Download Webmin 1.441

Webmin Documentation

Tip of the Day

Other Sites

Look and Feel

All Webmin modules should have the same general colour scheme, look and feel as defined by the following rules:

• All pages should be viewable on any browser that supports images, tables and forms. Browser features such as frames, DHTML, Javascript or Java should not be used unless there is no other option. It should be possible to use Webmin from browsers such as Netscape 1.1 or Pocket IE.

• All CGI programs that generate HTML output should call the header() function. This ensures that a standard page heading is generated, according to the theme in use. The only exception is a CGI that does not want any heading at all, such as one used in a pop-up selection window.

• The header() function outputs HTML tags setting the background, text and link colours for the generated page based on the chosen theme and colour scheme. The init_config() function sets the global variables $tb and $cb which should be used as the background colour for table headers and body rows respectively, as in this example :

  print "<table border width=100%>\n";
  print "<tr $tb> <td><b>Foo</b></td> <td><b>Bar</b></td> </tr>\n";
  print "<tr $cb> <td>some value</td> <td>another value</td> </tr>\n";
  ...
  

• Try to avoid generating HTML forms that contain a large number of input fields. Some browsers (particularly netscape on Unix) slow down when rendering such pages.

• Your module's main page (usually index.cgi) should set the config and noindex parameters of the header function to 1, assuming that the module does have a config.info file. This ensures that a Module Config link appears on the main page, and that the Module Index link does not.

• Other pages in the module should call header with the title parameter of set to the title that you want to appear, and the image paramater to an empty string. This ensures that a conventional title is displayed, and that a Module Config link back to the main page appears.