Deutsche README-Datei
=====================
+-------------------------------------------------------------------------------
Themenuebersicht:
-----------------
+-------------------------------------------------------------------------------
1. Danke
2. Voraussetzungen
3. Installation
-3. b) Manuelle-Installation
+3. a) Manuelle-Installation
+3. b) Zugriffsrechte (CHMOD)
4. Konfiguration
-4. b) SMTP-Support durch PHPMailer
+4. a) SMTP-Support durch PHPMailer
5. Wichtige Templates
6. Wie Sie mit dem Script Geld verdienen
7. Tipps und Hinweise zum Thema Sicherheit
8. Deinstallation
-9. Distanzierung
-----------------
+9. Bekannte Fehlerquellen und deren Behebung
+10. Weiterfuehrende, wichtige Links
+11. Distanzierung
+-------------------------------------------------------------------------------
+--------
1. Danke
--------
-Erst einmal vielen Dank, dass Sie mein kostenloses Mailtausch-Script MXChange
-(wird ab hier Programm genannt) heruntergeladen haben! Ich bietet Ihnen
-hiermit die Moeglichkeit an, einen komplett eigenen Mailtausch aufzubauen.
-Allerdings moechte ich hier nochmal darauf hinweisen, dass ich ABSOLUT KEINE
-GEWAEHR fuer die Fehlerfreiheit und Sicherheit dieses Programmes uebernehme!
-Die Installation erfolgt stets AUF IHRER EIGENEN GEFAHR UND VERANTWORTUNG hin!
+Erst einmal vielen Dank, dass Sie mein kostenloses Mailtausch-Script
+Mailer-Project (wird ab hier Programm genannt) heruntergeladen haben!
+Ich bietet Ihnen hiermit die Moeglichkeit an, einen komplett eigenen
+Mailtausch oder Paidmailer aufzubauen. Ich moechte hier nochmals darauf
+hinweisen, dass ich ABSOLUT KEINE GEWAEHR fuer die Fehlerfreiheit und
+Sicherheit dieses Programmes uebernehme! Die Installation erfolgt stets AUF
+IHRER EIGENEN GEFAHR UND VERANTWORTUNG hin!
+------------------
2. Voraussetzungen
------------------
LAMP steht fuer "Linux, Apache, MySQL, PHP".
-PHP sollte moeglichst in der Version 4.1.x vorliegen (oder hoeher), da in 4.0.x
-einfach zu viele Programmierfehler enthalten sind.
+PHP sollte moeglichst in der Version 4.4.x vorliegen (oder hoeher), da in den
+aelteren Versionen einfach zu viele Programmierfehler enthalten sind.
-Unter PHP5 ist die Software bereits etwas getestet und scheint zu funktionieren.
-Wenn Sie dennoch auf Fehler stossen, so melden Sie die bitte im Forum!
-(Siehe 3.b) )
+Mailer-Project ist mittlerweile weitgehenst unter PHP 5.3 getestet und sollte
+einwandfrei funktionieren. Wenn Sie dennoch auf Fehler stossen, so melden Sie
+die bitte im Forum oder im Bug-Tracker (siehe "10. Weiterfuehrende, wichtige
+Links").
Unter http://www.webhostlist.de koennen Sie sich einen passenden Anbieter
-raussuchen, wenn Sie nicht weiterwissen. Das MXChange-Script scheint mit einigen
-sogn. Free-Hostern nicht 100%ig klar zu kommen. Das lag in der Vergangenheit
-meistens daran, dass der system()-Befehl deaktiviert war und dass somit keine
-SQL-Dateien eingespielt wurden. Mittlerweile sollte dies jedoch klappen, da das
-Importieren der Dumps komplett umgeschrieben ist. Die Dumps funktionieren auch
-nicht mehr mit neueren SVN-Revision.
+raussuchen, wenn Sie nicht weiterwissen. Das Mailer-Project-Script scheint mit
+einigen sogn. Free-Hostern nicht 100%ig klar zu kommen. Das lag in der
+Vergangenheit meistens daran, dass der system()-Befehl deaktiviert war und dass
+somit keine SQL-Dateien eingespielt werden konnten.
+
+Mittlerweile sollte dies jedoch klappen, da das Importieren der Dumps komplett
+umgeschrieben ist.
Unter Windows-Systemen ist das Script nur unzureichend testen getestet worden.
Wenn Sie also z.B. WinXAMP (oder so?) haben, testen Sie es gerne dort. Gehen Sie aber
nicht davon aus, dass es auch fehlerfrei laufen wird. :-/
+---------------
3. Installation
---------------
+ Verzeichnis inc auf 777
+ Datein inc/config.php auf 666
-- Das Script befindet sich jetzt im Installationsmodus! Rufen Sie einfach
- das Script direkt auf: http://www.mein-server.de/mailtausch/ Das Script leitet
- Sie direkt in die Installationsroutine. Wenn Sie das aktuelle Theme nicht
- moegen, so koennen Sie schon jetzt das Theme "auswaehlen", indem Sie es an
- install.php wie folgt anhaengen:
+- Das Script befindet sich jetzt im Installationsmodus!
+- Rufen Sie einfach das Script direkt auf: http://www.mein-server.de/mailtausch/
+ Das Script leitet Sie direkt in die Installationsroutine.
+- Erhalten Sie hier "500 Internal Server Error" Fehlermeldungen, so muessen Sie
+ die .htaccess-Dateie aus dem Hauptverzeichnis loeschen (diese sollte neben
+ Dateien wie agb.php, admin.php befinden).
+- Wenn Sie das aktuelle Theme nicht moegen, so koennen Sie schon jetzt das Theme
+ "auswaehlen", indem Sie es an install.php wie folgt anhaengen:
- install.php?theme=business = Ruft das Theme "Solid-Business" auf
- install.php?theme=desert = Ruft das Theme "Desert-Storm" auf
Seite zu aktualisieren! Das kann durchaus zu Fehlern fuehren.
********************************************************************************
-3. b) Manuelle-Installation
+---------------------------
+3. a) Manuelle-Installation
---------------------------
Diese Installationsvarriante ist seit einigen Revisionen nicht mehr moeglich und
Ebenfalls viel Glueck dabei! :-)
-Als naechstes lesen Sie sich bitte die FAQs auf meiner Webseite durch:
-
-http://www.mxchange.org/cms/index/wht/faqs
-
-Wenn Sie nicht klarkommen oder Sie Endlosschleifen oder Fehlermeldungen
-erhalten, melden Sie sich bitte bei mir. Die erste Anlaufstelle fuer Sie ist
-immer mein Forum, welches Sie hier finden koennen:
-
-http://forum.mxchange.org
-
-Auch sollten Sie meinen Bug-Tracker aufsuchen und dort Fehlermeldungen posten:
-
-http://bugs.mxchange.org
-
-Alle wichtigen Kontaktdaten finden Sie im Impressum:
-
-http://www.mxchange.org oder
-http://www.mxchange.de oder - LEITET an mxchange.org weiter!
-http://www.mxchange-demo.de - DERZEIT ist dort die Installation zu sehen!
+Schauen Sie unter "10. Weiterfuehrende, wichtige Links" nach, wenn Sie nicht
+weiter wissen.
+
+----------------------------
+3. b) Zugriffsrechte (CHMOD)
+----------------------------
+
+Es sind fuer Mailer-Project nur Leserechte auf Dateien und Verzeichnisse, sowie
+Ausfuehrbar/Durchsuchbar fuer Verzeichnisse noetig. Schreibrechte brauchen Sie
+auf das Verzeichnis inc/.secret/, inc/cache/ und inc/cache/_compiled/html/, da
+dort Dateien angelegt werden muessen. Nach der fertigen Installation koennen Sie
+sogar Schreibrechte vom Verzeichnis inc/.secret/ entfernen. Sie sollten dies
+aber erst nach der Installation von ext-sql_patches tun, da die Erweiterung
+dort Schreibzugriff braucht.
+
+Einfacher dargestellt bedeutet dies: (Oktalwerte)
+- CHMOD 0555 auf alle Verzeichnisse, plus CHMOD 0777 auf inc/.secret/,
+ inc/cache/ und inc/cache/_compiled/html/
+- CHMOD 0444 auf alle Dateien, bis auf die Dateien in den oben besagten
+ Verzeichnissen.
+
+Schreibrechte fuer inc/cache/ sind wichtig, damit u.a. Cache-Dateien zum
+Beschleunigen des Scriptes erzeugt werden koennen. Im Verzeichnis
+inc/cache/_compiled/html/ werden kompilierte Templates abgelegt, um sich
+wiederholende Dinge im Script zu sparen. Sollten Sie also Templates aendern,
+leeren Sie unbedingt inc/cache/_compiled/html/, da sonst Ihre Aenderungen
+nicht sichtbar werden.
+
+Alternativ koennen Sie - wenn Sie z.B. viele Templates oft am Aendern sind - in
+der Datei inc/cache/config-local.php die Zeile mit
+setConfigEntry('DEBUG_TEMPLATE_CACHE', 'Y'); einkommentieren. Loeschen Sie dazu
+die ersten zwei Slashes in der Zeile (zirka Zeile 88 rum), nicht aber die aus
+dem Kommentar darueber!
+
+So sollte dies dann aussehen:
+// CFG: DEBUG-TEMPLATE-CACHE
+setConfigEntry('DEBUG_TEMPLATE_CACHE', 'Y');
+
+Haben Sie Ihre Templates angepasst, so setzen Sie wieder die zuvor entfernten
+zwei Slashes, damit die Templates gecacht werden und Ihr Mailer schneller
+laeuft.
+
+Danach sollte die Zeile wieder wie folgt aussehen:
+// CFG: DEBUG-TEMPLATE-CACHE
+//setConfigEntry('DEBUG_TEMPLATE_CACHE', 'Y');
+----------------
4. Konfiguration
----------------
Wenn Sie hier angekommen sind, haben Sie Ihren ersten (?) freien Mailtausch
eingerichtet! Nochmals "Herzlichen Glueckwunsch" an dieser Stelle!
-4.b) SMTP-Support durch PHPMailer
+---------------------------------
+4.a) SMTP-Support durch PHPMailer
---------------------------------
-Seit der MXChange Version 0.2.1-RC5 wird PHPMailer in der Version 2.0.0 genutzt.
-Die Dokumentation, sowie Lizenzdatei finden Sie unter inc/phpmailer/. Ich nutze
-davon jedoch nur den SMTP-Auth-Mechanismus, damit mehr User mein Skript nutzen
-koennen. Mein besonderer Dank gilt hier The Shadowmaster, da er mich darauf
-aufmerksam und angespornt hat, den Support fuer SMTP-Auth einzubauen.
-
-Damit Sie dies nun auch in MXChange nutzen koennen, muessen Sie nach der
-Installation von MXChange die config.php erneut runterladen(!) und die Eintraege
-SMTP_HOSTNAME, SMTP_USER und SMTP_PASSWORD anpassen. Derzeit wird nur die
-SASL-Methode LOGIN unterstuetzt. Tesweise koennen Sie auch versuchen, SSL
+Seit der Mailer-Project Version 0.2.1-RC5 wird PHPMailer in der Version 2.0.0
+genutzt. Die Dokumentation, sowie Lizenzdatei finden Sie unter inc/phpmailer/.
+Ich nutze davon jedoch nur den SMTP-Auth-Mechanismus, da bei einigen Usern die
+mail()-Funktion deaktiviert war. Mein besonderer Dank gilt hier
+"The Shadowmaster", da er mich darauf aufmerksam und angespornt hat, den Support
+fuer SMTP-Auth einzubauen.
+
+Damit Sie dies nun auch in Mailer-Project nutzen koennen, muessen Sie nach der
+Installation von Mailer-Project die config.php erneut runterladen(!) und die
+Eintraege SMTP_HOSTNAME, SMTP_USER und SMTP_PASSWORD anpassen. Derzeit wird nur
+die SASL-Methode LOGIN unterstuetzt. Tesweise koennen Sie auch versuchen, SSL
einzuschalten. Sollten Sie Fehlermeldungen erhalten und es sind keine Mails
unterwegs, versuchen Sie als erstes das SSL abzuschalten. Eventuell unterstuetzt
Ihr fsocksopen()-Befehl von PHP kein SSL!
-Gerne kann ich Ihnen im Rahmen von Mailversand fuer MXChange hier etwas Support
-in meinem Forum anbieten, ich kann natuerlich nicht die gesamte PHPMailer-Klasse
-supporten!
+Gerne kann ich Ihnen im Rahmen von Mailversand fuer Mailer-Project hier etwas
+Support in meinem Forum anbieten, ich kann natuerlich nicht die gesamte
+PHPMailer-Klasse supporten!
Die neuste PHPMailer-Version finden Sie auf deren Homepage unter der folgenden
Adresse:
http://phpmailer.codeworxtech.com/
+---------------------
5. Wichtige Templates
---------------------
-Sie sollten nunn diverse Templates einstellen: impressum.tpl.de, metadata.tpl.de
+Sie sollten nunn diverse Templates einstellen: impressum.tpl, metadata.tpl
sind beispielsweise im "Fabrikzustand". Verwenden Sie dazu einen einfachen
-Texteditor und nicht einen HTML-Editor. Diese bauen oefters Kopf- und Fuss-Tags
-ein, die in Templates unerwuenscht sind.
+Texteditor wie Notepad.exe, nicht aber einen HTML-Editor. Diese bauen
+oefters Kopf- und Fuss-Tags ein, die in Templates unerwuenscht sind. Auch
+sollten Sie auf Texteditieren, wie Word verzichten, da diese sehr schlechten
+HTML-Code generien.
-Weitere Details zu meinem Template-System entnehmen Sie bitte der TEMPLATES.de !
+Weitere Details zu meinem Template-System entnehmen Sie bitte der TEMPLATES.txt !
Ich werde oefters gefragt, wo ein guter Platz fuer Banner-Codes und/oder
Counter-Codes ist. Dazu moechte ich gleich die interessantesten Plaetze
auflisten:
-- guest_header.tpl.de - Kopf-Template im Gastbereich: Hier koennen Sie
+- guest_header.tpl - Kopf-Template im Gastbereich: Hier koennen Sie
beispielsweise 468x60-Banner oder Textlinks unterbringen
-- member_header.tpl.de - Das gleiche Template dieses Mal fuer den Mitgliedsbereich
-- guest_footer.tpl.de - Das gleiche dieses Mal unten der Fuss
-- member_footer.tpl.de - Das gleiche dieses Mal fuer den Mitgliedsbereich
-- guest_advert.tpl.de - Gast-Template unterhalb des Menue-Systems: Hier passen
+- member_header.tpl - Das gleiche Template dieses Mal fuer den Mitgliedsbereich
+- guest_footer.tpl - Das gleiche dieses Mal unten der Fuss
+- member_footer.tpl - Das gleiche dieses Mal fuer den Mitgliedsbereich
+- guest_advert.tpl - Gast-Template unterhalb des Menue-Systems: Hier passen
gut 88x31-Banner und/oder Counter-Codes rein
-- member_advert.tpl.de - Gleiches Template fuer den Mitgliedsbereich
+- member_advert.tpl - Gleiches Template fuer den Mitgliedsbereich
+
+Damit Ihre Aenderungen beim Editieren der Templates sofort sichtbar sind,
+sollten Sie das Cachen der kompilierten Templates verhindern. Mehr dazu unter
+"3. b) Zugriffsrechte (CHMOD)".
+----------------------------------------
6. Wie Sie mit dem Script Geld verdienen
----------------------------------------
geschieht vollkommen automatisch!
Melden Sie sich als naechstes selber an. Die vom System Ihnen zugeteilte Ref-ID
-stellen Sie unter "Einstellungen -> Standart Ref-ID" als Referal-ID ein.
+tragen Sie unter "Einstellungen -> Standart Ref-ID" als Referal-ID ein.
Sobald Sie dies getan haben, und jemand Ihren Mailtausch ohne Ref-Link aufruft,
wird automatisch Ihre Ref-ID im Anmeldeformular eingesetzt. Folglich erhalten Sie
alle Refs, die nicht ueber Ref-Links reingekommen sind! Wenn Sie meinen, dass Sie
genug Refs haben (Tipp: ab 30 Refs wird es interessant fuer das neue Mitglied!)
dann versteigern Sie diesen in einem Auktionshaus Ihrer Wahl oder verkaufen Sie
-diesen von Ihrer Webseite aus.
+diesen von Ihrer Webseite aus. (Mailer-Project bietet fuer letzteres bald eine
+Erweiterung ext-refsell, solange muessen Sie schon eigene Templates und
+what-Dateien erstellen).
Nach Verkauf und Abgabe des Accounts melden Sie einfach erneut an, tragen die
Ref-ID ein und das Spiel beginnt von vorne.
natuerlich Ihren Mailtausch bewerben, da ihn sonst niemand kennt! Aber das
sollte Ihnen schon klar sein...
+------------------------------------------
7. Tipps und Hinweise zum Thema Sicherheit
------------------------------------------
Um diesen Code kommen (hoffentlich) die Faker-Programme nicht mehr herum.
+-----------------
8. Deinstallation
-----------------
selber loeschen. Versuche dies zu tun, fuehren zu Fehlern und die Tabellen
bleiben bestehen.
-9. Distanzierung
-----------------
+--------------------------------------------
+9. Bekannte Fehlerquellen und deren Behebung
+--------------------------------------------
+
+Hier sind alle bekannten "Fehermeldungen" und wie Sie diese selber beheben
+koennen. Richtige Bugs (Programmierfehler) koennen Sie nur mit entsprechenden
+Kenntnissen fixen, die hier ich aber gerne im Support-Forum oder im Bug-Tracker
+behandeln kann. Die meisten hier aufgelisteten Fehlermeldungen und deren
+Loesungen beruhen auf Erfahrungen mit unterschiedlichen Hostern.
+
+FEHLER:
+ Ihr Browser zeigt den Quellcode des Scriptes an, bzw. startet einen Download.
+LOESUNG:
+ Ihr Server unterstuetzt kein PHP. Aktuell werden PHP 4.4.x (die neuste bitte)
+ und alle PHP5 Versionen unterstuetzt. Bitte lassen Sie sich dies von Ihrem
+ Hoster nachinstallieren. Alternativ - ich nehme dann an, Sie hosten selber -
+ koennen Sie im Internet (ich kann www.ixquick.com als Google-Alternative sehr
+ empfehlen) nach Installationsanleitungen suchen. Mein Support-Team und ich
+ koennen da verstaendlicherweise nur geringfuegig helfen.
+
+FEHLER:
+ Ihr Browser zeigt "Datei nicht gefunden (404)" an.
+LOESUNG:
+ Sie haben das Script in ein falsches Verzeichnis auf dem Server hochgeladen.
+ Meistens gibt es auf dem Server ein Verzeichnis "htdocs" oder "html", wo Sie
+ Ihre Dateien hochladen muessen, damit sie im Internet abrufbar sind.
+ Verzeichnisse wie z.B. cgi-bin, phptmp, logs sind hier definitiv die falschen
+ Kandidaten.
+
+FEHLER:
+ Ihr Browser zeigt weiterhin "Datei nicht gefunden (404)" an.
+LOESUNG:
+ Haben Sie das Script an die richtige Stelle hochgeladen? Falls ja, dann haben
+ Sie vermutlich es nicht richtig aufgerufen. "htdocs" oder "html" sind keine
+ Verzeichnisse, die Sie im Browser aufrufen, sondern "root-Verzeichnisse", in
+ denen Ihr Webserver nachschaut, wenn er HTTP-Anfragen erhaelt.
+
+FEHLER:
+ Ihr Browser zeigt "Zugriff verweigert (403)" an.
+LOESUNG:
+ Es sind vermutlich nicht genuegend Zugriffsrechte gesetzt. Dabei gelten
+ andere, als die Sie z.B. von Windows her kennen, naemlich Unix-Dateirechte.
+ Diese koennen "Lesen" (das was wohl fehlt), "Schreiben" und "Ausfuehren" bzw.
+ "Suchen". Letzteres fuehrte oefters zu Verwirrung und gilt fuer z.B. Perl-
+ oder Shell-Script, nicht jedoch fuer PHP! Mehr dazu im Abschnitt "3. b)" .
+
+FEHLER:
+ Ihr Browser zeigt "Interner Serverfehler (500)" an.
+LOESUNG:
+ Ihr Server unterstuetzt nicht das Verwenden von so genannten .htaccess-
+ Dateien, was aber eigentlich kein grosses Risiko darstellen sollte. Dennoch
+ haben viele Hoster das Verwenden von eigenen .htaccess-Dateien unterbunden.
+ Loeschen Sie einfach die Datei .htacces aus dem Hauptverzeichnis des
+ Scriptes.
+
+FEHLER:
+ Ihr Browser zeigt weiterhin "Interner Serverfehler (500)" an.
+LOESUNG:
+ Es ist vermutlich mehr kaputt gegangen, als dass Sie es reparieren koennen
+ bzw. das Script dafuer verantwortlich ist. Setzen Sie sich mit dem Support
+ Ihres Hosters in Verbindung. Einige hatten in der Vergangenheit
+ zurueckgeschrieben, dass sie "das Script nich kennen" und daher nicht helfen
+ koennen. Teilen Sie dem Support einfach mit, dass es auch z.B. als CGI
+ (Fast-CGI laeuft bei mir auf der Entwicklungsumgebung unter Lighttpd)
+ problemlos laufen kann.
+
+FEHLER:
+ Ihr Browser leitet staendig weiter bzw. bricht irgentwann mit der Meldung ab,
+ es seien z.B. Cookies nicht aktiviert.
+LOESUNG:
+ Seit einigen Revisionen ist die Nutzung des Scriptes ohne Cookies moeglich.
+ Vermutlich haben Sie hier einen Bug gefunden. Alternativ koennen Sie einfach
+ im Browser die Cookies zulassen. Hilfestellungen dazu bietet mein Support-Team
+ und ich nur beschraenkt an. (Sie wissen schon, einfach im Internet suchen...)
+
+-----------------------------------
+10. Weiterfuehrende, wichtige Links
+-----------------------------------
+
+Ihre erste Anlaufstelle sollte immer diese README.txt sein, die anderen Dateien
+in diesem Verzeichnis sind teilweise stark veraltet und geben nicht das aktuelle
+Script wieder.
+
+Als naechstes koennen Sie in den FAQs: nachsehen:
+http://www.mxchange.org/cms/index/wht/faqs
+
+Wenn Sie nicht klarkommen oder Sie Endlosschleifen oder Fehlermeldungen
+erhalten, melden Sie sich bitte bei mir. Die erste Anlaufstelle fuer Sie ist
+immer mein Forum, welches Sie hier finden koennen:
+
+http://forum.mxchange.org
+
+Auch sollten Sie meinen Bug-Tracker aufsuchen und dort Fehlermeldungen posten:
+
+http://bugs.mxchange.org
+
+Alle wichtigen Kontaktdaten finden Sie im Impressum:
+
+http://www.mxchange.org oder
+http://www.mxchange.de oder - LEITET an mxchange.org weiter!
+http://www.mxchange-demo.de - DERZEIT ist dort die Installation zu sehen!
+
+Sehen Sie aber bitte von Anrufen ab, ich kann nicht immer am Telefon alles
+beseitigen. :-)
+
+-----------------
+11. Distanzierung
+-----------------
Da dieses Script frei und ohne Alterskontrolle zur Verfuegung steht, kann ich
nicht kontrollieren, wer sich dieses runterlaedt. In jedem Fall mache ich mich
und entziehe mich von der Haftbarkeit.
Jeder, der diese Software runterlaedt, hat die Lizenz GNU GPL Version 2 oder
-jede neuere Version gelesen und akzeptiert. Diese wird im jedem vollen Paket
-(nicht Patches) und Erweiterungen mitgeschickt.
+jede neuere Version gelesen und akzeptiert. Diese wird im jedem Downloadpaket
+mitgeschickt bzw. ist in der Repository unter [1] einsehbar.
+
+[1]: http://www.mxchange.org/repos/mailer/branches/0.2.1-FINAL/DOCS/LICENSE.txt
[EOF]
projects / mailer.git / commitdiff