hashandsalt / kirby-recurr
Kirby 3 Recurring Date Helper
Installs: 43
Dependents: 0
Suggesters: 0
Security: 0
Stars: 13
Watchers: 3
Forks: 1
Open Issues: 0
Type:kirby-plugin
Requires
- getkirby/composer-installer: ^1.1
- simshaun/recurr: ^4.0
README
This plugin integrates the Recurr library to make it easier to work with repeating dates (like events on a calender).
Install
Download
Download and copy this repository to /site/plugins/kirby-recurr
.
Composer
composer require hashandsalt/kirby-recurr
Commerical Usage
This plugin is free but if you use it in a commercial project please consider to
Usage
Use as a site method with manual dates:
$datelist = $site->recurr('2019-09-10 20:00:00', '2019-09-11 02:00:00', 'WEEKLY', ['WE', 'TH', 'FR'], '2019-10-11');
or with field data:
$datelist = $site->recurr($page->estart(), $page->eend()->or($page->estart()), $page->efreq()->recurrfreq(), $page->ebyday()->recurrdays(), $page->erange());
By default the plugin returns an array of dates for start and end times for each. If you want an RRule instead, you set true on the end:
$datelist = $site->recurr($page->estart(), $page->eend()->or($page->estart()), $page->efreq()->recurrfreq(), $page->ebyday()->recurrdays(), $page->erange(), true);
End date is optional:
$datelist = $site->recurr($page->estart(), null, $page->efreq()->recurrfreq(), $page->ebyday()->recurrdays(), $page->erange());
By day is only used if the frequency is set to either MONTHLY or YEARLY.
Field Methods
By day and Frequency need to be in uppercase, for convenience there are 2 field methods to do this for you:
$page->efreq()->recurrfreq()
$page->ebyday()->recurrdays()
Example Use
In the example above, we are feeding it Start Time, End Time, Frequency, Days to repeat on and the date to stop the range. The above example repeats every week but only on Wednesdays, Thursdays and Fridays. Then you can loop through it:
Date/Time Array
<table class="table">
<tr>
<th>Session Start</th>
<th>Session End</th>
</tr>
<?php
$datelist = $site->recurr($page->estart(), $page->eend()->or($page->estart()), $page->efreq()->recurrfreq(), $page->ebyday()->recurrdays(), $page->erange());
foreach($datelist as $event): ?>
<tr>
<td><?= $event['start'] ?></td>
<td><?= $event['end'] ?></td>
</tr>
<?php endforeach ?>
</table>
RRule
If your working with a calendar like fullcalender.js that supports RRules, you can get that like so:
<?php
$datelist = $site->recurr($page->estart(), $page->eend()->or($page->estart()), $page->efreq()->recurrfreq(), $page->ebyday()->recurrdays(), $page->erange(), true);
echo $datelist;
?>
Filter past dates
For convenience, the plugin contains a collection filter that will remove events that have happened before a certain date.
$events = $kirby->collection('events')->filterBy($field, 'datebefore', $beforedate);
To see this in action, you can use the snippet provided with the plugin to list upcoming events, assuming you have a collection called 'events':
<?= snippet('events/upcoming', ['field' => 'estart', 'beforedate' => date('Y-m-d H:i:s')]) ?>
Options
Default time zone is Europe/London
, and time format is 09-12-19 2:00am
.
You can reset these in your config:
'hashandsalt.recurr.timezone' => 'Europe/London',
'hashandsalt.recurr.format' => 'm-d-y g:ia',