README

This Connector allows you to fetch social posts from Instagram (Currently only via basic display api).

Important

The Instagram Basic Display API has been shut down. Personal Instagram accounts are no longer supported. Therefor this extension only works with Creator or Business Instagram accounts!

Release Plan

Installation

"require" : {
    "dachcom-digital/social-data" : "~3.1.0",
    "dachcom-digital/social-data-instagram-connector" : "~4.0.0"
}

API via Facebook Login

If you want to use the facebook api, you also have to install the league/oauth2-facebook extension:

"require" : {
    "league/oauth2-facebook": "^2.0"
}

Add Bundle to bundles.php:

return [
    SocialData\Connector\Instagram\SocialDataInstagramConnectorBundle::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: 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.

framework:
    session:
        cookie_samesite: 'lax'

Setup App

Some hints to set up your instagram app

Instagram API with Instagram Login

Create Business App
Add "Instagram" Product
- Add https://YOURDOMAIN/admin/social-data/connector/instagram/check in Instagram => API setup with Instagram business login => 3. Set up Instagram business login => Business login settings
Select Instagram API with Instagram Login and store Instagram app ID and Instagram app secret in the pimcore connector section

Instagram API with Facebook Login

Create Business App
Select Instagram API with Facebook Login and store App-ID and App Secret in the pimcore connector section
Add "Facebook Login for Business" Product
- Add https://YOURDOMAIN/admin/social-data/connector/instagram/check in Valid OAuth Redirect URIs in section "Settings"

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

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: instagram
            connector_config:
                api_connect_permission_instagram_login: ['instagram_business_basic'] # default value
                api_connect_permission_facebook_login: ['instagram_basic', 'pages_read_engagement', 'pages_show_list', 'business_management'] # default value

Upgrade Info

Before updating, please check our upgrade notes!

License

For licensing details please visit LICENSE.md

dachcom-digital / social-data-instagram-connector

Maintainers

Details