PHP Twitter Widget


A PHP alternative to the Twitter Embed Timelines JavaScript.

Twitter Embedded Timelines allow you to show your latest tweets using JavaScript. While this can help you easily implement your latest tweets on you website, I needed to create a similar effect without including any additional JavaScript files on the web page.

I decided to create a script that will fetch tweets server-side, and allow for including in a web page without JavaScript includes. I also needed to ensure I cached the result, to avoid hitting API limits.

Using the popular TwitterOAuth PHP Library for authentication, we can access the Twitter Rest API.

Works with PHP 5.3+ through to PHP 7+.


First, you need to head over to and register your new Application. You will need the following keys for your new 'App'.

  • Consumer Key
  • Consumer Secret Key (This must always remain private)
  • Access Token
  • Access Token Secret

You can now install the PHP Twitter Widget using composer:

composer install benhall14/php-twitter-widget

To implement, first instantiate a TwitterWidget with your credentials to fetch the feed. The feed will be cached so we don't call the API on every page load. The default cache file age limit is 3600 seconds (1 hour).

require '../vendor/autoload.php';

try {
$twitterWidget = new TwitterWidget(
$consumer_key, # your Twitter consumer key
$consumer_secret, # your Twitter consumer secret
$access_token, # your Twitter access token
$access_token_secret, # your Twitter access token secret
'nasa', # the screen name of the Twitter feed to display
15, # the number of tweets to return
'../cache/twitter_status_feed.json', # path to the cache file
3600 # the number of seconds to cache the feed for, default is 3600 (1 hour)
} catch (Exception $e) {
/* handle any error thrown, such as unwritable cache file */
echo $e->getMessage();

You can then use the following to display the feed on your web page, passing the your chosen feed title, such as "My Tweets". The second optional parameter should be a boolean of whether to print(true) or return(false) the formatted feed. The third optional parameter is the tweet date format - default = M d H:i A.

echo $twitterWidget->display('My Tweets', true, 'M d H:i A');


Works with PHP 5.3, PHP 5.5, PHP 5.6, and PHP 7

PHP CURL Extension

TwitterOAuth Library


Copyright (c) Benjamin Hall, -

Licensed under the MIT license


If you find this project helpful or useful in any way, please consider getting me a cup of coffee - It's really appreciated :)


More Projects?
View Code Showcase
Benjamin, is brilliant at what he does, he really knows what he is at. Gives real useful advice and guidance. He is fast and timely provides updates and always provides solutions and listens well. Trust me Benjamin is a breath of fresh air.
- Alexander T.
Ben had a great idea for my project and completed the project to our requirements very quickly. He also helped me tweak a few issues and answered my questions quickly. We'll work with Ben again!
- Gordon S.
I was impressed: a freelancer who could give me inputs and details on how he'd implement the solution, kept me updated in the meanwhile, understood my requirements and proposed pretty nice tweaks to make things even better. Ben, you are amazing. I will need no more time to find any other dev's, and will surely deal with you again if I need something related to these things in the future. Full stop.
- Marco F.
Absolutely superb, a great work ethic, outstanding knowledge and a great eye for detail. I thoroughly recommend him!
- Gary J.
Benjamin is a talented developer who can tackle technically challenging projects with great service and communication. Thoroughly recommended.
- Steven M.
Ben truly went above and beyond. He's fantastic at communication, coding, getting round problems, fixing issues, WordPress, custom plugins and much more. I will be using Ben again for other projects.
- Rachael R.
Ben went the extra mile and not only resolved the problem but provided a more suitable solution for the long term. Cheers!
- William R.
Ben is an amazing developer. He took the project and delivered it on time and within budget, whilst maintaining excellent communication. He also worked beyond what was asked to make sure the project was functioning correctly. Would highly recommend A++++!
- David B.
Fantastic work on our JS script. Ben worked beyond the goals of the project and overcame extra issues that were not defined in the project. He is very quick to respond and patent when waiting for our response. One of our top 5 Developers, We had to deal with many Interfaces including server firewalls/Java-scripting/JSON/PHP/PHP APIs/Remote Databases and automation.
- Kevin J.
Ben is just great to work with. Efficient, clearly communicating, understanding very quickly, and also giving great advice. I will continue working with Ben on any other WordPress stuff. Sorry for all those other PPH'ers :-)
- Bruno V.
Absolutely amazing experience. Ben is an expert in this field, I was amazed at how quickly he jumped on our platform and decoded the code, db etc. He will go over and above to find solutions for clients. Highly recommended.
- Harrus A.
Interested in working together to make something great? Hire CONOBE