Getting Started with the Unidy WordPress Plugin

The Unidy WordPress plugin is a companion for the Unidy SDK. It ships a set of modules (authentication, profile, newsletter, tickets, transactions, subscriptions, and WooCommerce) that render on your WordPress site via shortcodes and integrate with your Unidy instance. Each module can be enabled or disabled independently.

1. Requirements

WordPress 6.0 or newer

PHP 8.1 or newer

A Unidy instance URL and an SDK API key (both provided by your Unidy contact)

An HTTPS site (required by the SDK's cookie policy)

2. Install the plugin

Download the latest release ZIP from github.com/UnidyID/unidy-wordpress-plugin.

In WordPress, go to Plugins → Add New → Upload Plugin and select the ZIP.

Click Install Now, then Activate.

Once activated, a new menu item Unidy appears in the WordPress admin sidebar.

3. Connect to your Unidy instance

Open Unidy → Overview in the WordPress admin.

Enter your Instance URL (for example, https://your-instance.unidy.de).

Enter your SDK API key. The key is stored non-autoloaded and masked after saving.

Click Test connection. A green Instance reachable badge confirms the SDK can talk to your Unidy backend.

ℹ️

If the test fails, verify that (a) the instance URL includes the protocol, (b) the API key was copied without leading or trailing whitespace, and (c) your Unidy instance allows requests from your WordPress domain.

4. Enable the modules you need

Under Modules on the Overview screen you can enable or disable each module individually. Only enabled modules load their assets and register their shortcodes, so keeping unused modules off keeps the frontend lean.

See the Enabling Modules article for a decision matrix on which modules serve which use cases.

5. Verify the setup

Create a test page in WordPress and drop the shortcode [unidy_user_menu] into it — a TowersID pill should appear.

Click the pill. The Unidy authentication overlay opens.

Sign in with a valid Unidy user. After the redirect, the pill turns into an avatar with your initials and a dropdown menu.

At this point the plugin is fully wired up. Continue with the module-specific configuration guides.