webCOMAND

File Settings Content Type

File Settings configure if, when and where Files in Packages will be written to the file system.

A default File Settings configuration is typically installed with webCOMAND, under /System/Packages/"COMAND File".  It is configured to write Files in all Packages to the packages folder under a subfolder with the name of the parent Package's Namespace.  It can be disabled or overridden by other File Settings with more specific Folders and Content Types.

To install or reinstall the default File Settings, import:
/var/www/webcomand/packages/io_comand_file/install/file_settings.js

Fields

  • Title - Optional title for the settings.
  • Description - Optional description for the settings.
  • Folders - The folder(s) to apply these settings to. If no folders are selected, these settings will apply to all content matching the specified types.
  • Inherit Folders - If checked, all subfolders will also inherit these settings, recursively.
  • Content Types - The content type(s) to apply these settings to. If none are selected, this will apply to all content types in the selected folder(s).
  • Inherit Types - If checked, all subtypes recursively will also inherit these settings.
  • Approve Path - Filesystem path where to write matching content as files when it is approved.
  • Save Path - Filesystem path where to write matching content as files when it is saved.
  • Store Path - Filesystem path where to write matching content as files when it is stored (automatically as the file is updated).
  • Active - Check to enable the settings.  Uncheck to disable.

Paths

The Approve, Save and Store Paths can be specified in the following ways:

  • Package - Enter a single dot (.) to write content as files under the content's parent Package namespace folder.
  • Relative Paths - Enter a relative path (path that does not start with a slash) to write content as files relative to the content's parent Package namespace folder.
  • Absolute Paths - Enter an absolute path (path that starts with a slash) to write files from the primary "Files" folder.
  • Do Not Write - Leave the path blank to indicate that no file should be written.