Примітка: цикл RUBRIQUES виводить тільки «активні» рубрики, тобто ті, в яких є опубліковані статті, до яких додані файли чи сайти або які містять активні підрубрики. Так зроблено, щоб на сайті не показувалися порожні рубрики. Проте в разі необхідності ви можете вивести «порожні» рубрики, але про це нижче.
Критерії
Для того, щоб вибрати рубрики, які необхідно показати, використовуються наступні критерії:
- {id_rubrique} повертає рубрику з ідентифікатором id_rubrique. Оскільки ідентифікатор рубрики може мати тільки одне значення, то цей критерій виведе тільки одну рубрику (або не виведе нічого).
Примітка: можна вивести кілька рубрик, користуючись критерієм
{id_rubrique IN xxx,yyy,zzz}
- {id_secteur} повертає всі розділи, які знаходяться в секторі з ідентифікатором id_secteur. Також можна використовувати критерій {branche}, який детально описаний в статті ARTICLES. Опис циклу, для виведення всіх підрубрик будь-якого рівня вкладеності.
- {id_parent} виводить список підрубрик, що знаходяться в рубриці, у якої id_parent=#ID_RUBRIQUE. Використовується для виведення підрубрик поточної рубрики.
Поле бази id_parent містить номер батьківської рубрики. Тому щоб вивести вміст певної рубрики, треба вказати її номер у цьому критерії.
Приклад:
Цикл, який виводить підрубрики, вкладені в поточну рубрику.
<BOUCLE_parent(RUBRIQUES) {id_rubrique}>
Рубрика №#ID_RUBRIQUE містить такі підрубрики:
<BOUCLE_children(RUBRIQUES) {id_parent=#ID_RUBRIQUE}>
#TITRE <br />
</BOUCLE_children>
</BOUCLE_parent>Цикл _parent виводить інформацію про поточну рубрику. Насамперед нас цікавить значення #ID_RUBRIQUE, яке ми використовуємо в наступному циклі, щоб вказати, з якої рубрики треба вивести всі дочірні елементи.
- {racine} виводить список рубрик в корені сайту. Повністю ідентично запису {id_parent=0}.
- {id_enfant} повертає рубрику, яка містить підрубрику, номер якої вказаний у критерії id_enfant. Так само можна записати {id_rubrique=#ID_PARENT}. Критерій виводить тільки один запис або нічого у випадку, якщо ця рубрика - коренева.
- {meme_parent} виводить список рубрик, батьківський номер яких (id_parent) такий самий, як у поточної рубрики.
- {id_mot}, {titre_mot=xxx} повертає список рубрик, до яких додано ключ з вказаним номером або ж із заданим ім’ям.
<BOUCLE_rubs(RUBRIQUES) {id_mot=2}>
#TITRE
</BOUCLE_rubs>- {id_groupe}, {type_mot=yyyy} виводить список рубрик, до яких додані ключі з групи ключів з вказаним номером або назвою.
<BOUCLE_rubs(RUBRIQUES) {id_groupe=1}>
#TITRE
</BOUCLE_rubs>- {recherche} виводить список рубрик, які знайдені пошуковою системою SPIP за ключами, заданими в пошуку. Детальніше про роботу пошукової системи.
- {lang} виводить всі рубрики, мова яких дорівнює значенню з оточення (з URL або зовнішнього циклу) або ж головній мові сайту (якщо в оточенні значення lang не задано).
- {tout} виведе всі рубрики, включаючи порожні. Даний фільтр необхідний в дуже специфічних випадках або ж при налагодженні сайту.
Критерії, доступні в SPIP 3
{feuille} дозволяє вивести рубрики без підрубрик - найнижчі елементи дерева рубрик.
{noeud} дозволяє відібрати рубрики, у яких є підрубрики.
{!racine} виводить всі рубрики, крім кореневих. Тобто у яких {id_parent!=0}.
{profondeur=1} виводить рубрики 2-го рівня (0 рівень - це корінь сайту, тобто сектор, 1 рівень - рубрики, які знаходяться в секторі).
Критерії, що використовуються для виведення статей
Ви можете використовувати універсальні критерії.
- {exclus} використовується для того, щоб виключити поточну рубрику з результатів виведення. Корисний з критерієм meme_parent.
Теги для цього циклу
- Теги, що одержуються з бази даних
Інформація, яку виводять дані теги, зберігається в базі даних. Тому їх можна використовувати для сортування виведених елементів (наприклад, {par titre} виведе рубрики з назвами, впорядкованими за алфавітом).
- #ID_RUBRIQUE виводить номер рубрики.
- #TITRE виводить назву рубрики. Починаючи з версії SPIP 3.0 при виведенні назви до неї автоматично застосовується фільтр |supprimer_numero.
- #DESCRIPTIF виводить вміст поля «опис». Поле можна включити в налаштуваннях сайту.
- #TEXTE виводить вміст поля «текст» поточної рубрики.
- #ID_SECTEUR виводить номер сектора, в якому знаходиться поточна рубрика.
- #ID_PARENT виводить номер рубрики, в якій знаходиться поточна рубрика. Якщо у нас рубрика другого рівня вкладеності, то #ID_PARENT==#ID_SECTEUR.
- #LANG виводить мову рубрики.
- Теги, що обчислюються (генеруються)
На відміну від статичних тегів, значення обчислюваних тегів не зберігається в базі даних, а генерується SPIPом. Тому ми не можемо використовувати їх для сортування результатів.
- #NOTES виводить виноски (значення генерується на основі поля «текст» рубрики - SPIP аналізує і знаходить всю інформацію про виноски і виводить її).
- #INTRODUCTION виводить перші 600 символів поля «текст». Детальніше про тег #INTRODUCTION.
- #URL_RUBRIQUE виводить URL сторінки рубрики. Особливості такі ж, як і для #URL_ARTICLE.
- #DATE виводить дату останнього опублікованого елемента у поточній рубриці або її підрубриках - статті, новини, тощо.
- #FORMULAIRE_FORUM виводить форму коментарів до розділу. Більше інформації в статті «Les formulaires».
- #PARAMETRES_FORUM виводить список усіх змінних, необхідних для роботи форми (докладніше. Приклад:
[ <a href="forum.php3?(#PARAMETRES_FORUM)">Залишити коментар</a> ]
- #FORMULAIRE_SITE (починаючи з версії SPIP 1.4 ) виводить форму, яка дозволяє відвідувачам пропонувати посилання на сайти для поточної рубрики. Посилання публікуються тільки після затвердження адміністратором.
Форма виводиться на сайті тільки в тому випадку, якщо в конфігурації сайту включена опція «Каталог сайтів».
Логотипи
- #LOGO_RUBRIQUE виводить логотип рубрики. Якщо додана картинка в поле «Логотип при наведенні мишею» (вмикається в конфігурації системи), то логотип виводиться зі скриптом, який замінює одне лого на інше при наведенні миші.
Якщо рубрика не має логотипу, то виведеться або логотип батьківської рубрики, або рубрики рівнем вище у випадку, якщо у батьківської рубрики теж не буде логотипу.
Синтаксис логотипа:
[(#LOGO_RUBRIQUE|alignment|address)]
Де:
- alignment вирівнювання (left абоright)
- address - URL, на який перейде відвідувач, якщо натисне на логотип.
Починаючи з версії SPIP 2.1 можна використовувати наступний запис:
#LOGO_RUBRIQUE{#URL_RUBRIQUE,left}
Як отримати більше інформації про логотип
Якщо вам необхідно вивести URL логотипу, то ви можете застосувати фільтр |lien:
[ (#LOGO_ARTICLE|lien) ]
А починаючи з версії SPIP 2.1 можна писати так:
[ (#LOGO_ARTICLE*) ]
Якщо вам необхідно вивести назву файлу логотипу, ви можете застосувати фільтр |fichier:
[ (#LOGO_ARTICLE|fichier) ]
А починаючи з версії SPIP 2.1 можна писати так:
[ (#LOGO_ARTICLE**) ]
Всі логотипи зберігаються в корені папки IMG/ і мають фіксовані назви. Для логотипу рубрики назва формується таким чином: rubonXXX.ext, де XXX - номер рубрики, а ext - розширення файлу.
Виведення певного логотипу
І ще два тега, які іноді стають у нагоді (особливо в тих випадках, коли нам необхідно два логотипи для виведення в різних шаблонах):
- #LOGO_ARTICLE_NORMAL виведення зображення логотипу;
- #LOGO_ARTICLE_SURVOL виведення зображення логотипу при наведенні мишкою
Примітка: є новий синтаксис для тегів LOGO_XX