Georg-Kloster Calendar Workshop

Опис

Додає 22 динамічні блоки Gutenberg і короткі коди. Календарні та біблійні дані надходять із зовнішніх сервісів, перелічених нижче; власної календарної бази даних у плагіні немає.

Вихідний код і розробка

Публічний репозиторій вихідного коду: https://github.com/VAtapin/wp_orthodox_calendar
Вихідні файли JavaScript і CSS: https://github.com/VAtapin/wp_orthodox_calendar/tree/main/assets

Файли assets/admin.js, assets/calendar.js, assets/editor.js, assets/admin.css та assets/calendar.css — оригінальні читабельні вихідні файли, включені до ZIP. WordPress використовує їх безпосередньо. Транспіляції, об’єднання, мініфікації та генерування JavaScript/CSS немає; окремого прихованого дерева вихідного коду немає. Скрипти використовують бібліотеки Gutenberg, надані WordPress, а не власні включені копії.

Редагуйте ці вихідні файли безпосередньо. Для встановлення й розробки плагіна збірка npm не потрібна. Перевіряйте синтаксис JavaScript командами node –check assets/admin.js, node –check assets/calendar.js та node –check assets/editor.js; PHP-файли — командою php -l. Необов’язкове форматування: npx prettier@3.6.2 –write assets/.js assets/.css. Репозиторій містить scripts/build-language-files.mjs для повторного створення каталогів MO за допомогою Node.js. Пакування випусків описано в README.md публічного репозиторію.

Короткі коди

[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” задає спосіб відкриття дня; reading_open=”inline|modal” — спосіб відкриття читань. Для окремої сторінки розмістіть на ній [orthocal_day] і оберіть цю сторінку в налаштуваннях. Параметри sections=”fasting,saints,readings,texts,icons”, images=”0|1″ та heading=”0|1″ керують вмістом. Конструктор в адміністративній панелі показує параметри й результат.
image_size=”120″ задає висоту зображення посту в пікселях; ширина зберігає пропорції вихідного зображення. Чинні короткі коди зі значеннями small, medium і large надалі використовують висоти 28, 44 та 72 пікселі.
Довідкова бібліотека містить початковий корпус із 98 церковнослов’янських текстів із джерелами й очікує богослужбової редакторської перевірки. Вона не призначає текст щоденній службі автоматично. Акафісти заплановано в BibleDesktop і ще не підключено.

Загальні параметри: lang=”ru|cu|de|uk|pl”, profile=”typikon-strict|parish”, theme=”book|modern|inherit”, compact=”0|1″ та oldstyle=”0|1″. Часослов використовує захищений маршрут служб і містить вставки шостого часу. Порожня дата означає поточну дату в часовому поясі WordPress. Підтримуються роки 1900–2200.
Фільтри найближчих подій: main (головні та поминальні), twelve (Пасха й дванадесяті свята), great (великі), memorial (поминальні) і all (усі). Пошук охоплює вказану дату та наступні 366 днів; виводиться не більш ніж 10 подій.

Зовнішні сервіси

Календарний API: https://bible-desktop.com/api/v1/calendar/
Використовується для обчислення дат, свят, постів, пам’ятей і посилань на читання. Завантаження блока, його попередній перегляд в адміністративній панелі або зміна дати передають із сервера WordPress дату/період, мову, календарний профіль і параметри відображення/фільтрації. Публічні запити містять X-Calendar-Client: orthocal-wordpress. Для звичайного публічного використання реєстрація та ключ не потрібні.
Умови використання: https://bible-desktop.com/pages/api-terms
Політика конфіденційності: https://bible-desktop.com/pages/api-privacy

API Bible Desktop: https://bible-desktop.com/api/
Використовується для перекладів Біблії, книг, розділів, богослужбових бібліотек, житій і каталогів/зображень ікон. Відкриття читань або бібліотеки передає обраний переклад, книгу/розділ, мову, ідентифікатор твору або параметри сторінок і фільтрів. Для ікон передається календарний місяць/день або ідентифікатор матеріалу/зображення. За відсутності даних у кеші WordPress завантажує зображення й шрифти; запланована перевірка кешу передає умовні HTTP-заголовки. Bible Desktop обчислює календар локально. Попередній ключ Kalendar ніколи не передається новому постачальнику.
Умови використання: https://bible-desktop.com/pages/api-terms
Політика конфіденційності: https://bible-desktop.com/pages/api-privacy

Обидва сервіси отримують IP-адресу сервера, що надсилає запит, час запиту, запитаний ресурс і технічні HTTP-заголовки. Плагін не передає IP-адреси відвідувачів, імена, адреси електронної пошти, паролі WordPress або вміст записів. Віддалені медіафайли кешуються й надаються локально. За наявності чинного запису кешу запити можуть не виконуватися. Повні тексти, ікони та житія не включено до ZIP; відповідні права на матеріали зберігають чинність.
Єдину адресу API Bible Desktop можна змінити в налаштуваннях підключення. Ці посилання описують типових постачальників; адміністратори, які обирають іншого постачальника, мають вивчити його умови використання та політику конфіденційності й повідомити про них користувачам.

Кеш і доступ

Потрібний оновлений календарний API: upcoming, view=summary і заголовок X-Calendar-Application-Cache-TTL.
Успішні календарні відповіді зберігаються лише з дозволу API й не довше ніж 300 секунд; відкликання доступу та зміни бази даних враховуються не пізніше завершення цього строку. Після помилок застарілі дані не використовуються. Відповіді без дозвільного заголовка не зберігаються між запитами.
Біблійні відповіді зберігаються протягом обраних 0, 1, 6 або 24 годин (типово — 24); no-store забороняє зберігання, якщо API окремо його не дозволив. Браузер об’єднує одночасні однакові запити.
Локальні зображення й шрифти зберігаються в uploads/orthocal-cache. Віддалені фотографії зменшуються до 1200 пікселів за довшою стороною та стискаються до розміру не більш ніж 100 КБ перед збереженням. Умовні перевірки ETag/Last-Modified через WP-Cron виконуються кожні 6, 12, 24 або 168 годин (типово — 24). Змінений файл отримує нову URL-адресу з хешем; у разі помилки зберігається остання робоча копія. Обмеження — 200 МБ; старі версії можна видалити в адміністративній панелі. Файли бібліотеки медіа не змінюються.
Публічні маршрути REST обмежені фіксованими джерелами й дозволеним списком параметрів. Лічильники WordPress обмежують звичайний потік запитів; для суворого захисту від розподіленого вичерпання квот налаштуйте також обмеження частоти запитів на вебсервері.
Якщо сайт кешує цілі сторінки, виключіть сторінки календаря або встановіть строк зберігання не більш ніж 300 секунд і очищуйте кеш опівночі за часовим поясом сайту. Інакше HTML може залишатися в кеші довше за дані API.
Збереження налаштувань скидає кеш плагіна. Деактивація зберігає налаштування.

Можливості

22 динамічні блоки Gutenberg і короткі коди, окреме меню плагіна, конструктор із попереднім переглядом наживо та копіюванням коротких кодів, вбудована довідка, серверне формування HTML, зміна дат без перезавантаження, модальні вікна, пошук у пам’ятях дня, постійні посилання ?orthocal_date=YYYY-MM-DD, незалежні блоки, три теми оформлення, адаптивна верстка, стилі друку та керування з клавіатури.
Налаштування, блоки Gutenberg, картки дня та вікно читання підтримують підписи російською, німецькою, українською та польською мовами; мова календарних даних і мова Біблії вибираються окремо. Переклади календаря можуть бути неповними. Вбудовані богослужбові тексти — церковнослов’янські; німецькі видання доступні за посиланнями. Відсутні дані ніколи не замінюються іншими іконами чи житіями.