59.4. The theme_footer Function

This function is much simpler and not very different from the standard footer function from web-lib.pl. It just prints HTML to close the table started by theme_header (unless $theme_no_table is set), followed by links to previous pages as specified in the parameters. Finally, the required </body> and </html> tags are produced to properly end the page.

When overriding the footer function in your own theme, make sure that it properly processes all of the parameters, as multiple pairs of return links and titles can be provided. If your theme's main menu categorizes modules, any link to / should be replaced with a link like /?cat=$module_info{'category'} so that the current module's category is displayed when such a link is used to return to the main menu. Most themes put an arrow next to each of the return links, but this is not required. Yours can just use text links, form buttons, or anything that you can think of.

If the last parameter to the footer function is non-zero, it will not produce HTML for the end of the page and instead will only generate the return links. The MSC theme's theme_footer function checks for this, if the number of parameters is odd, and does the right thing. Your theme should, too, as some Webmin programs depend upon this behavior to get the correct layout.