A professional, self-contained events calendar plugin with recurring events, design customization, and mobile-optimized views.
Vieww Events Calendar is a professional, self-contained WordPress plugin for managing and displaying events. No external dependencies required! Built with performance in mind, it features advanced caching, multiple display options, and native WordPress meta boxes.
Key Features:
-
Three Beautiful Display Views:
- Grid/Card View – Responsive 3-column grid showing upcoming events
- List View – Filterable list with date range selection and pagination
- Calendar View – Interactive month calendar with navigation
-
Recurring Events: Set events to repeat on specific days of the week automatically
-
Design Customization: Full control over colors, fonts, and spacing to match your brand
-
Mobile Optimized: Enhanced mobile experience with event detail modals and calendar/list toggle
-
Performance Optimized: Advanced caching system with transient storage
-
Self-Contained: Native WordPress meta boxes – no external plugins needed
-
Cache Management: Built-in admin interface for cache control
-
Developer Friendly: Clean, well-documented code following WordPress standards
Requirements:
- WordPress 5.0 or higher
- PHP 7.4 or higher
That’s it! No external plugins or dependencies required.
Developer Notes
File Structure:
vieww-events-calendar/
├── vieww.php (Main plugin file)
├── includes/
│ ├── class-vieww-post-type.php (CPT, REST API, Gutenberg blocks)
│ ├── class-vieww-meta-boxes.php (Native meta boxes with validation)
│ ├── class-vieww-core.php (Caching, event instances)
│ ├── class-vieww-shortcodes.php (Grid, list, calendar shortcodes)
│ └── class-vieww-ical.php (iCal export, Google Calendar)
├── admin/
│ ├── class-vieww-admin.php
│ ├── class-vieww-design-settings.php (Colors, fonts, dark mode)
│ ├── class-vieww-welcome.php
│ └── class-vieww-help.php
├── assets/
│ ├── css/
│ │ ├── grid-view.css
│ │ ├── list-view.css
│ │ ├── calendar-view.css
│ │ └── admin-modern.css
│ └── js/
│ ├── modal.js (Event modals, swipe gestures)
│ ├── calendar-ajax.js (AJAX calendar navigation)
│ ├── admin-meta-boxes.js
│ ├── admin-welcome.js
│ └── admin-help.js
└── uninstall.php
Hooks:
Action: vieww_events_uninstall – Fired when plugin is uninstalled
Functions:
Vieww() – Returns main plugin instance
Cache Key:
The plugin uses transient key vieww_cached_events_v6 for caching events, plus versioned HTML cache transients.
Support
For support, please use the WordPress.org support forums for this plugin.
FAQ
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=1 to 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)
You can also override styles by adding custom CSS to your theme. The plugin uses separate CSS files for each view:
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).
ChangeLog
2.2.0
- 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
2.1.1
- 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
2.0.0
- Added calendar month view
- Improved caching system
- Added admin interface for cache management
- Performance optimizations
1.0.0
- Initial release
- Grid and list views
- Basic caching functionality
