• MODX.com



TwitterX is an extra by qodo, first released on 2015-08-04.

Package Description

TwitterX v1.3.7

This package loads Twitter feeds and searches using the new (and very annoying) Twitter 1.1 API. You will need to create a Twitter app here: https://dev.twitter.com/apps/new

Once you've created your new application you will need to generate tokens and use those tokens when you call the TwitterX snippet which will load your statuses:

Snippet TwitterX

This should be called uncached if you are using :ago in the chunk otherwise it can be cached.

[[!TwitterX?     &twitter_consumer_key=`aaaa`    &twitter_consumer_secret=`bbbb`     &twitter_access_token=`cccc`     &twitter_access_token_secret=`dddd`    &limit=`4`    &timeline=`user_timeline`    &chunk=`TwitterXTpl`    &cache=`7200`      &screen_name=`Qodo` &include_rts=`1` ]]

  • twitter_consumer_key - your twitter consumer token (REQUIRED)
  • twitter_consumer_secret - your twitter consumer secret (REQUIRED)
  • twitter_access_token - your twitter access token (REQUIRED)
  • twitter_access_token_secret - your twitter access token secret (REQUIRED)
  • limit - limit how many statuses to display (default: 5)
  • timeline - which twitter timeline to load (default: user_timeline)
  • chunk - which chunk to load when rendering the statuses (default: TwitterXTpl)
  • cache - how many seconds to cache the twitter data feed (default: 7200)
  • screen_name - which user(s) you want to load (comma separated)
  • include_rts - should this include retweets (default: 1)
  • ** NEW ** exclude_replies - should this exclude replies (default: 0)
  • cache_id - unique ID for caching in case you want to view multiple feeds or different feeds  (default: TwitterX_PAGEID)
  • toPlaceholder - a placeholder ID if you want to use content as a placeholder instead of outputting directly (default: '')
  • toPlaceholderPrefix - if you want to prefix the placeholder values. E.g. 'twitterx' would create placeholders like [[*twitterx.text]] (default: '')
  • search - search Twitter using a search value. When using this parameter, screen_name and timeline are ignored. (example: &search=`MODX`)
  • slug - for when loading a twitter list, you must specify a screen_name and a slug (default: '')

Loading timelines

As the 1.1 API is more restrictive the tweets available have changed. The snippet defaults to user_time line but you can load any of these:

  • public_timeline
  • public_timeline
  • friends_timeline
  • user_timeline
  • mentions
  • retweets_of_me
  • favourites

Loading lists ** New as of 1.3 **

You can now load lists by using the following:   

&timeline=`lists/statuses`    &slug=`NAME_OF_YOUR_SLUG`&screen_name=`SCREEN_NAME_OF_LIST_OWNER`

An example of this would be the MODX List: https://twitter.com/modx/the-modx-team   

&timeline=`lists/statuses`    &slug=`the-modx-team`    &screen_name=`modx`

Searching Twitter

TwitterX now supports basic Twitter searches using the &search parameter:&search=`MODX`

Snippet TwitterXFormat

Use this snippet in your chunk placeholders to format the status text and automatically link any search, usernames or topics:[[+text:TwitterXFormat]]

Chunk options

The package comes with a chunk for displaying the statuses called 'TwitterXTpl'. You can customise this by using the following placeholders:

  • created_at - date status was created
  • source - source of the Tweet (application like web, iOS etc)
  • id - status id on Twitter
  • text - status main text
  • name - Twitter name
  • screen_name - Twitter username
  • profile_image_url - Twitter avatar image url for this user (uses https as of version 1.3.3)
  • location - This users location
  • url - This users URL (if specified)
  • description - This users profile information

Retweets (where applicable)

  • retweet_created_at - date status was created
  • retweet_source - source of the Tweet (application like web, iOS etc)
  • retweet_id - status id on timeline
  • retweet_id_str - status id on Twitter (twitter.com/user/statuses/id_str)
  • retweet_text - status main text
  • retweet_name - Twitter name
  • retweet_screen_name - Twitter username
  • retweet_profile_image_url - Twitter avatar image url for this user (uses https as of version 1.3.3)
  • retweet_location - This users location
  • retweet_url - This users URL (if specified)
  • retweet_description - This users profile information

Further info

For information and support, check out my blog:


Usage/Installation Instructions

Install from MODX package manager and follow instructions at http://www.qodo.co.uk/blog/twitterx-a-new-modx-extra-for-pulling-in-twitter-feeds-using-api-1.1/


First seen
Supported databases
Minimum MODX Requirement

TwitterX Releases

Vendor Signature Released on
MODX.com 1.4.0-pl 2022-04-12 (2 years ago)
MODX.com 1.3.7-pl 2015-08-04 (8 years ago)

We've also seen 13 unverified versions of TwitterX in use, but don't list those as we've been unable of confirming they are official releases from an official source.