Liturgical year module


The liturgical year, also known as the Christian year, consists of the cycle of liturgical seasons in Christian churches which determines when Feasts, Memorials, Commemorations, and Solemnities are to be observed and which portions of Scripture are to be read. The dates of the festivals vary somewhat between the different churches, though the sequence and logic is largely the same. This module shows major events in the liturgical calendar in chronological order.

Step-by-step guide for Joomla 2.5 and later

  1. Log in to the Joomla administration back-end.
  2. Select Extensions / Install/Uninstall from the top menu.
  3. In the panel Upload package file, click Browse and locate the installation package you have downloaded to your local computer.
  4. Click the button Upload & Install.
  5. Select Extensions / Module manager from the top menu.
  6. Click Liturgical year in the list.
  7. In the panel Details on the left-hand size, select Published from the drop-down list Published.
  8. Finally, go through either the (a) or (b) series of steps.

    (a) In order to use the module as a regular module:

    1. In the panel Details, click the button Select position and choose a template position from the list.
    2. In the panel Menu assignment, choose the menu items where the module will display (e.g. On all pages, or Only on the pages selected and tick some of the checkboxes).
    3. Click Save and you are all set.

    (b) In order to put the module in the text of an article:

    1. In the panel Details, type your own name in the text box Position, e.g. liturgicalyear.
    2. In the panel Menu assignment, choose On all pages from the drop-down list Module assignment.
    3. Click Save & Close.
    4. Select Extensions / Plugin manager from the top menu.
    5. Find Content - Load modules in the list and make sure it is enabled.
    6. In the text of an article, type {loadposition liturgicalyear}. (For this step, do not use copy-and-paste.)
  9. If you have found the liturgical year module useful, please consider registering and submitting a vote and/or review in the JED.


This module can be installed and configured in the administration back-end using the Module manager. Individual events can be shown or hidden separately (e.g. show Christmas and hide Ash Wednesday), with optionally displaying the exact date as well as the number of days since or until the event. The module lets you configure lookahead and lookbehind, i.e. the maximum number of days until an event to be shown and the maximum number of days to elapse before the event would be hidden.

There are two ways to use the module. Typically, you would simply assign the Liturgical year module to a regular template position already understood by the template you use, such as left or right, which would make it appear directly in the designated position. However, you can also embed the output of the module inside the text of an article, as illustrated by the sample output below. This is accomplished with the help of the Load module built-in Joomla extension using the syntax {loadposition modulename} where modulename is a custom name you have chosen for Position on the module configuration page (e.g. myposition). (See the example below for details. Novice users must pay attention to type the phrase for loadposition including the opening and closing braces and the chosen module name, and not copy and paste it from this text.)

Events available

You can check or uncheck each of the events below on the module configuration page.

Commonly observed




Sample output

The example below illustrates the Liturgical year module when embedded directly in the text of an article with the help of the Load module extension using the syntax {loadposition liturgicalyear} where liturgicalyear is the custom name chosen for Position on the module configuration page.

Reformation day
(Saturday, 31 October 2020, 5 days later)

All Saints' Day
(Sunday, 01 November 2020, 6 days later)

All Souls' Day
(Monday, 02 November 2020, 7 days later)

Eternity Sunday
(Sunday, 22 November 2020, 27 days later)

Advent Sunday
(Sunday, 29 November 2020, 34 days later)

Advent (second Sunday)
(Sunday, 06 December 2020, 41 days later)

Advent (third Sunday)
(Sunday, 13 December 2020, 48 days later)

Advent (fourth Sunday)
(Sunday, 20 December 2020, 55 days later)

(Friday, 25 December 2020, 60 days later)

Christmas (second day)
(Saturday, 26 December 2020, 61 days later)

(Wednesday, 06 January 2021, 72 days later)

Ash Wednesday
(Wednesday, 17 February 2021, 114 days later)

Lent (first Sunday)
(Sunday, 21 February 2021, 118 days later)


The liturgical year module is available for download under GNU/GPL at JoomlaCode.


If you need support to find a solution to a problem you have encountered or you have further questions, please feel free to This email address is being protected from spambots. You need JavaScript enabled to view it.. Our small projects team is glad to give assistance as needed. However, please note that unlike the software itself, which scales with the number of users without putting extra strain on us, e-mail questions take as much time to answer as many there are. Replying to e-mails diverts resources from project development and maintenance, both of which have much higher community value. Therefore, should you want to ask questions, please consider donating to the project first.


Donate in EUR via PayPal
Donate in USD via PayPal