DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:simplechat

simplechat Plugin

Compatible with DokuWiki

2013-05-10 "Weatherwax"

plugin A simple chat window

Last updated on
2013-07-03
Provides
Syntax
Repository
Source

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

Tagged with !broken, ajax, chat

A version compatible with Greebo is waiting PR validation can be found here.

Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Examples/Usage

On the page you want a chat room add

 ~~simplechat~~ 

You should also add the

~~NOCACHE~~

tag also since this a very dynamic plugin.

A typical chat window. A simplechat chat window

Features

  • Anonymous users can be displayed as Anonymous or their IP address
  • Notifications of people entering and leaving the chat page
  • No database used
  • Each chat is kept in its own file based on page ID
  • Chat logs can be saved
  • Idle rooms can have their logs cleared
  • Commands for emotes, rolling dice, server time

Syntax

~~simplechat~~

Configuration and Settings

These settings are available in the admin configuration screen.

  • chatretentiontimer (default: 30) - How many minutes an idle room will keep the log. After this time it will delete or save the log depending upon the savelogsflag.
  • savelogsflag (default checked) - When checked the logs will be moved into a save folder and timestamped when they are cleared.
  • maxloglinecount (default 2000) - When the chat room log goes over this value it will trigger the clearing method to either delete or save the log depending upon the savelogsflag.
  • showanonymousip (default unchecked) - When checked anonymous users will show up as their IP address.

Chat Log Locations

An active chat room keeps the log in data/chats/log-roomname.txt
When a log is saved and time-stamped it is moved to data/chats/roomname/log-timestamp.txt
The log clearing routine is only checked when someone loads the page with the chat room. I keep the logs in the data directory so upgrades to the plugin wont delete the logs.

Change Log

  • 2013-07-03
    • Initial release

Known Bugs and Issues

  • Have not tested on a very heavy load

ToDo/Wish List

  • Operator controls
  • Log Viewer
  • Improved security

FAQ

The idea for this came from http://css-tricks.com/jquery-php-chat/

Please remember this is supposed to be a simple chat room. There are lots of ajax, mysql, php chat rooms out there with tons of features, but they are not as easy to setup as this one. I would like to keep it that way.

That being said, If you have some good ideas or even some crazy ones I would love to hear them. I wrote this to be part of some custom plugin I am writing for my site. If I come up with some nice features in my custom one I will try to roll it into this one.

Discussion

I could use some pointers on how to get an ajax module to read in a plugins configuration settings without much overhead. I did some tricks to pass info but I was pretty limited in what I could do with ajax.

2015 - Hrun

I like the idea of a simple and functional chat, but in Hrun version of DW it just show the frame. I can't wait the update :) — Florin

plugin/simplechat.txt · Last modified: 2020-04-01 23:49 by luffah

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