=== Feast Calendar ===
Contributors: webquicky
Tags: orthodox, feasts, calendar, easter, cyprus
Requires at least: 6.2
Tested up to: 7.1
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Orthodox feast calendar for WordPress: fixed and movable feasts, the Orthodox feasts of Cyprus ready to add, and the next feast on your site.

== Description ==

Feast Calendar keeps the feasts of your parish, village or community in one place and shows the next one on your site. Movable feasts are counted from Orthodox Easter, so their dates change every year by themselves.

* Monthly calendar in wp-admin, with the whole year listed below it
* Fixed feasts (same date every year, one or more days), movable feasts (days before or after Orthodox Easter) and whole-month feasts
* The Orthodox feasts celebrated in Cyprus, ready to add: all of them, only the major ones, or the ones you tick
* "All" and "Major" views: major feasts are the great feasts of the Lord and of the Virgin Mary, and the religious public holidays
* Turn any feast on or off. A feast that is off stays in the list but does not show on the site
* Change the date of a feast for one year only, or skip it for one year. Other years keep the normal rule
* Greek, English and Russian name for every feast, for multilingual sites
* Admin screens in Greek, English or Russian, switched from the top of the page
* A month calendar for the site, with previous / next month, as a shortcode or an Elementor widget
* Appearance settings: colours, font and corners of the calendar, with a live preview

= Shortcodes =

* `[next_feast]` the next feast, or the one happening now. Options: `link=""`, `lang="el"`, `lang="en"` or `lang="ru"`, `only="major"`, `class=""`
* `[feast_list count="7"]` the coming feasts as a list. Options: `count`, `lang`, `only="major"`, `class`
* `[feast_calendar]` the month calendar. Options: `month="2026-12"`, `only="major"`, `lang`, `nav="no"`, `list="no"`, `easter="no"`, `class`, and for one calendar only `color_fixed`, `color_easter`, `color_month`, `color_accent`, `color_text`, `color_bg`, `color_head`, `color_border`, `font`, `radius`

On Elementor sites there is also a "Feast Calendar" widget with colour and typography controls.

The page language comes from Polylang or WPML when they are active, otherwise from the site language.

= For developers =

* `fcal_capability` who may manage feasts (default `edit_pages`)
* `fcal_front_lang` the language of the site texts
* `fcal_front_text` the site texts ("Next feast", "Happening now", "All feasts")
* `fcal_library` the list of Orthodox feasts offered for adding
* `fcal_front_css` return false to drop the default site styles
* `fcal_docs_urls` the Documentation links

== Installation ==

1. Plugins > Add New Plugin > Upload Plugin, choose the ZIP file and click Install Now.
2. Activate. The major Orthodox feasts of Cyprus are added to the calendar the first time.
3. Open Feasts in the admin menu.

Documentation: https://www.webquicky.com/plugin/feast-calendar-documentation/

== Frequently Asked Questions ==

= What happens to my feasts if I deactivate the plugin? =

Nothing. Feasts and yearly changes stay saved and come back when you activate it again.

= St George falls before Easter this year. What do I do? =

When 23 April falls before Easter, St George is celebrated on Easter Monday. Open the calendar, click the feast and use "Change date this year".

= Does it work with Polylang or WPML? =

Yes. On multilingual sites the feast name and the calendar follow the page language. Every feast has a Greek, English and Russian name. Without a multilingual plugin the site language is used.

= Does it send any data anywhere? =

No. Feast Calendar does not contact any external server and does not collect any data. Everything is stored in your own WordPress.

== Screenshots ==

1. The month calendar on the front of the site, as a shortcode or an Elementor widget.
2. The month calendar in wp-admin, with the whole year listed below it.
3. The Orthodox feasts of Cyprus, ready to add: all of them, only the major ones, or the ones you tick.
4. Adding or editing a feast, with ready presets for movable (Easter based) feasts.
5. Appearance settings for the calendar: colours, font and corners, with a live preview.

== Changelog ==

= 1.0.0 =
* First release.

== Upgrade Notice ==

= 1.0.0 =
First release.
