Georg-Kloster Calendar Workshop

Beschreibung

Fügt 22 dynamische Gutenberg-Blöcke und Shortcodes hinzu. Kalender- und Bibeldaten stammen aus den unten aufgeführten externen Diensten; das Plugin enthält keine Kalenderdatenbank.

Quellcode und Entwicklung

Öffentliches Quellcode-Repository: https://github.com/VAtapin/wp_orthodox_calendar
JavaScript- und CSS-Quellen: https://github.com/VAtapin/wp_orthodox_calendar/tree/main/assets

Die Dateien assets/admin.js, assets/calendar.js, assets/editor.js, assets/admin.css und assets/calendar.css sind die originalen, lesbaren Quellen und im ZIP enthalten. WordPress verwendet sie direkt. Es gibt keine Transpilierung, Bündelung, Minifizierung, generierten JavaScript-/CSS-Dateien oder versteckten separaten Quellbaum. Die Skripte verwenden die von WordPress bereitgestellten Gutenberg-Bibliotheken statt mitgelieferter Kopien.

Bearbeite diese Quelldateien direkt. Für die Installation und Entwicklung des Plugins ist kein npm-Build erforderlich. Prüfe die JavaScript-Syntax mit node –check assets/admin.js, node –check assets/calendar.js und node –check assets/editor.js. PHP-Dateien kannst du mit php -l prüfen. Optionale Formatierung: npx prettier@3.6.2 –write assets/.js assets/.css. Das Repository enthält scripts/build-language-files.mjs zum erneuten Erstellen von MO-Katalogen mit Node.js. Die Anleitung zur Zusammenstellung von Veröffentlichungspaketen steht in der README.md des öffentlichen Repositorys.

Shortcodes

[orthocal_today]
[orthocal_upcoming limit=“5″ filter=“main“]
[orthocal_month year=“2027″ month=“5″]
[orthocal_year year=“2027″]
[orthocal_day date=“2027-05-02″]
[orthocal_readings date=“2027-05-02″]
[orthocal_calendar open=“modal“]
[orthocal_fasting]
[orthocal_saints]
[orthocal_feasts limit=“5″]
[orthocal_memorial]
[orthocal_pascha year=“2027″]
[orthocal_fasts year=“2027″]
[orthocal_date]
[orthocal_texts]
[orthocal_troparia scope=“resurrection“ tone=“1″]
[orthocal_kontakia scope=“weekday“ weekday=“1″]
[orthocal_prayers]
[orthocal_magnifications]
[orthocal_horologion]

open=“inline|modal|page“ steuert das Öffnen eines Tages; reading_open=“inline|modal“ das Öffnen von Lesungen. Für eine eigene Seite platziere dort [orthocal_day] und wähle die Seite in den Einstellungen. sections=“fasting,saints,readings,texts,icons“, images=“0|1″ und heading=“0|1″ steuern den Inhalt. Der Generator im Administrationsbereich zeigt Parameter und Ausgabe an.
image_size=“120″ legt die Höhe eines Fastenbildes in Pixeln fest; die Breite behält das Seitenverhältnis bei. Bestehende Shortcodes mit small, medium und large verwenden weiterhin Höhen von 28, 44 und 72 Pixeln.
Das Nachschlagewerk enthält einen Anfangsbestand von 98 kirchenslawischen Texten mit Quellen. Die liturgische redaktionelle Prüfung steht noch aus. Es ordnet Texte nicht automatisch dem täglichen Gottesdienst zu. Akathiste sind in BibleDesktop geplant und noch nicht angebunden.

Allgemeine Parameter: lang=“ru|cu|de|uk|pl“, profile=“typikon-strict|parish“, theme=“book|modern|inherit“, compact=“0|1″ und oldstyle=“0|1″. Das Horologion verwendet eine geschützte Gottesdienstroute und enthält Einschübe der sechsten Stunde. Ein leeres Datum bedeutet das aktuelle Datum in der WordPress-Zeitzone. Unterstützte Jahre: 1900–2200.
Filter für bevorstehende Ereignisse: main (Haupt- und Totengedenktage), twelve (Pascha und die zwölf großen Feste), great (große Feste), memorial (Totengedenktage) und all (alle). Die Suche umfasst das angegebene Datum und die folgenden 366 Tage und zeigt höchstens zehn Ereignisse.

Externe Dienste

Kalender-API: https://bible-desktop.com/api/v1/calendar/
Zur Berechnung von Daten, Festen, Fasten, Gedenktagen und Lesungsverweisen. Laden eines Blocks, Administrationsvorschau oder Datumswechsel übermitteln Datum/Zeitraum, Sprache, Kalenderprofil sowie Anzeige-/Filterparameter vom WordPress-Server. Öffentliche Anfragen enthalten X-Calendar-Client: orthocal-wordpress. Für die normale öffentliche Nutzung sind weder Registrierung noch Schlüssel erforderlich.
Nutzungsbedingungen: https://bible-desktop.com/pages/api-terms
Datenschutzerklärung: https://bible-desktop.com/pages/api-privacy

Bible-Desktop-API: https://bible-desktop.com/api/
Für Bibelübersetzungen, Bücher, Kapitel, liturgische Bibliotheken, Heiligenviten sowie Ikonenkataloge und Bilder. Beim Öffnen von Lesungen oder Bibliotheken werden Übersetzung, Buch/Kapitel, Sprache, Werkkennung oder Seiten- und Filterparameter übermittelt. Für Ikonen werden Kalendermonat/-tag oder Material-/Bildkennung gesendet. Bei fehlendem Cache lädt WordPress Bilder und Schriftarten herunter; geplante Cache-Prüfungen senden bedingte HTTP-Header. Bible Desktop berechnet den Kalender lokal. Der bisherige Kalendar-Schlüssel wird niemals an den neuen Anbieter übermittelt.
Nutzungsbedingungen: https://bible-desktop.com/pages/api-terms
Datenschutzerklärung: https://bible-desktop.com/pages/api-privacy

Beide Dienste erhalten die IP-Adresse des anfragenden Servers, Anfragezeit, angeforderte Ressource und technische HTTP-Header. Das Plugin übermittelt keine Besucher-IP-Adressen, Namen, E-Mail-Adressen, WordPress-Passwörter oder Beitragsinhalte. Entfernte Medien werden zwischengespeichert und lokal ausgeliefert. Bei gültigem Cache-Eintrag können Anfragen entfallen. Volltexte, Ikonen und Heiligenviten sind nicht im ZIP enthalten; die jeweiligen Rechte gelten weiterhin.
Die gemeinsame API-Adresse von Bible Desktop kann in den Verbindungseinstellungen geändert werden. Diese Links beschreiben die Standardanbieter; bei Wahl eines anderen Anbieters müssen Administratoren dessen Nutzungsbedingungen und Datenschutzerklärung prüfen und ihren Benutzern bekannt machen.

Cache und Zugriff

Die aktualisierte Kalender-API ist erforderlich: upcoming, view=summary und der Header X-Calendar-Application-Cache-TTL.
Erfolgreiche Kalenderantworten werden nur mit Erlaubnis der API und höchstens 300 Sekunden gespeichert; Zugriffsaufhebung und Datenbankänderungen werden spätestens nach Ablauf dieser Frist berücksichtigt. Nach Fehlern werden keine veralteten Daten verwendet. Antworten ohne erlaubenden Header werden nicht zwischen Anfragen gespeichert.
Bibelantworten werden für die gewählten 0, 1, 6 oder 24 Stunden gespeichert (Standard: 24); no-store verhindert die Speicherung, sofern die API sie nicht gesondert erlaubt. Der Browser fasst gleichzeitige identische Anfragen zusammen.
Lokale Bilder und Schriftarten liegen in uploads/orthocal-cache. Entfernte Fotos werden auf höchstens 1.200 Pixel an der längsten Seite verkleinert und vor dem Speichern auf maximal 100 KB komprimiert. Bedingte ETag/Last-Modified-Prüfungen über WP-Cron erfolgen alle 6, 12, 24 oder 168 Stunden (Standard: 24). Geänderte Dateien erhalten eine neue URL mit Hash; bei Fehlern bleibt die letzte funktionierende Kopie erhalten. Die Grenze beträgt 200 MB; alte Versionen können im Administrationsbereich gelöscht werden. Dateien der Mediathek bleiben unberührt.
Öffentliche REST-Routen sind auf feste Quellen und eine Positivliste von Parametern begrenzt. WordPress-Zähler begrenzen normalen Datenverkehr; konfiguriere zusätzlich eine serverseitige Ratenbegrenzung zum strikten Schutz vor verteilter Ausschöpfung der Kontingente.
Bei vollständigem Seiten-Caching schließe Kalenderseiten aus oder setze eine TTL von höchstens 300 Sekunden und leere den Cache um Mitternacht in der Zeitzone der Website. Andernfalls kann HTML länger bestehen bleiben als die API-Daten.
Das Speichern der Einstellungen leert den Plugin-Cache. Die Deaktivierung erhält die Einstellungen.

Funktionen

22 dynamische Gutenberg-Blöcke und Shortcodes, ein eigenes Plugin-Menü, ein Generator mit Live-Vorschau und Kopieren von Shortcodes, integrierte Hilfe, serverseitig erzeugtes HTML, Datumswechsel ohne Neuladen, modale Dialoge, Suche in den Gedenktagen, Permalinks mit ?orthocal_date=YYYY-MM-DD, unabhängige Blöcke, drei Designs, responsive Layouts, Druckstile und Tastaturbedienung.
Einstellungen, Gutenberg-Blöcke, Tageskarten und der Textleser unterstützen russische, deutsche, ukrainische und polnische Beschriftungen; die Sprache der Kalenderdaten und der Bibel wird getrennt gewählt. Kalenderübersetzungen können unvollständig sein. Die integrierten liturgischen Texte sind kirchenslawisch; deutsche Ausgaben sind über Links verfügbar. Fehlende Daten werden niemals durch andere Ikonenbilder oder Heiligenviten ersetzt.