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 prize image for each raffle. Set raffle rules on a per raffle basis. One or more entries per user. Admin settable time delay between user entries. One or more prizes per raffle. One or more winners per raffle (multiple winners require multiple prizes). Selectable usergroups Post count limit if desired. Require Human Verification if desired. Will show in Community Menu if desired. 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) 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 IANA — Example domains, 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 FROM 1.0.1 to 1.0.2 * ------------------------------------------------- Unless I instruct otherwise, you only need to upload the contents of the 'upload' folder to your forum's root. (If your forum's location is IANA — Example domains, the root is /forums/) * 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.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 منبع: vbiran.ir
