=== Super Advent Calendar ===
Author: Verdant Studio
Author URI: https://www.verdant.studio
Contributors: verdantstudio, robertverdant
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires at least: 6.6
Requires PHP: 7.4
Stable tag: 1.24.0
Tags: advent calendar, christmas, giveaway, countdown, holidays
Tested up to: 7.1

Advent calendar block for daily giveaways, discount codes and holiday countdowns, with doors that stay locked until their day.

== Description ==

= WordPress Advent Calendar Plugin =

Give your website a festive touch with Super Advent Calendar — a flexible, customizable advent calendar for holiday giveaways or seasonal countdowns. Choose from pre-built themes or build your own, configure each door’s content individually, and delight visitors with built-in animations and special effects.

Want your own images, more animations and confetti or snowfall when a door opens? [Have a look at Premium](https://www.verdant.studio/plugins/super-advent-calendar/#pricing).

= Perfect for =

* Shops sharing a daily discount code or giveaway in December
* Growing your newsletter by putting a sign-up form behind a door
* Schools, churches and communities counting down to Christmas
* Easter, New Year or any other countdown to an event

== Free Features ==

* Door count: control how many doors your calendar has
* Layout: customize with grid columns and rows
* Animations: reveal doors with a flip or an open door animation
* Themes: choose a festive default theme or design your own
* Schedule: control when doors can be opened, preview on a specific date, schedule all at once or per door, shift all dates for next year
* Content: add content such as text, links or embeds (via shortcodes)
* Appearance: open a link, a modal, or display content inline
* Styles: change typography, padding, colors and dimensions for each slot
* Locked content: each door reveals on its scheduled date; past and future doors stay hidden

== Premium Features ==

Make the calendar truly yours and give visitors a reason to come back every day.

* Images: put your own photos, illustrations or product shots on the doors
* Animations: 8 additional revealing animations, such as slide in, slide up/down, rotate into view and fade and skew
* Special effects: confetti (classic, Christmas, Easter or New Year) or snowfall, triggered when a door is opened
* Save state: doors visitors opened stay open on their next visit, so the calendar fills up day by day
* Premium support

[**Learn more about the Premium version.**](https://www.verdant.studio/plugins/super-advent-calendar/#pricing)

== Translation Ready ==

Speak another language? You can help make Super Advent Calendar available in your language! Join our [translation project](https://translate.wordpress.org/projects/wp-plugins/super-advent-calendar/) on WordPress.org and contribute to translating the plugin for the global community.

== Documentation ==

You can find the [documentation](https://www.verdant.studio/plugins/super-advent-calendar/) on our site.

== Installation ==

1. Upload `super-advent-calendar` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to any post or page and search for the 'Advent Calendar' block.

== Screenshots ==

1. Create an Advent Calendar
2. You can also show content in a modal
3. Choose an animation, schedule all doors at once and preview the calendar on a specific date
4. Select a default style or create your own
5. Add and schedule content to unlock at a certain date/time
6. Change colors, typography and dimensions per door
7. Super Advent Calendar Premium lets you add images to personalize the calendar
8. Super Advent Calendar Premium also lets you choose from special effects
9. Use shortcodes in door content to embed forms and other dynamic elements

== Frequently Asked Questions ==

= Where can I find the documentation? =

You can find the documentation at: [verdant.studio/plugins/super-advent-calendar](https://www.verdant.studio/plugins/super-advent-calendar/ "Super Advent Calendar Documentation")

= Does this plugin work with Divi, Elementor, and other page builders? =

Yes, while the Super Advent Calendar plugin is designed as a Gutenberg block, you can use it with page builders such as Divi, Elementor and WPBakery. For detailed instructions, check out our [page builder documentation](https://docs.verdant.studio/super-advent-calendar/#page-builders "Page builder Documentation").

= Can visitors peek at future doors? =

No. The content of a door is only loaded once its scheduled date has arrived, so it can't be found in the page source beforehand. That makes it safe to hide discount codes and giveaways.

= Can I reuse my calendar next year? =

Yes. Shift all door dates at once by a number of days and your calendar is ready for the next season.

= Does it work with page caching? =

Yes. Doors keep opening on the right day, even when the page is served from a full page cache.

= Can I use it for something other than Christmas? =

Yes. Choose any number of doors and any dates, for example for Easter, a New Year countdown or an event launch.

= Can I upgrade to Premium later? =

Yes. Your existing calendars keep working as they are, and the Premium options become available as soon as you upgrade.

= Do you like the plugin? =

We'd love to hear from you! A [review on WordPress.org](https://wordpress.org/support/plugin/super-advent-calendar/reviews/#new-post) helps others find the plugin and keeps us motivated to improve it.

== Changelog ==

= 1.24.0: Oct 24, 2026 =

- Add: add an open door revealing animation
- Change: remove the arrow from the locked door tooltip
- Fix: quote the data attributes of a door so values containing spaces don't break the json

= 1.23.0: Oct 20, 2026 =

- Add: schedule all doors at once and shift all dates by a number of days, e.g. to reuse a calendar next year
- Add: preview the calendar on a specific date (only for users who can edit the calendar)
- Add: `superac_shortcode_content` and `superac_can_view_calendar_post` filters
- Add: editor side feedback on specific changes made
- Fix: doors continue to work on pages served from a full page cache
- Fix: superac shortcode can only request door content of public and published posts
- Fix: a calendar embedding itself through the shortcode crashed the page
- Fix: multiple calendars embedded through the shortcode on one page use the correct doors

= 1.22.1: Oct 8, 2026 =

- Change: update dependencies
- Fix: script error instead of fallback text when a card has no content
- Fix: "Invalid URL" message for link cards could not be translated

= 1.22.0: Jun 11, 2026 =

- Change: remove custom autoloader, use default
- Change: improve schedule start/end comparison
- Change: improve code and script loading fallbacks
- Change: update dependencies

= 1.21.1: May 6, 2026 =

- Change: update dependencies
- Fix: Tailwind (preflight) CSS unscoped on pages loading the calendar

= 1.21.0: Apr 7, 2026 =

- Add: 22 additional festive background styles/patterns (making a total of 25)
- Change: upgrade Tailwind from v3 to v4 and rewrite parts of the CSS
- Change: improve the way scripts are loaded
- Change: test with WordPress 7.0 and update support
- Change: update dependencies
- Fix: grid resizing on the editor view

= 1.20.2: Dec 1, 2025 =

- Change: test with WordPress 6.9 and update support

= 1.20.1: Nov 26, 2025 =

- Change: update dependencies
- Fix: broken links in readme documentation
- Fix: grid should now autofill on smaller screens
- Fix: make superac-day selector more specific

= 1.20.0: Nov 16, 2025 =

- Change: use custom DI container and remove dependency to external DI container
- Change: update dependencies
- Fix: prevent locked door with href from scrolling up the page
- Fix: enforce no margin on superac day class on the editor

= 1.19.1: Oct 12, 2025 =

- Change: update dependencies
- Fix: load just one canvas element, improves performance on large calendars

= Earlier versions =

For the changelog of earlier versions, please refer to [the changelog on verdant.studio](https://docs.verdant.studio/super-advent-calendar/#changelog).
