Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
We offer a list of Scaleflex's DAM most popular plugins with brief descriptions on how to set them up.
Third-party product integration
In ecosystem integration, seamless connectivity facilitates communication and interaction between third-party components.
This introductory guide aims to clarify the distinctions among the two main types of software connections: plugins and connectors (aka applications).
Plugins are software components designed to extend the functionality of a more extensive application. They allow developers to add specific features or behaviours to an existing software system without modifying its core codebase. Plugins are usually loaded dynamically at runtime, making adding or removing them easier without affecting the main application's stability.
Plugins provide a modular approach to integration, enabling third-party developers to seamlessly integrate DAM into the host application/software. Simply use our Media Asset Widget to replace or complement the media gallery used by the third-party software/tool.
Applications, also known as standalone connectors or adapters, are complete and self-contained entities designed to perform specific tasks or provide a range of functionalities to users. Unlike plugins and libraries, applications are intended to be independent and tightly integrated.
Our applications have user interfaces (UI) and may interact independently with other applications or services. They will always perform a range of additional functions, such as programmatic synchronisation and similar advanced features.
In summary, plugins extend the functionality of existing applications with a more passive role, while applications/connectors facilitate interoperability and seamless synchronisation between different systems by being placed in between them and actively intervening.
A manual integration will always be possible using our Media Asset Widget, whose code/package is linked in this documentation.
We offer a list of Scaleflex's DAM most popular connectors with brief descriptions on how to set them up.
DAM Magento Plugin
The DAM Plugin is an extension which adds Asset Management to the Magento Admin (Product Images, Tinymce 4 WYSWYG) and shows it on the Front-end (Product listing page, Product detail page, Minicart, Cart Page, and Checkout Page).
There are 3 simple steps for enabling the plugin on your Magento 2 website:
Obtain a DAM token (request it here);
Install the DAM module for Magento 2;
Add your security configuration parameters to access your DAM library.
Please note that the plugin will make some changes in the Admin section.
Currently, the plugin only supports the Text Component in Page Builder; other components will be supported in future versions.
TinyMCE Image (Insert/Edit) default function will be disabled. You can change the image size by scaling (drag and drop function) or delete it and add a new one with the size you like;
The plugin will disable the default upload function in Product Edit Page. Instead, every asset will be managed by DAM (single source of truth).
The plugin works well with the Magento Luma default theme. If you use a different theme, please check the manual integration below to get the product images.
You can register for a demo if you don't already have a DAM account.
Prerequisites
DAM supports Open Source and Commerce Edition from version 2 onwards.
If you have a question or need assistance, feel free to contact our support.
Install with Composer
To be able to install the module by Composer, you need to get a copy of the module on the Magento Marketplace, or directly from Github. Then, unzip the source code to app/code folder.
Enable and install the following modules in Magento:
php bin/magento module:enable Scaleflex_Filerobot php bin/magento setup:upgrade php bin/magento setup:static-content:deploy
Configuration
Once the steps listed above are completed, you need to enter your DAM token and security template into the DAM module configuration in the Magento admin interface: Stores > Configuration > DAM By Scaleflex > DAM integration.
If your token and security template id is verified, please activate the module by selecting Yes in the DAM Enable dropdown then save again.
After all is done, you will be asked to flush your Magento cache.
You will not be able to activate the plugin until the token and security template id are correct.
Configuration options
DAM Token: Your DAM token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Project > Access > Security templates (tab) menu;
DAM upload directory: This is the top storage folder for your assets. The default value is /magento
.
Please create the folder in DAM first to prevent an error. If you want to change it, you need to check if the folder exists in your DAM container.
Please click on Icon DAM on TinyMCE:
Then choose which images you want to insert -> transform:
You will be able to select and insert one or more images:
If you want to change the image size, please choose one image at time and click Insert. After that, you will be able to set the desired image dimensions.
If you want to change the dimensions of an already inserted image, you can use Tinymce Image size drag and drop.
Go to Product Edit Page in Images and Video Tab, then click Image Manager. Then you can use the file manager like TinyMCE above.
DAM Canva
The Canva plugin allows you to create using all the power of Canva and any existing templates and designs you have saved, transporting your final render into your DAM library.
Follow the below steps:
Click the Upload button (1), and select the Canva option (2)
Then login using your usual credentials in Canva and create at will
Finally, click the "Publish" button (3) on the top right corner of the Canva interface
This will import your creation as a regular asset, added to the current folder with a simple click on "upload" (4) If you need any pre-upload transformations you could set them to execute from the "Settings" side panel
DAM Drupal module
Download from Github
Step 1: Download the latest version from https://www.drupal.org/project/filerobot_by_scaleflex/releases;
Step 2: Extract the zip file in /modules
;
Step 3: In the Drual admin, navigate to Extend / find Filerobot by Scaleflex / Install
Install with Packagist
Step 1: Run composer require 'drupal/filerobot_by_scaleflex:^1.0'
Step 2: In the Drupal admin, navigate to Extend / find Filerobot by Scaleflex / Install
Activation: You can enable or disable the module;
Token: Your token from the DAM;
CNAME: If you have a CNAME configure in DAM, you can enter it in this field;
Security Template Identifier: To load the DAM Widget or DAM Image Editor, you need to create a Security Template in your DAM Asset Hub first. This will grant your Drupal instance the necessary credentials to access your storage;
DAM upload directory: The directory in your DAM account where the files will be stored.
You need to click the Update widget to load the image after choosing the image from the DAM widget.
DAM Contentstack App
The features of the DAM Contentstack App include:
Asset Manager Widget in Contentstack Content Management;
Multiple file type support;
Metadata sync: asset metadata from DAM will show on your Rest/GraphQL response.
if you don't already have a DAM account.
Sign up to Contentstack.
Updating
Security Template Identifier: Found in the Project > Access > Security Templates tab, this key is required for secure access
Asset
Container: Your DAM token from the Asset Hub interface
Custom Field
JSON Rich Text Editor
Step 2. Select Scaleflex Filerobot
Step 3. Save and Close
Step 4. On Your Entry open DAM and choose image
Custom Field
JSON Rich Text Editor
DAM Prestashop plugin
Supports the default versions of Product Media and TinyMCE (and not other TinyMCE Plugins);
Supports Prestashop from version 1.7.8.7 onwards.
if you don't already have a DAM account.
- Download the DAM module
Step 1:
Step 2: Unzip the file and change the folder name to "DAM"
Step 3: Zip the file with the name "DAM.zip"
Step 4: In Admin go to Modules/Module Manager -> Upload the Zipped file
- From the Marketplace
Step 1: In Admin go to Modules/Module Catalog and search for "Filerobot by Scaleflex"
Step 2: Click "Install"
3. Configuration
Step 3: Go to Modules/Module Manager -> Other Section -> Click on Configure on "Filerobot by Scaleflex"
Step 4: Update the configuration (credentials) and activate the Module, then your site is ready to go.
Activation: Enable/Disable the module
Token: Your DAM Token
Security template identifier: Your DAM security template (in Project > Access > Security templates tab)
DAM upload directory: The directory where you want to store/manage assets
4. User guide
Product media
Go to Catalog/Product -> Click +
button in Product Images
Choose images and click Insert
Product WYSIWYG
Click the image
icon on WYSIWYG
Then it is the same as for a Product Media click Insert
after choosing your image(s)
DAM Opencart plugin
The DAM Plugin is an extension which adds Asset Management to Opencart.
There are 3 simple steps for enabling the DAM plugin on your Opencart admin:
Obtain a DAM token (request it );
Install the DAM module for Opencart;
Add your security configuration parameters to access your DAM library.
Currently, the plugin supports the default WYSIWYG editor from Opencart - Summernote, but the native "Image resize" function is disabled. You can change the image size by removing the previous one then add it with new dimensions (a dedicated function will be added in the next version).
if you don't already have a DAM account.
Upload the admin
folder in upload/admin
to your Opencart source code.
Login to the Admin Dashboard, navigate to Extensions/Installers and upload the scaleflex_filerobot.ocmod.zip
file. Then, go to Modification and click Reload to update the installer.
Navigate to Extensions/Extensions, choose Modules from the drop-down menu, select DAM and update all configurations.
DAM Token: Your DAM token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Project > Access > Security templates tab;
DAM upload directory: This is the top storage folder for your assets.
Please create the folder in DAM first to prevent error.
You need to enable the extension in order to use DAM in all pages.
With Summernote:
With Image field:
If you are on Summernote: You can select multiple images for insertion.
If you are in an Image Field: You should select only one. If you selected multiple items, it will use the last one, as Opencart's Image Field inserts only one image at a time.
This extension is 100% compatible with the default theme.
If you use another theme (stock or custom), you should verify that the image is indeed from DAM before returning data to the view. An examples for banners would be:
The Contentful DAM App allows users to seamlessly integrate and manage digital assets (images, videos, and documents) from Scaleflex DAM within the Contentful CMS. With support for multiple file types
The features of the Contentful DAM App include:
Asset Manager Widget: Manage and insert assets directly within the Contentful content editor, streamlining the asset handling process.
Multiple File Type Support: Supports a variety of file types, including images, videos, and 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
if you don't already have a DAM account.
Sign up to Contentful.
Contentful is 100% Cloud Native, so you have to sign up for a hosted CMS at and you will get a link to your space:
There are 2 ways:
Configuration keys(* = required):
Token*: This is the Scaleflex DAM token found in the Asset Hub interface, which allows the app to connect to your DAM account
Security Template*: Found in the Project > Access > Security Templates tab, this key is required for secure access
Asset directory: Defines the top-level folder for storing assets. The default is the root directory (/).
You can quickly validate your token and security template by clicking "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 refresh your browser (Ctrl + F5) each time you change the settings so they take effect.
In any content model, create a new JSON Object Field
In Appearance section, choose Scaleflex DAM
In any Scaleflex DAM Field, to insert assets from DAM to content, click on Asset Manager
An Asset Dialog will 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 have 2 options:
Insert as original
Insert as transformed (change the image format or size before inserting)
After inserted, assets will appear like below:
You can:
Reorder assets position by drag and drop
You can delete unwanted asset(one by one - click on the 3 dots icon ...
then select "Delete") or click "Clear all" to remove all selected assets
If any changes are done from the Hub, please use "Refresh Assets" button so to update Contentful
The following is an example of how metadata for inserted assets is stored in JSON format within Contentful.
DAM x Opencart v4 plugin
The DAM Plugin is an extension which adds Asset Management to Opencart.
There are 3 simple steps for enabling the DAM plugin on your Opencart admin:
Obtain a DAM token (request it );
Install the DAM module for Opencart;
Add your security configuration parameters to access your DAM library.
if you don't already have a DAM account.
Login to Admin Dashboard
Go to Extensions > Installer and upload the file filerobot.ocmod.zip
Install DAM plugin
Navigate to Extensions/Extensions, choose Modules from the drop-down menu, select Filerobot and update all configurations.
DAM Token: Your DAM token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Project > Access > Security templates tab;
DAM upload directory: This is the top storage folder for your assets.
Please create the folder in DAM first to prevent errors.
You need to enable the extension in order to use DAM in all pages.
With Ckeditor:
With Image field:
If you are on Ckeditor: You can select multiple images for insertion.
If you are in an Image Field: You should select only one. If you selected multiple items, it will use the last one, as Opencart's Image Field inserts only one image at a time.
This extension is 100% compatible with the default theme.
If you use another theme (stock or custom), you should verify that the image is indeed from DAM before returning data to the view. An examples for banners would be:
Copy
DAM Shopware module
if you don't already have a DAM account.
Step 1:
Step 2: Rename the Zip file with the name DAM.zip
Step 3: In Admin go to Extensions / My extensions / Upload extension
Step 1: In Admin go to Extensions / Store / Catalog and search for "Filerobot by Scaleflex":
Step 2: Select the extension and choose Add extension:
Step 3: Go to Extensions / My extensions / Filerobot by Scaleflex - Digital Asset Management, Media Optimisation and Acceleration / choose Configuration:
Step 4: Update the configuration and activate the Module and your site is ready to go:
Admin access key ID: Need to generate in "Setting" to call API in Admin Dashboard;
Admin secret access key: Need to generate in "Setting" to call API in Admin Dashboard;
Folder Id: This key will auto-generate when the plugin is activated;
Activation: Enable/Disable the module;
Token: Please enter your DAM token here;
CNAME: Enter the CNAME as per the configuration in your DAM Asset Hub interface, once validated and the SSL certificate is accepted. (Or leave blank if none);
DAM upload directory: The directory in your DAM account where the files will be stored.
The step to get "Admin access key ID" and "Admin secret access key":
DAM x Strapi plugin
To get Scaleflex DAM integrated you will need to set up these 2 components:
Scaleflex DAM plugin: ;
DAM upload-provider: .
Benefits:
All your media will be hosted on Scaleflex DAM;
You have the option to synchronize all your existing media to Scaleflex DAM;
You will have access to the Media Asset Widget (MAW), where you can upload media to Scaleflex DAM and select media from Scaleflex DAM.
Additional workflows or enrichments can be performed from the DAM UI
if you don't already have a Scaleflex DAM account.
Install the Scaleflex DAM plugin and you should see Scaleflex DAM in the left menu.
The following options are available to you:
Then, install the DAM upload provider. Every media you upload will have DAM URLs:
Upload media to Scaleflex DAM:
Select media from Scaleflex DAM:
Beginning with 2 local images
And 10 images on Scaleflex DAM
Synchronize
Note: Please don't close the browser tab until the sync process is done.
Results
DAM Sylius plugin
if you don't already have a DAM account.
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
This command requires you to have Composer , as explained in the installation chapter of the Composer documentation.
Then, enable the plugin by adding it to the list of registered plugins/bundles in config/bundles.php file of your project:
To configure the DAM Sylius plugin, the following components need to be updated:
1. DB Schema
Copy
2. Admin route
Create file in config/routes/scaleflex_sylius_filerobot.yaml
with the following content:
Copy
3. Product media tab form
Change form theme {% form_theme form '@ScaleflexSyliusFilerobotPlugin/Admin/Form/imagesTheme.html.twig' %}
in your templates/bundles/SyliusAdminBundle/Product/Tab/_media.html.twig
Copy
4. Product grid thumbnail
Change grid thumbnail column template
5. Script
6. Config filter
Create a file config/packages/scaleflex_filerobot.yaml
and add content bellow
7. Update configuration in Admin
Navigate to Configuration / Scaleflex DAM
You can enable the plugin only if both token and security template id are correct.
Activation: Enable/Disable the plugin
DAM Token: Your DAM token, unique DAM Project and gallery identifier
Security Template Identifier: Your security template ID, found in the "Access > Security templates" section of your DAM admin
DAM upload directory: (sub)folder path to your asset's gallery, eg. /my_sylius_folder
The DAM plugin offers various Twig methods and filters to assist developers:
is_filerobot(image_path)
: Twig function which checks if an image is stored in DAM ;
image_path|filerobot('sylius_shop_product_thumbnail')
: A resizing Twig filter; More filters can be added in in config/package/scaleflex_filerobot.yaml
.
and in Twig
We have some default size follow Sylius default, you can override it in filter config ab
If you use Scaleflex DAM on existing File you have to check the path is filerobot or not, if not use the default way
Example with Sylius default
templates/bundles/SyliusShopBundle/Product/_mainImage.html.twig
templates/bundles/SyliusShopBundle/Product/Show/_mainImage.html.twig
:
DAM Akeneo connector app
The DAM Akeneo app offers the following features:
One DAM token supports only one Akeneo EE Instance. One Akeneo EE Instance however can use multiples DAM tokens
Metadata sync locales and code of metadata need to match.
Asset Manager
Medialink Type only: Link Sync
Akeneo Entity Reference
Image Type: Binary sync
Text type: Link sync
Size setting
Support at family level (Asset Manager), Entity level (Entity Reference) for specific Scope and Locale
Metadata sync to Attribute
Support Global
Support value per locale
You need an active DAM account. if you don't already have one;
Your Akeneo plan needs to be Enterprise Edition.
After login to Akeneo, navigate to Connect / App Store and Find the DAM by Scaleflex App
Then click Connect: You will be redirected to the Asset Hub and will be able to choose which token you want to use for your Akeneo EE instance
Each Token can be used for only one Akeneo EE Instance
Multiple Akeneo instance can use the same Token
After selecting your token and clicking Active, you will be redirected back to Akeneo
Then please Confirm that you give App access to the Akeneo EE instance
After confirmation, you will be redirected back to DAM
Choose to go to Setting
View the Asset Library
1. General Settings
General settings:
Enable / Disable: If disabled, you cannot use Akeneo Sync feature on DAM
Default size: Default image size will be used if there are no configs related to each asset
Default function: Crop or Fit
Please click Apply change to update configuration
After updating the settings, please refresh the DAM browser page
Size settings: please see the size section below
Sync all setting / Best fit for newcomers
2. Size Settings
How does it work?
Can be duplicated
Priority: Bottom to Top, and it will apply the first matching setting only
Example: An Asset with these information:
Scope: commerce / Locale: en_US / Family: filerobotmedia
Will try to match setting following the steps bellow:
First try: Type: Asset / Family: filerobotmedia / Scope: commerce / Locale: en_US
Second try: Type: Asset / Family: All Items / Scope: commerce / Locale: en_US
Third try: Type: Global / Scope: commerce / Locale: en_US
Use default setting
Add new
(1) To add new size setting click Add new size on the top right
Explanation
(1) Type - currently the app supports 3 types
Global: Affects all assets including entity and asset
Asset: Asset Family
Entity: Entity Reference
(2) If we choose Asset or Entity, we can also choose which attribute family(asset manager) or entity(entity reference) will be applied this setting
We can also choose All Items to apply to all Family / Entity
(3) / (4) Scope and Locale
To choose locale you muse choose a scope first / can choose No Scope
There are 4 cases which can happen:
(5) / (6) Function and Size
Function: Crop and Fit
Size of asset to be resized
Must follow format: width x height, example: 300x400
Edit / Delete
(1) Click on Edit on each setting
Same as Add new
You can delete by clicking the Delete button on the opened Modal
Synchronize Media
(1) On each Asset / Click Detail
(2) You can choose which type to sync
Entity: Entity reference
Asset: Asset Manager
(3) On Sync Asset Tab
Choose Family or Entity
Choose attribute(For Entity support two types: Text(Link sync) and Image(Binary Sync)
There are 4 cases that can happen:
Value per channel and value per locale are both false: Can sync without choose scopes or locales
Value per locale is true, value per channel is false: Must choose at least one locale
Value per locale is false, value per channel is true: Must choose at least one scope
Value per channel and value per locale are both true: Must choose at least one scope and locale
Entity Code(Entity Ref): Code -> You can search for old code, or create new one.
(4) To check sync history, Click Sync Logs
(5) You can see which locales and scopes were synced by clicking View on each item
Only support attribute with following settings:
Value per locale: true / Value per channel: false
Value per locale: false / Value per channel: false
Configuration step:
(1) Go to store config
(2) In Regional variants, Add new group
(3) Option setting
(3.1) Name of Group - Can be anything you want
(3.2) / (3.3) Code of Locale / Must match the setting in Akeneo / See picture bellow
Metadata setting
(1) Click to manage, Metadata tab; you can add new Group then Add new field
(2.1) API Value must match (3.1) Attribute code(in Entity / Asset Manager Family)
If (3.2) is uncheck then (2.2) is None else (2.2) must specific a Regional variants group as we did above with Same setting as Akeneo locales
How to sync
After configuration, everything is automatic for the mapping between two systems
On each Asset detail(1) you can see Metadata tab(2), You can change value by locale or value only(if value per locale is false)(3) , then click Done(4) to save the value
Please note that this plugin is directly developed and maintained by the team.
This integration allows business users to build personalized landing pages and applications by repurposing content from your Scaleflex DAM digital asset management system. It also enables developers to use their preferred front-end tools to build these applications.
Make assets housed in Scaleflex DAM available to the by adding this integration.
Get connection settings
Log into Scaleflex DAM Hub.
Note Container Id string to the left from your account icon at the top right corner. You will need this value in the next section.
Click on the Settings icon top right corner of the screen.
Scroll to the tab Project section.
Click on Access ink.
Create a new template in the Security templates tab if not created yet.
Note the Secret Key of your template. You will need this value in the next section.
Add integration
In Uniform, open your project.
Navigate to the Integrations tab.
Scroll to the section Browse Integrations.
Click Scaleflex DAM.
Click Add to project.
add-project
Enter the required values:
Click Save.
After you install the Scaleflex DAM integration, new asset library becomes available.
You can manage your Scaleflex DAM assets from inside Uniform. Uniform leverages its Media Widget to provide access to your library throughout your project.
Integrate Hygraph with DAM by Scaleflex to bring in and manage your digital assets seamlessly from the DAM as the Single Source of Truth.
With this application, users can upload, store, edit, manage, optimize, enrich and automate their media assets right within their Hygraph UI, saving time and better enhancing their workflow.
Publish your Media Assets directly from within Hygraph with the Media Asset Widget:
As Original
: This option is available for all assets. Adds them to the content entry as is, as a preview or downloadable element.
As Transformation
: This option is only available for image assets. It lets you modify the image format, quality, size, and even to crop part of it.
This integration is developed and maintained by our partner Hygraph.
Useful resources:
General information:
Installation guide:
Hygraph community (slack):
OneTeg is a no-code integration platform as a service (iPaaS) content and data exchange solution. It allows for easy integration between the Scaleflex DAM and other systems that can run on the Cloud or On-Prem, to solve the complexities of content unification and data synchronization while providing user-driven flows for a simplified integration across platforms.
A complete list of the compatible third party software connected to Scaleflex DAM can be found .
In order to access your DAM assets in the programs mentioned above, you must have:
an active user account in Scaleflex DAM
an active licence registered in OneTeg (ask your administrator or point of contact)
Connect to your OneTeg Dashboard
Define the Scaleflex connection {your_company}.oneteg.com/en/connections
Open the Workflow builder: {your_company}.oneteg.com/en/flows
Click the [+] icon on the top right corner to add a workflow
Build using the block editor (drag & drop, configure elements individuallly)
Save
Full headless access to the Scaleflex DAM library and functions (ref below).
Exemple of workflows
Library of flows:
Details and setting of a flow
Step 1. On Content Type Menu
Step 3. Save and Close
Step 4. On Your Entry open DAM and choose image Step 5. Publish
Step 1. On Content Type Menu
Step 2. Select Scaleflex DAM
Step 5. Publish
To install the Contentful DAM App, visit the and click 'Install'. Follow the prompts to complete the installation.
Security Template Identifier: To load the DAM Widget or DAM Image Editor, you need to create a in your DAM Asset Hub first in order for your Shopware instantiation of the DAM Widget to obtain proper credentials and access your storage;
You need to login to first
Navigate to Settings / Developement / Akeneo PIM to open the Setting page. Alternatively, you can follow this
The App | Akeneo |
---|
You must close the asset popup and open again to make new metadata available to sync(5)
Uniform setting | Value |
---|
You can insert assets directly into your Uniform using .
Connection configuration: you will need to use an API key ( find it there )
No Scope + No Locale | Value per locale: False Value per channel: False |
Scope + No Locale | Value per locale: False Value per channel: True |
No Scope + Locale | Value per locale: True Value per channel: False |
Scope + Locale | Value per locale: True Value per channel: True |
Container Id | Your DAM container id (aka token). |
Security templates secret key | Security templates are meant to be used by frontend applications calling the DAM API directly or via the Media Asset Widget. |
DAM Storyblok App
Register for a demo if you don't already have a DAM account.
Sign up to Storyblok.
You can find the Scaleflex DAM in the Storyblok Marketplace, clicking the Visit Website button will link to this page containing all instructions.
Note that requesting an installation delegation can be done via our contact form or our support email hello@scaleflex.com, and finally using our regular support page.
Make sure you complete, in any case, each of the following steps fully:
Send us the installation delegation request, including
Your Storyblok "Space ID" (find it in the settings, in General / Space)
Your preference of installation type ( Field Plugin, or App level -default- )
Add (invite) our Plugins Installation team to your Space
Use register@scaleflex.com (you can remove this user once the installation is completed)
with "Admin" role (otherwise the installation is not possible)
Our support team will contact you back to confirm the installation date and make sure you have everything configured properly to start using the Scaleflex DAM plugin.
Once this is done, you will be able to find the new block in your "Block Library" under the name "DAM" and be ready to go!
Depending on your level of support and onboarding plan, a CSM can assist you for the next steps: setup and configuration.
You have 3 required configuration items to take from the Asset hub: Token (the unique project or library identifier), Security Template (this will be used as the secret for authentication), Directory (where you want Storyblok's assets to be stored and retrieved from, usually a dedicated sub-directory; note that this field must be comprised under the directory limit of the Security Template you have selected) And there are optional fields: limit, attributes
You can add as many blocks containing the DAM field type as needed. There is no limit on the number of blocks you can include.
Go to Block Library -> New Block
Enter any Technical Name you want, Select Nestable Block -> click "Add Block"
In the side modal "Edit [Technical Name]" that appeared, enter any name as Field (eg. DAM_Asset), then select the type of field as plugin -> click "Add"
Click on the field just added (in the "General" section below), then scroll down to the Plugin Options, then choose "filerobot-storyblok" in the Custom Type drop-down. Add the 3 configuration keys you gathered from the DAM and set up like below:
token = Token from DAM (aka project identification code),
secTemplate = Security template from DAM,
rootDir = Base directory (also in the security template configuration).
limit (optional) = number of files you can show when choose on DAM Asset
attributes (optional) = add more data on API Response Structure (ex: meta, tags, owner),
limitType (optional) = File Type Filtering ( ex: image, video, audio, application, application/zip, application/x-zip-compressed, application/vnd.rar, application/x-rar-compressed )
Note: Show complete Metadata work if the token has permission. The list project configuration default shows the title and description.
Below are the 3 configuration steps illustrated:
New BlockNew Field TypeField Required SettingsField Optional Settings
Add New Block
In any Content, type Edit Page
Click Add Block, Choose the Block contain the DAM Field you want to add to the Page:
It is now possible to interact with your DAM library assets directly from Storyblok:
Copy
Copy
CI-Hub allows you to easily open and modify assets stored in the Scaleflex DAM using Office365, Google, Figma, and Adobe software. It also allows to add a seamless integration of your Scaleflex DAM library as an extension of your own personal computer storage with the CI-Hub Drive connector, that adds a Cloud-connected "additional drive" to your Windows Explorer or Apple Finder.
A complete list of the compatible software tools for use with CI-Hub can be found here.
In order to access your DAM assets in the programs mentioned above, you must have:
an active user account in Scaleflex DAM
an active licence registered in CI-Hub (ask your administrator or point of contact)
an access (account or licence) to the software you wish to use for asset modification
installed the corresponding CI-Hub integration (aka. add-on, extension) for that software.
Please check this page for detailed instructions for your software.
Open the CI-Hub integration panel in the desired software and click the "Login" button
Use your CI-Hub credentials on the page "Sign in to CI HUB" and switch back to the application
Validate your Scaleflex DAM connection and authenticate
[first time] Add a connection to Scaleflex (the [+] icon on the right) and connect using your DAM credentials on the dedicated page, select your Project identifier to connect to
[following times] Reload your connection to Scaleflex (the "refresh" icon at the bottom)
Please note: When you log into your Scaleflex DAM account, and select the project you wish to grant access to via CI-Hub, you must use the name shown in the top right of the Scaleflex DAM interface:
The CI-Hub connector allows you to preview files available in DAM, then to select them for export and open them in your preferred software tool. You may modify the content within that tool and then upload the new version of the file back to Scaleflex DAM. The upload is not automatic and occurs only after the user selects this option.
The connector allows you to search for files and inspect their metadata as well.
Some types of files cannot be opened in certain software. This is a limitation of the software itself and it comes from the "specialisation" of what it is doing. For example, video files cannot be opened using the CI-Hub connector for Adobe Photoshop, nor can Excel sheets be opened using the connector for InDesign.
The Gallery and User Role permissions in Scaleflex DAM may affect the number of files accessible via CI-Hub, as well as the actions that can be applied to them. For example, if a folder is hidden from a specific user in Scaleflex DAM, its content will also be unavailable for that user in CI-Hub. Also, if the user does not have a permission to upload new files in Scaleflex DAM, it may result in a failure to upload the modified file version back to DAM after editing within the specified software.
Some software have file size limitations when importing assets from DAM. Known use cases are:
the integration with Google Slides that do not allow assets bigger than 8MBs. In such cases a solution could be to open the file in Powerpoint or in some of the products of Adobe.
Figma allows images with dimensions up to 4096x4096px to be imported.
The process of uploading the edited version back to DAM depends on the filename of the new file and the configuration of your Scaleflex DAM storage. If you choose the same filename and folder as the existing asset, be aware that if DAM Storage is set to 'New version,' the file will be uploaded on the top of the existing asset. If it is set to 'Overwrite,' the new file will replace the previous version, and the older file will be lost. If it is set to 'Refuse upload,' you will need to change the filename to import the new file back to the Scaleflex DAM.
The CI-Hub connector needs to actively be connected to Scaleflex DAM in order to fetch the assets content from the Storage, you therefore need to be online and have a steady internet connection.
The DAM Adobe CC embeds the Media Asset Widget (MAW) plugin inside the following supported Adobe applications:
Adobe Photoshop
Adobe Illustrator
Adobe InDesign
There are no more copy-pasting media assets from your local drive to DAM; everything happens within your Creative Cloud application.
Step 1. Download the extension files from the link and unzip them.
(use the following in your browser if you can't download from the above URL link)
Step 2. Copy the unzipped folder content into the folder for your Creative Cloud version:
If you have Photoshop CC 2014, CC 2015, CC 2015.5, CC 2017 or above:
Mac OS: /Library/Application Support/Adobe/CEP/extensions/
Windows x64: C:/Program Files (x86)/Common Files/Adobe/CEP/extensions/
If you have Photoshop CC:
Mac OS: /Library/Application Support/Adobe/CEPServiceManager4/extensions/
Windows x64: C:/Program Files (x86)/Common Files/Adobe/CEPServiceManager4/extensions/
You have to create the folder if it does not already exist.
Step 3. Restart Photoshop, and you will find the DAM widget/extension in Window > Extensions > extension_name.
First, you need to log in to your DAM account from the Widget.
Then, you can select the Company and Project you would like to access (for multi-project DAM accounts).
You can browse your container and its folder structure directly from the widget, use the search and sort functions, and create folders.
You can upload images from Photoshop directly to your DAM container. Downloaded images from DAM can be inserted as a new file or layer in an existing Photoshop project.
DAM WordPress plugin
The DAM WordPress plugin allows you to interact with your WordPress database and upload or access media assets. It enables you to manage, upload, and access media assets from within your DAM, directly in WordPress, providing a more efficient and streamlined media management process. If you are new to DAM, check out this introduction video.
Plugin: https://wordpress.org/plugins/filerobot-digital-asset-management-and-acceleration/
Or
Ensure you have a DAM account. If not, register for a demo.
Log in to your WordPress admin panel
Enter "Filerobot" in the search field and then install the plugin
Once installed, click Activate.
Navigate to the DAM admin page
Fill-in the plugin's settings page with the required authentication details:
CNAME: If you'd like to use a custom domain for image URLs.
DAM token: Your token from the DAM.
Security Template Identifier:A key for obtaining time-limited access tokens (used for API interaction). See: Security templates. Behind the scenes, the code would use the Security Template Identifier to obtain a SASS (the “limited-time password”). The SASS would then be used in the auth header for interacting with the Filerobot API (https://developers.scaleflex.com/)
DAM upload directory: Choose the folder where uploaded assets should be stored in the DAM platform.
“Don’t store media assets on WP server” : If checked, only the original image will be stored on WordPress, while image variants (resized, compressed) will remain on DAM.
“Use Media Asset Widget as gallery”: Replaces the default WordPress Media Gallery with the DAM Media Asset Widget.
“Synchronize DAM metadata” : Syncs metadata from DAM to WordPress (e.g., DAM tags as image alt text). Warning: This option is mandatory for advanced editors (like Elementor, Gutemberg, etc.).
“Sync Post ID” checked means this option will sync all post ID are using the asset to a specific metadata field.
“Sync metadata fields”: Syncs selected metadata fields between DAM and WordPress. Warning: This setting needs a specific set of metadata in DAM to be activated, otherwise will break the synchronization. And “Name of the metadata list in WP database” is required if this option checked.
The “Test connection” button tests if your DAM token and Security Template Identifier can connect to your Filerobot asset library.
The “Synchronization status” button tells you how many files still needs to be synchronized from WP CMS to Filerobot platform (the “up”) and how many files still needs to be synchronized from Filerobot platform to WP CMS (the “down”).
The “Trigger synchronization” button starts the actual synchronization.
For example, before DAM is installed and activated, you have these 2 images on your WP CMS and these 2 images on your DAM platform:
At this point, the images' URLs still have WP CMS URLs
After you install, activate and configure DAM , you can first check the connection to DAM. This will confirm if you entered the correct credentials.
Then you can check the status of what is yet to be synchronized:
Then you can do the actual synchronization:
The progress bars will give you information about the current synchronization process
The logs tab will show you more information about the synchronized media assets.
Now you can see that all the images' URLs had became DAM URLs
and on DAM platform
The next major feature that DAM brings is: the Media Asset Widget (MAW) in Media Library
Here you can upload your media assets to the DAM platform (instead of WP’s local library)
The next major feature that DAM brings is that: anywhere where the Media Manager opens, a MAW tab will be inserted into it.
The next feature that DAM brings is it’s image editor, instead of WP’s image editor
DAM also has a cron
When you deactivate DAM , all the media assets that have been synchronized to DAM will be removed.
From Jan 2022: Media files' metadata sync is enabled:
DAM meta → WP meta,
DAM tags → WP alt,
DAM comments → WP content.
From Jan 2022: DAM plugin only works with these settings:
June 2022: The plugin is English-only and no longer supports multilingual strings.
The DAM WordPress plugin is compatible with popular plugins like:
Classic Editor,
Gutenberg Editor,
WooCommerce, Elementor,
ACF.
If you encounter any issues with third-party plugins, please let us know, as WordPress's open system sometimes allows plugins to overwrite configurations.
Prismic Headless CMS integration
Instead of using the /list
endpoint (API documentation), this API supports Prismic's format directly.
This endpoint lists the assets with the following settings:
50 elements per pages
ordered by last_update
GET {API_SECRET_KEY}@api.filerobot.com/{TOKEN}/integration/prismic/assets
Property | Description |
---|---|
Parameter | Description |
---|---|
Copy-paste the cURL request in your Terminal to see the API in action.
The response format will look like this:
Where:
results_size is the total counting of the listing result; and could be easily understood as the sum of size(results)
of all pages, while each page contains a maximum of 50 files.
image_url is fixed to be resized to 100x100
description would be returned as a concatenation from blob->meta->search
and blob->meta->tags
and the parsed list of directories and sub-directories. In case the file doesn't have this field (and is at the root folder), it defaults to No description for this file is available
.
DAM Zapier integration
Zapier connects over 3,000 different tools, applications, and services you need to manage your business. Their simple integration platform allows anyone to seamlessly integrate DAM with other applications to automate workflows.
The DAM integration allows to:
Setup a trigger when a new file is uploaded to DAM (useful for setting up notifications, transforming uploaded files or using other tools)
Upload new files to DAM
Transform files in DAM (this is done by adding transformation functions to the file CDN link)
Search for existing files and folders
Create folders
Start a new Zap and add a tool to start the trigger with. It can be DAM or any other tool. DAM can either start the Zap or execute the actions for the trigger coming from other tools, as shown in the example below.
Once the DAM trigger/action is added, you will be asked to "Choose account" to connect to DAM.
New browser window will pop up asking for authentication details to DAM Asset Hub.
DAM Token can be found in the DAM Asset Hub project selector and next to the project title. While DAM API Secret Key is available in Settings > Access > Security templates (tab) menu in the DAM Asset Hub. Make sure the API Secret Key has the minimum required permission for the actions of the Zap.
Once done, you have successfully connected your DAM account to your Zapier account.
After the account is successfully configured and authenticated, you will be able to set up the triggers and actions for execution.
When selecting the Folder Path, if you leave it as a default option, it will only do actions on the Root folder of your DAM account. When looking for a specific folder, you can add the folder path manually or use the search function for exiting folders in the Root folder path.
DAM Pabbly integration
Pabbly connects more than 800+ software products for seamless real-time data transfer. Their simple integration platform allows anyone to seamlessly integrate DAM with other applications to automate workflows.
You can request for demo if you don't have a DAM Account.
After logging in DAM, you need to login to Pabbly Connect.
In the Actions seaction, search for Filerobot by Scaleflex.
Choose Action Event or Trigger Event from the drop down input and confirm with Connect:
You can find your token and the API key in DAM Asset Hub: Developers / API Secret Keys.
Once you save your Token and API key, you don't need to enter it again for another action event by selecting "Select Existing Connection" option.
Triggers are events that occur in DAM and that events data are sent to Pabbly. DAM Pabbly connector has the following triggers:
DAM Pabbly connector has the following actions and corresponding inputs:
Have a Kontent CMS setup. https://kontent.ai/
Add custom element
Content model (left hand side) > Create new > Custom element (right hand side). You will then have the below view.
**Hosted code URL: https://scaleflex.cloudimg.io/v7/plugins/filerobot-kontent/filerobot-custom-element.html?func=proxy
Parameters:
note: "dir" element is optional, by default will go to the root folder of your library. Do not add "/" at the end of the directory string.
Create new content with this Custom Element
Content & asset (left hand side) > Create new > Chose type: Your_Type_Name. Chose and add some images, publish. You will then have the below view.
The images below are the images added in from the Widget into a Kontent content-item. When they are added, they will have DAM-URLs (instead of their Strapi CMS URLs).
Tutorial: https://kontent.ai/learn/tutorials/develop-apps/build-strong-foundation/set-up-preview/
Go to Settings > API Keys. For this, you will need your Project ID. You may also need your API Key (depends on what you want to do, but for simple things Project ID is enough).
Write a client app that utilizes the Delivery API
Recall that Kontent have 3 sets of APIs that you can interact with
Delivery APIs in plain HTTPS form can be downloaded from https://kontent.ai/learn/tutorials/develop-apps/get-started/postman-collection/ and imported into POSTMAN
For the 3 content items that come out of the box, Kontent already have an example client app, which we can imitate.
This example app was made by using React JS https://github.com/kontent-ai/sample-app-react
Hosted on various Github Pages.
After writing and hosting your client app, go to Settings > Preview URLs and define your Preview URL formats.
See how Kontent defined their preview URLs for their example app:
Codename
, URLSlug
& ItemId
are obtained as follows:
Once you done all the above, you can preview by clicking Preview:
https://scaleflex.zendesk.com/hc/en-gb/requests/new or hello@scaleflex.com
DAM Shopify app
The DAM x Shopify App can be installed from the Shopify App Store.
Create a support request to be helped adding the App to your store.
Have a DAM account, with the DAM App installed. If you don't have an account yet, please contact us to get one;
Create the Security Template Identifier (SEC) to use the app (Settings > Access > Security templates tab > Add template)
You need to have a store on Shopify.
In Shopify, open the DAM app in the Apps menu item and click the button “Configuration”
Fill-in your DAM token, CNAME (not required), Security Template Identifier (SEC), Upload Directory (not required, the default will be "/"), and press “Save”
Add DAM snippets to your theme: In modal Configuration, click the button “Update Snippets” to update or create new DAM snippets in your theme store.
Add product webhooks for actions create/update/delete, that will check and update images from DAM Hub when the user has a permission to create/update/delete.
In Shopify, open the DAM app from the Apps menu item.
Click the button “Sync All Product Media”. The process will run in the background for a few minutes depending on the number of images in your store. It will download all product images from Shopify and store them in your DAM Library.
Fill in your product name. Then press "Sync":
You can add DAM images to your website by editing your theme's code.
The following snippets provide the functionality to display images on your website:
filerobot-image-tag.liquid: Builds an image tag with multiple sources to render product images on your website lazily, applying transformations.
filerobot-product-media.liquid: Uses filerobot-image-tag to render product images on your website, with optional transformations.
filerobot-url.liquid: This will help you build a DAM URL to deliver an image on your website with any transformations that you want to apply.
You can use these snippets in your theme's code, referencing them in other snippets or sections.
You can use filerobot-image-tag.liquid or filerobot-url.liquid to display DAM image on your page
First you will need to assign variable fr_metafields
:
Example:
To render image tag
Example:
To get DAM image url
Example:
Note: Read more about attribute optimizer following this LINK
Require:
Configuration of your application in Shopify
Installing the Product Webhook
To import multiple images you need to follow the document of Shopify: https://help.shopify.com/en/manual/products/import-export/using-csv#adding-multiple-product-images
Copy the image URL in the Hub and paste the URL to the column Image Src in the CSV file. After that, you can use the function "Import" on the Products page to update the product with your CSV file.
Example file:
When Shopify import is done, the DAM webhook will convert the image links from Shopify CDN to DAM CDN link.
DAM Commercetools connector app
Nginx
PM2
Nodejs > v16.10.0
Certbot
To install the DAM module, please follow the steps below:
2. Upload and unzip to the server at your domain path (Ex: /var/www/public_html/)
3. Configuration Commercetools & DAM plugin (Read 2. Configuration)
4. Go to the source folder and run "npm install", "npm run build" (this command will build and create a folder public)
5. Go to the folder public and run "pm2 serve --spa".
6. Config your domain, port you will run with Nginx and create SSL with Certbot (Read here) For example, config with port 8080:
Get the applicationId and entryPointUriPath of Commercetools (Read here)
Configure the DAM module as follow:
For Commercetools project:
Clone file custom-application-config.example.mjs and rename to custom-application-config.mjs
Input your Commercetools configuration
Set your entryPointUriPath at src/constants.js
For the DAM module:
Clone file filerobot-config.json.example in folder "src" and rename to filerobot-config.json
Input your DAM token, SEC, upload directory, and any other options as fitting.
In left-menu, select Scaleflex DAM > Products
In this page select your product variant need to upload/update image
To add new image, click on "Add Image" in view page Variant Detail
Select an image on the widget and click on "Insert" button to add the image.
Note: You can select multiple images.
# | Action | How to |
---|---|---|
Trigger Name | Description |
---|---|
Action Name | Description | Inputs |
---|---|---|
API_SECRET_KEY
can be generated in the Asset hub (documentation)
TOKEN
your DAM token
folder
the path to the folder you would like to list default: /
page
the result page number, starting from 1 default: 1
File Upload
It is fired when a new file is uploaded to Filerobot.File details are sent.
File Upload
Used to upload remote hosted files to DAM
Origin File Url,File name
File Delete
Delete file from DAM
File UUID
File Rename
Used to rename file.
File UUID,File new name
Folder Create
Create new folder in DAM.
Folder path
Folder Delete
Delete folder in DAM
Folder UUID
Folder Rename
Rename folder in DAM
Folder UUID,Folder new name
Folder List
Lists all folders details
(N.A.)
1
Add Assets
2
Reorder
Drag and drop to sort assets
3
Remove Asset
On each added Asset -> Click the Bin icon to remove one Item
4
Remove all Assets
To remove (delete) all Assets, click the red "Remove all assets" in the top right corner.
1/ Click Add Assets 2/ Asset picker modal: Choose any asset(s) you want to insert 3/ On top of the modal: Click Insert 4/ Result