![Як адаптувати шаблон joomla 1 (внутрішнього зовнішнього інтерфейсу) Як адаптувати шаблон joomla 1](https://images-on-off.com/images/120/kakadaptirovatshablonjoomla1-9c4d1504.jpg)
Отже, нижче представлений переклад статті:
1. Адаптація шаблону під Joomla 2.5. вступ
2. Переконаємося в тому, що настройки шаблону з боку адмін.панелі і зовнішній інтерфейс можна локалізувати
У роботі над Witblits я хотів переконатися в тому, що мовні змінні внутрішнього і зовнішнього інтерфейсу можна повністю перевести. Спочатку я задумався, так як не міг відшукати документацію щодо змін в мовних файлах в Joomla 2.5. але в кінці кінців мені все вдалося.
Зауваження: якщо заглянути в уже встановлений шаблон, ви не знайдете там цих мовних файлів. Це тому, що вони переміщаються в / SITEROOT / languages / en-GB / (британська англійська) при установці шаблону.
Підключаємо файл локалізації шаблону до Joomla
Для того щоб в Joomla з'явилися включені переклади, потрібно додати цей текст в templateDetails.xml:
Зверніть увагу на те, як я вказав шлях папки: де знаходяться файли перекладу по відношенню до головної папки шаблону. Після створення необхідних мовних файлів і прив'язки локалізації до Joomla. додамо цей блок в самий верх мовного файлу:
Таким чином, ми прив'язуємо копірайт і інформацію про ліцензії. Єдине, що тут потрібно згадати - це необхідність використання крапки з комою замість знака # (який раніше використовувався в файлах .ini в Joomla 1.5) у верхній частині інформації файлу. Мені потрібен час для з'ясування, але якщо не змінити символ таким чином, переказ не причепиться.
Додавання файлу локалізації налаштувань адміністративної частини шаблону
Однією з моїх первинних завдань було додавання перекладу для панелі адміністратора і для шаблонів зовнішнього інтерфейсу. В розширеннях це можна зробити висновком мовного файлу адміністратора (під таким же ім'ям, як і в зовнішньому інтерфейсі) в тег
Зверніть увагу, що у мітки, опису і налаштувань радіо є мовні константи. У мовному файлі вони будуть виглядати так:
3. Використання нового елемента "Media"
В Joomla елементи являють собою xml-типи, які використовуються при створенні ваших опцій. Типи за замовчуванням: text, textarea, radio, list, section, category, spacer, filelist, folderlist, і т.д.
Що буде виглядати ось так:
Рис.1. Media елемент в Joomla 2.5
Натисканням кнопки «вставити» відкривається панель лайтбоксу, яка дозволяє користувачеві вибрати існуюче зображення або завантажити нове:
![Як адаптувати шаблон joomla 1 (внутрішнього зовнішнього інтерфейсу) Як адаптувати шаблон joomla 1](https://images-on-off.com/images/120/kakadaptirovatshablonjoomla1-9690d449.png)
Рис.2. Media елемент в Joomla 2.5 - спливаюче вікно з вибором файлу
4. Як створити свої елементи для опцій вашого шаблону
Над цією частиною мені теж довелося "поламати голову", але завдяки порадам Стіан (Stian), стало набагато легше.
Створити елемент «завантажувач»
![Як адаптувати шаблон joomla 1 (joomla) Як адаптувати шаблон joomla 1](https://images-on-off.com/images/120/kakadaptirovatshablonjoomla1-6e95aa9f.png)
Рис.3. Створити елемент "завантажувача" в Joomla 2.5
За допомогою прикріпленого спеціального css файлу адміністратора мені вдалося налаштувати вигляд і стиль панелі адміністрування:
![Як адаптувати шаблон joomla 1 (joomla) Як адаптувати шаблон joomla 1](https://images-on-off.com/images/120/kakadaptirovatshablonjoomla1-1ad2c1f8.png)
Рис.4. Шаблон Joomla 2.5 - застосування елемента "завантажувач" в налаштування адмін. панелі
Створити елемент «піпетка»
Файл елемента «піпетка» міститься в zip-архіві в кінці цієї статті. Якщо хочете подивитися які зміни були внесені в код, просто скачайте прикріплені файли і уважно їх вивчіть.
Для активації опцій «піпетки» я просто додав наступне в мій файл templateDetails.xml:
Якщо поглянути на файл colorpicker.php. можна побачити, що я додав два нових параметра для елемента «піпетка»: - "id" і "previewid". Вони були потрібні для їх унікальності щоб я міг посилатися на них при написанні CSS або JS-коду. Ось приклад новоствореної «піпетки» в дії:
![Як адаптувати шаблон joomla 1 (внутрішнього зовнішнього інтерфейсу) Як адаптувати шаблон joomla 1](https://images-on-off.com/images/120/kakadaptirovatshablonjoomla1-075bcd95.png)
Рис.5. Елемент «піпетка» в настройках шаблону Joomla
Активація нових елементів в templateDetails.xml
Ще одна важлива деталь з приводу нестандартних елементів це те, що для їх роботу необхідно прописати їх у файлі templateDetails.xml для того, щоб вони працювали в Joomla. Десь на початку файлу (в моєму варіанті - під мовним блоком), додайте цей код (шаблон для Joomla 2.5):
В Joomla 1.5 код буде виглядати приблизно так:
Вивчайте, що у випадку з моїм шаблоном Witblits, я вирішив зберегти всі спеціальні файли адміністратора в папці для того, щоб все було в одному місці. У вас все може бути по-іншому.
5. Як полегшити процес оновлення для користувачів
Це відомо ще з часів версії Joomla 1.5 (або навіть раніше), але все одно корисно знати.
У самому верху файлу templateDetails.xml. де ми бачимо:
Додайте method = "upgrade" до Тегу з установкою:
Таке рішення дозволить користувачам встановлювати оновлену версію шаблону без необхідності видаляти попередню - це дозволить файлів нової версії переписувати колишні файли (з "старої" версії шаблону). Можливість поновлення шаблону спростить як ваше життя, так і життя вебмасетров, що використовують ваші шаблони.
6. Шорткоди параметрів шаблону
У Witblits я включив файл опцій, в якому описав за допомогою змінних поставив деякі функції і параметри з коду шаблону.
Так як я часто використовую ці функції по всьому шаблоном, я вирішив створити змінні для кожної з них - так і мені простіше запам'ятати, і рядків коду виходить менше.
Ось кілька прикладів:
Це означає, що замість того щоб писати:
я можу використовувати більш коротку версію:
Вважаю, що така змінна дозволить набагато легше орієнтуватися в структурі шаблону і не плутатися в довгих конструкціях.
7. Оновлений список синтаксичних помилок в error.php
Якщо у вашому шаблоні використовується стандартний файл error.php (розташований в корені шаблону), знадобиться оновити список синтаксичних помилок для роботи в Joomla 2.5.
Цей код взятий з оригінальною документації:
8. Заміна базових шаблонів виводу в Joomla 2.5
В Joomla 1.5 в силу табличного виведення багатьох компонентів і модулів при створенні Morph мені доводилося створювати свої шаблони виведення компонетов в папці html - щоб код був красивим і семантичним.
З виходом Joomla 1.6 ця необхідність у багатьох місцях відпала, так як розробники вже використовують нормальну Дівова верстку і для багатьох компонентів наявність своїх шаблонів виводу не є такою нагальною необхідність, як в Joomla 1.5. Майте це на увазі при оновленні своїх шаблонів.
Починаючи з версії 1.6, код шаблонів став чистішим і семантично. У зв'язку з чим я вирішив видалити існуючі html перевизначення і замінив на нові.
Завантажити елементи шаблону, що використовувалися в даній статті:
Спасибі kip0ki і Sulpher за допомогу в перекладі і правці статті.