Note: The recipes here are for PmWiki versions 0.6 and 1.0 only. For PmWiki 2.0 recipes, see Cookbook.

Problem: the link to the x-chat_resource_files.zip file is not working. Someone please update the link. I can't find the files anywhere else.


This add-on allows PmWiki users to embed an java-based IRC (Internet Relay Chat) client on any WikiPage. The default (out-of-the-box) behaviour is pre-set to join the IRC channel (#pmwiki) on the irc.freenode.net server.


No Demo available yet, but as soon as Pm get's a spare moment, you can check here: X-ChatDemo?



Thanks to Priit Laes for sending me the changes to make X-Chat's output XHTML compliant.

Special Thanks

Special thanks to all the developers on the PmWiki mailing list, they're always offering suggestions and helpful tips for me when I need to figure PHP out. Did I mention I don't know much about PHP? Thanks also to the folks at http://www.pjirc.com for creating a great java plug-in.


There are two parts to this installation. First part is to enable chat in PmWiki, the second is configuration and data files for the chat-client itself.
  1. Create a new folder: /local/scripts.
  2. Save this file (x-chat.php) in the new directory.
  3. Add this line to your config.php file:
  4. Create another new folder: /pub/x-chat
  5. Copy all contents from the x-chat_resource_files.zip archive in to the new folder.
Note: If your pub folder is in a different than the location suggested above, then you will probably need to change some variables in the USER DEFINED VARIABLES section of this script.


You need both of the files listed below. The .zip files contains the java-chat-client related files, and the .php file is the actual plug-in for PmWiki which makes it all work.

x-chat.php.txt (rename this to x-chat.php)


Using this script is easy, just enter the following WikiText in any WikiPage on your site:
The java-chat client software will automatically load and be put on the page.


March 24, 2004 - Enhanced output to be XHTML compliant.
March 23, 2004 - Beta release. Please report any bugs.


I've only tested this on MSIE6.0. I'd appreciate anybody out there that is using this script successfully can post what browser and version they are using so the rest of the people will know if it's compatible or not. Thanks!

Working without issues

  • Microsoft Internet Explorer 6.0

Working with some issues

  • Mozilla 1.7a (Linux) - Applet width in % is interpreted as width in pixels
  • Epiphany 1.2.0 (Linux) - Applet width in % is interpreted as width in pixels
  • Mozilla FireFox 0.8 (Linux) - Applet width in % is interpreted as width in pixels
This problem only happens on Unix boxes. More information about this problem here:

Not working

  • Opera 7.23 (Linux) - Applet loads, but it's impossible to connect to server
  • I have Mozilla Firefox (Linux) and the applet does not start because it can't find irc.ParameterProvider class. Most probably it is related to the fact that the zip file does not contain irc.jar.

pmwiki-2.3.7 -- Last modified by {{tman}}?

from IP: ip should be disabled by default for security reasons