# mod\_admin\_config

Source: https://zotonic.com/docs/1759/mod_admin_config

URI: https://zotonic.com/id/1759

Language: en



Add support for editing the site’s configuration values, as accessed through <a href="/id/doc_model_model_config" class="doc-reference doc-reference-model"><code>model#config</code></a>.

The page in the admin is a list of every configuration module, key and textual value. Entries can be added, removed, and edited, if the user has the permission to do so.

When a value is longer than 65 characters, it will be truncated in the admin config list view. To view the whole value, click the row.

SSL certificates configuration
------------------------------

Via the menu System > Configuration > SSL Certificates all available certificates can be viewed.

The SSL modules add a panel here using a template `_admin_config_ssl_panel.[module_name].tpl`. Only the SSL modules providing a certificate are listed.

Here the module `mod_ssl_letsencrypt` lets you request a free certificate from the LetsEncrypt service.

Email configuration
-------------------

The System > Configuration > Email configuration page groups the settings used for outgoing e-mail. It also provides a form for sending a test message, which is useful for checking the effective SMTP configuration.

Other e-mail modules can add their own settings panel by providing an `_admin_config_email_panel.tpl` template. The page uses an `all include`, so every matching module template is rendered. Configuration values shown by those panels are available through <a href="/id/doc_model_model_config" class="doc-reference doc-reference-model"><code>model#config</code></a>.

Accepted Events
---------------

This module handles the following notifier callbacks:

- `observe_admin_menu`: Add site-configuration menu entries for editable config sections.

Delegate callbacks:

- `event/2` with `submit` messages: `config_save`, `test_email`.
- `event/2` with the `regenerate_self_signed` postback: Replace Zotonic’s fallback certificate for the site hostname.

License: 

Attribution: 

Related resources: https://zotonic.com/api/agent/related/1759?language=en


## API access

- [API help](<https://zotonic.com/api-help>)
- [OpenAPI specification](<https://zotonic.com/openapi.json>)
- [This resource as JSON](<https://zotonic.com/api/agent/resource/1759?language=en>)
