Меню на сайті
Модуль «Меню на сайті» формує меню будь-якої складності і в будь-якій кількості.
Модуль складається з 2-х частин: пункти меню і меню.
Пункти меню
Пункти меню - посилання, що формують меню. Тобто, по суті, саме меню і є. Навігація. Пункти меню можуть посилатися на сторінки сайту, категорії модулів і елементи модулів, а також на будь-яку зовнішню посилання.
Пункти меню мають наступні характеристики:
Основні:
- Назва пункту меню - Ця назва виводиться як пункт меню на сайті. Параметр має різні значення для різних мовних версій сайту.
- Опублікувати на сайті - Чи показувати пункт меню на сайті або тимчасово приховати. Параметр має різні значення для різних мовних версій сайту.
- Посилання з пункту меню - Адреса посилання, куди веде поточний пункт меню. Заповнюється автоматично при позначці галки «Показувати в меню» у елемента на сайті. Можливо вказати вручну, як на внутрішню сторінку сайту, так і на будь-який інший сайт.
- Відкривати в новому вікні - Якщо відзначена, клік користувача за пунктом меню на сайті відкриє посилання в новому вікні.
- Атрибути HTML посилання - HTML-код, що виводиться у вигляді атрибутів для тега усередині посилання <a ***> </ a> (Веб-майстру і програмісту).
- Властивості пункту.
- Належить до меню - Вибір меню, до якого належить поточний пункт.
- Вкладеність: належить - Переміщення поточного пункту меню і всіх його підпунктів в приналежність іншого пункту меню (адміністратору сайту).
- Сортування: встановити перед - Змінити становище поточного пункту меню серед інших пунктів (адміністратору сайту).
- Зображення - Призначити поточного вибору меню зображення. Тоді посиланням буде не назва пункту, а прикріплене зображення.
- Опис - Короткий опис виводитися для пункту меню на сайті. Параметр має різні значення для різних мовних версій сайту.
При блокуванні елемента, на який посилається пункт меню, відповідний пункт меню теж блокується. Також при видаленні елемента - відповідний пункт меню видаляється. Тобто, якщо приховати або видалити сторінку на сайті, відповідний пункт меню також буде приховано або видалений.
Структуру меню можна формувати безпосередньо з модуля «Меню на сайті» або при заповненні сторінок сайту, категорій або елементів модулів, відзначаючи галку «Показувати в меню». При цьому структура сайту повторюється в меню.
приклад:
Відзначаємо опцію «Показувати в меню» для новини. Якщо категорія, якій належить новина, також має посилання в меню, то новий пункт меню додасться як вкладений в пункт категорії меню. Інакше додасться пункт меню першого рівня.
При формуванні списку елементів, які можна вибрати в якості посилань для пунктів меню, використовуються елементи інших модулів. Посилання на ці елементи формуються за допомогою файлу modules / модуль / admin / модуль.admin.menu.php.
Меню
Категорії меню - це різні меню на сайті. Меню на сайті може бути необмежена кількість. Виводяться вони на сайті за допомогою шаблонного тега show_block .
При видаленні меню видаляються всі належні йому пункти меню.
Категорії меню мають наступні характеристики:
Основні:
- ID меню - Номер елемента в БД (Веб-майстру і програмісту).
- Назва меню - Назва меню, відображається на сайті перед меню, якщо відзначений параметр «Показувати заголовок меню». Параметр має різні значення для різних мовних версій сайту.
- Опублікувати на сайті - Чи показувати меню на сайті. Параметр має різні значення для різних мовних версій сайту.
- Показувати заголовок меню - Якщо відзначене, перед пунктами меню виведеться назву меню (адміністратору сайту).
- Розкривати всі пункти меню - Якщо відзначене, в меню будуть виводитися всі пункти меню, включаючи вкладені. Інакше вкладені пункти будуть з'являтися тільки при переході на батьківський пункт. (Адміністратора сайту).
- Чи не відображати посилання на елемент, якщо він має дочірні пункти - Якщо відзначене, пункти меню не будуть посиланнями, якщо у них є вкладені пункти. (Адміністратора сайту).
- Поточний пункт меню як посилання - Якщо відзначене, активний пункт меню залишиться посиланням. (Адміністратора сайту).
- Не додавати ім'я пункту меню, якщо використовується изображнием - Якщо до пункту меню прикріплено зображення, то ім'я пункту відображатися не буде. (Адміністратора сайту).
- Відображати на сторінках - Вибір окремих сторінок сайту, де буде показуватися меню. Утримуйте CTRL, щоб вибрати кілька сторінок (адміністратору сайту).
- Доступ - Якщо відзначити опцію «Доступ тільки», категорію побачать тільки авторизовані на сайті користувачі, зазначених типів. Чи не авторизовані, в тому числі пошукові роботи, побачать «404 Сторінку не знайдено» (адміністратору сайту).
- Сортування: встановити перед - Редагування порядку проходження категорії в списку. Поле є для редагування тільки для категорій, які відображаються на сайті.
- Шаблон виведення меню - Шаблон буде використаний, якщо в шаблонному тезі show_block вказано атрибут template = "select". (Веб-майстру і програмісту. Не міняйте цей параметр, якщо не впевнені в результаті!)
налаштування
- Використовувати зображення - Якщо відзначити, то до кожного пункту меню потім можна буде завантажувати зображення. Необхідно для графічних сайтів, де пункти меню намальовані, а не написані текстом
- Генерувати розміри зображень - Розміри зображень, задані в модулі «Зображення» і тег латинськими буквами для підключення зображення на сайті. Обов'язково повинні бути задані два розміри: прев'ю зображення в списку файлів (тег medium) і повне зображення (тег large).
- Максимальний розмір файлів - Параметр показує максимально припустимий розмір файлів, встановлений в настройках хостингу. Параметр виводиться, якщо вибрано пункт «Використовувати зображення».
- Застосувати налаштування до всіх раніше завантажених зображень - Дозволяє переконвертіровать розмір вже завантажених зображень. Кнопка необхідна, якщо змінені настройки розмірів зображень. Параметр виводиться, якщо вибрано пункт «Використовувати зображення».
шаблонні теги
Для роботи з модулем «Меню» служать наступні шаблонні теги :
show_block - виводить меню.
атрибути:
- id - ідентифікатор категорії меню;
- template - ім'я шаблону;
Якщо в атрибуті template вказано якесь значення, то повинен існувати файл modules / menu / view / menu.view.show_block_ template .php.
приклад:
<Insert name = "show_block" module = "menu" template = "supermenu">
меню оформиться за допомогою файлу modules / menu / view / menu.view.show_block_ supermenu .php, який необхідно буде створити (можна скопіювати будь-який інший існуючий файл шаблону)
Значення template = "default" підключить шаблон modules / menu / view / menu.view.show_block.php.
Значення template = "select" підключить шаблон обраний для меню в адміністративному інтерфейсі - параметр "Шаблон виведення меню».
Якщо атрибут template не заданий, меню оформляється за допомогою атрибутів оформлення і виводиться шаблоном modules / menu / view / menu.view.show_menu.php.
- tag_start_номер - текст, що виводиться перед кожним посиланням меню (може містити слово Increment - при виведенні автоматично заменяемое на арифметичну прогресіію, 1, 2, 3, ... і Level - заменяемое на номер рівня меню);
- tag_end_номер - текст, що виводиться після кожного посилання пункту меню (може містити слово Increment - заменяемое на збільшується номер і Level - заменяемое на номер рівня меню);
- tag_end_after_children_номер - текст, що виводиться після вкладених пунктів кожного пункту меню (може містити слово Increment - заменяемое на збільшується номер і Level - заменяемое на номер рівня меню);
- tag_level_start_номер - текст, що виводиться перед рівнем (номер) меню;
- tag_level_end_номер - текст, що виводиться після рівня (номер) меню;
- tag_active_start_номер - текст, що виводиться перед активним пунктом меню рівня (може містити слово Increment - заменяемое на збільшується номер і Level - заменяемое на номер рівня меню);
- tag_active_end_номер - текст, що виводиться після активного пункту меню рівня (може містити слово Increment - заменяемое на збільшується номер і Level - заменяемое на номер рівня меню);
- tag_active_end_after_children_номер - текст, що виводиться після вкладених пунктів активного пункту меню рівня (може містити слово Increment - заменяемое на збільшується номер і Level - заменяемое на номер рівня меню);
- tag_active_child_start_номер - текст, що виводиться перед пунктом меню рівня (номер) з активним дочірнім пунктом (може містити слово Increment - заменяемое на збільшується номер і Level - заменяемое на номер рівня меню);
- tag_active_child_end_номер - текст, що виводиться після пункту меню рівня (номер) з активним дочірнім пунктом (може містити слово Increment - заменяемое на збільшується номер і Level - заменяемое на номер рівня меню);
- tag_active_child_end_after_children_номер - текст, що виводиться після вкладених пунктів пункту меню рівня (номер) з активним дочірнім пунктом (може містити слово Increment - заменяемое на збільшується номер і Level - заменяемое на номер рівня меню);
- separator_номер - текст, що розділяє пункти меню;
- count_level - кількість виведених рівнів меню, атрибут використовується при оформленні меню атрибутами (template = "");
- defer - маркер відкладеної завантаження шаблонного тега: event - завантаження контенту тільки за бажанням користувача при натисканні кнопки "Завантажити", emergence - завантаження контенту тільки при появі у вікні браузера клієнта, async - асинхронна (одночасна) завантаження контенту спільно з контентом шаблонних тегів з тим же маркером, sync - синхронна (послідовна) завантаження контенту спільно з контентом шаблонних тегів з тим же маркером, за замовчуванням завантаження контенту тільки за бажанням користувача;
- defer_title - текстовий рядок, що виводиться на місці появи завантаження контенту за допомогою відкладеної завантаження шаблонного тега.
Номер в назві атрибутів позначає номер рівня. Якщо атрибути не вказані для поточного рівня, то вони успадковуються у верхнього рівня.
приклад:
<Insert name = "show_block" module = "menu">
виведе просто список посилань основного меню
<Table>
<Insert name = "show_block" module = "menu" id = "2" tag_start_1 = "[tr] [td]" tag_end_1 = "[/ td] [/ tr]">
</ Table>
сформує таблицю, в окремій клітинці якої будуть пункти меню з другого меню
<Insert name = "show_block" module = "menu" tag_start_1 = "[div class =` menu`] "tag_end_1 =" [/ div] "tag_start_2 =" [div class = `submenu`]" tag_end_2 = "[/ div ] ">
виведе:
<Div class = "menu"> <a href= "..."> Про нас </ a> </ div>
<Div class = "submenu"> <a href= "..."> Тварини </ a> </ div>
<Div class = "submenu"> <a href= "..."> Місія </ a> </ div>
<Div class = "submenu"> <a href= "..."> Історія </ a> </ div>
<Div class = "menu"> <a href= "..."> Фотогалерея </ a> </ div> <insert name = "show_block" module = "menu" tag_start_1 = "[div class =` menuLevel`] "tag_end_1 =" [/ div] ">
виведе:
<Div class = "menu1"> <a href= "..."> Про нас </ a> </ div>
<Div class = "menu2"> <a href= "..."> Тварини </ a> </ div>
<Div class = "menu2"> <a href= "..."> Місія </ a> </ div>
<Div class = "menu2"> <a href= "..."> Історія </ a> </ div>
<Div class = "menu1"> <a href= "..."> Фотогалерея </ a> </ div>
У шаблоні тега можна отримати значення будь-якого атрибута через змінну $ result [ "attributes"] [ "назва атрибута"].
База даних
{Menu} - Пункти меню
{Menu_category} - Меню
{Menu_category_site_rel} - Дані про те, на яких сторінках сайту виводиться меню
{Menu_parents} - Батьківські зв'язку пунктів меню
файли
Модуль знаходиться в папці modules / menu і влаштований класично .
modules / menu / admin / js / menu.admin.js - редагування пунктів меню, JS-сценарій;
modules / menu / admin / menu.admin.php - редагування пунктів меню;
modules / menu / admin / menu.admin.action.php - обробка POST-запитів при роботі з меню в адміністративній частині;
modules / menu / admin / menu.admin.category.php - редагування категорій меню;
modules / menu / admin / menu.admin.config.php - настройки модуля;
modules / menu / admin / menu.admin.inc.php - підключення модуля до адміністративної частини інших модулів;
modules / menu / menu.php - контролер;
modules / menu / menu.inc.php - підключення модуля;
modules / menu / menu.install.php - установка модуля;
modules / menu / menu.model.php - модель;
modules / menu / views / m / menu.view.show_block_topmenu.php - шаблон меню template = topmenu;
modules / menu / views / m / menu.view.show_level_topmenu.php - шаблон виводу першого рівня меню, викликається з функції show_block на початку файлу, template = topmenu;
modules / menu / views / m / menu.view.show_level_topmenu_2.php - шаблон другого і наступних рівнів меню, оформленого шаблоном;
modules / menu / views / m / menu.view.show_level_topmenu_3.php - шаблон другого і наступних рівнів меню, оформленого шаблоном;
modules / menu / views / menu.view.show_block.php - шаблон меню, оформленого шаблоном;
modules / menu / views / menu.view.show_block_leftmenu.php - шаблон меню template = leftmenu;
modules / menu / views / menu.view.show_block_topmenu.php - шаблон меню template = topmenu;
modules / menu / views / menu.view.show_level.php - шаблон виводу першого рівня меню, викликається з функції show_block на початку файлу, оформленого шаблоном;
modules / menu / views / menu.view.show_level_2.php - шаблон виводу другого і наступних рівнів меню, оформленого шаблоном;
modules / menu / views / menu.view.show_level_leftmenu.php - шаблон виводу першого рівня меню, викликається з функції show_block на початку файлу, template = leftmenu;
modules / menu / views / menu.view.show_level_leftmenu_2.php - шаблон другого і наступних рівнів меню, оформленого шаблоном;
modules / menu / views / menu.view.show_level_topmenu.php - шаблон виводу першого рівня меню, викликається з функції show_block на початку файлу, template = topmenu;
modules / menu / views / menu.view.show_level_topmenu_2.php - шаблон другого і наступних рівнів меню, оформленого шаблоном;
modules / menu / views / menu.view.show_level_topmenu_3.php - шаблон другого і наступних рівнів меню, оформленого шаблоном;
modules / menu / views / menu.view.show_menu.php - шаблон меню, оформленого атрибутами тега.