Extension:Guestbook

From MediaWiki.org

Jump to: navigation, search

         

Manual on MediaWiki Extensions
List of MediaWiki Extensions
Crystal Clear action run.png
Guestbook

Release status: stable

Implementation  Special page
Description Adds a guestbook as a specialpage.
Author(s)  Tino Reichardt
Last Version  0.13 (2007-12-29)
MediaWiki  >=1.6.0
License No license specified
Download gbook.tar.bz2
README

check usage (experimental)

Contents

[edit] Overview

This MediaWiki extension adds a guestbook to your wiki installation.

It uses the following user preferences:

  • language of currently logged in user
    • German and English are currently supported
  • the guestbook entry count per page is defined with the setting of:
preferences -> search -> Hits per page

[edit] Installation

The installation requires following steps:

  1. extracting gbook.tar.gz to "$wiki/extensions/"
  2. enabling the extension in LocalSettings.php
  3. integrate Special:Guestbook into the MediaWiki:Sidebar or create some link

[edit] Installing the files

change to the /extensions/ directory

cd /home/www/example.org/Wiki/extensions/

download the tarball:

wget http://www.mcmilk.de/projects/wiki-gbook/gbook.tar.bz2

extract the archiv and delete it:

tar xjvf gbook.tar.bz2
rm -f gbook.tar.bz2

[edit] Adjust LocalSettings.php

Add this line at the end of LocalSettings.php:

require_once("extensions/gbook/gbook.php");

You can also adjust the moderating rights for the guestbook to some user groups. The default defines, that the user of the group sysop have the ability to moderate/delete guestbook entries. As default exist this setting in gbook.php.

$wgGroupPermissions['sysop']['gbook'] = true;

[edit] Linking the Special:Guestbook

The guestbook is a specialpage, which is not shown is the Special:Specialpages overview. You can create a link to the guestbook with [[Special:Guestbook]]... thats it ;)

[edit] Styling

The guestbook uses the following css styles:

  • class successbox (creating a new entry was successful)
  • class errorbox (for all error messages)
  • class visualClear (directly after some error/success box)
  • class gbook
    • DIV Layer, which will be used around each entry
    • the class gbook is is defined in "$wiki/extensions/gbook.css" and should be adjusted

[edit] Problems / FAQ

[edit] The Captcha isn't shown or some error message is there.

  • this problem was reported by a lot of users
  • it isn't the guestbook, its a missing funtion within PHP
  • solution: build PHP yourself or install the appropriate GD package of your distribution

[edit] Links

[edit] Homepage / Installation