WP Manifestindependent plugin directory
manifest / integrations / emmie-connector

Emmie Connector

WordPress plugin that connects a website to Emmie: an intake form that adds a new client, and Emmie's booking form.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/back-to-code/emmie-connector/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

A WordPress plugin that connects an organisation's website to Emmie, the care-management platform. It adds two things to the site:

  • An intake form ([wp2emmie_form]). A visitor's answers become a new client in the organisation's own Emmie. Once the token checks out, the plugin creates a page /kennismaken with this form.
  • The booking form for introductory meetings ([emmie_kennismaking]), which Emmie draws into the page.

The organisation enters its Emmie API address and an API token under Settings › Emmie Connector. Emmie shows both under Instellingen › Instroom. reCAPTCHA v3 keys are optional and protect the intake form against bots.

The plugin is maintained by Emmie B.V. This repository is its source; readme.txt is the description the plugin directory of WordPress.org shows.

Requirements

  • PHP 8.0 or higher
  • An organisation on Emmie, and someone there with access to Instroom to make the API token

Development

composer install      # the coding standards (PHPCS with WPCS and PHPCompatibilityWP)
composer lint         # php -l on every PHP file
composer phpcs        # the WordPress Coding Standards, as CI runs them

CI runs on every pull request: php -l on the lowest and the highest supported PHP version, and PHPCS with the ruleset in phpcs.xml.dist.

A local WordPress against a local Emmie

docker-compose.test.yml starts WordPress on http://localhost:8080 with this directory mounted as the plugin. The steps to point it at a local Emmie are in the comment at the top of that file.

docker compose -f docker-compose.test.yml up -d
docker compose -f docker-compose.test.yml down -v

Files

File What it does
emmie-connector.php Plugin header, activation, the setup redirect and the clean-up on deactivation
admin-settings.php The settings page and the token check against Emmie
form-handler.php The intake form and sending it to Emmie
booking-form.php The booking form for introductory meetings
class-wp2emmie-data-encryption.php Encrypts the API token at rest with the site's own keys
functions.php The Emmie address, logging of failed HTTP calls and the privacy statement link
languages/ Dutch translation

License

GPL-2.0-or-later. See LICENSE.