PHPackages                             prestashopcorp/ps\_facebook - 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. [Utility & Helpers](/categories/utility)
4. /
5. prestashopcorp/ps\_facebook

ActivePrestashop-module[Utility & Helpers](/categories/utility)

prestashopcorp/ps\_facebook
===========================

PrestaShop Social with Facebook & Instagram allows you to easily feature your products on Facebook and Instagram so people can discover and buy them.

v1.38.18(2w ago)10019[1 PRs](https://github.com/PrestaShopCorp/ps_facebook/pulls)AFL-3.0PHPPHP >=7.2.5CI passing

Since Oct 22Pushed 4mo ago9 watchersCompare

[ Source](https://github.com/PrestaShopCorp/ps_facebook)[ Packagist](https://packagist.org/packages/prestashopcorp/ps_facebook)[ RSS](/packages/prestashopcorp-ps-facebook/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (22)Versions (175)Used By (0)

[![PrestaShop Social with Facebook & Instagram logo](_dev/src/assets/logo-wordmark.svg)](_dev/src/assets/logo-wordmark.svg)

PrestaShop Social with Facebook & Instagram (ps\_facebook)
==============================================================

[](#prestashop-social-with-facebook--instagram-ps_facebook)

[![PHP tests](https://github.com/PrestaShopCorp/ps_facebook/workflows/PHP%20tests/badge.svg)](https://github.com/PrestaShopCorp/ps_facebook/workflows/PHP%20tests/badge.svg)[![JS tests](https://github.com/PrestaShopCorp/ps_facebook/workflows/JS%20tests/badge.svg)](https://github.com/PrestaShopCorp/ps_facebook/workflows/JS%20tests/badge.svg)

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

[](#installation)

Use `make build` to install dependencies (or `make docker-build` to run it within docker).

Check other commands with `make help`.

Requirements
------------

[](#requirements)

This module is compliant with PrestaShop 1.7+. PHP compatibility can be found in `composer.json`.

You need a facebook developper account added to the PrestaShop Social Media app (ID:726899634800479) to manage its settings.

CDN usage
---------

[](#cdn-usage)

If you want to use local vue app, set on your .env USE\_LOCAL\_VUE\_APP at 1.

```
USE_LOCAL_VUE_APP=1

```

Usage
-----

[](#usage)

Install module and connect to FBE in module BO

Delivery
--------

[](#delivery)

### Automatic

[](#automatic)

This package should be automatically delivered by the CI/CD, see the [github workflows](./github/workflows). Zips should be available for each [releases](./releases).

### Manual

[](#manual)

1. Fill up `.env.inte` and `.env.prod` files
2. Use `make bundle` to build up deliverable zips for integration and production purpose.
3. Find zips within the `./dist` directory

About
-----

[](#about)

### Compliancy with PrestaShop 1.6

[](#compliancy-with-prestashop-16)

This module is not compliant with PS 1.6 as some Pixel events could not be implemented properly on this version (i.e `CustomizeProduct`). This avoids potential misunderstanding about mismatching behavior of the module with different versions of PrestaShop.

### Facebook Pixel

[](#facebook-pixel)

- **Pixel & GDPR**

Based of the [Facebook documentation about GDPR](https://developers.facebook.com/docs/facebook-pixel/implementation/gdpr/), a user may revoke his consent to use Pixel. This can be notified to Facebook by calling `fbq('consent', 'revoke');`. Cookies management modules are available on the PrestaShop marketplace to allow the management of Facebook features to each user.

For third-party module developers, this module will revoke the consent to use Pixel if the proper JS variable is set in the page content before the initialization of this module:

```
window.doNotConsentToPixel = true;
```

- **Using Pixel event in other modules**

You can call custom Pixel event by using hook: actionFacebookCallPixel

You also need to add some params in hook call

*Required:*

- eventName
- module

*Optional:*

- id\_product
- id\_product\_attribute

Example:

```
Hook::exec('actionFacebookCallPixel' ,['eventName' => 'AddToWishlist', 'module' => 'wishlist', 'id_product' => $productId, 'id_product_attribute' => $idProductAttribute]);

```

- **Documentation**

- [List of standard Pixel events](https://developers.facebook.com/docs/facebook-pixel/reference/)

### Development

[](#development)

The main branch receiving all kind of contributions (bug fixes, improvements & new features) is the `master` branch.

In the future we may maintain several branches at the same time, for instance to fix the current version in production while we prepare new features for the next release. These branches would be defined as `[1-9]*.[1-9]*.x` (for instance `1.4.x`).

- **Running with dev dependencies**

```
composer install --dev

```

- **Working with VueJS app**

To set the build of the VueJS app in development mode and watching your changes:

```
cd _dev
npm run dev
```

- **Replacing config values of the project**

Some values of the Config class can be overwriten by having your own environment variables.

You can for instance have your own `.env` at the root of this project to replace the Facebook App ID or switch the API URLs to another domain.

### Tests

[](#tests)

This module follows [recommandations of the PrestaShop devdocs](https://devdocs.prestashop.com/1.7/modules/testing/) and is checked by PHP-CS-Fixer, PHPStan and PHPUnit before each release.

Two sets of tests have been implemented in this module:

- **Unit tests**

```
vendor/bin/phpunit tests/unit/

```

- **Integration tests**

These tests run the calls to Facebook API to make sure the data the module relies on is still valid. It requires preliminary configuration, by setting your FBE configuration in a JSON config file.

```
cp tests/integration/config.json.dist tests/integration/config.json
# Edit your config.json, then
vendor/bin/phpunit tests/integration/ -v
```

### Storybook

[](#storybook)

Here available storybooks URLs according to existing environments :
[Integration Storybook](https://facebook-storybook-integration.prestashop.com/)
[Preproduction Storybook](https://facebook-storybook-preproduction.prestashop.com/)
[Production Storybook](https://facebook-storybook.prestashop.com/)

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance82

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community27

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Recently: every ~34 days

Total

167

Last Release

15d ago

PHP version history (2 changes)v1.0.0-alpha.1PHP >=5.6

v1.18.0-beta.1PHP >=7.2.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/15106407?v=4)[Jarvis](/maintainers/ps-jarvis)[@ps-jarvis](https://github.com/ps-jarvis)

---

Top Contributors

[![Quetzacoalt91](https://avatars.githubusercontent.com/u/6768917?v=4)](https://github.com/Quetzacoalt91 "Quetzacoalt91 (1118 commits)")[![margud](https://avatars.githubusercontent.com/u/51944825?v=4)](https://github.com/margud "margud (372 commits)")[![ps-jarvis](https://avatars.githubusercontent.com/u/15106407?v=4)](https://github.com/ps-jarvis "ps-jarvis (212 commits)")[![gxapplications](https://avatars.githubusercontent.com/u/15003653?v=4)](https://github.com/gxapplications "gxapplications (161 commits)")[![xGouley](https://avatars.githubusercontent.com/u/12794114?v=4)](https://github.com/xGouley "xGouley (91 commits)")[![pablopolyte](https://avatars.githubusercontent.com/u/31857168?v=4)](https://github.com/pablopolyte "pablopolyte (68 commits)")[![L3RAZ](https://avatars.githubusercontent.com/u/25088641?v=4)](https://github.com/L3RAZ "L3RAZ (43 commits)")[![zalexki](https://avatars.githubusercontent.com/u/3863527?v=4)](https://github.com/zalexki "zalexki (35 commits)")[![m-Poulain](https://avatars.githubusercontent.com/u/93722295?v=4)](https://github.com/m-Poulain "m-Poulain (34 commits)")[![Poulinhoo](https://avatars.githubusercontent.com/u/22856724?v=4)](https://github.com/Poulinhoo "Poulinhoo (25 commits)")[![kseghair](https://avatars.githubusercontent.com/u/16594134?v=4)](https://github.com/kseghair "kseghair (24 commits)")[![ga-devfront](https://avatars.githubusercontent.com/u/52718717?v=4)](https://github.com/ga-devfront "ga-devfront (20 commits)")[![ClaraLpresta](https://avatars.githubusercontent.com/u/76918665?v=4)](https://github.com/ClaraLpresta "ClaraLpresta (11 commits)")[![SachaAvazashvili](https://avatars.githubusercontent.com/u/90195053?v=4)](https://github.com/SachaAvazashvili "SachaAvazashvili (11 commits)")[![cdesiles](https://avatars.githubusercontent.com/u/1536672?v=4)](https://github.com/cdesiles "cdesiles (10 commits)")[![Maxence-Perrin](https://avatars.githubusercontent.com/u/47532622?v=4)](https://github.com/Maxence-Perrin "Maxence-Perrin (7 commits)")[![Nakahiru](https://avatars.githubusercontent.com/u/16980315?v=4)](https://github.com/Nakahiru "Nakahiru (7 commits)")[![amarie75](https://avatars.githubusercontent.com/u/11529550?v=4)](https://github.com/amarie75 "amarie75 (2 commits)")[![Ant0wan](https://avatars.githubusercontent.com/u/43214931?v=4)](https://github.com/Ant0wan "Ant0wan (2 commits)")[![Roxayl](https://avatars.githubusercontent.com/u/5798568?v=4)](https://github.com/Roxayl "Roxayl (1 commits)")

---

Tags

facebookfbeprestashopprestashop-module

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/prestashopcorp-ps-facebook/health.svg)

```
[![Health](https://phpackages.com/badges/prestashopcorp-ps-facebook/health.svg)](https://phpackages.com/packages/prestashopcorp-ps-facebook)
```

###  Alternatives

[roots/bedrock

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

6.5k441.8k2](/packages/roots-bedrock)[akaunting/laravel-money

Currency formatting and conversion package for Laravel

7825.3M18](/packages/akaunting-laravel-money)[cognesy/instructor-php

The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control

310107.9k1](/packages/cognesy-instructor-php)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41716.4k2](/packages/lullabot-drainpipe)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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