Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- administration:newsletter [2025/11/27 13:54] – [Einrichtung durch den Betrieb] ameier
+++ administration:newsletter [2025/11/27 14:58] (aktuell) – [Einrichtung durch den Betrieb] ameier
@@ Zeile 19: / Zeile 19: @@
 Die Einrichtung erfolgt direkt im Backend der Live-Umgebung (https://www.unilu.ch/typo3)
-  * Anlegen einer neuen **BE-Benutzergruppe** mit dem Titel "newsletters/[newsletter-name]". Diese Gruppe erbt die Benutzergruppe "! Newsletters: Erstellen und Versenden". Es sind keine weiteren Einstellungen nötig.
+  * **BE-Benutzergruppe** mit dem Titel "newsletters/[newsletter-name]" auf Rootpage [0] anlegen. Die Gruppe muss die "! Newsletters: Erstellen und Versenden" erben. Es sind keine weiteren Einstellungen nötig.
-  * Hinzufügen dieser Gruppe zur Gruppe "! Newsletter: Administrator".
+  * BE-Benutzergruppe in Gruppe "! Newsletter: Administrator" ergänzen.
-  * 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}}
+  * BE-Benutzergruppe zu den erlaubten Gruppen ("Groups which may be assigned through the action") in der **sys_action "Backend-Benutzer verwalten"** hinzufügen (im Root-Verzeichnis - auf eine vernünftige alphabetische Sortierung achten). {{:administration:unilu-48087-sysaction.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 "Verhalten" 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.
+  * **Newsletter Ordner** unterhalb //Newsletters// [5117] anlegen. "Contains plugin: Direct Mail" wählen. Im TSconfig-Feld des neuen Ordner wird die uid der **neuen BE-Benutzergruppe** setzen: ''TCEMAIN.permissions.groupid=149''. Im Reiter "Verhalten" die Newsletter-Sprache auswählen (ist relevant für die persönliche Anrede und den Abmelde-Link). {{:administration:unilu-48087-sysfolder-nl.png|}}
+  * Das Headerbild wird in der Regel von visol erstellt und unter dem Reiter Ressourcen ergänzt/geändert werden. Es kann aber auch von Redaktor*innen 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''
   * **Geschützter Newsletter:** 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. Option "Extend to Subpages" aktivieren, damit die Berechtigung auch für alle Unterseiten gilt. {{:administration:unilu-48087-access.png|}}
-  * **Empfänger Ordner** für ''fe_users'' unterhalb neuem Newsletter-Ordner anlegen. "Contains Plugin: Website User)" wählen. 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.{{:administration:unilu-48087-sysfolder-nl.png|}}
+  * **Empfänger Ordner** für ''fe_users'' unterhalb neuem Newsletter-Ordner anlegen. "Contains Plugin: Website User)" wählen. 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.
-  * **Anmeldeformular/Abmeldelink** 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. Um im Newsletter einen personalisierten Abmeldelink zu rendern, muss unter dem Reiter "Verhalten" die Checkbox "**Newsletter-Abmeldung erlaubt**" (''unsubscribe_allowed'') aktiviert werden. {{:administration:unilu-48087-feuser-folder-an-abmelden.png|}} Es braucht dafür auch eine //dedizierte Anmeldeseite//, die das Inhaltselement mit CType ''newsletterregistration_newsletterregistration'' enthält, sowie ein //**separates TSconfig File**//  (''EXT:userunilutemplate/Configuration/TSConfig/PageTSConfig/Newsletters/<newslettername>.tsconfig''), das die Anmeldeseite per ''tx_userunilunewsletterrendering.registrationPid=N'' referenziert. Das TSconfig File selber muss in den Seiteneigenschaften des Sysfolders importiert werden. {{:administration:unilu-48087-pagets-import.png|}}
+  * **Anmeldeformular/Abmeldelink** 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. Um im Newsletter einen personalisierten Abmeldelink zu rendern, muss unter dem Reiter "Verhalten" die Checkbox "**Newsletter-Abmeldung erlaubt**" (''unsubscribe_allowed'') aktiviert werden. {{:administration:unilu-48087-feuser-folder-an-abmelden.png|}} Es braucht dafür auch eine **dedizierte Anmeldeseite**, die das Inhaltselement mit CType ''newsletterregistration_newsletterregistration'' enthält, sowie ein //**[[administration:newsletter#beispiel_tsconfig|separates TSconfig File]]**//, in dem die uid der Anmeldeseite per ''registrationPid'' referenziert. Das TSconfig File muss in den Seiteneigenschaften des Sysfolders importiert werden. {{:administration:unilu-48087-pagets-import.png|}} Fehlt die Konfiguration, wird beim Versand an die fe_user Liste eine Warnung angezeigt. {{:administration:unilu-48087-alert-registrationpid.png|}}
   * **TypoScript Setup** aus dem Ordner ''EXT:/packages/userunilutemplate/Configuration/TypoScript/Extension/Userunilunewsletterrendering/Newsletters/<newsletter>.typoscript'' kopieren und anpassen. Die neuen Dateien in Git einchecken.
@@ Zeile 34: / Zeile 35: @@
   * Nun sollte ein **Newsletter als Vorlage** angelegt werden, ev. zusammen mit einigen Inhaltselementen.
-  * Das Headerbild wird auf dem Live-System in den Ordner ''fileadmin/newsletters/headerbilder'' hochgeladen und in den Seiteneigenschaften (Tab Ressourcen) des Newsletter-Ordners 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** setzen (siehe [[administration:newsletter#berechtigungen|Berechtigungen]]). 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.
   * **Newsletterspezifische Absenderadressen** werden im bereits erwähnten ''../<newslettername>.tsconfig'' definiert.
-=== Beispiel EXT:userunilutemplate/Configuration/TSConfig/PageTSConfig/Newsletters/<newslettername>.tsconfig ===
+==== Beispiel .tsconfig PageTS ====
+EXT:userunilutemplate/Configuration/TSConfig/PageTSConfig/Newsletters/<newslettername>.tsconfig
   # Newsletter - Infomail from the dean GMF - sysfolder 12818
@@ Zeile 51: / Zeile 54: @@
   mod.web_modules.dmail.replyto_email = gmf@unilu.ch
   mod.web_modules.dmail.simulate_usergroup = 3
+==== Beispiel .typoscript Setup ====
+EXT:userunilutemplate/Configuration/TypoScript/Extension/Userunilunewsletterrendering/Newsletters/<newslettername>.typoscript
+  plugin.tx_userunilunewsletterrendering {
+    settings {
+      headerAltText = Universität Luzern - Department of Health Sciences and Medicine
+      title = Infomail from the dean GMF
+      contactImprintLink = 12808
+      archiveLink = 12808
+    }
+    view {
+      templateRootPaths.1 = EXT:userunilutemplate/Resources/Private/Extensions/Userunilunewsletterrendering/Default/Templates/
+      partialRootPaths.1 = EXT:userunilutemplate/Resources/Private/Extensions/Userunilunewsletterrendering/Default/Partials/
+      layoutRootPaths.1 = EXT:userunilutemplate/Resources/Private/Extensions/Userunilunewsletterrendering/Default/Layouts/
+    }
+  }
+  lib.aside.5.value = Infomail from the dean GMF
+  lib.aside.10.value < plugin.tx_userunilunewsletterrendering.settings.title
 ==== An-/Abmeldeformular & Opt-in Link ====
+Siehe auch [[redaktion:z._newsletter#anmeldung_per_formular_abmelden_per_link_im_newsletter|Newsletter Redaktion]]
 Achtung: Soll das An-/Abmelden per Link oder Formular möglich sein, muss die Konfiguration ergänzt werden.
@@ Zeile 71: / Zeile 97: @@
 Detaillierte Infos zum Setup siehe: ''/userunilutemplate/Configuration/TSConfig/PageTSConfig/Newsletters/README.md''
-Siehe auch [[redaktion:z._newsletter#anmeldung_per_formular_abmelden_per_link_im_newsletter|Newsletter Redaktion]]
 ==== Berechtigungen ====