---
title: "Global Configuration"
description: "Configure the proxy used to fetch pages for analysis – essential for Docker, basic-auth-protected staging, and other restricted setups."
canonical_url: "https://kirby.tools/docs/seo-audit/configuration/global"
---

# Global Configuration

> Configure the proxy used to fetch pages for analysis – essential for Docker, basic-auth-protected staging, and other restricted setups.

Most of the SEO Audit configuration can be done in your blueprints per view button or section. Additionally, you can configure internal handling of the plugin globally in your `config.php` file.

## Global Defaults

### `logLevel` <u-badge className="align-middle,ml-2,rounded-full!" label="String" variant="subtle"></u-badge>

Default logging level for the analysis. Options: `error`, `warn` (default), `info`, and `debug`. Inspect the browser console to see the logs.

```php [config.php]
return [
    'johannschopplich.seo-audit' => [
        'logLevel' => 'info'
    ]
];
```

## Proxy Configuration

For specific use cases, such as running Kirby inside Docker containers, you can adjust the proxy configuration globally.

### `urlResolver` <u-badge className="align-middle,ml-2,rounded-full!" label="Closure" variant="subtle"></u-badge>

The `urlResolver` property accepts a closure that is used to resolve the URL of the proxy API. This is useful if you run Kirby inside Docker containers and need to resolve the URL to the host machine:

```php [config.php]
return [
    'johannschopplich.seo-audit' => [
        'proxy' => [
            'urlResolver' => function (string $url) {
                $uri = new \Kirby\Http\Uri($url);

                if ($uri->domain() === '127.0.0.1:3000') {
                    $uri->setHost('host.docker.internal');
                }

                return $uri->toString();
            }
        ]
    ]
];
```

### `params` <u-badge className="align-middle,ml-2,rounded-full!" label="Array" variant="subtle"></u-badge>

Any parameter supported by Kirby's [`Remote::request()`](https://getkirby.com/docs/reference/objects/http/remote/request#params-array) method can be passed to the proxy API. This is useful if you need to authenticate against the preview URL:

```php [config.php]
return [
    'johannschopplich.seo-audit' => [
        'proxy' => [
            'params' => [
                'basicAuth' => 'user:password'
            ]
        ]
    ]
];
```

## Custom Plugin Translations

If you prefer to overwrite the default translations of the plugin, you can do so by adding translations for your language in the `languages` directory of your Kirby installation.

<note>

See the plugin's [`translations.php`](https://github.com/kirby-tools/kirby-seo-audit/blob/main/src/extensions/translations.php) for the full list of translation keys.

</note>

For example, to change the translation of the analyze button to `Check SEO` in English, append the following `translations` array to the `languages/en.php` file:

```php [languages/en.php]
return [
    'code' => 'en',
    'name' => 'English',
    // ... Other language configuration
    'translations' => [
        'johannschopplich.seo-audit.analyze' => 'Check SEO'
    ]
];
```

---

Every page of this site as Markdown: <https://kirby.tools/sitemap.md>