> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/calendar-filter/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/calendar-filter/calendar-filter.md).

# Calendar Filter

{% embed url="<https://norrnext.com/joomla-extensions/other/calendar-filter>" %}

### System Requirements

| Minimal     | Recommended |
| ----------- | ----------- |
| Joomla 4.4+ | Joomla 6.0+ |
| PHP 8.1     | PHP 8.3+    |

### Installation

This extension can be installed as a typical Joomla extension and the installation package comes as a module and plugin.&#x20;

[How to install an extension](https://docs.norrnext.com/joomla-tutorials/how-to-install-an-extension)\
[How to enable one-click update for NorrNext commercial extensions](https://docs.norrnext.com/joomla-tutorials/how-to-enable-one-click-update-for-norrnext-commercial-extensions)

The system plugin has no options while module needs to be configured.

### Module Settings

<figure><picture><source srcset="/files/mfMEYpK4GrqSLilWhQMm" media="(prefers-color-scheme: dark)"><img src="/files/7shgM0uZHdU3sRTpv9Q3" alt="Calendar Filter  - settings"></picture><figcaption><p>Module settings</p></figcaption></figure>

**Articles Query Date** — Created / Published / Modified / Custom Field. Select the article dates or custom field that will be used to query the articles.

**Field** — the list of custom fields that have a Calendar type to query the dates.

**Default Category** - the category that will be used if the category is not set in the request parameters (URL).

**Archived Articles** — Yes / No. Should the archived articles be queried or not.

**Years Ordering** — Descending / Ascending. Set how the years in the list layout should be sorted.

**Articles Link** — if enabled, this parameter assigns link below the calendar with a menu item for quick return to the list of all articles (reset).

#### Calendar Options

<figure><picture><source srcset="/files/nQBz0yE4TrnFSnh2vjHS" media="(prefers-color-scheme: dark)"><img src="/files/YFVHMRCMPDjXHl6UP6Kp" alt="Calendar Options"></picture><figcaption><p>Calendar Options</p></figcaption></figure>

**Calendar by Article** — set the current calendar's year and month by the last article's year and month.

**Ignore Request** — Yes/No. Ignore the request parameters set in the URL and use from the module settings.

**Type** — 'Day' - in the calendar you can select years, months and days. 'Month' - available only months and years. 'Year' - available only years.

**Theme** — select calendar's theme. System / Light / Dark.

**Days Outside** — show or hide the days from the previous and next month.

**Show Titles on Hover** — show article titles as popups when hovering over dates.

**Popup Titles Order** — ordering of article titles inside the popup. Created date / Published date / Modified date / Title.&#x20;

**Week Numbers** — show or hide week numbers.

**First Day of the Week** — set the first day of the week.

To choose between Calendar and List mode you need to go to Advanced Tab and select the right Layout:&#x20;

* Default (Calendar)
* Bootstrap list
* Uikit list