madebyprisma/instagram

A simple toolkit that allows for one-click CMS integration with Instagram

v2.5.3 2022-09-08 15:38 UTC

AGPL-3.0-only

• Jesse Solomon

README

composer require madebyprisma/instagram

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

Getting Started

1. 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

1. Assign your app keys:

# mysite.yml

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

1. 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