Теги Evolution
Вступ
У шаблонах Evolution CMS використовуються різні теги, які служать для формування контенту. Теги дають простий, але ефективний спосіб включати в контент веб-сторінки різні дані.
Види використовуваних тегів
- [[snippet]] - результат роботи кешувального сніпета.
- [!snippet!] - те саме, але без кешування
- [(setting)] - будь-яке значення з налаштувань сайту. Найчастіше використовується щось на зразок [(site_name)].
- [*resourceField*] - ТВ-параметр або поле ресурсу
- [^timing^] - час виконання скриптів
- [ ~ link ~ ] - посилання на ресурс
- {{chunk}} - чанк
- [+placeholder+] - плейсхолдер
Сніпети
Сніпети - це просто PHP-код, вихід якого відображається в місці розміщення тега сніпета.
Щоб виконати сніпет, вставте його в документі, чанкі або шаблоні, де потрібно відобразити висновок результатів його роботи.
Налаштування
У тегах налаштувань знаходяться параметри системи. Наприклад, [(site_name)] вставить ім'я сайту. Це часто використовується в заголовках сторінок.
Список налаштувань можна знайти в базі даних Evolution в таблиці PREFIX_system_settings, де PREFIX це префікс ваших таблиць.
Список налаштувань:
- [(allow_duplicate_alias)] - дозволені чи ні повторювані псевдоніми при використанні дружніх URL
- [(automatic_alias)] - чи генеруються псевдоніми документів на основі заголовків сторінок автоматично
- [(base_url)] або [(site_url)] - адреса сайту
- [(cache_default)] - документ 'кешувальний' за замовчуванням
- [(captcha_words)] - слова, які використовуються для налаштування Captcha
- [(custom_contenttype)] - розділений комами список типів вмісту, що обслуговується MODx
- [(default_template)] - ідентифікатор шаблону використовується за замовчуванням для нових документів
- [(editor_css_path)] - шлях до CSS-файлу використовується візуальним редактором
- [(emailsender)] - основна адресу електронної пошти на сайті
- [(emailsubject)] - тема листа підтвердження реєстрації веб-користувачів
- [(error_page)] - ідентифікатор сторінки помилки '404'
- [(etomite_charset)] або [(modx_charset)] - кодування сайту
- [(fck_editor_autolang)] - вказує, чи встановлений FCKeditor для автоматичного визначення мови
- [(fck_editor_style)] - вказує стиль використаний в FCKeditor
- [(fck_editor_toolbar)] - вказує на призначену для користувача панель інструментів, додану в FCKeditor
- [(filemanager_path)] - коренева папка для доступу файлового менеджера MODx
- [(friendly_alias_urls)] - чи використовуються псевдоніми в дружніх URL
- [(friendly_urls)] - чи використовуються дружні URL
- [(friendly_url_prefix)] - префікс для дружніх URL
- [(friendly_url_suffix)] - суфікс для дружніх URL
- [(manager_language)] - мова системи управління
- [(manager_theme)] - шаблон системи управління
- [(number_of_logs)] - кількість записів протоколу на одній сторінці
- [(number_of_messages)] - кількість повідомлень на одній сторінці
- [(number_of_results)] - кількість елементів, що відображаються в списках і результатах пошуку
- [(publish_default)] - публікація нових ресурсів після створення за замовчуванням
- [(rb_base_dir)] - фізичний шлях до папки файлів
- [(rb_base_url)] - адреса (URL) папки файлів
- [(search_default)] - нові ресурси після створення доступні для пошуку за замовчуванням
- [(server_offset_time)] - поправка (кількість годин) між часом на місці вашого перебування та на місці знаходження сервера
- [(server_protocol)] - HTTP або HTTPS (SSL) з'єднання
- [(settings_version)] - версія системи
- [(signupemail_message)] - повідомлення, яке надсилатиметься менеджерам, коли створюється обліковий запис нового менеджера
- [(site_name)] - Назва сайту
- [(site_start)] - ідентифікатор стартової сторінки
- [(site_status)] - статус сайту online (1) або offline (0)
- [(site_unavailable_message)] - повідомлення, що виводиться в разі недоступності сайту (коли обраний статус 'Оффлайн') або в разі виникнення помилки. Це повідомлення виводиться тільки в тому випадку, коли не вибрана сторінка 'Сайт недоступний'
- [(site_unavailable_page)] - ідентифікатор ресурсу, який повинні будуть побачити відвідувачі, якщо спробують зайти на сайт, коли він недоступний
- [(strip_image_paths)] - використовуються абсолютні або відносні посилання для зображень, файлів, анімації і т.д.
- [(top_howmany)] - кількість кращих показників в звітах статистики
- [(track_visitors)] - реєструвати відвідування
- [(udperms_allowroot)] - дозволити користувачам створювати ресурси в кореневій папці
- [(unauthorized_page)] - ID ресурсу, який повинні будуть побачити відвідувачі, якщо спробують зайти на закриту сторінку (403 - доступ заборонений)
- [(upload_files)] - розділений комами список розширень файлів, які можуть бути завантажені через файловий менеджер
- [(upload_maxsize)] - максимальний розмір файлів в байтах
- [(use_alias_path)] - використовуються вкладені URL
- [(use_captcha)] - використовувати код CAPTCHA при авторизації
- [(use_editor)] - використовувати HTML-редактор
- [(use_udperms)] - права доступу юзера
- [(webpwdreminder_message)] - повідомлення, яке надсилатиметься веб-користувачам, коли вони запитують нагадування пароля
- [(websignupemail_message)] -повідомлення, яке надсилатиметься веб-користувачам, коли створюється обліковий запис нового веб-користувача
- [(which_editor)] - використовуваний HTML-редактор
Поля ресурсів
Теги ресурсів можуть відображати основні атрибути ресурсів, які знаходяться в базі даних в таблиці PREFIX_site_content.
Це найбільш часто використовувані теги ресурсу:
- [*pagetitle*] - назва документу
- [*longtitle*] - довга назва документа
- [*introtext*] - зведення документа
- [*content*] - зміст документа
Змінні шаблону
ТВ-параметри - це потужний спосіб вставки блоків контенту, характерних для відображуваної сторінки.
ТВ-параметри можуть бути налаштовані для конкретного документа.
Таймінг
В Evo є кілька тегів часу:
- [^qt^] - час на запити до бази даних
- [^q^] - запитів до бази даних
- [^p^] - час на роботу PHP скриптів
- [^t^] - загальний час на генерацію сторінки
- [^s^] - джерело вмісту (база або кеш)
- [^m^] - розмір кеша (опціонально)
Посилання
Щоб вставити посилання на інший документ, просто помістіть номер ідентифікатора документа в тег посилання. Наприклад, [~ 123 ~] створить посилання на документ з ідентифікатором 123.
Чанки
В шматках міститься простий текст, зазвичай HTML-код, який буде просто вставлений на сторінку.
Вони дуже зручні для зберігання загального вмісту. Наприклад, якщо футер містить номер телефону, а номер змінюється, вам потрібно внести зміни тільки в чанк, а не на кожну сторінку сайту.
Плейсхолдери
Найбільш часто плейсхолдери потрібні для темізаціі виведення сніпета.
<div class="nl_summaryPost">
<h3><a href="[+id+]">[+title+]</a></h3>
<div>[+summary+]</div>
<p>[+link+]</p>
<div style="text-align:right;">by <strong>[+author+]</strong> on [+date+]</div>
</div>
Плейсхолдери можуть використовуватися де завгодно в будь-якому HTML-коді.
Хорошим прикладом цього є сніпет Persinalize. Він просто повертає ім'я веб-користувача в плейсхолдер.
Але ви можете помістити сніпет один раз в свій шаблон або документ, а потім помістити плейсхолдер в стільки місць, скільки захочете, наприклад, в привітанні у верхній частині сторінки і в розділі «вихід із системи».
Комбінуйте!
Використовуючи комбінації фрагментів, ТВ-параметрів і чанків, ви можете зробити свій сайт досить гнучким! Наприклад, у вас може бути сніпет, результати роботи якого будуть залежати від переданих ТВ-параметрів, а зовнішній вигляд буде темізуватись чанками з плейсхолдерамі всередині.
Детальніше про всі види тегів і їх використання ви можете прочитати в документації розробника.