Russian Sebloders - Russian Sebloders
Даний матеріал містить основну інформацію, необхідну для початку роботи з шаблонами позицій (оверрайдами, overrides). У статті наводиться докладний опис структури оверрайдів, директорій та файлів, необхідних для нормальної роботи.
ВСТУП
Система шаблонів Seblod створена таким чином, щоб легко інтегруватися в існуючу систему керування шаблонами Joomla. Користувацькі шаблони (оверрайди) Seblod є простим набором PHP файлів, розташованих у строго певних директоріях і названих таким чином, щоб Seblod їх міг автоматично ідентифікувати та призначити відповідним типам контенту/типам пошуку.
Хотілося б зробити невеликий відступ і визначитися з термінологією.
Найчастіше саме оверрайди, як часто використовувані ми називаємо "кастомним шаблоном", хоча по суті це не зовсім так.
Що ж таке користувальницький (або кастомний) шаблон, оверрайд та варіація?
1)кастомний шаблон (custom template) - шаблон виводу, створений користувачем з "0", або на основі дефолтних шаблонів Seblod, коли виведення даних здійснюється за рахунок зміни основного шаблону index.php. Надає найповніший контроль над висновком, можливість задати формат, кількість позицій, спосіб отримання/виводу значень і т.д.
2)оверрайд (override) шаблону - функціонал, передбачений шаблонами Seblod - можливість змінити виведення даних у якійсь одній/всіх позиціях виводу, додавши відповідним чином файл овверайду конкретної позиції до папки positions шаблону seb_one. Змінити/оформити висновок можна лише в межахпозицій, визначених основним шаблоном (index.php).
3)варіації (variation) шаблону - більш гнучкий аналог оверрайду, на мій погляд один з найпотужніших інструментів виведення в Seblod, АЛЕ знову ж таки - немає сенсу застосовувати в будь-яких ситуаціях, все залежить від завдання. Прикладом є варіація seb_css3. Дозволяє визначити формат виведення даних для певної позиції у шаблоні. Варіація використовується як "правило" виводу, в якому можна навіть створити та змінювати налаштування, створивши певний інтерфейс для їх введення. Варіації завантажуються в певні папки і після вже включаються безпосередньо в типі контенту, тип пошуку для БУДЬ-ЯКОГО обраної позиції! вже з менеджера Seblod (на відміну від попередніх двох варіантів).
У даному матеріалі розглядається саме створення і структура оверрайдів шаблону, як методу кастомізації форм і виведення даних, що найчастіше використовується.
Оверрайди шаблону дозволяють Вам налаштувати дизайн та виведення даних повністю відповідно до Ваших потреб. Для початку роботи необхідно створититип контенту (content type) уМенеджері типів форм і контенту (Seblod Form & Content Type Manager) і додати всі необхідні поля у відповідні позиції форм. Дана інструкція покаже Вам, як створити оверрайд, який буде автоматично прив'язаний до створеного типу контенту і візьме на себе керування виведенням даних або форми.
РОЗМІЩЕННЯ ОВЕРРАЙДУ ШАБЛОНУ SEBLOD
Файли оверрайдів шаблону Seblod мають бути розміщені у відповідній папці основного шаблону Seblod (seb_one). Він розташований у папці шаблонів Joomla:
Усі основні зміни відповідно до цієї інструкції відбуватимуться в папціpositions. Це папка в якій розміщуються ваші PHP файли оверрайдів шаблону(Overrides).
У Seblod 2.x папка positions не містить вищезгаданої структури папок і файлів, її необхідно створити самостійно. Ви також можете завантажити повну структуру файлів та папок тут.
При створенні структури папок та файлів самостійно дотримуйтесь наступної інструкції:
Створіть ті папки, які Вам необхідні!
Для керування виводом у папці з ім'ям Типу контенту (типу пошуку) можуть бути створені такі підпапки:
- content - оверрайд закладки content
- admin - оверрайд Admin Form
- site - оверрайд Site Form
- Intro - оверрайд Intro
Для типу пошуку імена папок відповідно будуть:
- search - оверрайд Search form
- item - оверрайд виводу item
ДЛЯ LIST ОВЕРРАЙДИ В SEB_ONE НЕ ПЕРЕДБАЧЕНІ! ДЛЯ ВИСНОВКУ В КОРИСТУВАЛЬНОМУ ФОРМАТІ ДАНИХ З LIST ВИКОРИСТОВУЙТЕ ШАБЛОНИ СТОРІННИХ РОЗРОБНИКІВ, НАПРИКЛАД TPL_BASIC_LIST.
Тобто. наприклад, якщо вам потрібно зробити оверрайд позиції mainbody у виведенні (content) типу контенту "_content_type", то:
a) створіть порожній файл з розширенням .php у цій папці з іменем потрібної позиції, тобто. mainbody.php;
б) додайте наступний код на самому початку файлу:
в) Збережіть файл.
г) також не забудьте додати до папки порожній файлindex.html
Папка позицій може мати наступну структуру.
Крок 1. Створення папки для контенту.
Її повний шлях буде наступним:
Тепер у папці products містяться такі підпапки:
/admin /content /intro /site
Крок 2. Створення необхідних файлів оверрайду для кожного видуформи/контенту.
Відповідно, нам необхідно створити три файли mainbody.php , topbody.php та bottombody.php Розмістити дані файли у відповідні папки видів форм/контенту.