Site hosted by Angelfire.com: Build your free website today!

P-News1.16  Readme

Inhalt:
1. Einleitung
2. Installation
    ٠ Template
    ٠ Includen
    ٠ Hochladen
    ٠ Setup
    ٠ Erstes Ausführen
    ٠ Quick Install
    ٠ Update
3. Funktionen
    ٠ Smilies
    ٠ Kategorien
    ٠ News Submit
    ٠ Badwords
    ٠ Language File
4. Fehlermeldungen
5. Credits  & Links

 

1. Einleitung
Hallo und vielen Dank das du dich für mein Script entschieden hast.
Mein Script ist für all die die keine eigene MySQL Datenbank haben aber trotzdem ein Featurereiches News-Script haben wollen.
In der nachfolgenden Dokumentation erfährst du alles über die Installation und die Funktionen.

Viel Spaß noch mit P-News

2. Installation
Dieses Script basiert auf reinen Textdateien, eine MySQL Datenbank ist somit nicht erforderlich :)
Ich habe versucht das Script so umfangreich wie nur möglich zu Schreiben wollte aber trotzdem nie die Benutzerfreundlichkeit aus den Augen verlieren.
Du hast nun folgende Möglichkeiten das Script zu Installieren:
    ٠ Zuerst das Design Anpassen
    ٠ Das Script in deine Vorhandene Seite einfügen
    ٠ oder Direkt mit dem Hochladen beginnen

Templates:
Die Templates dienen dazu das Script an dein Eigenes Design 100% anzugleichen.
Die kannst den Header, den Footer, die Newstabelle und die Feedbacktabelle bearbeiten und Farblich anpassen.
Das wichtigste ist, sofern du das Design anpasst, das du beim Bearbeiten die "replaces" {blablubb} nicht mutwillig entfernst.
Du kannst natürlich das eine oder andere weglassen aber um die Volle Funktionspalette  auszunutzen solltest du alle replaces in dein Template einbauen :)
Benutze einfach die nachfolgenden replaces und setzte sie einfach an die Stelle im HTML-Code wo du sie später auch haben willst.

Für die "header.html" und "footer.html" kannst du folgende replaces verwenden:
 

{news}  -> News Übersicht

{anz}  -> Gesamtzahl der News

{seiten} -> Gesamtzahl der Seiten

{admin} -> Admin Center

{anz_aktiv} -> Anzahl der noch nicht Aktivierten News

{submit} -> News Submit

{search} -> Suche

{archiv} -> Öffnet das Archiv

{logout} -> Löscht deine P-News Cookies

{kategorien} -> Dropdownfeld für die Kategorien

Für "news.html" stehen diese zur Verfügung:
 

{news} -> Die News

{comments} -> Kommentaranzeige

{titel} -> Titel der News

{datum} -> Das Datum an der die News gepostet wurden

{zeit} -> Die Zeit an der die News gepostet wurden

{related} -> Related Links

{email} -> die eMail Adresse des Autors

{name} -> Name des Autors

{kat} -> Kategorie

{more} -> An dieser Stelle wird dann die Weiterleitung zur Fortsetzung angezeigt

und schließlich für die "feedback.html" diese hier:
 

{name} -> Name des Posters

{feedback} -> Das gepostete Feedback

{email} -> eMail Adresse des Posters

{icq} -> ICQ UIN des Posters

{www} -> HP des Posters

{datum} -> Datum an dem das Feedback verfasst wurde

{zeit} -> Uhrzeit an der das Feedback verfasst wurde

{quote} -> Zitat Antwortbutton

Includen:

Wenn du das Script in deine Seite per PHP einfügen (includen) willst, so schaue dir doch das Include-Tutorial auf meiner Seite an :)

Hochladen:

So jetzt geht's ans Hochladen :)
Verbinde zu deinem Server und erstelle ein neues Verzeichnis (bsp. "news") in dieses Verzeichnis lädst du nun alle Dateien und Ordner Hoch, behalte die Ordnerstruktur auf jedenfall bei!
Wenn alle Dateien und Ordner hochgeladen sind musst du noch die Dateirechte (CHMOD) verteilen.
Alle nachfolgenden Dateien bekommen die Rechte 777:
Hauptverzeichnis:
config.php
db (Ordner)

Im "db" Verzeichnis:
badwords.txt
feedback.dat
kats.dat
news.dat
reload.dat
submit.dat
user.dat

Das wars weiter zum Set Up.

Setup:
Wenn jetzt alles an seinem Platz ist kannst du das Setup Menü aufrufen:

Bsp.: www.deineseite.de/news/setup.php
Wenn du jetzt siehst das alle Dateien existieren und schreibbar sind hast du alles richtig gemacht :)
 Das hier verlangte Passwort lautet Standartmäßig "admin"
Stelle nun die gesamten Einstellungen nach deinen Belieben ein drücke anschließend auf "Abschicken", jetzt kannst du das Script aufrufen.

Erstes Ausführen:

Jetzt wollen wir einmal kucken ob du alles richtig gemacht hast, rufe jetzt das Script per:

Bsp.: www.deineseite.de/news/p-news.php

auf.

Wenn du jetzt die ersten News siehst hat es geklappt!


Quick Install:
Für alle die nicht soviel Lesen möchten hier noch mal die Kurzfassung
1. Lokal alles Entpacken
2. Gegebenenfalls die Templates (templates/*.html) und die Texte (misc/language.php) Anpassen
3. Zum Server Verbinden und neues Verzeichnis erstellen
4. Alles in das Verzeichnis hochladen
5. CHMOD Rechte für "config.php" sowie der "db" Ordner und dessen Inhalt
6. Script zuerst mit der "setup.php" Aufrufen und Einstellungen ändern
7. Script jetzt mit "p-news.php" Aufrufen

8. FERTIG!

Update:
Wenn du das Script von einer älteren Version Updaten willst führe einfach die Datei "dbconvert.php" aus bevor du andere Einstellungen bzw. Änderungen vornimmst!
Diese Dateien musst du Hochladen:
p-news.php
admin.php
setup.php
dbconvert.php

misc/language.php
misc/cookies.php
misc/functions.php

db/badwords.txt

images/quote.gif
images/aktiv.gif

 

Für die Templates gibt es auch zwei neue replaces:

In der "header.html" bzw. "footer.html"
{kategorie}  -> "Kategorie-sortier-Dropdownfeld"

 

Und in der "feedback.html"
{quote}  ->  Wird durch dein Quote Button ersetzt

Jetzt sollte alles so funktionieren wie es soll.
 

Viel Spaß noch mit P-News


3. Funktionen
P-News hat zahlreiche Funktionen mit zahlreichen Einstellungen die ich hier ein wenig erläutern möchte.

Smilies:
Die Smilies Funktion umfasst drei Bereiche, das AdminMenü, Feedback und das SetupMenü.
Um neue Smilies hinzuzufügen lade sie einfach in den"images/smilies" Ordner hoch sie werden sofort verfügbar sein.
Willst du den neuen Smilie auch in der Auswahlliste (Feedback und News-Posten) haben musst du in das SetupMenü (setup.php).
Die nun hier aufgelisteten Smilies kannst du ALLE in die Auswahlliste verfrachten aber ich empfehle nur ca. 10 Smilies auszuwählen.
Wenn du einen Smilie in die Liste einfügen willst, klicken einfach auf ihn drauf er wird sich selbst hinzufügen ;)
Willst du einen Smilie entfernen  klicke in das Textfeld hinein und entferne den Smilie-Code (:smile:) mit, und das ist ganz Wichtig, dem direkt nachfolgendem Leerzeichen!
Nun nur noch unten auf "Abschicken" und die Auswahlliste ist Upgedatet.

Kategorien:
Um Kategorien hinzuzufügen oder zu entfernen musst du in das SetupMenü (setup.php).
Unter der Option 2 (2. Kategorien, Badwords und Smilies) findest du ein Textfeld indem du die Kategorien hinzufügen bzw. entfernen kannst.
Wichtig dabei ist es darf nur eine Kategorie pro Zeile stehen, sonst kommt es zu Komplikationen.
Die Bilder für die Kategorien kommen in den "images/kats" Ordner.

Badwords:
Mit den Badwords kann man Wörter aus Kommentaren herausfiltern und ersetzen.
Das Wichtigste ist, wie bei den Kategorien, nur ein Badword + Übersetzung in eine Zeile!
Wenn dir keine Übersetzung einfällt lasst das Übersetzungsfeld frei das Badword wird dann mit Sternchen ersetzt.

News Submit:
Mit der News Submit Funktion haben Außenstehende User die Möglichkeit News einzuschicken, die dann gegebenenfalls von einem Admin oder Moderator aktiviert werden können.

Language File:
Mit der Language File (Sprach Datei) lassen sich die gesamten Texte, die von Script generiert werden, bearbeite bzw. Übersetzen.
Diese Datei liegt (Standart) im "misc" Ordner und heißt "language.php".

4. Fehlermeldungen
Fatal error: Call to undefined function: xxx in admin.php on line XX
-> Diese Fehlermeldung tritt nur auf wenn du das Script includest und es schon eine Funktion, Array oder Variable namens xxx hast, entferne diesen Eintrag und es sollte funktionieren.

  Warning: file("xxx") - No such file or directory in /home/www/xrootx/html/x/xxx.php on line xx

-> Du hast entweder die Datei nicht im angegebenem Ordner oder du hast falsche Pfadangaben im SetupMenü gemacht oder du hast die CHMOD's nicht gesetzt.

Weitere werden folgen.. Bei Problemen -> http://www.ppopn.net/wbb


5. Credits und Links
Zuersteinmal möchte ich mich bei allen Freunden, Membern und Board-Mitgliedern bedanken dich mich Unterstützt und mich auch zu neuen Features ermuntert haben.  Danke euch Allen!

Links:
www.ppopn.net
www.ppopn.net/wbb
www.schattenbaum.net/php

by ppopn © 2002-2003