Extension:Guestbook

From MediaWiki.org

Jump to: navigation, search
Manual on MediaWiki Extensions
List of MediaWiki Extensions
Guestbook

Release status: stable

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

Contents

Overview

This MediaWiki extension adds a guestbook to your wiki installation.

It uses the following user preferences:

  • language of currently loggoed 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

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

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

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;

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 ;)

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

Problems / FAQ

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

Links

Homepage / Installation

Personal tools