Resources

hippoTELL User Guide


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 ...

1. What’s in the carton?

2.
Getting started

3. Using the configuration notecard

4. The website

5. Menu and voice commands

6. API for scripters



1. What’s in the carton?

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.



2. Getting started

Using your noticeboard is very simple. Just follow these steps:

  1. 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!

  2. Rez the hippoTELL noticeboard and it will load it's configuration notecard.

  3. 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".

  4. Visit http://users.hippo-technologies.co.uk/ (or click the noticeboard and choose "Website" from the menu).

  5. 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.



3. Using the configuration notecard

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.

First, if you’d like to allow friends to be able to use the menu and voice commands, add their names (separated by a comma) after the OTHER USERS command.

e.g. OTHER USERS: Jim Monkeybrains, Pathfinder Linden, Ivor Largenose

etc.

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).

e.g. PASSWORD: topsecret

(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.



4. The website

The website is very simple to use. Here are the important points:

  1. You need to register using the supplied HippoTech Website Registration Pass before you can interact with your hippoTELL boards on the website.

  2. More than one noticeboard can be updated *at the same time* simply by ticking more than one before you choose "Edit".

  3. 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 free demo version and the server in that can be used to host your images. (You can also grab one from SLExchange).

  4. 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.

  5. 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.

  6. 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:

    http://www.hippo-tech-sl.com/hippotell/edit.php?NAME=yourname&PASSWORD=yourpassword

    e.g. http://www.hippo-tech-sl.com/hippotell/edit.php?NAME=Pathfinder Linden&PASSWORD=whatabighat



5. Menu and voice commands

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.

REGISTER Forces the noticeboard to register afresh with the website. Sometimes SL can play odd tricks and break the link between the noticeboard and the website; if this happens, use this command to re-register it. You can also use this command after renaming a noticeboard.
RESET Resets the noticeboard, reloads its configuration notecard and registers it afresh with the website. Use this after editing the "_config" notecard.
WEBSITE Directs you to the Hippo Technologies website, where you can edit one or more noticeboards.
TEST GIVE Tests out the giving capabilities of the noticeboard. You can, if you wish, have the noticeboard give a landmark, notecard, image, or object (or any combination) to a visitor who clicks it. To do this, just add the item you wish to give to the noticeboard's inventory.
UNREGISTER Removes the noticeboard from the website list. Use this before deleting a noticeboard so your list does not get cluttered.
HELP Gives a copy of this notecard.
BACKGROUND Offers another menu allowing you to change the board's background texture, colour or transparency (alpha). Click the button for the attribute you wish to change, then enter a value as instructed. (Known colour names are: red, blue, green, yellow, pink, white, black, orange, grey.)
ENTER TEXT

Allows you to type the text you want to appear on the noticeboard via chat. Useful if you want to quickly change the text without opening your web browser. (You can also click the round Hippo Technologies logo on the front of the noticeboard to enter text).

Please note when you're entering text that you can insert some special commands or symbols into the text:

| forces a newline (e.g. I like|roast beef|much!) ... if you actually want the | character to appear, prefix it with \, e.g. I like\|funky\|symbols

[left] - tells the noticeboard to start left aligning each line
[right] - tells the noticeboard to start right aligning each line
[centre] - tells the noticeboard to start centre aligning each line

(To get the [ to appear on the board, again prefix it with \[ e.g. We like \[brackets].

You can mix and match these commands, so for example:

[centre]Hello!|[left]Do you like my new hippoTELL|system?

The last set of commands are to change the text colour:

[red]
[yellow]
[green]
[blue]
[orange]
[black]
[white]
[grey]
[pink]

Note: you can change colours *within* a line when left aligning text; if centre or right aligning, the line must all be the same colour. The best way to learn what you can and can't do is just to play with things.



6. API for scripters

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>", "");
e.g. llMessageLinked(LINK_SET, -700641, "<1, 0, 0>", "");

Alpha ... llMessageLinked(LINK_SET, -700642, "<alpha value>", "");
e.g. llMessageLinked(LINK_SET, -700642, "0.75", "");

Texture ... llMessageLinked(LINK_SET, -700643, "<texture name (or part thereof), UUID key, or the word none>", "");
e.g. 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.

6.2 Email

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....

<noticeboardkey@lsl.secondlife.com>

... 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:

ADDRESS f9d5c2fe-d782-2260-dcb6-0214b4a9ea54@lsl.secondlife.com
SUBJECT API^4000^topsecret^none^1^black
MESSAGE [centre]Hello world!|[yellow]Isn't this neat!

The same could be done from an LSL script ...

llEmail("f9d5c2fe-d782-2260-dcb6-0214b4a9ea54@lsl.secondlife.com", "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.

We recommend to all customers that they join the Hippo Technologies Users Group in Second Life (search for it, the group is open enrollment). It’s a friendly community and lots of advice, tips and support can often be found by asking nicely!

<< Back