| Current Path : /var/www/surf/TYPO3/vendor/mask/mask/Documentation/ExtensionSettings/ |
| Current File : //var/www/surf/TYPO3/vendor/mask/mask/Documentation/ExtensionSettings/Index.rst |
.. include:: ../Includes.txt
.. _extension-settings:
==================
Extension Settings
==================
These are the available settings for mask. They can be configured via the GUI in **Settings > Extension Configuration**
or directly in the AdditionalConfiguration.php like described in :ref:`installation <installation>`. If you don't change
any settings, a dummy extension `mask_project` will be created as fallback.
General
=======
.. _extension-settings-loader_identifier:
loader_identifier
_________________
| Can be either `json` or `json-split`.
| Defines which JsonLoader to use.
| Refer to the API documentation for more information.
| Default: `json`
.. _extension-settings-json:
json
____
| Only for JsonLoader.
| File with project specific mask configuration.
| Mask stores the information, which is needed to generate content elements and extend page templates into one file: `mask.json`. With this setting you can change the path to this file.
| Default: :code:`EXT:{your_sitepackage}/Configuration/Mask/mask.json`
.. _extension-settings-content_elements_folder:
content_elements_folder
_______________________
| Only for JsonSplitLoader
| Folder in which to save content element definitions.
| Default: `EXT:{your_sitepackage}/Configuration/Mask/ContentElements`
.. _extension-settings-backend_layouts_folder:
backend_layouts_folder
______________________
| Only for JsonSplitLoader
| Folder in which to save backend layout definitions.
| Default: `EXT:{your_sitepackage}/Configuration/Mask/BackendLayouts`
.. _extension-settings-pids:
backendlayout_pids
__________________
| Page ids from where the in PageTS defined backend layouts should be loaded (comma separated).
| Default: 0 (root-pid, all layouts are found)
override_shared_fields
______________________
| If you want to reuse fields with different configurations between content elements this needs to be enabled
| for example one dropdown field with different items per content element
| Be careful using this option, it will change the structure in the JSON for storing content element information and can not be undone.
| Note that Core fields are always allowed to be overridden.
| Default: false (field configuration is synced between content elements)
Frontend
========
.. _extension-settings-frontent-templates:
content
_______
| Folder for Content Fluid Templates.
| Mask generates a html file with fluid tags for each new content element. Here you can set the path to this file.
| Default: :code:`EXT:{your_sitepackage}/Resources/Private/Mask/Frontend/Templates`
.. _extension-settings-frontent-layouts:
layouts
_______
| Folder for Content Fluid Layouts.
| Here you can set the path to the fluid layouts of your mask templates.
| Default: :code:`EXT:{your_sitepackage}/Resources/Private/Mask/Frontend/Layouts`
.. _extension-settings-frontent-partials:
partials
________
| Folder for Content Fluid Partials.
| Here you can set the path to the fluid partials of your mask templates.
| Default: :code:`EXT:{your_sitepackage}/Resources/Private/Mask/Frontend/Partials`
Backend
=======
.. _extension-settings-backend-templates:
backend
_______
| Folder for Backend Preview Templates.
| Here you can set the path the fluid templates for backend previews of your content elements.
| Default: :code:`EXT:{your_sitepackage}/Resources/Private/Mask/Backend/Templates`
.. _extension-settings-backend-layouts:
layouts_backend
_______________
| Folder for Backend Preview Layouts.
| Here you can set the path to the fluid layouts of your mask backend previews.
| Default: :code:`EXT:{your_sitepackage}/Resources/Private/Mask/Backend/Layouts`
.. _extension-settings-backend-partials:
partials_backend
________________
| Folder for Backend Preview Partials.
| Here you can set the path to the fluid partials of your mask backend previews.
| Default: :code:`EXT:{your_sitepackage}/Resources/Private/Mask/Backend/Partials`
.. _extension-settings-backend-preview:
preview
_______
| Folder for preview images.
| You can change the preview image of content elements to your preferred png image (32x32 pixel) or svg graphic.
| Store them with the key of the contentelement as filename (e.g. mykey.png or mykey.svg)
| Default: :code:`EXT:{your_sitepackage}/Resources/Public/Mask`
|
.. figure:: ../Images/AdministratorManual/ExtensionConfiguration.png
:alt: Extension Manager options
Extension Configuration options in **Settings > Extension Configuration**