Ihoss Extension: BBTags Tutorial

BBTags

Adding a criteria

When you submit a message the extension will first check if the page passes one or more of the criteria you have set. If you want the extension to parse any page and not check if it meets any of the criteria, then you can set that in the options. Pages that do not meet the criteria will have a white paper with a + in it in the statusbar ([+]) and if you click on it the Add Criteria dialog opens. It will by default have the url of the current site but you can edit it to anything you want. For example you could enter ihoss and then any url with ihoss would pass the criteria. If the icon is just a blank page ([ ]) then the site already passes the criteria. If you click on this icon the Options dialog will open and in the Criteria tab you can see all the criterias. Here you can add, edit and delete criterias.

Installing a Tag

To install a tag you right click on a link to it (you can use this) to bring up the context menu. Click on BB Tags>Install. You will now get a confirmation message with the entire file so you can check if you want to install it or not. If the tag is installed then instead you will get a message stating just that. If you accept to install the tag then it will install and an "installation complete" message will appear.

Submitting a form

Make sure you have installed a tag and added a criteria that this page meets before going on. To use tags all you have to do is type your message into a textarea (the large textboxes, like the one below). Enter the message you want to submit one or more of the tags. You can try entering \google::Ihoss\ in the form below and clicking submit. If you don't want the textarea parsed then enter \no\ as the very first thing in the textarea.

Making a tag

This part is not important for a normal user, but if you want to make your own tags then I will explain here. Have a look at a tag file (like Scramble). You will notice that the first line has information about the tag. This line should contain the name of the tag, the author and a simple example of how to use it. The data is seperated by ','. From line 2 and on the scripting starts. Each script line starts with a single character and then the parameter. The character tells the engien what function to run, and the parameter is passed into the function. Below is the meaning of all the characters:

CharacterMeaning
rReplace, replace(#,#+1);
wWith, put this line after a replace line
mIf Match, match(#); does the next lines if # is found in the text
nIf Not Match, !match(#); does the next lines if # is not found in the text
eEnd If, if m or n return false then parsing starts from here again
vEval, eval(#) evaluates the #. You can add this after a replace instead of w or alone

#=value of the line excluding the function character, for now you can't nest m or n, and v has not yet been implimented!

Tags

NameAuthorExample
GoogleMarius Gundersen\google::ihoss\
MySiteMarius Gundersen\home::index.php::click here\
ScrambleFredi Bach\scramble\
ShuffleFredi Bach\shuffle\
SmiliesMarius Gundersenlots of smilies, like <_< and _?_

Test Form