Параметры

Если нас не устраивают параметры вызова сниппета, установленные по умолчанию, их можно изменить в обычном порядке - при вызове сниппета.

Здесь мы приводим сокращенный список параметров - те, которые могут реально потребоваться.  Итак, основные параметры:

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

• &url - Url ленты новостей
• &header - чанк заголовка ленты.
• &item - чанк, отображающий одну новость ленты
• &noitem - чанк, отображающий сообщение об отсутствии новостей - фактически перекрывает разные ошибки.
• &footer - чанк концовки ленты.
• &dateformat (strftime dateformat) - формат отображения даты и времени
• &max - максимальное число отображаемых новостей.
• &cache_enable (true|false) - разрешает или запрещает возможность кэширования.
• &cache_time (number) - время жизни кэша в секундах.

Есть еще несколько "хитрых" параметров, но они скорее для гурманов, которые могут разобраться самостоятельно (extclass, rows, embed).

Плейсхолдеры

При написании упомянутых выше чанков должны использоваться плейсхолдеры (подстановки). Вот их перечень:

 Для header и footer:

[ +title+ ] - Заголовок всей ленты
[ +permalink+ ] - ссылка на ленту
[ +description+ ] - сводная информация о ленте.
[ +description(text)+ ] - сводная информация с удалением всех тегов HTML
[ +description(html)+ ] - сводная информация с удалением тегов HTML за исключением <a> и <img >.
[ +description(type,number)+ ] - сводная информация заданного типа и длины, например:
[ +description(text,300)+ ]
[ +image_title+ ] - заголовок логотипа
[ +image_url(width,height)+ ] - url картинки логотипа с заданными размерами

Есть еще "хитрая" подстановка:

[ +subscribe_xxxx+ ] - специальная "функция подписки". Здесь её мы не описываем, кому надо - прочитает в документации "simplepie API document" .
Мы в чанке заголовка использовали только часть возможных плейсхолдеров.

Для одной новости (item):

[ +title+ ] - заголовок новости
[ +permalink+ ] - URL новости
[ +description+ ] - некая сводка по новости
[ +date+ ] - дата новости
[ +category+ ] - категория
[ +author+ ] - автор.

Мы в чанке новости использовали только часть возможных плейсхолдеров.

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