Table of Contents
freechat Plugin
Compatible with DokuWiki
- 2023-04-04 "Jack Jackrum" unknown
- 2022-07-31 "Igor" unknown
- 2020-07-29 "Hogfather" unknown
- 2018-04-22 "Greebo" yes
Similar to chat
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
.
Overview
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:
~~CHAT~~
or
{{chat>}}
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:
{{chat>chatid=chat1}}
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:
{{chat>rooms=Room1,Room2}}
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.
{{chat>rooms=Room1,Room2|chatid=chat1}}
Chatting
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
/help
Refer to http://www.phpfreechat.net/commands 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
Discussion
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 http://www.phpfreechat.net/pub/logo2_80x15.png to themes/default/images
And then amend<img src="http://www.phpfreechat.net/pub/logo2_80x15.png"to
<img src="<?php echo $c->getFileUrlFromTheme('images/logo2_80x15.png'); ?>"