jquery-insta-bam.js

/** @preserve
 * insta-bam
 *
 * Created at: 2012-11-20 21:22:09 +0100
 * Updated at: 2013-11-19 16:21:40 +0100
 *
 * Author: @clrblnd (+ @ivow for the way of the code)
 * Version: 1.2.2
 *
 */

/*global jQuery:false console window*/

(function($, window) {
  "use strict";

  var tmpl_feed = '<a href="{{instagram_url}}" class="instabam"><img src="{{instagram}}" alt="{{caption}}" data-likes="{{likes}}" /><time datetime="{{created_at_iso}}" title="{{created_at_formatted}}">{{created_at_formatted}}</time></a>';

  var plugin_name = 'instaBam',
      defaults    = {
        doneCallback  : null,
        list          : null,
        tmpl_feed     : tmpl_feed
      },
      ISODateString;

  function InstaFeed(element, url, options){
    this.element  = element;
    this.options  = $.extend( {}, defaults, options );
    this.url      = url;
    this.id       = this.url.hashCode();
    this.cache    = window.sessionStorage[plugin_name + this.id];

    this.init();
  }

  InstaFeed.prototype.init = function(){
    var _this = this;

    if ( window.JSON && window.Storage && _this.cache !== undefined) {
      _this.output( $.parseJSON(_this.cache) );

    } else {
      $.ajax({
        dataType: 'jsonp',
        success: function( response_data ){

          // Check if API response isn't an error
          // http://instagram.com/developer/endpoints/
          if ( response_data.meta.code !== 200 ) {
            if ( $.isFunction(_this.options.onErrorAPI) ) {
              _this.options.onErrorAPI.call( _this.element, response_data );
            }

          } else {
            if ( window.JSON && window.Storage ) {
              window.sessionStorage[plugin_name + _this.id] = JSON.stringify( response_data );
            }
            _this.output( response_data );

          }

        },
        url: _this.url
      });

    }

  };

  InstaFeed.prototype.output = function( data ){
    var _this       = this,
        $this       = $(this.element),
        feed_result = [],
        $ul         = this.options.list ? this.options.list : $('<ul />');

    // check for whitelist data
    if(_this.options.whitelist) {

      if(_this.url.indexOf('https://api.instagram.com/v1/tags/') != -1) {

        $.each( data.data, function(idx, value){
          if ( $.inArray(value.user.username,_this.options.whitelist) != -1 ) {
            feed_result.push(value);
          }
        });

      } else if (_this.url.indexOf('https://api.instagram.com/v1/users/') != -1) {

        $.each( data.data, function(idx, value){

          $.each( value.tags, function(idy, tagvalue){
            if ( $.inArray(tagvalue,_this.options.whitelist) != -1 ) {
              feed_result.push(value);
            }
          });
        });

      } else {
        // feed is all
        feed_result = data.data;
      }

    } else {
      // feed is all
      feed_result = data.data;
    }

    // read out result
    $.each( feed_result, function(idx, value) {

      var $li                   = $('<li />'),
          template              = _this.options.tmpl_feed,
          created_at            = new window.Date( parseInt(value.created_time * 1000, 10) ),
          created_at_formatted  = created_at.getFullYear() + '-' + (created_at.getMonth() + 1) + '-' + created_at.getDate(),
          created_at_iso        = _this.createdAtISO( created_at ),
          caption               = value.caption ? value.caption.text : "";

      template = template
        .replace(/\{\{instagram_url\}\}/g         , value.link)
        .replace(/\{\{instagram\}\}/g             , value.images.standard_resolution.url)
        .replace(/\{\{caption\}\}/g               , caption)
        .replace(/\{\{likes\}\}/g                 , value.likes.count)
        .replace(/\{\{created_at_iso\}\}/g        , created_at_iso)
        .replace(/\{\{created_at_formatted\}\}/g  , created_at_formatted);

      $li
        .append( $(template) )
        .appendTo( $ul );

    });

    // append content to element
    $ul.appendTo( $this );

    if ( $.isFunction( this.options.doneCallback) ) {
      this.options.doneCallback.call( this.element );
    }
  };

  InstaFeed.prototype.createdAtISO = function( date ) {
    function pad(n) {
      return n < 10 ? '0' + n : n;
    }
    return date.getUTCFullYear() + '-' + pad( date.getUTCMonth() + 1 ) + '-' + pad( date.getUTCDate() )+ 'T' + pad( date.getUTCHours() ) + ':' + pad( date.getUTCMinutes() ) + ':' + pad( date.getUTCSeconds() ) + 'Z';
  };

  // jQuery function
  $.fn.instafeed = function( url, options ){

    return this.each( function() {
      $(this).data( plugin_name, new InstaFeed(this, url, options) );

      var instabam_instance = $(this).data( 'instaBam' );

    });
  };

  // Helpers
  String.prototype.hashCode = function(){
    var hash = 0,
        i,
        character;

    if (this.length === 0) {
      return hash;
    }

    for (i = 0; i < this.length; i++) {
        character = this.charCodeAt(i);
        hash = ((hash<<5)-hash)+character;
        hash = hash & hash; // Convert to 32bit integer
    }
    return Math.abs(hash);
  };

}(jQuery, window));