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&uuml;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 gelesen und
 361 akzeptiert. Diese wird im jedem vollen Paket (nicht Patches) und Erweiterungen
 362 mitgeschickt.
 363
 364 [EOF]