9 3. b) Manuelle-Installation
11 4. b) SMTP-Support durch PHPMailer
13 6. Wie Sie mit dem Script Geld verdienen
14 7. Tipps und Hinweise zum Thema Sicherheit
22 Erst einmal vielen Dank, dass Sie mein kostenloses Mailtausch-Script MXChange
23 (wird ab hier Programm genannt) heruntergeladen haben! Ich bietet Ihnen
24 hiermit die Moeglichkeit an, einen komplett eigenen Mailtausch aufzubauen.
25 Allerdings moechte ich hier nochmal darauf hinweisen, dass ich ABSOLUT KEINE
26 GEWAEHR fuer die Fehlerfreiheit und Sicherheit dieses Programmes uebernehme!
27 Die Installation erfolgt stets AUF IHRER EIGENEN GEFAHR UND VERANTWORTUNG hin!
32 Sie benoetigen eine sogn. LAMP-Umgebung auf Ihrem Server. Das ist nichts
33 besonders! (Also wenn Ihr Hoster gut Geld verlangt, dann gehen Sie besser
36 LAMP steht fuer "Linux, Apache, MySQL, PHP".
38 PHP sollte moeglichst in der Version 4.1.x vorliegen (oder hoeher), da in 4.0.x
39 einfach zu viele Programmierfehler enthalten sind.
41 Unter PHP5 ist die Software bereits etwas getestet und scheint zu funktionieren.
42 Wenn Sie dennoch auf Fehler stossen, so melden Sie die bitte im Forum!
45 Unter http://www.webhostlist.de koennen Sie sich einen passenden Anbieter
46 raussuchen, wenn Sie nicht weiterwissen. Das MXChange-Script scheint mit einigen
47 sogn. Free-Hostern nicht 100%ig klar zu kommen. Das lag in der Vergangenheit
48 meistens daran, dass der system()-Befehl deaktiviert war und dass somit keine
49 SQL-Dateien eingespielt wurden. Mittlerweile sollte dies jedoch klappen, da das
50 Importieren der Dumps komplett umgeschrieben ist. Die Dumps funktionieren auch
51 nicht mehr mit neueren SVN-Revision.
53 Unter Windows-Systemen ist das Script nur unzureichend testen getestet worden.
54 Wenn Sie also z.B. WinXAMP (oder so?) haben, testen Sie es gerne dort. Gehen Sie aber
55 nicht davon aus, dass es auch fehlerfrei laufen wird. :-/
60 Die Installation ist recht einfach gehalten:
62 - Entpacken Sie das heruntergeladene Archiv (zum Beispiel mit WinZIP) in ein
63 Verzeichnis auf Ihrer Festplatte. Es wird dabei ein Verzeichnis namens
64 "mxchange-x.x.x" angelegt (wobei x.x.x die aktuelle Version ist).
66 - Laden Sie den gesamten Inhalt des Verzeichnisses "0.2.1" hoch (die anderen
67 Dateien werden nicht benoetigt.) Auch die SQL-Dateien im Hauptverzeichnis
68 sollten mit hochgeladen werden, die upgrade.php bitte nicht mehr mit hochladen!
70 - Setzen Sie die Zugriffsrechte (CHMOD) wie folgt:
71 + Verzeichnis inc auf 777
72 + Datein inc/config.php auf 666
74 - Das Script befindet sich jetzt im Installationsmodus! Rufen Sie einfach
75 das Script direkt auf: http://www.mein-server.de/mailtausch/ Das Script leitet
76 Sie direkt in die Installationsroutine. Wenn Sie das aktuelle Theme nicht
77 moegen, so koennen Sie schon jetzt das Theme "auswaehlen", indem Sie es an
78 install.php wie folgt anhaengen:
80 - install.php?theme=business = Ruft das Theme "Solid-Business" auf
81 - install.php?theme=desert = Ruft das Theme "Desert-Storm" auf
83 - Der Installationspfad wird vom Script selbst erkannt (Auto-Detection) und
84 brauch bei 99% aller Installationen nicht von Ihnen geaendert werden. Auch
85 die Installationsroutine "laesst die Finger davon".
87 - Neuerdings wird auch die URL automatisch erkannt. Auch hier brauchen Sie mit
88 99%-iger Wahrscheinlichkeit nichts aendern. :-)
90 - Folgen Sie den Anweisungen auf dem Bildschirm. Wenn diese
91 IMMER_GROSS_GESCHRIEBEN_SIND, ist vermutlich die englische Sprache aktiv. Sie
92 muessen derzeit die deutsche Sprache dann so aufrufen:
93 http://www.ihr-server.de/install.php?mx_lang=de
95 - Lassen Sie folgende Einstellungen beim Installieren auf Standart:
96 + Ausgabe-Modus auf 'render'
97 + Frameset abschalten (Table-Set aktivieren).
99 Diese beiden Einstellungen haben bei den ersten Installationen die meisten
104 ********************************************************************************
105 Uebrigens: Wenn das Script Sie bittet, Zugriffsrechte bestimmter Dateien oder
106 Verzeichnisse zu aendern und Ihnen aber einen "Weiter-Button" anbietet, fuehren
107 Sie diese ZUERST durch und klicken dann auf "Weiter", versuchen Sie nicht die
108 Seite zu aktualisieren! Das kann durchaus zu Fehlern fuehren.
109 ********************************************************************************
111 3. b) Manuelle-Installation
112 ---------------------------
114 Diese Installationsvarriante ist seit einigen Revisionen nicht mehr moeglich und
115 wird hier nur aus "historischen Gruenden" in der Readme behalten. Bitte probieren
116 Sie es nicht weiter aus, sondern versuchen Sie die halb-automatische
117 Installation. Sollten Sie dort auf Fehlermeldungen stossen, schauen Sie am Besten
118 einfach im Forum unter http://forum.mxchange.org vorbei. Vielleicht wurde Ihr
119 Fehler dort schon behoben. Und aktualisieren Sie immer Ihren SVN-Checkout!
121 ********************************************************************************
122 * Ab hier die veraltete Anleitung zur manuellen Installation *
123 ********************************************************************************
125 Falls es bei der halb-automatischen Installation per install.php nicht klappen
126 sollte (Fehlermeldungen beim Einspielen der SQL-Dateien), so muessen Sie diese
127 selber in folgender Reihenfolge (unbedingt einhalten!!!) einspielen:
129 1. install/tables.sql
130 2. install/menu-de.sql
132 Stellen Sie dann in der inc/config.php die Konstante mxchange_installed auf
136 define('mxchange_installed', false);
139 define('mxchange_installed', true);
141 Anschliessend stellen Sie die MySQL-Zugangsdaten, den Titel Ihres Mailtausches,
142 Werbspruch (Slogan) und Ihre EMail-Adresse (zum Empfangen von Anmelde-EMails
145 Die inc/config.php ist dazu von mir ausreichend gut durchkommentiert. Beachten
146 Sie aber, dass Sie Ihre Daten zwischen die doppelten Anfuehrungszeichen (")
149 Ebenfalls viel Glueck dabei! :-)
151 Als naechstes lesen Sie sich bitte die FAQs auf meiner Webseite durch:
153 http://www.mxchange.org/cms/index/wht/faqs
155 Wenn Sie nicht klarkommen oder Sie Endlosschleifen oder Fehlermeldungen
156 erhalten, melden Sie sich bitte bei mir. Die erste Anlaufstelle fuer Sie ist
157 immer mein Forum, welches Sie hier finden koennen:
159 http://forum.mxchange.org
161 Auch sollten Sie meinen Bug-Tracker aufsuchen und dort Fehlermeldungen posten:
163 http://bugs.mxchange.org
165 Alle wichtigen Kontaktdaten finden Sie im Impressum:
167 http://www.mxchange.org oder
168 http://www.mxchange.de oder - LEITET an mxchange.org weiter!
169 http://www.mxchange-demo.de - DERZEIT ist dort die Installation zu sehen!
174 Nach dem Installationsvorgang sollte das *grundlegenste* erledigt sein.
175 Richten Sie als naechstes *unbedingt* einen Administrator-Account ein! Dieses
176 wird auch nach der Installation automatisch der naechste Schritt sein.
178 Danach geht es gleich im Admin-Bereich weiter. Glueckwunsch, Sie sind hier
181 Gleich nach dem Login im Admin-Bereich werden Ihnen eine Reihe Aufgaben
182 zugeteilt. Führen Sie der Reihe nach aus und installieren Sie die
183 Erweiterungen in Ihr System.
185 Danach koennen Sie die Aufgaben ohne Bedenken loeschen. Sollten Sie mal ein
186 Update von mir erhalten, oder auch eine Erweiterung loeschen, wird - solange
187 die Erweiterung noch auf dem Server existiert - wieder eine neue Aufgabe
188 automatisch generiert.
190 Die Erweiterungen admintheme1 und admintheme_default sind Sondererweiterungen:
192 - admintheme_default: Standartmenue (Auslieferung) setzen
193 - admintheme1: EMail-Statistik und Online-Statistik werden in das Menue
194 Statistiken verschoben
196 Beachten Sie, dass diese Erweiterungen nach Registrierung wieder entfernt
197 werden, da sie nur das Admin-Menue veraendern sollen und sonst keine weitere
200 Zurueck zur Konfiguration des Mailtausches!
202 Als naechstes sollten Sie schauen, ob Sie mit den Standartbeschriftungen aller
203 Menues zufrieden sind (was auch meistens so ist... ;-) ). Dann richten Sie unter
204 "Einstellungen" die Untermenuepunkte von oben nach unten durcharbeiten:
206 - Kategorien einrichten: Richten Sie hier Kategorien ein. In diesen koennen dann
207 Ihre Mitglieder ihre Werbung spaeter buchen. Es snd berteits welche vorgegeben.
208 Derzeit koenenn Sie noch nicht aendern oder loeschen!
210 - Anmeldeformular: Stellen Sie hier ein, wie viele Kategorien bei der Anmeldung
211 *mindestens* ausgewaehlt werden sollen, damit die Anmeldung durchgefuehrt
212 werden kann. Dieses wirkt sich auch spaeter auf den Mailversand aus!
214 - Versand, Empfang: Richten Sie hier fuer die Mitglieder die maximal zu
215 empfangenen Mails pro Tag ein (also wie viel ein Mitglied pro Tag empfangen
216 will). Dieses sollten schon mehr als 5 Auswahlen (+ 0 Mails / Tag wegen der
219 - Sicherheitseinstellungen: Diverse Einstellungen zum Thema Sicherheit, wie
220 minimale Passwortlaenge, doppelt angemeldete Email-Adressen / Passwoerter
223 - Punkte: Hier gibt es gleich zwei weitere Unterpunkte:
225 * Willkommensgutschrift und andere Festbetraege editieren: Hier stellen Sie
226 Die Vergueetung bei Anmeldung ("Willkommensgutschrift") und eine einmalige
227 Referal-Gutschrift (nur erste Ebene!) ein.
229 * Referal-Ebenen editieren / loeschen / hinzufuegen: Dies ist wohl das
230 interessanteste fuer Mitglieder! Es empfiehlt sich, das ganze "in der
231 Waage" zu halten: Nicht zu viel aber auch nicht zu wenig und je "tiefer"
232 die Ebenen, desto niedriger der prozentualer Anteil. Zudem sollten zum
233 Starten 5 Ebenen reichen. :-)
235 * Auch bei den Referal-Ebenen koennen Sie noch nichts aendern / loeschen!
236 Loeschen von Referal-Ebenen im Betrieb ist gefaehrlich! Dadurch
237 verlieren Ihre Mitglieder definitiv Punkte in den Ebenen! Also vorher
238 manuell gutschreiben!!!
240 Wenn Sie hier angekommen sind, haben Sie Ihren ersten (?) freien Mailtausch
241 eingerichtet! Nochmals "Herzlichen Glueckwunsch" an dieser Stelle!
243 4.b) SMTP-Support durch PHPMailer
244 ---------------------------------
246 Seit der MXChange Version 0.2.1-RC5 wird PHPMailer in der Version 2.0.0 genutzt.
247 Die Dokumentation, sowie Lizenzdatei finden Sie unter inc/phpmailer/. Ich nutze
248 davon jedoch nur den SMTP-Auth-Mechanismus, damit mehr User mein Skript nutzen
249 koennen. Mein besonderer Dank gilt hier The Shadowmaster, da er mich darauf
250 aufmerksam und angespornt hat, den Support fuer SMTP-Auth einzubauen.
252 Damit Sie dies nun auch in MXChange nutzen koennen, muessen Sie nach der
253 Installation von MXChange die config.php erneut runterladen(!) und die Eintraege
254 SMTP_HOSTNAME, SMTP_USER und SMTP_PASSWORD anpassen. Derzeit wird nur die
255 SASL-Methode LOGIN unterstuetzt. Tesweise koennen Sie auch versuchen, SSL
256 einzuschalten. Sollten Sie Fehlermeldungen erhalten und es sind keine Mails
257 unterwegs, versuchen Sie als erstes das SSL abzuschalten. Eventuell unterstuetzt
258 Ihr fsocksopen()-Befehl von PHP kein SSL!
260 Gerne kann ich Ihnen im Rahmen von Mailversand fuer MXChange hier etwas Support
261 in meinem Forum anbieten, ich kann natuerlich nicht die gesamte PHPMailer-Klasse
264 Die neuste PHPMailer-Version finden Sie auf deren Homepage unter der folgenden
267 http://phpmailer.codeworxtech.com/
269 5. Wichtige Templates
270 ---------------------
272 Sie sollten nunn diverse Templates einstellen: impressum.tpl.de, metadata.tpl.de
273 sind beispielsweise im "Fabrikzustand". Verwenden Sie dazu einen einfachen
274 Texteditor und nicht einen HTML-Editor. Diese bauen oefters Kopf- und Fuss-Tags
275 ein, die in Templates unerwuenscht sind.
277 Weitere Details zu meinem Template-System entnehmen Sie bitte der TEMPLATES.de !
279 Ich werde oefters gefragt, wo ein guter Platz fuer Banner-Codes und/oder
280 Counter-Codes ist. Dazu moechte ich gleich die interessantesten Plaetze
283 - guest_header.tpl.de - Kopf-Template im Gastbereich: Hier koennen Sie
284 beispielsweise 468x60-Banner oder Textlinks unterbringen
285 - member_header.tpl.de - Das gleiche Template dieses Mal fuer den Mitgliedsbereich
286 - guest_footer.tpl.de - Das gleiche dieses Mal unten der Fuss
287 - member_footer.tpl.de - Das gleiche dieses Mal fuer den Mitgliedsbereich
288 - guest_advert.tpl.de - Gast-Template unterhalb des Menue-Systems: Hier passen
289 gut 88x31-Banner und/oder Counter-Codes rein
290 - member_advert.tpl.de - Gleiches Template fuer den Mitgliedsbereich
292 6. Wie Sie mit dem Script Geld verdienen
293 ----------------------------------------
295 Sie koennen nicht nur mit Werbeeinahmen Geld verdienen - was sich nur bei 1000
296 Besuchern pro Tag und mehr sich lohnen wuerde - sondern auch mit Verkauf von
297 Accounts! Dabei brauchen Sie noch nicht mal Ihren Ref-Link bewerben! Das
298 geschieht vollkommen automatisch!
300 Melden Sie sich als naechstes selber an. Die vom System Ihnen zugeteilte Ref-ID
301 stellen Sie unter "Einstellungen -> Standart Ref-ID" als Referal-ID ein.
303 Sobald Sie dies getan haben, und jemand Ihren Mailtausch ohne Ref-Link aufruft,
304 wird automatisch Ihre Ref-ID im Anmeldeformular eingesetzt. Folglich erhalten Sie
305 alle Refs, die nicht ueber Ref-Links reingekommen sind! Wenn Sie meinen, dass Sie
306 genug Refs haben (Tipp: ab 30 Refs wird es interessant fuer das neue Mitglied!)
307 dann versteigern Sie diesen in einem Auktionshaus Ihrer Wahl oder verkaufen Sie
308 diesen von Ihrer Webseite aus.
310 Nach Verkauf und Abgabe des Accounts melden Sie einfach erneut an, tragen die
311 Ref-ID ein und das Spiel beginnt von vorne.
313 Viel Erfolg beim Geldverdienen!
315 Uebrigens: 30 Refs sind durchaus 20 EUR und mehr wert. Und Sie muessen
316 natuerlich Ihren Mailtausch bewerben, da ihn sonst niemand kennt! Aber das
317 sollte Ihnen schon klar sein...
319 7. Tipps und Hinweise zum Thema Sicherheit
320 ------------------------------------------
322 ###############################################################################
323 Etwas sehr wichtiges vorweg: Loeschen Sie die Installationsroutine (install.php
324 aus dem Hauptverzeichnis und inc/install*), damit Unbefugte diese nicht
325 missbrauchen koennen!
326 ###############################################################################
328 Stellen Sie beim Sicherheitscode (beim Best. von Mails wird dieser angezeigt und
329 muss wiederholt werden) nicht weniger als 3 ein. Eine 0 deaktiviert nun seit
330 einigen Versionen den Code, nicht aber den Button! Dieser muss noch immer
331 angeklickt werden. Ich habe diesen Code aus einem einfachen Grund eingebaut:
333 So wie es bei einem anderen Mailtausch-Betreiber aussah, wurden zwar die Mails
334 bestaetigt, aber die Seite nie besucht. So wie ich vermute, wurden sogn. Fake-
335 Programme (Auto-Confirm) verwendet, um die Mails zu bestaetigen, da die Links
338 Dieses Script ist mit einem Sicherheitscode zum Eingeben + einem Buttom zum
339 Anklicken ausgestattet. Er wird in ein Bild hineingeschrieben, das gemustert
340 ist. Weitere Details entnehmen Sie bitte der Textdatei SECURITY.txt!
342 Um diesen Code kommen (hoffentlich) die Faker-Programme nicht mehr herum.
347 Zur Deinstallation loeschen Sie alle Dateien des Scriptes vom Server und die
348 Tabellen mit Struktur. Bei den meisten Hostern duerfen Sie nicht die Datenbank
349 selber loeschen. Versuche dies zu tun, fuehren zu Fehlern und die Tabellen
355 Da dieses Script frei und ohne Alterskontrolle zur Verfuegung steht, kann ich
356 nicht kontrollieren, wer sich dieses runterlaedt. In jedem Fall mache ich mich
357 fuer Folgen und daraus resultierenden Schaeden in keinsterweise verantwortlich
358 und entziehe mich von der Haftbarkeit.
360 Jeder, der diese Software runterlaedt, hat die Lizenz GNU GPL Version 2 oder
361 jede neuere Version gelesen und akzeptiert. Diese wird im jedem vollen Paket
362 (nicht Patches) und Erweiterungen mitgeschickt.