Title: Hansel & Gretel: Fine-Tuned Breadcrumb Generator
Author: Chris
Published: <strong>ഓഗസ്റ്റ്‌ 6, 2012</strong>
Last modified: ജനുവരി 4, 2013

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/hansel-gretel.svg)

# Hansel & Gretel: Fine-Tuned Breadcrumb Generator

 By [Chris](https://profiles.wordpress.org/rodaine/)

[Download](https://downloads.wordpress.org/plugin/hansel-gretel.zip)

 * [Details](https://ml.wordpress.org/plugins/hansel-gretel/#description)
 * [Reviews](https://ml.wordpress.org/plugins/hansel-gretel/#reviews)
 *  [Installation](https://ml.wordpress.org/plugins/hansel-gretel/#installation)
 * [Development](https://ml.wordpress.org/plugins/hansel-gretel/#developers)

 [Support](https://wordpress.org/support/plugin/hansel-gretel/)

## Description

### For Full Documentation & The Latest Updates

[Watch us on GitHub!](https://github.com/Clark-Nikdel-Powell/Hansel-and-Gretel)

### Where The Heck Am I?

Let’s face it: breadcrumbs are an integral part of websites these days. They give
an immediate sense of hierarchy to your visitors and allow users to backtrack through
your site to (hopefully) find more content. WordPress simplifies structuring sites
how ever it seems reasonable, but it takes a bit more effort to generate breadcrumbs
for all the different types of posts, and pages, and taxonomies, and archives, and…
you get the idea.

### But there are already plugins for that, aren’t there?

Sure! And a lot of them work really well for simple sites with simple hierarchies,
but many of them fall short in one way or the other:

> **Want to use the new semantic `<nav>` element?**
>  Nope sorry, all they have are`
> <p>`‘s or `<ul>`‘s.
> **Need to control the classes or IDs of the crumbs?**
>  Yep, nope; their wrapper
> has a fixed class of `breadcrumbs` though…I hope that’s all you need.
> **Uh…okay what about custom taxonomies?**
>  You already know the answer to this
> question…
> **And custom post types?**
>  Better hope they’re hierarchical!
> **Should I even bother mentioning rich snippets/microdata?**
>  Haven’t found one
> yet.

### Okay fine, but what makes you think yours is any better?

It might be obvious (considering the previous section) that this plugin seeks to
address all the customizability problems with the existing breadcrumb plugin environment
while still keeping it as easy to use as possible (read: `HAG_Breadcrumbs();`, done!).
It’s as simple as that. Hopefully it can live up to your expectations!

### Features

_The following features are currently available unless otherwise specifed._

 * **Simple Installation**
    Upload the plugin, activate via the WordPress admin,
   and drop the function where you want the breadcrumbs to appear in your template.
   Done!
 * **Fine-Tuned Control**
    H&G works right out of the box, but oftentimes we want
   custom control. Nearly every aspect of the breadcrumbs rendering can be changed
   a’la the [myriad of options](https://github.com/Clark-Nikdel-Powell/Hansel-and-Gretel#options)
   available.
 * **Microdata Integration**
    H&G by default includes the microdata format for a
   [WebPage’s breadcrumbs](http://schema.org/WebPage), a format that is jointly 
   supported by [Bing](http://www.bing.com/community/site_blogs/b/search/archive/2011/06/02/bing-google-and-yahoo-unite-to-build-the-web-of-objects.aspx),
   [Google](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=1211158),
   [Yahoo!](http://developer.yahoo.com/blogs/ydn/posts/2011/06/introducing-schema-org-a-collaboration-on-structured-data/)
   and [Yandex](http://help.yandex.ru/webmaster/?id=1122752).
 * **Full Markup Control**
    Choose any element to wrap your breadcrumbs, including
   optional class(es) or ID attributes. Likewise, you can include prefix and suffix
   content right inside the wrapper element tags for further control.
 * **Template Hierarchy Based Rendering**
    H&G utilizes the [WordPress Template Hierarchy](https://codex.wordpress.org/Template_Hierarchy)
   to determine which crumbs to show, including that elusive Comments Popup Window
   everybody (read: nobody) uses! This means, regardless of your theme, Hansel &
   Gretel will follow WP’s lead about the content on the page.
 * **Custom Post Types & Taxonomies**
    Never worry about how breadcrumbs behave 
   across your fancy new post types and taxonomies. H&G accounts for hierarchical
   and non-hierarchical types, whether or not they have an archive page, and also
   provides options to override breadcrumb display for individual post types if 
   desired.
 * **Home & Last Crumbs**
    H&G allows full control in showing home breadcrumbs and
   even allows for customized Front Page versus Blog Home Page templates. Likewise,
   the last, current page crumb has equal control depending on the needs of your
   theme.
 * **Made for Theme Developers**
    Hansel and Gretel was made by theme developers
   for theme developers. The default options and degree of customizability were 
   all considered by our team of experienced WP developers to make sense right out
   of the box, with as little further customization as possible. Give it a try and
   let us know what you think. We all want H&G to be the simplest and smartest breadcrumb
   plugin you’ll ever use! To contribute to the development of this plugin, [fork our repo](https://github.com/Clark-Nikdel-Powell/Hansel-and-Gretel)
   over on GitHub.

## Screenshots

 * [[
 * Breadcrumbs for the custom Books post-type including the genre taxonomy for Memoirs
   of a Geisha
 * [[
 * Breadcrumbs for the default Post post-type including the categories taxonomy

## Installation

_Installing Hansel & Gretel is easy-peasy, but of course there’s a bit of administrative
work on the front end you’ll need to take care of._

### Requirements & Compatibility

**Minimum (theoretical) WordPress Version Required:** 3.1.0
 **Actually Tested Versions**
3.3.2, 3.4.X, 3.5

If you find it non-operational on your particular flavor of WP, please let us know.

### Instructions

 1. Make sure WordPress 3.1.0 or better is running on your site. It will not work with
    older versions.
 2. Get the plugin onto your site, in one of many ways:
 3.  * Use the Plugin Manager via the WordPress admin to install the plugin (via Add
       New). Search for “Hansel & Gretel” and click install on this plugin.
     * Download the [stable zip archive](https://downloads.wordpress.org/plugin/hansel-gretel.zip)
       from the WordPress Plugin Repository and extract the contents.
     * Download the [bleeding-edge zip archive](https://github.com/Clark-Nikdel-Powell/Hansel-and-Gretel/zipball/master)
       from GitHub and extract the contents.
     * Clone the [GitHub Repository](https://github.com/Clark-Nikdel-Powell/Hansel-and-Gretel)
       to your local machine (or even your remote server on some hosting providers!)
       and always have an up-to-date version available to you.
 4. If you didn’t use the Plugin Manager to install H&G, upload the `hansel-gretel`
    folder to your plugins directory (`/wp-content/plugins/hansel-gretel/`).
 5. Activate the plugin through the Plugins page on the WordPress admin.
 6. Add the following snippet to your theme file(s) outside [The Loop](https://codex.wordpress.org/the_loop)
    where you want the breadcrumbs to appear: `<?php if (function_exists('HAG_Breadcrumbs')){
    HAG_Breadcrumbs(); } ?>`
 7. **Profit!**

## FAQ

  Where can I learn more about this plugin?

Checkout the [GitHub Repository](https://github.com/Clark-Nikdel-Powell/Hansel-and-Gretel)
for this Plugin!

## Reviews

ഈ പ്ലഗിന് റിവ്യൂകൾ ഒന്നുമില്ല.

## Contributors & Developers

“Hansel & Gretel: Fine-Tuned Breadcrumb Generator” is open source software. The 
following people have contributed to this plugin.

Contributors

 *   [ Chris ](https://profiles.wordpress.org/rodaine/)
 *   [ Taylor ](https://profiles.wordpress.org/taylor_cnp/)

[Translate “Hansel & Gretel: Fine-Tuned Breadcrumb Generator” into your language.](https://translate.wordpress.org/projects/wp-plugins/hansel-gretel)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/hansel-gretel/), check
out the [SVN repository](https://plugins.svn.wordpress.org/hansel-gretel/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/hansel-gretel/) 
by [RSS](https://plugins.trac.wordpress.org/log/hansel-gretel/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

Checkout the [GitHub Repository](https://github.com/Clark-Nikdel-Powell/Hansel-and-Gretel#development)
for the full changelog!

## Meta

 *  Version **0.0.5**
 *  Last updated **13 വര്‍ഷങ്ങള്‍ ago**
 *  Active installations **200+**
 *  വേർഡ്പ്രസ്സ് പതിപ്പ് ** 3.1.0 അല്ലെങ്കില്‍ അതിലും ഉയര്‍ന്നത് **
 *  Tested up to **3.5.2**
 *  Language
 * [English (US)](https://wordpress.org/plugins/hansel-gretel/)
 * Tags
 * [breadcrumb](https://ml.wordpress.org/plugins/tags/breadcrumb/)[breadcrumbs](https://ml.wordpress.org/plugins/tags/breadcrumbs/)
   [crumb](https://ml.wordpress.org/plugins/tags/crumb/)[hierarchy](https://ml.wordpress.org/plugins/tags/hierarchy/)
   [microdata](https://ml.wordpress.org/plugins/tags/microdata/)
 *  [Advanced View](https://ml.wordpress.org/plugins/hansel-gretel/advanced/)

## Ratings

 5ൽ 4.8 നക്ഷത്രങ്ങൾ.

 *  [  7 5-star reviews     ](https://wordpress.org/support/plugin/hansel-gretel/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/hansel-gretel/reviews/?filter=4)
 *  [  1 3-star review     ](https://wordpress.org/support/plugin/hansel-gretel/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/hansel-gretel/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/hansel-gretel/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/hansel-gretel/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/hansel-gretel/reviews/)

## Contributors

 *   [ Chris ](https://profiles.wordpress.org/rodaine/)
 *   [ Taylor ](https://profiles.wordpress.org/taylor_cnp/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/hansel-gretel/)