Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dachcom-digital/pimcore-social-data-instagram-connector
https://github.com/dachcom-digital/pimcore-social-data-instagram-connector
instagram pimcore pimcore-bundle social-data
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dachcom-digital/pimcore-social-data-instagram-connector
- Owner: dachcom-digital
- License: other
- Created: 2020-10-05T10:09:02.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-11-07T11:20:41.000Z (about 1 year ago)
- Last Synced: 2024-11-07T19:18:25.720Z (about 2 months ago)
- Topics: instagram, pimcore, pimcore-bundle, social-data
- Language: PHP
- Homepage:
- Size: 107 KB
- Stars: 0
- Watchers: 8
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Pimcore Social Data - Instagram Connector
[](LICENSE.md)
[](https://packagist.org/packages/dachcom-digital/social-data-instagram-connector)
[](https://github.com/dachcom-digital/pimcore-social-data-instagram-connector/actions?query=workflow%3ACodeception+branch%3Amaster)
[](https://github.com/dachcom-digital/pimcore-social-data-instagram-connector/actions?query=workflow%3A"PHP+Stan"+branch%3Amaster)
This Connector allows you to fetch social posts from Instagram (Currently only via basic display api).
### 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-instagram-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-instagram-connector/tree/1.x) |
## Installation
```json
"require" : {
"dachcom-digital/social-data" : "~3.0.0",
"dachcom-digital/social-data-instagram-connector" : "~3.0.0"
}
```
Add Bundle to `bundles.php`:
```php
return [
SocialData\Connector\Instagram\SocialDataInstagramConnectorBundle::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: instagram
```
### 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-instagram-connector/issues).
```yaml
framework:
session:
cookie_samesite: 'lax'
```
## Instagram Backoffice
Some hints to set up your instagram app
### Private
- Create Non-Business Facebook App
- Add Instagram Basic Display Product
- Add `https://YOURDOMAIN/admin/social-data/connector/instagram/check` in `Valid OAuth Redirect URIs`
- Add `https://YOURDOMAIN/admin/social-data/connector/instagram/deauthorize` in `Deauthorize` (dummy)
- Add `https://YOURDOMAIN/admin/social-data/connector/instagram/data-deletion` in `Data Deletion Requests` (dummy)
- Add at least one instagram test account
### Business API
Even if you're allowed to choose between a private and business connection, the business API is currently not supported and will be available soon.
- Create Business Facebook App
- Add Instagram Graph API
## Connector Configuration
Now head back to the backend (`System` => `Social Data` => `Connector Configuration`) and checkout the instagram 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 instagram token generation.
After hitting the "Connect" button, a popup will open to guide you through instagram 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 |
|---------|-------------------------------------------------------------------------------|
| `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: instagram
connector_config:
api_connect_permission_private: ['user_profile', 'user_media'] # default value
api_connect_permission_business: ['pages_show_list', 'instagram_basic'] # 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)