SuperLinks 0.71
===============

By Howard Jones, November 21st 2007 - howie@thingy.com
http://wotsit.thingy.com/haj/cacti/

This plugin is an extension of my Links plugin with some important new features:
* It supports ANY number of extra tabs
* It will dynamically create the Tab graphics as pages are created
* It has the same user-based access-control as Weathermap
* It allows you to add new links to the Console menu as well as tabs
  and also blocks of content to the 'Welcome' front page.
* Allows you to directly embed another website/application without writing any HTML

INSTALLATION
============

Just as any other Cacti plugin - unzip into your plugins folder, add a line to
your include/config.php (for Cacti 0.8.6) or include/global.php (for Cacti 0.8.7)
file:

   $plugins[]= 'superlinks';

Make sure that the plugins/superlinks/content directory is writable by your
webserver user. The SuperLinks management page will warn you if this is
not correct.

NOTE: SuperLinks also requires the 'gd' php module and the related GD library (or DLL).
It also requires that GD was built with PNG support and Freetype support.

USE
===

Go into Cacti's User Management and give yourself permission to Manage and View SuperLinks Pages.

Copy some HTML fragments into the plugins/superlinks/content/ directory

Go to Cacti's Console menu, and Management..SuperLinks Pages

Choose Add, and then pick a file from the content/ list. You can then choose the name of the
Tab or Menu Item, and which of those it will be.

Click on the username in the 'Acccesible By' column to change which users are allowed to see
this particular page. Tabs will disappear for other users.

NOTES
=====
The files in content/ should NOT be complete HTML files - they should have no HEAD or BODY tags.
Only the stuff that would normally appear inside <body>.  There are 3 example files in the 
directory already.

LICENSE
=======

See COPYING for the license under which SuperLinks is released (short version - it's GPLed).

This plugin includes one icon from Mark James's excellent Silk icon set. These are released under
under a Creative Commons Attribution 2.5 License. The full icon set is available at
http://www.famfamfam.com/lab/icons/silk/

The supplied DejaVu Fonts are copyright Bitstream, with some additional glyphs copyright Tavmjung Bah.
DejaVu changes are in public domain. For more information see:
  http://dejavu.sourceforge.net/wiki/index.php/License

HISTORY
=======

0.1 - Initial Release
0.2 - Added: red tab for 'current' page. Small fix for Cacti permissions.
0.3 - Fixes for strict mysql mode. Fix for console menu errors. 
      Uses unique tab image filenames to avoid browser caching issues.
0.4 - Switched from Vera to DejaVu for fonts. Added some automatic text-scaling/layout code.
      Added checks for the relevant PHP module support.
0.5 - Added explicit license statement.
      Fix for another (pretty obscure) mysql issue if your database name
      has a '-' in it.
0.6 - Some fixes for incompatible changes in Cacti 0.8.7
      Added a 'FRONT' option that appears on the 'three basic steps' page - make-your-own-MOTD?
      Added a new sample content page that pulls data from the Docs plugin. El-Cheapo CMS!
      Fixed the zip so you don't need to rename the directory. Sorry about that.
0.7 - Allow arbitrary html content to be added to the any Superlink (thanks to TheWitness)
      When a Superlink is selected to be a console selection, include the console (and again)
      Remove the "Console->" link from the Cacti Navigation for tabs (and again!)
      Rename the Superlinks navagation item to the Superlink title when displayed (and AGAIN)
      Allow 'guest' account access to superlinks pages (if you give that user access)
      Fixed some UI bugs so that the page title appears in the management pages.
0.71  Fixed a typo in the IFRAME stuff, so including a web URL works now.
      Added in support for IFRAMEs on the FRONT option. Just cos. It's pretty ugly.
      Fix for Ubuntu/Debian failing to load fonts (thanks to corym)
