Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dachcom-digital/pimcore-social-data-facebook-connector
https://github.com/dachcom-digital/pimcore-social-data-facebook-connector
facebook pimcore pimcore-bundle social-data
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dachcom-digital/pimcore-social-data-facebook-connector
- Owner: dachcom-digital
- License: other
- Created: 2020-10-05T09:22:07.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-11-07T11:20:25.000Z (about 1 year ago)
- Last Synced: 2024-10-13T18:59:53.629Z (3 months ago)
- Topics: facebook, pimcore, pimcore-bundle, social-data
- Language: PHP
- Homepage:
- Size: 88.9 KB
- Stars: 1
- Watchers: 8
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Pimcore Social Data - Facebook Connector
[](LICENSE.md)
[](https://packagist.org/packages/dachcom-digital/social-data-facebook-connector)
[](https://github.com/dachcom-digital/pimcore-social-data-facebook-connector/actions?query=workflow%3ACodeception+branch%3Amaster)
[](https://github.com/dachcom-digital/pimcore-social-data-facebook-connector/actions?query=workflow%3A"PHP+Stan"+branch%3Amaster)
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](https://github.com/dachcom-digital/pimcore-social-data-facebook-connector/tree/2.x) |
| **1.x** | `6.0` - `6.9` | `3.4`, `^4.4` | 22.10.2020 | Unsupported | [1.x](https://github.com/dachcom-digital/pimcore-social-data-facebook-connector/tree/1.x) |
## Installation
```json
"require" : {
"dachcom-digital/social-data" : "~3.0.0",
"dachcom-digital/social-data-facebook-connector" : "~3.0.0"
}
```
Add Bundle to `bundles.php`:
```php
return [
SocialData\Connector\Facebook\SocialDataFacebookConnectorBundle::class => ['all' => true],
];
```
### Install Assets
```bash
bin/console assets:install public --relative --symlink
```
## Enable Connector
```yaml
# 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](https://github.com/dachcom-digital/pimcore-social-data-facebook-connector/issues).
```yaml
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.
```yaml
# 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
Copyright: [DACHCOM.DIGITAL](http://dachcom-digital.ch)
For licensing details please visit [LICENSE.md](LICENSE.md)
## Upgrade Info
Before updating, please [check our upgrade notes!](UPGRADE.md)