Welcome to hippoTELL, an easy to use and remarkably powerful noticeboard system, allowing you to inform customers, friends and the generally interested of … well, anything you like really.
Here’s what this document describes for you …
If you look inside your hippoTELL folder in your inventory, you’ll find the following items:
- A hippoTELL noticeboard. This is copyable and modable (except the scripts) so you can resize it, retexture it etc. DO NOT UNLINK IT (or add items to the linkset) and don’t retexture the letter prims, or you’ll have a right old mess on your hands. (And this is why we make these things copyable … always keep a fresh, untinkered with version in your inventory).
- A HippoTech Website Registration Device. To use the web features of your new gadget, you will need to register with the Hippo Technologies website. Simply rez the device, touch it and you’ll be given a password to use. You can then visit users.hippo-technologies.co.uk and login.
- This notecard. Informative, fun, easy to read and printed on recycled pixels.
- An Affiliate Vendor. If you like the hippoTELL system, you can rez the vendor and sell it to friends or customers … you’ll get to keep 20% commission on each sale you make.
- A landmark to the Hippo Technologies Store. If you liked this gadget, why not stop by and see what else we have on offer.
Using your noticeboard is very simple. Just follow these steps:
- If you are not already registered with the Hippo Technologies website, rez the HippoTech Website Registration Pass found in your carton. Follow the instructions to get a password (which you can change later to something more meaningful. Do not use your Second Life password!
- Rez the hippoTELL noticeboard and it will load it’s configuration notecard.
- Click it and choose "Register" from the menu. The board will turn itself online and register with our website. If registration fails, wait a moment then click it and choose "Register".
- Visit http://users.hippo-technologies.co.uk/ (or click the noticeboard and choose "Website" from the menu).
- Login using your Second Life name and the password you were given in step (1) above. Click the hippoTELL icon and you will then see a list of your noticeboards. Tick the board (or boards) you wish to change, choose "Edit" and then enter the text, colour and alignment for each line. You can also pick a background texture (provided you have a server rezzed with textures in, see below), colour and transparency (alpha) if you wish. Once you’re done, click "OK" and the noticeboard(s) will shortly update inworld. The website communications with your board(s) via two emails, sent different routes if the Second Life Grid is performing very badly, it may take slightly longer to update your board inworld.
Inside each hippoTELL noticeboard (right click it, choose edit, then more>>> if necessary, then find the contents tab) you will find a notecard called "_config". There are four settings you can edit in here, by changing the text after the command in capitals.
OTHER USERS: Jim Monkeybrains, Pathfinder Linden, Ivor Largenose
Second,you can set a password of up to 20 letters. This password protects your noticeboard (and allows friends to change it online, more on this later).
(You can also edit the password on the website, more on this later).
IMPORTANT -> if you change the password via the configuration notecard, please re-register your noticeboard afterwards, so the website has it … otherwise comms between web and world will fail (this is a security check).
The last two options concern the ability of the noticeboard to offer to direct visitors to a website when they click it. Just provide a website (the full address, starting with http) and a message for the dialog they’ll be shown; e.g.
URL ON CLICK: http://news.bbc.co.uk
URL DIALOG MESSAGE: See what's going on in the big, wide world!
You can leave any of these settings blank if you don’t wish to use them (although we STRONGLY advise you NOT to leave the password unset).
Then close/save the notecard, click the noticeboard, choose "Reset" to reload the card and any settings you changed.
The website is very simple to use. Here are the important points:
- You need to register using the supplied HippoTech Website Registration Pass before you can interact with your hippoTELL boards on the website.
- More than one noticeboard can be updated *at the same time* simply by ticking more than one before you choose "Edit".
- If you wish to pick textures for the board’s background from the website, you need a hippoVEND (our vending system) system with some textures uploaded. If you don’t have hippoVEND, simply visit the hippoVEND store (see the bottom of this notecard for a landmark). Find the hippoVEND display on the ground floor and click the "demo" button between the vendors; you’ll get a (nearly) free demo version and the server in that can be used to host your images. (You can also grab one from Second Life Marketplace).
- If you have more than one noticeboard in operation, it may help to rename them so you don’t get confused. Right-click your noticeboard inworld, choose "Edit" and "More>>>" if necessary to expand the build dialog box. Then edit the name in the General tab. Close the build dialog, click the noticeboard and choose "Register" from the menu to save the new name to the website.
- You can delete noticeboards from the website list by clicking the icon on their row. This does not delete the noticeboard inworld, it merely removes it from your list. You can pop a noticeboard back onto the website again by resetting it and registering it again inworld.
- You can edit the passwords for your noticeboards by clicking on the "Set Passwords" link below the hippoTELL heading on the main list of noticeboards. Change any passwords you wish to, then click ‘Save Changes’. (Note that if you reload a noticeboard’s configuration card inworld, it will overwrite any password you set using the website).
If you wish a friend to be able to change a noticeboard, don’t give them your Hippo Technologies account password. Instead, send them to:
Clicking the hippoTELL noticeboard will offer up a menu to you (and to any friends specified in the "_config" notecard when they click it). The menu offers a set of very simple commands.
API is an acronym for "Application Programming Interface" and it is a means by which you can control your hippoTELL boards from your own scripts if you’re a scripter. Since this information is aimed at scripters, it’s a little technical. Please skip it if you’re not interested in scripting.
There are two ways to do send messages to your noticeboard, by linked message and by email (either from within or from outside Second Life).
6.1 Linked Messages
You can insert a script of your own into the hippoTELL unit and use the following command …
llMessageLinked(LINK_SET, -987654321, message, "");
… to set the noticeboard’s text. The message takes the same form as entering text via voice command (see above), so you can control alignment and colours with ease.
You can also set the board’s background texture, colour or alpha via linked message if you want.
Colour … llMessageLinked(LINK_SET, -700641, "<colour name or key>", "");
llMessageLinked(LINK_SET, -700641, "<1, 0, 0>", "");
Alpha … llMessageLinked(LINK_SET, -700642, "<alpha value>", "");
llMessageLinked(LINK_SET, -700642, "0.75", "");
Texture … llMessageLinked(LINK_SET, -700643, "<texture name (or part thereof), UUID key, or the word none>", "");
llMessageLinked(LINK_SET, -700643, "marbled stone", "");
Finally, linked messages can also be DETECTED by any script you insert if you so wish. So, for example, if somebody clicks on a letter on the board, you’ll get a linked message with these details …
- integer -> 9000 + the clicked prim’s link number.
- string -> CLICK^<name of person who clicked> (e.g. CLICK^Pathfinder Linden).
- key -> the UUID key of the person who clicked.
This method allows you to control a noticeboard from any other script, anywhere on the Grid, or even from outside Second Life itself. You’ll need your noticeboard’s UUID key (this gets chatted to you by the noticeboard after you reset it). You then need to send an email to….
… with the subject set to …
API^random number^your board’s password^background texture name or key^background alpha value^background colour name …
… and the message body set to the text you wish to set.
|Important: the board remembers the last five messages sent to it and will not update if the random number you include in the subject is the same as one of those last five (this is to allow you to send the same message via two email routes, if you wish, during times of Second Life lag).|
When the board gets that email, it will update accordingly. So, for example:
|MESSAGE||[centre]Hello world!|[yellow]Isn’t this neat!|
The same could be done from an LSL script …
llEmail("firstname.lastname@example.org", "API^4000^topsecret^none^1^black", "[centre]Hello world!|[yellow]Isn't this neat!");
As you can see, you can use the same message formatting tags as you can when setting text via chat.
We hope that you enjoy using your hippoTELL system. Should you encounter any problems or have any questions that reading this document cannot solve, please IM one of our technical support team, or submit a ticket at our support site, hippoSUPPORT. We try to respond to queries within 48 hours. You can also try our growing collection of Knowledge Base articles.