Summary: Display sidebar shoutbox
Version: 1.0
Prerequisites: pmwiki-2.2.0-beta42, Fox forms
Status: tested
Maintainer: KMcC September 27, 2007, at 01:16 AM
Categories: Forms Fox

Questions answered by this recipe

  1. How can site visitors easily communicate with each other across all my Wiki farms?
  2. How can I provide live support?


Fox-forms (no javascript), low-overhead shoutbox


After surveying dozens of shoutbox and chat alternatives, I decided to stick with a simple, low-overhead Fox-forms-based solution. A shoutbox (we call it a hollabox) can be a delightful source of wiki fun, as well as provide live help, if desired.

Installation Steps

We send all shouts across the Wiki by posting to a common page (in the example below I use Site.ShoutBox, but any common essay service page will do, of course). In the following example, you must have an Author name already established in order to participate:

1) Download and install Fox.

2) Edit any skin's sidebar wiki page (usually Site.SideBar for most skins).

3) Add the following markup:

(:if ! equal {$Author} "":)
(:fox shoutbox #top target=Site.ShoutBox:)
(:input hidden author value='{$Author}' :) 
(:input textarea class=shoutbox shout cols=20 rows=2:)
(:input submit post Enter:)
(:foxtemplate "'''{$$author}''' [-{$$(date:M j, 'y  g a)}-]\n{$$shout}[[<<]]":)
(:foxend shoutbox:)
(:include Site.ShoutBox lines=30:)
%right%[[Site.ShoutBox|more >>]]

4) Style >>shoutbox<< as a Wiki style.

Couldn't be simpler! And what FUN everyone has in hilongos!

NOTE: For a Farm installation, the Site.ShoutBox should go in the shared.d folder of your Farm.

Release Notes

Initial release -- 9/27/2007.

See Also


KMcC September 27, 2007, at 01:15 AM


User notes : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.