codeq/instagram

Instagram images list for Neos CMS

v2.2.0 2023-10-16 19:58 UTC

Requires

• php: >= 7.4
• neos/neos: ^4.0 || ^5.0 || ^7.0 || ^8.0

MIT

• Roland Schütz

README

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.