Installation

Overview · Configuration · Usage · FAQ · Developer notes

Requirements

CS-Cart or Multi-Vendor 4.17.2 to 4.21.x, PHP 7.4 to 8.3 with the curl and gd extensions (gd resizes the images; without it JPEG photos are stored as they are).
An Instagram professional account (Business or Creator). Personal accounts cannot use the Instagram API.
A Meta developer account and an app of the Business type with the Instagram product (free). You create it once; the add-on uses only your own app and token.
HTTPS on the admin URL if you use the “Connect with Instagram” button (Meta accepts only https redirect URIs).

Install

Add-ons > Manage > upload kv_instagram_feed-1.0.0.zip and install it.
Enter the license key on the add-on page (License tab or the card at the top).
Open Marketing > Instagram feed and connect your account (see Configuration).
Click Sync now. Your newest posts appear within a few seconds.
Add the block Instagram feed in Design > Layouts (see Usage).

Cron job

Run every hour from the store folder:

php admin.php --dispatch=kv_instagram_feed.cron

Over HTTP: https://your-store/admin.php?dispatch=kv_instagram_feed.cron&cron_password=... with the cron password of Settings > Security. Each run syncs every connected account whose sync is due and refreshes tokens older than 7 days. Without a cron job the feed is synced when an administrator opens Marketing > Instagram feed and a sync is due.

Upgrade

Upload the new zip over the old files (Add-ons > Manage > upload). The add-on applies new tables and settings itself on the next admin page view. Posts, tags and the connection are kept.

Uninstall

Uninstalling removes the add-on tables (posts, tags, log), the stored connection and the image copies in images/kv_instagram_feed/. Nothing is deleted on Instagram. You can remove the app from your Instagram account under Settings > Apps and websites.