ASD Web Tools Help

Twitter Plugin for ASD Raffle Systems    

NOTE: This plugin may be used with all of your raffles. If you have purchased this Plugin more than once you may contact Alicia Stella for a refund of excess purchases.  

 

These Instructions are separated into 4 sections:
  General Use
  Setup Instructions
  Configuration Options
  Helpful Tips & FAQ's

Related Help Topics:
  ASD Raffle Systems
  Entry Plugin Help

 

_____General Use_________________________

This plugin allows your Raffle running in Second Life to update your Twitter Status automatically with SLurl, so people can visit your place.

You can set when the Raffle "tweets" messages to Twitter.

 

_____Setup Instructions____________________

First you will need an account at http://twitter.com.

You must also have an ASD Raffle System MAIN object in Second Life..

Move the scripts and notecards from the Twitter Plugin box to a folder in your Inventory.

From inside your Inventory, edit the "-Twitter Plugin Settings" note. (You should make a back-up copy before editing, in case of error.)

Open your Raffle MAIN object. Drag the Twitter Plugin settings note and the 2 scripts from your Inventory into the Raffle object's contents.

Reset Scripts in the Raffle Object and select the raffle ID from dialog menu.

Within 2 minutes you should see a dialog menu asking you to verify your Twitter account. Click the button to go to the URL and choose ALLOW from the page once you are there. You must wait until the Raffle object says in world: "Raffle is now successfully connected to Twitter" before closing your web browser or it will not work.

 

_____Configuration Options_______________

Change these settings in the "-Twitter Plugin Settings" notecard. You must Reset Scripts in object after making changes while notecard is inside Raffle Object.


Use Twitter Plugin? It will not work unless you have TRUE.
UsePlugin=FALSE
*To turn the plugin on or off, change this line to FALSE or TRUE.
_________________________________________________
TWEET SETTINGS

Post message on Twitter with Winner/New contest begining?
TweetWinner=TRUE
*If the contest ends and is set to recur a SLurl will be used in addition to announcing winner. If not set to recur only the winner will be announced.

Post message on Twitter every day around 12PM, noon Second Life time?
TweetDaily=FALSE

Post message on Twitter every night around 12AM, midnight Second Life time?
TweetNightly=FALSE

NOTE: Twitter may not post similar status updates within too short of a time period. You should not use both Daily and Nightly; only one or the other.
_________________________________________________
TEXT SETTINGS

You can have up to 20 characters of text at the begining.
PrefixText=#SL Raffle:
*You may choose to use your company name here.

You can have up to 20 characters text at the end. This is good for hashtags.
SuffixText=#inSL
*Hashtags help people find your posts. Popular ones are #SL #secondlife and #inSL
* More info: http://help.twitter.com/entries/49309-what-are-hashtags-symbols

NOTE: If your contest name is long you should keep prefix and suffix short or leave blank. Contest name is truncated when total message exceeds 140 characters.
_________________________________________________
BIT.LY LINK SETTINGS (ADVANCED)

If you have a bit.ly account you would like to use to shorten the url provide your username and api key.
BitlyUserName=
*If you have your own bit.ly account you can see exactly how many people are clicking on your links.
*Bit.ly is a free website service that shortens web url's.
*You can register for a free account here: http://bit.ly
*These settings can be left blank if you do not want to use your own account.

You can get the API Key from this page: http://bit.ly/a/account
BitlyAPIKey=

 

_____Helpful Tips & FAQ's_________________

If your objects are not working:

Check to be sure you have permission to Run Scripts on the land parcel. Be sure the object is set to the right group if only Group is allowed to Run Scripts.

Open object in EDIT and click on TOOLS at very top of screen, and then choose "Reset Scripts in Selection."

Deeded Objects will not work correctly.

Disclaimer: Alicia Stella Design is in no way affiliated with Twitter or Bit.ly. The performance of this plugin depends on the availability of these 2 websites. Twitter may not post multiple similar status updates in a row.

 



 // CHANGELOG //

VER 1.0 - May 24, 2010: Product Original Release

 



cron