foreman_custom_banner

A Foreman plugin which provides a configurable, custom banner for the Foreman UI.

The purpose of this plugin is to provide a simple way to distinguish multiple installations of Foreman, e.g. a production vs. a development installation. As well as the possibility of a link to a "help" or "quick start" page.

Installation

Build and install the rubygem
Add install/foreman_custom_banner.rb into Foreman's bundler.d directory. E.g. in the packaged Foreman installation, /usr/share/foreman/bundler.d
Restart the webserver hosting the Foreman application

Configuration

You configure the custom banner from the Settings page on the Custom Banner tab:

$custom\_banner\_settings\_preview$

With a default installation the custom banner would look like this:

$default\_custom\_banner\_preview$

If you only wanted to have a banner text simply remove the custom_banner_url and custom_banner_url_text values:

$text\_custom\banner\_preview$

If you only wanted to have a banner url simply remove the custom_banner_text value:

$url\_custom\_banner\_preview$

You can alter the style of the custom banner by changing the values for the custom_banner_style field. This field will accept any CSS style configuration