TwitterX v1.3.2

This uses twitteroauth: https://github.com/abraham/twitteroauth

This package loads Twitter feeds 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,Microsoft &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, retweeted_by_me etc)
• 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 you want to load
• include_rts - should this include retweets (default: 1)
• 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: '')
• 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 timeline
• id_str - status id on Twitter (twitter.com/user/statuses/id_str)
• text - status main text
• name - Twitter name
• screen_name - Twitter username
• profile_image_url - Twitter avatar image url for this user
• 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
• 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:

http://www.qodo.co.uk/blog/twitterx-a-new-modx-extra-for-pulling-in-twitter-feeds-using-api-1.1/

Created by Stewart Orr @ Qodo Ltd (http://www.qodo.co.uk). Contributers: @sepiariver (http://www.sepiariver.ca), @OostDesign (http://www.oostdesign.com/), @scottborys (http://scottborys.com/)