WordPress and WooCommerce

Install the Hermeticor plugin to show your forms and track visits on WordPress, with WooCommerce cart rules.

Embed
Preview of the card
<a href="https://hermeticor.com/guides/wordpress"><img src="https://hermeticor.com/guides/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/9a3da731-ded5-4536-b84f-8c9a61420ff4/pages/69616c65-51e8-4eb0-8064-957f31a3def2/social-card.svg?v=3e7ae33eec8b" alt="WordPress and WooCommerce" width="600" height="315"></a>

The Hermeticor plugin loads the same script as the install snippet, so you do not edit your theme. It shows your published forms, places inline forms with a block or a shortcode, and keeps the WooCommerce cart up to date for form cart rules.

What you need first

  • A site in Hermeticor (Sites → Add site) and its site key. The key starts with hm_pk_ and is shown once, when you add the site.

  • WordPress 6.3 or later and PHP 7.4 or later.

1. Install the plugin

  1. Download hermeticor-wordpress.zip. Sites → Install → WordPress has the same link.

  2. In WordPress, open Plugins → Add New → Upload Plugin, choose the zip and click Install Now.

  3. Activate it.

2. Add your site key

Open Settings → Hermeticor.

Setting

What it does

Site key

Your hm_pk_… key. Secret keys (hm_sk_) are refused.

Endpoint

https://hermeticor.com. Change it only if you run your own Hermeticor. It must be https://.

Consent mode

Require consent (default): nothing is stored or sent until the visitor allows analytics. Opt out: on until the visitor declines. No consent banner: always on.

Load Hermeticor on the front end

Turn it off to pause everything without losing the settings.

Show published forms

Popups, fly-outs and inline forms.

Identify logged-in users

Off by default. When on, a logged-in user's email is sent, and only after they allow marketing.

Save, load a page of your site, then click Check install on the site in Hermeticor.

3. Place an inline form

Popups and fly-outs show on their own once published, following their targeting. An inline form needs a place on the page:

  • Block editor: add the Hermeticor form block and enter the form ID.

  • Anywhere else: use the shortcode.

[hermeticor_form id="0198a1b2-7c3d-7e4f-8a5b-6c7d8e9f0a1b"]

The form ID is the last part of the form editor's address in Hermeticor (/forms/<id>). The form must be the Embedded type and published. An invalid ID shows a note to editors and nothing to visitors.

WooCommerce

When WooCommerce is active, the plugin passes the cart total and item count to Hermeticor on every page and after each cart update, so form cart rules ("cart value over 50", "cart has items") work without code. The cart stays in the visitor's browser; it is not sent to Hermeticor.

The plugin never sends anything the consent mode does not allow. If your cookie banner supports the WP Consent API, the visitor's statistics and marketing choices are passed on. With any other banner, call this when the visitor decides:

hermetica.consent.update({ analytics: true, marketing: false })

See Unsubscribe and suppression for how consent works in Hermeticor.

Remove it

Deactivate and delete the plugin. Deleting it removes its settings.

Updated