🎞️ Strapi Plugin: Cincopa Uploader

A powerful Strapi plugin for uploading and managing media assets in Cincopa directly from the Strapi Admin Panel.

✨ Features

• 📤 Upload videos, images, and other assets to Cincopa
• 🔍 Search for assets by title or Cincopa Asset ID
• 🖝️ Link uploaded assets to custom collection types
• 🔄 Sync asset status automatically via Cincopa webhooks
• 🌐 Full Sync Mode for syncing all Cincopa assets

🛠️ Installation

This plugin is compatible with Strapi v5.

npm install strapi-plugin-cincopa-uploader@latest

⚙️ Configuration

After installation, configure the plugin based on your project setup.

Plugin Setup

JavaScript:

1// ./config/plugins.js
2module.exports = ({ env }) => ({
3  'cincopa-uploader': {
4    enabled: true,
5    config: {
6      apiToken: env('CINCOPA_API_TOKEN'),
7      fullCincopaSync: false,
8    },
9  },
10});

TypeScript:

1// ./config/plugins.ts
2export default ({ env }) => ({
3  'cincopa-uploader': {
4    enabled: true,
5    config: {
6      apiToken: env('CINCOPA_API_TOKEN'),
7      fullCincopaSync: false,
8    },
9  },
10});

Environment Variable:

1CINCOPA_API_TOKEN=your_actual_api_token_here

Restart the server after saving changes:

npm run develop

📢 Webhook Setup

Enable real-time synchronization by configuring a webhook in your Cincopa account.

• Go to your Cincopa Dashboard
• Create a new webhook
• Set the URL:

1https://your-strapi-domain.com/api/cincopa-uploader/webhook

Note: Webhook signature verification is currently disabled (may be added in future updates).

For local development, use ngrok:

ngrok http 1337

Then set the ngrok public URL in the webhook configuration.

🌐 Full Sync Mode

If fullCincopaSync is set to true, the plugin will synchronize all assets in your Cincopa account, not only those uploaded via Strapi.

Modify in your plugin config:

1fullCincopaSync: true

📅 Usage

Uploading Assets

• Navigate to Cincopa Uploader in the Strapi Admin Panel
• Upload via file or remote URL
• Uploaded media is linked to custom collection types easily

Asset Management

• Create or update entries by associating uploaded Cincopa assets
• Example: Create an "IKEA Stores" collection type and attach video tours

API Access

Enable public API access for your content:

• Go to Settings > Roles > Public
• Enable find and findOne permissions for your collection types

Fetch your data via:

curl http://localhost:1337/api/ikea-stores

Assets will appear with metadata, media URLs, and thumbnails.

💡 FAQ

The plugin doesn't show in Admin UI?

rm -rf .cache build
npm run build
npm run develop

Webhooks don't work locally?

Use ngrok or a similar tunneling tool.

💬 Support

For assistance, contact support@cincopa.com

📄 License

MIT