File Manager feature overviewEdit on GitHub
The File Manager feature lets you upload and manage your assets (media files) effectively. You can do the following:
- Upload and delete files in bulk.
- Add and delete files manually through the Back Office.
- Maintain multiple versions of individual files.
- Drag and drop to create and update your assets’ file structure.
- Manage files from a list view.
A Back Office user can upload files then add them to CMS pages and blocks to display on the Storefront.
Apart from images, you can add many different types of assets to your project, including but not limited to the following ones:
- PDF documents
Digital assets let content managers create rich, compelling, and attractive content for your customers. They also let you offer your customers additional information like user manuals or instructions.
The files in the Back Office are kept in a tree-like structure. A Back Office user can create folders (also known as directories) under File Directories Tree and organize them into a hierarchical system by dragging and dropping them in the file tree.
The changes take effect after Save is selected.
A Back Office user can delete any folder within File Directories Tree by selecting Delete Directory. If the deleted folder contains files, those files are automatically moved to the parent directory. Parent directory in File Directories Tree cannot be deleted.
Files List displays all the files uploaded to the Back Office in a table view. The Back Office user can view, edit, and delete files here.
File Uploader lets you store multiple versions of any file.
For example: a Back Office user uploads Instruction1.txt file (v.1). The user then updates and reuploads the .txt file (v.2). Next, the user decides that the image instruction is more useful and uploads Instruction.png (v.3).
There are now three versions of the file available: two text files and one image file.
By default, the latest version of the file is displayed to the buyer in the shop application.
MIME Type Settings
MIME Type Settings let you define the file types that can be uploaded to the Back Office.
MIME type is a standard that describes the contents of the files. MIME type indicates how a web browser will process a file. For example, if the MIME type is set as
text/html, the document will open in Notepad. If the MIME type is set as
image/jpeg, the document will open with an image viewer program.
The Back Office user can only upload files with a MIME type that is selected in the Is Allowed column. If no MIME types are defined, files of any type can be uploaded. If you add at least one MIME type, only the files of the added types can be uploaded.
The most popular file types that shop owners allow to be uploaded to the Back Office are:
|TYPE||DESCRIPTION||EXAMPLE OF MIME TYPE|
|text||Represents any document that contains text and is theoretically human readable||
For text documents without specific subtype,
|image||Represents any kind of images||
|audio||Represents any kind of audio files||
|video||Represents any kind of video files||
There are two types of assets in the Spryker Commerce OS: dynamic and static.
Dynamic assets are files added during content and product creation: adding or changing CMS pages and adding product images.
Static assets are images, fonts, CSS, JS, HTML, and PHP files that are available and used by default. All static asset files are split into folders according to the application they are used for: Zed, Yves, or Glue. PHP and HTML files stored in static asset directories are used for handling errors and showing the platform maintenance messages.
Except for the error handling files, there are no Glue-related assets.
Location of static assets
By default, static assets are stored locally in the following folders:
For organizational or cost and speed optimization purposes, the location of static assets can be changed to an external source.
The following environment variables are used for that:
See Integrating custom location for static assets for more details.
Related Business User articles
|BACK OFFICE USER GUIDES|
|Manage file tree|
|Manage file list|
|Add and edit MIME types|
Related Developer articles
|UPGRADE GUIDES||DATA IMPORT|
|Upgrade the FileManager module||File details - mime_type.csv|
|Upgrade the FileManagerStorage module|
|Upgrade the FileManagerWidget module|
For submitting the form