Skip to main content

Twitter

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.

Note

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.