Basic wrapper for Seaofclouds / Tweet.js that incorporates functionality with Twitter's v1.1 API
PHP JavaScript
Switch branches/tags
Nothing to show
Latest commit 2f412c5 Jul 11, 2013 @StanScates Merge pull request #26 from RKD-Graphics/master
new minified version
Permalink
Failed to load latest commit information.
twitter new minified version Jul 4, 2013
.gitignore Updating documentation Feb 21, 2013
CHANGELOG.md Version 1.4 Apr 23, 2013
LICENSE Initial commit Feb 20, 2013
README.md Version 1.4 Apr 23, 2013

README.md

v1.4

Why?

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.

Features

  • 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, domain.com/twitter).

  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 https://dev.twitter.com/apps 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() {
    $('.twitterfeed').tweet({
        modpath: '/assets/twitter/',
        count: 5,
        loading_text: 'loading twitter feed...',
        /* etc... */
    });
</script>
  1. That's all.

Caveats

  • Does not spontaneously spawn kittens. [in progress]

Support

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.