Copyable Tip Jars Help
Date 2009/2/17 13:30:00 | Topic: Tip Jars
| Copyable House Owned, Genie Bottle, Tipping Hats, Pot of Gold, Record Case, Fortune Cookie, and Custom Tip Jars
Complete Instructions & Help
• General Use
• Setup Instructions
• About the Configuration Notecard
• Customizing
• Helpful Tips & FAQ's
• Updates Changelog
NOTE: The default setting is to only allow members of the same Group to login to the Tip Jars. Have the group active while rezzing or change the object's group in EDIT under General tab. You can turn off the Group-Only feature in setup.
_____General Use__________________________
Owner sets out multiple Tip Jars. Employees log in to them.
Avatars pay money to Tip Jars and money first goes to object owner, then is paid to logged employee.
If the owner wishes, a percentage of the funds can be given to extra owners or remain with object owner from every tip collected.
The object owner or any extra owners can Touch a logged jar to see how much they have earned personally since the employee logged in.
When finished using Tip Jar the logged employee can log out. Tip Jars can also be set to Auto Log out when the user leaves, so another employee may use.
_____Setup Instructions_____________________
Rez a copy of the Tip Jar somewhere.
Open the object in EDIT. Click on "More>>" to reveal tabs and click on the "Content" tab.
Edit the Access List and Configuration Notecards inside the object.
You should see a pop-up dialog menu asking if you should "Reset" or "Cancel." Choose "Reset" if ready for your new settings to take effect. (You can also Touch and choose "Reset" from owner menu.)
You will be asked for permission to "Take Lindens from you? Click yes. This allows the script to pay the employee and/or extra owners when tipped.
Touch the object for more options by Menu.
Take a Copy to your inventory to Rez more with the same settings.
_____About the Configuration Notecard_________
Do not remove any lines, even if you are not using them.
// BASIC SETTINGS //
Your custom message to the tipper.
ThankYouMessage=Thanks for the tip!
*Do NOT use any special characters. Only use alpha-numeric and basic punctuation , . !
How to deliver Thank You message? (IM, WHISPER, SAY, SHOUT)
ThankYouMode=IM
To give away a gift on donation set the name of item here that is in object's inventory, (put NONE for no gift)
GiftName=NONE
*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.
If Set TRUE the object name will change to reflect the current user. FALSE will always keep name same.
NameChange=FALSE
*EXAMPLE: "Alicia Stella's Tip Jar" with namechange true or "Tip Jar" if namechange false.
// CUSTOM SETTINGS //
These settings may vary depending on your model.
This is displayed in floating text while not in use.
EmptyText=Empty
*Do NOT use any special characters.
If set TRUE you may replace "Name's Tip Jar" with your own text.
ShowCustomText=FALSE
CustomText=Any Text Here!
*You can set the top line to TRUE and put a single space here after the "=" for No Hover Text
Set FALSE to not show how much collected in floating text.
ShowTotalDonated=TRUE
Show the last tipper & amount in floating text.
ShowLastDonation=TRUE
ShowLastDonatorName=FALSE
*You must also have ShowLastDonation=TRUE to show the name
The color of the Floating Text when in use.
FloatTextColor=<1.0, 1.0, 1.0>
*Use the "Color Finder" included with your Tip Jar.
// STAFF SETTINGS //
Allow people on Access List notecard? (Add names to other note.)
UseAccessList=FALSE
*You can have up to 60 names of avatars to allow to login to the tip jar. This can be used with Group-Mode or by itself.
Allow members of same group? (FALSE for anybody or just the Access List if enabled above)
GroupUse=TRUE
*Set the Group you wish to use in EDIT under the GENERAL tab. Then users must have that same group active to login to jars.
*If you have Access List disabled and Group disabled, then anyone would be allowed to login to an empty jar.
Set this TRUE to empty the jar when employee logs off SL or goes farther than the range in meters set below.
AutoLogOut=FALSE
*When TRUE this feature will automatically logout a user when they leave.
If Auto-Logout is set to TRUE: Distance in meters in all directions that employee will be logged out if they exceed. (96 is the most and 5 is the least)
LogOutRange=96
// MONEY & EXTRA OWNERS //
You can edit the Fast Pay button amounts here. (Put 1 to 4 numbers separated by commas.)
PayPresets=20,50,100,200
ShowAnyAmount=TRUE
*These are the 4 preset buttons users see when paying the object.
*The Any Amount box is where you type any amount. If you set FALSE, users must use a preset button only.
Assign extra owners by putting their UUID keys here. Owners can log out employees and can earn a percentage of tips (optional, set amounts next.)
Owner2=00000000-0000-0000-0000-000000000000
Owner3=00000000-0000-0000-0000-000000000000
Owner4=00000000-0000-0000-0000-000000000000
*To get UUID keys, use the included "Key Finder" object and have the extra owner Touch it. It will say their key and you can copy it from the Local Chat History.
Split 100 between the logged in employee and any extra owners listed above. (Any remaining percentage will stay with object owner.)
EmployeePercent=100
Owner2percentage=0
Owner3percentage=0
Owner4percentage=0
*The employee is the current avatar that has their name floating above the tip jar.
*Do not remove the percentage lines above. If you are not using them set to 0.
*Anything left after employee and extra owners get their cut stays with object owner so you do not have to specify your amount.
// 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.)
ServerChannel=0
Categories are defined using Tipping Server and must be one word, Case Sensitive. (Leave NONE for no category.)
Category=NONE
_____Customizing__________________________
You may resize the object as needed.
Touch the Object for Menus that only the Object Owner can see. Here you may have an option to change colors, or other appearance settings, (based on model.)
_____Helpful Tips & FAQ's____________________
If your Tip Jar is 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. (Tipping Hat requires permission to Rez/Create Objects as well.)
• Open object in EDIT and click on TOOLS at very top of screen, then choose "Reset Scripts in Selection."
Deeded Tip Jars will not work correctly.
• Q: How do I setup Percentages with other owners in a product?
• Q: How do I get the money out of my donation box or tip jar?
/// CHANGELOG ///
JANUARY 2015 - VER 6.0 UPDATE
• Commas will be stripped out of custom thank you and custom floating text to prevent script errors.
• Other bug-fixes added to help tip jars run more smoothly.
• Individual staff member percentages added when using ASD Tipping Server, set through Web Tools. Requires the updated Tip Jars as well as Tipping Server version 1.2 (or higher).
NOVEMBER 2009 - VER 5.5 UPDATE
• Name Change option added to Configuration. Allows objects to rename themselves when user logs in or always keep name same. EXAMPLE: "Alicia Stella's Tip Jar" with namechange true or "Tip Jar 5.5" if namechange false.
• "Empty" text uses custom text color now.
• Tipping Server Integration.
FEBRUARY 2009 - VER 5.0 UPDATE
• Converted to MONO.
• Percentage Split much easier to setup.
• Dialog Menu on Login to jar
• Improved Employee Touch Menu with more options.
• Employee can choose Pay Notification method from IM, Dialog, Both, or None.
• Employee can change colors, can be disabled in Configuration. (Only in models with Color options)
• Customizable "Thank you" message to tipper
• New Options for Thank you message: IM, Whisper, Say, or Shout
• Can now edit "empty" label text
• Can disable 'Any Amount' box from Pay Presets
• Object names can be changed and version number is in object name
• Devices will not become active until Owner grants Pay Permissions.
• Genie Bottle: You can now Select color by menu for genie smoke including random color each time.
FEBRUARY 2008 - VER 4.5 UPDATE
MAY 2007 - VER 4.0 UPDATE
AUGUST 2006 - VER 1.0 - Product Release
|
|