Removed unneccessary eval() command in overview-inc.php, internal TODO closed
[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 Auch sollten Sie meinen Bug-Tracker aufsuchen und dort Fehlermeldungen posten:
150
151 http://bugs.mxchange.org
152
153 Alle wichtigen Kontaktdaten finden Sie im Impressum:
154
155 http://www.mxchange.org oder
156 http://www.mxchange.de oder
157 http://www.mxchange-demo.de
158
159 4. Konfiguration
160 ----------------
161
162 Nach dem Installationsvorgang sollte das *grundlegenste* erledigt sein.
163 Richten Sie als naechstes *unbedingt* einen Administrator-Account ein! Dieses
164 wird auch nach der Installation automatisch der naechste Schritt sein.
165
166 Danach geht es gleich im Admin-Bereich weiter. Glueckwunsch, Sie sind hier
167 angekommen!
168
169 Gleich nach dem Login im Admin-Bereich werden Ihnen eine Reihe Aufgaben
170 zugeteilt. Führen Sie der Reihe nach aus und installieren Sie die
171 Erweiterungen in Ihr System.
172
173 Danach koennen Sie die Aufgaben ohne Bedenken loeschen. Sollten Sie mal ein
174 Update von mir erhalten, oder auch eine Erweiterung loeschen, wird - solange
175 die Erweiterung noch auf dem Server existiert - wieder eine neue Aufgabe
176 automatisch generiert.
177
178 Die Erweiterungen admintheme1 und admintheme_default sind Sondererweiterungen:
179
180 - admintheme_default: Standartmenue (Auslieferung) setzen
181 - admintheme1: EMail-Statistik und Online-Statistik werden in das Menue
182   Statistiken verschoben
183
184 Beachten Sie, dass diese Erweiterungen nach Registrierung wieder entfernt
185 werden, da sie nur das Admin-Menue veraendern sollen und sonst keine weitere
186 Funktion haben.
187
188 Zurueck zur Konfiguration des Mailtausches!
189
190 Als naechstes sollten Sie schauen, ob Sie mit den Standartbeschriftungen aller
191 Menues zufrieden sind (was auch meistens so ist... ;-) ). Dann richten Sie unter
192 "Einstellungen" die Untermenuepunkte von oben nach unten durcharbeiten:
193
194 - Kategorien einrichten: Richten Sie hier Kategorien ein. In diesen koennen dann
195   Ihre Mitglieder ihre Werbung spaeter buchen. Es snd berteits welche vorgegeben.
196   Derzeit koenenn Sie noch nicht aendern oder loeschen!
197
198 - Anmeldeformular: Stellen Sie hier ein, wie viele Kategorien bei der Anmeldung
199   *mindestens* ausgewaehlt werden sollen, damit die Anmeldung durchgefuehrt
200   werden kann. Dieses wirkt sich auch spaeter auf den Mailversand aus!
201
202 - Versand, Empfang: Richten Sie hier fuer die Mitglieder die maximal zu
203   empfangenen Mails pro Tag ein (also wie viel ein Mitglied pro Tag empfangen
204   will). Dieses sollten schon mehr als 5 Auswahlen (+ 0 Mails / Tag wegen der
205   Urlauber) sein.
206
207 - Sicherheitseinstellungen: Diverse Einstellungen zum Thema Sicherheit, wie
208   minimale Passwortlaenge, doppelt angemeldete Email-Adressen / Passwoerter
209   verweigern.
210
211 - Punkte: Hier gibt es gleich zwei weitere Unterpunkte:
212
213         * Willkommensgutschrift und andere Festbetraege editieren: Hier stellen Sie
214           Die Vergueetung bei Anmeldung ("Willkommensgutschrift") und eine einmalige
215           Referal-Gutschrift (nur erste Ebene!) ein.
216
217         * Referal-Ebenen editieren / loeschen / hinzufuegen: Dies ist wohl das
218           interessanteste fuer Mitglieder! Es empfiehlt sich, das ganze "in der
219           Waage" zu halten: Nicht zu viel aber auch nicht zu wenig und je "tiefer"
220           die Ebenen, desto niedriger der prozentualer Anteil. Zudem sollten zum
221           Starten 5 Ebenen reichen. :-)
222
223         * Auch bei den Referal-Ebenen koennen Sie noch nichts aendern / loeschen!
224           Loeschen von Referal-Ebenen im Betrieb ist gefaehrlich! Dadurch
225           verlieren Ihre Mitglieder definitiv Punkte in den Ebenen! Also vorher
226           manuell gutschreiben!!!
227
228 Wenn Sie hier angekommen sind, haben Sie Ihren ersten (?) freien Mailtausch
229 eingerichtet! Nochmals "Herzlichen Glueckwunsch" an dieser Stelle!
230
231 4.b) SMTP-Support durch PHPMailer
232 ---------------------------------
233
234 Seit der MXChange Version 0.2.1-RC5 wird PHPMailer in der Version 2.0.0 genutzt.
235 Die Dokumentation, sowie Lizenzdatei finden Sie unter inc/phpmailer/. Ich nutze
236 davon jedoch nur den SMTP-Auth-Mechanismus, damit mehr User mein Skript nutzen
237 koennen. Mein besonderer Dank gilt hier The Shadowmaster, da er mich darauf
238 aufmerksam und angespornt hat, den Support fuer SMTP-Auth einzubauen.
239
240 Damit Sie dies nun auch in MXChange nutzen koennen, muessen Sie nach der
241 Installation von MXChange die config.php erneut runterladen(!) und die Eintraege
242 SMTP_HOSTNAME, SMTP_USER und SMTP_PASSWORD anpassen. Derzeit wird nur die
243 SASL-Methode LOGIN unterstuetzt. Tesweise koennen Sie auch versuchen, SSL
244 einzuschalten. Sollten Sie Fehlermeldungen erhalten und es sind keine Mails
245 unterwegs, versuchen Sie als erstes das SSL abzuschalten. Eventuell unterstuetzt
246 Ihr fsocksopen()-Befehl von PHP kein SSL!
247
248 Gerne kann ich Ihnen im Rahmen von Mailversand fuer MXChange hier etwas Support
249 in meinem Forum anbieten, ich kann natuerlich nicht die gesamte PHPMailer-Klasse
250 supporten!
251
252 Die neuste PHPMailer-Version finden Sie auf deren Homepage unter der folgenden
253 Adresse:
254
255 http://phpmailer.codeworxtech.com/
256
257 5. Wichtige Templates
258 ---------------------
259
260 Sie sollten nunn diverse Templates einstellen: impressum.tpl.de, metadata.tpl.de
261 sind beispielsweise im "Fabrikzustand". Verwenden Sie dazu einen einfachen
262 Texteditor und nicht einen HTML-Editor. Diese bauen oefters Kopf- und Fuss-Tags
263 ein, die in Templates unerwuenscht sind.
264
265 Weitere Details zu meinem Template-System entnehmen Sie bitte der TEMPLATES.de !
266
267 Ich werde oefters gefragt, wo ein guter Platz fuer Banner-Codes und/oder
268 Counter-Codes ist. Dazu moechte ich gleich die interessantesten Plaetze
269 auflisten:
270
271 - guest_header.tpl.de - Kopf-Template im Gastbereich: Hier koennen Sie
272   beispielsweise 468x60-Banner oder Textlinks unterbringen
273 - member_header.tpl.de - Das gleiche Template dieses Mal fuer den Mitgliedsbereich
274 - guest_footer.tpl.de - Das gleiche dieses Mal unten der Fuss
275 - member_footer.tpl.de - Das gleiche dieses Mal fuer den Mitgliedsbereich
276 - guest_advert.tpl.de - Gast-Template unterhalb des Menue-Systems: Hier passen
277   gut 88x31-Banner und/oder Counter-Codes rein
278 - member_advert.tpl.de - Gleiches Template fuer den Mitgliedsbereich
279
280 6. Wie Sie mit dem Script Geld verdienen
281 ----------------------------------------
282
283 Sie koennen nicht nur mit Werbeeinahmen Geld verdienen - was sich nur bei 1000
284 Besuchern pro Tag und mehr sich lohnen wuerde - sondern auch mit Verkauf von
285 Accounts! Dabei brauchen Sie noch nicht mal Ihren Ref-Link bewerben! Das
286 geschieht vollkommen automatisch!
287
288 Melden Sie sich als naechstes selber an. Die vom System Ihnen zugeteilte Ref-ID
289 stellen Sie unter "Einstellungen -> Standart Ref-ID" als Referal-ID ein.
290
291 Sobald Sie dies getan haben, und jemand Ihren Mailtausch ohne Ref-Link aufruft,
292 wird automatisch Ihre Ref-ID im Anmeldeformular eingesetzt. Folglich erhalten Sie
293 alle Refs, die nicht ueber Ref-Links reingekommen sind! Wenn Sie meinen, dass Sie
294 genug Refs haben (Tipp: ab 30 Refs wird es interessant fuer das neue Mitglied!)
295 dann versteigern Sie diesen in einem Auktionshaus Ihrer Wahl oder verkaufen Sie
296 diesen von Ihrer Webseite aus.
297
298 Nach Verkauf und Abgabe des Accounts melden Sie einfach erneut an, tragen die
299 Ref-ID ein und das Spiel beginnt von vorne.
300
301 Viel Erfolg beim Geldverdienen!
302
303 Uebrigens: 30 Refs sind durchaus 20 EUR und mehr wert. Und Sie muessen
304 natuerlich Ihren Mailtausch bewerben, da ihn sonst niemand kennt! Aber das
305 sollte Ihnen schon klar sein...
306
307 7. Tipps und Hinweise zum Thema Sicherheit
308 ------------------------------------------
309
310 ###############################################################################
311 Etwas sehr wichtiges vorweg: Loeschen Sie die Installationsroutine (install.php
312 aus dem Hauptverzeichnis und inc/install*), damit Unbefugte diese nicht
313 missbrauchen koennen!
314 ###############################################################################
315
316 Stellen Sie beim Sicherheitscode (beim Best. von Mails wird dieser angezeigt und
317 muss wiederholt werden) nicht weniger als 3 ein. Eine 0 deaktiviert nun seit
318 einigen Versionen den Code, nicht aber den Button! Dieser muss noch immer
319 angeklickt werden. Ich habe diesen Code aus einem einfachen Grund eingebaut:
320
321 So wie es bei einem anderen Mailtausch-Betreiber aussah, wurden zwar die Mails
322 bestaetigt, aber die Seite nie besucht. So wie ich vermute, wurden sogn. Fake-
323 Programme (Auto-Confirm) verwendet, um die Mails zu bestaetigen, da die Links
324 nachmachbar sind.
325
326 Dieses Script ist mit einem Sicherheitscode zum Eingeben + einem Buttom zum
327 Anklicken ausgestattet. Er wird in ein Bild hineingeschrieben, das gemustert
328 ist. Weitere Details entnehmen Sie bitte der Textdatei SECURITY.txt!
329
330 Um diesen Code kommen (hoffentlich) die Faker-Programme nicht mehr herum.
331
332 8. Deinstallation
333 -----------------
334
335 Zur Deinstallation loeschen Sie alle Dateien des Scriptes vom Server und die
336 Tabellen mit Struktur. Bei den meisten Hostern duerfen Sie nicht die Datenbank
337 selber loeschen. Versuche dies zu tun, fuehren zu Fehlern und die Tabellen
338 bleiben bestehen.
339
340 9. Distanzierung
341 ----------------
342
343 Da dieses Script frei und ohne Alterskontrolle zur Verfuegung steht, kann ich
344 nicht kontrollieren, wer sich dieses runterlaedt. In jedem Fall mache ich mich
345 fuer Folgen und daraus resultierenden Schaeden in keinsterweise verantwortlich
346 und entziehe mich von der Haftbarkeit.
347
348 Jeder, der diese Software runterlaedt, hat die Lizenz GNU GPL gelesen und
349 akzeptiert. Diese wird im jedem vollen Paket (nicht Patches) und Erweiterungen
350 mitgeschickt.
351
352 [EOF]