MF Event

A lightweight WordPress plugin that renders an agenda-style list of upcoming events through a single shortcode. Built for school / institution calendars that mix two kinds of dates:

• Recurring dates that fall on the same day every year (most Gregorian dates, e.g. First Day of School).
• Year-specific dates that shift each year and you update annually (Hijri / religious days like Ramadan, Eid, Mawlid).

The output inherits the active theme's typography and adapts to the surrounding text colour, so it looks native on almost any theme without configuration.

Features

• 📅 One shortcode — [mf_event] (alias [mf_events]), drop it anywhere.
• 🎛️ Five display styles — Classic, Cards, Grid (pastel boxes, 3-up, month-grouped), Editorial (month-grouped hairline rows), or Timeline (vertical line with dots). Chosen in settings or per shortcode via style="…".
• 🔁 Recurring & one-off dates — leave the year empty to repeat yearly, or set a year for shifting religious dates that auto-expire after they pass.
• 📝 Event details in a pop-up — write rich content in the normal editor; if filled, the card opens an in-page modal (no separate page). Accessible (keyboard, Esc, focus-trap) and dark-mode aware.
• 🖼️ Event poster — set a Featured image and it shows at the top of the pop-up.
• 🔗 Related links — connect an event to existing pages/posts on your site (stored by ID, so links stay valid even if the URL changes) or to any custom URL; shown as clickable links inside the pop-up.
• 🎨 Custom event types — colour-coded accents, fully manageable from the admin, with auto-contrasting badges.
• 🟢 "Today" highlight — events happening today get their own emphasized boxes.
• 📆 Multi-day events — optional end date, including year-spanning ranges (e.g. Dec 25 – Jan 3).
• 🌍 Translation-ready — ships with Turkish (tr_TR) and Dutch (nl_NL) out of the box, plus a .pot template for any other language.
• 🧩 Theme-friendly CSS — typography via inherit, colours via currentColor/color-mix with safe fallbacks.
• 🪶 Lightweight — one PHP file, one small CSS file, and one tiny vanilla-JS file (loaded only where the shortcode runs). No libraries.
• ⬆️ One-click sample data and a legacy importer (from the older isabet-events plugin).

Installation

1. Copy the mf-event folder into wp-content/plugins/.
2. Activate MF Event in Plugins.
3. Add events under MF Events → Add Event, or click Load sample events on first run to start from a ready-made academic calendar.
4. Place [mf_event] on any page, post, or page-builder text/HTML element.

Usage

[mf_event]

Shortcode parameters

Parameters can be combined, e.g. [mf_event title="This Year" months="12" limit="10"].

Display styles

Pick the default look under MF Events → Settings → Display style, or override per shortcode with style="…":

• classic — the original look: full-width rows on a neutral surface with a thin coloured accent stripe on the left.
• cards — coloured cards with a filled date tile and a soft type-colour wash. Warm and inviting. (default)
• grid — soft pastel boxes, three per row, grouped by month, washed in the type colour with the date as a corner badge.
• editorial — calm hairline rows grouped by month, type shown as a small label. Clean and premium.
• timeline — a vertical line with a coloured dot per event, grouped by month. Calendar feel.

All styles inherit the theme font, auto-contrast their badges, and stay responsive/accessible.

How dates work

• No year on an event → it repeats the same day every year.
• A year set → a one-off date for that specific year; once it passes it drops off automatically — add next year's entry to keep it visible.
• The list is ordered relative to today, which uses your site's timezone (Settings → General → Timezone).

Details, poster & related links

When editing an event:

• Details — type into the main content editor. If it has content, the front-end card becomes clickable and opens an in-page pop-up showing it. Empty editor = plain non-clickable card.
• Poster — set a Featured image; it appears at the top of the pop-up.
• Related links — in the Related Links box, add rows that either point to a page/post on your site (chosen from a dropdown — stored by ID so the link survives slug changes) or to a custom URL. They render as a clickable list inside the pop-up.

The pop-up is keyboard-accessible: Enter/Space opens it, Esc or the overlay closes it, and focus is trapped while open and restored on close.

Event types

Each type has a colour used as the card's left-accent. Manage them under MF Events → Settings:

You can add, rename, recolour, or delete types. A type's slug (used in type="…") is generated from its name on creation and is fixed afterwards so existing events keep working.

Translations / i18n

Text domain: mf-event — translations live in /languages.

To add another language, copy languages/mf-event.pot to mf-event-<locale>.po, translate, and compile:

msgfmt mf-event-<locale>.po -o mf-event-<locale>.mo

WordPress loads the file matching the active site/user locale automatically.

File structure

mf-event/
├── mf-event.php              # plugin (CPT, meta boxes, settings, shortcode, renderer)
├── assets/
│   ├── mf-event.css          # front-end styles (theme-inheriting) + modal
│   └── mf-event.js           # vanilla-JS accessible detail modal
├── languages/
│   ├── mf-event.pot          # translation template
│   ├── mf-event-tr_TR.po/.mo # Turkish
│   └── mf-event-nl_NL.po/.mo # Dutch
└── README.md

Requirements

• WordPress 5.0+ (tested with the timezone & wp_date() APIs)
• PHP 7.4+ (uses arrow functions and DateTime)

License

GPL-2.0-or-later. See LICENSE.