ext-network continued, documentation updated, stelzi's fix integrated:
[mailer.git] / DOCS / de / README.txt
1 Deutsche README-Datei
2 =====================
3
4 Themenuebersicht:
5 ----------------
6 1. Danke
7 2. Voraussetzungen
8 3. Installation
9 3. b) Manuelle-Installation
10 4. Konfiguration
11 4. b) SMTP-Support durch PHPMailer
12 5. Wichtige Templates
13 6. Wie Sie mit dem Script Geld verdienen
14 7. Tipps und Hinweise zum Thema Sicherheit
15 8. Deinstallation
16 9. Distanzierung
17 ----------------
18
19 1. Danke
20 --------
21
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!
28
29 2. Voraussetzungen
30 ------------------
31
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
34 woanders hin... :-) )
35
36 LAMP steht fuer "Linux, Apache, MySQL, PHP".
37
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.
40
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!
43 (Siehe 3.b) )
44
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.
52
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. :-/
56
57 3. Installation
58 ---------------
59
60 Die Installation ist recht einfach gehalten:
61
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).
65
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!
69
70 - Setzen Sie die Zugriffsrechte (CHMOD) wie folgt:
71   + Verzeichnis inc auf 777
72   + Datein inc/config.php auf 666
73
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:
79
80   - install.php?theme=business = Ruft das Theme "Solid-Business" auf
81   - install.php?theme=desert   = Ruft das Theme "Desert-Storm" auf
82
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".
86
87 - Neuerdings wird auch die URL automatisch erkannt. Auch hier brauchen Sie mit
88   99%-iger Wahrscheinlichkeit nichts aendern. :-)
89
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
94
95 - Lassen Sie folgende Einstellungen beim Installieren auf Standart:
96   + Ausgabe-Modus auf 'render'
97   + Frameset abschalten (Table-Set aktivieren).
98
99   Diese beiden Einstellungen haben bei den ersten Installationen die meisten
100   Fehler verursacht!
101
102 Viel Glueck! :-)
103
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 ********************************************************************************
110
111 3. b) Manuelle-Installation
112 ---------------------------
113
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!
120
121 ********************************************************************************
122 *          Ab hier die veraltete Anleitung zur manuellen Installation          *
123 ********************************************************************************
124
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:
128
129 1. install/tables.sql
130 2. install/menu-de.sql
131
132 Stellen Sie dann in der inc/config.php die Konstante mxchange_installed auf
133 'true'.
134
135 Vorher:
136 define('mxchange_installed', false);
137
138 Nachher:
139 define('mxchange_installed', true);
140
141 Anschliessend stellen Sie die MySQL-Zugangsdaten, den Titel Ihres Mailtausches,
142 Werbspruch (Slogan) und Ihre EMail-Adresse (zum Empfangen von Anmelde-EMails
143 usw.) ein.
144
145 Die inc/config.php ist dazu von mir ausreichend gut durchkommentiert. Beachten
146 Sie aber, dass Sie Ihre Daten zwischen die doppelten Anfuehrungszeichen (")
147 setzen muessen.
148
149 Ebenfalls viel Glueck dabei! :-)
150
151 Als naechstes lesen Sie sich bitte die FAQs auf meiner Webseite durch:
152
153 http://www.mxchange.org/cms/index/wht/faqs
154
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:
158
159 http://forum.mxchange.org
160
161 Auch sollten Sie meinen Bug-Tracker aufsuchen und dort Fehlermeldungen posten:
162
163 http://bugs.mxchange.org
164
165 Alle wichtigen Kontaktdaten finden Sie im Impressum:
166
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!
170
171 4. Konfiguration
172 ----------------
173
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.
177
178 Danach geht es gleich im Admin-Bereich weiter. Glueckwunsch, Sie sind hier
179 angekommen!
180
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.
184
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.
189
190 Die Erweiterungen admintheme1 und admintheme_default sind Sondererweiterungen:
191
192 - admintheme_default: Standartmenue (Auslieferung) setzen
193 - admintheme1: EMail-Statistik und Online-Statistik werden in das Menue
194   Statistiken verschoben
195
196 Beachten Sie, dass diese Erweiterungen nach Registrierung wieder entfernt
197 werden, da sie nur das Admin-Menue veraendern sollen und sonst keine weitere
198 Funktion haben.
199
200 Zurueck zur Konfiguration des Mailtausches!
201
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:
205
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!
209
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!
213
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
217   Urlauber) sein.
218
219 - Sicherheitseinstellungen: Diverse Einstellungen zum Thema Sicherheit, wie
220   minimale Passwortlaenge, doppelt angemeldete Email-Adressen / Passwoerter
221   verweigern.
222
223 - Punkte: Hier gibt es gleich zwei weitere Unterpunkte:
224
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.
228
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. :-)
234
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!!!
239
240 Wenn Sie hier angekommen sind, haben Sie Ihren ersten (?) freien Mailtausch
241 eingerichtet! Nochmals "Herzlichen Glueckwunsch" an dieser Stelle!
242
243 4.b) SMTP-Support durch PHPMailer
244 ---------------------------------
245
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.
251
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!
259
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
262 supporten!
263
264 Die neuste PHPMailer-Version finden Sie auf deren Homepage unter der folgenden
265 Adresse:
266
267 http://phpmailer.codeworxtech.com/
268
269 5. Wichtige Templates
270 ---------------------
271
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.
276
277 Weitere Details zu meinem Template-System entnehmen Sie bitte der TEMPLATES.de !
278
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
281 auflisten:
282
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
291
292 6. Wie Sie mit dem Script Geld verdienen
293 ----------------------------------------
294
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!
299
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.
302
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.
309
310 Nach Verkauf und Abgabe des Accounts melden Sie einfach erneut an, tragen die
311 Ref-ID ein und das Spiel beginnt von vorne.
312
313 Viel Erfolg beim Geldverdienen!
314
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...
318
319 7. Tipps und Hinweise zum Thema Sicherheit
320 ------------------------------------------
321
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 ###############################################################################
327
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:
332
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
336 nachmachbar sind.
337
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!
341
342 Um diesen Code kommen (hoffentlich) die Faker-Programme nicht mehr herum.
343
344 8. Deinstallation
345 -----------------
346
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
350 bleiben bestehen.
351
352 9. Distanzierung
353 ----------------
354
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.
359
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.
363
364 [EOF]