內容簡介
WebSamurai SuperDate 外掛讓您能夠為任何 WordPress 文章類型（如文章、頁面或自訂文章類型）添加先進的日期排程功能，適合用於活動、預約、行程或需要重複日期管理的內容。
【主要功能】
• 文章類型選擇：輕鬆設定可使用的文章類型
• 重複日期：支援多種重複模式
• 日期範圍：設定內容的開始和結束日期
• 取消日期：維護排程中需排除的日期
• Gutenberg 區塊：以美觀的日、週或月曆視圖顯示日期
外掛標籤
開發者團隊
原文外掛簡介
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.
