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...
Third-party product integration
In the realm of ecosystem integration, seamless connectivity plays a crucial role in facilitating communication and interaction between different third-party components.
This introductory guide aims to clarify the distinctions we do among the two main types of software connections: plugins and connectors (aka applications).
Plugins are software components designed to extend the functionality of a larger application. They allow developers to add specific features or behaviors to an existing software system without modifying its core codebase. Plugins are usually loaded dynamically at runtime, making it easier to add or remove them without affecting the main application's stability.
Plugins provide a modular approach to integration, enabling third-party developers to integrate seamlessly Filerobot into the host application/software, simply using our Filerobot 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 their own user interfaces (UI) and may interact with other applications or services independently. They will always be performing a range of additional functions like programatic 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.
In any case, a manual integration will always be possible by the use of our Filerobot Media Asset Widget, whose code/package is linked in this documentation.
The Filerobot Adobe CC embeds the Filerobot Media Asset Widget (FMAW) plugin inside the following supported Adobe applications:
Adobe Photoshop
Adobe Illustrator
Adobe InDesign
No more copy-pasting media assets from your local drive to Filerobot, everything happens from 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 Filerobot widget/extension at Window > Extensions > extension_name.
First, you need to log in to your Filerobot account from the Widget.
Then, you can select the Company and Project you would like to access (for multi-project Filerobot accounts).
You can browse your container and its folder structure directly from the widget and use the search and sort functions. You can also create folders.
You can upload images from Photoshop directly to your Filerobot container. Downloaded images from Filerobot can be inserted as a new file or as a new layer in existing Photoshop project.
...
...
Filerobot Magento Plugin
The Filerobot 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:
Install the Filerobot module for Magento 2;
Add your security configuration parameters to access your Filerobot 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 Filerobot (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.
Filerobot supports Open Source and Commerce Edition from version 2 onwards.
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
Once the steps listed above are completed, you need to enter your Filerobot token and security template into the Filerobot module configuration the Magento admin interface: Stores > Configuration > Filerobot By Scaleflex > Filerobot integration.
If your token and security template id is verified, please activate the module by selecting Yes in the Filerobot 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.
Filerobot Token: Your Filerobot token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Developers top menu;
Filerobot upload directory: This is the top storage folder for your assets. The default value is /magento
.
Please create the folder in Filerobot first to prevent an error. If you want to change it, you need to check if the folder exists in your Filerobot container.
Please click on Icon Filerobot 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.
Obtain a Filerobot token (request it );
You can if you don't already have a Filerobot account.
If you have a question or need assistance, feel free to .
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 . Then, unzip the source code to app/code folder.
The Canva plugin allows you to create using all the power of Canva along with any existing templates and designs you already have saved, and transport your final render into your Filerobot library.
Simply follow the below steps:
Click the Upload button (1), and select the Canva option (2)
Then login using you 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 transport your creation as a regular asset, added in the current folder with a simple click on "upload" (4) -after any transformation you could wish to execute from the "settings" side panel-
Filerobot Contentful App
The features of the Filerobot Contentful App include:
Asset Manager widget in Contentful Content Management;
Multiple file type support;
Metadata sync: asset metadata from Filerobot will show on your Rest/GraphQL response.
There are 3 simple steps for enabling the App on your Contentful instance
(prerequisite) Have a Contentful Account;
Obtain a Filerobot token (request it here);
Install the Filerobot App from the Marketplace;
Add your security configuration parameters to access your Filerobot library.
Register for a demo if you don't already have a Filerobot account.
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:
Find it here https://www.contentful.com/marketplace/ and install it or click install now on https://www.contentful.com/marketplace/app/scaleflex-filerobot/.
Filerobot Token: Your Filerobot token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Developers top menu;
Filerobot upload directory: This is the top storage folder for your assets;
Assign to Fields: The app supports only the JSON Object Field, you can choose which field will be used by the app.
With the Asset Manager (1) button you can open the FMAW (Filerobot Media Asset Widget):
You can upload new assets with the Upload button (2):
or choose assets existing in your container (3) and Add (4) them:
You can delete a specific asset ot clear all of them (5):
Filerobot Contentstack App
The features of the Filerobot Contentstack App include:
Asset Manager widget in Contentstack Content Management;
Multiple file type support;
Metadata sync: asset metadata from Filerobot will show on your Rest/GraphQL response.
There are 3 simple steps for enabling the App on your Contentstack instance
(prerequisite) Have a Contentstack Account;
Install the Filerobot App from the Marketplace;
Add your security configuration parameters to access your Filerobot library.
Sign up to Contentstack.
Updating
Security Template Identifier: Security template ID, found in the Developers top menu;
Container: Your Filerobot 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 Filerobot and choose image
Custom Field
JSON Rich Text Editor
Obtain a Filerobot token (request it );
if you don't already have a Filerobot account.
Step 1. On Content Type Menu
Step 3. Save and Close
Step 4. On Your Entry open Filerobot and choose image Step 5. Publish
Step 1. On Content Type Menu
Step 2. Select Scaleflex Filerobot
Step 5. Publish
Filerobot Opencart plugin
The Filerobot Plugin is an extension which adds Asset Management to Opencart.
There are 3 simple steps for enabling the Filerobot plugin on your Opencart admin:
Obtain a Filerobot token (request it here);
Install the Filerobot module for Opencart;
Add your security configuration parameters to access your Filerobot 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).
Register for a demo if you don't already have a Filerobot 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 Filerobot and update all configurations.
Filerobot Token: Your Filerobot token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Developers top menu;
Filerobot upload directory: This is the top storage folder for your assets.
Please create the folder in Filerobot first to prevent error.
You need to enable the extension in order to use Filerobot 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 Filerobot before returning data to the view. An examples for banners would be:
Filerobot Drupal module
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
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 Filerobot Asset Hub;
CNAME: If you have a CNAME configure in Filerobot Asset Hub, you can enter it in this field;
Security Template Identifier: To load the Filerobot Widget or Filerobot Image Editor, you need to create a Security Template in your Filerobot Asset Hub first. This will grant your Drupal instance the necessary credentials to access your storage;
Filerobot upload directory: The directory in your Filerobot account where the files will be stored.
You need to click Update widget to load the image after choosing the image from the Filerobot widget.
Filerobot x Opencart v4 plugin
The Filerobot Plugin is an extension which adds Asset Management to Opencart.
There are 3 simple steps for enabling the Filerobot plugin on your Opencart admin:
Obtain a Filerobot token (request it here);
Install the Filerobot module for Opencart;
Add your security configuration parameters to access your Filerobot library.
Register for a demo if you don't already have a Filerobot account.
Login to Admin Dashboard
Go to Extensions > Installer and upload the file filerobot.ocmod.zip
Install Filerobot plugin
Navigate to Extensions/Extensions, choose Modules from the drop-down menu, select Filerobot and update all configurations.
Filerobot Token: Your Filerobot token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Developers top menu;
Filerobot upload directory: This is the top storage folder for your assets.
Please create the folder in Filerobot first to prevent error.
You need to enable the extension in order to use Filerobot 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 Filerobot before returning data to the view. An examples for banners would be:
Filerobot 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.
Register for a demo if you don't already have a Filerobot account.
- Download the Filerobot module
Step 1: Download the latest version Download Latest release of Module
Step 2: Unzip the file and change the folder name to "filerobot"
Step 3: Zip the file with the name "filerobot.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"
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 Filerobot Token
Security template identifier: Your Filerobot security template (in the top menu Developers)
Filerobot upload directory: The directory where you want to store/manage assets
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)
Filerobot Strapi plugin
To get Filerobot integrated you will need to setup these 2 components:
Filerobot plugin: https://github.com/scaleflex/strapi-plugin-filerobot/blob/v4/README.md;
Filerobot upload-provider: https://github.com/scaleflex/strapi-provider-upload-filerobot/blob/v4/README.md.
Benefits:
All your media will be hosted on Scaleflex's Filerobot platform;
You have the option to syncronize all your existing media to Filerobot;
You will have access to Filerobot Media Asset Widget (FMAW), where you can upload media to Filerobot and select media from Filerobot.
Additional workflows or enrichments can be performed from the Filerobot Hub UI
Register for a demo if you don't already have a Filerobot account.
Install the Filerobot plugin and you should see Filerobot by Scaleflex in the left menu.
The following options are available to you:
Then, install the Filerobot upload provider. Every media you upload will have Filerobot URLs:
Upload media to Filerobot:
Select media from Filerobot:
Beginning with 2 local images
and 4 images on Filerobot
Synchronize
Results
Filerobot Shopware module
Step 2: Rename the Zip file with the name filerobot.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 activate;
Activation: Enable/Disable the module;
Token: Please enter your Filerobot token here (eg: abcdefgh);
CNAME: Enter the CNAME as per the configuration done in your Filerobot Asset Hub interface, once validated and the SSL certificate is accepted. (Or leave blank if none);
Security Template Identifier: To load the Filerobot Widget or Filerobot Image Editor, you need to create a Security Template in your Filerobot Asset Hub first, in order for your Shopware instantiation of the Filerobot Widget to obtain proper credentials and access your storage;
Filerobot upload directory: The directory in your Filerobot account, where the files will be stored.
The step to get "Admin access key ID" and "Admin secret access key":
Filerobot Sylius plugin
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
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 Filerobot Sylius plugin, the following components need to be updated:
Create file in config/routes/scaleflex_sylius_filerobot.yaml
with the following content:
Change form theme {% form_theme form '@ScaleflexSyliusFilerobotPlugin/Admin/Form/imagesTheme.html.twig' %}
in your templates/bundles/SyliusAdminBundle/Product/Tab/_media.html.twig
Change grid thumbnail column template
Create a file config/packages/scaleflex_filerobot.yaml
and add content bellow
Navigate to Configuration / Scaleflex Filerobot
You can enable the plugin only if both token and security template id are correct.
Activation: Enable/Disable Filerobot plugin
Filerobot Token: Your Filerobot token, unique Filerobot Project and gallery identifier
Security Template Identifier: Your security template ID, found in the "Developers" section of your Filerobot admin
Filerobot upload directory: (sub)folder path to your asset's gallery, eg. /my_sylius_folder
The Filerobot plugin offers various Twig methods and filters to assist developers:
is_filerobot(image_path)
: Twig function which checks if an image is stored in Filerobot;
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 above
If you use Scaleflex Filerobot 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
:
if you don't already have a Filerobot account.
Step 1: Download the latest version
if you don't already have a Filerobot account.
This command requires you to have Composer , as explained in the installation chapter of the Composer documentation.
Please note that this plugin is directly developed and maintained by the Uniform team.
This integration allows business users to build personalized landing pages and applications by repurposing content from your Scaleflex Filerobot digital asset management system. It also enables developers to use their preferred front-end tools to build these applications.
Make assets housed in Scaleflex Filerobot available to the Uniform asset library by adding this integration.
Log into Scaleflex Filerobot 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 Development section.
Click on Security templates link.
Create a new template if not created yet.
Note the Secret Key of your template. You will need this value in the next section.
In Uniform, open your project.
Navigate to the Integrations tab.
Scroll to the section Browse Integrations.
Click Scaleflex Filerobot.
Click Add to project.
Enter the required values:
Click Save.
After you install the Scaleflex Filerobot integration, new asset library becomes available.
You can manage your Scaleflex Filerobot assets from inside Uniform. Uniform leverages its Media Widget to provide access to your library throughout your project.
You can insert assets directly into your Uniform Canvas components using asset parameters.
The Filerobot Adobe CC embeds the FMAW plugin inside following supported Adobe applications:
Adobe Photoshop
Adobe Illustrator
No more copy-pasting media assets from your local drive to Filerobot, everything happens from your Adobe application.
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 Filerobot widget/extension at Window > Extensions > extension_name.
First, you need to log in to your Filerobot account from the Widget.
Then, you can select the Company and Project you would like to access (for multi-project Filerobot accounts).
You can browse your container and its folder structure directly from the widget and use the search and sort functions. You can also create folders.
You can upload images from Photoshop directly to your Filerobot container. Downloaded images from Filerobot can be inserted as a new file or as a new layer in existing Photoshop project.
...
...
Filerobot Akeneo connector app
The Filerobot Akeneo app offers the following features:
One Filerobot token supports only one Akeneo EE Instance. One Akeneo EE Instance however can use multiples Filerobot 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
Your Akeneo plan needs to be Enterprise Edition.
You need to login to Filerobot Hub first
After login to Akeneo, navigate to Connect / App Store and Find the Filerobot by Scaleflex App
Then click Connect: You will redirected to the Filerobot Asset Hub and will be able 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 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 Filerobot
Choose to go to Setting
View the Asset Library
1. General Settings
General setting
Enable / Disable: If disabled, you cannot use Akeneo Sync feature on Filerobot
Default size: Default image size will be used if there are no config related to each asset
Default function: Crop or Fit
Please click Apply change to update configuration
After updating the settings, please refresh the Filerobot browser page
Size settings: please see the size section below
Sync all setting / Best fit for newcomers
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 support 3 types
Global: Affect all asset include 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 can happen:
(5) / (6) Function and Size
Function: Crop and Fit
Size of asset to be resized
Must follow format: widthxheight, example: 300x400
Edit / Delete
(1) Click on Edit on each setting
Same as Add new
(2) You can Delete by click Delete button on opened Modal
(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 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 click 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
You must close the asset popup and open again to make new metadata available to sync(5)
Filerobot Wordpress plugin
The Filerobot WordPress Plugin allows integration of Filerobot with your WordPress website.
The plugin allows you to interact with your WordPress database and upload or access media assets from within the Filerobot DAM.
You only need to have a Filerobot account and install the plugin in your WordPress site.
Or
Step 4 - Enter "Filerobot" in the search field and then install the plugin
Step 5 - Activate (it will not modify yet your current configuration or image source & delivery)
Step 6 - Navigate to the Filerobot admin page
Step 7. Fill-in the plugin's settings page with authentication parameters
CNAME: You can set a custom domain. When some clients' images on Filerobot redisplay and they don’t want the Filerobot’s domain to appear in the images' URLs, then it's possible to set it there.
Filerobot token: The token (project id) that you signed up for, from Filerobot.
Filerobot upload directory: Which "root" folder you want to upload to on the Filerobot platform.
“Don’t store media assets on WP server” checked means not to store the size-variants of an image on the “local” WP CMS. The original image is however still stored on the WP CMS.
“Use Filerobot Media Asset Widget as gallery” checked means only use FMAW as the Media Gallery/Uploader. The default WP Media Gallery will therefore be hidden.
“Synchronize Filerobot metadata” checked means this option will import the metadata available in Filerobot (tags, etc.) in your image description and alt text to facilitate search. 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” checked means this option will import the specific metadata fields in Filerobot with the selected metadata fields chosen in the setting. Warning: This setting needs a specific set of metadata in Filerobot 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 Filerobot 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 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 Filerobot is installed and activated, you have these 2 images on your WP CMS and these 2 images on your Filerobot platform:
At this point, the images' URLs still have WP CMS URLs
After you install, activate and configure Filerobot, you can first check the connection to Filerobot. 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 Filerobot URLs
and on Filerobot platform
The next major feature that Filerobot brings is: the Filerobot Media Asset Widget (FMAW) in Media Library
Here you can upload your media assets to the Filerobot platform (instead of WP’s local library)
The next major feature that Filerobot brings is that: anywhere where the Media Manager opens, a FMAW tab will be inserted into it.
The next feature that Filerobot brings is it’s image editor, instead of WP’s image editor
Filerobot also has a cron
Deactivation
When you deactivate Filerobot, all the media assets that has been synchronized to Filerobot will be removed.
From Jan 2022: We enabled the Media files' metadata sync:
FR meta -> WP meta,
FR tags -> WP alt,
FR comments -> WP contents
From Jan 2022: Filerobot plugin only works with these settings:
June 2022: All English. No more Multilingual, language strings, etc …
The Filerobot Wordpress plugin works well with other popular plugins:
Classic Editor
Gutenberg Editor
WooCommerce
Elementor
ACF
... but let us know if you have any compatibility issue with third parties plugins; as WordPress is a very open system, it is always possible that some plugin overwrite part of the configuration.
Uniform setting | Value |
---|---|
Step 1. the extension files from the link bellow and unzip them.
You need an active Filerobot account. if you don't already have one;
Navigate to Settings / Developement / Akeneo PIM to open the Setting page. Alternatively, you can follow this
The App | Akeneo |
---|
If you are new to Filerobot, here is a short introduction:
Plugin:
if you don't already have a Filerobot account.
Security Template Identifier: It’s like a way obtain limited-time passwords. See: . 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 ()
Container Id
Your Filerobot container id (aka token).
Security templates secret key
Security templates are meant to be used by frontend applications calling the Filerobot DAM API directly or via the Filerobot Media Asset Widget.
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 |
Integrate Hygraph with Filerobot 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 Filerobot Media Asset Widget:
As Original
: This option is available for all assets. Adds them to the content entry as is as 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 crop part of it.
This integration is developed and maintained by our partner Hygraph.
Useful resources:
Filerobot Commercetools connector app
Nginx
PM2
Nodejs > v16.10.0
Certbot
To install the Filerobot module, please follow the steps below:
1. Download the latest version Download Latest release of Module
2. Upload and unzip to the server at your domain path (Ex: /var/www/public_html/)
3. Configuration Commercetools & Filerobot 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 Filerobot 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 Filerobot module:
Clone file filerobot-config.json.example in folder "src" and rename to filerobot-config.json
Input your Filerobot token, SEC, upload directory, and any other options as fitting.
Filerobot Pabbly integration
Pabbly connects more than 800+ software products for seamless real-time data transfer. Their simple integration platform allows anyone to seamlessly integrate Filerobot with other applications to automate workflows.
After logging in Filerobot, 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 Filerobot 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 FIlerobot and that events data are sent to Pabbly. Filerobot Pabbly connector has the following triggers:
Filerobot Pabbly connector has the following actions and corresponding inputs:
Add custom element
Content model (left hand side) > Create new > Custom element (right hand side). You will then have the below view.
Parameters:
note: "dir" element is optional, by default will go to the root folder of your library. Do not add "/" at the start & end of the directory string.
Create new content with this Custom Element
Content & asset (left hand side) > Create new > Chose type: FMAW. Chose and add some images, publish. You will then have the below view.
The images below are the images added in from FMAW into a Kontent content-item. When they are added, they will have Filerobot-URLs (instead of their Strapi CMS URLs).
Go to Settings > API Keys. For this, you will definitely 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 set of APIs that you can interact with
For the 3 content items that comes out of the box, Kontent already have an example client app, which we can imitate.
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
You can if you don't have a Filerobot Account.
Trigger Name | Description |
---|
Action Name | Description | Inputs |
---|
Have a Kontent CMS setup.
**Hosted code URL: *
Tutorial:
Delivery APIs in plain HTTPS form can be downloaded from and imported into POSTMAN
This example app was made by using React JS
or
or hello@scaleflex.com
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 filerobot | Origin File Url,File name |
File Delete | Delete file from Filerobot | File UUID |
File Rename | Used to rename file. | File UUID,File new name |
Folder Create | Create new folder in Filerobot. | Folder path |
Folder Delete | Delete folder in Filerobot | Folder UUID |
Folder Rename | Rename folder in Filerobot | Folder UUID,Folder new name |
Folder List | Lists all folders details | (N.A.) |
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
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
.
Filerobot Shopify app
You already have a store on Shopify.
From Shopify, open the Filerobot app in the Apps menu item and click the button “Configuration”
Fill-in your Filerobot token, CNAME (not required), Security Template Identifier (SEC), Upload Directory (not required, the default will be "/"), and “Save”
Add Filerobot snippets to your theme: In modal Configuration, click the button “Update Snippets” to update or create new Filerobot snippets in your theme store.
Add product webhooks for action create/update/delete, that will check and update images to Filerobot Hub when the user has action create/update/delete.
In Shopify, open the Filerobot 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 on your store, the process will download all product images from Shopify and store them on Filerobot Library.
Fill in your product name you need to "Sync"
You can add Filerobot images to your site by editing your theme's code.
The snippets provide the functionality to display images on your site
filerobot-image-tag.liquid: Builds an image tag with multiple sources to render product images on your site lazily, applying transformations.
filerobot-product-media.liquid: Uses filerobot-image-tag to render product images on your site, with optional transformations.
filerobot-url.liquid: This will help you build a Filerobot URL to deliver an image on your site 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 Filerobot image on your page
First we need assign variable fr_metafields
Example:
To render image tag
Example:
To get Filerobot image url
Example:
Parameter | Description |
---|---|
The Filerobot x Shopify App can be installed from the .
to be helped adding the App to your store.
Have a Filerobot Asset Hub account, with the Filerobot App installed. If you don't have an account yet, please to get one;
Create the Security Template Identifier (SEC) to use the app (Setting > Security templates > )
Note: Read more about attribute optimizer following this
API_SECRET_KEY
can be generated in the Asset hub (documentation)
TOKEN
your Filerobot token
folder
the path to the folder you would like to list default: /
page
the result page number, starting from 1 default: 1
Filerobot 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 Filerobot with other applications to automate workflows.
The Filerobot integration allows to:
Setup a trigger when a new file is uploaded to Filerobot (useful for setting up notifications, transforming uploaded files or using other tools)
Upload new files to Filerobot
Transform files in Filerobot (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 Filerobot or any other tool. Filerobot can either start the Zap or execute the actions for the trigger coming from other tools, as shown in the example below.
Once the Filerobot trigger/action is added, you will be asked to "Choose account" to connect to Filerobot.
New browser window will pop up asking for authentication details to Filerobot Asset Hub.
Filerobot Token can be found in the Filerobot Asset Hub project selector and next to the project title. While Filerobot API Secret Key is available in the Developers menu in the Filerobot 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 Filerobot 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 Home folder of your Filerobot account. When looking for a specific folder, you can add the folder path manually or use the search function for exiting folders in the Home folder path.