Download the PHP package prestashopcorp/ps_facebook without Composer

On this page you can find all versions of the php package prestashopcorp/ps_facebook. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package ps_facebook

PrestaShop Social with Facebook & Instagram (ps_facebook)

PHP tests JS tests

Installation

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

Check other commands with make help.

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

If you want to use local vue app, set on your .env USE_LOCAL_VUE_APP at 1.

Usage

Install module and connect to FBE in module BO

Delivery

Automatic

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

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

Compliancy with PrestaShop 1.6

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

Based of the Facebook documentation about 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:

You can call custom Pixel event by using hook: actionFacebookCallPixel

You also need to add some params in hook call

Required:

Optional:

Example:

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).

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

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

This module follows recommandations of the PrestaShop devdocs and is checked by PHP-CS-Fixer, PHPStan and PHPUnit before each release.

Two sets of tests have been implemented in this module:

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.

Storybook

Here available storybooks URLs according to existing environments :
Integration Storybook
Preproduction Storybook
Production Storybook

All versions of ps_facebook with dependencies

PHP Build Version
Package Version
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package prestashopcorp/ps_facebook contains the following files

Loading the files please wait ....