alleyinteractive/wp-allegro-audience

WordPress Plugin to include Allegro Audience on your site.

v0.1.0 2026-07-20 13:24 UTC

Requires

• php: ^8.3
• alleyinteractive/composer-wordpress-autoloader: ^1.0
• alleyinteractive/wp-type-extensions: ^4.0

Requires (Dev)

• alleyinteractive/alley-coding-standards: ^2.0
• mantle-framework/testkit: ^1.15
• rector/rector: ^2.0
• szepeviktor/phpstan-wordpress: ^2.0

GPL-2.0-or-later

• Allegro Audience

• alleyinteractive
• wp-allegro-audience

Published on Packagist.org on 2026-07-20 13:24 UTC

README

Homepage — Documentation

Allegro Audience WordPress Plugin

Connect your WordPress site to Allegro Audience. Enter your organization URL, verify the connection, and Allegro Audience's client.js is automatically injected on every front-end page.

Installation

Install via Composer:

composer require alleyinteractive/allegro-audience

Or upload the plugin ZIP through Plugins → Add New in WordPress.

Configuration

1. Activate the plugin.
2. Go to Settings → Allegro Audience.
3. Enter your Allegro Audience organization URL (e.g. https://your-org.allegrocdp.com).
4. Click Save & Verify — the plugin confirms the URL is a live Allegro Audience instance and checks that CORS is configured for your domain.
5. Once verified, client.js is injected automatically on every front-end page.

How it works

• Health check — on save, the plugin makes a server-side request to <org-url>/up and verifies the x-allegro-health: 1 response header.
• CORS check — the browser fetches <org-url>/client.js directly to confirm cross-origin access is configured. If it isn't, the settings page shows a warning with a link to the Allegro Audience developer docs.
• Script injection — once verified, <script src="<org-url>/client.js"></script> is output in wp_head on every front-end page.

Development

composer install
composer serve   # starts wp-env

Run tests and linting:

composer test       # lint + PHPUnit
composer phpunit    # PHPUnit only
composer phpstan    # static analysis (level max)
composer phpcs      # coding standards

Releasing

Run npm run release to bump the version and trigger the built-release workflow, which creates a versioned tag.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

Maintained by Alley Interactive. Like what you see? Come work with us.

License

The GNU General Public License (GPL) license. Please see License File for more information.