Integrate your WordPress site with CallTrackingMetrics for advanced call and form tracking, analytics, and marketing attribution.
- WordPress 6.5 or higher (tested up to 6.8.1)
- PHP 7.4+ (8.0+ recommended)
- CallTrackingMetrics account with API access enabled
- Obtain a CallTrackingMetrics Account
- Sign up at CallTrackingMetrics and ensure your account has API access enabled.
- Download or Clone the Plugin
- Download the latest release or clone the repository into your WordPress plugins directory:
git clone <repo-url> wp-content/plugins/call-tracking-metrics
- Download the latest release or clone the repository into your WordPress plugins directory:
- Install PHP Dependencies
- If you are developing or running from source, install dependencies with Composer:
cd wp-content/plugins/call-tracking-metrics composer install - Note: The plugin requires PHP 7.4 or higher (PHP 8.0+ recommended).
- If you are developing or running from source, install dependencies with Composer:
- Activate the Plugin
- Go to the WordPress admin dashboard, navigate to Plugins, and activate CallTrackingMetrics.
- Go to Settings > CallTrackingMetrics in the WordPress admin.
- Enter your CTM API Access Key and Secret Key (get these from your CTM dashboard).
- Enable integrations as needed:
- Contact Form 7: Toggle integration and map form fields. Ensure phone fields use
type="tel"for best compatibility. - Gravity Forms: Toggle integration and map form fields.
- Contact Form 7: Toggle integration and map form fields. Ensure phone fields use
- Optionally, enable the dashboard widget to view daily CTM activity directly in your WordPress admin dashboard.
- Configure additional options such as debug logging, tracking script injection, and more from the settings page.
- Save your settings.
- The plugin will automatically inject the CTM tracking script on your site’s
<head>, enabling call and form tracking on all public pages. - Submissions from Contact Form 7 and Gravity Forms are automatically tracked and sent to CTM, provided the relevant integration is enabled and fields are mapped.
- A dashboard widget will display daily CTM activity if enabled.
- Debug logs and activity can be viewed or emailed from the admin.
- Use the settings page to map your form fields to CTM fields for accurate data capture.
- Many admin features (such as emailing logs) use AJAX for a smooth experience.
- The plugin is compatible with standard WordPress installations. For multisite, activate per site as needed.
- Easy to configure and use
- Tracks calls from a full range of sources
- Identifies repeat callers
- Shows which marketing sources provide the best ROI
- Integrates with Contact Form 7 and Gravity Forms
- Dashboard widget for at-a-glance analytics
- Debug logging and troubleshooting tools
- Install and activate the plugin.
- Enter your CTM API keys in Settings > CallTrackingMetrics.
- Enable and configure integrations for your forms.
- Check the dashboard widget for activity.
- Review logs for troubleshooting if needed.
- API Connection Issues: Double-check your API keys and ensure your CTM account has API access enabled.
- No Calls/Leads Tracked: Ensure the tracking script is present in your site’s
<head>. Check for JavaScript errors in the browser console. - Form Integration Not Working:
- Make sure the relevant integration (CF7 or GF) is enabled in plugin settings.
- For Contact Form 7, ensure phone fields use
type="tel". - For Gravity Forms, confirm field mapping is correct.
- Debug Logs: Use the admin dashboard widget or the “Email Daily Log” feature to review logs for errors or activity.
- Plugin Not Loading: Ensure PHP version is compatible (>=7.4, ideally 8.0+). Check for missing Composer dependencies (
vendor/folder).
- Dependencies: Managed via Composer. Run
composer installafter pulling updates. - Testing: (No test files present, but autoload-dev is configured for PHPUnit. Add tests in
tests/and run withvendor/bin/phpunit.) - Updating: After updating, always verify plugin activation and check the dashboard widget for errors.
- Uninstall: Plugin cleans up its options on uninstall.
- All plugin files are in
wp-content/plugins/call-tracking-metrics/. - Remove any development or temporary files before handoff (e.g.,
.DS_Store, local config overrides). - Ensure
vendor/is present for production, or provide instructions to runcomposer install.
- Initialize a git repository if not already present:
git init git add . git commit -m "Initial commit of CallTrackingMetrics plugin"
- Add remote and push:
git remote add origin <repo-url> git push -u origin main
GPL-2.0-or-later
This plugin supports multiple languages using standard WordPress translation functions (__(), _e()).
- Extract translatable strings:
- All user-facing strings use the
call-tracking-metricstext domain. - The
.pottemplate file is located at/languages/call-tracking-metrics.pot.
- All user-facing strings use the
- Create a translation:
- Use a tool like Poedit or Loco Translate to create
.poand.mofiles for your language (e.g.,call-tracking-metrics-fr_FR.po,call-tracking-metrics-fr_FR.mo). - Place these files in the
/languagesdirectory.
- Use a tool like Poedit or Loco Translate to create
- Load translations:
- WordPress will automatically load the correct translation based on the site language settings.
Run the following command from the plugin root:
wp i18n make-pot . languages/call-tracking-metrics.potFor more details, see the WordPress Plugin Handbook: Internationalization.