Modx Evo Как да създадете верига от менюта за Modx (Breadcrumbs) от Василиса Белозерова
Често искате да създадете верига от елементи от менюто. Обикновено изглежда така:
И се показва в горната част на страницата. Тази функция е необходима за удобство на потребителите.
Така че да започваме. modx има вграден фрагмент - [ [Breadcrumbs]]
За да го използвате е необходимо да се регистрирате в шаблона на сайта:
[ [Breadcrumbs]] или [ !Breadcrumbs]]
В този случай използваме точно 1 опция, тъй като не е необходимо да актуализираме данните всеки път, когато актуализираме една и съща страница.
Галета със стилове
Показва се на всички страници с изключение на първата.
Нека стилизираме нашата верига:
#bread top: 20px; text-align:left;
#bread afont-size : 14px; color:#333; >
Можете да използвате допълнителни опции:
[[Трохи за хляб? ¶meter_name1=`стойност` ¶meter_name2=`стойност`]]
Опции за галета
-
&maxCrumbs — максималният брой елементи във веригата. Възможни стойности: цяло число. По подразбиране: 100.
Забележка: ако числото е зададено на по-малко от възможния брой точки, тогава в средата на веригата ще се появи многоточие “. ” вместо допълнителни елементи.
&respectHidemenu - скриване на елементи, които не са маркирани за показване в менюто. Възможни стойности: 0 - показване 1 - скриване. По подразбиране: 1.
Забележка: можете да разрешите или забраните елементите да се показват в менюто на страницата за редактиране на ресурс в раздела „Общи“. Квадратче за отметка „Покажи в менюто“.
&showCurrentCrumb — показване на елемента с името на текущата страница във веригата. Възможни стойности 0 - не показване 1 - показване. По подразбиране: 1.
Забележка: използвайки товапараметър, можете да деактивирате показването на последния елемент във веригата.
Забележка: По подразбиране тази опция показва елемента на текущата страница като обикновен текст, ако искате да покажете елемента като връзка към текущата страница, задайте стойността на 1.
&linkTextField е името на елементите в навигационната верига. По подразбиране: menutitle или pagetitle. Възможни стойности: description longtitle pagetitle menutitle.
Забележка: този параметър определя кое поле ще се използва за формиране на имената на елементите на навигационната верига. По подразбиране името на елемента от веригата ще съответства на името на елемента от менюто, което може да бъде променено на страницата за редактиране на ресурс в полето „Елемент от менюто“.
&linkDescField — атрибут заглавие за връзки в навигационната верига. По подразбиране: описание. Възможни стойности: заглавие на страницата, дълго заглавие, описание, заглавие на менюто. Забележка: стойността на атрибута заглавие изскача, когато задържите курсора на мишката върху връзка в навигационната верига. По подразбиране се взема стойността на полето "Описание", която може да бъде променена на страницата за редактиране на ресурса.
Забележка: Можете да зададете стойността на 0, ако по някаква причина искате веригата за навигация да не може да се кликва и да се показва като текст.
&crumbGap е низ, който ще представлява прекъсване в навигационната верига. Възможни стойности: низ. По подразбиране: многоточие “. ".
Забележка: можете да посочите кои знаци ще прекъснат веригата за навигация, ако броят на елементите във веригата е по-голям от стойността, посочена в &maxCrumbs.
&stylePrefix — префикс в имената на CSS класове. Възможни стойности: низ. По подразбиране: B_.
Забележка: стойността на този параметър определя префикса в CSS иметокласове. Малко по-високо вече отбелязахме кои класове се използват при показване на HTML маркиране и за какво отговарят.
Настройки на връзката към началната страница:
- &showHomeCrumb — показване на връзка към началната страница. Възможни стойности: 0 - не показване 1 - показване. По подразбиране: 1.
&homeId е идентификаторът на страницата, която ще се счита за начална. Възможни стойности: цяло число. По подразбиране: $modx->config['site_start'].
Забележка: По подразбиране главната страница ще бъде тази, чийто идентификатор е посочен на страницата за конфигурация на системата в полето "Първа страница".
&homeCrumbTitle — текст на елемента на началната страница в навигационната верига. Възможни стойности: низ. По подразбиране: menutitle или pagetitle.
Забележка: Можете да използвате тази опция, когато искате текстът на елемента на главната страница да е различен от името на елемента от менюто на главната страница или заглавието на страницата, което може да се промени при редактиране на ресурси. Например някои разработчици въвеждат името на домейна вместо името „Начало“ в навигационната верига.
&homeCrumbDescription е персонализиран текст, който може да се използва като атрибут заглавие за връзка към началната страница. Възможни стойности: низ. По подразбиране: стойността, посочена в параметъра linkDescField.
Забележка: Ако полето е оставено празно, тогава текстът за атрибута на заглавието ще бъде определен от параметъра &linkDescField. По желание можете да въведете текста, който ще изскочи, когато задържите курсора на мишката върху връзката. Например „Отидете на главната страница“
Настройки за показване на навигационната верига на различни страници:
- &showCrumbsAtHome — показва веригата за навигация на началната страница. Възможни стойности: 0 - не показвай 1 - показвай. По подразбиране: 1.
Забележка: Тази настройка може да се използва за деактивиране на показването на навигацията с навигационни пътища на главната страница.
&hideOn - не показвайте навигационни пътеки на страници Възможните стойности са разделени със запетаи идентификационни номера на страници, където веригата за навигация не трябва да се показва.
Забележка: Тази опция е полезна за малък брой страници, където по изключение не е необходимо да показвате лента за навигация. Ако има много такива страници, тогава е по-добре да използвате параметъра &hideUnder или да помислите за създаване на друг шаблон.
&hideUnder - не показвайте веригата за навигация на дъщерни страници Възможните стойности са разделени със запетаи идентификатори на папки, чиито дъщерни документи не трябва да показват подложка за навигация.
Забележка: Посочването на идентификатори на папки скрива само лентата за навигация на дъщерните страници. Ако искате низът да не се показва както на дъщерната, така и на родителската страница, добавете идентификаторите на родителския ресурс към &hideUnder и &hideOn.