Skip to content
This repository has been archived by the owner on Sep 18, 2024. It is now read-only.

nineteen-2/statamic-instagram-basic-display-api

Repository files navigation

DEPRECATED

Suggestion replacement:

Display a user Instagram Feed using Instagram Basic Display API

Statamic 3.0+

📸 This addon provide a robust way to integrate Instagram Feed using Instagram Basic Display API

🔥 Using the API is the recommanded way to acces Instagram User Feed

⚡️ This addon also provide cache to limit API calls

📦 It is based on the Instagram Basic Display PHP API

Requirements

  • PHP 7 or higher
  • cURL
  • Facebook Developer Account
  • Facebook App

Get started

To use the Instagram Basic Display API, you will need to register a Facebook app and configure Instagram Basic Display. Follow the getting started guide.

Installation

Require it using Composer.

composer require nineteensquared/instagram

Configuration

Set the App ID and SECRET in the .env file

INSTAGRAM_APP_ID=
INSTAGRAM_APP_SECRET=

Set the OAuth Redirect URI in Instagram Basic Display configuration

For example: https://statamic.test/cp/nineteen-ig/auth

Connect to Instagram

Log into the control panel, and go to Tools > Instagram and click on the Login with Instagram button.

Tag

{{ instagram limit="6" as="ig" }}
    <div>
        {{ ig }}
            <a href="{{ permalink }}" >
                <img src="{{ thumbnail_url ?? media_url }}" alt="{{ caption }}" />
            </a>
        {{ /ig }}
    </div>
{{ /instagram }}


Parameters

Parameter Default Value Description
limit 12 Number of image

Variables

Variable Description
caption The Media's caption text. Not returnable for Media in albums.
id The Media's ID.
media_type The Media's type. Can be IMAGE, VIDEO, or CAROUSEL_ALBUM.
media_url The Media's URL.
permalink The Media's permanent URL. Will be omitted if the Media contains copyrighted material, or has been flagged for a copyright violation.
thumbnail_url The Media's thumbnail image URL. Only available on VIDEO Media.
timestamp The Media's publish date in ISO 8601 format.
username The Media owner's username.

Overriding configuration

php artisan vendor:publish --tag=instagram-config

Changelog

Please see CHANGELOG for more information what has changed recently.

Common error :

{
"error_type": "OAuthException",
"code": 400,
"error_message": "Insufficient developer role"
}

➡️ Add an Instagram Test User following step 3

Support

🐛 Open an issue on github