Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time
Apr 23, 2013
Feb 20, 2013
Apr 23, 2013



seaofclouds / tweet has always been one of my preferred methods of client-side twitter integration. With the advent of Twitter's 1.1 API and the deprecation of 1.0, client side timeline fetching and parsing is no longer feasable due to the authentication restrictions imposed by OAuth. This exists to serve as a layer in between, serving the JSON directly to Tweet.js and caching it in a flat .json file to compensate for the v1.1 API's access limitations on sites which require more than ~12 loads of a user's timeline per minute.

This mod works as an intermediary between seaofclouds / tweet and the twitter JSON api which it uses to fetch tweets. It handles the server-side authentication process and (optionally) caches the JSON file locally to avoid being throttled, which it then passes off to seaofclouds / tweet as normal. Simple yet effective.


  • Works with Twitter API v1.1.
  • Caches resources server-side in flat JSON files.
  • Easily configurable.
  • Supports all features of seaofclouds / tweet.
  • Supports OAuth Token Authentication (via Twitter App)

How to use

For existing seaofclouds / tweet users:

  1. Acquire /twitter/. How you wish to structure the files is up to you, but by default it is designed to be placed in the docroot of your website as a whole. (IE,

  2. Replace your existing JS reference to jquery.tweet.js to the modified one provided. <script type="text/javascript" charset="utf-8" src="/twitter/jquery.tweet.js"></script>

  3. You need to have a twitter App for your usage in order to obtain OAuth credentials, see for help.

  4. After creating your app, configure index.php with your OAuth credentials, and enable caching if you desire. Your cache directory of choice must be writable by PHP.

  5. If you keep index.php somewhere besides /twitter/, specify the path to it via the modpath option, relative to your domain. For example:

<script type="text/javascript">
$(document).ready(function() {
        modpath: '/assets/twitter/',
        count: 5,
        loading_text: 'loading twitter feed...',
        /* etc... */
  1. That's all.


  • Does not spontaneously spawn kittens. [in progress]


If you are having issues, set $debug = true; in index.php. Errors should be logged to the JS console on execution.

If you still can't figure it out, feel free to contact me or submit an issue.

Unfortunately, I can not guarantee any support for this. I will, however, provide help and support within the constraints of my schedule.


Basic wrapper for Seaofclouds / Tweet.js that incorporates functionality with Twitter's v1.1 API




No releases published


No packages published

Contributors 4

You can’t perform that action at this time.