Создание шаблона при помощи template-extention [Piwigo Wiki]

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
=== Создание шаблона при помощи template-extention===
== Что такое шаблон?==
Шаблон в чем-то напоминает наш скелет, это архитектура страниц Вашей галереи. В шаблоне описано расположение и способ отображения элементов на странице, однако шаблон — это только каркас и в чистом виде он не может быть использован, ему необходима дополнительная информация, получаемая из тем.
== Что же такое template-extantion (T-E) ?!==
T-E — это программное средство настройки отображения галереи. При помощи T-E вы можете создавать файлы собственного шаблона на основе исходного. И соответсвенно настраивать свою галерею.
== Введение==
Для начала необходимо пояснить, что шаблонные файлы (файлы формата .tpl) — это не более чем текстовый файл, содержащий инструкции согласно которым будет отображаться страница. Таким образом, изменяя файлы шаблонов, вы изменяете внешний вид своей галереи.\\
Однако очень важно не менять оригинальные файлы Piwigo! Именно по этому мы будем работать не с оригинальными файлами, а создавать собственные на их основе. Вот почему наш метод называется template-extantion (расширение шаблона), поскольку вы, фактически, расширяете возможности исходного шаблона.
== Template-extantion==
Буквально — расширение шаблона — это файлы, которые будут дополнять исходный шаблон для получения нужного вам результата. Его работа сделана максимально логически очевидной: мы создаем копию исходного файла, вносим в нее изменения и программно перекрываем ей файл исходного шаблона. При этом ваш расширенный файл имеет другое название и другое расположение, в результате при обновлении Piwigo ваши изменения не пропадут со старым исходным файлом (который при обновлении может быть заменен), они сохраняться в вашем расширении, которое по прежнему будет изменять отображение сайта, перекрывая новый файл исходного шаблона.
== Создание пользовательских файлов==
Для начала необходимо активировать плагин LocalFiles Editor в **панели Администрирования -> плагины -> управление**. 
Далее входим в панель **LocalFiles Editor** и переходим на вкладку **«Шаблоны»**:\\
{{:localfileseditor1.png?800}}\\
Вы можете либо выбрать уже существующий файл для редактирования, либо, если хватает навыков, создать новый.
== Использование==
Предположим, что мы хотим изменить файл picture.tpl, который отвечает за отображение фотографии в нормальном режиме.
Жмем на ссылку **«Создать новый файл»**:\\
{{:localfileseditor2.png?800}}\\
  * //Имя файла// — вводим имя файла, в нашем случае что-нибудь вроде my-picture.tpl, или picture-personel.tpl, главное не изменять исходный файл.
  * //Родительская директория// — по умолчанию это папка templates-extantion, но если вы хорошо разбираетесь в структуре сайта, то можете ее изменить.
  * //Модель// — можно выбрать пустую страницу, или использовать уже готовый файл для частичного редактирования.
== Внесение изменений==
Поскольку вы работаете с собственной копией файла, вы можете вносить любые изменения, не опасаясь за сохранность исходного файла шаблона. Здесь все зависит только от ваших знаний PHP, HTML, JavaScript, CSS и всего, что вы захотите использовать.
== Применение внесенных изменений==
Недостаточно просто создать расширенный файл шаблона, необходимо еще сообщить движку Piwigo, что необходимо учитывать внесенные изменения. Как это сделать показано ниже: \\
В **панели администрирования** переходим на вкладку **Настройки -> Шаблоны**:\\
{{:templateextantion1.png?800}}\\
  * //Заменяющий (Пользовательский шаблон)// — это файлы, которые будут перекрывать исходный шаблон. Не все файлы здесь созданы вами, некоторые создаются при установке Piwigo и служат в качестве примера.
  * //Исходный шаблон// — это файлы исходного шаблона, которые необходимо перекрыть вашим расширением.
  * //Опциональное ключевое слово URL// — если вы не знаете, что это такое, то лучше и не трогать.
  * //Связанная тема// — если в этом списке выбрать какую-нибудь тему, то внесенные вами изменения будут отображаться только при выборе этой темы. Если поле оставить пустым, то изменения применяются для всех тем.
== Предупреждение==
Ваш расширенный файл не что иное, как копия файла исходного шаблона. Но при крупных обновлениях Piwigo, файлы исходного шаблона могут сильно меняться, а ваши останутся основанными на старом шаблоне и устареют. Поэтому необходимо следить за крупными обновлениям и проверять ваши файлы расширения на соответствие новым файлам шаблона.\\ \\
Для сравнения файлов вам могут помочь некоторые программы, такие, как Notepad++ (с небольшим плагином) или WinMerge. \\ \\
Если вам понадобится помощь, вы всегда можете обратиться за помощью на [[http://ru.piwigo.org/forum/|форум]] =)
Наверх
template_creating.1404386022.txt.gz · Последние изменения: 2014/07/03 11:13 — konve
Все страницы Недавние изменения
Показать страницу
История страницы