Pinnwand (Gästebuch-Skripte) – frei²-Opensource

Als Pinnwand wird auf dieser Webseite das Gästebuch bezeichnet, weil es sehr kompakt ist und nur über wenige Features verfügt („lediglich das Anheften eines Zettels an eine Pinnwand“). Die zugehörigen Skripte und die Konfiguration der „Pinnwand“ sind im folgenden dokumentiert:

1. Voraussetzungen zum Betrieb
2. Funktionen der Pinnwand
3. Möglichkeiten zur Konfiguration
4. Zusammenspiel mit Jlog
5. Download/Quellcode
6. Datenbank-Schema
7. Lizenz
8. Bugs, Kontakt

---

Voraussetzungen zum Betrieb

• Jlog 1.1.0 oder höher
• PHP ab Version 4.3
• MySQL-Datenbank (benötigt nur eine Tabelle)
• QuizSession-Bibliothek
• In der hier verwendeten Fassung:
  • mod_rewrite
  • Content Negotiation (Option +MultiViews)

Funktionen der Pinnwand

• Vorschau
• minimalistische Formatierung von Beiträgen:
  • Absätze
  • beliebige Sonderzeichen (über Entitäten)
• Verwendung des Zeichensatzes ISO-8859-1, passend zu Jlog
• In der hier verwendeten Fassung direkt in Jlog integriert.

Möglichkeiten zur Konfiguration

„Schöne URIs“

Bei der Verwendung von mod_rewrite lässt sich die Pinnwand auch über so genannte „schöne URIs“ aufrufen, d.h. statt /pinnwand/index.php?p=5 über /pinnwand/5. In der .htaccess werden dazu folgende RewriteRules benötigt:

# Pinnwand-Zettel abfangen
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule "^pinnwand/([0-9]+)$" pinnwand/index.php?p=$1 [QSA]

Falls die Pinnwand zusammen mit einer Jlog-Installation benutzt werden soll ist wichtig, dass diese Regel vor dem letzten Ruleset definiert wird – der Kommentar catches all pages ist wörtlich zu nehmen!

Zusammenspiel mit Jlog

TODO, siehe Jlog als CMS

Download/Quellcode

Die Pinnwand besteht aus folgenden Dateien:

Download-Archiv

enthält alle Dateien, die man zum Betrieb des Gästebuchs braucht und im folgenden aufgeführt sind:

index.php

Dies ist die Startseite der Pinnwand, die auch für die Darstellung der „Pinnwand-Zettel“ (Einträge) zuständig ist. In der hier vorliegenden Version muss mod_rewrite in der .htaccess richtig konfiguriert sein, die Zugriffsdaten für die Datenbankzugriffe sowie das Layout stammen von Jlog.

anheften.php

Dieses Skript organisiert das Verfassen und „Anheften“ eines neuen Zettels an die Pinnwand. Die Zugriffsdaten für die Datenbankzugriffe sowie das Layout stammen von Jlog.

sql.inc.php

Alle SQL-Funktionen und -hilfsfunktionen sind in diesem Modul zusammengefasst.

util.inc.php

Diese Bibliothek enthält allgemeine Hilfsfunktionen für die Pinnwand.

Datenbank-Schema

CREATE TABLE `pinnwand` (
	`lfd` bigint(20) unsigned NOT NULL auto_increment,
	`Datum` datetime NOT NULL default '0000-00-00 00:00:00',
	`Name` varchar(50) NOT NULL default '',
	`Stadt` varchar(255) default NULL,
	`Email` varchar(100) default NULL,
	`Homepage` varchar(100) default NULL,
	`Kommentar` text NOT NULL,
	PRIMARY KEY  (`lfd`)
);

Lizenz

Copyright © 2006 - 2008 Robert Bienert, alle Rechte vorbehalten

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Bugs, Kontakt

Es kann nicht ausgeschlossen werden, dass die Pinnwand Bugs enthält. Momentan existiert kein Bugtracker, allerdings können Fehler oder Anregungen jederzeit per Email (Adresse im Impressum) gemeldet werden.