Title: WebSamurai SuperDate Author: Kiera Howe Published: 12 August 2026 Last modified: 12 August 2026 --- Search plugins ![](https://s.w.org/plugins/geopattern-icon/superdate.svg) # WebSamurai SuperDate By [Kiera Howe](https://profiles.wordpress.org/jxowe/) [Download](https://downloads.wordpress.org/plugin/superdate.1.0.0.zip) * [Details](https://en-gb.wordpress.org/plugins/superdate/#description) * [Reviews](https://en-gb.wordpress.org/plugins/superdate/#reviews) * [Installation](https://en-gb.wordpress.org/plugins/superdate/#installation) * [Development](https://en-gb.wordpress.org/plugins/superdate/#developers) [Support](https://wordpress.org/support/plugin/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. ## Blocks This plugin provides 3 blocks. * SuperDate Calendar Display dates in day, week, or month view from SuperDate meta boxes. * SuperDate Upcoming Dates Display the next scheduled dates for a post. * SuperDate Schedule Display a post's schedules in plain text (time, repeat pattern, location). ## Installation 1. Upload the `superdate` folder to the `/wp-content/plugins/` directory. 2. Activate the plugin through the ‘Plugins’ menu in WordPress. 3. Go to Settings > WebSamurai SuperDate to configure which post types should use the plugin. 4. Edit any post of the selected type to see the new meta boxes. ## FAQ ### Which post types can use WebSamurai SuperDate? Any registered post type. Go to Settings > WebSamurai SuperDate and tick the post types you want WebSamurai SuperDate meta boxes to appear on. ### How do I exclude a single date from a repeating schedule? Add the date to the Cancelled Dates meta box on the post. Cancelled dates are excluded everywhere dates are calculated, including the WebSamurai SuperDate Calendar block. ### Can the calendar block show events from more than one post? Yes. Enable **Show All Posts** in the block settings, then optionally filter by post type, category, or tag. ## Reviews There are no reviews for this plugin. ## Contributors and Developers “WebSamurai SuperDate” is open source software. The following people have contributed to this plugin. Contributors * [ Kiera Howe ](https://profiles.wordpress.org/jxowe/) [Translate “WebSamurai SuperDate” into your language.](https://translate.wordpress.org/projects/wp-plugins/superdate) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/superdate/), check out the [SVN repository](https://plugins.svn.wordpress.org/superdate/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/superdate/) by [RSS](https://plugins.trac.wordpress.org/log/superdate/?limit=100&mode=stop_on_copy&format=rss). ## Change Log #### 1.0.0 * Initial release * Post type selection settings page * Repeating dates functionality (daily, weekly, monthly, yearly, custom) * Date range meta box * Cancelled dates meta box * WebSamurai SuperDate Calendar Gutenberg block with single post mode and Show All mode, day/week/month views, filtering by post type, category, and tag, multiple posts per date, and clickable post links in Show All mode * Date calculation helper class * Full WordPress coding standards compliance ## Meta * Version **1.0.0** * Last updated **16 hours ago** * Active installations **Fewer than 10** * WordPress version ** 5.0 or higher ** * Tested up to **7.0.4** * PHP version ** 7.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/superdate/) * Tags * [calendar](https://en-gb.wordpress.org/plugins/tags/calendar/)[dates](https://en-gb.wordpress.org/plugins/tags/dates/) [events](https://en-gb.wordpress.org/plugins/tags/events/)[recurring](https://en-gb.wordpress.org/plugins/tags/recurring/) [schedule](https://en-gb.wordpress.org/plugins/tags/schedule/) * [Advanced View](https://en-gb.wordpress.org/plugins/superdate/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/superdate/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/superdate/reviews/) ## Contributors * [ Kiera Howe ](https://profiles.wordpress.org/jxowe/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/superdate/)