PHPackages mercator/wn-calendar-plugin - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. mercator/wn-calendar-plugin ActiveWinter-plugin[Utility & Helpers](/categories/utility) mercator/wn-calendar-plugin =========================== Calendar Plugin for Winter CMS Block. 1602[1 PRs](https://github.com/helmutkaufmann/wn-calendar-plugin/pulls)HTML Since May 27Pushed 1mo agoCompare [ Source](https://github.com/helmutkaufmann/wn-calendar-plugin)[ Packagist](https://packagist.org/packages/mercator/wn-calendar-plugin)[ RSS](/packages/mercator-wn-calendar-plugin/feed)WikiDiscussions main Synced today READMEChangelogDependenciesVersions (1)Used By (0) Calendar Plugin for Winter CMS Block ==================================== [](#calendar-plugin-for-winter-cms-block) A flexible and robust plugin for managing and displaying calendars and events on your Winter CMS website. This plugin provides a full backend interface for managing multiple calendars and their entries, and includes a powerful, configurable frontend block for easy display. --- Features -------- [](#features) - **Core Functionality** - Manage multiple, distinct calendars. - Create detailed calendar entries with a title, optional summary, HTML description, an optional featured image, a specific start and optional end time, location, and timezone. - Control event visibility with `published_from` and `published_to` dates. - **Backend Management** - Dynamic side navigation menu that lists all created calendars for easy filtering of the entries list. - Default sort order for entries is descending by start date, showing the newest events first. - A "Purge" function on the calendar update page to easily delete old events before a specified date. - **Powerful Frontend Block** - A single, versatile block to display your calendar on any Winter CMS Static Page. - **Dual Display Views**: - **List View**: A collapsible accordion-style list where each individual event is its own item. - **Grid View**: A traditional monthly calendar grid. - **Interactive UI**: - In Grid View, click on an event to see its full details in a popover card. - In List View, the accordion title shows the date, event title, and summary. The expanded content shows full details. - The accordion can be configured to start with all items expanded and to allow multiple items to be open simultaneously. - **Multi-lingual Support**: All dates, times, and weekday names are automatically translated based on the active locale (requires the Winter.Translate plugin). - **Calendar Feeds** - **iCal Subscription**: Each calendar provides a `webcal://` subscription link, allowing users to subscribe to the entire calendar in applications like Outlook, Google Calendar, or Apple Calendar. - **Single Event Download**: Each event can have an "Add to Calendar" icon to download an `.ics` file for just that single event. - **RSS Feed**: Each calendar automatically generates a standard RSS feed for syndication in news readers. --- Installation ------------ [](#installation) 1. Run `composer require mercator/wn-calendar-plugin` 2. Run the database migrations: ``` php artisan winter:up ``` --- Block Configuration ------------------- [](#block-configuration) When you add the "Calendar" block to a page, you have the following settings available: SettingDescription**Calendar**Selects which calendar's events to display. This is required.**Display View**Choose between the `List View` (accordion) and `Grid View` (monthly calendar).**Feed Button Alignment**Choose the alignment (`left`, `center`, `right`) for the 'Subscribe' button, or hide it (`Not Shown`).**Show 'Add to Calendar' button**If checked, each event will have its own download button in the detailed view.**Start with all days expanded**(List View only) If checked, all accordion items will be open by default.**Limit displayed events**(List View only) If specified, only this many events will be shown from within the calculated date range.**Start Date**The date to start displaying events from. If left blank, it defaults to the current day or month.**Months to Show**The number of months of events to display from the start date.--- Feed URLs --------- [](#feed-urls) The plugin generates feed URLs based on the slug of the calendar you create in the backend. - **iCal Subscription**: `https://your-domain.com/mercator/calendar/ical/{slug}.ics` - **RSS Feed**: `https://your-domain.com/mercator/calendar/rss/{slug}` Components vs Blocks -------------------- [](#components-vs-blocks) The plugin exposes both **components** and **blocks** so you can choose the pattern that fits your site structure. - **Components** are added directly to CMS pages or layouts with the `{% component %}`tag. They are the right choice when your URL structure is dynamic (e.g. `/event/:id`) or you need to access the component from within page logic. Components are configured on the page marked-up file and accept URL parameters as defaults. - **Blocks** appear in the Winter CMS block picker and behave like reusable snippets that can be dragged onto any static page or layout. Use blocks when you want editors to place prebuilt calendar pieces without editing the page markup itself. Blocks still expose the same variables in the rendered page, so the Twig you write to display them is identical to what you'd use inside a component. Both the full calendar view and the single-entry view are available as either a component or a block: - `Calendar` component / block — shows a list or grid of events from one calendar. When added to a page as a component you configure the calendar ID and display options in the page file; as a block you use the designer's block picker and set the same options via the block properties panel. - `Calendar Entry` component / block — renders details for one specific event (see below). ### Example: full calendar component usage [](#example-full-calendar-component-usage) ``` url = "/calendar" == title = "Upcoming events" layout = "default" [calendarComponent] calendar_id = 3 view = "list" showEventIcsButton = 1 buttonAlignment = "left" startDate = "2026-03-01" monthsToShow = 2 ``` ### Example: full calendar block [](#example-full-calendar-block) Simply drop the **Calendar** block in the CMS designer on any static page or layout. The property names are identical, so the settings shown in the editor mirror those available for the component (calendar selection, view type, feed button alignment, etc.). The underlying HTML/Twig that renders the calendar is shared between the two; using a block just gives you a visual placeholder in the layout editor and avoids manual Twig markup. You can mix and match: for example, the calendar block on your homepage and an entry component on an `event` detail page. Individual Event Pages ---------------------- [](#individual-event-pages) A new `Calendar Entry` component is available to render the details of a single event. It expects an `entryId` property (usually supplied via a URL parameter) and exposes an `entry` page variable containing the model instance. Example CMS page setup: ``` url = "/event/:entry_id" == title = "Event details" layout = "default" [calendarEntryComponent] entryId = "{{ :entry_id }}" showEventIcsButton = 1 ``` ### Block for Static Pages [](#block-for-static-pages) If you prefer to use the feature as a reusable **block** instead of a component, a `Calendar Entry` block is also provided. It has the same options but renders via the page designer's block picker and can be placed on any static page or layout. Fields available: - **Entry** – recordfinder dropdown listing published entries by title. - **Show 'Add to Calendar' button** – toggle the ICS download link. The block will expose the same `entry` and `icsUrl` variables in the page context. Example usage in a layout's markup is identical to the component above. And in the page markup you can reference the entry: ``` {{ entry.title }} {{ entry.start_datetime|date("l, F jS, Y g:i A") }} ``` The component will also include an `icsUrl` variable when the `showEventIcsButton` option is enabled, linking to the existing `/mercator/calendar/ical/event/{id}.ics` route. ### Health Score 23 — LowBetter than 26% of packages Maintenance61 Regular maintenance activity Popularity13 Limited adoption so far Community4 Small or concentrated contributor base Maturity11 Early-stage or recently created project How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/2d4325040b5bcb235cf0f7555ec5b28498935f54c74bb90c3b2828461598500d?d=identicon)[mercator](/maintainers/mercator) ### Embed Badge ![Health badge](/badges/mercator-wn-calendar-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/mercator-wn-calendar-plugin/health.svg)](https://phpackages.com/packages/mercator-wn-calendar-plugin) ``` ### Alternatives [fojuth/readmegen Readme file / doc generator. It uses VCS logs as a source of information. 6139.2k1](/packages/fojuth-readmegen)[davidanderson684/simba-plugin-manager-updater This class is an updates checker and UI for WordPress plugins that are hosted using the Simba Plugin Manager plugin 2753.8k](/packages/davidanderson684-simba-plugin-manager-updater)[in2code/ipandlanguageredirect Redirects TYPO3 visitors automatic or with a suggestlink to another language and/or root page. 1443.0k](/packages/in2code-ipandlanguageredirect)[steevanb/php-collection Add IntCollection, StringCollection, ObjectCollection etc. 1633.2k1](/packages/steevanb-php-collection)[webcraft/laravel-random Laravel wrapper around paragonie/random-lib 1011.3k](/packages/webcraft-laravel-random) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)