WebSamurai SuperDate

Description

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.