= IRC Logs Plugin =

== Description ==

Display logs of an IRC channel in trac

== Bugs/Feature Requests == 

Existing bugs and feature requests for IrcLogsPlugin are 
[report:9?COMPONENT=IrcLogsPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=IrcLogsPlugin&owner=pacopablo new ticket].

== Download ==

Download the zipped source from [download:irclogsplugin here].

== Source ==

You can check out IrcLogsPlugin from [http://trac-hacks.org/svn/irclogsplugin here] using Subversion, or [source:irclogsplugin browse the source] with Trac.

== Installation ==

Run "easy_install http://trac-hacks.org/svn/irclogsplugin/0.10/" for 0.10.4 trac installations

Run "easy_install http://trac-hacks.org/svn/irclogsplugin/0.11/" for 0.11+ trac installations

The IrcLogsPlugin depends on the http://swapoff.org/wiki/pyndexter python indexer.  (It is installed automatically by easy_install)

== Configuration ==

In your trac.ini file add these:

Under [Components], add:
 irclogs.irclogsplugin = enabled

Under [irclogs], add:
 path = /path/to/log/file/ChannelLogger
 
 indexer = builtin:///tmp/pyndexter.idx
 
 prefix = #roomname

This module was written assuming the use of supybot logs.  You will need to configure your supybot to output in the correct format (these are not the default for supybot):

 config supybot.log.timestampformat %Y-%m-%d %H:%M:%S |
 
 config supybot.plugins.channellogger true
 
 config supybot.plugins.channellogger.directories false
 
 config supybot.plugins.channellogger.filenametimestamp %Y%m%d
 
 config supybot.plugins.channellogger.rotatelogs true

To (re)index your log files, use this pydexter indexing python script.  Be sure to edit the two variables for file locations in the script.

== Recent Changes ==

[[ChangeLog(irclogsplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:mitsuhiko] [[BR]]
'''Contributors:''' [wiki:pacopablo] 

== Comments ==
{{{
[23:42] <Rica|Coding> Someone know the IRCLogs plugin ?
[23:43] <Rica|Coding> (and have some info about it... nothing interresting on the wiki page...) Should the log be available before processing ? or Does the plugin connect to some channels ?
[23:43] <pacopablo> Rica|Coding: it just renders logs
[23:43] <pacopablo> specifically supy bot logs
[23:44] <Rica|Coding> ^^ok
[23:44] <pacopablo> you'll need a bot to creat the logs before the plugin is sueful
}}}