Skip to content

code-q-web-factory/neos-instagram

Repository files navigation

Instagram images list for Neos CMS

This package retrieves instagram media files through the Facebook API to display it. Version two implements the new Facebook API.

The development and the public-releases of this package are generously sponsored by Code Q Web Factory.

Installation

CodeQ.Instagram is available via packagist, and compatible to the Facebook API in version 2. Add "codeq/instagram" : "~2.1" to the require section of the composer.json or run:

composer require codeq/instagram

We use semantic-versioning so every breaking change will increase the major-version number.

Usage

  1. Create a Facebook Instagram app. Complete steps 1-4 of these Facebook instructions until and including "Step 3: Create instagram test user". As OAuth Redirect URI please use https://{YOUR_DOMAIN}.at/instagram-endpoint
  2. Set the Instagram app id as CodeQ.Instagram.appId and the app secret as CodeQ.Instagram.appSecret in your project configuration
  3. Follow "Step 4: Authenticate test user" and go to https://api.instagram.com/oauth/authorize?client_id={YOUR_APP_ID}&redirect_uri=https://{YOUR_DOMAIN}/instagram-endpoint&scope=user_profile,user_media&response_type=code and run the authorization process.

How to render images

<CodeQ.Instagram:ImagesList
	attributes.class="instagram-images-list instagram-images-list--images-per-row-3"
	limit="12"
	/>

By default, we do not include any styling. Feel free to include Resources/Private/Fusion/InstagramList.scss into your own build process are create any custom styling.

License

Licensed under MIT, see LICENSE

Contribution

We will gladly accept contributions. Please send us pull requests.


Code Q