{"id":26950,"date":"2013-12-28T00:51:16","date_gmt":"2013-12-28T00:51:16","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/instant-breadcrumbs\/"},"modified":"2014-08-08T01:08:01","modified_gmt":"2014-08-08T01:08:01","slug":"instant-breadcrumbs","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/instant-breadcrumbs\/","author":13159498,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.4.5","stable_tag":"1.4.5","tested":"3.9.40","requires":"3.0.0","requires_php":"","requires_plugins":"","header_name":"Instant Breadcrumbs","header_author":"Chris Nash","header_description":"","assets_banners_color":"bc8d53","last_updated":"2014-08-08 01:08:01","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/loseyourmarbles.co\/instant-breadcrumbs\/contribute","header_plugin_uri":"http:\/\/loseyourmarbles.co\/instant-breadcrumbs","header_author_uri":"http:\/\/loseyourmarbles.co\/about-me","rating":3.7,"author_block_rating":0,"active_installs":300,"downloads":35005,"num_ratings":3,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.4.5":"<ul>\n<li>Translations for French, Serbian, and Spanish.<\/li>\n<\/ul>","1.4.4":"<p>Compatibility improvement for more third-party plugins and themes. Should improve breadcrumb behavior if used in footers.<\/p>","1.4.3":"<p>Bug fix for sites that have a static page set as their front page. Compatibility with third-party plugins.<\/p>","1.4.2":"<p>Compatibility release, verifying with WordPress 3.9 and latest third-party plugins.<\/p>","1.4.1":"<p>New settings option to enable\/disable the automatic breadcrumb in the menu. Enabled by default.<\/p>","1.4":"<p>Large theme compatibility improvements and performance enhancements.<\/p>","1.3.1":"<p>Improved theme compatibility for themes such as Modernize.<\/p>","1.3":"<p>Bug fixes for post hierarchies, category selection, current URL and language search path. Support for non-standard themes. New breadcrumb widget.<\/p>","1.2.1":"<p>Bug fixes for HTML tags included in post titles.<\/p>","1.1":"<p>If breadcrumbs do not appear or have missing titles, you should upgrade for these bug fixes.<\/p>","1.0":"<p>Initial release.<\/p>"},"ratings":{"1":"1","2":0,"3":0,"4":0,"5":"2"},"assets_icons":[],"assets_banners":{"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"829313","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.2","1.2.1","1.3","1.3.1","1.4","1.4.1","1.4.2","1.4.3","1.4.4","1.4.5"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"829300","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"829300","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"829300","resolution":"3","location":"assets"},"screenshot-4.png":{"filename":"screenshot-4.png","revision":"829300","resolution":"4","location":"assets"},"screenshot-5.png":{"filename":"screenshot-5.png","revision":"829300","resolution":"5","location":"assets"}},"screenshots":{"1":"A screenshot of Instant Breadcrumbs generated on a blog post in TwentyFourteen, showing the\nbreadcrumb trail for the current post, including the post category. This is without any theme editing;","2":"The exact same blog in TwentyTwelve, no theme editing;","3":"... and in TwentyThirteen, again without theme editing;","4":"The same page in TwentyFourteen on a smaller display, showing the breadcrumb trail automatically\nstyles with the navigation menu;","5":"The breadcrumb trail for a page that already appears in the nav menu, reusing the existing link."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2752,175,1865,1753],"plugin_category":[43],"plugin_contributors":[79999],"plugin_business_model":[],"class_list":["post-26950","plugin","type-plugin","status-publish","hentry","plugin_tags-breadcrumbs","plugin_tags-links","plugin_tags-menu","plugin_tags-navigation","plugin_category-customization","plugin_contributors-loseyourmarbles","plugin_committers-loseyourmarbles"],"banners":{"banner":"https:\/\/ps.w.org\/instant-breadcrumbs\/assets\/banner-772x250.jpg?rev=829313","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/instant-breadcrumbs_bc8d53.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/instant-breadcrumbs\/assets\/screenshot-1.png?rev=829300","caption":"A screenshot of Instant Breadcrumbs generated on a blog post in TwentyFourteen, showing the\nbreadcrumb trail for the current post, including the post category. This is without any theme editing;"},{"src":"https:\/\/ps.w.org\/instant-breadcrumbs\/assets\/screenshot-2.png?rev=829300","caption":"The exact same blog in TwentyTwelve, no theme editing;"},{"src":"https:\/\/ps.w.org\/instant-breadcrumbs\/assets\/screenshot-3.png?rev=829300","caption":"... and in TwentyThirteen, again without theme editing;"},{"src":"https:\/\/ps.w.org\/instant-breadcrumbs\/assets\/screenshot-4.png?rev=829300","caption":"The same page in TwentyFourteen on a smaller display, showing the breadcrumb trail automatically\nstyles with the navigation menu;"},{"src":"https:\/\/ps.w.org\/instant-breadcrumbs\/assets\/screenshot-5.png?rev=829300","caption":"The breadcrumb trail for a page that already appears in the nav menu, reusing the existing link."}],"raw_content":"<!--section=description-->\n<p>Instant Breadcrumbs adds a breadcrumb trail to your WordPress blog's primary navigation menu. No theme editing required!\nIncluding a breadcrumb trail on your site not only makes it easier for visitors to navigate your site, but also allows\nsearch engines to better explore your blog and include the breadcrumb information in rich snippet data in search\nresults. Many breadcrumb plugins exist, but normally require either theme editing, or use of a theme that is already\ncustomized to include the breadcrumb function. In addition, editing the theme is usually followed by some CSS\nstyling to make the breadcrumb trail match the overall 'look' of the site.<\/p>\n\n<p>Instant Breadcrumbs takes a different approach. Since breadcrumbs are a navigation aid, the generated trail is\nautomatically added to the front of your existing primary navigation menu. This allows it to not only function\nstraight out of the box with a large number of themes, but also use the existing styling of your primary navigation\nmenu.<\/p>\n\n<p>A quick overview of Instant Breadcrumbs features:<\/p>\n\n<ul>\n<li>Works with both custom primary menus and the default 'page' menu generated by WordPress;<\/li>\n<li>Produces RDFa-compliant breadcrumb trails that may be used by Google and others in search results;<\/li>\n<li>Supports customization of the breadcrumb titles for pages such as the front page, archives, and search;<\/li>\n<li>Re-uses existing top-level entries in the primary menu to avoid repeated links;<\/li>\n<li>Includes CSS classes for added breadcrumbs for optional further styling if desired;<\/li>\n<li>Use the built-in breadcrumb generator, or third-party generators such as Yoast (<a href=\"http:\/\/wordpress.org\/plugins\/wordpress-seo\/\">WordPress SEO<\/a>)\nand <a href=\"http:\/\/wordpress.org\/plugins\/breadcrumb-navxt\/\">Breadcrumb NavXT<\/a>, adding those to the nav menu without theme editing. Tested against\nBreadcrumb NavXT 5.1.0 and WordPress SEO 1.5.4.2;<\/li>\n<li>Supports HTML markup in post titles, with the option to disable it;<\/li>\n<li>\"Manual\" mode allows insertion into templates for themes that do not use the WordPress primary navigation menu;<\/li>\n<li>A widget is available if you would prefer to show the breadcrumb trail in a sidebar.<\/li>\n<\/ul>\n\n<p>Visit the <a href=\"http:\/\/loseyourmarbles.co\/instant-breadcrumbs\">Plugin Blog Page<\/a> if you have a comment or suggestion for the next update of the plugin!\nIf Instant Breadcrumbs is useful to you, please consider making a small contribution via <a href=\"http:\/\/loseyourmarbles.co\/instant-breadcrumbs\/contribute\">Flattr<\/a> to help support\nthe continued development and improvement of this plugin, or leave a review at the <a href=\"http:\/\/wordpress.org\/plugins\/instant-breadcrumbs\/\">WordPress Plugin Directory<\/a>.<\/p>\n\n<h4>Translations<\/h4>\n\n<p>The Instant Breadcrumbs plugin is currently translated into the following languages:<\/p>\n\n<ul>\n<li>es_ES: Espa\u00f1ol<\/li>\n<li>fr_FR: Fran\u00e7ais<\/li>\n<li>sr_RS: Srpski jezik<\/li>\n<\/ul>\n\n<p>Spanish translation provided by Andrew Kurtis of <a href=\"http:\/\/www.webhostinghub.com\/\">WebHostingHub<\/a>.\nSerbian translation provided by Ogi Djuraskovic of <a href=\"http:\/\/firstsiteguide.com\/\">FirstSiteGuide<\/a>.<\/p>\n\n<p>All other translations courtesy of the continued hard work of the <a href=\"http:\/\/wp-translations.org\/\">WP-Translations<\/a> team. This plugin is proud to be a part of the\nWP-Translations community. If you would like to make translation contributions, please visit the <a href=\"http:\/\/transifex.com\/projects\/p\/instant-breadcrumbs\">translation dashboard on Transifex<\/a>.<\/p>\n\n<p>Banner image is <a href=\"http:\/\/www.flickr.com\/photos\/shinyredtype\/5692770225\/in\/photostream\/\">Trail of (gluten-free) bread crumbs<\/a> by <a href=\"http:\/\/www.flickr.com\/photos\/shinyredtype\/\">Kat Selvocki<\/a> and\nused here under <a href=\"http:\/\/creativecommons.org\/licenses\/by-nc-nd\/2.0\/\">CC BY-NC-ND 2.0<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Unzip and upload the <code>instant-breadcrumbs<\/code> directory to the <code>\/wp-content\/plugins\/<\/code> directory;<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress;<\/li>\n<li>Optionally change settings values in the 'Breadcrumbs' settings page, listed under 'Appearance';<\/li>\n<li>If using a supported breadcrumb plugin as generator, customize that plugin settings;<\/li>\n<li>Optionally add custom CSS, although the plugin is designed to work without theme editing;<\/li>\n<li>If your theme does not have a primary navigation menu, insert <code>&lt;?php instant_breadcrumb(); ?&gt;<\/code> into your theme.\nYou may pass optional HTML as a first parameter to separate items, and pass <code>true<\/code> as a second parameter if you\nwish to return the result rather than write it directly to the page. It is strongly recommended that you perform\nyour own CSS styling in manual mode;<\/li>\n<li>If you prefer, you may include the breadcrumb trail in a widget. Go to the 'Widgets' submenu (under 'Appearance' in the\nWordPress admin) and drag the Instant Breadcrumbs widget to the appropriate position. You may set a title and optional\nseparator HTML. As above, it is recommended you apply your own CSS styling.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>Which themes does the plugin support?<\/dt>\n<dd><p>Instant Breadcrumbs is designed to work with \"generic\" WordPress blog themes. In other words, these\nare basic themes which have a header that calls <code>wp_nav_menu<\/code> in their header to include a\nmenu (or a menu based on your static pages, if no menu has been defined). The default themes that\nship with each WordPress installation are good examples, as are most \"general purpose\" blogging\nthemes. The plugin is intended to provide easy breadcrumb functionality for basic blogging, and will\nattempt to identify the first menu on the web page.<\/p><\/dd>\n<dt>Breadcrumbs are not showing, or are in the wrong menu?<\/dt>\n<dd><p>Instant Breadcrumbs attempts to find the first menu in your theme, and add the trail there. For some\nthemes the menu may be difficult to identify, or the first menu is not the ideal position. In these\ncases, you may manually specify a theme location in the Instant Breadcrumbs settings. The value here\nshould match the <code>theme_location<\/code> in the relevant <code>wp_nav_menu<\/code> call in your theme header. Leave this\nblank to allow Instant Breadcrumbs to automatically find the first one.<\/p>\n\n<p>If your web site is highly customized, and your theme contains its own custom code to generate\nmenus or navigation, then it's likely that Instant Breadcrumbs may not be called when your site\nis displayed. In this case, you can revert to theme editing and call <code>instant_breadcrumb()<\/code> manually\nto insert the breadcrumb trail at an appropriate location in your theme. You can optionally insert\nHTML between the breadcrumb elements, and you should perform your own CSS styling. Alternatively,\nyou may insert the supplied widget in an appropriate location.<\/p><\/dd>\n<dt>I don't want the breadcrumb trail automatically adding itself to my menu.<\/dt>\n<dd><p>The automatic addition of breadcrumbs to the main menu is not for everyone. It may not suit your\nexisting menu items, or perhaps you would prefer a more traditional breadcrumb display somewhere\nelse in your layout. The automatic mode is the default in Instant Breadcrumbs, but you may disable\nit in the Breadcrumbs settings page (under Appearance). If you are using the widget method, or\nmanually editing your template PHP, it is recommended you disable automatic mode.<\/p><\/dd>\n<dt>Will settings remain if I upgrade the plugin?<\/dt>\n<dd><p>The plugin is designed to keep your settings from one installed version to the next. If the upgraded\nversion has new settings, they will be set to sensible defaults. You should verify these new settings\nafter an upgrade. Your old settings should still be preserved.<\/p><\/dd>\n<dt>My home page appears twice in the modified menu?<\/dt>\n<dd><p>Instant Breadcrumbs will reuse menu items wherever possible, for example when viewing a page that is\nalready in the top-level menu. However it cannot reuse a menu item link if doing so would mean the\ngenerated breadcrumbs are no longer in order. The usual example of this is if the home page already\nappears in the primary menu. The generated breadcrumb trail requires the home link to be first. The\neasiest workaround for this is simply to customize your menu so the home page is not included a\nsecond time.<\/p><\/dd>\n<dt>How can I apply custom CSS to the added breadcrumbs?<\/dt>\n<dd><p>The Instant Breadcrumbs plugin adds the CSS class <code>ib-crumb<\/code> to the <code>li<\/code> element of any breadcrumbs in\nthe menu, and <code>ib-lastcrumb<\/code> to the last link in the breadcrumb trail representing the current page.\nFurthermore, the class <code>ib-added<\/code> is added to the <code>li<\/code> element of new menu items created by the plugin,\nand <code>ib-edited<\/code> to existing menu items. These may be styled in your theme's <code>style.css<\/code> should for\ninstance you would like breadcrumb items to be highlighted in a different color.<\/p>\n\n<p>Some useful examples: <code>.ib-crumb {display:inline;}<\/code> will display your breadcrumb trail in a single line\nif you are using PHP or the widget to display the trail. A more complex one is <code>.ib-crumb+.ib-crumb:before {content:\"&gt;\";}<\/code>\nwhich will add the additional arrow as a separator between consecutive breadcrumbs.<\/p><\/dd>\n<dt>Why do HTML characters such as &lt;, &gt;, and &amp; appear incorrectly in the output?<\/dt>\n<dd><p>If your post title includes these characters, be sure to escape them correctly (for example\nas <code>&amp;lt;<\/code>, <code>&amp;gt;<\/code>, and <code>&amp;amp;<\/code>). Otherwise they may be rendered incorrectly at any time they may appear on the Web\npage, including in the breadcrumb trail. This is nothing particular about Instant Breadcrumbs, but all\nbreadcrumb generators, and Web pages in general, behave similarly. As of version 1.2, you may include HTML markup in\nyour post titles, such as <code>&lt;em&gt;for emphasis&lt;\/em&gt;<\/code>, and the Instant Breadcrumb trail will optionally\ninclude it in the breadcrumb as well. This option is enabled by default. Disabling it will use\ntext only in each crumb.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.4.5<\/h4>\n\n<ul>\n<li><em>NEW<\/em> Translations for French, Serbian, and Spanish.<\/li>\n<li>Compatibility verification for WordPress 3.9.2 and latest development versions of WordPress SEO and Breadcrumb NavXT.<\/li>\n<\/ul>\n\n<h4>1.4.4<\/h4>\n\n<ul>\n<li><em>FIX<\/em> Made built-in generator more robust with more plugins and themes. Should improve function when breadcrumbs are used in footers. (Thanks to Krishna Roy).<\/li>\n<li>Compatibility verification for WordPress 3.9.1, WordPress SEO 1.5.4.2, and Breadcrumb NavXT 5.1.0.<\/li>\n<\/ul>\n\n<h4>1.4.3<\/h4>\n\n<ul>\n<li><em>FIX<\/em> Use the static page title if <code>show_on_front<\/code> is set to <code>page<\/code>. Better for multilingual sites. (Thanks to luoshiben).<\/li>\n<li>Compatibility verification for WordPress SEO 1.5.2.8.<\/li>\n<li>Compatibility modifications for forthcoming Breadcrumb NavXT changes.<\/li>\n<\/ul>\n\n<h4>1.4.2<\/h4>\n\n<ul>\n<li>Compatibility verification for WordPress 3.9 and WordPress SEO 1.5.2.7.<\/li>\n<\/ul>\n\n<h4>1.4.1<\/h4>\n\n<ul>\n<li><em>NEW<\/em> Added setting in the Appearance\/Breadcrumb menu to control automatic addition of the trail to the menu.<\/li>\n<\/ul>\n\n<h4>1.4<\/h4>\n\n<ul>\n<li><em>FIX<\/em> Cleanup empty placeholder HTML elements, such as when the breadcrumb trail is inserted before an empty menu.<\/li>\n<li><em>NEW<\/em> Automatically detect the first navigation menu in a theme and apply the breadcrumb there. Improves theme compatibility.<\/li>\n<li><em>NEW<\/em> Optionally specify a theme location of a menu, to allow breadcrumbs to appear in menus other than primary.<\/li>\n<li>Performance improvements.<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li><em>FIX<\/em> Improved theme compatibility, supporting more menu theme locations. Plugin should now work with Modernize. (Thanks to Arun Nair).<\/li>\n<\/ul>\n\n<h4>1.3<\/h4>\n\n<ul>\n<li><em>FIX<\/em> Corrected the order of hierarchical post types in the breadcrumb.<\/li>\n<li><em>FIX<\/em> Changed category selection to use count, rather than term order.<\/li>\n<li><em>FIX<\/em> Corrected a bug in the current URL lookup when using Yoast or NavXT.<\/li>\n<li><em>FIX<\/em> Corrected the search path for language translation files.<\/li>\n<li><em>NEW<\/em> Support for manual insertion of a breadcrumb trail into a theme with a PHP call.<\/li>\n<li><em>NEW<\/em> Added a widget to allow the user to insert and display the breadcrumb trail in a sidebar.<\/li>\n<li>Readme and FAQ updates.<\/li>\n<li>Link to contribute to the plugin development via Flattr.<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li><em>FIX<\/em> HTML tags in post titles now handled correctly, for both built-in and external breadcrumb generators.<\/li>\n<li><em>NEW<\/em> Option to optionally strip HTML tags from the generated titles.<\/li>\n<li>Updated test environment to WordPress 3.8.1, WordPress SEO 1.4.24, and Breadcrumb NavXT 5.0.1.<\/li>\n<li>Small readme and FAQ updates.<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li><em>FIX<\/em> Corrected an issue where breadcrumb titles could be empty. Use defaults in this case.<\/li>\n<li><em>FIX<\/em> Enable the breadcrumbs to appear even if the navigation menu or page list are empty.<\/li>\n<li><em>NEW<\/em> Supports Yoast and Breadcrumb NavXT breadcrumb trails.<\/li>\n<li><em>NEW<\/em> Added more CSS classes to be compliant with <code>wp_nav_menu<\/code> item styling.<\/li>\n<li>Display default values for breadcrumb titles in the settings page.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Instant Breadcrumbs adds a breadcrumb trail to your WordPress blog&#039;s primary navigation menu. No theme editing required!","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/26950","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=26950"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/loseyourmarbles"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=26950"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=26950"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=26950"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=26950"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=26950"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=26950"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}