X (Twitter) Feed
The X (Twitter) Feed module shows recent posts from one X account in a responsive grid. It reads the posts with the X API. Reading a timeline needs a paid X API plan (Basic tier or higher). The free tier cannot return timelines. Create an app at developer.x.com to get your API key and secret.
The module caches the posts for one hour, so a new post can take up to an hour to appear. Replies and reposts are not shown.
How to add the X (Twitter) Feed module
- Add a section and a row, then add the X (Twitter) Feed module.
- Enter your handle and API credentials under Content > X Feed.
- Choose which elements to show and how many posts to load under Content > Elements.
Content
X Feed
- User Name: your X handle. The @ is optional.
- API Key (Consumer Key) and API Key Secret (Consumer Secret): from your X developer app.
If a field is empty, or no posts come back, the module shows a short message on the page instead of the grid.
Elements
- Sort By: Recent Posts, Old Posts, Favorite or Retweet. Default is Recent Posts.
- Number of Tweets: how many posts to show. Default is 8.
- Show X Logo, Show User Image, Show Name, Show User Name, Show Date, Show Favorite and Show Retweet: toggle each part of a post. User Name is off by default.
- Show Read More and Read More Text: a link to the post on X. Default text is "Read More".
Design
- Grid: Columns (default 3), Column Gap (Left/Right) and Column Gap (Top/Bottom) (default 20px each).
- User Avatar: Avatar Position, Avatar Placement, Avatar Offset X and Y, Profile Image Size (default 50px) and Avatar Spacing.
- Tweets: Alignment, X Logo Size, Tweets Padding and Description Bottom Spacing.
- Text: font options for the post text.
- Footer: Footer Alignment, Footer Padding, and the color and size of the Favorite and Retweet text and icons.