Breadcrumbs

Breadcrumb‌ها بخش ضروری ناوبری وبسایت هستند که یک مسیر واضح برای پیمایش در سلسله‌مراتب سایت به کاربران ارائه می‌دهند. با کمک به کاربران برای دانستن موقعیتشان در سایت و بازگشت آسان به صفحات قبلی، تجربه کاربری کلی را بهبود می‌بخشند.

المان Breadcrumbs آیتم‌های breadcrumb مختلفی بسته به نوع صفحه مورد مشاهده تولید می‌کند.

از انواع مختلف صفحه پشتیبانی می‌کند، از جمله پست‌ها یا صفحات تکی (is_singular())، صفحه اصلی (is_home())، دسته‌بندی‌ها (is_category())، taxonomy‌ها (is_tax())، آرشیوهای post type (is_post_type_archive())، برچسب‌ها (is_tag())، آرشیوهای تاریخ (is_date())، صفحات نویسنده (is_author())، نتایج جستجو (is_search()) و صفحات خطا (is_404()).

تنظیمات

• Gap (number with units) — فاصله بین آیتم‌های breadcrumb. خاصیت gap را کنترل می‌کند.

ساختار (Structure)

این بخش به شما اجازه می‌دهد ساختار آیتم‌های breadcrumb را سفارشی‌سازی کنید. در حال حاضر از صفحات تکی و آرشیو تاریخ پشتیبانی می‌کند.

ساختار آرشیو تاریخ

ساختار صفحه تکی

به‌طور پیش‌فرض، Bricks آیتم‌های breadcrumb را به شکل زیر نمایش می‌دهد:

برای پست‌ها:
Home > دسته‌بندی‌های والد (در صورت وجود) > دسته‌بندی (در صورت وجود) > پست‌های والد (در صورت وجود) > پست جاری

برای انواع پست دیگر:
Home > آرشیو پست > پست‌های والد (در صورت وجود) > پست جاری

می‌توانید ساختار breadcrumb را برای انواع پست مختلف سفارشی‌سازی کنید. همچنین می‌توانید چندین نوع پست را با هم گروه‌بندی کنید اگر می‌خواهید ساختار یکسانی داشته باشند. هر نوع پستی که در ساختارهای سفارشی شما به‌طور خاص تعریف نشده باشد به‌طور خودکار از ساختار پیش‌فرض استفاده می‌کند.

مثال ۱:
برای صفحه تکی نوع پست Tanks، می‌خواهم آرشیو نوع پست و taxonomy سفارشی را به‌عنوان آیتم‌های breadcrumb نمایش دهم.

مثال ۲:
برای صفحه تکی محصولات، می‌خواهم taxonomy سفارشی را به‌عنوان آیتم‌های breadcrumb نمایش دهم.

• Post types (repeater) — ساختارهای breadcrumb سفارشی برای نوع پست‌های خاص تعریف کنید.
• Post types (select, multiple) — نوع پست‌هایی که این ساختار روی آن‌ها اعمال می‌شود را انتخاب کنید. گزینه‌ها: نوع پست‌های ثبت‌شده. پیش‌فرض: Posts.
• Hide current post (checkbox) — پست جاری را از breadcrumb‌ها مخفی کنید.
• Show parent posts (checkbox) — پست‌های والد را در سلسله‌مراتب نمایش دهید.
• Show post type archive (checkbox) — لینک آرشیو نوع پست را نمایش دهید.
• Show taxonomy (checkbox) — taxonomy را در breadcrumb‌ها نمایش دهید.
• Taxonomy slug (text) — slug taxonomy برای نمایش. هنگامی‌که Show taxonomy فعال است الزامی‌است. پیش‌فرض: «category».
• Taxonomy info (info) — فقط اولین term اختصاص‌یافته نمایش داده خواهد شد. فقط وقتی Show taxonomy فعال است نمایش داده می‌شود.

• Show parent terms (checkbox) — term‌های والد را در سلسله‌مراتب نمایش دهید. فقط وقتی اولین term اختصاص‌یافته یک term فرزند باشد کار می‌کند.

• Add context (checkbox) — context را به تاریخ‌ها در قالب‌های آرشیو اضافه کنید.

خانه (Home)

در این بخش می‌توانید آیتم root (خانه) مسیر breadcrumb را سفارشی‌سازی کنید. URL را تنظیم کنید، متن برچسب را تغییر دهید، یک آیکون انتخاب کنید و موقعیت آیکون را تعیین کنید.

• URL (text) — URL سفارشی برای لینک خانه. پیش‌فرض: URL خانه.

• Text (text) — برچسب برای لینک خانه. پیش‌فرض: «Home».

• Icon (icon) — آیکون برای لینک خانه.

• Icon: Gap (number with units) — فاصله بین آیکون خانه و برچسب. فقط وقتی Icon تنظیم شده در دسترس است.

• Icon: Position (select) — موقعیت آیکون خانه. گزینه‌ها: Before، After. پیش‌فرض: Before. فقط وقتی Icon تنظیم شده در دسترس است.

• Hide label (checkbox) — برچسب خانه را هنگام وجود آیکون مخفی کنید. فقط وقتی Icon تنظیم شده در دسترس است.

جداکننده (Separator)

اینجا می‌توانید ظاهر و رفتار جداکننده‌ها بین لینک‌های breadcrumb را تغییر دهید.

• Separator (select) — نوع جداکننده. گزینه‌ها: Text، Icon، None. پیش‌فرض: Text.

• Separator (text) — متن جداکننده. پیش‌فرض: «/». فقط وقتی Separator روی Text یا خالی است در دسترس است.

• Icon (icon) — آیکون جداکننده. فقط وقتی Separator روی Icon است در دسترس است.

• Color (color) — رنگ جداکننده.

• Size (number with units) — اندازه جداکننده.

آیتم (Item)

این بخش به شما اجازه می‌دهد هر لینک breadcrumb را استایل‌دهی کنید.

• Padding (spacing) — padding برای آیتم‌های breadcrumb.

• Background color (color) — رنگ پس‌زمینه برای آیتم‌های breadcrumb.

• Border (border) — تنظیمات border برای آیتم‌های breadcrumb.

• Typography (typography) — typography برای آیتم‌های breadcrumb.

جاری (Current)

از این تنظیمات برای استایل‌دهی آخرین آیتم در مسیر breadcrumb استفاده کنید، که صفحه یا پست جاری را نشان می‌دهد.

• Padding (spacing) — padding برای آیتم صفحه جاری.

• Background color (color) — رنگ پس‌زمینه برای آیتم صفحه جاری.

• Border (border) — تنظیمات border برای آیتم صفحه جاری.

• Typography (typography) — typography برای آیتم صفحه جاری.

مرجع توسعه‌دهنده

برای JSON schema کامل به Breadcrumbs Schema مراجعه کنید.