WP Manifestindependent plugin directory
manifest / utilities / tidewater-seasonal-events-popup

Tidewater Seasonal Popup

Seasonal event popup plugin for Tidewater Tours with Elementor-editable content.

by Strong Anchor Tech · github.com/stronganchor/tidewater-seasonal-events-popup · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/stronganchor/tidewater-seasonal-events-popup/archive/refs/heads/main.zip

Declares an update source (https://github.com/stronganchor/tidewater-seasonal-events-popup), so updates arrive through the plugin's own updater.

Readme

Tidewater Seasonal Popup

Site-wide seasonal event popup plugin for Tidewater Tours.

What It Does

  • Shows one popup on public pages.
  • Uses sessionStorage so each popup key appears once per browser session.
  • Keeps the close button, backdrop, delay, and popup frame in the plugin.
  • Supports either simple built-in fields or client-editable Elementor content inside the popup.
  • Bundles Plugin Update Checker so Strong Anchor can ship updates from GitHub.

Client Editing Workflow

  1. In WordPress, create or edit an Elementor saved template or a Header Footer & Blocks template for the popup content.
  2. Go to Settings > Seasonal Popup.
  3. Set Content source to Elementor template or block.
  4. Select the template/block.
  5. Save the popup settings and purge the public page cache.

After that setup, the client can edit the selected template in Elementor without touching the plugin settings. The plugin still controls the modal frame, close button, display delay, and once-per-session behavior.

When switching to a new seasonal event, change the Popup key in Settings > Seasonal Popup. That makes visitors who already saw the previous event see the new popup once.

Fallback Editing

If Elementor is not used, leave Content source set to Built-in popup fields and edit:

  • Image URL
  • Title
  • Body lines
  • Button label
  • Button URL
  • Open delay

There is also a shortcode source for page-builder blocks that expose a shortcode.

Release Workflow

  1. Update the plugin header Version: and TIDEWATER_SEASONAL_POPUP_VERSION.

  2. Commit the change.

  3. Push main.

  4. Tag the release, for example:

    git tag v1.1.0
git push origin main v1.1.0

Plugin Update Checker points at:

https://github.com/stronganchor/tidewater-seasonal-events-popup

The update branch defaults to main and can be overridden with the tidewater_seasonal_popup_update_branch filter or TIDEWATER_SEASONAL_POPUP_UPDATE_BRANCH constant.

Live Deployment Note

The current live Tidewater site still needs this 1.1.0 build installed once fresh WordPress credentials are available. After that first manual update, future plugin updates can be maintained from this GitHub repo.

Read the full README on GitHub →