1st News Version 3 – Personal

1st News Version 3 – Personal
Installationshandbuch
1st News Version 3 – Personal...........................................................................................................................1
Vorwort ..............................................................................................................................................................1
Funktionen ........................................................................................................................................................ 2
Änderungen/Neuerungen/behobene Fehler.............................................................................................. 2
Installation ....................................................................................................................................................... 2
Voraussetzungen ......................................................................................................................................... 2
Update von Version 2.1 ........................................................................................................................... 3
Update von Version 2.0.X oder älter ................................................................................................. 5
Neuinstallation ............................................................................................................................................ 7
Support.............................................................................................................................................................. 8
Vorwort
“1st News” verfügt in der neuen Version über einige neue Funktion, eine neue einfachere
Benutzerführung sowie über zahlreiche Optimierungen und Änderungen im Sourcecode. Alle mir
bisher bekannten Bugs bzw. Fehler konnten offensichtlich behoben werden.
Um den Umgang mit dem Script zur vereinfachen wurden im ACP „Admin Control Center“ einige
Überprüfungsroutinen mit Java-Script realisiert. Es ist deshalb erforderlich als Administrator
Java-Script im Browser aktiviert zu haben.
Das Script wurde in dieser Version zahlreichen Tests auf verschiedenen Systemen mit
unterschiedlichsten Browsern unterzogen, dennoch kann absolute Fehlerfreiheit von meiner
Seite aus leider nicht garantiert werden. Sollten Sie also einen Fehler entdecken, dann Erstellen
Sie bitte einen neuen Beitrag mit einem aussagekräftigen Betreff in unserem Support-Forum, zu
finden unter http://www.coder-treff.de.
Stephan Altmann
1st News 3 Personal
Seite 1
Funktionen
Versenden einer Registrierungsmail mit Bestätigungscodeode
Versenden von HTML- oder Text-Mails
Versenden eines Attachments
Schnellauswahl für das Einfügen von HTML-Codes
Verschlüsseln und Versternen der Passwörter
Speichern der Newsletter im Archiv (optional)
Editieren der Einstellungen im ACP
Umfangreiche Log-Funktion
Templatesystem
integrierter Templateeditor
Installations- und Updatescript
Codegenereator zur Ausgabe des HTML Codes für Einbettung in Homepage
Vorschaufunktion (für HTML- und Textmails)
bequeme Verwaltung der Mailadressen
Speichern der Mailadressen in einer Textdatei, MySQL wird nicht benötigt
Automatisches Durchsuchen der Datenbank um wiederholtes Eintragen einer Mailadresse zu verhindern
praktisch unbegrenzt große Mailingliste realisiert mit Hilfe eines wiederholten Reloads der Versendeseite zum
Umgehen des Servertimeouts
Uneinsehbare Daten (PHP-Dateien)
Suchfunktion
Geordnete Empfängerausgabe
Änderungen/Neuerungen/behobene Fehler
integrierter Templateeditor
neues Templatesystem (klassenbasiert)
neues Layout
verbesserte Benutzerführung
verbesserte Vorschaufunktion (HTML-/Text-Code wird wie in Mail dargestellt)
Optimierung der Mailheader (Beseitigung diverser Fehler)
Installations- und Updatescript
Umgehen des Servertimeouts beim Versand der Mails (geteiltes Versenden)
Optimierung des Codes
Uneinsehbare Daten (PHP-Dateien)
Installation
Voraussetzungen
-PHP Version 4.0.2 oder größer
-aktivierte Dateiuploads (empfohlen – erforderlich für das Versenden von Attachments)
Für die Verwaltung wird die aktuelle Version eines der folgenden Browser empfohlen:
Internet Explorer 6
Netscape Version 7
Opera Version 7 (einige kleine Fehler in der Darstellung)
1st News 3 Personal
Seite 2
Update von Version 2.1
1.)
Entfernen Sie sämtliche Dateien außer der Mailingliste (mail.txt) von Ihrem Server und laden
Sie sämtliche Dateien aus dem Ordner „Upload“ vom Archiv auf Ihren Server.
2.)
Legen Sie anschließend folgende Schreibrechte für folgende Dateien fest (Näheres dazu in der
Hilfe Ihres FTP-Clienten):
Konfigurationsdatei
- Datei lib/config_data.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Einträge
- Datei entries/log.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei entries/mail.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei entries/protect.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Templates
- Ordner templates – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_done.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_exists.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_incorrect_mail.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_not_in_db.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_no_mail.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_no_rights.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_removed.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/footer.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/head.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/index.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/layout.css – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_done.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_exists.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_incorrect_code.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_no_code.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_no_rights.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Weitere
- Ordner acp – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Ordner acp/archiv – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
3.)
Rufen Sie im Browser die Datei setup.php im Stammverzeichnis des Newsletterscriptes auf.
3.1)
Nach dem Aufruf dieser Datei werden zuerst die Schreibrechte aller Dateien überprüft.
Erscheint hinter allen Einträgen ein grünes „Ok“ dann können Sie mit einem Klick auf den Link
„Weiter>>“ fortfahren. Ist das nicht der Fall dann korrigieren Sie gegebenenfalls die
Schreibrechte der entsprechenden Dateien und wiederholen Sie den Vorgang
(Aktualisierungsfunktion des Webbrowser) bis alle Schreibrechte korrekt vergeben sind. Fahren
Sie nun fort.
1st News 3 Personal
Seite 3
3.2)
Auf der folgenden Seite wird die aktuelle PHP-Version und die maximale Größe für Dateiuploads
überprüft. Werden die Ergebnisse in grüner Farbe ausgegeben sind alle Einstellungen korrekt,
andernfalls sollten die Servereinstellungen geändert bzw. der Hoster benachrichtigt werden.
Lässt sich das Problem nicht beheben müssen Sie auf den Versand von Mails mit Attachement
verzichten.
Nun müssen Sie einen Installationstyp festlegen, wählen Sie für das Update den Eintrag „Update
von Version 2.1“ und fahren Sie mit einem Klick auf den Button „Weiter“ fort.
3.3)
Auf der folgenden Seite sollten Sie den relativen Pfad zur alten Datei mit den Maileinträgen
angeben.
Beispiel: mail.txt oder ordner/mail.txt
Fahren Sie fort mit einem Klick auf den Button „Weiter“.
3.4)
Die Einträge werden nun in der Datei „entries/mail.php“ gespeichert. Erscheint eine
Fehlermeldung ist offensichtlich der Pfad zur alten Mailingliste nicht korrekt. Kehren Sie zurück
(Link „Zurück“) versuchen Sie es erneut. Fahren Sie abermals mit einem Klick auf den Link
„Weiter>>“ fort, wenn das Update erfolgreich ausgeführt werden konnte.
3.5)
Auf der folgenden Seite können Sie die Grundeinstellungen festlegen. Diese Einstellungen können
im nachhinein jederzeit über das ACP abgeändert werden. Bestätigen Sie die Eingaben mit einem
Klick auf den Button „Speichern“.
3.6)
Anschließend erhalten Sie die Meldung, dass die Einstellungen erfolgreich gespeichert werden
konnten. Fahren Sie wie bekannt fort.
3.7)
Zum Abschluss sollten Sie jetzt ein Passwort festlegen. Bitte beachten Sie, dass die Eingaben
beider Felder übereinstimmen, ansonsten erhalten Sie eine entsprechende Fehlermeldung. Das
Passwort wird gespeichert, nachdem der Button „Speichern“ betätigt wurde.
4.)
Nach einem erneuten Klick auf „Weiter>>“ erhalten Sie die Meldung, dass die Installation
erfolgreich abgeschlossen werden konnte. Sie können Sich jetzt in das ACP mit Ihrem soebend
festgelegten Passwort einloggen. Das Passwort können Sie ebenfalls im nachhinein jederzeit
ändern. Haben Sie kein Passwort angegeben, brauchen Sie beim Login kein Passwort angeben.
!!! Sie sollten nun Ihre alte Datei mit den Maileinträgen , sowie die Setup.php vom Server
entfernen.
1st News 3 Personal
Seite 4
Update von Version 2.0.X oder älter
1.)
Entfernen Sie sämtliche Dateien außer der Mailingliste (mail.txt) von Ihrem Server und laden
Sie sämtliche Dateien aus dem Ordner „Upload“ vom Archiv auf Ihren Server.
2.)
Legen Sie anschließend folgende Schreibrechte für folgende Dateien fest (Näheres dazu in der
Hilfe Ihres FTP-Clienten):
Konfigurationsdatei
- Datei lib/config_data.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Einträge
- Datei entries/log.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei entries/mail.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei entries/protect.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Templates
- Ordner templates – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_done.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_exists.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_incorrect_mail.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_not_in_db.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_no_mail.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_no_rights.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_removed.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/footer.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/head.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/index.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/layout.css – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_done.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_exists.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_incorrect_code.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_no_code.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_no_rights.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Weitere
- Ordner acp – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Ordner acp/archiv – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
3.)
Rufen Sie im Browser die Datei setup.php im Stammverzeichnis des Newsletterscriptes auf.
3.1)
Nach dem Aufruf dieser Datei werden zuerst die Schreibrechte aller Dateien überprüft.
Erscheint hinter allen Einträgen ein grünes „Ok“ dann können Sie mit einem Klick auf den Link
„Weiter>>“ fortfahren. Ist das nicht der Fall dann korrigieren Sie gegebenenfalls die
Schreibrechte der entsprechenden Dateien und wiederholen Sie den Vorgang
(Aktualisierungsfunktion des Webbrowser) bis alle Schreibrechte korrekt vergeben sind. Fahren
Sie nun fort.
1st News 3 Personal
Seite 5
3.2)
Auf der folgenden Seite wird die aktuelle PHP-Version und die maximale Größe für Dateiuploads
überprüft. Werden die Ergebnisse in grüner Farbe ausgegeben sind alle Einstellungen korrekt,
andernfalls sollten die Servereinstellungen geändert bzw. der Hoster benachrichtigt werden.
Lässt sich das Problem nicht beheben müssen Sie auf den Versand von Mails mit Attachement
verzichten.
Nun müssen Sie einen Installationstyp festlegen, wählen Sie für das Update den Eintrag „Update
von Version 2.0.X oder älter“ und fahren Sie mit einem Klick auf den Button „Weiter“ fort.
3.3)
Auf der folgenden Seite sollten Sie den relativen Pfad zur alten Datei mit den Maileinträgen
angeben.
Beispiel: mail.txt oder ordner/mail.txt
Fahren Sie fort mit einem Klick auf den Button „Weiter“.
3.4)
Die Einträge werden nun in der Datei „entries/mail.php“ gespeichert. Erscheint eine
Fehlermeldung ist offensichtlich der Pfad zur alten Mailingliste nicht korrekt. Kehren Sie zurück
(Link „Zurück“) versuchen Sie es erneut. Fahren Sie abermals mit einem Klick auf den Link
„Weiter>>“ fort, wenn das Update erfolgreich ausgeführt werden konnte.
3.5)
Auf der folgenden Seite können Sie die Grundeinstellungen festlegen. Diese Einstellungen können
im nachhinein jederzeit über das ACP abgeändert werden. Bestätigen Sie die Eingaben mit einem
Klick auf den Button „Speichern“.
3.6)
Anschließend erhalten Sie die Meldung, dass die Einstellungen erfolgreich gespeichert werden
konnten. Fahren Sie wie bekannt fort.
3.7)
Zum Abschluss sollten Sie jetzt ein Passwort festlegen. Bitte beachten Sie, dass die Eingaben
beider Felder übereinstimmen, ansonsten erhalten Sie eine entsprechende Fehlermeldung. Das
Passwort wird gespeichert, nachdem der Button „Speichern“ betätigt wurde.
4.)
Nach einem erneuten Klick auf „Weiter>>“ erhalten Sie die Meldung, dass die Installation
erfolgreich abgeschlossen werden konnte. Sie können Sich jetzt in das ACP mit Ihrem soebend
festgelegten Passwort einloggen. Das Passwort können Sie ebenfalls im nachhinein jederzeit
ändern. Haben Sie kein Passwort angegeben, brauchen Sie beim Login kein Passwort angeben.
!!! Sie sollten nun Ihre alte Datei mit den Maileinträgen , sowie die Setup.php vom Server
entfernen
1st News 3 Personal
Seite 6
Neuinstallation
1.)
Laden Sie sämtliche Dateien aus dem Ordner „Upload“ vom Archiv auf Ihren Server.
2.)
Legen Sie anschließend folgende Schreibrechte für folgende Dateien fest (Näheres dazu in der
Hilfe Ihres FTP-Clienten):
Konfigurationsdatei
- Datei lib/config_data.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Einträge
- Datei entries/log.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei entries/mail.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei entries/protect.php – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Templates
- Ordner templates – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_done.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_exists.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_incorrect_mail.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_not_in_db.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_no_mail.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_error_no_rights.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/action_removed.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/footer.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/head.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/index.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/layout.css – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_done.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_exists.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_incorrect_code.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_no_code.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Datei templates/save_error_no_rights.htm – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
Weitere
- Ordner acp – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
- Ordner acp/archiv – Schreibrechte (CHMOD 777 bzw. 666 auf einigen Servern)
3.)
Rufen Sie im Browser die Datei setup.php im Stammverzeichnis des Newsletterscriptes auf.
3.1)
Nach dem Aufruf dieser Datei werden zuerst die Schreibrechte aller Dateien überprüft.
Erscheint hinter allen Einträgen ein grünes „Ok“ dann können Sie mit einem Klick auf den Link
„Weiter>>“ fortfahren. Ist das nicht der Fall dann korrigieren Sie gegebenenfalls die
Schreibrechte der entsprechenden Dateien und wiederholen Sie den Vorgang
(Aktualisierungsfunktion des Webbrowser) bis alle Schreibrechte korrekt vergeben sind. Fahren
Sie nun fort.
1st News 3 Personal
Seite 7
3.2)
Auf der folgenden Seite wird die aktuelle PHP-Version und die maximale Größe für Dateiuploads
überprüft. Werden die Ergebnisse in grüner Farbe ausgegeben sind alle Einstellungen korrekt,
andernfalls sollten die Servereinstellungen geändert bzw. der Hoster benachrichtigt werden.
Lässt sich das Problem nicht beheben müssen Sie auf den Versand von Mails mit Attachement
verzichten.
Nun müssen Sie einen Installationstyp festlegen, wählen Sie für das Update den Eintrag
„Neuinstallation“ und fahren Sie mit einem Klick auf den Button „Weiter“ fort.
3.3)
Auf der folgenden Seite können Sie die Grundeinstellungen festlegen. Diese Einstellungen können
im nachhinein jederzeit über das ACP abgeändert werden. Bestätigen Sie die Eingaben mit einem
Klick auf den Button „Speichern“.
3.4)
Anschließend erhalten Sie die Meldung, dass die Einstellungen erfolgreich gespeichert werden
konnten. Fahren Sie wie bekannt fort.
3.5)
Zum Abschluss sollten Sie jetzt ein Passwort festlegen. Bitte beachten Sie, dass die Eingaben
beider Felder übereinstimmen, ansonsten erhalten Sie eine entsprechende Fehlermeldung. Das
Passwort wird gespeichert, nachdem der Button „Speichern“ betätigt wurde.
4.)
Nach einem erneuten Klick auf „Weiter>>“ erhalten Sie die Meldung, dass die Installation
erfolgreich abgeschlossen werden konnte. Sie können Sich jetzt in das ACP mit Ihrem soebend
festgelegten Passwort einloggen. Das Passwort können Sie ebenfalls im nachhinein jederzeit
ändern. Haben Sie kein Passwort angegeben, brauchen Sie beim Login kein Passwort angeben.
!!! Sie sollten nun die Datei Setup.php vom Server entfernen.
Support
Updates, Patches – http://www.programmers-club.de/firstnews
Support-Forum – http://www.coder-treff.de
1st News 3 Personal
Seite 8