# Opencart
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 [here](https://www.scaleflex.com/request-a-demo));
* Install the DAM module for Opencart;
* Add your security configuration parameters to access your DAM library.
### **Limitations**
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).
### Installation
#### Prerequisites
[Register for a demo](https://www.scaleflex.com/request-a-demo) if you don't already have a DAM account.
#### Step 1: Upload the plugin
* 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.
#### Step 2: Configure and activate the plugin
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*;
* **DAM upload directory:** This is the top storage folder for your assets.
{% hint style="info" %}
*Please create the folder in DAM first to prevent error.*
{% endhint %}
### Usage
You need to enable the extension in order to use DAM in all pages.
#### **Step 1: Open MAW (Media Asset Widget)**
With Summernote:
With Image field:
#### **Step 2: Choose the image(s), then click insert button**
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.
### Developer's den
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:
```
foreach ($banner_images as $key => $value) {
foreach ($value as $banner_image) {
if (strpos($banner_image['image'], 'filerobot')) { // Check if image URL contain "filerobot"
$data['banner_images'][$key][] = array(
'title' => $banner_image['title'],
'link' => $banner_image['link'],
'image' => $banner_image['image'],
'thumb' => $banner_image['image'] . '&width=100&height=100', // return with dimensions
'sort_order' => $banner_image['sort_order']
);
} else {
if (is_file(DIR_IMAGE . $banner_image['image'])) {
$image = $banner_image['image'];
$thumb = $banner_image['image'];
} else {
$image = '';
$thumb = 'no_image.png';
}
$data['banner_images'][$key][] = array(
'title' => $banner_image['title'],
'link' => $banner_image['link'],
'image' => $image,
'thumb' => $this->model_tool_image->resize($thumb, 100, 100),
'sort_order' => $banner_image['sort_order']
);
}
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.scaleflex.com/digital-asset-management-dam/plugins-and-connectors/plugins/opencart.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
