From aad5436f5bc52e8dae03b57cf7cd0ae8ef80480e Mon Sep 17 00:00:00 2001 From: FloJuh <122517567+FloJuh@users.noreply.github.com> Date: Wed, 2 Apr 2025 14:52:58 +0200 Subject: [PATCH 1/7] docs: improve Wolke calendar instructions --- mkdocs/docs/events.md | 36 ++++++++++++++++++++++-------------- 1 file changed, 22 insertions(+), 14 deletions(-) diff --git a/mkdocs/docs/events.md b/mkdocs/docs/events.md index c6d1b304..e9b047a9 100644 --- a/mkdocs/docs/events.md +++ b/mkdocs/docs/events.md @@ -27,20 +27,21 @@ Wenn die Seite nicht gefunden wird, musst Du die die Permalink-Struktur neu einl Das kannst Du direkt in den Sunflower-Einstellungen machen unter Einstellungen -> Permalinks. Alternativ kannst Du folgendes probieren: + - Einstellungen Permalinks - Wähle eine beliebige andere Einstellung aus und speichere sie - Wähle Deine bisherige Einstellung wieder aus und speichere sie - Fertig. Jetzt muss der Link im Menü funktionieren -## Termine über ical importieren +## Termine über iCal importieren *Sunflower* kann Termine aus mehreren externen Kalendern per iCal-URL importieren. -Bitte trage diese iCal-URLs in den Sunflower-Einstellungen ein. Die Termine werden regelmäßig automatisch aktualisiert. Solche Termine darfst Du nicht mehr im WordPress-Backend bearbeiten, weil Änderungen wieder überschrieben würden. +Bitte trage diese iCal-URLs in den Sunflower-Einstellungen unter `Sunflower > Termine > URLs der iCal-Kalender` ein. Die Termine werden regelmäßig automatisch aktualisiert. Solche Termine darfst Du nicht mehr im WordPress-Backend bearbeiten, weil Änderungen wieder überschrieben würden. Du kannst das Importieren von Termine auch gewollt auslösen (zusätzlich zum automatischen Import alle paar Stunden), indem Du in den Sunflower-Einstellungen auf *Kalender importieren* klickst. -Importiert werden +Importiert werden: - Titel - Beschreibung @@ -49,22 +50,29 @@ Importiert werden - Ort (dazu holt sich *Sunflower* selbstständig Geodaten, siehe unten)# - Auf Wunsch bekommen Termine eines Kalenders eine automatische Kategorie in WordPress zugewiesen. Trage dazu in den Einstellungen nach der KalenderURL einen Strichpunkt ; ein und dann den beliebigen Namen der automatisch zugewiesenenen Kategorie. -### Externe Kalender (z.B. Wolke) importieren - -Du kannst jeden Kalender importieren, der eine öffentliche URL im iCal-Format anbietet. In der grünen Wolke gibt es auch einen Service für grüne Mitglieder und Gliederungen. Unter -[wolke.netzbegruenung.de -> Kalender](https://wolke.netzbegruenung.de/apps/calendar/dayGridMonth/now) -findest Du Deine eigenen Kalender. Dort kanst Du mehrere Kalender anlegen, z.B. einen nur für die Webseite. +### Wolke-Kalender erstellen und importieren -Klicke auf +In der grünen Wolke gibt es auch einen Service für grüne Mitglieder und Gliederungen. Unter [wolke.netzbegruenung.de -> Kalender](https://wolke.netzbegruenung.de/apps/calendar/dayGridMonth/now) findest Du Deine eigenen Kalender. Dort kanst Du mehrere Kalender anlegen, zum Beispiel einen nur für die Webseite. -1. *+ Neuer Kalender* und vergebe einen beliebigen Namen -2. Neben dem Kalendername gibt es ein Kettensymbol, damit öffnet sich ein kleine Menü -3. hierin gibt es ein Untermenü, dass Du mit den drei Punkten öffnen kannst -4. anschließend klickst Du auf *Abonnement-Link kopieren* -5. diesen trägst Du in den *Sunflower-Einstellungen* ein +1. Klicke auf *+ Neuer Kalender* und vergebe einen beliebigen Namen, zum Beispiel "GRÜNE TERMINE (OV)". +2. Fahre mit der Maus über den Kalendernamen. Es erscheint ein Stift-Symbol. Klicke darauf, um das Bearbeitungsmenü zu öffnen. +3. Öffne das Untermenü *Link teilen*, indem Du rechts zuerst auf das Plus-Symbol und dann auf die drei Punkte klickst. +4. Klicke anschließend auf *Abonnement-Link kopieren*. +5. Füge diesen Link in den Sunflower-Einstellungen unter `Sunflower > Termine > URLs der iCal-Kalender` ein. Eine bebilderte Anleitung findest du auch [hier](https://gcms-intern.de/anleitungen/single/termine-anlegen#c892817). +!!! Note "Nachhaltige Kalenderverwaltung" + Damit der Kalender langfristig zuverlässig genutzt werden kann, sollte ihn eine Person verwalten, die Deiner Gliederung dauerhaft erhalten bleibt, wie zum Beispiel Dein\*e Kreisgeschäftsfüher\*in. + +Wenn Du möchtest, dass die anderen Mitglieder Eurer Gliederung den Kalender in der Wolke sehen können, kannst du eine zusätzliche Einstellung vornehmen. Dafür benötigst Du die Rolle `Wolke-Redakteur*in` für Deine Gliederung in der Mitgliederverwaltung Sherpa. Falls Du diese nicht hast, wende Dich an eine Person mit Sherpa-Zugang innerhalb Deiner Gliederung. + +1. Öffne das Bearbeitungsmenü des Wolke-Kalenders und gehe zur Zeile *Mit Benutzern oder Gruppen teilen*. +2. Gib dort den Gliederungsschlüssel ein. Dieser steht beispielsweise vor deinem Gliederungsordner in der [Wolke](https://wolke.netzbegruenung.de), zum Beispiel: + - `101009_Esslingen` (Kreisverband) + - `10100903_Esslingen` (Ortsverband) +3. Wichtig: Das Häkchen bei "kann bearbeiten" sollte nicht gesetzt werden. + ### Import-Häufigkeit festlegen Standardmäßig holt sich *Sunflower* alle drei Stunden neue Daten vom externen Kalender. Um diese Zeit zu ändern, kannst Du in der wp-config.php folgendes eintragen: From 58b6fe34dc66a7fa1c8d02b328e2d2871e9bac5d Mon Sep 17 00:00:00 2001 From: FloJuh <122517567+FloJuh@users.noreply.github.com> Date: Wed, 2 Apr 2025 14:59:38 +0200 Subject: [PATCH 2/7] Fix typo in events.md --- mkdocs/docs/events.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/mkdocs/docs/events.md b/mkdocs/docs/events.md index e9b047a9..39a80592 100644 --- a/mkdocs/docs/events.md +++ b/mkdocs/docs/events.md @@ -24,7 +24,7 @@ Wenn Du keine "Termine" siehst, klicke rechts oben auf das Zahnrad und blende Te ### Die Terminseite wird im Frontend nicht gefunden Wenn die Seite nicht gefunden wird, musst Du die die Permalink-Struktur neu einlesen. -Das kannst Du direkt in den Sunflower-Einstellungen machen unter Einstellungen -> Permalinks. +Das kannst Du direkt in den Sunflower-Einstellungen machen unter `Sunflower > Einstellungen > Permalinks`. Alternativ kannst Du folgendes probieren: @@ -47,7 +47,7 @@ Importiert werden: - Beschreibung - Start- und Enddatum - Kategorien (technisch sind das WordPress-Schlagwörter) -- Ort (dazu holt sich *Sunflower* selbstständig Geodaten, siehe unten)# +- Ort (dazu holt sich *Sunflower* selbstständig Geodaten, siehe unten) - Auf Wunsch bekommen Termine eines Kalenders eine automatische Kategorie in WordPress zugewiesen. Trage dazu in den Einstellungen nach der KalenderURL einen Strichpunkt ; ein und dann den beliebigen Namen der automatisch zugewiesenenen Kategorie. ### Wolke-Kalender erstellen und importieren @@ -106,7 +106,7 @@ Die Information zum Veranstaltungsort werden über [Nominatim](https://nominatim Wird ein Ort mit Straße und Ort beschrieben ist die Genauigkeit sehr hoch. Ein allgemeiner Begriff, wie z.B. "Geschäftsstelle" führt zu einem zufälligen Ergebnis. -Fehlerhafte Geodaten können in den Sunflower-Einstellungen unter `Termine -> Korrektur der Marker auf Landkarten von importierten Terminen` korrigiert werden. Sie werden bei allen zukünftigen Import-Läufen mit der selben Ortsbezeichnung wirksam. +Fehlerhafte Geodaten können in den Sunflower-Einstellungen unter `Sunflower > Termine > Korrektur der Marker auf Landkarten von importierten Terminen` korrigiert werden. Sie werden bei allen zukünftigen Import-Läufen mit der selben Ortsbezeichnung wirksam. ### Zoom-Level für importierte Termine festlegen Importierte Termine haben standardmäßig das Zoom-Level 12. Wenn Du davon abweichen möchtest, trage in der *wp-config.php* bitte die Zeile From 6abebf51a678317b4c314b714752b8e3aedbd6a0 Mon Sep 17 00:00:00 2001 From: FloJuh <122517567+FloJuh@users.noreply.github.com> Date: Wed, 2 Apr 2025 15:00:32 +0200 Subject: [PATCH 3/7] Fix typo in plugins.md --- mkdocs/docs/plugins.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/mkdocs/docs/plugins.md b/mkdocs/docs/plugins.md index 8543582f..71015dd3 100644 --- a/mkdocs/docs/plugins.md +++ b/mkdocs/docs/plugins.md @@ -4,7 +4,7 @@ Es gibt eine unübersehbare Menge an [WordPress Plugins](https://de.wordpress.or ## ActivityPub - Fediverse ohne Aufwand -Mit dem Plugin [Activitypub](https://de.wordpress.org/plugins/activitypub/) wird deine Webseite Teil des Fediverse. Über Mastodon kann man folgen, Beiträge favorisieren und teilen. +Mit dem Plugin [Activitypub](https://de.wordpress.org/plugins/activitypub/) wird Deine Webseite Teil des Fediverse. Über Mastodon kann man folgen, Beiträge favorisieren und teilen. Das Plugin muss einmalig unter `Einstellungen -> ActivityPub` konfiguriert werden. Danach brauchst Du Dich nicht mehr drum zu kümmern. @@ -22,7 +22,7 @@ Das Plugin [Embed Privacy](https://de.wordpress.org/plugins/embed-privacy/) verh Es ist nichts weiter zu machen, als das Plugin zu installieren. !!! Note "Twingle-Spendenformular mit Embed Privacy nutzen" - Wenn du das Embed des [twingle-Spendenformulars](donationform.md) einstellen oder deaktivieren möchtest, kannst du unter `Einstellungen > Embed Privacy > Embeds verwalten > Neuen Beitrag erstellen` twingle als Embed hinzufügen. Verwende dazu das Regex-Muster `/twingle\.de/`. + Wenn du das Embed des [twingle-Spendenformulars](donationform.md) einstellen oder deaktivieren möchtest, kannst Du unter `Einstellungen > Embed Privacy > Embeds verwalten > Neuen Beitrag erstellen` twingle als Embed hinzufügen. Verwende dazu das Regex-Muster `/twingle\.de/`. Da twingle keine Cookies setzt, kann das Overlay von Embed Privacy für diesen Embed-Anbieter deaktiviert werden. From 3fdb4a09ba71df4fb8be514a12c5a906f24cb29f Mon Sep 17 00:00:00 2001 From: FloJuh <122517567+FloJuh@users.noreply.github.com> Date: Wed, 2 Apr 2025 15:11:07 +0200 Subject: [PATCH 4/7] fix typo in events.md --- mkdocs/docs/events.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/mkdocs/docs/events.md b/mkdocs/docs/events.md index 39a80592..9df57e4c 100644 --- a/mkdocs/docs/events.md +++ b/mkdocs/docs/events.md @@ -1,6 +1,7 @@ # Veranstaltungen / Termine ## Termin manuell anlegen + Termine sind ein eigener Inhaltstyp, ähnlich wie Beiträge und Seiten. Du findest sie im Backend-Menü als extra Menüpunkt *Termine*. Dort kannst Du auf *Erstellen* klicken. Ein Termin besteht aus einer normalen Überschrift und normalem Inhalt, genauso wie Seiten und Beiträge. Zusätzlich gibt es in der Seitenleiste den Bereich *Termin*. Hier kannst Du folgendes einstellen: @@ -12,6 +13,7 @@ Ein Termin besteht aus einer normalen Überschrift und normalem Inhalt, genauso Außerdem kannst Du eine Markierung auf einer Landkarte [OpenStreetMap](https://www.openstreetmap.de/) setzen. Diese Landkarte wird nach einem Opt-In-Klick durch der\*die Besucher\*innen im Frontend angezeigt. ## Übersichtsseite im Menü einfügen + - Design > Menüs - Termine > alle anzeigen - Den obersten Eintrag zum Menü hinzufügen @@ -19,10 +21,12 @@ Außerdem kannst Du eine Markierung auf einer Landkarte [OpenStreetMap](https:// Wenn Du keine "Termine" siehst, klicke rechts oben auf das Zahnrad und blende Termine ein. ### In der Menüansicht werden keine Termine angezeigt + - Klicke auf *Ansicht anpassen* und - setze den Haken bei Termine ### Die Terminseite wird im Frontend nicht gefunden + Wenn die Seite nicht gefunden wird, musst Du die die Permalink-Struktur neu einlesen. Das kannst Du direkt in den Sunflower-Einstellungen machen unter `Sunflower > Einstellungen > Permalinks`. @@ -65,7 +69,7 @@ Eine bebilderte Anleitung findest du auch [hier](https://gcms-intern.de/anleitun !!! Note "Nachhaltige Kalenderverwaltung" Damit der Kalender langfristig zuverlässig genutzt werden kann, sollte ihn eine Person verwalten, die Deiner Gliederung dauerhaft erhalten bleibt, wie zum Beispiel Dein\*e Kreisgeschäftsfüher\*in. -Wenn Du möchtest, dass die anderen Mitglieder Eurer Gliederung den Kalender in der Wolke sehen können, kannst du eine zusätzliche Einstellung vornehmen. Dafür benötigst Du die Rolle `Wolke-Redakteur*in` für Deine Gliederung in der Mitgliederverwaltung Sherpa. Falls Du diese nicht hast, wende Dich an eine Person mit Sherpa-Zugang innerhalb Deiner Gliederung. +Wenn Du möchtest, dass die anderen Mitglieder Deiner Gliederung den Kalender in der Wolke sehen können, kannst Du eine zusätzliche Einstellung vornehmen. Dafür benötigst Du die Rolle `Wolke-Redakteur*in` für Deine Gliederung in der Mitgliederverwaltung Sherpa. Falls Du diese nicht hast, wende Dich an eine Person mit Sherpa-Zugang innerhalb Deiner Gliederung. 1. Öffne das Bearbeitungsmenü des Wolke-Kalenders und gehe zur Zeile *Mit Benutzern oder Gruppen teilen*. 2. Gib dort den Gliederungsschlüssel ein. Dieser steht beispielsweise vor deinem Gliederungsordner in der [Wolke](https://wolke.netzbegruenung.de), zum Beispiel: @@ -81,6 +85,7 @@ Standardmäßig holt sich *Sunflower* alle drei Stunden neue Daten vom externen wobei die 1 hier im Beispiel für jede Stunde steht. ### Anzahl der zu importierenden Termine festlegen + Standardmäßig holt sich *Sunflower* alle Termie der nächsten sechs Monate vom externen Kalender. Um dies zu ändern, kannst Du in der wp-config.php folgendes eintragen: ``define('SUNFLOWER_EVENT_TIME_RANGE', '3 months');`` @@ -96,6 +101,7 @@ Dabei kannst Du bspw. folgendes nutzen - 1 year ### Anzahl der sich wiederholenden Termine beim Import festlegen + Sich wiederholende Termine werden bis längstens in einem Jahr importiert. Du kannst die Höchstzahl der zu importierenden Termine bei sich wiederholenden Terminen so festlegen: ``define('SUNFLOWER_EVENT_RECURRING_EVENTS', 10);`` @@ -109,6 +115,7 @@ Wird ein Ort mit Straße und Ort beschrieben ist die Genauigkeit sehr hoch. Ein Fehlerhafte Geodaten können in den Sunflower-Einstellungen unter `Sunflower > Termine > Korrektur der Marker auf Landkarten von importierten Terminen` korrigiert werden. Sie werden bei allen zukünftigen Import-Läufen mit der selben Ortsbezeichnung wirksam. ### Zoom-Level für importierte Termine festlegen + Importierte Termine haben standardmäßig das Zoom-Level 12. Wenn Du davon abweichen möchtest, trage in der *wp-config.php* bitte die Zeile ``define('SUNFLOWER_EVENT_IMPORTED_ZOOM', 10);`` From 7c606beb2e46b477b8d0a9b3c98209cc02c05449 Mon Sep 17 00:00:00 2001 From: FloJuh <122517567+FloJuh@users.noreply.github.com> Date: Wed, 11 Jun 2025 15:01:07 +0200 Subject: [PATCH 5/7] Fix typo Gender-Star --- mkdocs/docs/events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs/docs/events.md b/mkdocs/docs/events.md index 9df57e4c..7e096c14 100644 --- a/mkdocs/docs/events.md +++ b/mkdocs/docs/events.md @@ -69,7 +69,7 @@ Eine bebilderte Anleitung findest du auch [hier](https://gcms-intern.de/anleitun !!! Note "Nachhaltige Kalenderverwaltung" Damit der Kalender langfristig zuverlässig genutzt werden kann, sollte ihn eine Person verwalten, die Deiner Gliederung dauerhaft erhalten bleibt, wie zum Beispiel Dein\*e Kreisgeschäftsfüher\*in. -Wenn Du möchtest, dass die anderen Mitglieder Deiner Gliederung den Kalender in der Wolke sehen können, kannst Du eine zusätzliche Einstellung vornehmen. Dafür benötigst Du die Rolle `Wolke-Redakteur*in` für Deine Gliederung in der Mitgliederverwaltung Sherpa. Falls Du diese nicht hast, wende Dich an eine Person mit Sherpa-Zugang innerhalb Deiner Gliederung. +Wenn Du möchtest, dass die anderen Mitglieder Deiner Gliederung den Kalender in der Wolke sehen können, kannst Du eine zusätzliche Einstellung vornehmen. Dafür benötigst Du die Rolle `Wolke-Redakteur\*in` für Deine Gliederung in der Mitgliederverwaltung Sherpa. Falls Du diese nicht hast, wende Dich an eine Person mit Sherpa-Zugang innerhalb Deiner Gliederung. 1. Öffne das Bearbeitungsmenü des Wolke-Kalenders und gehe zur Zeile *Mit Benutzern oder Gruppen teilen*. 2. Gib dort den Gliederungsschlüssel ein. Dieser steht beispielsweise vor deinem Gliederungsordner in der [Wolke](https://wolke.netzbegruenung.de), zum Beispiel: From 4b348d58fc357e0f89652bb97881a49f997e674d Mon Sep 17 00:00:00 2001 From: FloJuh <122517567+FloJuh@users.noreply.github.com> Date: Sat, 9 Aug 2025 12:59:23 +0200 Subject: [PATCH 6/7] Add info for iCal-Calendar, Remover Wolke-Instructions --- mkdocs/docs/events.md | 13 +------------ 1 file changed, 1 insertion(+), 12 deletions(-) diff --git a/mkdocs/docs/events.md b/mkdocs/docs/events.md index 8370cf57..02a97adb 100644 --- a/mkdocs/docs/events.md +++ b/mkdocs/docs/events.md @@ -39,7 +39,7 @@ Alternativ kannst Du folgendes probieren: ## Termine über iCal importieren -*Sunflower* kann Termine aus mehreren externen Kalendern per iCal-URL (zB Grüne Kalender aus der Wolke, siehe unten) importieren. +*Sunflower* kann Termine aus mehreren externen Kalendern per iCal-URL (zB Grüne Kalender aus der Wolke, siehe unten) importieren. Du kannst jeden Kalender importieren, der eine öffentliche URL im iCal-Format anbietet. Bitte trage diese iCal-URLs in den Sunflower-Einstellungen unter `Sunflower > Termine > URLs der iCal-Kalender` ein. Die Termine werden regelmäßig automatisch synchronisiert/aktualisiert. Solche Termine solltest Du nicht mehr im WordPress-Backend bearbeiten, weil Änderungen wieder überschrieben würden. @@ -66,17 +66,6 @@ In der grünen Wolke gibt es auch einen Service für grüne Mitglieder und Glied Eine bebilderte Anleitung findest du auch [hier](https://gcms-intern.de/anleitungen/single/termine-anlegen#c892817). -!!! Note "Nachhaltige Kalenderverwaltung" - Damit der Kalender langfristig zuverlässig genutzt werden kann, sollte ihn eine Person verwalten, die Deiner Gliederung dauerhaft erhalten bleibt, wie zum Beispiel Dein\*e Kreisgeschäftsfüher\*in. - -Wenn Du möchtest, dass die anderen Mitglieder Deiner Gliederung den Kalender in der Wolke sehen können, kannst Du eine zusätzliche Einstellung vornehmen. Dafür benötigst Du die Rolle `Wolke-Redakteur\*in` für Deine Gliederung in der Mitgliederverwaltung Sherpa. Falls Du diese nicht hast, wende Dich an eine Person mit Sherpa-Zugang innerhalb Deiner Gliederung. - -1. Öffne das Bearbeitungsmenü des Wolke-Kalenders und gehe zur Zeile *Mit Benutzern oder Gruppen teilen*. -2. Gib dort den Gliederungsschlüssel ein. Dieser steht beispielsweise vor deinem Gliederungsordner in der [Wolke](https://wolke.netzbegruenung.de), zum Beispiel: - - `101009_Esslingen` (Kreisverband) - - `10100903_Esslingen` (Ortsverband) -3. Wichtig: Das Häkchen bei "kann bearbeiten" sollte nicht gesetzt werden. - ### Import-Häufigkeit festlegen Standardmäßig holt sich *Sunflower* alle drei Stunden neue Daten vom externen Kalender. Um diese Zeit zu ändern, kannst Du in der wp-config.php folgendes eintragen: From e6dac740fadae1286a2d7d2c4a88f8fcd98d0944 Mon Sep 17 00:00:00 2001 From: FloJuh <122517567+FloJuh@users.noreply.github.com> Date: Mon, 18 Aug 2025 12:41:00 +0300 Subject: [PATCH 7/7] Fix commit 6affaaa --- mkdocs/docs/plugins.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/mkdocs/docs/plugins.md b/mkdocs/docs/plugins.md index d4c16c88..25c3e44c 100644 --- a/mkdocs/docs/plugins.md +++ b/mkdocs/docs/plugins.md @@ -22,10 +22,8 @@ Das Plugin [Embed Privacy](https://de.wordpress.org/plugins/embed-privacy/) verh Es ist nichts weiter zu machen, als das Plugin zu installieren. !!! Note "Twingle-Spendenformular mit Embed Privacy nutzen" - Wenn du das Embed des [twingle-Spendenformulars](donationform.md) einstellen oder deaktivieren möchtest, kannst du unter `Einstellungen > Embed Privacy > Embeds verwalten > Neuen Beitrag erstellen` twingle als Embed hinzufügen. Verwende dazu das Regex-Muster `/