This page describes the Installation and use of the Popup breadcrumb module, part of the Popup suite.

Note that the Popup breadcrumb uses the theme_breadcrumb hook to generate the breadcrumb. In order to display the popup breadcrumb, the current theme must not implement phptemplate_breadcrumb or hook_breadcrumb.

Installation

  1. Extract the popup archive into the site's modules directory.
  2. Go to admin/build/modules.
  3. Check the box next to the Popup breadcrumb module under the User interface section.
  4. Click Save configuration at the bottom of the page.
  5. You will be informed that the Popup breadcrumb module requires the Popup, Popup_UI and Views modules to be enabled, click Continue.
  6. The Popup breadcrumb module is now installed and ready to use.

Overview

The popup breadcrumb uses Views to render and display each of the breadcrumb level titles and popups. Each view may accept one or more arguments. These are harvested from either the current path or the path alias. On installation the popup breadcrumb module creates a view to list links to all other nodes, and configures it to be used as the first popup breadcrumb level.

Configuration

The popup breadcrumb may be configured at admin/settings/popup/breadcrumb.

To harvest arguments from the path or path alias, provide a path template in the Argument path template textbox. Use % to represent arguments.
With a hypothetical path:

node/12/edit

And a template:

node/%/%

The following arguments will be extracted from the path:
Argument 1: 12
Argument 2: edit

A link to the homepage may be appended to the front of the breadcrumb by checking the Prefix the breadcrumb with a link to the homepage box. The current page title may be appended to the rear of the breadcrumb by selecting the appropriate option on the configuration form.

Adding a level to the breadcrumb

  1. First create a View to represent the breadcrumb level.
  2. At the bottom of the Breadcrumb levels table, type label for the level in the textbox.
  3. Select the view created in step 1 in the dropdown under the Views section.
  4. Optionally select a display of the view to use in the Display column.
  5. Specify which arguments to pass to the view in the Arguments column. Arguments will be passed in numeric order to the view.
  6. Select what type to derive the level title from in the Derive from column. If the view returns nodes, select node title, and so forth.
  7. Select which argument dictates where the node title is derived from in the Argument column of the Title section.
  8. Click the Save button at the bottom the form.