Instafetch.js

Instafetch.js is a 6KB JavaScript plugin for the Instagram API using fetch instead of jQuery. This dev diaries fork adds the ability to link to a local page instead of Instagram if there is a local page to link to. You can accomplish this by passing in a links option to the instafetch settings:

instafetch.init({
    accessToken: 'REDACTED',
    target: 'instafetch',
    numOfPics: 10,
    caption: false,
    links: window.instagrams
});

The links array expects an id and url property:

[
    {
        id: "abcd123",
        url: "/social/my-sweet-page"
    },
    {
        id: "dcba321",
        url: "/social/my-other-sweet-page"
    }
]

Installation

Instafetch.js is available on CDNJS, NPM, Bower, and GitHub.

CDNJS

<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/instafetch.js/1.5.0/instafetch.min.js"></script>

NPM

npm install --save instafetch.js

require('instafetch.js');

Bower

bower install instafetch.js

<script type="text/javascript" src="path/to/bower_components/instafetch.js/dist/instafetch.min.js"></script>

GitHub

Download the script or the minified version in the dist folder.

<script type="text/javascript" src="path/to/instafetch.min.js"></script>

Usage

The Instagram API uses the OAuth 2.0 protocol, so you're going to need an access token. The easiest way to get your access token is login to Instagram on your browser and generate one on Pixel Union.

<script type="text/javascript">
  instafetch.init({
    accessToken: 'ACCESS TOKEN',
    target: 'instafetch',
    numOfPics: 20,
    caption: false
  });
</script>

Instafetch.js will look for an element with the ID of instafetch by default. The target element can be changed when initializing the plugin.

The plugin also allows you to set the number of items to return from your feed and if you want to include the captions.

Promise Polyfill

Instafetch.js was only 3KB initially, but those 3KB didn't support any version of Internet Explorer. IE will return "Promise is undefined" and the Instagram feed will be empty. Version 1.2 included the ES6-Promise polyfill, which added an extra 7KB just for IE. Version 1.3 removed the ES6-Promise polyfill for another Promise polyfill that only added 3KB.

Changelog

1.5

• Updated Promise polyfill
• Fixed bug for returned images without a caption

1.4

• Updated Fetch-JSONP
• Switched from ES5 to ES6

1.3

• Removed ES6-Promise polyfill
• Added Promise polyfill

1.2.2

• Fixed installation instructions for NPM

1.2.1

• Published different paths on NPM and Bower

1.2

• Added Browserify
• Added ES6-Promise polyfill for Internet Explorer support (Brian Hague)

1.1

• Changed Instagram API endpoint
• Removed user ID

1.0

• Initial release

Issues

Please submit any issues here.

License

Instafetch.js is licensed under the MIT License.