Weekly Raffle
Top Free Scripts
ASD Web Tools
Product Help
Tip Jars : Premium Donation Box Help
on 2008/4/11 15:56:19 (2518 reads)
Tip Jars

Premium Donation Box
Complete Instructions & Help

General Use
Setup Instructions
About the Configuration Notecard
Helpful Tips & FAQ's

_____General Use__________________________

Avatars pay money into Donation Box and it all goes to object owner. Based on extra owner settings, percentages of the pay may be split and paid out automatically from object owner's balance.

_____Setup Instructions_____________________

Rez a copy of the Donation Box somewhere.

Open the object in EDIT. Click on the "Content" tab. Open the notecard called "Configuration" and edit the settings inside, (see below.) Save and close notecard.

Object should reset automatically. Touch the object for more options.

_____About the Configuration Notecard_________

Note, only change things after "=" and DO NOT REMOVE ANY LINES!

Enter the text to display above the box.
DisplayText=Donation Box
*Put a single space here after the "=" for No Hover Text

Set these to TRUE to show the last person to donate in floating text and amount.
*You must have ShowLastDonation=TRUE to show the name

Specify a color for the floating text, (use the included Color Finder)
FloatTextColor=<1.0, 1.0, 1.0>

Message to person making donation. Use AVNAME and PAYAMT to show donator's name and amount paid.
ThankYouText=Thank you for the donation of PAYAMT, AVNAME!
*Message should be less than 250 characters.
*AVNAME and PAYAMT do not have to be used. If in use they must be all capital letters.

How to deliver Thank You message? (IM, WHISPER, SAY, SHOUT)

Amount of total Money to start the count at.
*Useful for if your script is accidentally reset.

To set a goal enter the amount in Lindens here, (0 for no goal)
*If you are not using the goal feature you must still have this line with a "0" or scripts may fail.

If using goal feature, total count can reset on this day, 1 to 28. (0 to not reset count automatically each month)
*This can be great to use for your tier payment day each month.

To give away a gift on donation set the name of item here that is in object's inventory, (put NONE for no gift)
*Be sure it is the exact name of the item. It can be a landmark, object, notecard, clothing, etc; any one single item you want.

How much must be donated to get gift? Leave 1 for any amount of Lindens.
*Can be any amount. 1 is the minimum.

You can edit the Fast Pay button amounts here.
*These are the 4 preset buttons users see when paying the object.

To link this donation box's totals up with others on your sim enter the channel number here, (must be any 4 to 8 digits). Leave 0 when not in use.
*When this feature is used, the last Donation Box paid will update all boxes with that one's totals. Tip: You make up the number to use, any 4 to 8 digits.

Send owner(s) an IM after donation is made? (Can be enabled/disabled by each owner via touch menu.)
*This setting is only the default for when device is reset. Owners can also change their personal notification setting via touch menu at any time.

To split money with up to 3 more addtional avatars, specify their keys and percentages here, excluding the object owner. (Any remaining funds stay with object owner):

*Do not remove the percentage lines above, even if you are not using them. If you have extra owners, you will be asked to click "Yes" to allow the object to "Take Lindens from you? Click yes. This allows the script to pay the extra owners.

// SERVER SETTINGS // INFO: http://www.asdwebtools.com/tipping.php

If using the ASD Tipping Server (sold separately,) please specify channel here. (Leave 0 for no server use.)

Categories are defined using Tipping Server and must be one word, Case Sensitive. (Leave NONE for no category.)

*If using a Tipping Server with your device all donations will be logged in Transaction History on the web.

When finished editing the 'Configuration' note, click SAVE and close. You will be prompted to reset scripts by menu, accept it.


You may resize the object as needed.

You can change the textures and colors in Edit under the Texture tab. Touch the object and turn off color change from the owner menu before selecting your color.

To use your own object:
-Open the Donation Box and Copy Contents to your Inventory.
-Open the object you want to use, (be sure you have modify rights.)
-Drag the "Configuration" notecard from your Inventory to the new object.
-Then drag the "Donation Box" and "Update Script" scripts into the new object.
-You do not need the "Colors" script unless you want your new object to change colors.
*Note: Scripts must be in the Key prim to work properly, (the last linked prim.)

_____Helpful Tips & FAQ's____________________

If your Donation Box is not working:

-Check to be sure you have permission to run scripts on the land parcel and be sure the object is set to the right group if needed.

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

Q: How do I setup Percentages with other owners in a product?

Q: Why do the totals keep reseting on my Donation Goal Thermometer or Donation Box?

Q: How do I get the money out of my donation box or tip jar?

Printer Friendly Page Send this Story to a Friend Create a PDF from the article
Most Popular Raffle System In Second Life
Visit ASD Studios Hollywood
Search for Help
Monthly Free Item
Santa Hat Givers

Limit one per avatar
Teleport Now!


Site Info
Total Hits: