Celena  ➤  Документація (Frontend)

Документація (Frontend) 1.0.24

  • - обов'язковий тег.

Загальні теги

Ці теги працюють на будь-якій сторінці вашого сайту.

Teг Опис
{META} Виводить мета-теги для пошукових систем. Ставиться перед тегом, що закриває <head>.
{STYLES} Виводить системні стилі системи, включаючи стилі інших плагінів та модулів.
{SCRIPTS} Виводить системні скрипти системи, включаючи скрипти інших плагінів та модулів.
{SYSTEMS} Виводить код, необхідний правильної роботи системи.
{THEME} Виводить шлях до папки із шаблоном. Наприклад //site.com/templates/Default
{CONTENT} Виводить контент. Пости, сторінки тощо.
{crumbs} Хлібні крихти.
{user-name} Виводить ім'я користувача.
{user-role} Виводить групу користувача.
{user-link} Виводить посилання на профіль користувача.
{user-avatar} Виводить посилання на аватарку користувача.
{auth} Виводить форми авторизації та реєстрації з файлу login.tpl.
{include file="inc/header.tpl"} Підключити файл, який знаходиться за адресою шлях до шаблону/inc/header.tpl Допускається розширення PHP.
Якщо першим ставитися сліш, шлях до файлу буде братися від кореня.

Умовні теги

Додавання приставки not- означає зворотну дію, не виводити вміст.
[category=1,2-5,10]...[/category]

[not-category=1,2-5,10]...[/not-category] 		Виведе вміст між тегами, якщо ми перебуваємо в категоріях, перерахованих в атрибуті.
[show=index,category]...[/show]

[not-show=index]...[/not-show] 		Виводить вміст між тегами, якщо тип сторінки збігається з наведеним в атрибуті. Наприклад: index,category - виведе контент, якщо користувач знаходиться на головній або в категорії.
Можливі варіанти для тега show

Стандартні варіанти. Ці назви відповідають іменам контролерів.

  • index - головна сторінка сайту
  • category - сторінка категорії
  • post - пост (повна новина)
  • page - статична сторінка
  • search - сторінка пошуку

Якщо у Вас встановлені плагіни, то у них працюють контролери. Назву контролера можна знайти в помічнику, увімкнувши опцію в налаштуваннях системи. Він з'явиться на кожній сторінці внизу.

Celena helper

Таким чином, тег буде мати вигляд: [show=plugins\Celena\Shop\Product]...[/show]
[role=0,1]...[/role]

[not-role=0,1]...[/not-role] 		Виводить вміст між тегами, якщо група користувачів збігається із вказаними ID в атрибуті. Наприклад: 0,1 - виведе контент, якщо користувач знаходиться в групі гості та адміністрація.
{custom}

{custom category="1,2-10" template="simple" limit="10" sort="desc"} - повний набір параметрів.


category - ID категорії або категорії через кому, з яких будуть отримані пости.

template - назва tpl файлу.

limit - у постів, яке потрібно вивести.

sort - сортування далі буде...
{langurl-ua}

Цей тег виведе посилання на цю сторінку, змінивши мову на обрану.

Категорія

Teг Опис
{category-title} Назва категорії.
{category-description} Опис категорії.
{category-content} Вміст категорії.

Додаткові поля

{field:name}

field - обов'язкове слово, що означає, що це додаткове поле.

name - ім'я додаткового поля, яке задано в адмінці.
{field[src]:image}

Якщо додаткове поле є картинкою, можна вивести лише посилання (оригінальне) зображення, додавши атрибут [src]
{field[src-thumb]:image}

Виведе посилання на зменшену копію завантаженого зображення.
[field_name]...[/field_name]

Виводить вміст між тегами, якщо додаткове поле name заповнено.

field_ - системне слово.

name - ім'я доп поля.
[not-field_name]...[/not-field_name]

Виводить вміст між тегами, якщо додаткове поле name НЕ заповнене.

field_ - системне слово.

name - ім'я доп поля.

Анонс та custom

anons.tpl - шаблон анонсу.

custom.tpl - шаблон кастомних новин за замовчуванням.

У двох шаблонах використовуються ті самі теги.

Teг Опис
{title} Назва посту.
{short} Короткий запис посту.
{link} Посилання на пост.
{see} Кількість переглядів.
{date}
{date-"d.m.Y H:i:s"}

Дата публікації у форматі (d.m.Y).

Можна вказувати формат, наприклад {date-"d.m.Y H:i:s"}
{author-link} Посилання на автора посту.
{author-name} Ім'я аватар автора посту.
{author-avatar} Посилання аватар автора посту.
{poster} Посилання на постер, якщо його вибрано.
{category-title} Назва категорії.
[poster]...[/poster] Виводить вміст, якщо постер був заданий.
[not-poster]...[/not-poster] Виводить вміст, якщо постер не було встановлено.

Додаткові поля

Пост

post.tpl - шаблон посту.

Teг Опис
{title} Назва посту.
{short} Короткий запис посту.
{categories} Список категорій посту.
{category} Посилання на кінцеву категорію.
{category-title} Назва кінцевої категорії.
{category-icon} Значок категорії.
{see} Кількість переглядів.
{date}
{date-"d.m.Y H:i:s"}

Дата публікації у форматі (d.m.Y).

Можна вказувати формат, наприклад {date-"d.m.Y H:i:s"}
{rating} Виведе рейтинг.
{content} Контент посту.
{edit} Посилання на редагування посту.
{comments}

Коментарі.

comments.tpl - файл відповідає за код одного коментаря.
{add-comment} Форма додавання коментаря.
{author-link} Посилання на автора посту.
{author-name} Ім'я аватар автора посту.
{author-avatar} Посилання аватар автора посту.
{poster} Посилання на постер, якщо він вибраний.

Умовні теги

Додавання приставки not- означає зворотну дію, не виводити вміст.
[post=3,10-100]...[/post] Виводить вміст, якщо ID посту підпадає під значення в атрибуті.
[poster]...[/poster] Виводить вміст, якщо постер був заданий.
[not-poster]...[/not-poster] Виводить вміст, якщо постер не було встановлено.
{prev-link} Посилання на попередню новину
{next-link} Посилання на наступну новину
{prev-title} Заголовок попередньої новини
{next-title} Заголовок наступної новини

Додаткові поля

Статична сторінка

page.tpl - Статична сторінка шаблон.

Teг Опис
{id} ID сторінки.
{title} Назва сторінки.
{poster} Посилання на постер, якщо його вибрано. Інакше виводиться шлях /templates/system/img/no-image.svg.
{edit} Посилання на редагування сторінки.
{date}
{date-"d.m.Y H:i:s"}

Дата публікації у форматі (d.m.Y).

Можна вказувати формат, наприклад {date-"d.m.Y H:i:s"}
{content} Вміст сторінки.

Коментарі

comments.tpl - шаблон одного коментаря.

Teг Опис
{id} ID коментаря.
{author-link} Посилання на профіль.
{author-name} Ім'я автора.
{author-avatar} Посилання на аватар.
{date} Дата коментарю у форматі (d.m.Y H:i).
{comment} Текст коментаря.

Профіль користувача

user.tpl - шаблон профілю користувача.

Teг Опис
{name} Ім'я користувача.
{avatar} Аватар користувача.
{registration} дата реєстрації.
{visited} Дата останнього візиту.
{role} Назва групи користувача.
{status} Статус користувача.

Умовні теги

Додавання приставки not- означає зворотну дію, не виводити вміст.
[self]...[/self] Виводить вміст, якщо користувач переглядає свій профіль.
[edit]...[/edit] Обгортка форми редагування профілю.
{edit-name} Поле для редагування імені.
{old-password} Поле для вказівки старого пароля.
{edit-password}

Поле для вказівки нового пароля.

При додаванні даного тега обов'язково додайте тег {old-password}
{edit-avatar} Поле вибору нового зображення для аватара.
{save} Кнопка збереження.

Результат пошуку

search.tpl - шаблон результату пошуку.

Для того, щоб запрацював живий пошук, додайте полю input просто атрибут name="str".

search.tpl - поки що у розробці. Зараз працює за стандартом.

Завантаження файлів

download.tpl - виведення одного посилання на скачування.

downloadPage.tpl - сторінка з виведенням файлу, що скачується.

Teг Опис

download.tpl
{link} Посилання на файл.
{name} ім'я файлу.
{counter} Кількість завантажень.

downloadPage.tpl
[meta:title=Завантаження файлу: {name}] Мета-тег title, який визначається крізь тег. До нього можуть входити інші теги, як показано на прикладі.
[meta:description=Завантаження файлу: {name}] Мета-тег description, який визначається крізь тег. До нього можуть входити інші теги, як показано на прикладі.
{name} Ім'я файл.
{timer} Таймер.
{counter} Кількість завантажень.

Правило для шаблонів

config.json - файл, який має лежати наприкінці шаблону.

{
  "name": "Web",
  "author": "Celena",
  "description": "Шаблон від [b]Celena.io[/b]",
  "1.2.3": "0.0.1",
  "poster": "img/poster.png"
}

Teг Опис
name Назва шаблону.
author Автор шаблону.
description Опис шаблону.
1.2.3 Версія шаблону.
poster Постер шаблону, починаючи з кореня самого шаблону.

Шаблон додаткового поля (фото, назва, значення)

ptv.tpl - файл, що відповідає за формування додаткового поля.

Teг Опис
{title} Назва одного елемента із дод. поля.
{value} Значення одного елемента із дод. поля.
{photo} Фото одного елемента із дод. поля.
[photo]...[/photo] Виводить вміст між тегами, якщо було встановлено зображення.
{new-password}
Loading...