Project Branding plugin for Kanboard, to allow a custom logo and some brand colours per project.

sirjeff 5a96096aca logo shows along with proper title and header 4 viikkoa sitten
Controller 053453c3a6 initial build 4 viikkoa sitten
Helper 053453c3a6 initial build 4 viikkoa sitten
Model 053453c3a6 initial build 4 viikkoa sitten
Schema 053453c3a6 initial build 4 viikkoa sitten
Template 5a96096aca logo shows along with proper title and header 4 viikkoa sitten
.gitignore 053453c3a6 initial build 4 viikkoa sitten
LICENSE b7a08ae074 changing .. always 1 kuukausi sitten
Plugin.php 053453c3a6 initial build 4 viikkoa sitten
README.md 5a96096aca logo shows along with proper title and header 4 viikkoa sitten
release.md 053453c3a6 initial build 4 viikkoa sitten
ver 053453c3a6 initial build 4 viikkoa sitten

README.md

OMI Project Branding plugin for Kanboard

Project Branding plugin for Kanboard, to allow a custom logo and some brand colours per project.
This is currently in progress. So far you can add a logo per project, and underline it with a custom colour .... yah!!!
There is a lot of styles to build in yet and the header/title still needs fixing.
I'm on it don't worry :)

Author

  • Dwayne Pivac @ OMI NZ
  • License MIT

Requirements

  • Kanboard 1.2
  • PHP 8.2.0

It is possible this works with other versions of Kanboard and PHP, but these are the version this was built and tested on.

How to install this plugin

All Kanboard plugins are found in the plugins directory. In general you just put your plugin there and that's about it!

CLI

In a terminal window ( or command for Windoze ) browse/cd to your Kanboard plugins directory and issue this command

git clone ( best method )

git clone https://vcs.nz/ominz/OMIProjectBranding.git

wget

zip ( Windoze )

wget https://vcs.nz/ominz/OMIProjectBranding/archive/main.zip

unzip main.zip

del main.zip

tar ( Nix )

wget https://vcs.nz/ominz/OMIProjectBranding/archive/main.tar.gz

tar -xzf main.tar.gz

rm main.tar.gz

GUI

Download either zip file :

and uncompress/unzip/untar into your Kanboard plugins directory

Upgrading

The best method is to use git pull if you installed via git clone.
Otherwise the usual way is to use the Uninstall link in Kanboard, then copy the plugin directory into the 'plugins', directory.
As your settings are kept in the database, you should back your database up before upgrading.
Especially in the early versions where the database table will be modified.
This message will change when the code is finalised :)

How to use

Use the "Branding" link in the left hand menu when you're in a project.
You can modify the logo per project by entering an image URL ( no upload possible here ) into the 'Logo URL' field.
The 'Accent Color' colour currently underlines the logo and that's all. It was just part of a PoC.
Still WiP so check back later :)

Compatibility

Compatibility with other Plugins.
So far I know it works with Customizer, but it will override the global logo ( which is the point of this plugin ).

Maintainers

  • Dwayne <dwayne at omi dot nz>
  • OMI Ltd. <adm at omi dot nz>