MD Group Gift Giver Script – User Manual

 Quick summary:

 

 


 

Initial notes

! IMPORTANT: The following user manual presents and explains the usage and detailed features of:

  • MD Group Gift Giver Script version 3.3.0

 


 

Chapter #1: initial setup

The first setup of MD Group Gift Giver Script is very easy and quick: simply drag the MD Group Gift Giver Script provided in the pack and drop it inside the prim that will work as group gift giver. Once done, simply clicking on the prim will make a the choice menu appear. This special menu is visible only to the owner and contains two main action:

  • Owner Menu: by clicking, the owner will access to the owner menu, where its possible to configure the group gift giver.
  • Get gift: this button simulate the behavior of the group gift giver as if the owner was a ‘normal’ user.
Choice Menu

Choice Menu

 


 

Chapter #2: Owner Menu

When the owner clicks the group gift giver, the configuration menu is displayed. This particular menu – accessible by the owner only – contains all the settings and options needed to setup the group gift giver in a quick and flexible way.

md-group-gift-giver-script-02

Owner Menu

This menu is divided in many section, some of them leading into other sub menus:

  • Active: by toggling this option on, the group gift giver will be enabled and it will be possible for users to click the board and get the gifts.
  • Group Only: by enabling this feature only the users wearing a specific group’s tag will be able to get the gifts. Owner will be asked to assign the group gift giver to the desired group using the group tool that can be found under right-click > Edit >General tab. Once selected the right group, clicking on the “Group Only” button will enable the feature. When the group only mode is active clicking on the button again will disable it.
    • NOTE: leaving this option disabled, will not restrict the gift giver to a specific group’s members; however, several other options are present to manage how can access the group gift giver.
  • Gift Limit: this option will apply a maximum number of gifts that will be given out to users. Owner will be asked to submit the maximum amount of gifts and once reached that number, no more gifts will be given out. This feature can be compared to a “limited stock quantity”.
  • Reserve Gift: this button will open a submenu dedicated to configure and manage the group gift giver’s access list. It is possible, infact, to add up to 10 different avatars that will be the only ones able to get the gifts. More about this feature can be found at the dedicated chapter.
  • Manager: this button will open a submenu dedicated to configure and manage the group gift giver’s manager list. It is possible, infact, to add up to 5 different avatars that will be able to manage the group gift giver’s settings. More about this feature can be found at the dedicated chapter.
  • Blacklist: this button will open a submenu dedicated to configure and manage the group gift giver’s blacklist. It is possible, infact, to add up to 10 different avatars that will be forbidden to use the group gift giver. More about this feature can be found at the dedicated chapter.
  • Options: this sub menu groups together some optional features, such as ‘1 per avi’ mode, the minimum avatar age required, hover text and notifications. The detail of each features will be explained in the options chapter.
  • Update: this button starts the update module, which will look online for a new update of the product and – if found – deliver it to the owner.
  • Reset: this button will reset the group gift giver, wiping all the data, including options and access list.

 


 

Chapter #3: Basic Usage

The basic usage for MD Group Gitft Giver Script is very easy and quick to get: simply drop the script into the prim that will work as group gift giver along with one or more items that will be used as gifts. The usage that will suit the most cases is simply restricting the access to gifts only to members of a specific group. In order to achieve that, it’s mandatory to assign the prim’s group to the desired one:

  1. right click on the prim and select ‘Edit’.
  2. navigate to the first tab, called ‘General’
  3. At the middle of the panel, there is a ‘Group’ entry: clicking on the wrench icon next to it will popup a window containing all the available groups to choose among.
Group assignment

Group assignment

 

Once done this, click the group gift giver in order to access the Owner Menu, where the ‘Group Only’ option needs to be enabled.

The basic setup is now complete: users clicking the group gift giver will be required to wear the corresponding group’s tag active in order to get the gifts contained.

 


 

Chapter #4: Reserve Gift

MD Group Gift Giver Script allows owner to compile a list of avatar that will be the only ones able to get the gifts; this list can contain up to 10 different avatar and this feature can be used in combination with other options – such as the ‘Group Only’ – or as main working mode.

Reserve Gift

Reserve Gift Menu

From this submenu many actions can be performed:

  • Add: by clicking, owner will be asked to provide the name or key (UUID) of the avatar to add to the reserve gift list. If the value submitted is valid, the corresponding avatar will be immediately added and will be able to click and access the group gift giver script in order to get the gifts contained.
  • Remove: this button will popup a menu containing all the avatar present inside the reserve gift list and owner will be asked to pick the one to remove.
  • Remove all: this option will remove all avatars, wiping the access list.
  • List: this button will list to the owner all the avatars present in the reserve gift list.

As mentioned before, the ‘Reserve Gift’ feature can be used alone or combined with other options: infact this feature represents another filtering level to better define who can access the gifts.

For example, combining the ‘Reserve Gift’ feature with ‘Group Only’ will let only users present into the access list and wearing the correct group’s tag to receive the gifts. Similarly, other options can be added or combined to customize even more the group gift giver.

 


 

Chapter #5: Manager

Similarly to the Reserve Gift feature, MD Group Gift Giver Script allows the owner to compile a list of avatar that will be considered “manager”: this list can contain up to 5 different avatar. The managers will be able to control the group giver script in all it’s aspects just as the owner would.

Manager Menu

Manager Menu

 

From this submenu many actions can be performed:

  • Add: by clicking, owner will be asked to provide the name or key (UUID) of the avatar to add as manager. If the value submitted is valid, the corresponding avatar will be immediately added and will be able to click and access the group gift giver script’s owner menu.
  • Remove: this button will popup a menu containing all the avatar present inside the manager list and owner will be asked to pick the one to remove.
  • List: this button will list to the owner all the avatars present in the manager list.

 


 

Chapter #6: Blacklist

Another important feature of MD Group Gift Giver Script is the blacklist one; this feature allows the owner to compile a list of avatar that will be considered “blacklisted”: the avatars present in this list will not be able to get the gift contained inside the group gift giver.

Blacklist Menu

Blacklist Menu

 

From this submenu many actions can be performed:

  • Add: by clicking, owner will be asked to provide the name or key (UUID) of the avatar to add to the blacklist. If the value submitted is valid, the corresponding avatar will be immediately added and from that moment will not be able to click and get the gifts.
  • Remove: this button will popup a menu containing all the avatar present inside the blacklist and owner will be asked to pick the one to remove.
  • Remove all: this option will remove all avatars, wiping the blacklist.
  • List: this button will list to the owner all the avatars present in the blacklist.

 


 

Chapter #7: Options

In the option sub menu is possible to find some additional features aimed to enrich even more the experience with the group gift giver script.

Options Menu

Options Menu

  • 1 per avi: this option will limit the users to get the gifts only once; this feature is useful when working with no-copy items or when a gift limit is set or in general when users can’t get multiple copies of the gifts. If users will try to get gifts for a second time, a warning message will be sent to them, informing they already had the gift once.
  • Avatar age: this option will give the gifts only to avatars whose age (in days) doesn’t exceed a specific value provided. In order to enable this option, owner will be asked to submit the maximum avatar’s age – expressed in days – for the avatars to get the gifts. Avatar exceeding the value will receive a warning message.
  • Hover text: this option will display a custom text – submitted by the owner – on the group gift giver.
  • Notify: if this option is enabled, an IM will be sent to the owner every time a gift is given to someone.

 


 

Chapter #8: MD Labs Online Services

MD Labs Online Services is a responsive website, accessible from any platform from mobile devices to desktop computers, which allow to interact with the products released by MD Labs. Here’s a quick overview of what the the MD Group Gift Giver owner will be able to do:

  • Get a quick overview of all the gift givers, with locations where they are rezzed, total number of gift given;
  • View detailed graphs by giver, date (day/month/year) , region or by customer;
  • Rename a specific giver;
  • Delete all data about a specific gift giver;
  • See the transactions list for any giver;
  • Archive unused givers;
  • Delete a specific transaction from a gift giver;

 


 

Chapter #8.1: Register an account and activate the product

Before accessing the website for the first time, the owner must register an account and activate the service. In order to do so, an Online Services HUD is provided inside the MD Visitor Tracker pack.

MD Labs Online Services HUD

MD Labs Online Services HUD

Once attached the HUD, there are 2 simple steps to follow:

  1. Click on the user icon register of the HUD, and type a password  for the Online Services login.
  2. Click on the check icon activateto activate the MD Visitor Tracker for the Online Services.

At this point it’s possible to open the  MD Labs Online Services website and simply log in.

 


 

Chapter #8.2: MD Group Gift Giver homepage

Once logged in the MD Labs Online Services website, it is possible to access the MD Group Gift Giver section from the ‘Products’ dropdown list on the top of the page. The page that will load is the MD Group Gift Giver homepage and will look similar to this one:

MD Group Gift Giver – homepage

 

The webpage is divided into 2 different tabs (right under the top bar), each one containing specific features:

  • My Givers: it’s the main tab, from here is possible to access the store’s data as well as to a list of all rezzed gift givers and the detailed transactions list of each of them.
  • Archived: this tab lists all the archived givers, the ones that are not used and/or not rezzed anymore in-world. Archiving the givers help keeping data sorted and consistent.

 

The first element in the homepage is the graph panel: the data represented here will vary based on the current view selected. The default view is “by giver” and the graph will show a pie chart with all the givers and their total gift given count.

MD Group Gift Giver – homepage

MD Group Gift Giver – homepage

 

The Tools panels groups together some useful tools to analyze and manipulate the giver’s data. The most important tool of this section is the ‘view‘ drop down list which allow to group, sort and view the data in several ways:

  • by giver: this is the default view, useful to analyze the number of gifts given by each giver;
  • by region: through this view is possible to analyze which regions generate the most traffic;
  • by day: this view is useful to analyze the daily gifts given by the givers;
  • by month: this view is useful to analyze the monthly gifts given by the givers;
  • by year: this view is useful to analyze the yearly gifts given by the givers;
  • by avatar: through this view is possible to analyze the gifts given to each avatar;
  • by gift: through this view is possible to analyze the gift given by each specific gift;

Other useful tools are the ‘delete selected‘ button, which allow the deletion of multiple givers at once, and the ‘export‘ button, which allow to export the data from the current view.

 


 

Chapter #8.3: Basic operations

When the data view is set to ‘by giver‘ some basic operations will be accessible, to perform over every giver listed. These operations are:

  • Turn on/off: this switch toggles the group gift giver’s status in-world between on and off.
  • Gift limit: through this switch it is possible to toggle the gift limit feature on the gift givers in-world. When enabling it, the feature will require to provide the maximum number of gifts that will be given before deactivating the gift giver.
  • 1 per avi: through this switch it is possible to toggle the 1 per avi feature, that limit each customers to get the gifts only once.

 

MD Group Gift Giver – basic operations

 


 

Chapter #8.4: Additional operations

While the data view is set to ‘by giver‘, is possible to perform some additional operations to the group gift givers; all these features are accessible by clicking the 3-dot icon (…) on the right of the giver’s list. A drop down window will appear with the following options:

  • Rename: rename the corresponding giver in-world and on MD Labs Online Services;
  • Reset: reset the corresponding giver in-world;
  • Archive: archive the corresponding giver, removing it from in-world (if present);
  • Delete all given: delete the complete giver’s complete transactions list;
  • Delete: delete the corresponding giver in-world and from MD Labs Online Services, removing also all the transactions and settings;

 

MD Group Gift Giver – additional operations

 


 

Chapter #8.5: Giver’s details: transactions list

As said in the previous chapters, depending on the data view chosen it will be possible to view and analyze different kind of data; the most important is the data view ‘by giver‘, which is also the default one. When this data view is selected, a list of all gift givers rezzed is presented along with the region and total gifts given for each giver. By clicking on the giver’s name the details page for that specific item will load, and will look like this one:

 

MD Group Gift Giver – details

 

The ‘tools‘ panels provides some useful instruments to filter, manage and analyze the giver’s data; it is possible in fact to filter and see only the gifts given during a specific period, delete multiple transactions at the same time and export the transactions list.

The transactions panel is the main panel of this page and presents a complete list of all the gifts given; for each transaction the following data is displayed:

  • Customer’s name;
  • Gift’s name;
  • Transaction’s date & time;