Achtung: Dies hier ist auch nicht für V4.5.4 oder V4.6 geeignet!!!
Vorsicht: Die Installation ist leider nicht trivial! Es wird phpMyAdmin (oder ein anderes geeignetes Verwaltungswerkzeug für mySQL-Datenbanken) benötigt. Auch einige Kenntnisse zu SQL und PHP wären günstig. Erschwerend kommt hinzu, dass man die mitgelieferte LiesMich.txt durchlesen und verstehen muss...
Und wie immer: Backup, Backup, Backup...
Für die Installation werden die folgenden zwei Pakete benötigt:
1. Die Newsletter-Core-ZIP-Datei gibt es [hier].
2. Das Zusatz-Pack unterscheidet sich geringfügig in Abhängigkeit von der verwendeten V4.5.x-Version:
V4.5.2 alpha: [hier]
V4.5 CVS (aktuellerer Snapshot, letzte getestete Version: contenido-cvs-45-2004-11-26): [hier]
Installation:
1. Den Inhalt der Newsletter-Core-ZIP-Datei (source_base.zip) entpacken.
2. Wichtig! Nun in der class.newsletter.groups.php in der Klasse "RecipientGroupMemberCollection" (unten) in der Funktion "function RecipientGroupMemberCollection()"
die folgenden Zeilen auskommentieren:
Code:
$this->_setJoinPartner ('RecipientGroupCollection');
$this->_setJoinPartner ('RecipientCollection');
D.h. ändern in:
Code:
// $this->_setJoinPartner ('RecipientGroupCollection');
// $this->_setJoinPartner ('RecipientCollection');
3. Die Dateien (ohne die LiesMich.txt-Dateien) in die entsprechenden Verzeichnisse hochladen (ab jetzt gibt es kein zurück mehr - wenn doch gewünscht: ggf. vorhandene Dateien auf dem Webserver vorher sichern bzw. umbenennen).
4. Den Inhalt des Zusatz-Pack (source_45.zip oder source_452.zip) entpacken und laaaangsam weiterlesen:
5. Folgende Dateien auf dem Webserver umbenennen, z.B. in .old (in dieser Zeit ist kein Zugriff auf Contenido möglich):
contenido\classes\class.genericdb.php
contenido\classes\class.ui.php
contenido\includes\cfg_language_de.inc.php
contenido\includes\cfg_sql.inc.php
contenido\xml\lang_*.xml (d.h. alle vorhandenen Dateien)
6a. Wenn man sich 100% sicher ist, die oben genannten Contenido-Versionen einzusetzen (d.h. V4.5.2 Alpha oder V4.5 in einem aktuelleren Snapshot, getestet bis: siehe oben), die entpackten Dateien (ohne die db_update.txt) in die entsprechenden Verzeichnisse hochladen.
6b. Wenn man doch eine andere Version einsetzt (z.B. eine zu diesem Zeitpunkt nicht verfügbare neuere V4.5.x), dann müssen die notwendigen Änderungen in den genannten Dateien manuell vorgenommen werden. Die notwendigen Informationen enthält die im Core-Pack mitgelieferte LiesMich.txt.
7. Jetzt wird es haklig: Mit phpMyAdmin bei seiner Contenido-mySQL-Datenbank anmelden.
8. Die db_update.txt in einem Text-Editor öffnen.
9. Die Tabellen-Prefixe an die eigenen Gegegenheiten anpassen (ersetze con_ durch xyz), Standard ist con.
10a. Wenn man sich ganz sicher ist, die richtige Version zu verwenden, auf eine beliebige Tabelle klicken und auf der rechten Seite auf "SQL". In die Eingabebox den ggf. geänderten Text aus der db_update.txt einfügen und mit OK ausführen.
10b. Wenn man sich nicht ganz sicher ist, ob man die richtige Version einsetzt (aus Datenbank-Sicht), stehen in der LiesMich.txt weitere Informationen zu den Änderungen zur Verfügung.
11. Fertig
Konfiguration:
Damit der Newsletter eingesetzt werden kann, müssen entsprechende Module zur Anmeldung und Verwaltung eingesetzt werden (siehe: [hier]).
Das Modul zur Verwaltung heißt nun "Newsletter Handler" (vorher: "Newsletter Blackbox"). Dieses Modul wird auf einer separaten Seite eingesetzt. Die ID dieses Artikels (idcatart) muss in den Mandanten-Einstellungen eingetragen werden, sonst ist ein Versenden eines Newsletters nicht möglich. Dazu stehen aber Funktionen in den Modulen zur Verfügung.
Wenn bereits Empfänger vorhanden sind:
Zum einen wird mit dieser Version ein Identifizierungs-Key für die Empfänger verwendet, mit der Empfänger sich an- und abmelden kann. Zum anderen hat sich gegenüber der vorherigen Version (zu V4.4.2/V4.4.4) dieser Key aus Sicherheitsgründen wieder geändert.
Mit den folgenden Schritten werden die Keys für alle Mandanten aktualisiert:
1. Schlüssel in System-Einstellung eintragen (Administration -> System -> Systemeinstellungen):
Typ: Newsletter
Name: updatekeys
Wert: 0 - Keine Neuberechnung, 1 - Neuberechnung bei Empfängern ohne oder mit Key mit einer Länge <> 30
2. Einmal Menü Extras -> Empfänger aufrufen.
Der Wert 1 und der Aufruf von Extras -> Empfänger führt zu einer Neuberechnung der Keys für Empfänger ohne Key bzw. einem Key mit einer Länge <> 30 bei >>>allen<<< Mandanten in >>>allen<<< Sprachen.
3. Danach sollte der Eintrag aus Performance-Gründen wieder gelöscht oder auf 0 gesetzt werden.
Neue Features:
- Komplette Umstellung des Newsletter-Bereichs auf Klassen,
- Newsletter können kopiert werden,
- Empfänger-Gruppen,
- Spezifizierung einer Standard-Empfänger-Gruppe möglich,
- Standard-Empfänger-Gruppe verfügt über * und steht am Anfang der Liste,
- Neue Empfänger werden autom. in Standard-Empfänger-Gruppe eingetragen,
- Übergabe der Newsletter-IDCatArt über Mandanteneingenschaft,
- Versenden des Newsletters an ausgewählte Gruppen,
- Löschen von alten, unbestätigten Empfängern ("purge"),
- Bestätigungsdatum wird erfasst,
- Willkommens-Newsletter-Eigenschaft wird in DB gespeichert,
- Willkommens-Newsletter verfügt über * und steht am Anfang der Liste,
- das nachträgliche Ändern der E-Mail-Adresse wäre möglich (ist aber in dem dazugehörigen Modulen noch nicht realisiert),
- Anmeldung von Nutzern bei mehr als einer Gruppe ermöglichen
- Link zu Frontend-Users (Anmeldung am Newsletter führt zur Erzeugung eines dekativierten Frontend-Users-Accounts, Aktivierung aktiviert FrontEnd-User-Account, Abmeldung führt zur Deaktivierung oder Löschung des Frontend-User-Accounts)
Korrekturen (Achtung!):
- MAIL_DATE und MAIL_TIME zeigen Sendedatum bzw. -zeit und nicht mehr das Datum, wann der Newsletter in der DB erzeugt wurde
- Die Newsletter werden nun nach Namen und nicht mehr nach Erstellung sortiert (Willkommens-Newsletter steht ggf. oben)
- Identifizierungs-Key kann nicht mehr geraten werden...
- Alter und neuer Key sind nicht identisch, neuer Key ist 30 Zeichen lang (damit ist die versehentliche Verwendung der alten Keys ohne Folgen)
- Als Speicherplatz für den Key wird die (z.Z. unbenutzte) Spalte 'hash' verwendet
- Wieder enthalten: Suchfunktion bei Empfängern
- Wieder enthalten: Begrenzte Anzeige der Anzahl der angezeigten Empfänger (inkl. vor und zurück)
Achtung: Etliche Änderungen werden bei einer neuen Contenido-Version wieder überschrieben - bitte Forum beachten bzw. ggf. selbst Hand anlegen ...
Bei Problemen:
Bitte Probleme im Modul-Thread posten: [hier]
Ich hoffe, ich habe nix vergessen... Ach ja, da die .po-Dateien (noch) nicht überarbeitet sind, erscheinen stellenweise englische Texte im Backend...
Gruß
HerrB