Skip to content

A Kirby 3 panel plugin to visualise the `site/logs` folder in the panel.

Notifications You must be signed in to change notification settings

bvdputte/kirby-logbook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kirby LogBook

A Kirby 3 panel plugin to visualise the site/logs folder in the panel.
Opinionated defaults to work best with the kirby-log plugin out-of-the-box.

Kirby LogBook screenshot

Installation

  • unzip master.zip as folder site/plugins/kirby-logbook or
  • git submodule add https://github.com/bvdputte/kirby-logbook.git site/plugins/kirby-logbook or
  • composer require bvdputte/kirby-logbook

⚠️ You'll need at least Kirby 3.6 to use this plugin.

Formatting & access

For now only users with the admin role will be able to open/use the area in the plugin.

Logs from the kirby-log plugin will be output as a table. All other logs will be print as a list of lines.

Configurable options

All of them are optional.

// in site/config/config.php:

// String. Name of logfile to show by default. Defaults to first.
'bvdputte.logbook.default' => 'mylog.log',
// Array with log filenames with no access in panel. Defaults to []
'bvdputte.logbook.hide' => ['my-restricted-log.log','some-other-log.log'],
// Integer. For performance reasons, only the x last lines of the log are being fetched and shown. Defaults to 2500
'bvdputte.logbook.maxLogLines' => 2000,
// Integer. The amount of lines per paginated set in the panel. Defaults to 25
'bvdputte.logbook.paginationSize' => 50,
// Array of roles that need access to the logviewer
'bvdputte.logbook.accessRoles' => [] 

Development info

For development to the vue part, run npm run dev
To build vue sfc, before commit, run npm run build

Disclaimer

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.

License

MIT

It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.

About

A Kirby 3 panel plugin to visualise the `site/logs` folder in the panel.

Resources

Stars

Watchers

Forks

Packages

No packages published