Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
vBulletin Raffles Details »
vBulletin Raffles
Mod Version: 1.4.6, by nhawk (Member) nhawk is offline
Developer Last Online: Dec 2019 I like it Show Printable Version Email this Page

This thread is in the Modification Graveyard.
vB Version: 4.1.1 Rating: (37 votes - 4.81 average) Installs: 270
Released: 30 Apr 2011 Last Update: 18 Nov 2015 Downloads: 1672
Not Supported Translations  

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

NOTE: This add-on is designed for use with vBulletin 4.1.1 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.

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 in forum sidebar and/or in 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)

* 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) Import the product XML file (product-raffles.xml) into the Product Manager in AdminCP.

3) 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'.

4) 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.

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

6) Set up a raffle.

7) 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/)

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

3) If you are already using vBCredits you will need to go into Raffle Settings and set 'Use vBCredits' to 'Yes' and set 'vBCredits Currency' to the currency you are using. If you are using any other credit system, you will need to provide the information on what table, field and userid field are used by that credit system.

* 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

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.4.6 (November 18, 2015)
- Fix - Missing code for sidebar block

1.4.5 (August 6, 2015)
- Fix - Error entering raffles with entry limit.

1.4.4 (August 29, 2013)
- Fix - XHTML 1.0 transitional validation errors in raffle sidebar box.

1.4.3 (March 15, 2013) (Never released on vB.org)
- Change - Moved hard coded day, hour, minute, second words to vB phrases.

1.4.2 (September 1, 2012) (Released February 18, 2013 on vb.org)
(NO NEED TO UPDATE IF YOU DON'T USE THE COMMUNITY MENU FOR RAFFLES)
- Fix - Community menu navigation information missing from install xml.

1.4.1 (August 15, 2012) (NO NEED TO UPLOAD FILES IF YOU ARE RUNNING 1.4.0 JUST IMPORT XML FILE)
- Fix - Raffle sideblock missing from install file (overlooked in version 1.4.0).

1.4.0 (August 13, 2012)
- Fix - Some servers not providing proper responses with direct MySQL calls. (usually nginx)

1.3.9 (June 28, 2012)
- Fix - Wrong phrase used for file upload error.
No need to import XML file if you are running version 1.3.8. Just upload files to server.

1.3.8 (June 27, 2012)
- Add - Ability to upload prize image from ACP.
NOTE: Depending on your server configuration, you may need to make your images/raffles folder writeable (776 or 777)
- Add - Option to prevent additional usergroups from entering a raffle.

1.3.7 (May 21, 2012)
- Add - Option to show old raffles on a different page than currrent raffles.
- Change - Removed raffle_bits template.
- Change - Made compatible with vB 4.2.0.

1.3.6 (March 12, 2012)
- Fix - Active raffle sideblock will no longer show if there are no active raffles.

1.3.5 (February 25, 2012) (Never released on vB.org)
- Code enhancement for expansion.

1.3.4 (December 28, 2011)
- Add - Mass delete raffle entries (you must select a raffle in ACP->Raffles->Manage User Entries. The selection 'All Raffles' will not display a delete all option).

1.3.3 (October 5, 2011) (No need to install xml file if upgrading from 1.32 to 1.33. Just upload files to server)
- Fix raffle ticket purchase link for AWCoding Credit Purchase System Pro.

1.3.2A (September 29, 2011)
- Re-uploaded 1.3.2 with correct cpnav_raffles.xml file.

1.3.2 (September 29, 2011)
- Fix detection of AWCoding Credit Purchase System Lite (problem caused when fixing Pro detection).

1.3.1 (September 28, 2011)
- Improved user entry list in AdminCP.
- Fix detection of AWCoding Credit Purchase System Pro.

1.3.0 (August 29, 2011) (Uploaded a second time with proper sideblock code)
- Code enhancement for future expansion.
- Enabled CSRF protection.

1.2.9 (August 24, 2011) (never uploaded here)
- Code enhancement for future expansion.
- Unregistered users can now see raffles in WGO and forum sidebar if they are allowed.
- Fix members no longer able to view and enter raffles scheduled in the future.

1.2.8 (August 1, 2011) (never uploaded here)
- Code enhancement for future expansion.

1.2.7 (August 1, 2011)
- Restored AWCPS patch to install script.
- Restored forum sidebar block to install script.
- Restored missing option to show image in sidebar block.

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

1.2.5 (July 16, 2011)
- Added Debug Logging option to raffle system. (v1.2.4 was never uploaded)

1.2.3 (July 15, 2011)
- MAJOR FIX - Fix raffle draw so no duplicates happen when allow multiple wins is set to no (finally found bug in 3.8.x version).

1.2.2 (July 11, 2011)
- Fix members can no longer enter multiple times by using the back button on their browser. (reported in vB 3.8.7 version)

1.2.1 (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.2.0 (July 4, 2011)
- Fix raffle draw time now displays in members's usercp chosen time zone format.

1.1.9 (July 3, 2011)
- Fix error in scheduled task when multiple prizes are awarded.
- Changed copyright so it only displays on raffle pages.

1.1.8 (June 17, 2011)
- Fix SQL error when 'Show Raffles Already Drawn' is set to 'No'.

1.1.7 (June 8, 2011)
- Added maximum picture width option for raffle detail page.

1.1.6 (June 6, 2011)
- Fix PMs not being sent with automated draw.
(NO NEED TO IMPORT XML IF YOU ARE ALREADY RUNNING VERSION 1.1.5 - JUST UPLOAD FILES)

1.1.5 (June 2, 2011)
- Fix vBCredits error created in version 1.1.1.
- Minor code change to make system compatible with PHP 5.3.x

1.1.4 (June 1, 2011)
- Database table creation change to make it compatible with MySQL 5.5.8
(NO NEED TO UPDATE IF YOU ARE ALREADY RUNNING VERSION 1.1.3)

1.1.3 (May 30, 2011)
- Added option to show raffle image in forum sidebar block.
- Added sidebar block image width setting.
- Added vBulletin minimum version 4.0.4 check.
- Changed database creation method.

1.1.2 (May 26, 2011)
- Fix system checking for credits when it shouldn't.

1.1.1 (May 26, 2011)
- Fix 'Other Credit System' saying not enough credits when member has enough.

1.1.0 (May 24, 2011)
- Added option to show the scheduled draw time on raffle pages.(user requested)

1.0.9 (May 21, 2011)
- Fix unregistered members unable to see raffles when they are allowed.

1.0.8 (May 16, 2011)
- Fix blank screen after entry.
- Fix redirect error.
- Fix default maximum entries.

1.0.7 (May 12, 2011)
- Added option to show who has entered raffles.(user requested)
- Reduced database queries by 1.
- Moved vBCredits log phrase to vBulletin phrases.
- Fixed bug where raffle sidebar was being displayed when raffles were turned off.

1.0.6 (May 10, 2011)
- Added the ability to allow multiple entries to be submitted at one time.(user requested)
- Added display of the number of entries a member has submitted to raffle detail page.(user requested)
- Added support for AW Coding's Credit Purchase System. (allows use of different payment systems to purchase 'tickets')
- Added transaction logging for vBCredits (thanks to Darkwaltz4 for info)
- Added minimum/maximum value checks.
- Added option to display winning "ticket" number(s) with winner name(s).(user requested)
- Added option to allow members to only win once per raffle.(user requested)
- Added PM to raffle admin if raffle couldn't be drawn when scheduled.
- Added ability to set a start date other than the day raffle was created.(user requested)
- Stray hardcoded phrase moved to vB phrases.
- Fixed bug where sent PMs were being saved in admin sent box when raffle was drawn manually even if option is set to no in settings.
- Fixed bug where only one winner was being displayed in admin area for a multi-prize raffle when raffle was drawn manually.

1.0.5 (May 4, 2011)
- Sidebar and Current Raffle templates now cached
- Fixed bug where entry limits over 999 only allowed 1 entry.
- Fixed missing phrases on new installs.
- Added support for vBCredits, ICash, kBank and vbBux. (user requested)

1.0.4 (May 3, 2011)
- Sidebar block now installs automatically when the add-on is installed.

1.0.3 (May 3, 2011)
- Added option to display current raffles in What's Going On (Displays what raffles are available for the member's usergroup). (user requested)
- Added Sidebar Block template and instructions in ReadMe on how to add a Current Raffle Block. (user requested)
- Added Banned Usergroup setting for usergroups forbidden to use or see the raffle system. (user requested via PM)
- Modified Raffle Admin so banned usergroups do not show up when creating or editing a raffle.

1.0.2 (May 2, 2011)
- Fixed "Enter Through" date display. (was not following vBulletin date display settings)
- Slight change to database routines so they all go directly through vBulletin.

1.0.1 (April 30, 2011)
- Added check to be sure files are uploaded to server (NO NEED TO DOWNLOAD IF YOU ALREADY HAVE 1.0.0 INSTALLED)

1.0.0 (April 30, 2011)
- Initial Release

* Known Working on vB Versions *
-------------------------------------------
4.0.4
4.0.6
4.0.7
4.0.8
4.1.1 through 4.2.1

Download Now

Only licensed members can download files, Click Here for more information.

Show Your Support

  • If you like this modification support the author by donating.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Similar Mod
Mod Developer Type Replies Last Post
Miscellaneous Hacks Turkish Language Pack for vBulletin 4.0 | vBulletin 4.0 İçin Türkçe Dil Paketi yilmaz Modification Graveyard 15 23 Nov 2009 15:49

  #451  
Old 06 Apr 2012, 19:22
nhawk nhawk is offline
 
Join Date: Jan 2011
Originally Posted by oddmud View Post
Can I change the auto PM wording?!
Yes.

Go to ACP->Languages & Phrases->Search in Phrases.

Search for Text: raffle_message_body
Search in... tick 'Phrase Variable Name Only'
Click Find.
Reply With Quote
  #452  
Old 07 Apr 2012, 16:51
officer cartman officer cartman is offline
 
Join Date: Oct 2010
do you have to use a monetary system? can you not just have a free entry? i tried to get this working but cannot create a raffle any ideas?
Reply With Quote
  #453  
Old 07 Apr 2012, 17:10
nhawk nhawk is offline
 
Join Date: Jan 2011
Originally Posted by officer cartman View Post
do you have to use a monetary system? can you not just have a free entry? i tried to get this working but cannot create a raffle any ideas?
No you don't need a monetary system.

What happens when you try to create a raffle?

And, when you create a raffle be sure your usegroup is in the allowed usergroups. Otherwise you won't be able to see it.

Posting a screenshot of your raffle settings and the raffle itself would help.
Reply With Quote
  #454  
Old 08 Apr 2012, 13:13
officer cartman officer cartman is offline
 
Join Date: Oct 2010
raffles appears at the top but i cannot create one and i have set admin to create view them...ill take another look...im sure its something simple
Reply With Quote
  #455  
Old 08 Apr 2012, 14:20
nhawk nhawk is offline
 
Join Date: Jan 2011
Originally Posted by officer cartman View Post
raffles appears at the top but i cannot create one and i have set admin to create view them...ill take another look...im sure its something simple
You do realize that raffles are created in (left menu) ACP->Raffles>Add New Raffle don't you?
Reply With Quote
  #456  
Old 23 Apr 2012, 20:01
Chris Beveridge Chris Beveridge is offline
 
Join Date: Apr 2008
How does this handle unregistered users who win? I haven't run any with this setting yet and I'm curious. Do they have to provide an email, etc?
Reply With Quote
  #457  
Old 23 Apr 2012, 20:17
nhawk nhawk is offline
 
Join Date: Jan 2011
Originally Posted by Chris Beveridge View Post
How does this handle unregistered users who win? I haven't run any with this setting yet and I'm curious. Do they have to provide an email, etc?
While the usergroup shows when you set up a raffle, unregistered users aren't allowed to enter at all. The only reason the usergroup shows up is because it's in the vBulletin usergroup list.

In order for someone to enter a raffle, they must have a userid. Without a userid, all they can do is look at raffles if you allow that.
Reply With Quote
  #458  
Old 01 May 2012, 15:41
oddmud's Avatar
oddmud oddmud is offline
 
Join Date: Oct 2009
For some reason (my server was down) my raffle didn't process on 04-30-12 at 10am. It's still "waiting to be drawn". How do I manually draw it so I can complete the raffle?

I tried to run it manually using the scheduled task manager.. I got this...

Fatal error: Existing data passed is not an array
Called set_existing in [path]/includes/class_dm_pm.php on line 683
Called post_save_each in [path]/includes/class_dm.php on line 917
Called save in [path]/includes/cron/raffledraw.php on line 271
Called include_once in [path]/admincp/cronadmin.php on line 116
in [path]/includes/class_dm.php on line 265
#0 vb_error_handler(256, Existing data passed is not an array
Called set_existing in /home/goaliecreasenet/goaliecrease.net/includes/class_dm_pm.php on line 683
Called post_save_each in /home/goaliecreasenet/goaliecrease.net/includes/class_dm.php on line 917
Called save in /home/goaliecreasenet/goaliecrease.net/includes/cron/raffledraw.php on line 271
Called include_once in /home/goaliecreasenet/goaliecrease.net/admincp/cronadmin.php on line 116
, /home/goaliecreasenet/goaliecrease.net/includes/class_dm.php, 265, Array ([existing] => ,[line] =>
Called set_existing in /home/goaliecreasenet/goaliecrease.net/includes/class_dm_pm.php on line 683
Called post_save_each in /home/goaliecreasenet/goaliecrease.net/includes/class_dm.php on line 917
Called save in /home/goaliecreasenet/goaliecrease.net/includes/cron/raffledraw.php on line 271
Called include_once in /home/goaliecreasenet/goaliecrease.net/admincp/cronadmin.php on line 116
Whats up with that?

I put it in debug mode and ran it again...

15901 Draw raffles 08:26, 1st May 2012 Current Winner IDs: 1800
15900 Draw raffles 08:26, 1st May 2012 Current Winner List: jack456123
15899 Draw raffles 08:26, 1st May 2012 Conditional Winner: 1800
15898 Draw raffles 08:26, 1st May 2012 End Date/Time = 04-30-2012 07:00 AM
15897 Draw raffles 08:26, 1st May 2012 Drawing April 2012 Contest - Drummond Custom AirBrush Paint Job
15896 Draw raffles 08:26, 1st May 2012 Multiple Winners = 0
15895 Draw raffles 08:26, 1st May 2012 Cron Run Schedule = : 0,-,-,-,-,-
15894 Draw raffles 08:26, 1st May 2012 Start drawing raffles Code v1.3.0
15893 Draw raffles 08:23, 1st May 2012 Start drawing raffles Code v1.3.0
15892 Draw raffles 08:22, 1st May 2012 Start drawing raffles Code v1.3.0
But it still shows "Waiting to be Drawn".
__________________
Like Fly Fishing?
www.flyfishbc.com

Last edited by oddmud; 01 May 2012 at 16:34.
Reply With Quote
  #459  
Old 01 May 2012, 18:06
nhawk nhawk is offline
 
Join Date: Jan 2011
Originally Posted by oddmud View Post
For some reason (my server was down) my raffle didn't process on 04-30-12 at 10am. It's still "waiting to be drawn". How do I manually draw it so I can complete the raffle?

I tried to run it manually using the scheduled task manager.. I got this...



Whats up with that?

I put it in debug mode and ran it again...



But it still shows "Waiting to be Drawn".
To manually draw a raffle, go to ACP->Raffles->Edit Raffles. Click on the Raffle Name. Then click Manually Draw Raffle.

So far as the error goes, I would have to see the complete settings for that raffle to duplicate the problem. I would also need the version of vBulletin you are running.
Reply With Quote
  #460  
Old 05 May 2012, 17:02
oddmud's Avatar
oddmud oddmud is offline
 
Join Date: Oct 2009
Originally Posted by nhawk View Post
To manually draw a raffle, go to ACP->Raffles->Edit Raffles. Click on the Raffle Name. Then click Manually Draw Raffle.

So far as the error goes, I would have to see the complete settings for that raffle to duplicate the problem. I would also need the version of vBulletin you are running.
Didn't do anything when I manually drew it. Nothing happened. I just deleted it, and started a new one.

I had to use random.org to pick a winning ticket number. :|
__________________
Like Fly Fishing?
www.flyfishbc.com
Reply With Quote
  #461  
Old 05 May 2012, 18:44
nhawk nhawk is offline
 
Join Date: Jan 2011
Originally Posted by oddmud View Post
Didn't do anything when I manually drew it. Nothing happened. I just deleted it, and started a new one.

I had to use random.org to pick a winning ticket number. :|
What version of vBulletin are you running?

My site draws a winner every day using vB 4.1.11 and has done so with every version from 4.0.4 forward.
Reply With Quote
  #462  
Old 06 May 2012, 15:44
cravendale cravendale is offline
 
Join Date: Oct 2010
Hi,

I'm running vB 4.0.6 so I'm also running an older version of Raffles.

When a member entered the Raffle. They get a DB error and this is what I get in email...

Database error in vBulletin 4.0.6:

Invalid SQL:
SELECT * FROM raffle
WHERE startdate <= 1336313626
WHERE enddate > 1336313626
ORDER BY id DESC;

MySQL Error : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'WHERE enddate > 1336313626
ORDER BY id DESC' at line 3
Error Number : 1064
Request Date : Sunday, May 6th 2012 @ 09:13:46 AM
Error Date : Sunday, May 6th 2012 @ 09:13:46 AM
Script : http://www.twofoursix/forum/raffles.php?do=main
Referrer : http://www.twofoursix.com/forum/raffles.php
IP Address : 77.101.70.149
Username : superjoe
Classname : vB_Database
MySQL Version :

The member appears in the list of members who entered. How can I resolve this error please?

thanks
Reply With Quote
  #463  
Old 06 May 2012, 17:43
nhawk nhawk is offline
 
Join Date: Jan 2011
Originally Posted by cravendale View Post
Hi,

I'm running vB 4.0.6 so I'm also running an older version of Raffles.

When a member entered the Raffle. They get a DB error and this is what I get in email...

Database error in vBulletin 4.0.6:

Invalid SQL:
SELECT * FROM raffle
WHERE startdate <= 1336313626
WHERE enddate > 1336313626
ORDER BY id DESC;

MySQL Error : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'WHERE enddate > 1336313626
ORDER BY id DESC' at line 3
Error Number : 1064
Request Date : Sunday, May 6th 2012 @ 09:13:46 AM
Error Date : Sunday, May 6th 2012 @ 09:13:46 AM
Script : http://www.twofoursix/forum/raffles.php?do=main
Referrer : http://www.twofoursix.com/forum/raffles.php
IP Address : 77.101.70.149
Username : superjoe
Classname : vB_Database
MySQL Version :

The member appears in the list of members who entered. How can I resolve this error please?

thanks
Update raffles to the latest version.
Reply With Quote
  #464  
Old 07 May 2012, 20:25
wilford brimley wilford brimley is offline
 
Join Date: Apr 2012
how can I make all users able to see raffle rules instead of just allowed usergroups? I want to be able to tell them how to join the usergroup in the rules.
Reply With Quote
  #465  
Old 07 May 2012, 22:55
nhawk nhawk is offline
 
Join Date: Jan 2011
Originally Posted by wilford brimley View Post
how can I make all users able to see raffle rules instead of just allowed usergroups? I want to be able to tell them how to join the usergroup in the rules.
Rules won't show up for anyone except allowed usergroups.

Put the instructions about how to join in the raffle description.
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 20:47.

Layout Options | Width: Wide Color: