*************************************************************** * * * SAMLOG: "Stand-Alone Module" Weblog * * * * * * Copyleft (L) 2002 Arne Pottharst * * * * Homepage: http://weblog.arnep.de * * E-Mail: weblog(at)arnep.de * * * *************************************************************** * * * based on BIGSAM Guestbook by * * * * Copyleft 2000 Georges Zadrozynski & Remi Lecoupe-Grainville * * gezzed@atilla.org & rlg@atilla.org * * * * Homepage : http://www.atilla.org/bigsam/ * * Mail : bigsam@atilla.org * * * *************************************************************** * * * This source is under GNU/GPL General Public License * * Please read text blow! * * * *************************************************************** - Version dieses Dokumentes: v0.5 - Aktuelle SAMLOG-Version: v0.5 - Stand: April 2002 INHALT DIESES DOKUMENTES 1. Lizenz 2. Was ist SAMLOG? 3. Installation 3.1 Dateien 3.2 Konfiguration 4. Bedienung 4.1 Das Adminmenu 4.2 Einträge machen 4.3 Einträge bearbeiten 4.4 Kommentare schreiben 4.5 Sicherheit 5. Häufige Fragen (FAQ) 5.1 Wie lautet das Passwort? 5.2 Wie lösche ich einen Eintrag? 5.3 Wie lösche ich einen Kommentar? 5.4 Was ist BBCode? 5.5 Es wird ein Fehler in der Datei ... angezeigt! 6. Geschichte der Entstehung 1. LIZENZ ### SAMLOG: "Stand-Alone Module" Weblog ### Copyright (c)SAMLOG 2001-2002 Arne Pottharst, samlog(at)arnep.de Please read original copyright ### ORIGINAL COPYRIGHT BIGSAM-GUESTBOOK ### BIG SAM - Built-In Guestbook / Stand-Alone Module - PHP Guestbook Copyright (C) Georges Zadrozynski & Remi Lecoupee;-Grainville ### GNU General Public License ### This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program 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 General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 2. WAS IST SAMLOG? SAMLOG ist ein PHP-Script zum führen eines Weblogs, d.h. eines öffentlichen Tagebuches im Internet. Es basiert auf einem Gästebuch-Script (kann auch auf http://arnep.de/scripte.html#gbook heruntergeladen werden) und hat folgende Features: - Admin-Login - Einträge nur durch Admin - Kommentare zu Einträgen durch Besucher - Formatierung der Kommentare mit BBCode - Popup-Fenster für Besucherkommentare - E-Mail-Benachrichtigung bei Kommentar - Dankes-E-Mail an Einträger 3. INSTALLATION Theoretisch muss nur die Datei samlog.php in ein beliebiges Verzeichnis kopiert werden. Fertig. Leider ist es in der Praxis oft nicht so einfach, außerdem können (sollten) noch verschiedene Einstellungen getroffen werden: 3.1 DATEIEN Die Datei samlog.php kann theoretisch einen beliebigen Namen tragen. Die beiden Dateien samlog.dat.php und samlog.comment.php passen sich automatisch an. Ebenso kann die Endung frei gewählt werden: statt samlog.php kann auch samlog.phtml o.ä. verwendet werden. Die Dateien samlog.dat.php und samlog.comment.php werden bei Bedarf angelegt, allerdings muss das Verzeichnis Schreibzugriff haben (chmod 777). Alternativ kann man beide Dateien auch von Hand anlegen und diesen Schreibrechte geben per chmod 777. Genaueres zum Setzen von Dateirechten steht in der Dokumentation des FTP-Programmes oder ist im Internet zu finden. Falls die beiden Dateien von Hand angelegt werden, sollten sie folgenden Inhalt haben (ohne die Leerzeichen am Anfang der Zeile): samlog.dat.php samlog.comment.php 3.2 KONFIGURATION In der Datei samlog.php können (und sollten) einige Einstellungen vorgenommen werden. Hier nur eine Kurzerklärung, genauere Informationen stehen in der Datei samlog.php an der ensprechenden Stelle! Configuration Step 1 : OS Auswahl des Betriebssystemes: Windows oder Unix/ Linux. Dies ist notwendig, da unter Windows die Handhabung von Dateien etwas anders abläuft als unter Unix/ Linux Configuration Step 2 : Language Auswahl der Sprache, alle nicht benötigten Sprachblöcke löschen. Zur Zeit nur gibts nur deutsch, englisch wird bald folgen, mehr Sprachen kann ich leider nicht. Wer möchte, darf übersetzen! E-Mail: samlog(at)arnep.de :-) Configuration Step 3 : Carbon Copy Email Angabe der E-Mail-Adresse sowie des Betreffs bei Benachrichtigung über einen neuen Eintrag. Außerdem noch die Wahl, ob Benachrichtigung erwünscht ist und ob der Besucher eine Dankesmail erhalten soll. Configuration Step 4 : Colors Einstellung der Farben. Nicht benötigte Blöcke weglöschen. Configuration Step 5 : Headers Kopfeintrag, alles was vor den Einträgen erscheinen soll. Configuration Step 6 : Footer Fusszeile, alles was nach den Einträgen erscheinen soll. Configuration Step 7 : Number of messages displayed Anzahl der Nachrichten, die pro Seite gezeigt werden, sowohl für den Admin als auch im Weblog an sich. Configuration Step 8 : Allow AutoLink System Wandelt Links automatisch in anklickbare Links um (bei den Besuchern). Das war alles, nun sollte das Weblog laufen. Erfahrungsberichte/ Probleme bitte an samlog(at)arnep.de schicken! :-) Der Hinweis: "Do edit below this line on your own risk, but feel free ;-)" gilt für alle, die nicht genau wissen, was PHP eigentlich ist. Alle anderen dürfen natürlich im Script "herumpfuschen", auf diese Art ist schließlich das SAMLOG entstanden. Bitte beachten: das SAMLOG unterliegt der GPL (GNU Public License), d.h. Änderungen müssen der Allgemeinheit zugänglich gemacht werden. Daher wäre es schön, wenn ich bei größeren Anderungen eine Kopie des geänderten Scriptes zugeschickt bekommen würde, vielleicht nehme ich die Änderungen ja "offiziell" auf... :-) 4. BEDIENUNG 4.1 Das Adminmenu Das Adminmenu ist ein wichtiger Bestandteil des SAMLOG, da hier die Einträge gemacht werden. Man erreicht das Adminmenu, indem man auf [!] klickt, dieses Symbol befindet sich im ganz unten auf der SAMLOG-Hauptseite. Es erscheint eine Eingabeaufforderung für das Passwort. Das Standardpasswort lautet "bigsamweblog" und sollte nach dem ersten Einloggen geändert werden! Falls das Passwort noch nicht geändert wurde, erscheint ein Hinweis. Siehe auch Punkt 5.1. Im Adminmenu erscheinen verschiedene Punkte: - "Passwort ändern" - "Eintrag machen" (Siehe Punkt 4.1) - "Einträge x-x bearbeiten" 4.2 Einträge machen Das wichtigste an einem Weblog sind natürlich die Einträge. Diese macht man im Adminmenu im entsprechenden Punkt "Eintrag machen". Es erscheint eine neue Seite mit zwei Feldern: "Titel" und "Text". Der Titel ist die Überschrift des Eintrages, dieser wird auch in der Übersicht angezeigt. Der Text ist das, was die Welt unbedingt erfahren soll, hier ist HTML erlaubt, Zeilenumbrüche werden automatisch eingefügt. Zur Erleicherung gibt es noch zwei Knöpfe: "Bild einfügen" und "Link einfügen". Es erscheinen verschiedene Dialogboxen, in die man die entsprechenden Werte wie URL oder Bildname einträgt. Wenn ein externer Link eingefügt wird (mit http:// beginnend), wird ein Symbol neben dem Link eingefügt, das den Link in einem neuen Fenster öffnet, der normale Link wird im aktuellen Fenster geöffnet. "Vorschau" zeigt eine Vorschau des Eintrages an, "Abschicken" speichert den Eintrag und wechselt ins Adminmenu zurück. 4.3 Einträge bearbeiten Beim Aufrufen der Einträge wird eine bestimmte Anzahl mit Kommentaren angezeigt, diese können bearbeitet, aber nicht gelöscht werden (siehe hierzu auch Punkt 5.2 und 5.3) ACHTUNG: Bei Opera (v6beta) kann es vereinzelt zu Problemen kommen, da das