Title: Breadcrumb Block Author: Phi Phan Published: 22 outubro, 2022 Last modified: 16 agosto, 2026 --- Pesquisar plugins ![](https://ps.w.org/breadcrumb-block/assets/icon.svg?rev=2802777) # Breadcrumb Block Por [Phi Phan](https://profiles.wordpress.org/mr2p/) [Baixar](https://downloads.wordpress.org/plugin/breadcrumb-block.1.1.1.zip) * [Detalhes](https://br.wordpress.org/plugins/breadcrumb-block/#description) * [Avaliações](https://br.wordpress.org/plugins/breadcrumb-block/#reviews) * [Instalação](https://br.wordpress.org/plugins/breadcrumb-block/#installation) * [Desenvolvimento](https://br.wordpress.org/plugins/breadcrumb-block/#developers) [Suporte](https://wordpress.org/support/plugin/breadcrumb-block/) ## Descrição This is a single-block plugin for the breadcrumb trail. It’s simple, lightweight, SEO-friendly, and WooCommerce compatibility. It also includes some simple separator icons. It works everywhere: Page Editor, Site Editor, and template files. ### How to customize the breadcrumb 1. How to change/remove an item? 2. ``` add_filter( 'breadcrumb_block_get_item', function ( $item_args, $context, $breadcrumbs_instance ) { // Ignore items without context. if ( ! $context || ! ( $context['object'] ?? false ) ) { return $item_args; } // Eg: remove a term. if ( 'term' === ( $context['type'] ?? '' ) && 'term-slug' === $context['object']->slug ) { return false; } // Eg: Change the title of a page. if ( 'page' === ( $context['type'] ?? '' ) && page_id_to_change === $context['object']->ID ) { $item_args[0] = 'Make it shorter'; } return $item_args; }, 10, 3 ); ``` 3. $item_args is a 3-item array: `[$item_label, $item_link, $item_attrs]` $context is an associative array: `['type' => 'item type', 'object' => 'item object']`.` type` can be one of the following values: `front_page`, `home`, `shop`, `page`,` post`, `single`, `term`, `taxonomy`, `post_type_archive`, `search`, `404`, `paged`,` author`, `date_year`, `date_month`, `date_day`, `attachment`. 4. How to change the markup of the block? 5. ``` add_filter( 'breadcrumb_block_get_breadcrumb_trail', function ( $markup, $args, $breadcrumbs_instance ) { return $markup; }, 10, 3 ); ``` 6. How to add or remove the items from the breadcrumb trail? 7. ``` add_filter( 'breadcrumb_block_get_items', function ( $items, $breadcrumbs_instance ) { return $items; }, 10, 2 ); ``` 8. How to use a custom separator for the breadcrumb trail? 9. ``` add_filter( 'breadcrumb_block_get_args', function ( $args ) { // For example, change separator. $args['separator'] = ''; return $args; } ); ``` 10. The custom separator should be an inline SVG. To make sure it displays properly, it should have three attributes: width, height, and fill. The values of these attributes should be as follows: `fill="currentColor" width="1em" height="1em"`. Using this hook, you can customize other attributes such as container, before, after, list_tag, item_tag, item_before, item_after, separator. 11. How to prepend the blog page to all single posts? 12. ``` add_action( 'breadcrumb_block_single_prepend', function ( $post, $breadcrumbs_instance ) { if ( 'post' === $post->post_type ) { $blog_id = get_option( 'page_for_posts'); if ( $blog_id ) { $breadcrumbs_instance->add_item( get_the_title( $blog_id ), get_permalink( $blog_id ) ); } } }, 10, 2 ); ``` If this plugin is useful for you, please do a quick review and [rate it](https://wordpress.org/support/plugin/breadcrumb-block/reviews/#new-post) on WordPress.org to help us spread the word. I would very much appreciate it. Please check out my other plugins if you’re interested: * **[Content Blocks Builder](https://wordpress.org/plugins/content-blocks-builder)**– Build custom layouts and blocks visually in the Block Editor without needing a code editor, using only core blocks and native Gutenberg features. * **[Meta Field Block](https://wordpress.org/plugins/display-a-meta-field-as-block)**– A single block to display custom fields in the Block Editor without coding. It supports ACF, MetaBox, WooCommerce, meta, rest field, shortcode and more. Works everywhere: in the Site Editor (FSE), the Block Editor, inside Query Loop, WooCommerce Product Collection, Term Query blocks, and even in template files. * **[SVG Block](https://wordpress.org/plugins/svg-block)** – A block to display SVG images as blocks. Useful for images, icons, dividers, and buttons. It allows you to upload SVG images and load them into the icon library. * **[Icon separator](https://wordpress.org/plugins/icon-separator)** – A tiny block just like the core/separator block but with the ability to add an icon. * **[Block Enhancements](https://wordpress.org/plugins/block-enhancements)** – Adds practical features to blocks like icons, box shadows, transforms, etc. * **[Counting Number Block](https://wordpress.org/plugins/counting-number-block)**– A block to display numbers with a counting effect * **[Better YouTube Embed Block](https://wordpress.org/plugins/better-youtube-embed-block)**– A block to solve the performance issue with embedded YouTube videos. It can also embed multiple videos and playlists. The plugin is developed using @wordpress/create-block. ## Capturas de tela [⌊Block settings⌉⌊Block settings⌉[ Block settings ## Blocos Este plugin disponibiliza 1 bloco. * Breadcrumb Block A simple breadcrumb trail block that supports JSON-LD structured data ## Instalação 1. Upload the plugin files to the `/wp-content/plugins` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the ‘Plugins’ screen in WordPress ## Perguntas frequentes ### What problem does this plugin solve? It provides a simple way to add a breadcrumb trail to your site. ### Who needs this plugin? Anyone can use this plugin. ## Avaliações ![](https://secure.gravatar.com/avatar/15fb84635c304663ee27a6654ad79fe11052aaa916919870cf4b4fc63f886db3? s=60&d=retro&r=g) ### 󠀁[Perfect for blocks based themes](https://wordpress.org/support/topic/perfect-for-blocks-based-themes/)󠁿 [Quentin Le Duff (–Q–)](https://profiles.wordpress.org/quentinldd/) 23 abril, 2026 3 respostas Excellent tiny plugin for gutenberg users ! 🙂 ![](https://secure.gravatar.com/avatar/a4cfe15d1dc6b602db7bd1ee9792d9e182c48f6b7b650374bf6731f9a77f4cdb? s=60&d=retro&r=g) ### 󠀁[Very satisfied](https://wordpress.org/support/topic/very-satisfied-200/)󠁿 [diloskitchen](https://profiles.wordpress.org/diloskitchen/) 8 agosto, 2025 1 resposta I use this plugin, but I had some difficulties at first. However, the programmer helped me and solved the problem. A big thank you! ![](https://secure.gravatar.com/avatar/fcbe7920199fe96befda397a2824d108a2c460092735e2f7078a146df3f18139? s=60&d=retro&r=g) ### 󠀁[Highly cistomizable](https://wordpress.org/support/topic/highly-cistomizable/)󠁿 [serge.k](https://profiles.wordpress.org/sergek-1/) 25 outubro, 2024 1 resposta The plugin is fantastic! A special thanks for the ‘How to Customize the Breadcrumb’ documentation—it was incredibly helpful. ![](https://secure.gravatar.com/avatar/165113b31107ddf357d6fc5dab56daee41b817824f525ad90a485bd10799b154? s=60&d=retro&r=g) ### 󠀁[PHP 8.2 or 8.3 support](https://wordpress.org/support/topic/php-8-2-or-8-3-support/)󠁿 [jaybharat1](https://profiles.wordpress.org/jaybharat1/) 10 setembro, 2024 1 resposta Please tell me Does this plugin support PHP 8.2 or 8.3? ![](https://secure.gravatar.com/avatar/bd8cdcc413a33fc79837a064dd2a95bef1de42becff0a4203c822cd014e6d9b5? s=60&d=retro&r=g) ### 󠀁[Excellent](https://wordpress.org/support/topic/excellent-13241/)󠁿 [Hans Joerg Klemenz](https://profiles.wordpress.org/hjklemenz/) 3 fevereiro, 2024 1 resposta Does exactly what I expected – without superfluous features. It works very well. Thank you. ![](https://secure.gravatar.com/avatar/0d8fe5ecc8e3f648fc990c8d7f98a692b963fc91c0d9436eb7dd5faaa5c0c1ab? s=60&d=retro&r=g) ### 󠀁[Works beautifully, great support!](https://wordpress.org/support/topic/works-beautifully-great-support-2/)󠁿 [Jim True](https://profiles.wordpress.org/jimtrue/) 8 novembro, 2023 1 resposta This just works, beautifully. Does exactly what you need and with filters, you can customize it quite easily. Great support as well. Highly recommend. [ Leia todas as 14 avaliações ](https://wordpress.org/support/plugin/breadcrumb-block/reviews/) ## Colaboradores e desenvolvedores “Breadcrumb Block” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin. Colaboradores * [ Phi Phan ](https://profiles.wordpress.org/mr2p/) Breadcrumb Block” foi traduzido para 3 localidades. Agradecemos aos [tradutores](https://translate.wordpress.org/projects/wp-plugins/breadcrumb-block/contributors) por suas contribuições. [Traduzir o “Breadcrumb Block” para seu idioma.](https://translate.wordpress.org/projects/wp-plugins/breadcrumb-block) ### Interessado no desenvolvimento? [Navegue pelo código](https://plugins.trac.wordpress.org/browser/breadcrumb-block/), consulte o [repositório SVN](https://plugins.svn.wordpress.org/breadcrumb-block/) ou assine o [registro de desenvolvimento](https://plugins.trac.wordpress.org/log/breadcrumb-block/) por [RSS](https://plugins.trac.wordpress.org/log/breadcrumb-block/?limit=100&mode=stop_on_copy&format=rss). ## Registro de alterações #### 1.1.1 _Release Date – 07 May 2026_ * Improved – Updated instpector control style #### 1.1.0 _Release Date – 24 November 2025_ * Improved – Revamped inspector settings and added more sepaprator icons * Added – UI for inputting labels * Added – Support for shadow #### 1.0.16 _Release Date – 16 January 2025_ * Changed – Updated placeholder texts to be more meaningful (props [rafaelvolpi](https://github.com/rafaelvolpi)). #### 1.0.15 _Release Date – 28 October 2024_ * Added – Support clientNavigation interactivity * Updated – Replace classnames with clsx * Updated – Tested up to WP 6.7 #### 1.0.14 _Release Date – 07 May 2024_ * Added – Add the breadcrumbs instance to the `breadcrumb_block_get_item` hook * Added – Add the new hook `breadcrumb_block_single_prepend` * Improved – Add the commented text to remove the output not escaped warning #### 1.0.13 _Release Date – 30 April 2024_ * Added – A new hook `breadcrumb_block_get_item` for customizing/removing each item of the breadcrumbs #### 1.0.12 _Release Date – 22 September 2023_ * Added – A new hook `breadcrumb_block_get_args` for customizing the output of the breadcrumb. #### 1.0.11 _Release Date – 12 August 2023_ * DEV – Refactor block metadata and upgrade to apiVerion 3 * DEV – Add a hook `apply_filters( 'breadcrumb_block_strip_shortcodes', false, $breadcrumb_instance )` to allow opt-in/opt-out shortcodes in the post title. Thanks to Steven A. Zahm (https://github.com/shazahm1) * DEV – Add parent crumbs to other hierarchical post types. Thanks to Steven A. Zahm (https://github.com/shazahm1) * DEV – Add a hook `apply_filters( 'breadcrumb_block_add_post_type_name', true, $post, $breadcrumb_instance )` to allow opt-in/opt-out post type name for custom post types * Fix – Conflict style with Bootstrap’s breadcrumb #### 1.0.10 _Release Date – 13 Apr 2023_ * DEV – Add a setting to input a custom home text #### 1.0.9 _Release Date – 24 Mar 2023_ * FIX – Error converting WP_Post_Type to string. Thanks to @tnchuntic for reporting it. #### 1.0.8 _Release Date – 20 Mar 2023_ * DEV – Make the block compatible with woocommerce #### 1.0.7 _Release Date – 11 Mar 2023_ * FIX – Add namespace to class_exists check #### 1.0.6 _Release Date – 12 Feb 2023_ * Add new hooks `breadcrumb_block_home_text`, `breadcrumb_block_home_url` #### 1.0.5 _Release Date – 05 Feb 2023_ * DEV – Add a setting to hide the home page link #### 1.0.4 _Release Date – 19 Jan 2023_ * FIX – Gap issue: adding the semicolon to the CSS variable * FIX – Could not modify breadcrumb data via the `breadcrumb_block_get_items` filter * DEV – Add a new arrow icon as a separator #### 1.0.3 _Release Date – 13 Dec 2022_ * DEV – Use post_type->labels->name instead of post_type->labels->singular_name for custom post type archive name * DEV – Add http://schema.org as @context for structured data * Note: Big thanks to [Yannick](https://wordpress.org/support/users/ja4st3r) for this release #### 1.0.2 _Release Date – 08 Dec 2022_ * DEV – Add a setting to hide the current page title #### 1.0.1 _Release Date – 01 Dec 2022_ * FIX – Syntax error on PHP version 7.0.0 #### 1.0.0 _Release Date – 22 Oct 2022_ ## Meta * Versão **1.1.1** * Última atualização **14 horas atrás** * Instalações ativas **3.000+** * Versão do WordPress ** 5.9 ou superior ** * Testado até **7.1** * Versão do PHP ** 7.0 ou superior ** * Idiomas * [English (US)](https://wordpress.org/plugins/breadcrumb-block/), [Polish](https://pl.wordpress.org/plugins/breadcrumb-block/), [Spanish (Chile)](https://cl.wordpress.org/plugins/breadcrumb-block/) e [Spanish (Spain)](https://es.wordpress.org/plugins/breadcrumb-block/). * [Traduzir para seu idioma](https://translate.wordpress.org/projects/wp-plugins/breadcrumb-block) * Tags * [block](https://br.wordpress.org/plugins/tags/block/)[breadcrumb](https://br.wordpress.org/plugins/tags/breadcrumb/) [gutenberg](https://br.wordpress.org/plugins/tags/gutenberg/)[menu](https://br.wordpress.org/plugins/tags/menu/) [navigation](https://br.wordpress.org/plugins/tags/navigation/) * [Visualização avançada](https://br.wordpress.org/plugins/breadcrumb-block/advanced/) ## Classificações 5 de 5 estrelas. * [ 14 avaliações com 5 estrelas ](https://wordpress.org/support/plugin/breadcrumb-block/reviews/?filter=5) * [ 0 avaliação com 4 estrela ](https://wordpress.org/support/plugin/breadcrumb-block/reviews/?filter=4) * [ 0 avaliação com 3 estrela ](https://wordpress.org/support/plugin/breadcrumb-block/reviews/?filter=3) * [ 0 avaliação com 2 estrela ](https://wordpress.org/support/plugin/breadcrumb-block/reviews/?filter=2) * [ 0 avaliação com 1 estrela ](https://wordpress.org/support/plugin/breadcrumb-block/reviews/?filter=1) [Sua avaliação](https://wordpress.org/support/plugin/breadcrumb-block/reviews/#new-post) [Ver todas avaliações](https://wordpress.org/support/plugin/breadcrumb-block/reviews/) ## Colaboradores * [ Phi Phan ](https://profiles.wordpress.org/mr2p/) ## Suporte Tem algo a dizer? Precisa de ajuda? [Ver fórum de suporte](https://wordpress.org/support/plugin/breadcrumb-block/) ## Doar Gostaria de contribuir para o desenvolvimento deste plugin? [ Doe para este plugin ](https://boldblocks.net?utm_source=wp.org&utm_campaign=readme&utm_medium=link&utm_content=Breadcrumb+Block+Donate)