Vieww Events Calendar – Recurring Events, Event Map & Calendar Plugin
| 开发者 | jarradnpd |
|---|---|
| 更新时间 | 2026年5月28日 19:21 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Vieww Events Calendar is a WordPress events calendar plugin for venues, community groups, churches, schools and small businesses. Show upcoming events in a card grid, a filterable list or a full month calendar — with recurring events, an interactive events map and full design controls built in.
Pick from three views — a card grid for what's coming up, a filterable list with date ranges, or a full month calendar visitors can click through. On phones, visitors get tap-to-open event cards and a quick toggle between calendar and list, so they don't lose their place.
What your visitors get:
- A polished calendar that matches your brand
- Three views to choose from — grid, list, or month calendar — and you can mix them across different pages
- Tap-to-open event cards on mobile so they don't have to leave the page to see the details
- A built-in events map so they can see at a glance where things are happening
- Add-to-calendar links — Google Calendar plus a downloadable file for Apple, Outlook and others
- Add events in under a minute — title, date, time, venue, description, done
- Recurring events — set an event to repeat on the days you choose
- Pick your own colours, fonts and spacing from a single design panel
- Dark mode — off, auto (follows the visitor's system preference), or always on
- Address autocomplete — start typing a venue and pick from suggestions; the location pin and details fill in for you
- One-click cache control whenever you need a fresh copy of your event list
[vieww_calendar_view]— the interactive month calendar[vieww_list]— a filterable list with date-range and pagination[vieww_calendar]— a 3-column grid of upcoming events[vieww_events_map]— a map of upcoming events with clustering
- WordPress 5.0 or higher
- PHP 7.4 or higher
安装:
- Upload the plugin files to
/wp-content/plugins/vieww-events-calendar/directory, or install through the WordPress plugins screen - Activate the plugin through the 'Plugins' screen in WordPress
- Go to Events → Add New to create your first event!
- Use shortcodes in your pages to display events
屏幕截图:
常见问题:
Do I need any other plugins?
No! The plugin is completely self-contained. It registers its own custom post type and creates native WordPress meta boxes for all event fields.
What fields are available for events?
When creating an event, you'll see two meta boxes: Event Details:
- Event Date (for one-off events)
- Event Time
- Event Description
- Event Image (via featured image sidebar) Recurring Event Settings:
- Recurring Days (checkbox for days of week)
- Recurring Start Date
- Recurring End Date
What shortcodes are available?
Grid/Card View:
[vieww_calendar]
Displays the next 9 upcoming events in a 3-column responsive grid.
List View:
[vieww_list per_page="10"]
Displays events in a list with date filters and pagination. The per_page parameter is optional (default: 10).
Calendar Month View:
[vieww_calendar_view show_images="yes"]
Displays an interactive month calendar with navigation. The show_images parameter is optional (default: yes).
How do I create a recurring event?
- Go to Events → Add New
- Leave the Event Date field empty in the Event Details box
- In the Recurring Event Settings box, check the days of the week
- Set the Recurring Start Date and Recurring End Date
- Fill in Event Time and Description
- Publish!
How do I create a one-time event?
- Go to Events → Add New
- Fill in the Event Date in the Event Details box
- Leave the Recurring Event Settings box empty
- Fill in Event Time and Description
- Publish!
Events aren't showing up, what do I do?
- Go to Events → Cache Settings in your WordPress admin
- Click "Refresh Event Cache"
- Alternatively, add
?refresh_events=1to any page URL
Does this work with cache plugins?
Yes! The plugin automatically clears popular cache plugins including:
- WP Fastest Cache
- WP Super Cache
- W3 Total Cache
- WP Rocket
Can I customize the styling?
Yes! The plugin includes a visual customization interface at Events → Design Settings. You can adjust:
- Colors (primary, accent, text, backgrounds)
- Typography (font families, sizes, weights)
- Spacing (padding, margins, gaps)
grid-view.css- Grid/card view styleslist-view.css- List view stylescalendar-view.css- Calendar view styles
How do I debug cache issues?
Add ?debug_cache=1 to any page URL to see cache status and contents (requires admin permissions).
更新日志:
2.4.4
- TESTED: Confirmed compatible with WordPress 7.0.
- NEW: WordPress.org listing now ships with screenshots — the interactive month calendar and a single event page. Screenshot captions rewritten to match.
- IMPROVEMENT: External Services section condensed to one line per service while keeping the required wp.org disclosure.
- IMPROVEMENT: Removed the Developer Notes section from the public listing — internal architecture detail isn't useful for site owners browsing the directory.
- IMPROVEMENT: Plugin description and listing rewritten to focus on what site owners and visitors get out of the calendar, rather than internal architecture.
- NEW: Plugin icon added.
- FEATURE: Structured location fields — split the single Location/Venue input into Venue Name, Street Address, Suburb, State, and Postcode for consistency with sibling Vieww plugins.
- FEATURE: Click-to-fill autocomplete — typing into Street Address shows Photon (komoot.io) suggestions; selecting one populates Suburb / State / Postcode / Latitude / Longitude in a single click. If Photon returns a named landmark and Venue Name is empty, the venue name is filled too (user-typed values are never overwritten).
- FEATURE: Geocoding now uses structured Nominatim queries from the new fields directly — more accurate and predictable than parsing a freeform string.
- FEATURE: Branded archive template (
archive-vieww-event.php) renders the calendar at/events/by default, with a friendly "No upcoming events" empty state when there's nothing to show — replacing the theme's generic "Sorry, but nothing was found" page. - IMPROVEMENT: Calendar prev/next/Today now swap the visible month in place instead of full-reloading the page, so embedding pages (e.g. Elementor canvases) keep their width and layout.
- IMPROVEMENT: Calendar nav uses replaceState rather than pushState — the browser back button returns to the page you came from, not through every month you visited.
- IMPROVEMENT: Default Dark Mode setting is now "Auto" (follows system preference) for new installs, with extra coverage for the event-time strip inside calendar event chips.
- FIX: Calendar prev/next URLs no longer leak between embedding pages. The cached HTML used to bake in the rendering page's URL, so a calendar embedded on one page could send visitors to another. URLs are now built from the current document at click time.
- FIX: Calendar buttons (prev/next/Today/filter) now follow the plugin's design-settings colour palette instead of inheriting Elementor's global accent/primary colours, which on some sites rendered the nav arrows green and the Today button blue.
- FIX: Addresses with both a unit keyword AND a slash (e.g.
Unit 5/123 Main St) no longer lose the street number during geocoding — coordinates resolve to the actual street, not the suburb centroid. - MIGRATION: Existing
event_locationvalues are best-effort split into Venue Name + structured address on first load. The original value is retained as a display fallback for entries that didn't parse cleanly.
- FEATURE: Event venue geocoding — automatically populates latitude/longitude from the Location/Venue field on save, with a fallback chain for Australian unit-style addresses
- FEATURE: "Geocode Now" button on the event edit screen for instant lat/lng preview with visible feedback
- FEATURE: Venue autocomplete via Photon (OpenStreetMap) — typeahead dropdown on the Location/Venue field, preserving user-typed unit prefixes and house numbers
- FEATURE: Single-event location map injected via
the_contentwhen an event has coordinates - FEATURE: New
[vieww_events_map]shortcode — renders all upcoming geocoded events on an interactive Leaflet map with clustering - IMPROVEMENT: New REST meta fields
event_latandevent_lngexposed via the WordPress REST API - IMPROVEMENT: Admin-only empty-state banner prompts editors to geocode listings when none yet have coordinates
- FEATURE: Frontend event search - filter list view events by title, description, or location
- FEATURE: Google Fonts integration - 15 Google Fonts available in Design Settings
- FEATURE: Dark mode support - off, auto (system preference), or always on
- FEATURE: Mobile swipe gestures - swipe left/right to navigate calendar months
- FEATURE: Gutenberg blocks - 3 server-side rendered blocks for the block editor
- FEATURE: REST API support - event meta fields exposed via WordPress REST API
- FEATURE: iCal export and Google Calendar integration
- FEATURE: AJAX calendar navigation for smoother month browsing
- FEATURE: Event modal popups with add-to-calendar links
- PERFORMANCE: Rendered HTML caching with version-counter invalidation
- PERFORMANCE: Per-request instance deduplication for recurring events
- SECURITY: Enhanced nonce verification and input sanitization throughout
- IMPROVEMENT: Admin meta box validation with real-time feedback
- IMPROVEMENT: Tabbed help documentation with persistent tab state
- IMPROVEMENT: Dismissable onboarding welcome page
- RELEASE: Initial WordPress.org release - Full-featured free version
- MAJOR: Removed ACF dependency - now completely self-contained with native WordPress meta boxes
- FEATURE: Recurring events - set events to repeat on specific days
- FEATURE: Design customization system with colors, typography, and spacing controls
- FEATURE: Three beautiful display views (grid, list, calendar)
- FEATURE: Mobile modal popups and calendar/list view toggle
- FEATURE: Getting started dashboard and help documentation
- SECURITY: Full nonce verification, input sanitization, and output escaping
- SECURITY: WordPress 6.9 compatibility and coding standards compliance
- PERFORMANCE: Advanced caching system with transient storage
- PERFORMANCE: Iteration safeguards to prevent infinite loops
- Complete plugin restructure with organized class files, separated CSS, and i18n support
- Added calendar month view
- Improved caching system
- Added admin interface for cache management
- Performance optimizations
- Initial release
- Grid and list views
- Basic caching functionality