← Back to plugins index

🐤 Latest tweets

This plugin displays the latest tweets from a Twitter account.

Supported features
→ Full specification		 📗 Classic template 📒 Markdown template
👤 Users đŸ‘Ĩ Organizations
🗝ī¸ plugin_tweets_token
Latest tweets with attachments
Latest tweets
## ➡ī¸ Available options
OptionDescription

plugin_tweets

Enable tweets plugin
🌐 Web instances must configure settings.json:
  • metrics.api.twitter.tweets
type: boolean
default: no

plugin_tweets_token

Twitter API token
🔐 Token
type: token

plugin_tweets_user

Twitter username
⏯ī¸ Cannot be preset
type: string
default: → User attached twitter

plugin_tweets_attachments

Tweets attachments

Can be used to display linked images, video thumbnails, etc.
type: boolean
default: no

plugin_tweets_limit

Display limit
type: number (1 ≤ đ‘Ĩ ≤ 10)
default: 2
## 🗝ī¸ Obtaining a Twitter token To get a Twitter token, it is required to apply to the [developer program](https://apps.twitter.com). It's a bit tedious, but requests seems to be approved quite quickly. Create an app from the [developer dashboard](https://developer.twitter.com/en/portal/dashboard) and register your bearer token in repository secrets. ![Twitter token](/.github/readme/imgs/plugin_tweets_secrets.png) ## ℹī¸ Examples workflows ```yaml name: Latest tweets uses: lowlighter/metrics@latest with: filename: metrics.plugin.tweets.svg token: NOT_NEEDED base: "" plugin_tweets: yes plugin_tweets_token: ${{ secrets.TWITTER_TOKEN }} plugin_tweets_user: github ``` ```yaml name: Latest tweets including attachments uses: lowlighter/metrics@latest with: filename: metrics.plugin.tweets.attachments.svg token: NOT_NEEDED base: "" plugin_tweets: yes plugin_tweets_token: ${{ secrets.TWITTER_TOKEN }} plugin_tweets_attachments: yes plugin_tweets_user: github plugin_tweets_limit: 1 ```