# You must use a tab-size of 4 spaces to edit this file.
---
site_settings:
    setting_group: errors
    title: Editing error handling settings
    tabs:
        errors:
            label: Showing errors
            edit_mode:
                enabled: true
                priv: _PRIV_EDIT_SITE_SETTING
            fields:
                description:
                    full_width: true
                    snippet:
                        html: |
                            Settings shown in pink boxes are determined in the <code>zenario_siteconfig.php</code> file.
                            Ask your Zenario system administrator to make changes.
                zenario_siteconfig:
                    type: grouping
                    name: zenario_siteconfig
                show_notices:
                    grouping: zenario_siteconfig
                    legend: Set in the <code>zenario_siteconfig.php</code> file
                    
                    label: 'Show PHP notices'
                    type: checkbox
                    readonly: true
                    post_field_html: |
                        (<code>E_NOTICE</code>)
                    note_below: |
                        This should be turned <strong>on</strong> for <strong>development</strong> and <strong>staging</strong> sites,
                        and turned <strong>off</strong> for <strong>live</strong> sites.
                        If enabled, Zenario and running modules will show messages whenever there is a warning
                        or error.
                show_all:
                    grouping: zenario_siteconfig
                    label: 'Show all other PHP errors'
                    type: checkbox
                    readonly: true
                    post_field_html: |
                        (<code>E_ALL</code>)
                    note_below: |
                        Recommended. If enabled, Zenario and running modules will show messages whenever a PHP error occurs.
 
                show_sql_errors_to_visitors:
                    site_setting:
                        name: show_sql_errors_to_visitors
                    label: 'Show SQL and Twig errors to visitors (always shown to administrators)'
                    type: checkbox
                    value: ""
                    note_below: |
                        Not recommended for production sites. Should be turned <strong>on</strong> for <strong>development</strong> and <strong>staging</strong> sites.
                        If enabled, the site will show errors from database (SQL) queries, and errors from
                        Twig Snippet and other Twig-based plugins, on visitor-facing pages. This can be helpful for development 
                        work, but should usually be left off for security reasons on production sites.
                

        mysql:
            label: Handling errors
            edit_mode:
                enabled: true
                priv: _PRIV_EDIT_SITE_SETTING
            fields:
                description:
                    full_width: true
                    snippet:
                        html: |
                            Settings shown in pink boxes are determined in the <code>zenario_siteconfig.php</code> file.
                            Ask your Zenario system administrator to make changes.
                zenario_siteconfig:
                    type: grouping
                    name: zenario_siteconfig
                
                debug_use_strict_mode:
                    grouping: zenario_siteconfig
                    legend: Set in the <code>zenario_siteconfig.php</code> file
                    
                    label: 'Run MySQL queries in strict mode'
                    type: checkbox
                    readonly: true
                    post_field_html: |
                        (<code>DEBUG_USE_STRICT_MODE</code>)
                    note_below: |
                        Recommended. If enabled, MySQL database queries will be run in "strict" mode. 
                        Should only be disabled if this site has old modules that don't obey modern, strict
                        SQL query standards.

                debug_send_email:
                    grouping: zenario_siteconfig
                    label: 'Report SQL, PHP or Twig errors by email'
                    type: checkbox
                    readonly: true
                    note_below: |
                        Recommended. If enabled, Zenario will report errors via email which result from database (SQL) queries,
                        PHP errors, and errors from Twig Snippet and other Twig-based plugins.
                    post_field_html: |
                        (<code>DEBUG_SEND_EMAIL</code>)
                email_address_global_support:
                    grouping: zenario_siteconfig
                    label: 'Support email address:'
                    pre_field_post_label_html: |
                        (<code>EMAIL_ADDRESS_GLOBAL_SUPPORT</code>)
                    note_below: |
                        Specify the email address of someone who will be able to address errors. They should ideally have
                        access to the server file system.
                    type: text
                    readonly: true
                    indent: 1
