Contentful

Scaleflex DAM(Filerobot) Contentful App

The features of the Scaleflex DAM(Filerobot) App include:

• Asset Manager widget in Contentful Content Management;

• Multiple file types support(images, video, documents)

• Metadata configuration:

  • Asset metadata from Scaleflex DAM will show on your Rest/GraphQL response

  • You can choose which attributes will be saved in contentful content field

• Configuration for limited file types and maximum file count

There are 3 simple steps for enabling the App on your Contentful instance

• (prerequisite) Have a Contentful Account;

• Obtain a Scaleflex DAM token (request it here);

• Install the Scaleflex DAM App from the Marketplace;

• Add your security configuration parameters to access your Scaleflex DAM library.

Installation

Prerequisites

1. Register for a demo if you don't already have a Filerobot account.

2. Sign up to Contentful.

Contentful is 100% Cloud Native, so you have to sign up for a hosted CMS at https://be.contentful.com and you will get a link to your space:

https://app.contentful.com/spaces/{Your Space ID}/home

Step 1. Install from Contentful Marketplace

There are 2 ways:

• Find it here https://www.contentful.com/marketplace/ and install it or click install now on https://www.contentful.com/marketplace/app/scaleflex-filerobot/.

• Click Install to Contentful bellow

Step 2. Configure the app

Configuration keys(* = required):

• Token*: Your Scaleflex DAM token from the Asset Hub interface;

• Security Template*: Security template ID, found in the Developers top menu;

• Asset directory: This is the top storage folder for your assets, default is root dir(/)

You can quickly validate your token and security template by click "Validate Scaleflex DAM Setting"

• Limit: The max number of files that can be added to a single field

• Attributes: A string containing information (JSON attributes) that you want to store in a Contentful field, separated by commas. For example: meta, info.

• Limit Type(s): String type, acceptable values: any or all of the following: 'image', 'video', 'audio', 'application', 'application/zip', 'application/x-zip-compressed', 'application/vnd.rar', 'application/x-rar-compressed', separated by commas.

Please hard refresh your browser each time you change the settings for them to take effect.

Usage

Field Setting

• In any content model, create a new JSON Object Field

• In Appearance section, choose Scaleflex DAM

Content Editor

In any Scaleflex DAM Field, to insert assets from DAM to content, Click on Asset Manager

an Asset Dialog will be appear

Select one or more assets you want to add to the field.

Click "Insert" on the top right corner of the opened Dialog

You can have 2 options:

• Insert as original

• Insert as transformed(change the image extension type, image size)

After inserted, assets will appear like bellow:

You can

• Reorder assets position by drag and drop

• You can delete unwanted asset(one by one - click on 3 dot then select delete) or click Clear all to remove all selected assets

• Update manual update metadata if any change from the hub, please use "Refresh Assets" button

JSON format

[
    {
        "url": "https://try.filerobot.com/Widget_demo_folder/%24R202RV2-AiiacoEg.jpg",
        "id": "2a9de85c-406a-5101-9ab5-7b6259250005",
        "name": "$R202RV2-AiiacoEg.jpg",
        "extension": "jpg",
        "type": "image/jpeg",
        "attributes": {
            "meta": {
                "boolean": true,
                "creator": "Hiep",
                "date": "2024-09-11",
                "dc_description": "dc description test",
                "description": {
                    "en": "neweded"
                },
                "multi_select": [
                    "Blue",
                    "Green",
                    "Yellow"
                ],
                "price": {
                    "default": "12"
                },
                "product_id": {
                    "default": "IIHHYTTD22"
                },
                "sport": "Sport test",
                "test": "None",
                "test-multi-select": [
                    "Test 2",
                    "Test 1"
                ],
                "test-price": {
                    "eur": "20"
                },
                "testsd": "2024-09-10",
                "title": {
                    "en": "testssssss"
                }
            }
        }
    }
]