Instagram API

Instagram API can be used to build non-automated, authentic, high-quality demonstrative blocks.

Official documentation

For more detailed information and examples, see the official documentation: Instagram API .

How to use?

Wrap any block in a parent element with an ID or class and add the same ID in the JS init function of the hs.instagram.js plugin and include the data-user-id, data-client-id and data-token data attributes.

Copy-paste the following <script> near the end of your pages under JS Implementing Plugins to enable it.

<script src="../../assets/vendor/instafeed.js/instafeed.min.js"></script>

Copy-paste the following <script> near the end of your pages under JS Front to enable it.

<script src="../../assets/js/helpers/hs.instagram.js"></script>

Copy-paste the init function under JS Plugins Init., before the closing </body> tag, to enable it.

<script>
  $(document).on('ready', function () {
    // initialization of instagram api
    $.HSCore.components.HSInstagram.init('#instaFeed', {
      after: function () {
        // initialization of masonry.js
        var $grid = $('.js-instagram').masonry({
          percentPosition: true
        });

        // initialization of images loaded
        $grid.imagesLoaded().progress(function () {
          $grid.masonry();
        });
      }
    });
  });
</script>

JavaScript behavior

Objects

Quality of the images.

resolution: 'standard_resolution' - string

Valid values are:

  • thumbnail (150x150)
  • low_resolution (306x306)
  • standard_resolution (612x612)

Default value is: thumbnail

Callbacks

before: function (invoker) {} - function
after: function (invoker) {} - function
success: function (invoker) {} - function
error: function (invoker) {} - function

Methods

Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-user-id="".

Attributes Description

data-user-id

A unique user ID. Use if data-get is set true.

data-get

data-client-id

An ID obtained with the Instagram API. Required!.

data-token

A valid oAuth token. Can be used in place of / along with the user ID.

data-get

Determines which type of images to output.
Valid values are:
  • user
  • popular
  • tagged
  • location
Default value is user

data-limit

Specifies the limit on the number of output images.

data-template

A template element.

afterShow: function (invoker) {}

Executes the code inside the body of the function each time it appears.

beforeShow: function (invoker) {}

Executes the code inside the body of the function each time it appears.

success: function (invoker) {}

Executes the code inside the body of the function if the plugin received the data.

error: function (invoker) {}

Executes the code inside the body if the images could not be loaded.
Contact Us