====== croissant Plugin ======

---- plugin ----
description: Change the displayed text in the breadcrumb path
author     : Adrian Lang 
email      : dokuwiki@cosmocode.de 
type       : syntax
lastupdate : 2016-09-07
compatible : anteater, rincewind, angua, adora belle, weatherwax, binky, ponder stibbons, hrun
depends    : 
conflicts  : 
similar    : 
tags       : breadcrumb

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-croissant/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-croissant/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-croissant/
donationurl: 
----

The plugin allows you to change the displayed text of a page in the breadcrumb path. \\ Why? Sometimes the main headline is too long, with this plugin you can create nice breadcrumbs and have "meaningful" H1 headlines.

===== Installation =====
[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

In your template, replace the current tpl_youarehere invocation with

<code php>
<?php
    $croissant =& plugin_load('syntax', 'croissant');
    if ($croissant !== null) {
        $croissant->tpl();
    } else {
        tpl_youarehere();
    }
?>
</code>

===== Syntax =====

On a wiki page, write ''~~bc:CUSTOMTITLE~~'' to show ''CUSTOMTITLE'' on the breadcrumb instead this page's title/pagename.

Additionally you can write ''~~nobc~~'' to not show the breadcrumbs on that page.

===== Development =====

=== Change Log ===

{{rss>https://github.com/cosmocode/dokuwiki-plugin-croissant/commits/master.atom date}}

===== Discussion =====