TikiBot
---------
$Header: /cvsroot/tikiwiki/tiki/lib/tikibot/README,v 1.1 2003/11/15 11:33:15 mose Exp $

That php bot uses SmartIRC for irc connection layer and 
Wollabot for bot behaviour and API. It uses php4 in CGI
mode, that you can use on command line or with exec().


Quick launch (unix only):
--------------------------
Edit wollabot.ini file and configure your server and channels
then execute : php4 start.php

More help 
----------
Up to date documentation : http://tikiwiki.org/TikiBot

On channel irc.freenode.net you can talk with tiki, or at 
least one lesser aspect of its personality, named tikibot. 
He answers to some words preceded by an exclamation mark (!). 
You can say the command directly on the channel, Tikibot is 
listening, he will understand it's a command and will answer 
publicly on the channel. 

You can also send him commands in a more private way (and 
less disturbing for the channel), by using a /msg irc command. 
In such case he will answer by a private message.

As tikibot is still a nOOb, his tutors can tell him what to 
say, or how to act. Don't be surprised if tikibot says hello 
and smiles, he's sort of learning to be interactive.

Its vocabulary is limited to the following possible commands :

FAQ management
!faq something
/msg tikibot !faq something
Give out the learned definition of word something. One faq is 
maintained per channel. #tikiwiki is on http://tikiwiki.org/faq.txt

!learn something the definition of something (need op)
Teaches tikibot the definition of word something. You have to be 
op on the channel to do that.

!forget something (need op)
Make tikibot forget a definition. It's required if you want to change 
a term, you have to forget it first. Needs op rights on the channel.

Remote controlling
/msg tikibot !say #tikiwiki blah blah (need op)
Make that tikibot talks on channel #tikiwiki

/msg tikibot !act #tikiwiki laughs (need op)
Make that tikibot act on channel #tikiwiki (in that example in a 
laughing manner).

Fortune cookies
!Fr
/msg tikibot !Fr
Spit out a french fortune cookie.

!Fe
/msg tikibot !Fe
Delivers an english fortune cookie.

PHP help
!php strtr
/msg tikibot !php strtr
Displays a line with php function args, commentary and url to 
documentation (for "strtr" in that example).

Google search
!G search something
/msg tikibot !G search something
Search from google.com and displays the first found results 
with URL (for "search something" in example)

!GF search something
/msg tikibot !GF search something
Search from google.fr and displays the first found results 
with URL relevant in french

!GT search something
/msg tikibot !GT search something
Search from google.com and displays the first found results 
with URL relevant on tikiwiki.org

Nickometer
!nickometer Warrior
/msg tikibot !nickometer Warrior
Display the lame percent of a nick to be used on irc.

Tikiwiki specifics
!T stats
/msg tikibot !T stats
don't work well yet

!T who
/msg tikibot !T who
lie ! lie ! lie ! bugged module

Babelfish translator
!B fr_en machin a traduire
/msg tikibot !B fr_en machin a traduire
Uses http://babelfish.altavista.com to translate words or sentences. 
From fr to en, it will translate "machin a traduire" in the example. 
Avalaible languages are
en_zh for English to Chinese
en_fr for English to French
en_de for English to German
en_it for English to Italian
en_ja for English to Japanese
en_ko for English to Korean
en_pt for English to Portuguese
en_es for English to Spanish
zh_en for Chinese to English
fr_en for French to English
fr_de for French to German
de_en for German to English
de_fr for German to French
it_en for Italian to English
ja_en for Japanese to English
ko_en for Korean to English
pt_en for Portuguese to English
ru_en for Russian to English
es_en for Spanish to English

-------
EOF

