WebSamurai SuperDate allows you to add sophisticated date scheduling functionality to any WordPress post type (posts, pages, or custom post types). Perfect for events, appointments, schedules, or any content that needs recurring date management.
Features
- Post Type Selection – Choose which post types should have WebSamurai SuperDate functionality through an easy-to-use settings page.
- Repeating Dates – Support for multiple repeat patterns:
- Daily (every X days)
- Weekly (every X weeks on selected days)
- Monthly (every X months on a specific day)
- Yearly (every X years)
- Custom dates (add specific dates manually)
- Date Range – Set start and end dates for your content.
- Cancelled Dates – Maintain a list of dates to exclude from the schedule.
- Gutenberg Block – Display dates in beautiful day, week, or month calendar views.
- WordPress Standards – Built following WordPress coding standards and best practices.
Requirements
- WordPress 5.0 or higher
- PHP 7.0 or higher
Support
For bug reports and feature requests, please contact the plugin author.
Usage
Settings Page
Navigate to Settings > WebSamurai SuperDate in your WordPress admin to select which post types should have WebSamurai SuperDate functionality.
Meta Boxes
When editing a post of a selected type, you’ll see three new meta boxes:
1. Repeating Dates
Choose how your dates should repeat:
- No Repeat – Single occurrence
- Daily – Repeat every X days
- Weekly – Repeat every X weeks on selected days of the week
- Monthly – Repeat every X months on a specific day of the month
- Yearly – Repeat every X years
- Custom Dates – Manually add multiple specific dates
2. Date Range
Set the start and end dates for when the content should be active or scheduled.
3. Cancelled Dates
Add specific dates that should be excluded from the schedule. Useful for holidays, exceptions, or one-off cancellations.
WebSamurai SuperDate Calendar Block
Insert the WebSamurai SuperDate Calendar block anywhere in your site – posts, pages, widget areas, or templates – to display dates in a visual calendar format.
Block settings:
- Show All Posts – Toggle to display dates from multiple posts instead of a single post.
- When disabled: Select a specific post to display.
- When enabled: Display dates from all posts with optional filters.
- Filter by Post Type – (Show All mode only) Select which post types to include.
- Filter by Category – (Show All mode only) Filter posts by categories.
- Filter by Tag – (Show All mode only) Filter posts by tags.
- View Type – Choose between Day, Week, or Month view.
- Current Date – Select which date to display (useful for previewing different time periods).
Display features:
- Day View – Shows all events for a single day with details and excerpts.
- Week View – Displays a 7-day grid with events for each day.
- Month View – Full calendar month grid with event indicators.
Single Post Mode: The block displays dates from one selected post, automatically calculating all dates based on the post’s WebSamurai SuperDate meta box settings, including repeating patterns and excluding cancelled dates.
Show All Mode: Display dates from multiple posts simultaneously. Use the filter options to narrow down which posts to include:
- Filter by one or more post types (posts, pages, custom post types)
- Filter by categories (for applicable post types)
- Filter by tags (for applicable post types)
- Combine filters for precise control
Each date in Show All mode displays all posts scheduled for that date, with clickable links to view the full post.
Developer Notes
Meta Data Reference
The plugin stores the following post meta fields:
_superdate_repeat_type– The type of repeat (daily, weekly, monthly, yearly, custom)_superdate_repeat_interval– The interval for repeating (e.g., every 2 days, every 3 weeks)_superdate_repeat_days– Array of days of the week for weekly repeats_superdate_repeat_day_month– Day of month for monthly repeats_superdate_repeat_dates– Array of custom dates_superdate_start_date– Start date for the date range_superdate_end_date– End date for the date range_superdate_cancelled_dates– Array of cancelled dates
Accessing Meta Data
You can access the WebSamurai SuperDate meta data in your theme or plugin:
// Get repeat type
$repeat_type = get_post_meta( $post_id, '_superdate_repeat_type', true );
// Get start date
$start_date = get_post_meta( $post_id, '_superdate_start_date', true );
// Get cancelled dates
$cancelled_dates = get_post_meta( $post_id, '_superdate_cancelled_dates', true );
Building the Block Assets
npm install # one-time
npm run build # compile src/ -> build/
npm run start # watch mode
Linting
npm run lint:php:setup # one-time - composer install
npm run lint:php # check PHP against WordPress Coding Standards
npm run lint:php:fix # auto-fix what phpcbf can
npm run lint:js # check JavaScript
npm run lint:css # check SCSS/CSS
See docs/coding-standards.md for details.