WebSamurai SuperDate

Àpèjúwe

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 Ìtumọ̀ Yorùbá: – Choose which post types should have WebSamurai SuperDate functionality through an easy-to-use settings page.
• Repeating Dates Ìtumọ̀ Yorùbá: – 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 Ìtumọ̀ Yorùbá: – Set start and end dates for your content.
• Cancelled Dates Ìtumọ̀ Yorùbá: – Maintain a list of dates to exclude from the schedule.
• Gutenberg Block Ìtumọ̀ Yorùbá: – Display dates in beautiful day, week, or month calendar views.
• WordPress Standards Ìtumọ̀ Yorùbá: – 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Ìtumọ̀ Yorùbá: ’ll see three new meta boxes:

1. Repeating Dates

Choose how your dates should repeat:

• No Repeat Ìtumọ̀ Yorùbá: – Single occurrence
• Daily Ìtumọ̀ Yorùbá: – Repeat every X days
• Weekly Ìtumọ̀ Yorùbá: – Repeat every X weeks on selected days of the week
• Monthly Ìtumọ̀ Yorùbá: – Repeat every X months on a specific day of the month
• Yearly Ìtumọ̀ Yorùbá: – Repeat every X years
• Custom Dates Ìtumọ̀ Yorùbá: – 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 Ìtumọ̀ Yorùbá: – posts, pages, widget areas, or templates Ìtumọ̀ Yorùbá: – to display dates in a visual calendar format.

Block settings:

• Show All Posts Ìtumọ̀ Yorùbá: – 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 Ìtumọ̀ Yorùbá: – (Show All mode only) Select which post types to include.
• Filter by Category Ìtumọ̀ Yorùbá: – (Show All mode only) Filter posts by categories.
• Filter by Tag Ìtumọ̀ Yorùbá: – (Show All mode only) Filter posts by tags.
• View Type Ìtumọ̀ Yorùbá: – Choose between Day, Week, or Month view.
• Current Date Ìtumọ̀ Yorùbá: – Select which date to display (useful for previewing different time periods).

Display features:

• Day View Ìtumọ̀ Yorùbá: – Shows all events for a single day with details and excerpts.
• Week View Ìtumọ̀ Yorùbá: – Displays a 7-day grid with events for each day.
• Month View Ìtumọ̀ Yorùbá: – 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Ìtumọ̀ Yorùbá: ’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 Ìtumọ̀ Yorùbá: – The type of repeat (daily, weekly, monthly, yearly, custom)
• _superdate_repeat_interval Ìtumọ̀ Yorùbá: – The interval for repeating (e.g., every 2 days, every 3 weeks)
• _superdate_repeat_days Ìtumọ̀ Yorùbá: – Array of days of the week for weekly repeats
• _superdate_repeat_day_month Ìtumọ̀ Yorùbá: – Day of month for monthly repeats
• _superdate_repeat_dates Ìtumọ̀ Yorùbá: – Array of custom dates
• _superdate_start_date Ìtumọ̀ Yorùbá: – Start date for the date range
• _superdate_end_date Ìtumọ̀ Yorùbá: – End date for the date range
• _superdate_cancelled_dates Ìtumọ̀ Yorùbá: – 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.