Mars Welcome Mat Version 005

Mars Welcome Guide
-------------------------
This welcome mat has a number of features to assist tracking of your visitors & welcoming them to your area (store, club etc).

* Provides new visitors with any landmarks, notecards or gifts
* Welcomes returning visitors but doesn't spam them
* Tracks up to about 1800 distinct visitors (returning visitors count as one)
* Uses the latest Linkset Data database procedures so data is immune to script resets
* Provides owner with statistics / full list when requested
* Optionally invites visitors to a group of your choice if they are not already wearing a member tag
* Optionally checks if visitors have joined your experience and if not invites them
* Mesh design (including detachable 3D Welcome sign)
* COPY/MOD

It requires some minor configuring to set up.

Installation
------------

1. Rez the mat & resize / position / texture as required

The mat is initially two linked mesh prims. Each may be individually resized/textured (feel free to take a copy of the welcome text & use elsewhere).

The scripts may be moved into other objects if required, they should still operate.

2. Set the mat description to the startup parameters (comma separated with no spaces)

a) initial number of visitors (for carrying on from a different welcome mat for example)
b) the scan range in whole metres if you want to scan every minute as well as rely on people walking over the mat. Zero stops scanning & mat just relies on people stepping on it.

Parameters are comma separated so
0,10
will start the mat from visitor zero and as well as collision events triggering checks additionally scans 10m around the mat (sphere).

3. Edit the welcome message you wish to display (as an IM in chat) to visitors - notecard : "Welcome Message".

This is sent as a single text string so should be limited to 1023 characters (for more use a notecard).

4. Edit the group invite message if you would like your visitors to join a group - notecard : "Group Invite"

A group invite may easily be generated from the groups profile by clicking Copy URI and pasting into the notecard unaltered.

Set the mat's group to the group you wish to check visitor membership of.

If you don't want to check/invite to groups simply delete the notecard.

Again this string is added to the welcome message and the whole must be under 1023 characters.

5. Insert into the welcome mat inventory any items you wish to give (landmarks, rules notecards, gifts etc.).

The only thing you should avoid are scripts - if you add any then they will be ignored by the inventory giver.

6. If you have an Experience set up and enabled on the parcel you plan to rez the mat then edit the "Check Experience" script in the mat contents.

Select your Experience in the dropdown menu in the script editor & select Save to recompile using your own Experience.

Edit the optional notecard to explain more about your Experience : "Experience Invite"

Alternatively if you do not have an experience leaving this script active will check for the Mars Experience.

Deleting or better still marking the script as not running (uncheck running) will disable the Experience checks. Also remember to delete the "Experience Invite" notecard if not needed.

You should not need to modify the code but you are welcome to do so at your own risk.

You are welcome to use this script in your own systems provided you leave the copyright

Operation
------------

Visitors who walk on the mat / collide with it and are in sensor range (if activated) will be considered for welcoming.

As their visit details are stored on a database the first check is if they are entirely new. If so they receive the welcome message, group message and any LM's/Gifts etc.

Any returning visitors (over 1 hour since they last visited) are greeted only and told when they last visited.

If the free memory in the Linkset Data (64k to start with) drops below 5k the oldest entries are deleted automatically.

Owner Statistics
-------------------
If you are interested in tracking who/how many visitors you have had just click the mat.

Initially you are given a couple of lines of statistics but clicking a second time within 30 secs will list everything from the database.

If you want to empty the database you need a script that issues llLinksetDataReset( ); to empty the database :-

default
{
state_entry()
{
llLinksetDataReset( );
llOwnerSay("Reset complete");
}
}

Let it run until completion & delete it.

See item in Second Life