New extension added, minor fixes, new author added
[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. Sollte dies bei Ihnen der Fall sein, fahren
50 Sie unter 3.b) mit der manuellen Installation fort.
51
52 Unter Windows-Systemen habe ich das Script nur unzureichend testen koennen. Wenn
53 Sie also z.B. WinXAMP (oder so?) haben, testen Sie es gerne dort. Gehen Sie aber
54 nicht davon aus, dass es auch fehlerfrei laufen wird. :-/
55
56 3. Installation
57 ---------------
58
59 Die Installation ist recht einfach gehalten:
60
61 - Entpacken Sie das heruntergeladene Archiv (zum Beispiel mit WinZIP) in ein
62   Verzeichnis auf Ihrer Festplatte. Es wird dabei ein Verzeichnis namens
63   "mxchange-x.x.x" angelegt (wobei x.x.x die aktuelle Version ist).
64
65 - Laden Sie den gesamten Inhalt des Verzeichnisses "0.2.1" hoch (die anderen
66   Dateien werden nicht benoetigt.) Auch die SQL-Dateien im Hauptverzeichnis
67   sollten mit hochgeladen werden, die upgrade.php bitte nicht mehr mit hochladen!
68
69 - Setzen Sie die Zugriffsrechte (CHMOD) wie folgt:
70   + Verzeichnis inc auf 777
71   + Datein inc/config.php auf 666
72
73 - Das Script befindet sich jetzt im Installationsmodus! Rufen Sie einfach
74   das Script direkt auf: http://www.mein-server.de/mailtausch/ Das Script leitet
75   Sie direkt in die Installationsroutine. Wenn Sie das aktuelle Theme nicht
76   moegen, so koennen Sie schon jetzt das Theme "auswaehlen", indem Sie es an
77   install.php wie folgt anhaengen:
78
79   - install.php?theme=business = Ruft das Theme "Solid-Business" auf
80   - install.php?theme=desert   = Ruft das Theme "Desert-Storm" auf
81
82 - Der Installationspfad wird vom Script selbst erkannt (Auto-Detection) und
83   brauch bei 99% aller Installationen nicht von Ihnen geaendert werden. Auch
84   die Installationsroutine "laesst die Finger davon".
85
86 - Neuerdings wird auch die URL automatisch erkannt. Auch hier brauchen Sie mit
87   99%-iger Wahrscheinlichkeit nichts aendern. :-)
88
89 - Folgen Sie den Anweisungen auf dem Bildschirm. Wenn diese
90   IMMER_GROSS_GESCHRIEBEN_SIND, ist vermutlich die englische Sprache aktiv. Sie
91   muessen derzeit die deutsche Sprache dann so aufrufen:
92   http://www.ihr-server.de/install.php?mx_lang=de
93
94 - Lassen Sie folgende Einstellungen beim Installieren auf Standart:
95   + Ausgabe-Modus auf 'render'
96   + Frameset abschalten (Table-Set aktivieren).
97
98   Diese beiden Einstellungen haben bei den ersten Installationen die meisten
99   Fehler verursacht!
100
101 Viel Glueck! :-)
102
103 ********************************************************************************
104 Uebrigens: Wenn das Script Sie bittet, Zugriffsrechte bestimmter Dateien oder
105 Verzeichnisse zu aendern und Ihnen aber einen "Weiter-Button" anbietet, fuehren
106 Sie diese ZUERST durch und klicken dann auf "Weiter", versuchen Sie nicht die
107 Seite zu aktualisieren! Das kann durchaus zu Fehlern fuehren.
108 ********************************************************************************
109
110 3. b) Manuelle-Installation
111 ---------------------------
112
113 Falls es bei der halb-automatischen Installation per install.php nicht klappen
114 sollte (Fehlermeldungen beim Einspielen der SQL-Dateien), so muessen Sie diese
115 selber in folgender Reihenfolge (unbedingt einhalten!!!) einspielen:
116
117 1. install/tables.sql
118 2. install/menu-de.sql
119
120 Stellen Sie dann in der inc/config.php die Konstante mxchange_installed auf
121 'true'.
122
123 Vorher:
124 define('mxchange_installed', false);
125
126 Nachher:
127 define('mxchange_installed', true);
128
129 Anschliessend stellen Sie die MySQL-Zugangsdaten, den Titel Ihres Mailtausches,
130 Werbspruch (Slogan) und Ihre EMail-Adresse (zum Empfangen von Anmelde-EMails
131 usw.) ein.
132
133 Die inc/config.php ist dazu von mir ausreichend gut durchkommentiert. Beachten
134 Sie aber, dass Sie Ihre Daten zwischen die doppelten Anfuehrungszeichen (")
135 setzen muessen.
136
137 Ebenfalls viel Glueck dabei! :-)
138
139 Als naechstes lesen Sie sich bitte die FAQs auf meiner Webseite durch:
140
141 http://www.mxchange.org/cms/index/wht/faqs
142
143 Wenn Sie nicht klarkommen oder Sie Endlosschleifen oder Fehlermeldungen
144 erhalten, melden Sie sich bitte bei mir. Die erste Anlaufstelle fuer Sie ist
145 immer mein Forum, welches Sie hier finden koennen:
146
147 http://forum.mxchange.org
148
149 Alle wichtigen Kontaktdaten finden Sie im Impressum:
150
151 http://www.mxchange.org oder
152 http://www.mxchange.de oder
153 http://www.mxchange-demo.de
154
155 4. Konfiguration
156 ----------------
157
158 Nach dem Installationsvorgang sollte das *grundlegenste* erledigt sein.
159 Richten Sie als naechstes *unbedingt* einen Administrator-Account ein! Dieses
160 wird auch nach der Installation automatisch der naechste Schritt sein.
161
162 Danach geht es gleich im Admin-Bereich weiter. Glueckwunsch, Sie sind hier
163 angekommen!
164
165 Gleich nach dem Login im Admin-Bereich werden Ihnen eine Reihe Aufgaben
166 zugeteilt. Führen Sie der Reihe nach aus und installieren Sie die
167 Erweiterungen in Ihr System.
168
169 Danach koennen Sie die Aufgaben ohne Bedenken loeschen. Sollten Sie mal ein
170 Update von mir erhalten, oder auch eine Erweiterung loeschen, wird - solange
171 die Erweiterung noch auf dem Server existiert - wieder eine neue Aufgabe
172 automatisch generiert.
173
174 Die Erweiterungen admintheme1 und admintheme_default sind Sondererweiterungen:
175
176 - admintheme_default: Standartmenue (Auslieferung) setzen
177 - admintheme1: EMail-Statistik und Online-Statistik werden in das Menue
178   Statistiken verschoben
179
180 Beachten Sie, dass diese Erweiterungen nach Registrierung wieder entfernt
181 werden, da sie nur das Admin-Menue veraendern sollen und sonst keine weitere
182 Funktion haben.
183
184 Zurueck zur Konfiguration des Mailtausches!
185
186 Als naechstes sollten Sie schauen, ob Sie mit den Standartbeschriftungen aller
187 Menues zufrieden sind (was auch meistens so ist... ;-) ). Dann richten Sie unter
188 "Einstellungen" die Untermenuepunkte von oben nach unten durcharbeiten:
189
190 - Kategorien einrichten: Richten Sie hier Kategorien ein. In diesen koennen dann
191   Ihre Mitglieder ihre Werbung spaeter buchen. Es snd berteits welche vorgegeben.
192   Derzeit koenenn Sie noch nicht aendern oder loeschen!
193
194 - Anmeldeformular: Stellen Sie hier ein, wie viele Kategorien bei der Anmeldung
195   *mindestens* ausgewaehlt werden sollen, damit die Anmeldung durchgefuehrt
196   werden kann. Dieses wirkt sich auch spaeter auf den Mailversand aus!
197
198 - Versand, Empfang: Richten Sie hier fuer die Mitglieder die maximal zu
199   empfangenen Mails pro Tag ein (also wie viel ein Mitglied pro Tag empfangen
200   will). Dieses sollten schon mehr als 5 Auswahlen (+ 0 Mails / Tag wegen der
201   Urlauber) sein.
202
203 - Sicherheitseinstellungen: Diverse Einstellungen zum Thema Sicherheit, wie
204   minimale Passwortlaenge, doppelt angemeldete Email-Adressen / Passwoerter
205   verweigern.
206
207 - Punkte: Hier gibt es gleich zwei weitere Unterpunkte:
208
209         * Willkommensgutschrift und andere Festbetraege editieren: Hier stellen Sie
210           Die Vergueetung bei Anmeldung ("Willkommensgutschrift") und eine einmalige
211           Referal-Gutschrift (nur erste Ebene!) ein.
212
213         * Referal-Ebenen editieren / loeschen / hinzufuegen: Dies ist wohl das
214           interessanteste fuer Mitglieder! Es empfiehlt sich, das ganze "in der
215           Waage" zu halten: Nicht zu viel aber auch nicht zu wenig und je "tiefer"
216           die Ebenen, desto niedriger der prozentualer Anteil. Zudem sollten zum
217           Starten 5 Ebenen reichen. :-)
218
219         * Auch bei den Referal-Ebenen koennen Sie noch nichts aendern / loeschen!
220           Loeschen von Referal-Ebenen im Betrieb ist gefaehrlich! Dadurch
221           verlieren Ihre Mitglieder definitiv Punkte in den Ebenen! Also vorher
222           manuell gutschreiben!!!
223
224 Wenn Sie hier angekommen sind, haben Sie Ihren ersten (?) freien Mailtausch
225 eingerichtet! Nochmals "Herzlichen Glueckwunsch" an dieser Stelle!
226
227 4.b) SMTP-Support durch PHPMailer
228 ---------------------------------
229
230 Seit der MXChange Version 0.2.1-RC5 wird PHPMailer in der Version 2.0.0 genutzt.
231 Die Dokumentation, sowie Lizenzdatei finden Sie unter inc/phpmailer/. Ich nutze
232 davon jedoch nur den SMTP-Auth-Mechanismus, damit mehr User mein Skript nutzen
233 koennen. Mein besonderer Dank gilt hier The Shadowmaster, da er mich darauf
234 aufmerksam und angespornt hat, den Support fuer SMTP-Auth einzubauen.
235
236 Damit Sie dies nun auch in MXChange nutzen koennen, muessen Sie nach der
237 Installation von MXChange die config.php erneut runterladen(!) und die Eintraege
238 SMTP_HOSTNAME, SMTP_USER und SMTP_PASSWORD anpassen. Derzeit wird nur die
239 SASL-Methode LOGIN unterstuetzt. Tesweise koennen Sie auch versuchen, SSL
240 einzuschalten. Sollten Sie Fehlermeldungen erhalten und es sind keine Mails
241 unterwegs, versuchen Sie als erstes das SSL abzuschalten. Eventuell unterstuetzt
242 Ihr fsocksopen()-Befehl von PHP kein SSL!
243
244 Gerne kann ich Ihnen im Rahmen von Mailversand fuer MXChange hier etwas Support
245 in meinem Forum anbieten, ich kann natuerlich nicht die gesamte PHPMailer-Klasse
246 supporten!
247
248 Die neuste PHPMailer-Version finden Sie auf deren Homepage unter der folgenden
249 Adresse:
250
251 http://phpmailer.codeworxtech.com/
252
253 5. Wichtige Templates
254 ---------------------
255
256 Sie sollten nunn diverse Templates einstellen: impressum.tpl.de, metadata.tpl.de
257 sind beispielsweise im "Fabrikzustand". Verwenden Sie dazu einen einfachen
258 Texteditor und nicht einen HTML-Editor. Diese bauen oefters Kopf- und Fuss-Tags
259 ein, die in Templates unerwuenscht sind.
260
261 Weitere Details zu meinem Template-System entnehmen Sie bitte der TEMPLATES.de !
262
263 Ich werde oefters gefragt, wo ein guter Platz fuer Banner-Codes und/oder
264 Counter-Codes ist. Dazu moechte ich gleich die interessantesten Plaetze
265 auflisten:
266
267 - guest_header.tpl.de - Kopf-Template im Gastbereich: Hier koennen Sie
268   beispielsweise 468x60-Banner oder Textlinks unterbringen
269 - member_header.tpl.de - Das gleiche Template dieses Mal fuer den Mitgliedsbereich
270 - guest_footer.tpl.de - Das gleiche dieses Mal unten der Fuss
271 - member_footer.tpl.de - Das gleiche dieses Mal fuer den Mitgliedsbereich
272 - guest_advert.tpl.de - Gast-Template unterhalb des Menue-Systems: Hier passen
273   gut 88x31-Banner und/oder Counter-Codes rein
274 - member_advert.tpl.de - Gleiches Template fuer den Mitgliedsbereich
275
276 6. Wie Sie mit dem Script Geld verdienen
277 ----------------------------------------
278
279 Sie koennen nicht nur mit Werbeeinahmen Geld verdienen - was sich nur bei 1000
280 Besuchern pro Tag und mehr sich lohnen wuerde - sondern auch mit Verkauf von
281 Accounts! Dabei brauchen Sie noch nicht mal Ihren Ref-Link bewerben! Das
282 geschieht vollkommen automatisch!
283
284 Melden Sie sich als naechstes selber an. Die vom System Ihnen zugeteilte Ref-ID
285 stellen Sie unter "Einstellungen -> Standart Ref-ID" als Referal-ID ein.
286
287 Sobald Sie dies getan haben, und jemand Ihren Mailtausch ohne Ref-Link aufruft,
288 wird automatisch Ihre Ref-ID im Anmeldeformular eingesetzt. Folglich erhalten Sie
289 alle Refs, die nicht ueber Ref-Links reingekommen sind! Wenn Sie meinen, dass Sie
290 genug Refs haben (Tipp: ab 30 Refs wird es interessant fuer das neue Mitglied!)
291 dann versteigern Sie diesen in einem Auktionshaus Ihrer Wahl oder verkaufen Sie
292 diesen von Ihrer Webseite aus.
293
294 Nach Verkauf und Abgabe des Accounts melden Sie einfach erneut an, tragen die
295 Ref-ID ein und das Spiel beginnt von vorne.
296
297 Viel Erfolg beim Geldverdienen!
298
299 Uebrigens: 30 Refs sind durchaus 20 EUR und mehr wert. Und Sie muessen
300 natuerlich Ihren Mailtausch bewerben, da ihn sonst niemand kennt! Aber das
301 sollte Ihnen schon klar sein...
302
303 7. Tipps und Hinweise zum Thema Sicherheit
304 ------------------------------------------
305
306 ###############################################################################
307 Etwas sehr wichtiges vorweg: Loeschen Sie die Installationsroutine (install.php
308 aus dem Hauptverzeichnis und inc/install*), damit Unbefugte diese nicht
309 missbrauchen koennen!
310 ###############################################################################
311
312 Stellen Sie beim Sicherheitscode (beim Best. von Mails wird dieser angezeigt und
313 muss wiederholt werden) nicht weniger als 3 ein. Eine 0 deaktiviert nun seit
314 einigen Versionen den Code, nicht aber den Button! Dieser muss noch immer
315 angeklickt werden. Ich habe diesen Code aus einem einfachen Grund eingebaut:
316
317 So wie es bei einem anderen Mailtausch-Betreiber aussah, wurden zwar die Mails
318 bestaetigt, aber die Seite nie besucht. So wie ich vermute, wurden sogn. Fake-
319 Programme (Auto-Confirm) verwendet, um die Mails zu bestaetigen, da die Links
320 nachmachbar sind.
321
322 Dieses Script ist mit einem Sicherheitscode zum Eingeben + einem Buttom zum
323 Anklicken ausgestattet. Er wird in ein Bild hineingeschrieben, das gemustert
324 ist. Weitere Details entnehmen Sie bitte der Textdatei SECURITY.txt!
325
326 Um diesen Code kommen (hoffentlich) die Faker-Programme nicht mehr herum.
327
328 8. Deinstallation
329 -----------------
330
331 Zur Deinstallation loeschen Sie alle Dateien des Scriptes vom Server und die
332 Tabellen mit Struktur. Bei den meisten Hostern duerfen Sie nicht die Datenbank
333 selber loeschen. Versuche dies zu tun, fuehren zu Fehlern und die Tabellen
334 bleiben bestehen.
335
336 9. Distanzierung
337 ----------------
338
339 Da dieses Script frei und ohne Alterskontrolle zur Verfuegung steht, kann ich
340 nicht kontrollieren, wer sich dieses runterlaedt. In jedem Fall mache ich mich
341 fuer Folgen und daraus resultierenden Schaeden in keinsterweise verantwortlich
342 und entziehe mich von der Haftbarkeit.
343
344 Jeder, der diese Software runterlaedt, hat die Lizenz GNU GPL gelesen und
345 akzeptiert. Diese wird im jedem vollen Paket (nicht Patches) und Erweiterungen
346 mitgeschickt.
347
348 [EOF]