Usage¶
Message board¶
The tribune can either be used from the web interface or via remote client applications.
Just enter in, and type your message in the input box at the bottom of the list of messages. You can use shortcut buttons to add html tags to surround your current text selection in the input (or just add it if you didn’t select text).
Also in your message you can insert smileys (commonly called totoz) from the smiley host
(by default http://totoz.eu/). Smileys syntax is to surround the smiley key word with
[:keyname]
like [:totoz]
that will be replaced to a link to the image
http://totoz.eu/totoz.gif
. This image will be displayed when the mouse cursor hovers the
link.
The default interface performs a periodical request on the remote backend to display any new message, so you don’t have to reload the page to see new message. When the the periodical refresh is on progress you will see a sign in the input, if the server return a response error you will see a sign that will be hidden at the next refresh success response.
If your posted message is not validated, the input field will be displayed with red borders, the borders will be hidden just after a new validated post.
In fact, the only option you can manage is the Active refresh that you can disable to avoid any periodical request on the remote backend. But if you disable it and you post a new message, there will still be a POST request that will refresh the message list.
Action commands¶
Action commands can be passed to message content, generally this results in doing the action without saving a new message although some actions can push a message to save.
All action command must start with a /
followed (without any separator) by the
action name and then the action arguments if any. Invalid action commands will often
result in saving the content as a new message.
- name
This allows anonymous users to display a custom name instead of their User-Agent in messages.
Name saving is made by a special cookie, so if the user loses or deletes his cookie, he loses his custom name.
Add new ua :
/name My name is bond
Remove the saved ua :
/name
Note that this name will only be directly visible for anonymous user, because registered users have their username displayed, but the name (or user-agent) is visible on mouse over their username. This behavior is only on HTML board, remote clients have their own behaviors.
- nick
- This is an alias for
name
action command, it work exactly the same. - lastfm
This command use the LastFM API to automatically post a musical instant for the current track played. This works only the current track played, not the last recent track played.
You should specify an username in argument within the action, it will be used as the username account on LastFM from where to search the current track.
Generally, you will do like this :
/lastfm instant myname
But if you are authenticated on the tribune and your username is the same as on your LastFM account, you can do like this :
/lastfm instant
This will result in a message like this :
====> Moment Artist - Title <====- bak
Intended for users to manage their message filters, see Message filtering system for a complete explanation.
If you want to avoid displaying message from the registered user
BadBoy
, you will do :/bak add author Badboy
You want to avoid displaying all message containing a reference to
http://perdu.com
you will do :/bak set message *= http://perdu.com
You want to avoid displaying message from all user with an user-agent from
Mozilla
:/bak set ua *= Mozilla
Discovery¶
Discovery files describes the needed configuration to use a tribune with third client applications.
They are simple XML files for describe configuration to access to the remote backend and to post new message, plus some other options and parameters.
You can access them at location /discovery.config
under the path of the tribune,
so for the default tribune this is usually :
/tribune/discovery.config
And for a channel with the slug name “foo”, it will be :
/tribune/foo/discovery.config