Instagram Photos

This feature enables photos to be displayed from the Instagram API. To enable this feature, follow the steps in each section below.


Generate an Access Token

This widget requires an access token generated from a client. To create a client, follow the steps below:

  1. Visit http://instagram.com/developer/clients/register/ and sign in
  2. Fill out the OAuth redirect_uri field with http://localhost
  3. Fill out the rest of the required fields
  4. Uncheck the Disable implicit OAuth option
  5. Click submit
  6. Find your Client ID

To authorise the client, replace CLIENTID with your Client ID in the URL below:

https://instagram.com/oauth/authorize/?client_id=CLIENTID&redirect_uri=http://localhost&response_type=token

To generate your access token:

  1. Visit the URL above, which contains your Client ID
  2. Grant access to your account
  3. When redirected copy the text after localhost/#access_token= and keep it safe

Add Your Configuration

This widget requires configuration, these requirements are detailed below:

Option Note
instagram.data.count Photos per page
instagram.data.access_token Your access token
instagram.url URL to get photos from. These are documented here

Below is an example of how your configuration should look:

"instagram" : {
  "data" : {
    "access_token" : "1234567890.a12345b.ab123ab123a12a1234a1a1234a12345",
    "count" : 4,
  },
  "url" : "https://api.instagram.com/v1/media/popular"
},

To add your configuration, follow the steps below:

  1. Locate the theme folder. Example: /ghost/content/themes/ghost-theme/
  2. Open partials/config.hbs
  3. Add your configuration
  4. Save partials/config.hbs

Add Theme Partial

This widget requires a theme partial. To add the partial, follow the steps below:

  1. Open default.hbs
  2. Find {{!> "instagram" }}
  3. Remove the exclamation mark to add the partial
  4. Save default.hbs
  5. Restart Ghost

Still need help? Contact Us Contact Us