sunnysideup / schedulizer
A silverstripe module for organising stuff to happen at arbitrary times in the future, useful with QueuedJobs
Installs: 11
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 2
Type:silverstripe-vendormodule
Requires
- silverstripe/recipe-cms: ^4.0 || ^5.0
Replaces
This package is not auto-updated.
Last update: 2024-10-29 12:59:28 UTC
README
Fun module for organising stuff to happen at arbitrary times in the future.
Maintainer Contacts
- Stephen McMahon stephen@symbiote.com.au
- Marcus Nyeholt marcus@symbiote.com.au
Requirements
- SilverStripe 3.1
Usage
- Create a Configured Schedule via the CMS admin
- From code, call
ConfiguredSchedule::get()->filter('Title', $name)->first()->getNextScheduledDateTime();
Configuring schedules
For a job, schedules are read in particular precedence; first, the 'default' schedule is loaded. All other schedules are evaluated to see if they are applicable for the "current" time; if so, the desired schedule is substituted for, in increasing order of importance
- A ScheduleRangeDayType (ie weekday, Weekend)
- A ScheduleRangeDay (ie Monday, Tuesday)
- A ScheduleRange (ie specific date)
This allows configuration of a schedule set that is, for example
- Default - 6am - 6pm every day until 2020
- Weekends - 9am - 5pm
- Thursday - 6am - 9pm
- 25/12/2015 - 10am - 2pm
The decided upon schedule evaluates each in order, and selects that which is most specific.
Create a schedule
- Open
admin/schedulizer/
. - Create a new schedule - for QueuedJobs usage, use the same name as the job classname
- Create a new Schedule Range; the first one should be called "Default" and have a type of "ScheduleRangeDefault". This is the baseline schedule that will be used
- Add additional schedules if needed
- Test the schedule by entering a date/time (YYYY-MM-DD hh:mm:ss format) and clicking "Test" - this will update with the next detected 'tick' time for that schedule.
Modifying a schedule
- Open
admin/schedulizer/
- Select the schedule to modify
- On the "Schedule Ranges" tab, select the schedule to modify
- Modify the relevant fields
- Save and close, then test the new schedule as above.
License
This module is licensed under the BSD license at http://silverstripe.org/BSD-license