Breadcrumb Navigation 1.0.0
by Jeff Tickle <jeff at jeff tickle dot com>

Hi!  Thanks for grabbing this exciting Breadcrumb module.

-=-

Configuration is rather straightforward.  The Breadcrumb Navigation
module is by default listed under the Site Content tab in the Control
Panel.  It has the very poorly gimped drawing of a loaf of bread and some
crumbs.

The "Home Link Text" is what you want your home link to say.  It can be
something like the default "Home," or perhaps "Main," "Home Page," or
something more appropriate to your language.

The Separator is what you want put between your breadcrumbs.  It can be
up to 255 characters, although we recommend only 2 or 3.  Some popular
separators include |, >, >>, <>, #, etc.  The "Display a separator
character before BCN" checkbox simply directs Breadcrumb Navigation to
either place a separator BEFORE the Home link, or not.  Usually popular
with the > variants of separators.

-=-

There are two ways to display breadcrumbs on your page.  The default
functionality is to display as a block.  The alternative is to grab the
breadcrumbs through your theme.php.

Method 1: In order to display as a block, go to Breadcrumb Settings in
the Control Panel.  Select the modules you wish the BCN to display on,
and hit Save Settings.  You will now have a Breadcrumb Navigation block
for each module you selected.  Unless you are using method #2 below, I
recommend leaving pagemaster and breadcrumb selected at all times.

Method 2: You can also integrate the breadcrumbs more seamlessly into
your theme.  Edit your theme's theme.php file, and put the following code
in it somewhere:

INCLUDE_ONCE PHPWS_SOURCE_DIR . 'mod/breadcrumb/class/Breadcrumb.php';
$THEME['BREADCRUMBS'] = PHPWS_Breadcrumb::getCrumbs();

Next, edit your theme's theme.tpl file and put the tag {BREADCRUMBS}
wherever you wish breadcrumbs to appear in your theme.

By default, getCrumbs will apply a div of class 'breadcrumb' arround your
Breadcrumb Navigation.  To change this, edit the file
PHPWS/mod/breadcrumb/templates/container.tpl.  Or, to get rid of the
container altogether, call PHPWS_Breadcrumb::getCrumbs(FALSE) in your
theme.tpl.

-=-

Never thought breadcrumbs could be this involved, eh?  Enjoy!
