MHS Donation Jar - Functions

(continued from Intro Page)

CONFIGURATION CARD

In the MHS Donation Jar's inventory (in the "Content" panel) you will see a notecard named MHS Jar Config. Data lines in that notecard are used to initialize the jar with default values when it is first rezzed or reset.

OPERATORS CARD

There is another notecard that the MHS Donation Jar will read, and that is one for holding the names of authorized operators. It is called MHS Jar Operators and is optional. If it's not in the jar's inventory, then only you (the owner) will have access to the options dialog. But if you're a club owner with assistants, or have a trusted partner (such as your own alt accounts!), you can configure the jar to allow them a subset of those options. Simply include a list of the people. Enter their SecondLife names, NOT their avatar key values.

Note: The "MHS Jar Operators" is not for specifying your shared tip recipients. Sharing is specified in the MHS Jar Config notecard using the "SHARE WITH=" token.

CHOOSE FROM SIX SOUND RESPONSES (and/or add your own!)

The MHS Donation Jar comes 'factory-equipped' with a variety of sounds that can be emitted anytime a tip is deposited. ("Boop-Oop-A-Doop" -- a nostalgic carryover from prior versions -- is still on the list... we'll never let that one go!). You can also add any number of your own sound objects. Keep their names short, because they're used as button titles which Linden limits to 12 characters (anything beyond that is truncated). For instance, if you have a sound object named "Incredible Firecrackers", better to rename it to "Firecracker", or even "Boom". Be creative!

DIALOG OPTIONS WHEN JAR IS CLICKED:

When anyone left-clicks the jar, your notecard configured "tickler message" is whispered. But if you (or your designated operators) click the jar, the SL viewer's options dialog will also appear. Basic information is shown at the top, such as the version number, tip threshold for someone to receive a rose, and the current sound and volume. The first button - Admin - is available only to you. All other buttons will be accessible by any avatar whose name you put in the MHS Jar Operators notecard.

Dialog Options (For a pictorial overview, click here)
  • Admin: Provides access to owner-only functions. Configured operators will not see this button.
    • ChatCmd: (short for "Chat Command") This opens up a 60-second listener channel for one of two abilities: /888 to change the hover text title on the fly (in lieu of editing the config notecard), and /999 to get an avatar's key (for tip sharing).

    • TipTracer: This is the front door to the TipTracer system. The buttons in this area are:
      • Password: retrieve your TipTracer password.
      • Import: transfer TipTracer history from another jar.
      • Report: reports server-side information on all your TipTracer-registered jars. More importantly, you can see what jars have not pinged the server, indicating those that will eventually be removed from the TipTracer system due to inactivity (360 days of no pinging will trigger an automatic removal of tip data).
      • Admin: returns to the Admin panel.
      • More Info: provides latest info on TipTracer that might be of interest to you.
      • Register/Unregister: register/unregister this jar from TipTracer.

    • Empl Login: Clicking this button allows you to toggle Employee Login mode. In it's default state, Employee Login's are disabled. When Employee Login mode is enabled, any group member (as dictated by the group-owned land where the jar is rezzed) can click the jar to "login" to get a percentage of tips put into that jar. However, you (the jar owner) and anyone you have configured in your MHS Jar Operators notecard can not log in as employees.

      You can configure in the MHS Jar Config notecard what percentage the employee gets (EMPLOYEE_PERCENTAGE=) and enable an auto-logoff if the employee exits SecondLife or ventures away by a configured distance (EMPLOYEE_LOGOFF_RANGE=).

    • Memory: Clicking this button generates a report on the version number and available memory for each script in the system. (It hasn't been necessary yet, but I might need to know this information if you have any issues to report.)

    • Update: Clicking this button will query the Zappowappy Update Server for any product updates. For no-copy tip jar owners, it's an easy two-step process. For copyable tip jar owners, it's an even easier one-step process! Click here for details.

    • Main Menu: return to the main menu.

    • Reset: Clicking this button is necessary to load your MHS Jar Config and MHS Jar Operators notecards. It's not as extensive as the Linden "Reset Scripts in Selection". For instance, the jar's reset function will keep hover text stats intact. The Reset function will unregister TipTracer and disable sharing. So if you want either of those active, you'll have to re-enable them after the reset is complete.

    • Sharing: This activates the recipients you have specified with the SHARE WITH= tokens in the MHS Jar Config notecard. A summary of how many recipients are configured and the total percentage that you'll be paying out will be reported. You should then verify the sharing request. A Debit Permissions dialog will require you to Grant debit permissions.

    		•
  • Sounds: Clicking this button brings you to the sound options panel:
    • Type: All the sound objects that were found in the jar's inventory will be represented as buttons here. When you click one of the buttons, the applicable sound object will be played out to you, and the sounds menu will reappear. You will also see a Random button. This directs the jar to pick one of your sounds randomly with each tip.

    • Volume: This is where you adjust the sound volume, from 0 (off) to 10 (max). When a selection is made, you'll hear the sound at the selected volume and the menu will reappear. This allows you to adjust it on-the-fly.

  • News: Displays latest-and-greatest information in your viewer's popup dialog.

    		•
  • Help: Clicking this button provides a notecard containing a very brief summary of the MHS Donation Jar features.

  • Hover Text: Three buttons are available from this point: Display, Lines, and Color. Click here to learn about the hover text configuration.

    		•
  • Clear Stats: Clear the displayed total and tip statistics displayed in the hover text.

    		•
  • Rose Color: Select from one of 6 colors: red, purple, pink, yellow, black, white. (The color change won't be immediate! Due to the temp-on-rez feature, you will see the new color at the next temp-on-rez cycle, which will occur sometime within 60 seconds.)

    The color you choose will determine what gift is given to the tipper if the tip amount satisfies the MHS Jar Config notecard's "GIFT THRESHOLD=" value. Unless you specify custom objects to be passed out, as discussed in this page, an MHS rose of the same color will be given to the tipper.

    		•
  • Ignore: Remove the options dialog with no action taken (analogous to a "Cancel" action).

    • OTHER CONSIDERATIONS

    • Keep the jar upright. The rotating rose won't orient itself properly at any other angles.

    • Due to the temp-on-rez feature, there will be an occasional double-rose appearance in the jar. And if you move the jar, the spinning rose won't move with it. Not to worry! Within 60 seconds, the rose will disappear, and a new one will appear inside the jar at its new location.

    UPDATES:

    MHS Donation Jar updates are always free. Simply exercise the Admin | Update process described here.

    MISCELLANEOUS QUESTIONS:

    Q: I'm only interested in the jar prim. Do I need the pedestal that it sits on?
    A: Yes. The internal messaging system between the various scripts requires that the MHS Donation Jar comprise a linked set (i.e., a single prim is not permissable). Unlinking the MHS Donation Jar will disable all messaging. However, if you're familiar with building things in Second Life, you could replace the pedestal with any other prim of your choosing. For example, a table! Just make sure the jar is the root prim.

    Q: Can I disable the jar's handing out of a rose?
    A: You can effectively disable that action by setting the GIFT THRESHOLD= to a very large value, say 10,000L. Also check the tickler message in the MHS Jar Config notecard to make sure it makes no reference to a rose being handed out.

    Q: Can I move the contents of the jar (scripts, et. al.) into my own prim?
    A: No. The scripts must remain in the prim that they were shipped in.

    Q: After tips are made into my jar, how do I get my money?
    A: You already have it! Just check in your SecondLife® account's Transaction History and you will see that anything paid into your MHS Donation Jar goes directly into your SL account.

    Q: How are tips different from donations? Why isn't it named the MHS Tip Jar?
    A: Some say TO-MAY-TO while others say TO-MAH-TO... it's all the same in SL!

    Q: Just wondering, how does one pronounce "MHS"?
    A: "Chargoggagoggmanchauggagoggchaubunagungamaugg" (it's French).
    Home | Intro | Overview | Notecards | Updating | Sales | TipTracer | Login

    ZappoWappy™ (c) 2006-2021