Editing Config Options by File (section)

== P ==

=== [[paths.pl]] ===
* '''documents_path''' - Sets the path where uploaded documents for the repository archive are stored. (By default a sub-directory of the archive's parent directory called <code>documents</code>).
* '''config_path''' - Sets the path where configuration files for the repository archive are located. (By default a sub-directory of the archive's parent directory called <code>cfg</code>).
* '''htdocs_path''' - Sets the path where cached HTML files for the repository archive are located. (By default a sub-directory of the archive's parent directory called <code>html</code>).

=== [[plugins.pl]] ===
* '''plugins''' - Defines various settings for EPrints plugins.
** '''PLUGIN::NAME''' - This must follow <code>$c->{plugins}</code> (e.g. <code>$c->{plugins}->{Export::Thing}</code>).
*** '''params'''
**** '''disable''' - If set to <code>1</code> disable the plugin.
**** '''visible''' - Who should the plugin be visble to? <code>public</code>, <code>staff</code> or <code>api</code>.
**** '''advertise''' - Should the plugin be advertised in dropdowns or other listing. If set to <code>0</code> not advertised.
** '''Import::DOI''' - Only uncommented in pub_lib flavour.
*** '''params'''
**** '''pid''' - The PID (username:password) for the repository archive's CrossRef account. (Placeholder by default).
**** '''doi_field''' - The eprint metadata field that stores DOIs.  (By default <code>id_number</code>).
**** '''use_prefix''' - If prefix should be added at start of DOI.  (By default <code>1</code>, do use prefix).
** '''Import::DOI_UNIXREF''' - Only present in pub_lib flavour.
*** '''params''' - Uses <code>Import::DOI</code> params with <code>Import::DOI_UNIXREF</code>.
* '''export_privacy''' - Restricts certain export plugins being available to non-logged in users where export may contain information covered by privacy laws (e.g. email addresses) and can be found in [[y_export_privacy.pl]].  (By default set to <code>1</code> enforce export privacy for pub_lib flavour.  Zero flavour does not define this configuration option as none of its export plugins have privacy concerns by default).
* '''plugin_alias_map''' - Allows an alternative plugin to be aliased to an existing one.  Useful if you want to augment an existing plugin, without modifying the original plugin file.  (E.g. <code>$c->{plugin_alias_map}->{"Export::DC"} = "Export::LocalDC";</code> uses extended <code>Export::LocalDC</code> plugin to replace <code>Export::DC</code> plugin it extends).

=== [[private_ips.pl]] ===
* '''ignore_x_forwarded_for_private_ip_prefixes''' - Lists private IP address subnets that if the X-Forwarded IP address is set and lies within then the original remote IP address is logged in the access table/file instead.