=== Breadcrumb Widget Pro ===
Contributors: tcoder
Tags: breadcrumb, elementor widget, elementor addon, elementor breadcrumb, breadcrumb widget
Requires at least: 6.1
Stable tag: 1.0.0
Tested up to: 7.1
Requires PHP: 7.4
License: GPL v3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html


A custom Elementor widget that adds a fully customizable breadcrumb trail to any page.


== Description ==

= Breadcrumb Trail =
– **Trail Mode: Automatic** — builds the trail from the current post, page, or WooCommerce product context automatically. Choose the source explicitly (Post / Page / Product) or leave it on "Auto-detect."
  – Toggle "Show Category" to include the post/product category (with parent categories) in the trail.
  – Toggle "Show Parent Pages" to include ancestor pages for hierarchical Pages.
  – Toggle "Show Current Item" to include/exclude the current page title as the last crumb.
– **Trail Mode: Manual** — add, reorder, or remove trail items yourself in the repeater. Leave the last item's link empty, and it becomes the non-clickable "current" item.

= Home Link =
– Rename the label, set a custom URL, and optionally show an icon before (or instead of) the text.

= Separator =
– Text/symbol (e.g.,`>`, `/`, `•`), an icon from Elementor's icon library, or an uploaded SVG.

= SEO =
– Toggle JSON-LD `BreadcrumbList` structured data output (on by default) — helps Google show your breadcrumb trail directly in search results.

== Style settings ==

– **Layout** — space between items, alignment.
– **Typography** — font family/weight/size/color for items, plus a separate color for the current (non-link) item.
– **Links** — link color, hover color, hover underline on/off.
– **Separator** — color and size (works for text, icon, and SVG).
– **Item Box** — background color, padding, border (style/width/color), border radius, and box shadow — useful if you want each crumb to look like a small pill/chip.

== Notes on the SVG separator option ==

WordPress blocks SVG uploads by default for security (an SVG can carry embedded script). This plugin re-enables SVG uploads in the Media Library so the "Custom SVG Upload" separator option works. Only give Media Library upload access to trusted admins/editors. If you'd rather not loosen this site-wide, remove the `upload_mimes` filter in `breadcrumb-widget-pro.php` and instead install a dedicated SVG-sanitizing plugin (e.g., "Safe SVG") — the widget's Media control will still work with whatever SVG upload path you use.

== Screenshots ==
1. Multiple Sources and Flexible Controls
2. Beautiful Breadcrumbs, Your Way

== Installation ==

= Installation =
1. Zip the `breadcrumb-widget-pro` folder if it isn't already (this download is already zipped).
2. WordPress Admin → Plugins → Add New → Upload Plugin → choose the zip → Install → Activate.
3. Requires **Elementor** (the free version is enough) to be active.
4. Edit any page with Elementor, search for **"Breadcrumbs Pro"** in the widget panel, and drag it in.

== Frequently Asked Questions ==
* For more questions or help, [contact me](info@tcoderbd.com)
* About Author [Touhidul Sadeek](https://github.com/touhidbd)

== Changelog ==
= 1.0.0 - 09/08/2026 =
* Initial release

== Upgrade Notice ==
= 1.0.0