Configuration

You can configure Omeka S by editing config/local.config.php. Options from the application and module configuration files are merged into local configuration and used by Omeka S services to operate the application. See the following files to reference default options and their format (do not modify the files):

• application/config/module.config.php
• application/config/navigation.config.php
• application/config/routes.config.php

Local configuration already contains options that are likely to be changed from one installation to another.

Navigation configuration. Details about configuration can be found in Zend's documentation.

Router configuration. Details about configuration can found in Zend's documentation.

• config: Session configuration options. Options can be found in Zend's documentation.
• save_handler: The session save handler service (must implement Zend\Session\SaveHandler\SaveHandlerInterface). Set this to null to use the database save handler.

A list of MVC listeners. Add module-specific listeners to MVC events.

View manager options. Options can be found in Zend's documentation.

Configuration for asset files.

• use_externals: Whether to use external assets.
• externals: Lists of external asset URLs, keyed by local asset path.

Configuration for the access control list (ACL).

• acl_resources: A list of resources to load into the access control list. API adapters, Doctrine entities, and controllers that are registered in configuration are automatically loaded.

The path to the temporary directory.

Doctrine entity manager options.

• is_dev_mode: Whether to run the entity manager in development mode. See Doctrine's documentation for more information.
• mapping_classes_paths: A list of paths containing Doctrine entity classes.
• resource_discriminator_map: A list of entities that are mapped to Omeka's Resource entity (for first-class resources that can be described using values, i.e. RDF).

Lists of tasks to run during installation.

• locale: The language code for this locale.
• translation_file_patterns: Options for translation.

• application: Logging options for application-level messages.
• sql: Logging options for SQL-level messages.

Each logger can be toggled on or off using log. The path to each log file is stored in path.

• adapter: The connection adapter class to use.
• sslcapath: The path to the SSL certificate directory.
• sslcafile: The path to the SSL certificate file.

You can add other configuration options to this list, from Zend's documentation.

• execute_strategy: The CLI execution strategy to use, either "exec" to use PHP's exec() or "proc_open" to use PHP's proc_open().
• phpcli_path: The path to PHP CLI.

• store: The file store service, responsible for managing the storage of files.
• thumbnailer: The thumbnailer service, responsible for creating derivative images of files.
• thumbnail_types: The types of thumbnails to create and store, including the strategy and pixels constraint.
• thumbnail_options
  • imagemagick_dir: The path to the directory where the ImageMagick command is.
  • page: The page from which to create a thumbnail in a multi-paged file.
• thumbnail_fallbacks: A list of fallback images for files that have no thumbnail derivatives, keyd by the original file type.

A list of services.

A list of controllers.

A list of controller plugins.

A list of API adapters.

A list of view helpers.

A list of block layouts.

A list of navigation links.

A list of media ingesters.

A list of media renderers.

A list of file renderers.

A whitelist of URL patterns for oEmbed media.

• transport:
• default_message_options: