# Shopware

## Installation <a href="#od_1e92263f" id="od_1e92263f"></a>

### Prerequisites <a href="#od_117c69a2" id="od_117c69a2"></a>

[Register for a demo](https://www.scaleflex.com/en/request-a-demo) if you don't already have a DAM account.

### Download and install the module <a href="#step-1.-download-and-install-the-module" id="step-1.-download-and-install-the-module"></a>

#### **Install from Github**

* Step 1:  [Download Latest release of Module](https://github.com/scaleflex/shopware-filerobot-plugin/releases)
* Step 2: Rename the Zip file with the name *DAM.zip*
* Step 3: In Admin go to *Extensions* / *My extensions* / *Upload extension*

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FXKzuVtRzrTEGJLOxLwE4%252Fs1.png%3Falt%3Dmedia%26token%3D873f6bd4-a775-4cb4-bb17-f4c040c28507&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=17d9a637&#x26;sv=1" alt=""><figcaption></figcaption></figure>

#### **Install from Shopware Store**

* Step 1: In Admin go to *Extensions* / *Store* / *Catalog* and search for "Filerobot by Scaleflex":

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FaTaLDZNbFMb70PQ13Vqz%252Fs2.png%3Falt%3Dmedia%26token%3D68823b3d-a56e-46ff-864a-2bceaec120bd&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=4613a062&#x26;sv=1" alt=""><figcaption></figcaption></figure>

* Step 2: Select the extension and choose *Add extension:*

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252F9kQPXeAtIlaXP00fSZ8t%252Fs3.png%3Falt%3Dmedia%26token%3D82a62352-398b-44c0-a2ae-4bd9d574b368&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=74dc5848&#x26;sv=1" alt=""><figcaption></figcaption></figure>

* Step 3: Go to *Extensions* / *My extensions* / *Filerobot by Scaleflex - Digital Asset Management, Media Optimisation and Acceleration* / choose *Configuration:*

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252Fzs41ZKqLMxy8kOqkDgEw%252Fs4.png%3Falt%3Dmedia%26token%3D3980f70f-123f-4f04-854d-ddae380df6aa&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=5e361dda&#x26;sv=1" alt=""><figcaption></figcaption></figure>

* Step 4: Update the configuration and activate the Module and your site is ready to go:

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252F5wA8pdWqVjopeWFCBLPa%252Fs5.png%3Falt%3Dmedia%26token%3D18f41e4d-7488-4587-9dfd-7cfb4be62a0e&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=3dc44af9&#x26;sv=1" alt=""><figcaption></figcaption></figure>

### Configure <a href="#od_ebdb8e0c" id="od_ebdb8e0c"></a>

* **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);
* **Security Template Identifier:** To load the DAM Widget or DAM Image Editor, you need to create a [Security Template](https://docs.scaleflex.com/vxp-visual-experience-platform/settings/project/access/security-templates) in your DAM Asset Hub first in order for your Shopware instantiation of the DAM Widget to obtain proper credentials and access your storage;
* **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"**:<br>

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FiXX4qh9zPhxJgc9OlhwZ%252Fs6.png%3Falt%3Dmedia%26token%3D90d49a0d-988c-4b35-ac32-8e150252817e&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=a2df77ab&#x26;sv=1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2F2gLBeWy2truGLmejevLo%2Fimage.png?alt=media&#x26;token=41bf291d-66da-4f95-9104-51749f3cfec4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2Ff8RIsPpqBlFQdfOUawe6%2Fimage.png?alt=media&#x26;token=672ac901-7ff5-4b0b-9115-0ab2ebfeea68" alt=""><figcaption></figcaption></figure>
