Adds 22 dynamic Gutenberg blocks and shortcodes. Calendar and Bible data come from the external services listed below; no calendar database is included in the plugin.<\/p>\n\n
Public source repository: https:\/\/github.com\/VAtapin\/wp_orthodox_calendar\nJavaScript and CSS sources: https:\/\/github.com\/VAtapin\/wp_orthodox_calendar\/tree\/main\/assets<\/p>\n\n
The files assets\/admin.js, assets\/calendar.js, assets\/editor.js, assets\/admin.css and assets\/calendar.css are the original, human-readable sources and are included in this ZIP. They are served directly by WordPress. There is no transpilation, bundling, minification or generated JavaScript\/CSS, and no separate hidden source tree. The scripts use WordPress-provided Gutenberg libraries rather than bundled copies.<\/p>\n\n
Edit these source files directly. No npm build is required for plugin installation or development. To check JavaScript syntax, run node --check assets\/admin.js, node --check assets\/calendar.js and node --check assets\/editor.js. PHP files can be checked with php -l. Optional formatting: npx prettier@3.6.2 --write assets\/.js assets\/<\/em>.css. The repository includes scripts\/build-language-files.mjs for rebuilding MO catalogues with Node.js. The release packaging procedure is documented in the public repository README.md.<\/p>\n\n [orthocal_today]\n[orthocal_upcoming limit=\"5\" filter=\"main\"]\n[orthocal_month year=\"2027\" month=\"5\"]\n[orthocal_year year=\"2027\"]\n[orthocal_day date=\"2027-05-02\"]\n[orthocal_readings date=\"2027-05-02\"]\n[orthocal_calendar open=\"modal\"]\n[orthocal_fasting]\n[orthocal_saints]\n[orthocal_feasts limit=\"5\"]\n[orthocal_memorial]\n[orthocal_pascha year=\"2027\"]\n[orthocal_fasts year=\"2027\"]\n[orthocal_date]\n[orthocal_texts]\n[orthocal_troparia scope=\"resurrection\" tone=\"1\"]\n[orthocal_kontakia scope=\"weekday\" weekday=\"1\"]\n[orthocal_prayers]\n[orthocal_magnifications]\n[orthocal_horologion]<\/p>\n\n open=\"inline|modal|page\" controls how the day opens; reading_open=\"inline|modal\" controls readings. For a separate page, place [orthocal_day] on it and select that page in the settings. sections=\"fasting,saints,readings,texts,icons\", images=\"0|1\", and heading=\"0|1\" control the content. The admin generator previews parameters and output.\nimage_size=\"120\" sets a fasting-image height in pixels; its width retains the source image ratio. Existing small, medium, and large shortcodes continue to use heights of 28, 44, and 72 px.\nThe reference library contains an initial corpus of 98 Church Slavonic texts with sources and awaits liturgical editorial review. It does not automatically assign a text to a daily service. Akathists are planned in BibleDesktop and are not yet connected.<\/p>\n\n General parameters: lang=\"ru|cu|de|uk|pl\", profile=\"typikon-strict|parish\", theme=\"book|modern|inherit\", compact=\"0|1\", and oldstyle=\"0|1\". The Horologion uses a protected service route and includes Sixth Hour inserts. An empty date means the current date in the WordPress timezone. Supported years are 1900\u00e2\u20ac\u201c2200.\nUpcoming-event filters: main (major and memorial), twelve (Pascha and the Twelve Great Feasts), great, memorial, and all. The search covers the supplied date and the next 366 days, with a maximum of 10 events.<\/p>\n\n Calendar API: https:\/\/bible-desktop.com\/api\/v1\/calendar\/\nUsed to calculate dates, feasts, fasting, commemorations and reading references. Loading a block, its admin preview or changing the date sends the date\/period, language, calendar profile and display\/filter parameters from the WordPress server. Public requests include X-Calendar-Client: orthocal-wordpress. Normal public use needs no registration or key.\nTerms of Service: https:\/\/bible-desktop.com\/pages\/api-terms\nPrivacy Policy: https:\/\/bible-desktop.com\/pages\/api-privacy<\/p>\n\n Bible Desktop API: https:\/\/bible-desktop.com\/api\/\nUsed for Bible translations, books, chapters, liturgical libraries, hagiographies and icon catalogues\/images. Opening readings or a library sends the selected translation, book\/chapter, language, work identifier or pagination\/filter parameters. Loading icons sends the calendar month\/day or material\/image identifier. On cache misses, WordPress downloads images and fonts; scheduled cache revalidation sends conditional HTTP headers. Bible Desktop calculates the calendar locally. The retired Kalendar key is never sent to the replacement provider.\nTerms of Service: https:\/\/bible-desktop.com\/pages\/api-terms\nPrivacy Policy: https:\/\/bible-desktop.com\/pages\/api-privacy<\/p>\n\n Both services receive the requesting server IP address, request time, requested resource and technical HTTP headers. The plugin does not send visitor IP addresses, names, email addresses, WordPress passwords or post contents. Remote media are cached and served locally. Requests may be skipped while a valid cache entry is available. Full texts, icons and hagiographies are not bundled in the ZIP; their respective rights remain applicable.\nThe single Bible Desktop API origin can be changed in the Connection settings. These links describe the default providers; administrators choosing a different provider must review and disclose that provider's terms and privacy policy to their users.<\/p>\n\n The updated calendar API is required: upcoming, view=summary, and the X-Calendar-Application-Cache-TTL header.\nSuccessful calendar responses are retained for up to 300 seconds only when allowed by the API; access revocation and database changes appear no later than this expiry. Stale data is not used after errors. Responses without the allowing header are not retained between requests.\nBible responses are retained for the selected 0\/1\/6\/24 hours (24 by default); no-store disables retention unless separately permitted by the API. The browser deduplicates simultaneous requests.\nLocal images and fonts are stored in uploads\/orthocal-cache. Remote photos are resized to a maximum edge of 1200 pixels and compressed to no more than 100 KB before they are saved. Conditional ETag\/Last-Modified checks through WP-Cron run every 6\/12\/24\/168 hours (24 by default). A changed file receives a new hashed URL, while the last working copy remains available after a failure. The limit is 200 MB; old versions can be cleared in the admin area. Media Library files are not affected.\nPublic REST routes are limited to fixed sources and an allowlist of parameters. WordPress counters limit ordinary traffic; configure web-server rate limiting as well for strict protection against distributed quota exhaustion.\nIf the site has full-page caching, exclude calendar pages or use a TTL of no more than 300 seconds and clear it at midnight in the site timezone. Otherwise, HTML can outlive the API data.\nSaving settings invalidates the plugin cache. Deactivation preserves settings.<\/p>\n\n 22 dynamic Gutenberg blocks and shortcodes, a dedicated plugin menu, a live-preview generator with shortcode copying, built-in help, server-rendered HTML, date switching without reloads, modal dialogs, daily-commemoration search, ?orthocal_date=YYYY-MM-DD permalinks, independent blocks, three themes, responsive layouts, print styles, and keyboard navigation.\nSettings, Gutenberg blocks, day cards and the reader support Russian, German, Ukrainian and Polish labels; the calendar-data language and Bible language are chosen separately. Calendar translations can be incomplete. Built-in liturgical texts are Church Slavonic, with German editions available through links. Icon images and hagiographies are never substituted for missing data.<\/p>\n\n\n The retired Kalendar key is not sent to Bible Desktop. Saved legacy settings are retained but do not authorize public calendar requests.\nThe calendar, texts, translations, and icons API is configured in Georg-Kloster Calendar Workshop \u00e2\u2020\u2019 Connection. Its current default address is https:\/\/bible-desktop.com and no file access is required.<\/p>\n\n\n All calendar requests now use the configured Bible Desktop provider. Removed the separate Kalendar API origin and key forwarding. Decorative packs, Typikon signs and Monomakh are bundled locally; shortcodes and galleries are preserved.<\/p>\n\nShortcodes<\/h3>\n\n
External Services<\/h3>\n\n
Cache and access<\/h3>\n\n
Features<\/h3>\n\n
\n
1.3.78<\/h4>\n\n
\n
1.3.77<\/h4>\n\n
\n
1.3.76<\/h4>\n\n
\n
1.3.75<\/h4>\n\n
\n
1.3.74<\/h4>\n\n
\n
1.3.73<\/h4>\n\n
\n
1.3.72<\/h4>\n\n
\n
1.3.71<\/h4>\n\n
1.3.70<\/h4>\n\n
\n
1.3.69<\/h4>\n\n
\n
1.3.68<\/h4>\n\n
\n
1.3.67<\/h4>\n\n
\n
1.3.66<\/h4>\n\n
\n
1.3.65<\/h4>\n\n
\n
1.3.64<\/h4>\n\n
\n
1.3.63<\/h4>\n\n
\n
1.3.62<\/h4>\n\n
\n
1.3.61<\/h4>\n\n
\n