PHPackages                             hirale/openmage-meta-conversions - 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. [API Development](/categories/api)
4. /
5. hirale/openmage-meta-conversions

ActiveMagento-module[API Development](/categories/api)

hirale/openmage-meta-conversions
================================

Meta Conversions API integration for OpenMage and Maho, built on hirale/queue.

v2.0.0(2mo ago)3101OSL-3.0PHPPHP &gt;=8.3

Since Jun 9Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/hirale/openmage-meta-conversions)[ Packagist](https://packagist.org/packages/hirale/openmage-meta-conversions)[ RSS](/packages/hirale-openmage-meta-conversions/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (3)Dependencies (8)Versions (5)Used By (0)

Hirale Meta Conversions API Module
==================================

[](#hirale-meta-conversions-api-module)

A module for integrating [Meta Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api/get-started), sending events from server side.

For duplicate events, you can consult this page

If you are using javascript to send pixel events, You can get event\_id like this.

```
Mage::helper('metaconversions')->getEventId();
```

Supported Events
----------------

[](#supported-events)

- `AddToCart`
- `AddToWishlist`
- `CompleteRegistration`
- `InitiateCheckout`
- `Purchase`
- `Search`
- `ViewContent`
- `PageView`
- `ViewCart`

You can check more events in the [events section](https://developers.facebook.com/docs/meta-pixel/reference#standard-events).

Install
-------

[](#install)

Requires [`hirale/queue`](https://github.com/hirale/queue) `^3.0`(pulled in automatically).

**Maho** (26.5+):

```
composer require hirale/openmage-meta-conversions
```

**OpenMage** (20.17+, PHP 8.3+) — one-time tweaks first; details in the [hirale/queue README](https://github.com/hirale/queue#openmage-one-time-composer-adjustments):

```
composer config platform.php 8.3
composer config allow-plugins.hirale/magento-module-installer true
composer require hirale/magento-module-installer hirale/openmage-meta-conversions
```

Usage
-----

[](#usage)

### Setup

[](#setup)

1. This module requires the [hirale/queue](https://github.com/hirale/queue) module — configure its backend first (System &gt; Configuration &gt; Hirale &gt; Queue).
2. Generate an access token. See .
3. Go to system config `System > Configuration > Sales > Meta API > Conversions API`. Insert the parameters from step 1, save.

### Debug

[](#debug)

Enable Debug Mode in system config, then check `var/log/meta_conversions.log`. Each processed queue message logs two entries: the event batch (envelopes + custom data — `user_data` is deliberately never written to logs, and PII is already SHA-256 hashed before it even reaches the queue) and the Graph API response.

```
2026-06-11T10:00:00+00:00 DEBUG (7): Array
(
    [store_id] => 1
    [events] => Array
        (
            [0] => Array
                (
                    [event] => Array
                        (
                            [event_time] => 1718044092
                            [event_source_url] => https://example.com/some-product.html
                            [action_source] => website
                            [event_id] => 666745bcdd76a
                            [event_name] => ViewContent
                        )

                    [custom_data] => Array
                        (
                            [currency] => USD
                            [content_type] => product
                            [content_ids] => Array ( [0] => SKU-9 )
                        )

                )

            [1] => Array
                (
                    [event] => Array
                        (
                            [event_name] => PageView
                        )

                    [custom_data] =>
                )

        )

)

2026-06-11T10:00:00+00:00 DEBUG (7): FacebookAds\Object\ServerSide\EventResponse Object
(
    [container:protected] => Array
        (
            [events_received] => 2
            [messages] => Array ( )
            [fbtrace_id] => AkuJqnm2pr421jM7d89SRqa
        )

)

```

Upgrading
---------

[](#upgrading)

- The access token is now stored encrypted (`adminhtml/system_config_backend_encrypted`). After upgrading, re-enter and save the token once in system config.
- The queue message schema changed (one message now carries all events of a request, and PII is hashed before enqueueing). Let the queue worker drain pending metaconversions messages before deploying the upgrade; messages enqueued by the old version cannot be processed by the new handler.

License
-------

[](#license)

The Open Software License v. 3.0 (OSL-3.0). Please see [License File](LICENSE.md) for more information.

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance88

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 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 ~243 days

Total

4

Last Release

61d ago

Major Versions

v1.1.0 → v2.0.02026-06-10

PHP version history (2 changes)v1.0.0PHP ^8.0

v2.0.0PHP &gt;=8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/22028058?v=4)[Hirale](/maintainers/hirale)[@hirale](https://github.com/hirale)

---

Top Contributors

[![hirale](https://avatars.githubusercontent.com/u/22028058?v=4)](https://github.com/hirale "hirale (16 commits)")

---

Tags

facebookmetaopenmagecapimagento1mahomahoecommerce

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/hirale-openmage-meta-conversions/health.svg)

```
[![Health](https://phpackages.com/badges/hirale-openmage-meta-conversions/health.svg)](https://phpackages.com/packages/hirale-openmage-meta-conversions)
```

###  Alternatives

[facebook/php-business-sdk

PHP SDK for Facebook Business

91524.8M37](/packages/facebook-php-business-sdk)[october/rain

October Rain Library

1601.7M102](/packages/october-rain)[esign/laravel-conversions-api

A laravel wrapper package around the Facebook Conversions API

68181.8k](/packages/esign-laravel-conversions-api)[edbizarro/laravel-facebook-ads

Facebook &amp; Instagram Ads for Laravel 5.6+

13530.0k](/packages/edbizarro-laravel-facebook-ads)[combindma/laravel-facebook-pixel

Meta pixel integration for Laravel

5286.6k](/packages/combindma-laravel-facebook-pixel)

PHPackages © 2026

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