Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
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
You need an active Filerobot account. Register for a demo if you don't already have one;
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
Navigate to Settings / Developement / Akeneo PIM to open the Setting page. Alternatively, you can follow this link
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)
The App | Akeneo |
---|---|
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 Shopify app
The Filerobot 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 Filerobot Asset Hub account, with the Filerobot 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 (Setting > Security templates > Add template)
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:
Note: Read more about attribute optimizer following this LINK
Require:
Configuration your application in Shopify
Install 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 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 Filerobot webhook will convert the image links from Shopify CDN to Filerobot CDN link.
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 Filerobot-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 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
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 comes 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
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.
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 image on the widget and click on "Insert" button to add the image.
Note: You can select multiple images.
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.
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.
You can if you don't have a Filerobot Account.
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:
Prismic Headless CMS integration
Instead of using the /list
endpoint (), 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
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
.
if you don't already have a Scaleflex DAM account.
Scaleflex DAM token: The token (project ID) you signed up for, from Scaleflex DAM.
Security Template Identifier: It’s like a way to 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 Scaleflex DAM API ()
Filerobot upload directory: Which "root" folder do you want to upload to on the Filerobot platform?
Navigate, browse, and search for your Scaleflex DAM image and video assets for your Canva designs.
Drag and drop to add the image/video to your design.
Trigger Name | Description |
---|
Action Name | Description | Inputs |
---|
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.) |
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: |