SPIP

RUBRIQUES. Описание цикла

Serge Markitanenko — 2013-05-18T20:04:54Z

La boucle RUBRIQUES цикл используется для отбора и вывода списка разделов (неожиданно, правда?)

Примечание. Цикл 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 содержит номер родительского раздела. Поэтому что бы вывести содержимое конкретного раздела, надо указать его номер в этом критерии.

Пример.

Цикл, который выводит подразделы, вложенные в текущий раздел.


 Раздел №#ID_RUBRIQUE содержит такие подразделы:
 
 #TITRE

Цикл _parent выводит информацию о текущем разделе. Более всего нас интересует значение #ID_RUBRIQUE, которое мы используем в следующем цикле, что бы указать, для какого раздела надо вывести все дочерние элементы.

- {racine} выводит список разделов в корне сайта. Полностью идентично записи {id_parent=0}.

- {id_enfant} возвращает раздел, который содержит подраздел, номер которого указанный в критерии id_enfant. Так же можно записать как {id_rubrique=#ID_PARENT}. Критерий выводит только одну запись или ничего, в случае если этот раздел - корневой.

- {meme_parent} выводит список разделов, у которых номер родителя (id_parent) такой же как у текущего раздела.

- {id_mot}, {titre_mot=xxx} возвращает список разделов, к которым добавлен ключ с указанным номером или же с заданным названием.


 #TITRE

- {id_groupe}, {type_mot=yyyy} выводит список разделов, к которым добавлены ключи из группы ключей с указанным номером или названием.


 #TITRE

- {recherche} выводит список разделов, которые найдены поисковой системой SPIP по ключевым словам, заданным в поиске. Подробнее о работе поисковой системы. О проблеме с кирилическим поиском в статье ARTICLES. Описание цикла.

- {lang} выводит все разделы, язык которых равен значению из окружения (из URL или внешнего цикла) или же главному языку сайта (если в окружении значение lang не задано.

- {tout} выведет все разделы, включая пустые разделы.
- Однако, данный фильтр необходим в очень специфических случаях или же при отладке сайта.

Критерии, доступные в SPIP 3

{feuille} позволяет вывести разделы без подразделов - самые нижние элементы дерева разделов.

{noeud} позволяет отобрать разделы у которых есть подразделы.

{!racine} выводит все разделы, кроме корневых. Т.е. у которых {id_parent!=0}.

{profondeur=3} выводит разделы 3го уровня (0 уровень - это корень сайта, 1 уровень - сектора, 2 и больше - все остальные разделы) .

Критерии, используемые для вывода статей

Вы можете использовать универсальные критерии.

- {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 выводит список всех переменных, необходимых для работы формы (подробнее. Пример:

[ Оставить комментарий ]

- #FORMULAIRE_SITE (since 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 вывод изображения логотипа при наведении мышкой

[SPIP 2.1]

Note: there is a new syntax for the LOGO_XX tags.

ARTICLES. Описание цикла

Serge Markitanenko — 2013-05-16T18:35:51Z

Данный цикл используется для вывода статей из базы данных. Он обозначается при помощи слова ARTICLES (не забываем добавить “S” в конце слова) в круглых скобках.

<BOUCLEn(ARTICLES){criterion...}>

Примечание. Цикл ARTICLES по умолчанию выводит только статьи со статусом "опубликована". Для того, что бы показать статьи с другими статусами ("готовится", "утверждается" и т.д.) необходимо воспользоваться специальным критерием.

Критерии, используемые для выбора статей

Приведенные критерии можно использовать для выбора статей из базы данных:

- {tout}, (переводится с французского как "все"), покажет все статьи из всех разделов (rubriques) существующих на сайте со статусом "опубликовано". Критерий полезен, если необходимо показать свежие статьи, которые опубликованы на сайте.

- {id_article} возвращает статью, у которой номер соответствует id_article. Так как номер каждой статьи уникальный, данный фильтр вернет только одну статью или же ничего.

Если критерий задан как {id_article}, то SPIP попробует взять значение из окружения (из URL или внешнего цикла. В случае, если в окружении значение id_article не задано, то критерий интерпретируется как {id_article=0}. Так как статьи с таким номером нет, но и результат цикла будет нулевой.

Если значение критерия задать явно {id_article=1}, то SPIP попробует вывести статью с номером 1.

Если необходимо вывести несколько статей, то данный критерий можно расширить при помощи оператора IN - {id_article IN xxx,xxx ...}.

- {id_rubrique} возвращает все статьи из заданного раздела(rubrique).

- {id_secteur} возвращает все статьи из заданного сектора. Сектор - раздел который находится в корне сайта, у него id_parent=0. Статьи выводятся не только из раздела, но и из всех его подразделов, вне зависимости от уровня вложенности.

- {branche} выводит все статьи из текущего раздела и его подразделов. Однако, этот критерий надо использовать только при условии, если текущий раздел задается окружением, явно задать значение критерия нельзя. Обычно это выглядит так:


 
 #TITRE

В версиях SPIP до 3.х.х нельзя задавать значения критерия напрямую: {branche=2} работать не будет. В более поздних версиях - надо проверить :))).

Этот критерий надо использовать аккуратно, если структура сайта спроектирована правильно, то в нем нет необходимости, но он часто необходим при организации вывода каталогов товаров или услуг.

- {id_auteur} возвращает список статей указанного автора (статьи, созданные указанным пользователем).

- {id_mot} возвращает список статей, которым добавлен указанный ключ. Ключи - это аналог меток, позволяют группировать статьи по дополнительным признакам.

- {titre_mot=xxxx} или {type_mot=yyyy} возвращает список статей, название ключа у которых соответствует “xxxx” или же статьи, к которым добавлены ключи из группы с названием “yyyy”. Однако, нельзя использовать несколько критериев {titre_mot=xxxx} или {type_mot=yyyy} в одном и том же цикле.

- {id_groupe=zzzz} возвращает все статьи, ключи которых находятся в группе с номером "zzzz". [Замечание: критерий не совместим с критерием {type_mot=yyyy} и их нельзя использовать в одном цикле.]

- {lang} возвращает статьи, написанные на заданном языке. Надо понимать, что SPIP не умеет автоматически распознавать язык, на котором написана статья - язык статьи, это опция, которая определяется опцией "Главный язык сайта" в настройках CMS, или же задаются в опциях раздела/статьи, если на сайте включен режим многоязычности.

- {date} (или {date=...} или {date==...}) возвращает все статьи согласно текущей дате или же дате, полученной из URL. На самом деле работа с датами и временем требует отдельно вдумчивого изучения, подробная информация тут.

- {recherche} выводит статьи, согласно заданному критерию поиска. Поиск выполняется отдельной подсистемой SPIP, но начиная с версии 2.0 и включая текущую 3.0.х поисковая система не умеет искать слова в кирилице. Подробная информация о системе поиска, для того, что бы исправить проблему с поиском на кирилице можно использовать этот плагин.

Вывод статей в зависимости от статуса

Для отбора статей по статусу используется критерий status. Необходимо помнить, что по умолчанию, выводятся только опубликованные статьи. {statut IN prop,prepa,publie,refuse,poubelle} - выводит все статьи. Значения статусов: готовится (prepa), на утверждении (prop), опубликовано (publie), отказано (refuse), удалено (poubelle).

{statut=prepa) выводит статьи, со статусом "готовится".

Критерии, используемые для вывода статей

Вы можете задавать количество статей, которые необходимо вывести, определять порядок вывода и многое другое. C циклом (ARTICLES) можно использовать практически все универсальные критерии.

- {exclus} позволяет исключить данную статью из списка результатов.

Информация для нижеприведенных тегов берется из базы данных (в отличии от "расчитываемых" тегов - это понятие будет раскрыто немного позже).Все теги, получаемые из базы можно использовать для сортировки You can also use them as sorting criterion (for example, {par titre} by title or {par date} по дате).

- #ID_ARTICLE возвращает номер статьи (id - уникальный идентификатор в базе данных). Полезен, если необходимо передать номер статьи в произвольный шаблон. Например, у вы сделали шаблон page.html для отображения версии страницы для печати, тогда ссылка на страницу в шаблоне будет выглядеть так:

версия для печати

- #SURTITRE выводит содержимое поля главное название статьи. Поле включается в настройках системы.

- #TITRE выводит название статьи. Тег использует практически во всех циклах для отображения названия объекта, который выводится из базы.

- #SOUSTITRE выводит поле "подзаголовок", поле включается в настройках системы.

- #DESCRIPTIF выводит поле "описание". Поле включается в настройках системы. Используется так же в циклах (RUBRIQUES), (MOTS).

- #CHAPO выводит поле "введение" в статье. Поле включается в настройках системы.

- #TEXTE выводит основной текст статьи. Так же используется для вывода этого поля в цикла (RUBRIQUES), (MOTS) и других.

- #PS выводит содержимое поля "пост-скриптум". Поле включается в настройках системы.

- Вывод дат: работа с тегами #DATE, #DATE_REDAC, #DATE_MODIF подробно описана в отдельной статье.

- #ID_RUBRIQUE выводит номер раздела: номер раздела в цикле (RUBRIQUES) или номер раздела, в котором находится статья в цикле (ARTICLES).

- #ID_SECTEUR выводит номер сектора, в котором находится статья или раздел. Сектор - это раздел сайта, который находится в корне, у которого id_parent=0.

Теги #NOM_SITE и #URL_SITE отвечают за вывод поля "гиперссылка", которое включается в настройках сайта. #NOM_SITE - название сайта, a #URL_SITE за ссылку.

- #VISITES выводит количество просмотров статьи.

- #POPULARITE выводит рейтинг посещаемости статьи в процентах.Подробнее в отдельной статье.

- #LANG выводит язык статьи или раздела.

Вычисляемые (генерируемые) теги

- #NOTES выводит сноски (значение генерируется на основе текста статьи - SPIP анализирует и находит всю информацию о сносках и выводит ее).

- #INTRODUCTION: тег выводит поле описание(#DESCRIPTIF),а если его нет - то показывает первые 600 символов статьи (из полей #CHAPO и #TEXTE). Подробнее.

- #LESAUTEURS выводит список авторов данной статьи. Имя автора (#NOM) выводится как ссылка на страницу его профиля (auteur.html). Тег позволяет вывести авторов статьи без построения дополнительного цикла AUTEURS.

- #PETITION выводит текст подписи, если таковой существует.

Данный функционал используется крайне редко, поэтому если необходима более подробная информация по этому тегу - можно обратится к английской версии статьи.

- #URL_ARTICLE выводит URL текущей статьи, подробнее.

- #FORMULAIRE_FORUM выводит форму комментариев к текущей статье.

- #FORMULAIRE_SIGNATURE выводит форму по сбору подписей к статье.

- #PARAMETRES_FORUM выводит список всех параметров необходимых для работы формы (подробнее. Пример:

[ Оставить комментарий ]

Логотипы

- #LOGO_ARTICLE выводит логотип статьи. Если добавлена картинка в поле "Логотип при наведении мышкой" (включается в настройках системы), то логотип выводится со скриптом, который заменяет одно лого на другое при наведении мышки.

- #LOGO_ARTICLE_RUBRIQUE выводит логотип статьи, а если его нет - то логотип раздела.

- #LOGO_RUBRIQUE выводит лого раздела.

Пример вывода лого статьи:

[ (#LOGO_ARTICLE|alignment|address) ]

Alignment (выравнивание) может быть left(по левому краю) или right(по правому). Address - это URL на который можно перейти, если нажать на картинку. Если это значение не указать, то лого будет некликабельным.

В чистом виде тег выводит уже готовый HTML код, но в ряде случаев необходимо вывести название файла, например, что бы указать в качестве фона в таблице. Для этого можно использовать фильтр |fichier следующим образом: [ (#LOGO_ARTICLE|fichier) ]

- #LOGO_ARTICLE_NORMAL вывод изображения логотипа
- #LOGO_ARTICLE_SURVOL вывод изображения логотипа при наведении мышкой

#SESSION

Serge Markitanenko — 2013-05-12T19:05:44Z

#SESSION, выводит информацию, хранимую в сессии, отдельно для каждого посетителя сайта. Используется для ограничения доступа и хранения дополнительной информации ( например, список последних просмотренных статей, статьи для сравнения).

По умолчанию в SPIP сессии хранятся следующие значения:

id_auteur: уникальный идентификатор пользователя
nom: имя пользователя (#NOM)
bio: текст о себе (#BIO)
email: емейл автора
nom_site: название сайта автора
url_site: URL сайта автора
login: логин
statut: группа пользователя - 0minirezo (администраторы и ограниченные администраторы), 1comite (автора), 6forum (посетители)
maj: время и дата последнего обновления профиля автора
pgp: PGP ключ автора
en_ligne: время и дата предыдущего входа в систему пользователя
imessage: 'oui' если пользователь отправил личное сообщение
messagerie:
prefs: настройки административной части пользователя
- couleur => 1 to 6, цвет
- display => 1 (только текст) ; 2 (иконки и текст) ; 3 (только иконки)
- cnx => пустое значение или 'perma' (если "запомнить на несколько дней" активировано)
cookie_oubli: хеш замещающего куки (помоему связано с восстановлением пароля, но могу ошибаться) или пустое значение
source: 'spip' или 'ldap' - источник аутентификации
lang: язык административной части сайта
extra: список дополнительных полей для профиля автора
auth: тип аутентификации (spip, ldap)
cookie: 'oui' если авторизирован при помощи куки, значения не существует, если другой тип подключения (incl. PHP_AUTH_USER)
hash_env: внутренний хеш - идентифицирующий сессию пользователя
ip_change: FALSE до тех пор, пока IP пользователя не изменился. TRUE если IP изменился. SPIP пересоздает новую сессию если подключенный пользователь сменил свой адрес.

Примеры

Показать определенный текст только администратору:

[(#SESSION{statut}|=={0minirezo}|oui) Этот текст увидят только администраторы или ограниченные администраторы]

Такая же техника позволяет нам показывать определенные поля определенной группе пользователей:

[(#SESSION{statut}|=={0minirezo}|oui) #DESCRIPTIF]

Если объем кода большой,или есть необходимость вызвать цикл, то этот код выносят в отдельный файл, например в reserved.html :

[(#SESSION{statut}|=={0minirezo}|oui) ]

Работа с другими тегами

Тег хорошо работает в связке с #AUTORISER.
Вы можете сохранять свои значения в сессию при помощи тега #SESSION_SET

Построение условий при помощи плагина Bonux

Замечательный плагин SPIP Bonux позволяет нам использовать синтаксис цикла для записи условий.

Предположим, что нам необходимо вывести название раздела в шаблоне article.html только для авторизированных пользователей (администратор, редакторов и просто посетителей). Код будет выглядеть следующим образом:


  #TITRE


При традиционной записи нам бы пришлось создать дополнительный файл для цикла _titre, но чем больше файлов, тем сложнее управлять проектом в дальнейшем. Использование цикла (CONDITION) позволяет обойтись без этого.



#PARAMETRES_FORUM
Serge Markitanenko — 2013-05-12T15:49:57Z
- #PARAMETRES_FORUM генерирует и выводит список переменных формы, которые позволяют оставлять комментарий к статье. Пример:

[Оставить комментарий] 

Так же вы можете передать в тег параметр, который указывает на какую страницу SPIP должен перевести пользователя, после того, как сообщение было отправлено. Пример: 
 Оставить комментарий

переведет пользователя на текущую страницу, после того, как (...)


-
Теги

/ 
BOUCLE(ARTICLES), 
#PARAMETRES_FORUM, 
Balises calculées


#FORMULAIRE_FORUM
Serge Markitanenko — 2013-05-12T15:38:51Z
- #FORMULAIRE_FORUM генерирует и выводит форму для комментариев к статье. Более подробная информация о формах: "Forms".


-
Теги

/ 
BOUCLE(ARTICLES), 
#FORMULAIRE_FORUM, 
Balises calculées


#FORMULAIRE_SIGNATURE
Serge Markitanenko — 2013-05-12T15:31:22Z
- #FORMULAIRE_SIGNATURE генерирует и выводит форму, которая используется для того, что бы оставить подпись к статье (есть такой функционал - подписаться под статьей, выразим тем самым ей поддержку).


-
Теги

/ 
BOUCLE(ARTICLES), 
#FORMULAIRE_SIGNATURE, 
Balises calculées


#PETITION
Serge Markitanenko — 2013-05-12T15:28:52Z
- #PETITION выводит текст подписи, если таковой существует.

Данный функционал используется крайне редко, поэтому если необходима более подробная информация по этому тегу - можно обратится к английской версии статьи.


-
Теги

/ 
BOUCLE(ARTICLES), 
#PETITION, 
Balises calculées


#LESAUTEURS
Serge Markitanenko — 2013-05-12T15:25:07Z
- #LESAUTEURS выводит список авторов данной статьи. Имя автора (#NOM) выводится как ссылка на страницу его профиля (auteur.html). Тег позволяет вывести авторов статьи без построения дополнительного цикла AUTEURS.


-
Теги

/ 
BOUCLE(ARTICLES), 
#LESAUTEURS, 
Balises calculées


#INTRODUCTION
Serge Markitanenko — 2013-05-12T15:21:37Z
- #INTRODUCTION тег выводит поле описание(#DESCRIPTIF),а если его нет - то показывает первые 600 символов статьи (из полей #CHAPO и #TEXTE).
		При выводе этого тега убирается все форматирование, например выделение курсивом и полужирным.
 Если вы хотите изменить количество символов, которое выводится по умолчанию, то в передайте новое количество символов в качестве параметра тегу #INTRODUCTION{300} - выведет не 600, а 300 символов.
 Если необходимо вручную задать часть текста, которая должна выводится при помощи этого тега, то необходимо использовать директиву и выделить необходимую часть текста при помощи  и :
La foule des bourgeois et des bourgeoises s'acheminait donc de toutes parts dès le matin, maisons et boutiques fermées, vers l'un des trois endroits désignés. Chacun avait pris parti, qui pour le feu de joie, qui pour le mai, qui pour le mystère. Il faut dire, à l'éloge de l'antique bon sens des badauds de Paris, que la plus grande partie de cette foule se dirigeait vers le feu de joie, lequel était tout à fait de saison, ou vers le mystère, qui devait être représenté dans la grand'salle du Palais bien couverte et bien close, et que les curieux s'accordaient à laisser le pauvre mai mal fleuri grelotter tout seul sous le ciel de janvier dans le cimetière de la chapelle de Braque.

_ {(v.hugo)}
Из приведенного примера тег #INTRODUCTION покажет только "Chacun avait pris parti, qui pour le feu de joie, qui pour le mai, qui pour le mystère."
 В случае, если текст статьи превышает 600 символов, то после вывода текста #INTRODUCTION добавит троеточие, что бы показать, что у текста есть продолжение((...)).
Можно изменить символы ((...)), которые выводятся после #INTRODUCTION. Для этого в файле mes_options.php file необходимо изменить значение константы:
define('_INTRODUCTION_SUITE', ' текст вместо троеточия');


#NOTES
Serge Markitanenko — 2013-05-12T09:11:20Z
#NOTES выводит сноски к статье (такого поля нет в базе данных, вывод генерируется на основе анализа поля #TEXTE).


-
Теги

/ 
BOUCLE(ARTICLES), 
#NOTES, 
Balises calculées