Изменения в шаблонной системе при переходе с версии 0.9.0 на 0.9.1

Разработка версии 0.9.1 заняла значительное время и в процессе работы над версией было внесено достаточное количество изменений в шаблонную систему.

Несмотря на то, что изменений действительно много, вы можете достаточно быстро адаптировать ваш существующий шаблон для работы с новой версией. При наличии навыков работы с HTML на адаптацию шаблона у вас уйдёт от 10 до 30 минут.

• Комментарии вынесены в отдельный плагин (comments)
• Работа с учётными записями пользователей вынесена в отдельный плагин (uprofile)
• Созданы специальные страницы для обработки ошибки 404: Not found
• Создан специальный настроечный файл variables.ini (функционал из файла navigations.ini перенесён в него)

• [NEW] - новый шаблон
• [EDIT] - изменения в существующем шаблоне
• [DEL] - удаление существующего файла
• [MOVE] - существующий файл перенесён

Список изменённых шаблонов/файлов

[EDIT] categories.tpl

• добавился блок [if_link]..[/if_link] - содержимое блока показывается в случае, если элемент меню должен быть ссылкой (см. параметр "Режим отображения ссылок в меню категорий" в настройках категорий)

[EDIT] usermenu.tpl

• добавилась переменная {form_action}, её необходимо использовать в качестве action'а для формы авторизации
• переменная {request_uri} переименована в {redirect}, её необходимо использовать в качестве значения для переменной redirect в форме авторизации
• добавилась переменная {logout_link}, её необходимо использовать для ссылки на выход (logout)
• удалён блок [login-err]..[/login-err]. Теперь в случае ошибки авторизации вся информация отображается в новом шаблоне login.tpl

[EDIT] news.short.tpl

• блок [link]..[/link] переименован в [full-link]..[/full-link]

[EDIT] news.full.tpl

• добавлен блок [more]..[/more], его необходимо устанавливать в месте разделения короткой и длинной новостей. логика работы блока: если включена поддержка "Расширенного режима для разделения короткой/полной новостей" (настройки системы => новости) и пользователь указал свой текст разделителя, то выводится пользовательский разделитель. Иначе - выводится содержимое этого блока.
• убран блок [comheader]..[/comheader], теперь вся информация для комментариев выводится плагином comments. для работы комментариев в шаблон необходимо добавить переменную {plugin_comments} в место, где должны отображаться комментарии

[MOVE] print.tpl

[EDIT] main.tpl

• убрана переменная {metatags}, на её место пришла переменная {htmlvars} (на её месте отображаются не только мета-теги, но и подключаются необходимые JS/CSS библиотеки, включая те, которые подгружают плагины)

[EDIT] search.table.tpl

• невидимое (hidden) input-поле action больше не нужно
• переименованы языковые переменные: author => search.filter.author, category => search.filter.category, date => search.filter.date, search => search.submit, found => search.found (т.е. теперь вместо {l_author} надо писать {l_search.filter.author})
• убраны переменные {padeg1}, {padeg2}, {count_all}

• переменная {form_url}, её необходимо использовать в качестве action'а для формы
• языковые переменные {l_search.found}, {l_search.notfound}
• переменная {count} (кол-во найденных новостей)
• блок [found]..[/found] - отображается только в случае, если что-то нашли (в него удобно класть отображение информации о кол-ве найденных новостей)
• блок [found]..[/found] - отображается только в случае, если что-то нашли (в него удобно класть отображение информации о кол-ве найденных новостей)
• блок [notfound]..[/notfound] - отображатеся только в случае, если ничего найти не удалось
• блок [error]..[/error] и языковая переменная {l_search.error} - отображается в случае, если неверно указаны входные параметры (обычно - если не задан текст для поиска)

[EDIT] search.form.tpl

• добавилась переменная {form_url}, её необходимо использовать в качестве action'а для формы авторизации
• невидимое (hidden) input-поле action больше не нужно

[MOVE] search.entries.tpl [необязательный шаблон]

[EDIT] lostpassword.tpl

• переменная {php_self} заменена на {form_action} (используется в качестве action для тега <form>
• удалена переменная action из формы

[EDIT] registration.tpl

• добавилась переменная {form_action}, её необходимо использовать в качестве action'а для формы авторизации (ранее в некоторых случаях там использовалась переменная {php_self} либо {register_link}. обе переменные сейчас недоступны)
• невидимое (hidden) input-поле action больше не нужно

[NEW] login.tpl

• {form_action} - URL формы-обработчика
• {redirect} - значение, которое необходимо передать в скрытом поле ввода redirect, позволяет вернуться обратно на страницу (внутри сайта), с которой пользователь авторизовывался

• username - логин пользователя
• password - пароль пользователя

[NEW] 404.internal.tpl

[NEW] 404.external.tpl

[MOVE] comments.show.tpl

• Для правильной отработки ссылки на цитирование необходимо в блоке [quote]..[/quote] ссылку прописывать так (т.е. добавить return false;):

  [quote]<a href="" onclick="quote('{author}'); return false;" title="{l_quote}"> {l_quote}</a>[/quote]
  

[MOVE] comments.form.tpl

• изменён блок JS кодов, отвечающих за добавление комментариев через AJAX, необходимо этот блок взять из стандартной поставки. Также из стандартной поставки желательно взять заголовочную часть (идёт сразу за JS кодом) либо сделать по аналогии:

  <div id="new_comments"></div>
  <form id="comment" method="post" action="{post_url}" name="form" [ajax]onsubmit="add_comment(); return false;"[/ajax]>
  <input type="hidden" name="newsid" value="{newsid}" />
  <input type="hidden" name="referer" value="{request_uri}" />
  

• добавилась переменная {post_url}, её необходимо использовать в качестве action'а для формы авторизации
• добавилась переменная {request_uri}, её значение необходимо передавать в hidden-переменную referer для корректной переадресации обратно к новости при добавлении комментария и отключении AJAX режима:

  <input type="hidden" name="referer" value="{request_uri}" />
  

• теперь для текстового блока <textarea> необходимо указывать id="content":

  <textarea name="content" id="content" style="width: 95%;" rows="8"></textarea>
  

[NEW] plugins/comments/comments.internal.tpl

• [comheader]..[/comheader] - блок выводится в случае, если в новости уже есть комментарии
• {entries} - список комментариев (для отображения используется шаблон comments.show.tpl)
• {more_comments} - ссылка "Читать все комментарии" (отображается в случае, если комментарии к новости не помещаются на первой странице внутри новости)
• {form} - форма добавления комментариев

[NEW] plugins/comments/comments.external.tpl

• {link} - ссылка на новость, к которой показываются комментарии
• {title} - название новости, к которой показываются комментарии

[EDIT] bbcodes.tpl

<a href="javascript:insertext('[b]','[/b]', '{area}')" title='{l_qt_bold}'> ...

<a onclick="insertext('[b]','[/b]', '{area}')" title='{l_qt_bold}'> ...

<span id="tags">
...содержимое...
</span>

[MOVE] error.tpl

[MOVE] users.tpl

• Языковые переменные перенесены в плагин uprofile, теперь вместо {l_var} нужно писать {l_uprofile:var}
  Пример: вместо {l_icq} нужно писать {l_uprofile:icq}

[MOVE] profile.tpl

• Языковые переменные перенесены в плагин uprofile, теперь вместо {l_var} нужно писать {l_uprofile:var}
  Пример: вместо {l_icq} нужно писать {l_uprofile:icq}
• добавилась переменная {form_action}, её необходимо использовать в качестве action'а для формы авторизации
• в форме необходимо добавить скрытое поле:

  <input type="hidden" name="plugin_cmd" value="apply" />
  

[MOVE] static.tpl

[DEL] activation.tpl

[DEL] addnews.tpl

[DEL] quicktags.tpl

[NEW] redirect.tpl

• {title} - заголовок страницы
• {message} - сообщение для пользователя
• {link} - URL страницы-переадресации
• {linktext} - текст, отображаемый на URL'е переадресации

[DEL] navigation.ini

[NEW] variables.ini

; Настройка панели постраничной навигации
[navigation]
; Формат ссылки `предыдущая страница`
prevlink	= "<a href='%link%'>%page% "
; Формат ссылки `следующая страница`
nextlink	= "<a href='%link%'>%page%</a> "
; Формат ссылки `текущая страница`
current_page	= " <b>[%page%]</b> "
; Формат ссылки `страница`
link_page	= "<a href='%link%'>%page%</a> "
; Разделитель блока ссылок (многоточие)
dots		= " ... "

; Настройка отображения системных сообщений/ошибок
[messages]
; Сообщение об ощибке
msg.error	= "<div class='msge'><img src='{skins_url}/images/error.gif' hspace='10' />{l_msge_error} {text}</div>"
; Информационный блок к сообщению об ошибке
msg.error_info	= "<div class='msge'><img src='{skins_url}/images/error.gif' hspace='10' />{l_msge_error} {text}</div><div class='msgi'><img src='{skins_url}/images/info.gif' hspace='10' />{l_msgi_info} {info}</div>"
; Системное сообщение (об успешно выполненном действии)
msg.common	= "<div class='msgo'><img src='{skins_url}/images/msg.gif' hspace='10' />{text}</div>"
; Информационный блок к системному сообщению
msg.common_info	= "<div class='msgo'><img src='{skins_url}/images/msg.gif' hspace='10' />{text}</div><div class='msgi'><img src='{skins_url}/images/info.gif' hspace='10' />{l_msgi_info} {info}</div>"
; Отдельно создаваемый информационный блок
msg.info	= "<div class='msgi'><img src='{skins_url}/images/info.gif' hspace='10' />{l_msgi_info} {info}</div>"

; Настройка BB кодов
[bbcodes]
; ** URL ** (параметры BB кода)
; Стиль по умолчанию для BB кода URL (если не задан в самом BB коде)
;url.class.default	= ""

; Задавать стиль для BB кода URL (вне зависимости от того задан ли стиль в BB коде)
;url.class.force	= ""

; Значение параметра target по умолчанию для BB кода URL (если не задан в самом BB коде)
;url.target.default	= ""

; Значение параметра target для BB кода URL (вне зависимости от того задан ли стиль в BB коде)
;url.target.force	= ""

; ** IMG ** (параметры BB кода)
;url.class.default	= ""
;url.class.force	= ""

; ** ATTACH **
; Формат отображения для BB кода [attach]
; Допустимые параметры:
; * {url}   - URL файла-вложения
; * {title} - Имя файла-вложения
; * {size}  - Размер файла-вложения
attach.format	= "<a href='{url}'>{title} ({size})</a>"
; Текст, который будет выводиться вместо тега [attach] в случае, если такого файла-вложения не существует
attach.nonexist	= "[wrong or deleted attach]"