FieldtypeRecurringDates by Eduardo San Miguel Garcia

Field that stores recurring events from a UI to define RRules.

This is a pre-release please do not use in production.

FieldtypeRecurringDates

inputfieldrecurringdates

Fieldtype and Inputfield for definining recurring dates according to RFC-RFC 5545 and the awesome library php-rrule

Installation

composer require elabx/fieldtype-recurring-dates

Make sure to install both FieldtyeRecurringDates and AlpineJS modules. Additionally you may install RecurringDatesFinder for search operations.

Or download through the processwire modules directory.

This module will save the RRules occurrences in the database to be queried later.

Find pages with fields

Use date values valid for date selectors.

$pages->find('recurring_meetings=>today')

Finding occurrences

You can use the module included in this same package to find the rules occurrences:

$start and $end value are any acceptable value for $datetime

$finder = $modules->get('ReccurringDatesFinder')
$output = $finder->find(
     // from date
    'today',
    // to date
    '+30 days',
    $selector, [
        'fields' => [ // Will find event occurrences in fields specified in this array
            'recurring_meetings',
            'recurring_events'
        ]
    ]

This method will return the SQL UNION result of specified fields.

You can also hook into getRecurringFieldQueries() to add queries that will get added to the final UNION query.

TODO

  • [ ] Add support for BYSETPOS
  • [ ] Add support for 'Never' option.

Wishlist

  • [ ] Support for plain text RRule.
  • [ ] Add support for BYWEEKNO, BYYEARDAY, BYMONTHDAY, BYMINUTE, BYHOUR, BYMINUTE, BYSECOND .
  • [ ] Add support to modify RRule before saving? Maybe skips
  • [ ] Use RSet instead of RRule?

Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Latest news

  • ProcessWire Weekly #518
    The 518th issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 13 April 2024
  • ProFields Table Field with Actions support
    This week we have some updates for the ProFields table field (FieldtypeTable). These updates are primarily focused on adding new tools for the editor to facilitate input and management of content in a table field.
    Blog / 12 April 2024
  • Subscribe to weekly ProcessWire news

“Indeed, if ProcessWire can be considered as a CMS in its own right, it also offers all the advantages of a CMF (Content Management Framework). Unlike other solutions, the programmer is not forced to follow the proposed model and can integrate his/her ways of doing things.” —Guy Verville, Spiria Digital Inc.