Calendora Banners
| 开发者 | goldenpixel |
|---|---|
| 更新时间 | 2026年10月15日 22:17 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv3 or later |
| 版权网址: | 版权信息 |
详情介绍:
Calendora Banners manages promotional banners on a schedule, so you do not have to edit the homepage before every occasion.
You set a campaign once: the content, the images, the buttons and the dates. The plugin decides what is on air. A Valentine's Day banner can start fourteen days before the date and stop on the day itself. When nothing seasonal is running, an evergreen campaign takes the slot instead.
Seasonal and evergreen campaigns never mix. A seasonal campaign always wins; evergreen ones are the fallback for the quiet days between them. When several seasonal campaigns overlap, they rotate in a slider.
The plugin makes no external requests. It sets no cookies, collects no statistics and sends nothing anywhere. The name-day calendar and the font are bundled with the plugin and read locally.
How it works
- Add a campaign and choose whether it recurs every year on a fixed date, or runs once between two dates.
- Set how many days before the event it should start, and how many days after it should stop.
- Add desktop and mobile images, up to two call-to-action buttons, and the text.
- Place the banner with the
[caleba_banners]shortcode, or drop the Calendora Banners widget into an Elementor layout.
安装:
- Upload the plugin and activate it.
- Open Calendora Banners in the WordPress admin menu.
- Review the starter campaigns that were created for you, and edit the ones you want to keep.
- Add your own images and button links.
- Place
[caleba_banners]on a page, or add the Calendora Banners widget in Elementor.
屏幕截图:
常见问题:
Do I need Elementor?
No. Elementor is optional. The shortcode works on its own, and the plugin does not fail if Elementor is absent. If Elementor is installed, an extra widget becomes available with its own layout and styling controls.
Does the plugin send any data anywhere?
No. It makes no external HTTP requests, loads no external fonts or scripts, sets no cookies and collects no analytics. The name-day data and the font are bundled with the plugin.
What happens when two campaigns overlap?
They rotate in a slider. You set the maximum number of banners shown at once in the settings.
Why does my evergreen campaign not appear?
Because a seasonal campaign is running. Evergreen campaigns are a fallback for the days when nothing seasonal is scheduled; they never appear alongside a seasonal campaign. You can also switch the fallback off entirely in the settings.
How do I show today's name days in a heading?
Write either form in the content:
Today we celebrate {today_names}
or
Today we celebrate [caleba_today_names]
Both produce the same result, for example "Today we celebrate Teresa i Jadwiga". The curly token is the safer choice inside Elementor and page builders, because some widgets and theme headings do not run shortcodes on their fields - there you would otherwise see the shortcode name instead of the names.
The same applies to {tomorrow_names}, {day_plus_2_names} and {day_plus_3_names}.
Nothing is written to the database: the replacement happens while the page is rendered.
Can I use the name-day calendar without the banners?
Yes. The four name-day shortcodes return just the names, with no markup, so you can place them in any page, post or text widget.
Will uninstalling delete my campaigns?
Not unless you ask it to. By default the plugin keeps your data when you delete it. There is a setting, "Delete all plugin data on uninstall", which you have to switch on yourself if you want a clean removal.
Is the plugin translated?
The interface is in English and ships with a Polish translation. The name-day calendar itself is Polish data.
更新日志:
1.6.5
- Fixed: the name-day banner disappeared whenever a seasonal campaign was running. It is stored as an evergreen campaign, and evergreen campaigns step aside for seasonal ones - but the name-day banner shows the day's names, not a promotion, so it should stay.
- Name-day campaigns now remain active alongside seasonal campaigns, and they are no longer affected by the evergreen fallback setting or by the maximum number of banners. Those two settings now apply only to promotional campaigns.
- Ordinary evergreen campaigns are unchanged: they still step aside for seasonal campaigns and still follow both settings.
- Added: name-day tokens and shortcodes are now resolved in normal WordPress content and in rendered Elementor widget output. Write
{today_names},{tomorrow_names},{day_plus_2_names}or{day_plus_3_names}, or the matching[caleba_today_names],[caleba_tomorrow_names],[caleba_day_plus_2_names]and[caleba_day_plus_3_names]shortcode, in page and post content, in a text widget or in an Elementor widget. - The curly tokens are the safer choice in Elementor and in page builders: some widgets and theme headings do not run shortcodes on their fields, and there the shortcode name would be shown as plain text instead of the names.
- Nothing is written to the database. The replacement happens while the page is rendered, only in visible text: scripts, styles, HTML comments and element attributes are left untouched, and no third-party shortcodes are executed.
- The name-day data is unchanged and the four shortcodes keep working exactly as before, in every place they already worked. The remaining campaign tokens (
{date},{day_month},{today_names_short},{tomorrow_date}) stay campaign-only on purpose, because they only make sense inside a banner.
- Improved WordPress.org coding standards compliance.
- Added consistent plugin-specific prefixes for public identifiers and stored data. Existing campaigns, settings, name-day overrides, test mode and evergreen order are migrated automatically on the first admin page load after the update.
- Shortcodes are renamed and the old names no longer work. The banner shortcode is now [caleba_banners], and the name-day shortcodes are [caleba_today_names], [caleba_tomorrow_names], [caleba_day_plus_2_names] and [caleba_day_plus_3_names]. Update any page that used the previous names.
- Hardened output escaping throughout the admin interface.
- Removed redundant manual translation loading.
- Updated the public package to rely on WordPress.org translation delivery.
- Corrected the feature list: the plugin imports campaigns from JSON and lets you download the bundled starter file, but it does not export existing campaigns.
- Preserved existing campaign scheduling, slider, name-day, Test Mode and Elementor behaviour.
- Fixed: when a toggle switch was turned on, the knob jumped three pixels upwards and stuck out above the switch, so the control looked misaligned. Off state was fine. The cause was a rule in WordPress core's own admin stylesheet that the plugin was not overriding in the checked state.
- Fixed: the knob also stopped a few pixels short of the right edge when switched on. It now travels the full distance.
- Added a browser-based test that measures the switch geometry in both states, so this cannot come back unnoticed.
- Fixed: turning on "Use theme colors for navigation" still showed the arrows in the plugin's own colours. The theme mode now declares no colours at all, so your theme's button styling finally applies.
- Fixed: the slider dots kept hard-coded colours in both modes. They now follow the selected mode like the arrows and the pause control.
- Fixed: vertical alignment of the toggle switches in settings rows, this time without depending on a container property a more specific rule can override.
- Fixed: added breathing room between the "Save settings" button and the Test mode section below it.
- Neutral mode, mobile behaviour, keyboard access, ARIA labels and reduced-motion handling are unchanged.
- Fixed: slider arrows and the pause control picked up colours from the active site theme. Theme button rules are more specific than the plugin's own, and the admin preview has no theme stylesheet, which is why the preview looked right and the front end did not.
- Navigation now has its own neutral styling, scoped to the banner so a theme cannot override it.
- Added a setting, "Use theme colors for navigation", off by default, for people who want the theme to style the arrows and pause control.
- Fixed spacing of the save button in Test Mode and on the Name days screen.
- Fixed vertical alignment of the toggle switches in settings rows.
- Mobile behaviour, keyboard access, ARIA labels and reduced-motion handling are unchanged.
- Renamed the product to Calendora Banners. The technical prefixes, the post type and the
[smart_campaigns]shortcode are unchanged, so existing pages keep working. - Security: call-to-action links are now escaped as URLs, so schemes such as
javascript:ordata:text/htmlcan no longer reach the front end. Previously they were escaped only as attributes. - Security: imported JSON is validated much more strictly. Event dates must exist in the calendar, one-off campaigns need a real date window, and link schemes are checked. Uploaded files are verified as genuine HTTP uploads.
- Security: image addresses are encoded for the CSS context, so they cannot break out of
url()and inject their own declarations. - Security: request data is unslashed correctly. Brand names and name-day overrides containing an apostrophe no longer accumulate backslashes on each save.
- Security: campaign actions verify the post type first, so a plugin action can no longer delete or overwrite an unrelated WordPress post.
- Security: data migrations now require the
manage_optionscapability. - Removed all content specific to the original client. The starter campaigns are now neutral commercial examples.
- The interface is fully internationalised, with English source strings and a Polish translation.
- Accessibility: the carousel can be paused, stops on focus and on touch, and does not auto-advance for visitors who ask for reduced motion.
- Accessibility: inactive slides are hidden from screen readers, and the carousel exposes a proper region role.
- Settings: a new "Delete all plugin data on uninstall" option, off by default, so removing the plugin keeps your campaigns unless you say otherwise.
- Added
LICENSE, plugin metadata required by the plugin directory, and a WordPress.org readiness contract to the test suite. - Fixed a defect in the test runner that reported some failing contracts as passing.
- Fixed: bold text in the banner headline picked up an uncontrolled weight of 900 and switched to a different cut of the typeface.
- Bold weights are now explicit: 800 in the headline, 700 in the description.
- Bold, italic and underline each change one property only; the typeface, size and letter spacing stay as they were.
- Unformatted content looks exactly as before.
- A small formatting toolbar above the headline and description: bold, italic, underline and line break.
- The headline is a multi-line field, and Enter inserts a real line break.
- Only
strong,em,uand line breaks are allowed; every other tag is stripped. - Content is filtered on save and again on render, so older records are safe too.
- No TinyMCE and no full WYSIWYG editor.
- The dashboard counts what is on air using the same helper as the front end.
- Fixed: content containing an ampersand came back into the editor correctly.
- Drag-and-drop ordering for evergreen campaigns, with a handle on each card.
- The order is saved without reloading the page, with a confirmation message.
- Move up and move down buttons for keyboard use; they work without JavaScript too.
- An on-air marker on the campaigns that are actually being shown, with their slot number.
- Four global name-day shortcodes that return just the names, with no markup.
- The shortcodes use the same calendar and the same tokens as the banners, and respect test mode.
- Banner polish: a lighter name-day footer, smaller desktop arrows that appear on hover and focus, and mobile content moved higher.
- Test mode with a simulated date and an optional forced campaign, stored per administrator.
- Dynamic name-day tokens for tomorrow and the next two days.
- Per-campaign typography and image positioning, with inline validation in the editor.
- The admin stylesheet was split into ten modules with no visual change.
- Rebuilt admin foundation and dashboard on a documented design-token system.
- Self-hosted Geist variable font, no external font CDN.