Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- administration:newsletter [2022/12/13 14:42] – paellig
+++ administration:newsletter [2025/09/16 15:17] (aktuell) – [Manueller CSV/XLSX Import] ameier
@@ Zeile 5: / Zeile 5: @@
 Folgende Angaben sind Teil der Bestellung:
-  * Die grösse des **Headerbilds** ist unterschiedlich je nach dem, ob es Partnerlogos beinhaltet oder nicht. Diehe dazu die Spezifikation in Ticket Nr. [[https://redmine.visol.ch/issues/30136#note-11|30136]]. Das Bild soll im PNG Format gespeichert werden.
+  * Headerbild und Logo sind getrennte Grafiken und können, bei Bedarf, mit einem Partnerlogo ergänzt werden. Siehe dazu die Spezifikation in Ticket Nr. [[https://redmine.visol.ch/issues/30136#note-11|30136]]. Das Bild soll im JPG-Format gespeichert werden. Die in der Kerbe verwendete Schrift ist "Söhne - Halbfett" (@visol: Der Font ist, zusammen mit einer Musterdatei und Anleitung für Affinity Photo, im Kundenordner von Google Drive.){{:undefined:header-foto-masse.png|}}
   * **Titel** des Newsletters (i.d.R. identisch mit Text auf Grafik)
   * **Bezeichnung** des Newsletters (Text unterhalb des Headers)
@@ Zeile 12: / Zeile 12: @@
   * Information, ob der Newsletter an **interne Benutzer** (siehe unten) **oder externe Benutzer** geht. Bei internen Benutzern die Angabe der Datenquelle (XML-Datei auf dem Server), bei externen Benutzern Info, auf welcher Seite die **Anmeldung** eingefügt werden soll.
   * Information, ob der Newsletter **öffentlich einsehbar ist oder nur von intern** bzw. via SwitchAAI- oder Benutzername/Kennwort-Anmeldung.
+Siehe auch https://docs.google.com/document/d/1yQUSdqJUaafySsbSkCl5olTmXOwnUrquFh-mgBdGh3Y/edit
 ===== Einrichtung durch den Betrieb =====
@@ Zeile 21: / Zeile 23: @@
   * Hinzufügen dieser Gruppe zu den erlaubten Gruppen ("Groups which may be assigned through the action") in der **sys_action "Backend-Benutzer verwalten"** (im Root-Verzeichnis - auf eine vernünftige alphabetische Sortierung achten).
 {{:administration:pasted:20221207-104248.png}}
-  * Anlegen eines **neuen Folders** mit "Contains plugin: Direct Mail" im Folder "Newsletters". Im TSconfig-Feld wird die **entsprechende Benutzergruppe** gesetzt: ''TCEMAIN.permissions.groupid=149''. Im Reiter "Zugriff" zudem die Newsletter-Sprache auswählen (ist relevant für die persönliche Anrede und den Abmelde-Link). Das Headerbild kann von der Uni unter dem Reiter Ressourcen ergänzt/geändert werden.
+  * Anlegen eines **neuen Folders** mit "Contains plugin: Direct Mail" im Folder "Newsletters". Im TSconfig-Feld wird die **entsprechende Benutzergruppe** gesetzt: ''TCEMAIN.permissions.groupid=149''. Im Reiter "Verhalten" zudem die Newsletter-Sprache auswählen (ist relevant für die persönliche Anrede und den Abmelde-Link). Das Headerbild kann von der Uni unter dem Reiter Ressourcen ergänzt/geändert werden.
   * Gibt es für den Newsletter ein **Archiv**, so muss in der Page TSConfig des Direct Mail-Folders für den Newsletter noch die Konfiguration hinterlegt werden, dass bei jeder Änderung an einem Newsletter der Cache des Archivs gelöscht wird: ''TCEMAIN.clearCacheCmd = 5514''
   * Falls es sich um einen internen (zugriffsgeschützen) Newsletter handelt, muss die Seite kurzfristig auf eine normale Seite geändert werden, damit die entsprechende **Benutzergruppe** ausgewählt werden kann. Zudem muss die Option "Extend to Subpages" aktiviert sein, damit die Berechtigungen auch für alle Unterseiten gelten.
+{{:administration:pasted:20230126-164712.png}}
   * Im Newsletter-Ordner wird nun ein **Ordner** (Contains Plugin: Website User) **für die Benutzer** angelegt. Das Vorgehen für den regelmässigen Import interner Benutzer (intern = User die keinen Abmeldelink haben sollen) über einen XML-Export ist weiter unten beschrieben.
-  * Sollen (ausschliesslich oder unter anderem) **externe Benutzer** den Newsletter abonnieren können, muss für diese ein separater Ordner (Contains Plugin: Website User) angelegt werden. In diesem Ordner wird im Reiter "**Zugriff**" (//Access//) die Checkbox "**Newsletter-Abmeldung erlaubt**" (//Newsletter subscription cancellation allowed//) gesetzt, falls Benutzer einen Abmelde-Link mit dem Newsletter erhalten sollen.
+  * Sollen (ausschliesslich oder unter anderem) **externe Benutzer** den Newsletter abonnieren können, muss für diese ein separater Ordner (Contains Plugin: Website User) angelegt werden. In diesem Ordner wird im Reiter "**Verhalten**" (//Access//) die Checkbox "**Newsletter-Abmeldung erlaubt**" (//Newsletter subscription cancellation allowed//) gesetzt, falls Benutzer einen Abmelde-Link mit dem Newsletter erhalten sollen. Entsprechend den Vorschriften des UWG (Bundesgesetz gegen den unlauteren Wettbewerb) ist man auf der sicheren Seite, wenn man die Option des **Abmeldelinks standardmässig eingeschaltet** hat.
   * Nun sollte ein **Newsletter als Vorlage** angelegt werden, ev. zusammen mit einigen Inhaltselementen.
-  * Eine bestehende **Newsletter-Konfiguration** aus dem Ordner ''EXT:/packages/userunilutemplate/Configuration/TypoScript/Extension/Userunilunewsletterrendering/Newsletters/'' und anpassen. Die neuen Dateien in Git einchecken. Das TypoScript-File wird nun im Newsletter-Ordner im TypoScript-Setup eines **neuen TypoScript Templates (+NL <Name>)** referenziert. Das Headerbild wird auf dem Live-System in den Ordner ''fileadmin/newsletters/headerbilder'' hochgeladen und in den Seiteneigenschaften (Tab Ressourcen) des Newsletter-Ordners referenziert.
+  * Eine bestehende **Newsletter-Konfiguration** aus dem Ordner ''EXT:/packages/userunilutemplate/Configuration/TypoScript/Extension/Userunilunewsletterrendering/Newsletters/'' kopieren und anpassen. Die neuen Dateien in Git einchecken. Das TypoScript-File wird nun im Newsletter-Ordner im TypoScript-Setup eines **neuen TypoScript Templates (+NL <Name>)** referenziert. Das Headerbild wird auf dem Live-System in den Ordner ''fileadmin/newsletters/headerbilder'' hochgeladen und in den Seiteneigenschaften (Tab Ressourcen) des Newsletter-Ordners referenziert.
   * Die **Berechtigungen** gemäss untenstehendem Eintrag setzen. Die Zuteilung der entsprechenden Newsletter-Gruppe zum Benutzer wird durch die Unilu vorgenommen.
   * Je nach Abmachung mit der Unilu werden ev. noch *Empfängerlisten* eingerichtet.
@@ Zeile 78: / Zeile 81: @@
 Interne Benutzer können über einen Scheduler Job/Command Controller importiert werden.
-{{:administration:muster-xml-import-scheduler.png?|}}
+{{:administration:muster-xml-import-scheduler-v2.png?|}}
 Dafür muss von der Uni eine Datei mit folgender Spezifikation auf dem Webserver hinterlegt werden (üblicherweise im Ordner ''/home/www-data/externaldata/'') stehen:
@@ Zeile 103: / Zeile 106: @@
 	</Adressat>
 </All>
+</code>
+Um zu verifizieren, dass sich die Datei dort befindet, kann man sich via SSH mit dem Server verbinden:
+<code>
+ssh www-data@visol-unilu01.nine.ch
+ll externaldata
 </code>
@@ Zeile 117: / Zeile 127: @@
 === Zielordner und zutreffende Standardwerte setzen: ===
+Der Zielordner muss aktiv sein und in den **Seiteneigenschaften** unter "**Verhalten**" > "**Enthält Plugin-IN**" > "**Website-Benutzer**" gewählt haben.
 {{:administration:benutzer-import-01.png|}}
@@ Zeile 135: / Zeile 147: @@
 ==== Antwortadresse ====
-in htdocs/typo3conf/ext/userunilutemplate/Resources/Private/TSConfig/PageTSConfig/newsletters.ts können die Antwortadressen pro Newsletter (sysfolder uid) bei Bedarf überschrieben werden.
+in packages/userunilutemplate/Configuration/TSConfig/PageTSConfig/newsletters.tsconfig können die Antwortadressen pro Newsletter (sysfolder uid) bei Bedarf überschrieben werden.
 <code>
-[PIDinRootline = 5738]
+[5738 in tree.rootLineIds]
-  mod.web_modules.dmail.replyto_email=info@kolt-unilu.ch
+  mod.web_modules.dmail.replyto_email = info@kolt-unilu.ch
 [global]
 </code>
@@ Zeile 146: / Zeile 158: @@
 {{:administration:picture580-2.png?600|}}
+==== Scheduler/Planer > Cronjob ====
+Der Scheduler-Task, der den Versand durchführt ist im Backend "deaktiviert". Das ist so in Ordnung. Ausgelöst wird die Durchführung durch `cron`
+{{:administration:unilu-stopped-directmail-cronjob.png|}}
+<code>
+www-unilu@visol-unilu01:~$ crontab -e
+# Direct Mail
+>* * * * * command="/bin/bash -c \"php7.4 ~/releases/current/vendor/bin/typo3cms scheduler:run --task 18 --force\"" flock=~/tmp/scheduler-run-direct-mail.cron.lock monitorUrl="https://push.statuscake.com/?PK=31ca040c7c41ac2&TestID=6351373&time=\%s" ~/releases/current/lockLogMonitorCommand.sh >> ~/releases/current/logs/cronjobs/scheduler-run-direct-mail.log
+</code>