Sloodle Object Distributor
From SLIS Second Life Wiki
Contents |
[edit] Summary
The Object Distributor was introduced in Sloodle 0.2, and can be rezzed from a Sloodle Set (versions 0.702 and later). It allows in-world distribution of objects to avatars, and can be controlled/used in several ways:
- in-world, using one or more Sloodle Object Selectors
- within Moodle, using the Moodle Distribution Interface
- by a script or other website by accessing the Object Distribution Linker script
[edit] Compatibility
The Object Distributor is a sub-component of the Sloodle Set, so please check the Sloodle Set Compatibility information.
[edit] Setup
[edit] Automatic Configuration
The Object Distributor is distributed as part of the Sloodle Set. It is recommended that you use the official Sloodle.org Object Distributor to obtain an appropriate Set for your Sloodle version. Rez and configure the Sloodle Set, and click on the object vendor box (the tall one in the middle). Select the "Object Distributor" option from the dialog that appears, and an Object Distributor should be rezzed for you.
The Sloodle Set will automatically configure the Object Distributor for you, so it should be ready to use.
WARNING! You can only use *one* Distributor with a Moodle site at any one time. We will introduce support for multiple distributors in the future, but for the time being, the most recently rezzed Distributor takes precedence. You need to manually reconnect an old Distributor if have rezzed another since then.
NOTE: You can have as many Sloodle Object Selectors as you like, which allows people access to the Distributor from multiple locations.
[edit] Notecard Configuration
As with many Sloodle objects, if you prefer you can configure the Object Distributor manually using a notecard. It uses the same format as the 'sloodle_config' notecard for a Sloodle Set, so you can use the Sloodle notecard setup page on your Moodle site to generate one (if you are an administrator). The text from there should be placed into a notecard called "sloodle_config" in the Object Distributors's inventory.
You will need to reset the Distributor if you change the configuration notecard. This can be done by clicking it, and selecting "Reset" from the menu.
Notecard configuration is useful because:
- it will not lose its configuration when it is reset
- it does not require the use of a Sloodle Set every time
- it can be slightly more secure than automatic configuration
[edit] Usage
Only the owner of the Object Distributor can interact directly with it in-world.
When you have rezzed an Object Distributor, it will try to connect automatically. However, you will probably need to add items to its inventory. To do so, right-click it, select "Edit", and click the "Contents" tab. You can click and drag items into its inventory. You can add any item and types you like (e.g. objects, notecard, scripts, textures etc.), so long as their names do not conflict with any of the standard scripts or the "sloodle_config" or "sloodle_config_sample" notecards.
When you have changed the inventory of the Distributor, you will need it to reconnect so that it will update the Moodle site with its list of inventory. Do this from the Distributor menu.
[edit] Distributor Menu
If the owner of the Distributor touches it in-world, then a menu will be displayed, with the following options:
[edit] Reconnect
This option will keep the current configuration, but will re-establish the connection with the Moodle site, and send an update-to-date list of its inventory. This is useful if you have rezzed a second Distributor for the same site, but want to use the first one again. It is also useful if you have changed the inventory of the Distributor.
[edit] Reset
This will literally reset the whole object, which is useful if an error has occurred, or if you have changed the configuration notecard.
WARNING! If you have rezzed the Distributor from a Sloodle Set, then the automatic configuration settings will be completely lost if you reset it. You will need to provide a "sloodle_config" notecard to configure it, or delete it and rez another Distributor from the Sloodle Set.
[edit] Shutdown
If you do not want anybody to use the Distributor, then you can make it shutdown. This means that it will not accept any requests for objects to be distributed until you click it again, and select "Reset" or "Reconnect".
| This page is part of the Sloodle documentation | |||
|---|---|---|---|
| SloodleDocs Home | User Documentation | Administrator Documentation | Developer Documentation | Sloodle Wiki Home | |||
