Deutsche README-Datei ===================== Themenuebersicht: ---------------- 1. Danke 2. Voraussetzungen 3. Installation 3. b) Manuelle-Installation 4. Konfiguration 4. b) 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 ---------------- 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! 2. Voraussetzungen ------------------ Sie benoetigen eine sogn. LAMP-Umgebung auf Ihrem Server. Das ist nichts besonders! (Also wenn Ihr Hoster gut Geld verlangt, dann gehen Sie besser woanders hin... :-) ) 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. 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) ) 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. 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 --------------- Die Installation ist recht einfach gehalten: - Entpacken Sie das heruntergeladene Archiv (zum Beispiel mit WinZIP) in ein Verzeichnis auf Ihrer Festplatte. Es wird dabei ein Verzeichnis namens "mxchange-x.x.x" angelegt (wobei x.x.x die aktuelle Version ist). - Laden Sie den gesamten Inhalt des Verzeichnisses "0.2.1" hoch (die anderen Dateien werden nicht benoetigt.) Auch die SQL-Dateien im Hauptverzeichnis sollten mit hochgeladen werden, die upgrade.php bitte nicht mehr mit hochladen! - Setzen Sie die Zugriffsrechte (CHMOD) wie folgt: + 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: - install.php?theme=business = Ruft das Theme "Solid-Business" auf - install.php?theme=desert = Ruft das Theme "Desert-Storm" auf - Der Installationspfad wird vom Script selbst erkannt (Auto-Detection) und brauch bei 99% aller Installationen nicht von Ihnen geaendert werden. Auch die Installationsroutine "laesst die Finger davon". - Neuerdings wird auch die URL automatisch erkannt. Auch hier brauchen Sie mit 99%-iger Wahrscheinlichkeit nichts aendern. :-) - Folgen Sie den Anweisungen auf dem Bildschirm. Wenn diese IMMER_GROSS_GESCHRIEBEN_SIND, ist vermutlich die englische Sprache aktiv. Sie muessen derzeit die deutsche Sprache dann so aufrufen: http://www.ihr-server.de/install.php?mx_lang=de - Lassen Sie folgende Einstellungen beim Installieren auf Standart: + Ausgabe-Modus auf 'render' + Frameset abschalten (Table-Set aktivieren). Diese beiden Einstellungen haben bei den ersten Installationen die meisten Fehler verursacht! Viel Glueck! :-) ******************************************************************************** Uebrigens: Wenn das Script Sie bittet, Zugriffsrechte bestimmter Dateien oder Verzeichnisse zu aendern und Ihnen aber einen "Weiter-Button" anbietet, fuehren Sie diese ZUERST durch und klicken dann auf "Weiter", versuchen Sie nicht die Seite zu aktualisieren! Das kann durchaus zu Fehlern fuehren. ******************************************************************************** 3. b) Manuelle-Installation --------------------------- Diese Installationsvarriante ist seit einigen Revisionen nicht mehr moeglich und wird hier nur aus "historischen Gruenden" in der Readme behalten. Bitte probieren Sie es nicht weiter aus, sondern versuchen Sie die halb-automatische Installation. Sollten Sie dort auf Fehlermeldungen stossen, schauen Sie am Besten einfach im Forum unter http://forum.mxchange.org vorbei. Vielleicht wurde Ihr Fehler dort schon behoben. Und aktualisieren Sie immer Ihren SVN-Checkout! ******************************************************************************** * Ab hier die veraltete Anleitung zur manuellen Installation * ******************************************************************************** Falls es bei der halb-automatischen Installation per install.php nicht klappen sollte (Fehlermeldungen beim Einspielen der SQL-Dateien), so muessen Sie diese selber in folgender Reihenfolge (unbedingt einhalten!!!) einspielen: 1. install/tables.sql 2. install/menu-de.sql Stellen Sie dann in der inc/config.php die Konstante mxchange_installed auf 'true'. Vorher: define('mxchange_installed', false); Nachher: define('mxchange_installed', true); Anschliessend stellen Sie die MySQL-Zugangsdaten, den Titel Ihres Mailtausches, Werbspruch (Slogan) und Ihre EMail-Adresse (zum Empfangen von Anmelde-EMails usw.) ein. Die inc/config.php ist dazu von mir ausreichend gut durchkommentiert. Beachten Sie aber, dass Sie Ihre Daten zwischen die doppelten Anfuehrungszeichen (") setzen muessen. 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! 4. Konfiguration ---------------- Nach dem Installationsvorgang sollte das *grundlegenste* erledigt sein. Richten Sie als naechstes *unbedingt* einen Administrator-Account ein! Dieses wird auch nach der Installation automatisch der naechste Schritt sein. Danach geht es gleich im Admin-Bereich weiter. Glueckwunsch, Sie sind hier angekommen! Gleich nach dem Login im Admin-Bereich werden Ihnen eine Reihe Aufgaben zugeteilt. Führen Sie der Reihe nach aus und installieren Sie die Erweiterungen in Ihr System. Danach koennen Sie die Aufgaben ohne Bedenken loeschen. Sollten Sie mal ein Update von mir erhalten, oder auch eine Erweiterung loeschen, wird - solange die Erweiterung noch auf dem Server existiert - wieder eine neue Aufgabe automatisch generiert. Die Erweiterungen admintheme1 und admintheme_default sind Sondererweiterungen: - admintheme_default: Standartmenue (Auslieferung) setzen - admintheme1: EMail-Statistik und Online-Statistik werden in das Menue Statistiken verschoben Beachten Sie, dass diese Erweiterungen nach Registrierung wieder entfernt werden, da sie nur das Admin-Menue veraendern sollen und sonst keine weitere Funktion haben. Zurueck zur Konfiguration des Mailtausches! Als naechstes sollten Sie schauen, ob Sie mit den Standartbeschriftungen aller Menues zufrieden sind (was auch meistens so ist... ;-) ). Dann richten Sie unter "Einstellungen" die Untermenuepunkte von oben nach unten durcharbeiten: - Kategorien einrichten: Richten Sie hier Kategorien ein. In diesen koennen dann Ihre Mitglieder ihre Werbung spaeter buchen. Es snd berteits welche vorgegeben. Derzeit koenenn Sie noch nicht aendern oder loeschen! - Anmeldeformular: Stellen Sie hier ein, wie viele Kategorien bei der Anmeldung *mindestens* ausgewaehlt werden sollen, damit die Anmeldung durchgefuehrt werden kann. Dieses wirkt sich auch spaeter auf den Mailversand aus! - Versand, Empfang: Richten Sie hier fuer die Mitglieder die maximal zu empfangenen Mails pro Tag ein (also wie viel ein Mitglied pro Tag empfangen will). Dieses sollten schon mehr als 5 Auswahlen (+ 0 Mails / Tag wegen der Urlauber) sein. - Sicherheitseinstellungen: Diverse Einstellungen zum Thema Sicherheit, wie minimale Passwortlaenge, doppelt angemeldete Email-Adressen / Passwoerter verweigern. - Punkte: Hier gibt es gleich zwei weitere Unterpunkte: * Willkommensgutschrift und andere Festbetraege editieren: Hier stellen Sie Die Vergueetung bei Anmeldung ("Willkommensgutschrift") und eine einmalige Referal-Gutschrift (nur erste Ebene!) ein. * Referal-Ebenen editieren / loeschen / hinzufuegen: Dies ist wohl das interessanteste fuer Mitglieder! Es empfiehlt sich, das ganze "in der Waage" zu halten: Nicht zu viel aber auch nicht zu wenig und je "tiefer" die Ebenen, desto niedriger der prozentualer Anteil. Zudem sollten zum Starten 5 Ebenen reichen. :-) * Auch bei den Referal-Ebenen koennen Sie noch nichts aendern / loeschen! Loeschen von Referal-Ebenen im Betrieb ist gefaehrlich! Dadurch verlieren Ihre Mitglieder definitiv Punkte in den Ebenen! Also vorher manuell gutschreiben!!! Wenn Sie hier angekommen sind, haben Sie Ihren ersten (?) freien Mailtausch eingerichtet! Nochmals "Herzlichen Glueckwunsch" an dieser Stelle! 4.b) 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 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! 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 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. Weitere Details zu meinem Template-System entnehmen Sie bitte der TEMPLATES.de ! 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 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 gut 88x31-Banner und/oder Counter-Codes rein - member_advert.tpl.de - Gleiches Template fuer den Mitgliedsbereich 6. Wie Sie mit dem Script Geld verdienen ---------------------------------------- Sie koennen nicht nur mit Werbeeinahmen Geld verdienen - was sich nur bei 1000 Besuchern pro Tag und mehr sich lohnen wuerde - sondern auch mit Verkauf von Accounts! Dabei brauchen Sie noch nicht mal Ihren Ref-Link bewerben! Das 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. 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. Nach Verkauf und Abgabe des Accounts melden Sie einfach erneut an, tragen die Ref-ID ein und das Spiel beginnt von vorne. Viel Erfolg beim Geldverdienen! Uebrigens: 30 Refs sind durchaus 20 EUR und mehr wert. Und Sie muessen natuerlich Ihren Mailtausch bewerben, da ihn sonst niemand kennt! Aber das sollte Ihnen schon klar sein... 7. Tipps und Hinweise zum Thema Sicherheit ------------------------------------------ ############################################################################### Etwas sehr wichtiges vorweg: Loeschen Sie die Installationsroutine (install.php aus dem Hauptverzeichnis und inc/install*), damit Unbefugte diese nicht missbrauchen koennen! ############################################################################### Stellen Sie beim Sicherheitscode (beim Best. von Mails wird dieser angezeigt und muss wiederholt werden) nicht weniger als 3 ein. Eine 0 deaktiviert nun seit einigen Versionen den Code, nicht aber den Button! Dieser muss noch immer angeklickt werden. Ich habe diesen Code aus einem einfachen Grund eingebaut: So wie es bei einem anderen Mailtausch-Betreiber aussah, wurden zwar die Mails bestaetigt, aber die Seite nie besucht. So wie ich vermute, wurden sogn. Fake- Programme (Auto-Confirm) verwendet, um die Mails zu bestaetigen, da die Links nachmachbar sind. Dieses Script ist mit einem Sicherheitscode zum Eingeben + einem Buttom zum Anklicken ausgestattet. Er wird in ein Bild hineingeschrieben, das gemustert ist. Weitere Details entnehmen Sie bitte der Textdatei SECURITY.txt! Um diesen Code kommen (hoffentlich) die Faker-Programme nicht mehr herum. 8. Deinstallation ----------------- Zur Deinstallation loeschen Sie alle Dateien des Scriptes vom Server und die Tabellen mit Struktur. Bei den meisten Hostern duerfen Sie nicht die Datenbank selber loeschen. Versuche dies zu tun, fuehren zu Fehlern und die Tabellen bleiben bestehen. 9. 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 fuer Folgen und daraus resultierenden Schaeden in keinsterweise verantwortlich 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. [EOF]