panel

Disabling the Panel

If you don't need the Panel at all and you just want to work in your content folder, you can switch the Panel off in your config file.

return [
  'panel' => false
];

Allow the Panel to be installed on a remote server

As a security measure, you cannot install the Panel on a public server by default. To allow this, you can enable the panel.install option:

return [
  'panel' =>[
    'install' => true
  ]
];

It's recommended to remove this setting after the installation on your remote server is complete.

Moving the Panel to a different URL

If you want to add a little bit of additional security to your site and hide the Panel behind a different URL, you can set the URL slug in your config.

return [
  'panel' => [
    'slug' => 'super-secret-admin-area'
  ]
];

Your Panel is now accessible at http://yourdomain.com/super-secret-admin-area

Custom Panel CSS

We have made the design of the Panel as usable, beautiful and reduced as possible so that you or your clients can fully concentrate on creating content. However, if you want to spice it up a little or adjust to your or your clients branding, you can do that with your own custom stylesheet file. Add it to your config.php file like this:

return [
  'panel' => [
    'css' => 'assets/css/custom-panel.css'
  ]
];

@import url("custom.css");

Check out the following cookbook recipe for some examples:

• Examples for customizing the Panel

Instead of adding it to your config.php, CSS to be applied globally in the Panel can also be added via a plugin: if an index.css file is present in the root folder of a plugin, it will be automatically loaded into the Panel.

Custom Panel JS

You can also add your own custom Panel scripts in the config.php, giving you even more power to bend the Panel to your liking.

return [
  'panel' => [
    'js' => 'assets/js/panel.js'
  ]
];

Custom Panel Favicon

To offer a full white-label solution for your customers, you can even set a custom favicon for the Panel. From a simple implementation…

return [
  'panel' => [
    'favicon' => 'assets/favicon.ico'
  ]
];

…to full control over all formats:

return [
  'panel' => [
    'favicon' => [
      'apple-touch-icon' => [
        'type' => 'image/png',
        'url'  =>  'assets/apple-touch-icon.png',
      ],
      'shortcut icon' => [
        'type' => 'image/svg+xml',
        'url'  => 'assets/favicon.svg',
      ],
      'alternate icon' => [
        'type' => 'image/png',
        'url'  => 'assets/favicon.png',
      ]
    ]
  ]
];

Default Panel language

You can set the default Panel language that is used before a user logs in or when the user does not have a valid language configured:

return [
  'panel' => [
    'language' => 'de'
  ]
];

If the Panel language is not configured, Kirby will default to English on single-language sites and the default content language on multi-language sites.

KirbyText/Markdown

If false, the Panel formatting buttons and drag and drop for files and links will create regular Markdown instead of KirbyTags.

return [
  'panel' => [
    'kirbytext' => false
  ]
];

Drag texts

You can define custom callback functions (pageDragText or fileDragText) for the text that gets inserted when dragging a page or a file on a textarea, e.g.

return [
  'panel' => [
        'kirbytext' => [
            'fileDragText' => function(Kirby\Cms\File $file, $url) {
                if($file->extension() === 'jpg') {
                    return sprintf('(screenshot: %s)', $url);
                }

                if($file->type() === 'video') {
                    return sprintf('(video: %s loop: true)', $url);
                }

                return null;
            },
            'pageDragText' => function (Kirby\Cms\Page $page) {
                return sprintf('Check out this great page: %s', $page->url());
            },

        ],
    ],
];