Add-On Releases - Raffles 5 LITE

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

[nhawk]

Originally Posted by simonhind

nominated this mod

excellent product and 1st product i have installed without issues

good work

I cant' like another one of your posts for a while, so I'll just say thanks here.

[TheSupportForum]

Originally Posted by nhawk

I cant' like another one of your posts for a while, so I'll just say thanks here.

np i am looking forward to your other releases of this product and any addons you develope

[nhawk]

Update released today.

Note there is a bug in Beta 11 where the PM subject does not display properly in some cases. It's not a bug with the raffle system.

Also, you will need to re-insert the widgets where you had them after updating. There is a bug in Beta 10 and 11 where custom widgets get removed from pages after a product update.

[TheSupportForum]

Originally Posted by nhawk

Update released today.

Note there is a bug in Beta 11 where the PM subject does not display properly in some cases. It's not a bug with the raffle system.

Also, you will need to re-insert the widgets where you had them after updating. There is a bug in Beta 10 and 11 where custom widgets get removed from pages after a product update.

yeah i noticed they changes some standard code yet again

[nhawk]

A bug has been found in the raffle system.

At this time, don't allow members multiple entries in a raffle. They will receive a number of entries which is exponentially larger than the number that they are allowed and no error will be shown.

I already have the fix, but I am going to wait a little while before I release it to see if anything else crops up.

EDIT: This fix for this is in version 5.0.3.

[TheSupportForum]

@nhawk

small bug

when viewing raffle entries

Username is not linked correctly

incorrect
member.php?u=

correct
/member/(num)-username

example
/member/3-rachsuchtig

[nhawk]

Originally Posted by simonhind

@nhawk

small bug

when viewing raffle entries

Username is not linked correctly

incorrect
member.php?u=

correct
/member/(num)-username

example
/member/3-rachsuchtig

Thanks! I missed that during the conversion process.

I'll put the fix in the next release. The next release will be when the next Beta update is released by vBulletin.

FYI, only the userid is needed in the link. The name isn't required (at least it isn't yet).

[TheSupportForum]

Request :

Date Draw set as : DD/MM/YY rather than MM/DD/YY

i am from the UK and used to using DD/MM/YY, andy chances of doing a separate on with that change or could you provide the code change please

[nhawk]

Originally Posted by simonhind

Request :

Date Draw set as : DD/MM/YY rather than MM/DD/YY

i am from the UK and used to using DD/MM/YY, andy chances of doing a separate on with that change or could you provide the code change please

The note for date format will be changed because the date fields now accept either European or American date formats.

For the European format use a dash (-) or dot (.). For American format use a slash (/).

American - 02/15/2013
European - 15-02-2013 or 15.02.2013

The date members see on the raffle pages should already be shown in their chosen date format.

I'll change the ACP pages so it displays in the chosen format.

[TheSupportForum]

Originally Posted by nhawk

The note for date format will be changed because the date fields now accept either European or American date formats.

For the European format use a dash (-) or dot (.). For American format use a slash (/).

American - 02/15/2013
European - 15-02-2013 or 15.02.2013

The date members see on the raffle pages should already be shown in their chosen date format.

I'll change the ACP pages so it displays in the chosen format.

yeah that sounds great, thx