SK Gift Giver Version 1.7

Description
========
The SK Gift Giver script can be used to create a single item gift giver that is restricted to members of your Subscriber Kiosk list and optionally the user also has your land in their profile picks . Simply put the "SK Gift Giver" script, the "ESend0" script, the optional "SK Gift Giver Picks Checker", and !Config notecard in an object of your choice (e.g. box, panel, etc.) along with your gift item, then edit the !Config notecard parameters. When a user touches the object, it will first verify they have your land in their profile picks (if you have specified the Parcel ID on the PicksList in the !Config notecard). Then it will check that they are in your subscriber kiosk. If so, they will be given the gift item. If not, they will receive a message advising them of the reason they are not eligible to receive the gift. If they are not a subscriber, they will get a popup dialog box with an option button to subscribe.

NOTE: You can get the Parcel ID for your land by putting the script named "SK Gift Giver Parcel ID" in any prim and rezzing it on the land you want the Parcel ID for. You can also get the Parcel ID from the Firestorm view at World > Parcel Details > General > Parcel ID. A Parcel ID will look similar to this: ef886230-e56b-79af-0383-bd1b9fab7966. To enable user profile picks checking, put the parcel ID on the !Config notecard line that starts PicksList=.

Networked Distribution System (NDS) Gift Requests
================================
As of version 1.7 (or later), the Gift Giver supports gift requests made by remote users (grid wide) via an NDS (sold separately). See the NDS setup instructions for details for using the GIVE_GIFT function.

Setup and Configuration
================
The !Config notecard contains all owner specified parameters for setting the following Gift Giver options. Lines starting with // are comment lines and may be deleted if desired to speed up initialization.

KioskName=
// Name of associated Subscriber Kiosk primary master kiosk.
// Enables Gift Giver to verify subscriber status in associated primary master kiosk.

OfferToSubscribe=YES
// Set to YES (default) to offer user the option to subscribe if not already a subscriber.
// Set to NO to disable option to subscribe.

KioskOwnerKey=
// Key (uuid) of Subscriber Kiosk owner only if different than Gift Giver owner.

SACName=
// Name of Subscriber Archive Controller (SAC) if you are also using archive kiosks.
// Enables Gift Giver to verify subscriber status in associated archive kiosk(s).

SubDays=0
// Number of days an avatar needs to have been subscribed before they can get the gift.

PicksList=
// Comma separated list of Parcel IDs, at least one of which must be in the user's profile picks to get the gift.
// Leave this line blank (default) if you do not want to require your land to be in the user's profile picks.

BanList=
// List of avatars, separated by commas, who are banned from using the gift giver.
// To ban everyone not in the same group as the Gift Giver object, include "NonGroup" (without quotes) in the BanList.
// No message will be sent to banned users. The Gift Giver will simply not respond to their touches.

OneTimeGift=YES
// Set to YES (default) to allow only one gift per subscriber. Set to NO to disable multiple gift prevention.

EmailAddr=
// Enter an email address to send a transaction report each time a gift is taken. Leave blank for no emails.

Owner Unique Functions
================
When the owner touches the Gift Giver, it reports the number of gifts given and the number of avatars taking gifts. These numbers may be different if OneTimeGift=NO. These counters are reset when the Gift Giver is rezzed or reset, its Contents (inventory) are changed or the !Config notecard is edited.

Limitations and Restrictions
==================
1. SK Gift Giver and associated master kiosk must be in the same sim.
2. Only one gift may be placed in the Gift Giver, and it must be an object. If you want to give several items, pack them in a box (object).

Questions and Comments
====================
Please direct any questions or comments to Fred Allandale via IM or notecard in world. You can also visit http://subscriberkiosk.wordpress.com and post any questions or comments in the support section. I will generally respond in 24 hours or less.

http://slurl.com/secondlife/Distorted/203/159/223