# 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="https://3069341405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YBNLLoVmtaIjEzj4GyY%2Fuploads%2FJeqJ54mJtepYylA9TNeg%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-12-11%20%D0%B2%2016.04.01.png?alt=media&#x26;token=8a4a29fb-16b7-4a0d-93ba-c8684ca1ca91" media="(prefers-color-scheme: dark)"><img src="https://3069341405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YBNLLoVmtaIjEzj4GyY%2Fuploads%2FqoyShdhSZkjHAgeeA1oH%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-12-11%20%D0%B2%2016.03.21.png?alt=media&#x26;token=89401a3b-0f55-40c5-93db-5157f245654b" 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="https://3069341405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YBNLLoVmtaIjEzj4GyY%2Fuploads%2FWmR90ACwv3qjFAdhwRZV%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-12-11%20%D0%B2%2016.04.11.png?alt=media&#x26;token=7131495f-0192-4282-be56-bd89e0b3e093" media="(prefers-color-scheme: dark)"><img src="https://3069341405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YBNLLoVmtaIjEzj4GyY%2Fuploads%2FXWR6vRjKXPMiBi5XAaUo%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-12-11%20%D0%B2%2016.03.30.png?alt=media&#x26;token=30462388-c633-495b-bb00-c84f52f89123" 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.

**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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.norrnext.com/calendar-filter/calendar-filter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
