***************************************************************
*                                                             *
*                     LinkList 0.1 Beta                       *
*                                                             *
*               Copyleft (L) 2002 Arne Pottharst              *
*                                                             *
*              Homepage: http://linklist.arnep.de             *
*                  E-Mail: linklist@arnep.de                  *
*                                                             *
***************************************************************
*                                                             *
*     This source is under GNU/GPL General Public License     *
*                   Please read text blow!                    *
*                                                             *
***************************************************************

- Version dieses Dokumentes: 0.1 Beta
- Aktuelle LinkList-Version: 0.1 Beta
- Stand: 15.07.2002

INHALT DIESES DOKUMENTES

1. Lizenz
2. Was ist LinkList?
3. Installation
 3.1 Dateien
 3.2 Konfiguration
 3.3 Tabellen anlegen
4. Bedienung
 4.1 Kategorien
  4.1.1 Kategorien anlegen
  4.1.2 Kategorien umbenennen
  4.1.3 Kategorien verschieben
  4.1.4 Kategorien loeschen
 4.2 Links
  4.2.1 Link hinzufuegen
  4.2.2 Link suchen
  4.2.1 Link bearbeiten
  4.2.1 Link verschieben
  4.2.1 Link loeschen
  4.3 Sicherheit
5. Geschichte der Entstehung


1. LIZENZ

 Copyright (c)LinkList 2002 Arne Pottharst, linklist@arnep.de
 Please read GNU General Public License

 ### 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.
 
 Wenn jemand Vernderungen an diesem Script vornimmt, bitte
 mir Bescheid sagen, damit ich sie bei Bedarf einbauen kann.
 
 If somebody makes changes in this script, please let me know
 so that I can use your code maybe.

2. WAS IST LINKLIST?

 LinkList ist ein Script geschrieben in PHP, das eine MySQL-
 Datenbank nutzt, um persoenliche Links (Bookmarks, Favoriten)
 online zu verwalten. Es ermoeglicht das Anlegen von Kategorien
 und das automatische Einlesen von WWW-Seiten.

3. INSTALLATION

 Es muss PHP in der Version > 4 vorhanden sein, sowie eine
 MySQL-Datenbank.

 3.1 DATEIEN

  Alle PHP- und alle GIF-Dateien gemeinsam in ein beliebiges
  Verzeichnis kopieren.

 3.2 KONFIGURATION

  In der Datei "config.php" muessen folgende Anpassungen
  gemacht werden:

    $dbhost = "localhost"; # Hier steht meist localhost
    $dbname = "";          # Datenbankname
    $dbuser = "";          # Benutzername
    $dbpassword = "";      # Passwort

  Es sind zwei Bloecke vorhanden, einer mit der Bezeichnung
  "offline" und einer mit der Bezeichnung "online". "Offline"
  bezieht sich auf lokales Testen, "online" auf den Server im
  Internet.

 3.3 TABELLEN ANLEGEN

  Als letzter Schritt muessen noch die Tabellen in der MySQL-
  Datenbank angelegt werden, hierzu empfehle ich, per
  PHPMyAdmin die Datei "linklist.sql" einzulesen.

4. BEDIENUNG

 4.1 KATEGORIEN

  Alle Links werden in Kategorien einsortiert.
  Zum Wechseln in eine untergeordnete Kategorie einen Link aus
  der Liste anklicken, zum Wechsel in eine uebergeordnete
  Kategorie einen Link aus der Auswahl oben anklicken.

  4.1.1 KATEGORIEN ANLEGEN

   Um Links logisch zu sortieren, muessen als erstes Kategorien
   angelegt werden. Als einzige Kategorie ist immer "Top"
   vorhanden, dies ist die oberste Ebene. Zum Anlegen einer
   Unterkategorie auf "Kategorien bearbeiten" klicken und einen
   Namen eingeben, dann auf "Neue Unterkategorie hier
   hinzufuegen" klicken. Die Kategorie ist nun angelegt.

  4.1.2 KATEGORIEN UMBENENNEN

   kommt noch...

  4.1.3 KATEGORIEN VERSCHIEBEN

   kommt noch...

  4.1.4 KATEGORIEN LOESCHEN

   kommt noch...

 4.2 LINKS

  4.2.1 LINK HINZUFUEGEN

   Einen URL in das vorgesehene Feld eintragen und auf "Link
   hinzufuegen" klicken. Die gewaehlte WWW-Seite wird nun
   eingelesen. Sofern moeglich, werden die Felder automatisch
   ausgefuellt. "Titel" beinhaltet den Seitentitel, "Eigene
   Beschreibung" enthaelt die Seitenbeschreibung (Meta-
   description). Diese beiden Felder sollten immer, evtl. von
   Hand ausgefuellt werden, da sie spaeter im Verzeichnis
   angezeigt werden. Das "Stichwoerter"-Feld setzt sich aus
   Seitenstichwoertern und -autor (Meta-keywords, Meta-author)
   und haeufigen Woertern der Seite zusammen. Der "Seiten-
   inhalt" ist der Volltext der indizierten Seite.
   Nun muss eine Kategorie gewaehlt werden, in die der Link
   einsortiert werden soll, zuletzt auf "Speichern" klicken,
   um die eingegebenen Daten zu uebernehmen.

  4.2.2 LINK SUCHEN

   Zum Suchen eines Links in das entsprechende Feld unten auf
   der Seite ein Stichwort eingeben und auf "Volltext" klicken.
   Es werden alle Suchtreffer ausgegeben, sortiert nach den
   folgenden Rang-Kriterien: Suchwort im URL: 10 Punkte, im
   Titel: 10 Punkte, in der Beschreibung: 5 Punkte, in den
   Stichwoertern: 2 Punkte, im Volltext: 1 Punkt. Die Punkte
   werden addiert.

  4.2.1 LINK BEARBEITEN

   Das Icon des Stiftes neben dem Link klicken, dann oeffnet
   sich eine Seite zum Bearbeiten. Genauso verfahren wie beim
   Hinzufuegen eines Links

  4.2.1 LINK VERSCHIEBEN

   Das Icon des Stiftes neben dem Link klicken, dann oeffnet
   sich eine Seite zum Bearbeiten. Unten auf der Seite eine
   Kategorie aussuchen, dann genauso verfahren wie beim
   Hinzufuegen eines Links

  4.2.1 LINK LOESCHEN

   kommt noch...

  4.3 SICHERHEIT

   Ich empfehle, das Verzeichnis, in dem die LinkList-Dateien
   liegen, per .htaccess zu schuetzen, damit kein Zugriff durch
   unbefugte erfolgt.

5. GESCHICHTE DER ENTSTEHUNG

 Version 0.1 Beta (15.07.2001)
  - Kategorien anlegen
  - Links einfuegen und bearbeiten
  - Automatisches Einlesen der WWW-Seite
  - Einfache Volltextsuche mit Ranking nach einzelnen
    Stichwortern
  - keine Sicherheitstests, Variablenpruefungen etc.
  - viele fehlende Features
  - Unmengen von Bugs ;-)
