silverstripe-dms/docs/en/configuration.md
Franco Springveldt 6b25237ec6 NEW Query Builder functionality added
This enhancement adds the ability to add documents to a document set based on a list of filters added from DMSDocument. Fixes #96
2017-05-16 13:26:01 +12:00

2.2 KiB

Configuration

The file location is set via the DMS::$dmsFolder static, and points to a location in the webroot.

Enable/disable documents/sets for a specific page type

If you don't need documents/document sets for a specific page type you can disable this with YAML configuration:

MyPageType:
  documents_enabled: false

Likewise, you could override a previously set configuration value by setting this back to true in a configuration file with a higher precedence.

Allowed extensions for DMS documents

By default the allowed extensions for DMS documents will come from the UploadField's allowed extesions list, and will have a customised list of extensions for DMS merged in. The base allowed_extensions is a site-wide configuration setting. See here for information on changing this.

To add extra allowed file extensions purely for DMS documents, you can update the YAML configuration property:

DMSDocumentAddController:
  allowed_extensions:
    - php
    - php5

Adding fields to the Query Builder

Query builder fields are read from the DMSDocument::searchable_fields property set in querybuilder.yml. Some default fields are provided and can be customised by modifying the field and/or filter properties of a field or adding a new field entirely.

See here for information on how to modify search filters and see here for more information on the field types available.

The default searchable filters available to query builder is as follows:

DMSDocument:
  searchable_fields:
    Title:
      title: "Document title matches ..."
    Description:
      title: "Document summary matches ..."
    CreatedByID:
      title: 'Document created by ...'
      field: 'ListboxField'
      filter: 'ExactMatchFilter'
    LastEditedByID:
      title: 'Document last changed by ...'
      field: 'ListboxField'
      filter: 'ExactMatchFilter'
    Filename:
      title: 'File name'