Vieww Events Calendar – Recurring Events, Event Map & Calendar Plugin
| 开发者 | jarradnpd |
|---|---|
| 更新时间 | 2026年7月21日 08:06 |
| 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.
Venue maps are included and work the day you install: they run on OpenStreetMap, so there's no Google account to create, no API key to paste in, and no billing setup. Start typing a venue address and it completes itself — the pin lands on the map for you.
See the live demo · Documentation
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 a Google Maps API key?
No. The events map runs on OpenStreetMap and works as soon as you activate the plugin. There's no Google account to create, no API key to paste in, and no billing setup.
Do I need any other plugins?
No. Everything the calendar needs — events, recurring rules, views, maps and add-to-calendar links — ships in this one plugin. It works with any theme.
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!
Does this work with cache plugins?
Yes. The plugin keeps your calendar fast even with hundreds of events, and automatically refreshes itself when you publish or edit an event — including clearing WP Rocket, W3 Total Cache, WP Super Cache and WP Fastest Cache. If you ever want to force a fresh copy, Events → Cache Settings has a one-click refresh.
Can I customize the styling?
Yes. The plugin includes a visual customization interface at Events → Design Settings — colours, typography and spacing, with a live preview. Developers can also override styles with custom CSS; each view ships its own stylesheet (grid-view.css, list-view.css, calendar-view.css).
What happens to my data if I remove the plugin?
It's yours. Everything lives in your own WordPress database, and deleting the plugin removes its data cleanly — no orphaned tables left behind. Deactivating (rather than deleting) keeps all your data intact.
更新日志:
2.5.0
- NEW: Monthly recurring events — repeat on a chosen day of the month (for example, the 13th of every month). Months that don't have that day, such as the 31st in February, are skipped.
- NEW: Monthly events can also repeat on a weekday pattern — for example the second Tuesday, or the last Friday, of every month.
- NEW: Recurring events can repeat every few months (for example every second month), not only every month.
- NEW: Recurring events now take a start and end time. Set it once and the time shows on every occurrence across the list, calendar and single-event views.
- IMPROVEMENT: The event editor has a new "Repeats" control — Does not repeat, Weekly, or Monthly — so one-off and recurring events are clearer to set up.
- NEW: Designed single-event pages — each event now has its own styled layout with the date and time, a plain-language recurrence summary ("the second Tuesday of every month"), the next upcoming dates, an add-to-calendar button, venue details and a location map. Copy single-vieww-event.php into your theme to customise.
- FIXED: Design settings (colours, fonts, spacing) now apply on the front end. Previously they were saved in the admin but never rendered on the site; the calendar, list, grid and single views all follow your design page now.
- FIXED: Dark Mode stays readable on light themes. The calendar, list, grid and single-event views now sit on their own dark background, so text and buttons no longer wash out when Dark Mode is On — or Auto with the visitor's device in dark mode.
- IMPROVEMENT: WordPress.org listing rewritten — live demo and documentation links, Vieww-suite cross-links, Google-Maps-API-key and data-ownership FAQs, benefit-led short description. Troubleshooting/debug FAQ content moved to the documentation site.
- 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