README

This Connector allows you to fetch social posts from Facebook.

Release Plan

Release	Supported Pimcore Versions	Supported Symfony Versions	Release Date	Maintained	Branch
3.x	`11.0`	`6.2`	07.11.2023	Feature Branch	master
2.x	`10.1` - `10.6`	`5.4`	05.01.2022	Unsupported	2.x
1.x	`6.0` - `6.9`	`3.4`, `^4.4`	22.10.2020	Unsupported	1.x

Installation

"require" : {
    "dachcom-digital/social-data" : "~3.0.0",
    "dachcom-digital/social-data-facebook-connector" : "~3.0.0"
}

Add Bundle to bundles.php:

return [
    SocialData\Connector\Facebook\SocialDataFacebookConnectorBundle::class => ['all' => true],
];

Install Assets

bin/console assets:install public --relative --symlink

Enable Connector

# config/packages/social_data.yaml
social_data:
    social_post_data_class: SocialPost
    available_connectors:
        -   connector_name: facebook

Set Cookie SameSite to Lax

Otherwise, the oauth connection won't work.

If you have any hints to allow processing an oauth connection within strict mode, please tell us.

framework:
    session:
        cookie_samesite: 'lax'

Facebook Backoffice

First, you need to create a facebook app. Add https://YOURDOMAIN/admin/social-data/connector/facebook/check to the Valid OAuth Redirect URIs in facebook backoffice.

Connector Configuration

Now head back to the backend (System => Social Data => Connector Configuration) and checkout the facebook tab.

Click on Install
Click on Enable
Before you hit the Connect button, you need to fill you out the Connector Configuration. After that, click "Save".
Click Connect

Connection

This will guide you through the facebook token generation. After hitting the "Connect" button, a popup will open to guide you through facebook authentication process. If everything worked out fine, the connection setup is complete after the popup closes. Otherwise, you'll receive an error message. You may then need to repeat the connection step.

Feed Configuration

Name	Description
`Page Id`	Defines which page entries should be imported
`Limit`	Define a limit to restrict the amount of social posts to import (Default: 50)

Extended Connector Configuration

Normally you don't need to modify connector (connector_config) configuration, so most of the time you can skip this step. However, if you need to change some core setting of a connector, you're able to change them of course.

# config/packages/social_data.yaml
social_data:
    available_connectors:
        -   connector_name: facebook
            connector_config:
                api_connect_permission: ['pages_show_list'] # default value

Copyright and license

Upgrade Info

Before updating, please check our upgrade notes!

dachcom-digital / social-data-facebook-connector

Maintainers

Details