Add-On Releases - vBulletin Raffles

THIS ADD-ON IS NO LONGER AVAILABLE AND IS NOT SUPPORTED

NOTE: This add-on is designed for use with vBulletin 3.8.6 or higher. It may 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.

This is a port of my Raffle add-on for vBulletin 4.1.x to vBulletin 3.8.x. For the 4.1.x version see this thread.. https://vborg.vbsupport.ru/showthread.php?t=262901

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.
• 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.
• Require Human Verification if desired.
• Will show in Community Menu if desired.
• Show active raffles what's going on.
• 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)
• Support for just about any credit system such as vBCredits II, ICash, kBank and vbBux.
• Support for AW Coding's Credit Purchase System so member can purchase "raffle tickets".
• XHTML 1.0 Transitional validated (provided your current template passes the tests)

NOTE: Except for bug fixes, this mod is no longer being updated. I strongly suggest upgrading to vB 4.

* 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) If you intend to use AW Coding's Credit Purchase System with the Raffle System, install the Credit Purchase System FIRST.

2) 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/)
(If your forum's admincp is named something other than admincp, upload raffleadmin.php to your renamed admincp folder.)

3) Import the product XML file (product-raffles.xml) into the Product Manager in AdminCP.

4) If you want to view raffles on your site while the raffle system is turned off, go to AdminCP -> Usergroups -> Administrator Permissions select yourself and set "Can Admin Raffles" to 'Yes'.

5) Anyone you want to be able to administer raffles on your site must also have Administrator Permissions and have "Can Admin Raffles" set to 'Yes' or they will not be able to administer raffles.

6) Take some time to set the options in Raffle Settings.

7) Set up a raffle.

8) Make sure this add-on is marked as 'Installed' on vBulletin.org!
(If you want to get notices from me about updates for this add-on.)

* UPGRADE INSTRUCTIONS *
-----------------------------
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/)
(If your forum's admincp is named something other than admincp, upload raffleadmin.php to your renamed admincp folder.)

2) Import the product XML file (product-raffles.xml) into the Product Manager in AdminCP and be sure 'Allow Overwrite' is set to 'Yes'.

* USING RAFFLES *
-------------------
The whole system is pretty self explanatory, but there are a few things to keep in mind...

1) A default raffle image is supplied with the add-on. You must always supply an image for your raffles. You may change the default image if you like.

2) The entry period for raffles always end at 12:00am (midnight) on the day the raffle is to be drawn. (ie: Draw date is set 12/21/2011.. members can enter through 12/20/2011, the moment the date changes to 12/21/2011 no more entries are possible)

3) The scheduled task to draw the raffles is set to take place at 10:00am the day the raffle is to be drawn. You may change this by going to AdminCP->Scheduled Tasks->Scheduled Task Manager, find "Draw raffles", click on Edit and change the time of the draw to what you want it to be.

4) There are replacement variables used in several phrases. These are what the variables are:

raffle_agree: {1} = Forum name
raffle_eligible: {1} = Forum name {2} = Raffle name
raffle_message_body: {1} = Raffle name {2} = Draw date
raffle_message_close: {1} = Raffle admin name {2} = Phrase (raffle_admin_title)
raffle_message_salute: {1} = Winner name
raffle_recent: {1} = Time remaining before a user can enter again
raffle_winner_multi: {1} = Winner names for multiple raffle winners {2} = Raffle name
raffle_winner_one: {1} = Winner name for single raffle winner {2} = Raffle name'

More replacement variables are in the read.me included with this add-on.

5) When adding a custom user profile field for this add-on, be sure to 'Private Field' is set to 'Yes' and 'Field Searchable on Member List' is set to 'No'.

6) If you don't want to have Raffles in the community menu, you can use a forum link to raffles.php.

* History (Changelog) *
-------------------------
1.1.2 (October 6, 2011) (No need to import the xml file when upgrading from 1.1.0 or 1.1.1 to 1.1.2, just upload files to server.)
- Removed all direct mysql queries due to some systems having trouble with them.
- Corrected cpnav xml file (was showing an add-on option).

1.1.1 (October 5, 2011) (No need to import the xml file when upgrading from 1.1.0 to 1.1.1, just upload files to server.)
- Fix display of html on Edit Raffles screen.
- Improved user entry list function in AdminCP.
- Fix database warnings on some systems.
- Fix raffle ticket purchase link for AWCoding Credit Purchase System Pro.
- Fix detection of AWCoding Credit Purchase System Pro.

1.1.0 (August 1, 2011)
- Restored missing AWCPS patch in install script.
- Code enhancements for future expansion.

1.0.9 (July 20, 2011)
- Moved 'Allow Multiple Wins' from main settings to individual raffle settings. (user requested)

1.0.8 (July 16, 2011)
- Added Debug Logging option to raffle system.

1.0.7 (July 15, 2011)
- MAJOR FIX - Fix raffle draw so no duplicates happen when allow multiple wins is set to no.
- Add PM to raffle admin if no members enter a single prize raffle.

1.0.6 (July 13, 2011)
- Fix - Raffle not being drawn by scheduled task.

1.0.5 (July 11, 2011)
- Fix - members can no longer enter multiple times by using the back button on their browser.

1.0.4 (July 6, 2011)
- Fix Allow multiple wins to one member now works.
- Fix database error when no members enter raffle.
- Removed un-needed left joins in some DB queries that were needed in original release.

1.0.3 (July 4, 2011)
- Installation script change for systems not fully importing the parse templates plugin.
- Fix raffle draw time now displays in members's usercp chosen time zone format.
- Fix error in scheduled task when multiple prizes are awarded.
- Changed copyright so it only displays on raffle pages.

1.0.2 (June 27, 2011)
- Minor bug fix of active raffles in What's Going On area (was not collapsing properly).

1.0.1 (June 22, 2011)
- Converted missed 'view entries' from 4.x to 3.8.x format.

1.0. (June 20, 2011)
- Initial release for vBulletin 3.8.6.

* Known Working on vB Versions *
------------------------------------
3.8.6
3.8.7 PL 1

[Nelson58]

I looked, and cannot find an "adjust action" in VbCredits. Can you tell me where that is?

Thanks.

Nelson

[Nelson58]

Found it! It worked! Thanks a lot!!

[Nelson58]

I changed the name of the "currency" to "tickets" so as not to cause a problem with PayPal. I made the adjustment for the currency in the action screen.

I made the cost of each ticket $3 and the raffle takes 1 ticket each. It is working very nicely.
People can buy the tickets from a link on their postbit in their posts, profile, transactions page, etc., and then take a chance.

Thanks for the very nice mod!

If you ever work on this again- a suggested upgrade- allow people to specify how many tickets must be sold before the raffle is closed, so that it is the period of time specified OR the number of tickets sold, whichever is first. So that, for example, if you want to raise $600 by doing the raffle, they could specify to keep the ticket selling period open for a week or until 200 tickets are sold at $3 each.

[nhawk]

Originally Posted by Nelson58

I changed the name of the "currency" to "tickets" so as not to cause a problem with PayPal. I made the adjustment for the currency in the action screen.

I made the cost of each ticket $3 and the raffle takes 1 ticket each. It is working very nicely.
People can buy the tickets from a link on their postbit in their posts, profile, transactions page, etc., and then take a chance.

Thanks for the very nice mod!

If you ever work on this again- a suggested upgrade- allow people to specify how many tickets must be sold before the raffle is closed, so that it is the period of time specified OR the number of tickets sold, whichever is first. So that, for example, if you want to raise $600 by doing the raffle, they could specify to keep the ticket selling period open for a week or until 200 tickets are sold at $3 each.

I'm not sure if you're using the vB3 or vB4 version since here you post in the vB3 section and on my site, you post in the vB4 section.

The vB3 version will not be updated with new functions.

Also, I'd be VERY careful about selling tickets. It is not legal to do that in most places. Check your local laws.

[CheS06]

i installed this on my 2 forum and its worked well,

but i installed this in my one forum,same vb version, but everytime i upload the files on my file manager,then i extract it, its ok, but when i try to import the xml file at admincp > plugin & products, i got this message "Before installing, please upload all of the files that came with the Raffles addon!" even if i uploaded the files correctly..

and when i try to view the raffles.php "mysite/forum/raffles.php i got database error.

Database error in vBulletin 3.8.7:

Invalid SQL:

SELECT raffleadminperms
FROM administrator
WHERE userid = 39;

MySQL Error : Unknown column 'raffleadminperms' in 'field list'

PLS HELP

[nhawk]

You need to upload the 'CONTENTS' of the upload folder to your server. Not the actual upload folder.

Then try installing.

[CheS06]

yes thats whats i actually did.. actually i made this wonderful add-on working on my two other forums...

but when i try in my one ftp, even i uploaded it correctly, i keep getting that error.

"Before installing, please upload all of the files that came with the Raffles addon!"

[CheS06]

i check the files one by one on their desired location, and all files are there...

but when i import the xml its looks like the files are not in my forum

[nhawk]

Originally Posted by CheS06

i check the files one by one on their desired location, and all files are there...

but when i import the xml its looks like the files are not in my forum

Then one or more of the files is not where it belongs.

Did you rename your admincp folder to something other than admincp? If so, the contents of the admincp folder for raffles need to go into the renamed admincp.

[CheS06]

my admincp folder is still the same foldername sir..


i viewed the zip wich i upload and extracted and this is the contain files..

Archive:  upload.zip
  Length     Date   Time    Name
 --------    ----   ----    ----
        0  10-05-11 11:18   images/
        0  10-05-11 11:18   images/raffles/
    20303  03-31-11 16:12   images/raffles/default.gif
     1000  05-02-11 10:55   images/raffles/raffle.png
        0  10-05-11 11:18   includes/
        0  10-05-11 11:18   includes/cron/
    11386  10-06-11 15:27   includes/cron/raffledraw.php
      601  10-06-11 15:26   includes/functions_raffles.php
        0  10-05-11 11:18   includes/xml/
      242  04-28-11 16:29   includes/xml/bitfield_raffles.xml
      718  10-06-11 15:22   includes/xml/cpnav_raffles.xml
      876  10-04-11 18:00   includes/xml/hooks_raffles.xml
    25375  10-06-11 15:26   raffles.php
        0  10-05-11 11:18   admincp/
    30250  10-06-11 07:32   admincp/raffleadmin.php
 --------                   -------
    90751                   15 files