Chat_XH facilitates to have an arbitrary amount of simple chat rooms or shoutboxes on your website. Users that are logged in via Memberpages_XH or Register_XH are recognized as such; other visitors can send messages anonymously.
Please do read this documentation, before you encounter any problems!
Chat_XH couldn't be tested so far in various environments. It is a so called beta version. Use with caution!
Chat_XH is a plugin for CMSimple_XH. It requires CMSimple_XH ≥ 1.6 and PHP ≥ 5.0.0.
The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.
Note that the chat data files can be accessed directly by requesting their URL. A .htaccess file to prohibit this is already contained in the default data folder. For other servers or for custom data folders you have to take for yourself, that those data are protected from non authorized access.
The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select Plugins → Chat.
You can change the default settings of Chat_XH under "Config". Hints for the options will be displayed when hovering over the help icon with your mouse.
Localization is done under "Language". You can translate the character strings to your own language, if there is no appropriate language file available, or customize them according to your needs.
The look of Chat_XH can be customized under "Stylesheet".
Embedding of a chat room on a page is done with the following plugin call:
{{{chat('%CHAT_ROOM%');}}}
To embed a chat room in the template, insert:
<?php echo chat('%CHAT_ROOM%');?>
%CHAT_ROOM% is the name of the chat. It can be choosen arbitrarily, but may contain only lowercase alphanumeric characters (a-z and 0-9) and hyphens. Some examples:
{{{chat('chat');}}}
{{{chat('chat17');}}}
{{{chat('women-only');}}}
You can embed as many chat rooms on any single page as you like—they're working independent of each other as long as they have different names.
After a configurable time of inactivity (i.e. no new messages are posted), the chat history will be purged automatically.
If you want to edit the chat data files, you have to do this via FTP.
If JavaScript or Cookies are disabled in the visitor's browsers, or in case the browser doesn't support the required JavaScript (e.g. IE 6 and older), the automatic retrieval of new messages doesn't work. Instead the visitor has to refresh his browser to see them.
Displaying the currently logged in users is not yet implemented. For a workaround regarding Memberpages_XH see the CMSimple_XH Forum.
Chat_XH is licensed under GPLv3.
© 2012-2014 Christoph M. Becker
Czech translation © 2012 Josef Němec
Slovak translation © 2012 Dr. Martin Sereday
Chat_XH was inspired by scriptshow's MiniChat.
The plugin icon is designed by Alessandro Rei. Many thanks for publishing this icon under GPL.
This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.
Many thanks to the community at the CMSimple_XH forum for tips, suggestions and testing. Particularly I want to thank snafu for giving the first feedback.
And last but not least many thanks to Peter Harteg, the "father" of CMSimple, and to all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.