Отже, нижче представлений переклад статті:
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
Натисканням кнопки «вставити» відкривається панель лайтбоксу, яка дозволяє користувачеві вибрати існуюче зображення або завантажити нове:
Рис.2. Media елемент в Joomla 2.5 - спливаюче вікно з вибором файлу
4. Як створити свої елементи для опцій вашого шаблону
Над цією частиною мені теж довелося "поламати голову", але завдяки порадам Стіан (Stian), стало набагато легше.
Створити елемент «завантажувач»
Рис.3. Створити елемент "завантажувача" в Joomla 2.5
За допомогою прикріпленого спеціального css файлу адміністратора мені вдалося налаштувати вигляд і стиль панелі адміністрування:
Рис.4. Шаблон Joomla 2.5 - застосування елемента "завантажувач" в налаштування адмін. панелі
Створити елемент «піпетка»
Файл елемента «піпетка» міститься в zip-архіві в кінці цієї статті. Якщо хочете подивитися які зміни були внесені в код, просто скачайте прикріплені файли і уважно їх вивчіть.
Для активації опцій «піпетки» я просто додав наступне в мій файл templateDetails.xml:
Якщо поглянути на файл colorpicker.php. можна побачити, що я додав два нових параметра для елемента «піпетка»: - "id" і "previewid". Вони були потрібні для їх унікальності щоб я міг посилатися на них при написанні CSS або JS-коду. Ось приклад новоствореної «піпетки» в дії:
Рис.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 за допомогу в перекладі і правці статті.