Setting up the Twitter stream
1 / Create a Twitter developer account and app
To show Twitter posts on your website you need a Twitter account and a Twitter developer account. You find a step-by-step guide here: Setting up the developer account/Twitter app.
Since February 2023, tweets can no longer be read with the free Twitter API. You need at least the Basic plan for USD 100/month for the tweet import to work.
2 / Create a news archive
First create a news archive into which the Twitter posts will be imported. You have to specify a redirect page for the news archive because it is a mandatory field, although it is not relevant for the Social Feed bundle as there is no news detail page. Ideally, create a separate news archive for each Twitter account, so you can deselect individual accounts in the news list module later.
3 / Create an account
To create an account, click Create a new Social Feed account and select the type Twitter. A form opens where you enter all the required account data. After saving, it may take 2-3 minutes until all posts are imported.
- API key: Found in the app details in the tab “Keys and tokens”.
- API secret key: Found in the app details in the tab “Keys and tokens”.
- Access token: Found in the app details in the tab “Keys and tokens”.
- Access token secret: Found in the app details in the tab “Keys and tokens”.
- Twitter account: Enter the name of the Twitter account, without @.
- Search term: Instead of showing the posts of an account, you can also search for a specific term.
- Maximum number of posts: The maximum number of posts imported at once.
- News archive: Select the news archive into which the Twitter posts should be imported.
- Cron job execution: Choose how often the cron job runs to import new Twitter posts. The options are: no cron job, every minute, hourly, daily, weekly and monthly.
- Also import retweets: If you enable this checkbox, retweets are imported and shown as well.
- Also import replies: If you enable this checkbox, replies are imported and shown as well.
- Link hashtags and mentions: If you enable this checkbox, hashtags (e.g. #contao) and mentions (e.g. @pdirGmbH) are linked. For this, the template news_social_feed_extended must be selected in the news list module.
- Last import: The two text fields for the last import only show when the last import took place.
4 / Create a module
The page Module setup contains everything else about creating and placing the module.
