in-square/opendxp-instagram-bundle

Instagram media sync bundle for OpenDXP.

v1.0.0 2026-03-30 13:51 UTC

Requires

• php: ^8.3
• insquare/opendxp-process-manager-bundle: @dev
• open-dxp/opendxp: ^1.0
• symfony/console: ^7.4
• symfony/framework-bundle: ^7.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• phpstan/phpstan: ^1.11

GPL-3.0-or-later

• Wladyslaw Dudko

• instagram
• opendxp
• opendxp-bundle
• opendxp-plugin

README

Bundle synchronizes recent Instagram media into OpenDXP DataObjects. It creates an InstagramItem class on install and provides a console command to fetch the latest posts (image assets + metadata).

Features

• Imports recent Instagram media into InstagramItem objects.
• Stores media as OpenDXP assets under a configurable folder.
• Automatically refreshes the Instagram access token when it is close to expiring.
• Can be scheduled via CRON or executed through OpenDXP Process Manager.

Configuration

Create config/packages/in_square_opendxp_instagram.yaml in the OpenDXP project:

in_square_opendxp_instagram:
    object_folder: '/instagram'
    assets_folder: '/instagram'
    items_limit: 6

Website Settings

Add or update these Website Settings in OpenDXP:

• instagram_token (text) - required access token.
• instagram_token_expires_at (text) - updated automatically after token refresh.

Usage

Install the bundle (creates InstagramItem DataObject):

php bin/console opendxp:bundle:install InSquareOpendxpInstagramBundle

Fetch recent items:

php bin/console insquare:instagram:update-photos -c 6

Process Manager

You can add insquare:instagram:update-photos as a Process Manager job in OpenDXP to run it on a schedule. The command uses ExecutionTrait, so it integrates with Process Manager out of the box.