It's better when it's simple

User Tools

Site Tools


freechat Plugin

Compatible with DokuWiki

2014-09-29 "Hrun", 2009-12-25c "Lemming", "Frusterick Manners", "Greebo"

plugin Allow to insert and use phpFreeChat on DokuWiki

Last updated on

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Similar to chat

Tagged with chat, discussion

Download and Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually. Note: If you do install manually the directory must be named freechat.


The goal of this plugin was to provide a simple, ready to go chat system for your wiki using phpFreeChat library. It also bundles the necessary libraries so that you should not need to do any configuration to get it up and running as quickly as possible. However, I haven't thoroughly tested this point on many platforms yet, …

Syntax and usage

To use this plugin, just put this on a page:




Both will create a default chat window on the page that can be somewhat configured via the configuration page. For info about params and advanced configuration, see the phpFreeChat Official Home Page.

In order to have different chat windows in a DokuWiki installation, one can define different chatids:


chats with different chatid's function independently. However, one can only have one chat per page at the time.

The set of chat rooms to be opened by default can be controlled with the rooms= option:


opens the chat window with the two specified room tabs, the first one being the active one. Both options can be used by separating with |, e.g.



It should be obvious that chatting is done by typing your comment in the input box. However, phpfreechat understands a set of commands that are words starting with a / character. The list of available chat commands can be retrieved by typing


Refer to for documentation about these commands.

Version history

  • 2015-09-29 (current)
    • Add support for option chatid=
    • Add support for option rooms=
  • 2011-01-19
    • fix some bugs
    • add new params for admin configuration
    • add a link to demo page
  • 2011-01-14


There's always room for improvement. If you're able to add any contributions to make freechat better, please let me know or discuss your thoughts right here (please use ===== Level 2 Headlines ===== to open a new “thread”/issue and ---- (five dashes, horizontal rule) to structure it when needed).

Data folder

In terms of freechat plug-in feedback; its fantastic plug-in works works like dream. But wondering if I know, where exactly the chat data stored. Much appreciate your feedback.

All chat data are stored in data/cache/freechat folder
mluigi 2011/05/01 09:39

And how often is this purged? How can one archive it? Is it safe, in other words, and possible to retrieve at a later date? (Brilliant plugin, by the way: so very simple to set up! Thank you.)

Me too, I'm interested to learn on how not to keep it in cache subject to purge. I would like to have a history page where users can browse 'archived' messages.
deuts 2019-03-07 02:40

Feedback for Detritus

Works good so far, thanks for the awesome plugin!

fn@20060311: Here too on Detrius, but an suggest: Please dont load anything from other Sites else the own installed.

SSL/TLS Mixed Content

Hi! Thanks for the Plugin. Using it throws a mixed content warning, when using TLS on the Website. Commenting out the logo2_80x15.png in themes/default/chat.html.tpl.php helps.

You can upload to themes/default/images
And then amend
 <img src=""


 <img src="<?php echo $c->getFileUrlFromTheme('images/logo2_80x15.png'); ?>"
plugin/freechat.txt · Last modified: 2019-03-07 02:42 by deuts

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki