Setting up the Instagram stream
1 / Create a Facebook app
Create a new app with the button “Create app” at the top right.
In the App details dialog, enter a suitable app name.
Under Business messaging, select the use case “Manage messaging & content on Instagram”.
In the Business step, choose the option “I don’t want to connect a business portfolio yet” and click Next again.
Skip the following Requirements step without selecting anything (just click Next). An overview appears – use “Go to dashboard” to switch to the app dashboard.
In the left navigation bar, open Use cases and click “Customize”.
This area contains the Instagram app ID and the app secret. You will enter both values later in the corresponding Social Feed account in the Contao back end.
Scroll further down and click “Set up” at “4. Set up Instagram business login”.
A popup opens. Enter the redirect URL there:
https://your-domain.com/_instagram/auth
(Replace the domain with the one of your own website.)
At the bottom left of the menu, open App roles → Roles (1). Use the button “Add people” (2) to add a new role of type “Instagram tester” (3). In the search field, enter the name of the Instagram account whose content you want to read, select the correct account from the results and click “Add”.
Accept the invitation at the following link: https://www.instagram.com/accounts/manage_access
In the tab “Tester invites”, click “Accept”.
The Instagram tester should now be shown in the app roles – without the status “Pending”.
2 / Create a news archive
First create a new news archive. It collects your Instagram posts. When setting it up you have to specify a redirect page, although it plays no role for the Social Feed bundle. For a better overview, we recommend creating a separate archive for each Instagram account. That way you can easily hide individual accounts in the news list module later.
3 / Create an account and generate a token
Account settings
In the left navigation, go to PDIR APPS and click Social Feed accounts. Choose New account to create a new Social Feed account for the import.
Select Instagram as the type.
Paste the App ID and App secret into the corresponding fields, save, and use the button Request access token to generate a new access token. Before that, select the correct news archive into which the Instagram posts should be imported. You find the App ID and App secret in the Facebook app under API setup with Instagram business login.
Generate the access token
When you tick Request access token, you should be redirected to Instagram.
Log in with your Instagram credentials and confirm the access request with the button Allow.
The access token should now be generated and the fields Instagram access token and Access token expires on should be filled in.
Other fields
- Instagram account: Enter the profile name that should be shown on the website.
- Maximum number of posts: Defines how many posts are imported.
- News archive: Select the news archive into which the Instagram posts should be imported.
- Cron job execution: Choose how often the cron job runs to import new Instagram posts. The options are: no cron job, every minute, hourly, daily, weekly and monthly.
- Last import: The two text fields for the last import only show when the last import took place. Empty them to force a new import.
- Profile image: The profile image is not imported by default, so select it in this field to show it on the website. You can also set an image size, e.g. Important part, 50x50px.
4 / Create a module
The page Module setup contains everything else about creating and placing the module.