=== Happenly ===
Contributors: symelo
Requires at least: 7.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A vibrant what's-on events theme: big date blocks, gradient posters, a weekend strip, scroll-snap rails, ticket buttons and venue pages.

== Description ==

Happenly is a block theme for city what's-on guides, venue networks, festival programmes and community calendars. It is dark by default (midnight ground, signal coral, electric blue and sun yellow) with a Daytime scheme one click away, and it behaves like a wall of posters: oversized Epilogue type, big date blocks, sticker tags and scroll-snap rails.

Built in, with no plugins:

* Events and venues with typed details: category, area, tags (free, family friendly, outdoor, accessible), start and end dates, price, ticket button, address and map (loaded only after a click), galleries and a live "Ended" state.
* Search and filters: category, area, tags, price and sort orders, soonest first by default so past events sink.
* A weekend hero with the next Friday to Sunday, a day strip, a date ticker, a poster grid, a featured event with its date block, a venue spotlight and a hero with a background video and a pause button.
* A designed event page: big date block, photo mosaic with lightbox, ticket card, where and when facts, map and organiser form.
* Category and area pages with a banner and icon.
* About 30 patterns: heroes, rails, lists, galleries (masonry and carousel), forms (contact, newsletter), FAQ, stats, testimonials, footers and full pages.
* Forms with a Messages screen, motion classes, galleries and lightbox, featured video, light and dark schemes (the Symelo Theme Kit).
* Three style variations: Daytime, Festival and Jazz club.

The event details are edited with the free Secure Custom Fields plugin; the theme offers to install it. Listings already show before it is installed.

== Frequently Asked Questions ==

= Where do form messages go? =

Contact and newsletter forms are stored under Messages in the dashboard and emailed to the site's admin address. Change the recipient under Messages → Settings, or per form in the block's settings.

= How do I add an event? =

Go to Events → Add New. Set the category, area and tags in the sidebar, and fill the details (dates, price, ticket link, photos) in the event details box. Appearance → Import demo installs a sample guide to start from.

= How are past events handled? =

The default order is soonest first. An event that has finished gets an "Ended" label and is hidden from the soonest-first list.

= Can I use a light design? =

Yes. Visitors can switch with the sun and moon button in the header, and Appearance → Editor → Styles offers the Daytime, Festival and Jazz club variations.

= Can I turn animations off? =

Visitors who prefer reduced motion see no animations and the background video starts paused; everyone else can pause it with the button in its corner.

== Changelog ==

= 1.0.0 =
* First release.

== Copyright ==

Happenly WordPress Theme, (C) 2026 Symelo LTD. Happenly is distributed under the terms of the GNU GPL.

== Resources ==

* Symelo Theme Kit and the Symelo directory foundation: (C) 2026 Symelo LTD, GPLv2 or later.
* Epilogue: (C) 2020 The Epilogue Project Authors, SIL Open Font License 1.1 (assets/fonts/epilogue/OFL.txt), https://fonts.google.com/specimen/Epilogue
* Instrument Sans: (C) 2022 The Instrument Sans Project Authors, SIL Open Font License 1.1 (assets/fonts/instrument-sans/OFL.txt), https://fonts.google.com/specimen/Instrument+Sans
* Lucide icons (in the directory foundation): ISC License, https://lucide.dev (inc/foundation/LICENSE-lucide.txt).
* Tabler Icons ("dental", used as the tooth icon; in the directory foundation): MIT License, https://tabler.io/icons (inc/foundation/LICENSE-lucide.txt).
* Images: Symelo placeholder library (https://dev.symelo.com/tools/placeholder-images), (C) 2026 Symelo LTD, distributed with the theme under the GPLv2 or later: assets/images/abstract-5.webp (abstract-5), assets/images/abstract-10.webp (abstract-10), assets/images/pulse-poster.webp and assets/video/pulse-loop.mp4 (a slow pan made from abstract-5); foundation images inc/foundation/demo/images/: cafe.webp (interiors-8), bakery.webp (food-12), trattoria.webp (food-4), guesthouse.webp (interiors-4), cowork.webp (workspace-8), ceramics.webp (workspace-6), spa.webp (interiors-7), gallery.webp (architecture-12), old-town.webp (travel-9), harbour.webp (travel-5).
