IRC Content Management

Bordom.net is equipped with an IRC bot which lives in channel #bor on efnet. The bot's sole purpose in life is to monitor channel #bor and act as a gateway to the bordom.net website. It provides full content management services for the users in the channel.

Authenticating Yourself from IRC

To interface with Bordom, you must first identify yourself from IRC with the username and password that you registered on bordom.net.

/msg bordom identify [nickname] [password]

Assuming you have an account on bordom.net and your username and password match, Bordom should respond with an acknowledgement that you have been authenticated.

Bordom will also respond by granting your voice (+v) privledges on IRC.

Posting Items from IRC

Bordom grabs any urls posted to the channel, and is quite greedy. When an item is added, the bot will say "K: <title> [#N]". N is the number ID of the item and K is the letter ID. The number ID is permanent, but the letter ID is not. You may use either the item's letter or it's numeric ID, both are OK.

The letter ID is generated by Bordom when a new link is posted to the channel. Users can use this letter ID as a shorter way to refer to that link. The letter ID "A" is only 1 character, whereas the number ID's may grow quite large.

To have Bordom ignore a URL completely, prefix the URL with the ~ character.

This link will be ignored: ~http://example.com

When a URL is posted that already exists, the item is updated.

NOTE: You must be a channel operator to interact with Bordom on IRC.

To embrace the full power of Bordom content management, you must be an operator in the IRC channel.

Adding Comments

X: <comment> adds the comment to the item "X". Within the comment you can embed images, urls, and mailto links as well as add special formatting.

Example comments:

a: That's pretty funny.
a: That's pretty lamo.
r: Did you see http://www.example.com
q: +http://www.example.com/logo.gif

You can bold and italicize words and phrases in your comments by using special characters * and _. For example:

j: *this is bold*
s: _this is italicized_

You may also add your comments via the web by clicking on an item's permalink.

Deleting Comments

You can remove a comment permanently by using the trigger:

!delcomment 1234

... where 1234 is the comment's ID. There is a safeguard in place to ensure that people do not delete each other's comments. To override this feature and to delete a comment posted by a nick other than your own, use:

!delcomment 1234 --force

Tagging Items

Tags are a way to help organize the thousands of items in the database. You can tag one or more tag words to an item to help identify that item. These tag words are then used for searching, and finding other related items that share that same tag word.

Example tagging:

p: tag banana

The above command would add the tag banana to item 'p'. You may specify multiple tag words, by separating them with commas.

d: tag humor, irony, monkies, bananas

Editing Items

x: <command> performs <command> on item 'x'. X can be either the letter ID or the numeric ID. The edit commands are:

x: title <title>      Set item 'x' title to <title>
x: url <url>          Change item 'x' URL to <url>
x: caption <caption>  Set item 'x' caption to <caption>

x: excerpt <excerpt>  Set item 'x' excerpt to <excerpt>
x: image <url>        Set item 'x' image to <url>
x: thumb <url>        Set item 'x' thumbnail image to <url>

x: nick <nick>        Change item 'x' author to <nick>
x: tag <tag>          Adds tag word <tag> to item 'x' (comma separate multiple tag words)
x: untag <tag>        Removes tag word <tag> to item 'x'
x: set <z>            Adds item 'z' to a set with item 'x'
x: hide               Flags item 'x' as hidden
x: show               Flags item 'x' as visible
x: nsfw               Flags item 'x' as NSFW (not safe for work)
x: sfw                Flags item 'x' as SFW (safe for work)
x: bump               Bump item 'x' to the top
x: info               Retrieve information about item 'x'

See the illustration below for a reference of what goes where.

Real World Example

As seen from this example, the user 'adj' posts a url to the channel. Bordom snarfs it up and assigns it the letter "m". User 'adj' then edits the item by changing the item's excerpt.

Other IRC Commands

!help             Print URL of this help document
!help <cmd>       Display help for a given command
!queue            Print a summary of items in the queue awaiting moderation.
!search <word>    Search for items matching key word
!delcomment <id>  Delete comment by given comment ID
!unset <x>        Remove item 'x' from any item sets

Bordom has a quotes database too. They are displayed randomly at the bottom of this website.

!quote            Display random quote to the channel
!addquote         <quote> Add a quote