Facebook for WordPress

Grow your business with Facebook for WordPress! This plugin will install a Facebook Pixel for your page so you can capture the actions people take when they interact with your page, such as Lead, ViewContent, AddToCart, InitiateCheckout and Purchase events. Version 2.0.0 also includes support for the Conversions API, which lets you send events directly from your page’s server so you can capture a more of these events when they happen. This can help you better understand your customer’s journey from the moment they show interest in your business to the moment they complete a conversion. You can use this information to create ad campaigns that are relevant to your audience. Learn More

Requirements

Facebook for WordPress requires

• WordPress 5.7 or higher
• PHP 8.0 or greater

Get started

Clone this repo with the following command:

$ git clone https://github.com/facebookincubator/facebook-pixel-for-wordpress.git

Initiate the development environment:

1. Install Composer
2. Run the command to install the necessary package: $ composer install

Build the project and create the zip Run the command to run tests and create the zip under build directory.

$ vendor/bin/phing

Full Documentation

https://www.facebook.com/business/help/881403525362441

How to integrate your plugins

1. Add your integration class under integration/ folder
2. Extend the class from FacebookWordpressIntegrationBase
3. Define class variable PLUGIN_FILE to be your plugin PHP file
4. Define class variable TRACKING_NAME for tracking purpose, put this value under 'fb_wp_tracking' as a parameter in the pixel event
5. Define a public static function inject_pixel_code() to inject pixel at your page
6. Add your unit test class under tests/ folder
7. Extend the test class from FacebookWordpressTestBase
8. After the classes development, run tests by $ vendor/bin/phing

You can reference to integration/FacebookWordpressContactForm7.php and tests/FacebookWordpressContactForm7Test.php as an example

Contributing

See the CONTRIBUTING file for how to help out

Local Development Configuration

For local development or staging environments, you can override plugin constants by creating a local-config.php file in the plugin root directory. This file is gitignored and loaded automatically before any other plugin code.

Create the file:

cp local-config-sample.php local-config.php

Or create it manually:

<?php
// local-config.php — Local development overrides (gitignored).

// Point FBL4B at a staging Meta App and config.
define( 'FB_FBL4B_APP_ID', 'your_staging_app_id' );
define( 'FB_FBL4B_CONFIG_ID', 'your_staging_config_id' );

// Redirect FBL4B iframe and popup origin to a staging domain.
define( 'META_PIXEL_BASE_DOMAIN', 'your.staging.domain' );

Available constants:

Constant	Description	Default
FB_FBL4B_APP_ID	Meta App ID for FBL4B authentication	Production app ID from FacebookPluginConfig
FB_FBL4B_CONFIG_ID	FBL4B SUAT configuration ID	Production config ID from FacebookPluginConfig
META_PIXEL_BASE_DOMAIN	Base domain for FBL4B iframe and popup origin (e.g. facebook.com)	facebook.com

License

Facebook for WordPress is GPLv2-licensed