Instagram generator

IMPORTANT: Instagram had limited down the accessability of their APIs, and from June 1, 2016 you will be most likely only able to access your own images, and only the last 20 from them! For more information, read the bottom of this documentation.
This dynamic slide generator is available in the PRO version only.

Tutorial

  1. Go to the Smart Slider's back-end Global Settings → Instagram generator, and copy the Callback url.

  2. Login to Instagram, and go to this page to create a new client.
  3. Give an Application Name, a Description, write your website's url to the Website URL field, and paste your Callback url into the Redirect URI(s), and pass the captcha.

  4. Now you will see the client you have just made. Copy the CLIENT ID and the CLIENT SECRET.

  5. Paste them into the Smart Slider's back-end Global Settings → Instagram generator. (Make sure that you don't have any empty space characters in the end or beginning of them.)

  6. Click on Request token, and authorize the popup window.
  7. You will see the token appearing, and you should save on your settings.

  8. Now the api is done, and you can create a new slider, or use an existing one.

  9. Choose to give dynamic slides to your slider.

  10. Pick one of the Instagram generators.

  11. Since Instagram had tighten the access of APIs, your API is in sandbox mode until they will review it, and let you go live. This means, that you can only get images from yourself. So if you want to do that, it's perfectly fine, but if you want to search for tags or for photos from another users, you can't do that until your API is live. Scroll down to the end of this documentation to know more about this.
  12. Set up your generator, choose the settings you think you want, change the number of slides to how many do you want to be in your slider, change the cache expiration to the time you want your slider to look for new data, and if you want to, you can check, what will be on your slides in the record viewer.

    Instagram can have images and videos, but they do not offer a way through their API to only ask down the images, so it has to happen from our end of the code. Because of this 10 slides might not mean 10 slides, but it's rather 10 data asked down from Instagram including videos, which will be removed. If you want to have exactly 10 slides, you should rather ask down more data, like 20, so you would surely have 10 images and give 10 to the  maximum slide count option.

  13. Now you can start working on how your slides will look with the datas of the first slide. You can put down layers, and use the VARIABLE signs to put that data inside them, what you want there to be.

  14. If something is not clear, check out how the dynamic slide generators work.

Filter

Search by tag
  • Search by tag - The tag you would like to search for.
Search for the tag without hashtag.
Correct search:

Incorrect search:
Photos by user
  • Username - The username from who you would like to show photos.

Variables

My feed, Search by tag, Photos by user
  • title - The title of the photo.
  • image - The standard resolution image of the photo.
  • title - The thumbnail image of the photo.
  • url - URL to the photo.
  • author_name - The full name of the author of the photo.
  • author_url - URL to the website of the author of the photo.
  • low_res_image - A low resolution image of the photo.
  • owner_username - The username of the owner of the photo.
  • owner_profile_picture - The profile picture of the owner of the photo.
  • owner_bio - The biography of the owner of the photo.
  • likes_count - The number of likes on the photo.
  • comments_count - The number of comments at the photo.
  • commentsX - The Xth comment of the photo.
  • commentsX_username - The username of the Xth comment of the photo.
  • commentsX_profile_picture - The profile picture of the Xth commenter of the photo.

Sandbox mode

Instagram had limited down the access to their APIs, and because of that you can only access your images, even if you had access before, because they put your API back in sandbox mode. You would be only able to get access to other's images, if they would review your API, and allow you to go live with it. Currently for the use cases of showing the kind of instagram contents in a slider, which are offered in our slider, won't allow you to go live with your API for several nonsense reasons, like:

"Which use case best describes your Instagram integration?

- I want to install a third party widget to show Instagram content on my website.
- You do not need to submit for review for this use case..... Your client can remain in sandbox mode and the widget will have access to your last 20 media...."

except we would like to show images from other people too, just there isn't that kind of option. Basically they don't want everyday people to use their APIs for other, than showing their own images.

So you really shouldn't even count of being able to use our slider to show other people's instagram contents, and if you really really want to, you could try to convince them to let your API go live, maybe even lie. The process of trying to approve your API is, this:

  • Go to your clients.
  • Click on the Edit button of our API.

  • Fill in every field with not just short test texts, but with real answers, which could be accepted.
  • Go to the Permissions tab, and if you filled in everything in the Details, you will be able to click on the Start a submission button.
  • If you want to, you can read the great "reasons", why you can't have an API, but you can skip that, and from three points you will be able to make a request.
  • Choose one of them, fill in the form under it, and hope for the best.
  • "You won't receive an email when your app is reviewed, but you can check the status of your submission in the Permissions tab of your client dashboard.", so you will have to check it now and then, and you will see, if they approved it.
  • If they approved it, at your clients click on Edit at your client, and at the Client Status row you will be able to click on go live.

One more option

Until then, at the Sandbox tab you have an option to include 10 users to your API, so actually you are not only able to get your images, but you can also get images from other users, who are invited to your API (and they accept the invitation).

Read more about this in here.