PHPackages                             empiricompany/openmage-facebook-pixel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. empiricompany/openmage-facebook-pixel

ActiveMagento-module

empiricompany/openmage-facebook-pixel
=====================================

OpenMage module for Meta Pixel (Facebook Pixel) integration with automatic e-commerce event tracking and advanced matching.

1.0.5(4w ago)110MITPHPPHP >=7.4

Since Jul 13Pushed 4w agoCompare

[ Source](https://github.com/empiricompany/openmage-facebook-pixel)[ Packagist](https://packagist.org/packages/empiricompany/openmage-facebook-pixel)[ RSS](/packages/empiricompany-openmage-facebook-pixel/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (6)Dependencies (2)Versions (7)Used By (0)

OpenMage Facebook Pixel Extension
=================================

[](#openmage-facebook-pixel-extension)

OpenMage module for [Meta Pixel](https://developers.facebook.com/documentation/meta-pixel) (Facebook Pixel) integration with automatic e-commerce event tracking and [Advanced Matching](https://developers.facebook.com/documentation/meta-pixel/advanced/advanced-matching).

> **Platform compatibility**: this module is compatible with both [OpenMage](https://www.openmage.org/) and [MahoCommerce](https://mahocommerce.com/).

What It Does
------------

[](#what-it-does)

This module automatically tracks e-commerce events on your OpenMage store and sends them to Meta Pixel:

- **PageView**: Tracks every page view
- **ViewContent**: Tracks when customers view product pages
- **AddToCart**: Tracks when customers add products to cart
- **InitiateCheckout**: Tracks when customers start the checkout process
- **Purchase**: Tracks completed orders

Optional [Advanced Matching](https://developers.facebook.com/documentation/meta-pixel/advanced/advanced-matching) sends hashed customer email data for improved tracking accuracy.

Events Tracked
--------------

[](#events-tracked)

EventTriggerParametersPageViewEvery page—ViewContentProduct pagecontent\_ids, content\_type, contents, value, currencyAddToCartAdd to cart actioncontent\_ids, content\_type, contents, value, currencyInitiateCheckoutCheckout pagecontent\_ids, contents, num\_items, value, currencyPurchaseOrder success pagecontent\_ids, content\_type, contents, value, currencyFor complete parameter details: [Meta Pixel Standard Events](https://developers.facebook.com/documentation/meta-pixel/reference#standard-events)

Advanced Matching
-----------------

[](#advanced-matching)

The module sends the customer's **email** (`em`) for [Advanced Matching](https://developers.facebook.com/documentation/meta-pixel/advanced/advanced-matching).

In **Auto** mode (default), the Pixel SDK hashes the email automatically using SHA-256 before transmission. In **Hashed** mode, the email is pre-hashed server-side and never appears in plain text in the HTML source.

### Data Source Priority

[](#data-source-priority)

Customer email is retrieved from three sources:

1. **Logged-in customer** — from customer session
2. **Guest in checkout** — from the checkout quote
3. **Guest after purchase** — from the completed order

### Modes

[](#modes)

ModeDescription**Auto** (default)Passes normalized lowercase email. The Pixel SDK hashes it automatically.**Hashed**Pre-hashes email server-side with SHA-256. Email never appears in plain text in the HTML source.### References

[](#references)

- [Advanced Matching Implementation](https://developers.facebook.com/documentation/meta-pixel/advanced/advanced-matching)
- [Pixel Base Code](https://developers.facebook.com/documentation/meta-pixel/get-started#base-code)
- [Privacy and Data Use Guide](https://www.facebook.com/business/m/privacy-and-data)

Installation
------------

[](#installation)

### Via Composer

[](#via-composer)

```
composer require empiricompany/openmage-facebook-pixel
```

### Via Modman

[](#via-modman)

```
modman clone https://github.com/empiricompany/openmage-facebook-pixel.git
```

### Manual Installation

[](#manual-installation)

Copy the contents of `app/` folder to your OpenMage installation's `app/` folder:

```
cp -r app/* /path/to/openmage/app/
```

Then clear cache:

```
rm -rf /path/to/openmage/var/cache/*
```

Configuration
-------------

[](#configuration)

1. Go to **Admin Panel → System → Configuration → Facebook → Facebook Pixel**
2. Enable the module
3. Enter your Meta Pixel ID (you can find it in [Meta Events Manager](https://business.facebook.com/events_manager/))
4. Optionally enable Advanced Matching for better tracking accuracy
5. Choose Advanced Matching Mode: **Auto** (recommended) or **Hashed**
6. Optionally enable Debug Mode to log tracking data

[![immagine](https://private-user-images.githubusercontent.com/5071467/623540988-f7d10630-46e2-457b-a182-d6e03aaa0ad7.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODc1NzQ4MTgsIm5iZiI6MTc4NzU3NDUxOCwicGF0aCI6Ii81MDcxNDY3LzYyMzU0MDk4OC1mN2QxMDYzMC00NmUyLTQ1N2ItYTE4Mi1kNmUwM2FhYTBhZDcucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDgyNCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA4MjRUMTIyODM4WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YjMyMmY0MzZhOTczZTIyZjU4MzgyZTIzZmE4Mjk1Mjk2YmNjY2E5ZDA2ODI2NDQ3MzUxM2YwZjM2ZTM0NDk2NCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.kjjgBQa-KnOBd2nLbG6FSX9yLFwzsDBOOyK21O24wvg)](https://private-user-images.githubusercontent.com/5071467/623540988-f7d10630-46e2-457b-a182-d6e03aaa0ad7.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODc1NzQ4MTgsIm5iZiI6MTc4NzU3NDUxOCwicGF0aCI6Ii81MDcxNDY3LzYyMzU0MDk4OC1mN2QxMDYzMC00NmUyLTQ1N2ItYTE4Mi1kNmUwM2FhYTBhZDcucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDgyNCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA4MjRUMTIyODM4WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YjMyMmY0MzZhOTczZTIyZjU4MzgyZTIzZmE4Mjk1Mjk2YmNjY2E5ZDA2ODI2NDQ3MzUxM2YwZjM2ZTM0NDk2NCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.kjjgBQa-KnOBd2nLbG6FSX9yLFwzsDBOOyK21O24wvg)Testing
-------

[](#testing)

- Install the [Meta Pixel Helper](https://chromewebstore.google.com/detail/meta-pixel-helper/fdgfkebogiimcoedlicjlajpkdmockpc) Chrome extension to verify tracking
- Enable **Debug Mode** in module settings to log data to `var/log/facebook_pixel.log`
- See the [Meta Pixel support guide](https://developers.facebook.com/documentation/meta-pixel/support) for troubleshooting

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance94

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

6

Last Release

29d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5071467?v=4)[Tony](/maintainers/empiricompany)[@empiricompany](https://github.com/empiricompany)

---

Top Contributors

[![empiricompany](https://avatars.githubusercontent.com/u/5071467?v=4)](https://github.com/empiricompany "empiricompany (14 commits)")

---

Tags

magento1magento1-modulemahomaho-moduleopenmageopenmage-modulemagentoopenmagemeta-pixelmagento1facebook pixel

### Embed Badge

![Health badge](/badges/empiricompany-openmage-facebook-pixel/health.svg)

```
[![Health](https://phpackages.com/badges/empiricompany-openmage-facebook-pixel/health.svg)](https://phpackages.com/packages/empiricompany-openmage-facebook-pixel)
```

###  Alternatives

[magento-hackathon/magento-composer-installer

Composer installer for Magento modules

214811.2k391](/packages/magento-hackathon-magento-composer-installer)[mahocommerce/maho

Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+

1498.8k68](/packages/mahocommerce-maho)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)