=== Breadcrumb Widget Pro ===
Contributors: tcoder
Tags: breadcrumb, elementor widget, elementor addon, elementor breadcrumb, breadcrumb widget
Requires at least: 6.1
Stable tag: 1.1.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. Each item can optionally show an icon before its label (from Elementor's icon library), and you can hide the text so only the icon shows.

= 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.

= Collapse / Dropdown =
– Turn on "Collapse Long Trails into a Dropdown" to keep long trails compact: the first item and a set number of trailing items (including the current page) stay visible, and everything in between collapses behind a "…" button. Clicking it opens a dropdown listing the hidden items. Set "Max Visible Items" to control how many crumbs show before it collapses.

== Style settings ==

– **Skin** — five ready-made, eye-catching looks (Pill Chips, Gradient Bar, Underline Sweep, Glass Card, Arrow Ribbon), or "None" to use the manual style controls below.
– **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.
– **Item Icons** — (manual trail mode) size, color, and gap for the per-item icons.
– **Dropdown** — (shown when the dropdown collapse is enabled) toggle color, menu background, menu text color, and item hover background.

== 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.1.0 =
* New: 5 ready-made Skins (Pill Chips, Gradient Bar, Underline Sweep, Glass Card, Arrow Ribbon) — pick one from Style > Skin.
* New: "Collapse Long Trails into a Dropdown" — long trails collapse the middle items behind a "…" toggle that opens a dropdown menu.
* New: Dropdown style controls (toggle color, menu background/text/hover colors).
* New: manual trail items can show an icon before the label (Elementor icon library), with an option to hide the text and show icon-only.
* New: "Item Icons" style section for per-item icon size, color, and spacing.

= 1.0.0 - 06/09/2026 =
* Initial release

== Upgrade Notice ==
= 1.1.0
Adds ready-made skins and an optional collapsible dropdown for long breadcrumb trails.
Manual trail items can now show an icon before (or instead of) their label.
= 1.0.0
Initial release