-- pNews 2.0.10 --
Inhaltsverzeichniss
  1. Über PNEWS
  2. Lizenzbedingungen
  3. Vorraussetzungen
  4. Installation / Setup
  5. Anpassung ans eigene Design
  6. Administration
  7. Besonderheiten / Kategorie Bilder
  8. Support
  9. Versionshistorie
Über PHP News

Powie's PHP News entstand in Anlehnung an das Gästebuch. Früher hatte ich NewsPro, ein CGI Script, eingesetzt um News auf die Homepage zu bringen. Dies brachte aber gerade in den Möglichkeiten der Anpassung nur wenig Vorteile. Deshalb entstand dieses News Script!

Lizenzbedingungen

Die aktuellen Lizenzinformationen können sie unter www.powie.de einsehen.

Vorraussetzungen

Um das Script betreiben zu können sind folgende Mindestanforderungen zu erfüllen:

Installation / Setup

Erstellen sie auf ihren Webserver ein beliebiges Verzeichnis in den sie das News Script betreiben wollen. Entpacken sie alle Dateien aus der .zip Datei und übertragen diese mit ihrem FTP Programm in dieses Verzeichnis auf den Webserver. Stellen Sie sicher das die Bilder (.gif) im Binärmodus übertragen werden. Bei Webservern auf Linux Basis achten sie auf die korrekte GROSS/kleinschreibung der Files.

Setzen sie die Unterverzeichnisse catimg und org mit ihrem FTP Programm auf CHMOD 777, damit das Script auch Files hochladen kann.

In der Datei config.inc.php3 finden sie alle relevanten Parameter um das Script an ihre mySQL Datenbank anzubinden und einzustellen. Beachten sie das alle Werte in "" eingeschlossen sind und am Ende der der Zeile ein Semikolon steht: ;

$database Der Name ihrer Datenbank auf dem mySQL Server
$sqlhost Der Hostname auf dem die mySQL Datenbank läuft. Meistens : "localhost"
$sqluser Der Username für die Datenbank
$sqlpass Das Passwort für die Datenbank. Keine Angst sieht der Besucher der News-Seite nicht !
$tab_news Tabellenname für die News
$tab_newskom Tabellenname für die Kommentare
$tab_newsuser Tabellenname für die User
$c_header Farbangabe in der Form #RRGGBB für den Tabellenkopf
$c_left Farbangabe in der Form #RRGGBB für die linke Tabellenspalte
$c_right Farbangabe in der Form #RRGGBB für die rechte Tabellenspalte
$zps News die insgesamt angezeigt werden.
$viewticker Wenn dies auf 1 gesetzt wird erscheint der Ticker oberhalb der News !
$tickerframe In diesen Frame linkt der Ticker, es kann _blank, _self, _parent etc. verwendet werden
$tickerwidth Breite des News-Tickers in Pixeln !
$headlines Anzahl der Headlines die mit dem Script "headlines.php3" angezeigt werden !
$headlinesframe FRAME auf den die Links aus den den HeadLines linken (_top, _blank, ...)
$scripturl Die komplette URL zum Script, bitte keine / am Ende ! (http://www.deineurl.de/pfad)
$time_offset Zum Anpassen der Zeit, 3600 pro Stunde
$notifyemail Neue Posts die erst freigeschalten werden müssen, werden an diese Email Adresse gemeldet
$allowsubmit wenn auf 1 gestellt können Besucher News einsenden. Diese müssen dann von einem Moderator freigeschalten werden.
$archivnews Hier kann eine Zeit in Tagen eingestellt werden , nach welcher News automatisch gelöscht werden sollen. MIN = 30 Tage

Nach der Anpassung der Parameter $database, $sqlhost, $sqluser und $sqlpass haben sie bereits Zugang zur Datenbank. Die benötigten Tabellen für das News Script erstellen sie dann automatisch mit dem Script pnews_createdb.php. Beim Aufruf werden die Tabellen erstellt sowie der Admin Account zur Verwaltung angelegt.
Die Tabellennamen müssen nicht geändert werden. Diese geben aber die Möglichkeit auf einer Datenbank 2 verschiedene Scripte zu installieren indem man die Tabellennamen einfach entsprechend ändert.
$time_offset gibt den Zeitunterschied des Gästebuches zur Serverzeit an. Somit kann man das Gästebuch genau an eine Zeitzone anpassen. Der Wert gibt den Unterschied in Sekunden an. +3600 steht für +1 Stunde, -3600 steht für -1 Stunde.

$notifyemail ermöglich es bei Einsatz von Usern als "Writer" eine Email auszulösen wenn eine News gepostet wird die freigeschalten werden muss. Hier können auch mehrere Adressen durch Komma getrennt angegeben werden ! Diese Notification kann auch an ICQ gesendet werden wenn man als Adresse "ICQ#@pager.icq.com" angibt ! Möchten sie keine Notification bekommen stellen sie $notify="", ein !

Nach der Installation ist das File p*_createdb.php aus dem Script-Verzeichnis zu löschen. Andernfalls könnten unbefugte Besucher Zugriff auf den Admin-Bereich erlangen.

Anpassung ans eigene Design

Die Datei headlines.php können sie Beispielsweise in ein Menü oder Randbereiche einbauen und dort immer die aktuellsten News anzeigen. In der Datei muss bei abweichenden Verzeichnissen der Pfad zur Konfig Datei (config.inc.php) angepasst werden.

Templates: Im Unterordner /tpl befinden sich 3 Designvorlagen für die anzeige der News. Um diese zu nutzen einfach das gewünschte File in news_row.html umbenennen.

Administration

Das Script ist ab der Version 1.5 Multiuserfähig. Adminuser haben die Möglichkeit Benutzer anzulegen die dann als Moderator alle News betreuen können oder als Author eigene News posten können und nur diese eigenen bearbeiten / löschen dürfen. 
User mit Level "Writer" haben die Möglichkeit News zu posten, diese werden aber nicht sofort ind den öffentlichen News angezeigt. Diese News können von einen Admin oder Moderator freigegeben werden. Erst dann erscheinen sie öffentlich. Alle nicht freigegebenen News werden im Adminbereich solange mit NEW gekennzeichnet bis sie freigegeben sind.
User mit Status gesperrt haben keinen Zugang mehr zu den Posting Funktionen.

Administratoren und Moderatoren haben ebenso die Möglichkeit News zu sperren und zu entsperren. Diese News werden dann öffentlich nicht angezeigt.

Besonderheiten / Kategorie Bilder

News in der Übersicht auf der Frontpage können abgekürzt werden indem der TAG <more> eingesetzt wird. An dieser Stelle wird die News später abgeschnitten und mit einem Link ergänzt. Die erste News wird nicht gekürzt !

Der News-Text kann mit einem passenden Bild zu Kategorie eröffnet werden. Die Bilder zu den jeweiligen Kategorien werden im Unterordner "catimg/" abgelegt. Benutzen sie .gif Bilder. Als Name des Bilder nutzen sie den Namen der Kategorie ! Bilder werden nur angezeigt wenn sie vorhanden sind.

Beispiel: 
Kategoriename "Allgemein" -> Bild: "Allgemein.gif"
Kategoriename "Aktuelle News" -> Bild: "Aktuelle News.gif"

welcome.html - Dieses File wird nur beim ersten Aufruf der News Seite über den News angezeigt. Das File kann beliebig mit HTML befüllt werden. Beim zweiten Aufruf bleibt dieser Part verborgen.

Support

Support für das Script erhalten sie nur im Forum auf http://www.powie.de . Bitte stellen sie keine Anfragen via Email, da ich bei der Menge an Anfragen nicht garantieren kann diese schnell zu beantworten.

Versionshistorie

So hat sich pNews über die Zeit hinweg entwickelt:

Version Released Änderungen
2.0.10 -
  • Captcha Check für News einsenden
  • News einsenden auf "User" beschränkbar
2.09 27.10.2006
  • Kommentar Spam Blocker
2.08 03.03.2006
  • Kategoriebilder Online editierbar
  • Online Setup: Willkommen Text editierbar
  • <more> Tag Steuerung ab der Xten News auf der Startseite
  • FCKeditor benutzbar
2.07 09.05.2004
  • mySQL 4.1
2.06 23.12.2004
  • Bugfix: Es konnten auch Kommentare abgegeben werden wenn diese gestoppt wurden.
  • Design Anpassungen
2.05 03.06.2004
  • Kategorie Bilder einzeln abschaltbar
  • Editor: Objekte werden an Cursorposition eingefügt
  • Kommentare: werden verhindert wenn die News gesperrt wurde.
  • Bugfixes
  • table.class
  • News Druckansicht
  • News per Email versenden
  • Bilder Upload
  • Top-Poster Liste
2.04 29.11.2003
  • Abgabe von Kommentaren lässt sich an angemeldete PSCRIPT User begrenzen
  • register_globals=off Support
2.03 25.06.2003
  • welcome.html
  • Newsformat HTML / TXT einstellbar
2.02 18.01.2002
  • RDF/XML Backend
  • Userdatenbank mit dem Forum verknüpft
  • News Darstellung als Template
2.01 04.11.2002 Zwischenrelease
2.00 07.09.2002
  • Java-Script Hilfe für HTML Codes
  • Admin-Tool
  • Archiv Bug fixed
  • P_USER Datenbank
1.93 28.04.2002
  • Kommentare zu einzelnen News können gestoppt werden
  • Expire Zeit für News kann eingestellt werden
  • IP bei Kommentaren wird gespeichert
  • Index Update
1.92 22.11.01
  • Bugfixes
  • 2 News Design's
  • Komplettes Design über CSS einstellbar
  • News werden erst nach der gültigen Zeit "öffentlich"
  • 100% mehr Performance der SQL Abfragen der News Seite
  • Kategorie Bilder
1.91 15.09.01
  • Session's zur Loginsteuerung
  • Viele Bugfixes, Timefix included
  • News können in der Übersicht gekürzt werden
1.90 24.08.01
  • Links zum Thema
  • CSS Styles an Forum und Gästebuch angepasst 
  • Frameless Optimierungen
1.8 07.08.01
  • Wortlängenbegrenzung einstellbar
  • Bugfixes / Sicherheitslücke geschlossen
  • News lassen sich vorzeitig ins Archiv verlegen
  • Kommentarfunktion für jede News einzeln an/abschaltbar
1.7 23.05.01
  • Submit Funktion
  • Logout Funktion  (Cookie löschen)
  • Many Bugfixes
  • Kategorie Auswahl "alle"
1.6 15.02.01
  • Verbesserungen bei den Möglichkeiten der Design Anpassungen! 
1.5.2 11.01.01
  • Notification bei freizuschaltenden News möglich
  • Bugfixes
1.5.1 11.01.01
  • Neuer Userlevel: Writer
  • News lassen sich sperren
1.5  04.01.01
  • Suchfunktion im News Archiv
  • Multi User Support
  • News Kategorisierbar
  • Zeit / Datum der News direkt editierbar
  • Time Offset möglich
1.4.0 12.12.00
  • Bugfixes der Kommentarfunktion
  • Headlines Support
  • News Archiv
  • Smilies
1.3.1 31.10.00
  • Bugfix: Es wurden mehr News angezeigt als bei $zps eingestellt
1.3 07.10.00
  • Bugfixes
  • News-Ticker kann angezeigt werden 
1.2  
  • Bugfix von Darstellungsproblemen in Netscape
  • Admin kann Kommentare löschen
1.0 - 1.1  
  • verschiedene Anpassungen 
1.0  
  • erste Version