vBulletin LTS

Raffles 5 LITE
Mod Version: 5.0.0Beta6, by nhawk

After a considerable amount of thought, I will not be converting any of my mods to vB5.

If I should change my mind, I will let everyone know.

If a moderator could move this to the graveyard, I'd appreciate it.

NOTE: This add-on is designed for use with vBulletin 5 Connect. It WILL NOT work with earlier versions of vBulletin.

Raffles, giveaways, and contests, whatever you wish to call them, are a great way to increase traffic on any forum.

Features:

• Define a different prize image for each raffle.
• Set raffle rules on a per raffle basis.
• Set raffles to start in the future or on the day you create the raffle.
• Set the day and time entries for a raffle stop being accepted.
• Set the day and time a raffle will be drawn.
• Allow One or more entries per user.
• Allow multiple entries at one time if desired.
• Admin settable time delay between user entries.
• One or more prizes per raffle.
• One or more winners per raffle (multiple winners require multiple prizes).
• Allow members to win multiple times in one raffle if desired.
• Display winning 'ticket' numbers if desired.
• Selectable usergroups
• Post count limit if desired.
• Show active raffles anywhere you want to show them with widgets.
• Automatic raffle draw via vBulletin scheduled tasks.
• Manual raffle draw to override end date and/or scheduled draws.
• Turn raffles on or off via admincp. (Only raffle admins can view raffles when they are turned off)

The Pro version of Raffles 5 is available from my site.

Disclaimer: Laws about how raffles should be handled vary from location to location. Be sure to check with local authorities and to comply with any laws that may apply to you. The author of this add-on can not be held responsible if the use of this add-on results in any violation of local laws. By downloading this add-on, you agree to abide by local laws and to hold the author of this add-on harmless for any damages that may occurr from the use of this add-on.

* INSTALLATION *
-----------------------
1) Upload the contents of the 'upload' folder to your forum's root.
(If your forum's location is http://www.example.com/forums/, the root is /forums/)

2) Change the core/packages/raffles5/images folder properties so it is writeable (776 or 777).

3) Go to your site's home page and refresh the screen. (you may need to do this twice)

3a) If the raffle system doesn't auto-install, import the product XML file (product_raffles5.xml) into the Product Manager in AdminCP.
(The XML file is located in the /upload/core/packages/raffles5/xml folder)

4) Go to your site's home page and activate the Site Builder menu.

5) Either create a new page, or edit an existing page.

6) On the page where you want the active raffles to appear, select 'Add Modules' and click on 'Display'.
Then drag and drop either Raffles (Active - Large) or Raffles (Active - Small) widget where you want it to appear.

7) Take some time to set the options Raffle Settings.

8) Set up a raffle.


NOTE: If you want to display raffles that have already been drawn on a different page follow these steps..

1) Set 'Show Raffles Already Drawn With Active Raffles' to 'No' in ACP->Settings->Options->Raffle Settings.

2) Create or edit the page where you want the old raffles to be shown.

3) On the page where you want the old raffles to appear, select 'Add Modules' and click on 'Display'.
Then drag and drop the Raffles (Old) widget where you want it to appear.


* UPGRADE *
-----------------------
1) Upload the contents of the 'upload' folder to your forum's root.
(If your forum's location is http://www.example.com/forums/, the root is /forums/)

2) Import the product XML file (product_raffles5.xml) into the Product Manager in AdminCP.
(The XML file is located in the /upload/core/packages/raffles5/xml folder)

* Removal *
----------------
1) Uninstall the product in ACP->Products & Hooks->Manage Products.

2) Delete the core/packages/raffles5 folder from your server.

3) Delete the core/admincp/raffleadmin.php file from your server.

4) Delete the admincp/img/module-icon-raffle.png file from your server.


* History (Changelog) *
------------------------------
5.0.0 Beta 6
Regression - Restore library api files.
Remove - template API
Change - Version will remain at 5.0.0 and include Beta version number until final release

5.0.5 (October 24, 2012) * SYSTEM IS NOW COMPATIBLE WITH BETA 15 OR HIGHER ONLY!
Add - Activated vBulletin auto-install feature.
Fix - Banned usergroups able to see raffles.
Fix - Account for style changes in vB Beta 15.
Delete - Library API files - not needed with Beta 15

5.0.4 (October 9, 2012)
Fix - Member link in ACP user entry list still using vB4 link.
Fix - Missing query for user entries by all raffles.
Add - Detection of European date format settings in ACP.
Add - European date format now shown on ACP raffle screens.
Change - Date entry description text to include European date formats.
Change - Improved widget instance creation code.
Delete - Removed all references to $vbulletin which will soon be obsolete.

5.0.3 (September 28, 2012)
Fix - Multiple user entries result in an exponential number of entries.

5.0.2 (September 26, 2012)
Fix - Modified code to account for vB 5 Beta 11 removing function 'fetch_phrase'
Fix - Image still displayed in small active raffle widget when turned off for raffle
Change - Changed phrase for small active raffle widget in raffle setup

5.0.1 (September 21, 2012) (Upgrades from 5.0.0: Only upload files to server. No need to import XML if upgrading from 5.0.0)
Fix - Raffle descriptions and rules not saving properly when no paragraph formating is used.

5.0.0 (September 20, 2012)
- Initial Release