Skip to main content

WordFex - Sync WordPress with Perfex CRM

WordFex is a WordPress plugin that syncs new WordPress user registrations to Perfex CRM through the Perfex REST API.

Overviewโ€‹

WordFex bridges your WordPress website with your Perfex CRM installation. Whenever a new user registers on your WordPress site, WordFex automatically creates a corresponding customer or lead record in Perfex CRM via the REST API. This eliminates the need for manual data entry and ensures that your CRM is always up to date with your website's user base.

How It Worksโ€‹

  1. A new user registers on your WordPress website.
  2. WordFex captures the registration data.
  3. The plugin sends the data to your Perfex CRM via the REST API.
  4. A new customer or lead record is created in Perfex CRM automatically.
Requirement

WordFex requires the Perfex REST API module to be installed and active on your Perfex CRM instance. The plugin will not function without this dependency.

Requirementsโ€‹

Before installing WordFex, ensure you have the following:

RequirementDetails
WordPressAn active WordPress installation
Perfex CRMAn active Perfex CRM installation accessible via a public URL
Perfex REST API ModuleInstalled and activated on your Perfex CRM instance
REST API TokenA valid API token generated from the Perfex REST API module
PHP VersionPHP 7.4 or higher on both WordPress and Perfex CRM servers
info

The Perfex REST API module is a separate product that must be purchased and installed on your Perfex CRM before WordFex can communicate with it. Make sure the REST API module is properly configured and that you have generated an API token.

Installation (WordPress)โ€‹

WordFex is installed as a standard WordPress plugin:

  1. Extract your download and locate upload.zip.
  2. In WordPress admin, go to Plugins โ†’ Add New.
  3. Click Upload Plugin, select upload.zip, and press Upload.
  4. Click Activate. "WordFex" will appear under the Settings menu.
tip

For multisite installations, you may need to network activate the plugin or activate it per-site depending on your setup. Check the plugin documentation for multisite specifics.

After Installationโ€‹

Once the plugin is activated, you need to configure it to connect to your Perfex CRM:

  1. In WordPress admin, go to Settings โ†’ WordFex.
  2. Enter your Perfex CRM URL (e.g., https://yourdomain.com/crm).
  3. Enter the REST API token generated from your Perfex CRM's REST API module settings.
  4. Configure the sync options โ€” choose whether new registrations should be created as customers or leads.
  5. Save your settings.
  6. Test the connection โ€” register a test user on your WordPress site and verify that the record appears in Perfex CRM.
warning

Ensure your Perfex CRM installation is accessible from your WordPress server. If they are on different servers, verify there are no firewall rules blocking the connection between them.

Troubleshootingโ€‹

IssueSolution
Records not syncingVerify the REST API module is active and the API token is correct
Connection timeoutCheck that your Perfex CRM URL is accessible from the WordPress server
Plugin not appearing in SettingsDeactivate and reactivate the plugin; check for PHP errors in the WordPress log
Duplicate records in CRMReview the sync settings to ensure proper field mapping and deduplication

Supportโ€‹

If you encounter any issues during installation or configuration, visit the Themesic Support Portal to open a support ticket.