madebyprisma/instagram

Instagram Integration for SilverStripe

composer require madebyprisma/instagram

A simple toolkit that allows for one-click CMS auth for an Instagram account.

Getting Started

• Setup a Facebook app with Instagram Basic Display See Facebook Docs

• Setup Notes:
  • The CMS integration only works with https, however manually generated test tokens work locally.
  • Valid OAuth Redirect URIs should direct to https://{your-domain}/prisma.instagram/authorize
  • Deauthorize Callback URL should direct to https://{your-domain}/prisma.instagram/deauthorize
  • Data Deletion Request Callback URL should direct to https://{your-domain}/prisma.instagram/delete_data

• Assign your app keys:

# mysite.yml

Prisma\Instagram:
  app_id: {Instagram app ID}
  app_secret: {Instagram app secret}

• You or the client can then link an Instagram account by clicking on Link Account inside of Admin > Settings > Instagram

Reference

class Prisma\Instagram

• static function getMedia(int $limit = 5) ArrayList<Post>

DataObjet Post

• InstagramID: Int - ID of the Post
• Type: "IMAGE" "VIDEO" "CAROUSEL_ALBUM" - Media type, if this post is a child, then it will only be "IMAGE" or "VIDEO"
• ISOTimestamp: String - ISO8601 timestamp of the post
• URL: String - The URL to the post media
• ThumbnailURL: String - The URL to the post thumbnail, only available for "VIDEO"
• Caption: String? - Caption on the post, may be empty
• Children: ArrayList<Post>? - The posts children, only valid if Type is "CAROUSEL_ALBUM"
• PermaLink: String - The permalink to the post