PHPackages                             s1lentium/craft-recurring-dates - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. s1lentium/craft-recurring-dates

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

s1lentium/craft-recurring-dates
===============================

This is a plugin for the Craft CMS to add recurring dates functionality

1291PHP

Since Jun 10Pushed 8y ago1 watchersCompare

[ Source](https://github.com/S1lentium/craft-recurring-dates)[ Packagist](https://packagist.org/packages/s1lentium/craft-recurring-dates)[ RSS](/packages/s1lentium-craft-recurring-dates/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

craft-recurring-dates
=====================

[](#craft-recurring-dates)

### I could still use help testing and bug fixing. If you find any issues put them in the Github issues. Thanks

[](#i-could-still-use-help-testing-and-bug-fixing-if-you-find-any-issues-put-them-in-the-github-issues-thanks)

This is a plugin for the Craft CMS to add recurring dates functionality. It adds a new field type called Advanced Date which has the recurring date functions. It stores the recurring dates and an rule in the data base and returns an array of dates to the twig templates. I'm using the [Recurr library](https://github.com/simshaun/recurr) by [simshaun](https://github.com/simshaun) to build and parse the rrule.

\###Installation

1. Clone this project into `your_craft_dir/craft/plugins/recurringdate`
2. Install Composer from [getcomposer.org](https://getcomposer.org/doc/00-intro.md#installation-nix)
3. Run `composer install` or `php composer.phar install` in the `recurringdate` directory to install dependencies
4. Install the plugin through the Craft admin panel

\###Usage

- Add a new Advanced Date Field type to one of your sections
- Output is either an array of dates and the entries associated with them or an array of the values used to set the date rule. Output depends on how you query the dates
- Multiple Dates Query can be used to automatically sort and filter corresponding dates. I built this with an event calendar in mind, that would need recurring dates.

\####Example Output Usage - Multiple Dates Query

```
{% set query = craft.entries.section('events').relatedTo(craft.categories.slug('your-slug')) %}
{% set events = craft.recurringdate.dates('yourFieldHandle',
	{
		'limit': 3,
		'before': '12/22/2014',
		'after': 'now +1 months',
		'criteria': query
	})
%}

{% for event in events %}
	  {{ event.date.start|date("n/j/Y") }}{{ event.date.end ? ' -- ' ~ event.date.end|date("n/j/Y") }}
{% endfor %}

```

\####Arguments for `craft.recurringdate.dates`

- Field Handle - Handle of your field in the Craft CP

Values in the options array - see above example for usage

- `limit` - limit the number of entries returned
- `order` - 'ASC' or 'DESC' - defaults to 'ASC'
- `group` - null, 'day', 'month', or 'year' - See Grouping Info Below
- `before` - null, or Date string accepted by PHP's [strtotime function](http://www.php.net/manual/en/datetime.formats.php)
- `after` - null, or Date string accepted by PHP's strtotime function
- `criteria` - ElementCriteriaModel returned by a craft entry query
- `excludes` - if excluded dates should be respected - defaults to true

\####Properties available for output for Multiple Dates Query

- `date` - Array containing all the date info for the recurring date
    - `id` - Id of the date, used to query the correct date in a sequence
    - `elementId` - Id of the Craft entry associated with this date
    - `start` - A string containing the start date
    - `end` - A string containing the end date, if set
    - `start_time` - A string containing the start time, if set
    - `end_time` - A string containing the end time, if set
    - `allday` - If the date lasts all day
    - `repeats` - If the date repeats
    - `rrule` - The RRULE string used to build the date
- `entry` - The entry associated with this date

\####Info about using Group for Multiple Dates Query The Group query will return a different structure than a regular query. It's structure looks like this

```
  array(
	    'grouped_date_string' = array(
		      array('date', 'entry'),
		      array('date', 'entry'),
		      ...
	    ),
	    'grouped_date_string2' = array(
		      array('date', 'entry'),
		      array('date', 'entry')
	    ),
	    ...
  )

```

\####Example Output Usage - Single Date Query using Date ID

```
 {% set row = craft.recurringdate.date(id) %}
 {% set date = row.date %}
 {% set entry = row.entry %}
 {{ entry.title }}
 {{ date.start_date|date("n/j/Y H:i:s") }}{{ date.end_date is defined ? ' -- ' ~ date.end_date|date("n/j/Y H:i:s") }}

```

\####Properties available for output for Single Date Query The Single Date Query will only return one array that contains the `date` and the `entry` of the row with the specified ID. The idea is that you would use the multiple date query to list the date's ID and then you can select which specific date you want to display based on that ID.

\####Example Output Usage - Single Entry

```
  {% set date = entry.advanced_date_field_name %}
  {{ date.start_date|date("n/j/Y H:i:s") }}{{ date.end_date is defined ? ' -- ' ~ date.end_date|date("n/j/Y H:i:s") }}

```

\####Properties available for output for each Advanced Date Field - Single Entry

- `start_date` - Craft DateTime Object - Start date set for the event
- `start_time` - Craft DateTime Object - Same as startdate
- `end_date` - Craft DateTime Object - End date set for the event, can be null if not set
- `end_time` - Craft DateTime Object - Same as enddate
- `allday` - Boolean - If the event is an allday event
- `repeats` - Boolean - If the event repeats
- `frequency` - String - Recurrence frequency, 'daily', 'weekly', 'monthly', 'yearly'
- `interval` - Int - Recurrence Interval, integer from 1-31
- `weekdays` - Array - days of the week that the event occurs, undefined if interval not weekly, 'SU', 'MO', 'TU', etc...
- `repeat_by` - String - by day of week or day of month, undefined if interval not monthly, 'week', 'month'
- `ends` - String - how the event ends, 'never', 'after', 'until'
- `count` - Int - How many times this occurs, undefined if `ends` is not 'after'
- `until` - Craft DateTime Object - Date event goes until, undefined if `ends` is not 'until'
- `rrule` - RRULE string used to build the rule

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/6ebe908e005d7da384f9abf4a7a7a76de7604f52a18c50c4b13966d3e7ebca11?d=identicon)[S1lentium](/maintainers/S1lentium)

---

Top Contributors

[![dfockler](https://avatars.githubusercontent.com/u/2158103?v=4)](https://github.com/dfockler "dfockler (51 commits)")[![S1lentium](https://avatars.githubusercontent.com/u/2018277?v=4)](https://github.com/S1lentium "S1lentium (2 commits)")

### Embed Badge

![Health badge](/badges/s1lentium-craft-recurring-dates/health.svg)

```
[![Health](https://phpackages.com/badges/s1lentium-craft-recurring-dates/health.svg)](https://phpackages.com/packages/s1lentium-craft-recurring-dates)
```

###  Alternatives

[froala/wysiwyg-editor

A beautiful jQuery WYSIWYG HTML rich text editor. High performance and modern design make it easy to use for developers and loved by users.

5.4k306.9k3](/packages/froala-wysiwyg-editor)[rewieer/taskschedulerbundle

Task Scheduler with CRON for Symfony

63242.1k](/packages/rewieer-taskschedulerbundle)[ghoster/module-outofstockatlast

Magento 2.4.x module Sort Out Of Stock Product At last the product list

60122.6k](/packages/ghoster-module-outofstockatlast)[fof/byobu

Well integrated, advanced private discussions.

61105.8k9](/packages/fof-byobu)[flowpack/listable

Tiny extension for listing things

35209.0k7](/packages/flowpack-listable)[snowdog/module-alpaca-components

Components of the Alpaca theme for Magento 2

4582.2k2](/packages/snowdog-module-alpaca-components)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)