Home

Summary

• Enable the module and any option submodules (see below for details)
• Assign 'administer custom breadcrumbs' permission to those roles that should be allowed to add/edit/delete custom breadcrumbs.
• Assign 'use php in custom breadcrumbs' to roles that should be allowed to use php to determine breadcrumb visibility.
• Go to Configuration > User Interface > Custom breadcrumbs Settings to select the 'Home' breadcrumb text and possibly other global settings.
• Don't forget the breadcrumb settings (if any) at the admin/appearance/settings/[THEME] page!
• Go to Structure > Custom breadcrumbs to add new breadcrumbs
• To add a breadcrumb, click on one of the tabs at the top of the page. For example, click 'Node' to create a custom breadcrumb based on node type.
• Fill in the required information for the breadcrumb (varies depending on breadcrumb type, see below).
• For the titles, put each "crumb" one line after another (There is no need to put in "home")
• (optional) For each crumb title you can specify a title attribute ("tooltip") to add to the link. Separate the crumb title and the title attribute with a pipe (|) symbol:

   Item 1
   SubItem A|Title attribute for SubItemA (optional)
   SuperSubItem X

• For the paths, put the path to each crumb starting after the domain name. Don't include a leading or trailing slash.

   item1
   item-1/subitem-a
   item-1/subitem-a/supersubitem-x

• Click save to save the breadcrumb
• Visit the page and your breadcrumb should appear!

User interface

The user interface has been modified for Custom Breadcrumbs 2.0. Breadcrumbs from all custom breadcrumbs modules are tabulated at admin/structure/custom_breadcrumbs. The table can be sorted according to breadcrumb name, type, language (if locale is enabled) by clicking on the column headers. The table can also be filtered to display breadcrumbs of a specific type, language, or combination of the two.

A new custom breadcrumbs fieldset has been added to node edit pages. All defined breadcrumbs for a particular node are displayed here, with an option to edit each. If no breadcrumbs have been defined for a particular node, then a link can be followed back to admin/structure/custom_breacrumbs to add a custom breadcrumb.

Languages

If the core Locale module is enabled, then an additional option to specify the language for the breadcrumb is available when constructing the breadcrumb trail (with any of the custom breadcrumb modules).

Home breadcrumb

The text to display at beginning of the breadcrumb trail can be assigned from the custom breadcrumb configuration settings page. Typically this is Home or your site name. You can leave it blank to have no home breadcrumb. As with normal crumb titles, you can optionally specify a title attribute ("tooltip") for the crumb. Just separate the crumb text and the title attribute text with a pipe (|) symbol (i.e. Home crumb text|attribute title text). There is also an advanced setting to set the Home breadcrumb text on ALL pages, not just those with defined custom breadcrumbs. You can also use this feature to remove the home breadcrumb on all pages on the site - just enable the advanced setting and then leave the home breadcrumb text blank.

It is possible to translate the home reference title from custom breadcrumbs using the i18n module. Just put this in your settings.php:

  $conf['i18n_variables'] = array(
    //custom breadcrumbs
    'custom_breadcrumb_home',
  );

Then you can change it for each language at http://example.com/#lang-prefix#/admin/settings/custom-breadcrumbs.

See http://drupal.org/node/313272 for additional information.