York ( Слушатель ) | |
28 окт 2008 13:54:28 |
limit | Количество элементов возвращаемых в запросе. Число от 1 до 255. Значение по умолчанию: 5. Например, запрос http://glav.su/forum/index.php?action=.xml;type=rss;limit=10 вернёт 10 последних сообщений со всего форума. |
sa | Тип возвращаемых данных. Возможные значения: recent - получить последние сообщения форума. Значение по умолчанию. news - получить список новых тем. members - получить список последних зарегистрированных пользователей. Примеры: http://glav.su/forum/index.php?action=.xml;type=rss;sa=recent - вернёт 5 последних сообщений со всего форума. Тоже самое, что и http://glav.su/forum/index.php?action=.xml;type=rss. http://glav.su/forum/index.php?action=.xml;type=rss;sa=news - вернёт 5 последних созданных тем со всего форума. Темы возвращаются не за всё время, а за некоторый период, поэтому если за несколько дней на форуме не появилось новых тем, то поток будет пустым. Чтобы увеличить глубину просмотра, можно добавить параметр limit=255: http://glav.su/forum/index.php?action=.xml;type=rss;sa=news;limit=255 - запрос новых тем, но за больший период. Если добавить параметр board или boards, можно ограничить запрос новых тем одним или несколькими разделами, и тем самым повысить глубину просмотра. http://glav.su/forum/index.php?action=.xml;type=rss;sa=members - вернёт данные о 5 последних зарегистрированных пользователях. |
type | Тип возвращаемого потока. Возможные значения: smf - собственный формат от разработчиков форума. Значение по умолчанию. Возвращаемый таким образом XML содержит больше информации, чем при использовании других типов, но не поддерживается существующими RSS-агрегаторами. Поэтому, чтобы его преобразовать в читабельный вид, надо самостоятельно писать XSLT преобразование. rss - RSS 0.92. rss2 - RSS 2.0. atom - Atom. rdf - RDF. Примеры: http://glav.su/forum/index.php?action=.xml;type=rss http://glav.su/forum/index.php?action=.xml;type=rss2 http://glav.su/forum/index.php?action=.xml;type=atom Все потоки выше будут содержить 5 последних сообщений со всего форума но в различных форматах. Какой формат выбрать? Это зависит от того, какой формат поддерживает ваш агрегатор. Я с агрегаторами не разбирался, но думаю, что последнии версии всех агрегаторов поддерживают все перечисленные форматы кроме SMF. Например, Google Reader поддерживает все форматы кроме SMF. Какой формат выбрать из поддерживаемых агрегатором? RDF не рекомендую, т.к. он содержит минимум информации. Для чтения новых сообщений и уведомлений о новых темах через Google Reader лучше выбрать Atom, т.к. в этом формате есть поле с именем автора сообщения/темы, а в RSS и RDF его нет. Для получения списка пользователей через Google Reader подойдёт любой формат, т.к. Google Reader из всех имеющихся полей отображает только имя пользователя. |
board | Идетнификатор отслеживаемого раздела. Для данного форума - это число от 1 до 7. Если этот параметр не задан, то возвращаются сообщения со всего форума. Если параметр задан, то возвращаются только новые сообщения или темы, соданные в данном разделе. Примеры и способ определения идентификатора раздела смотрите ниже. |
boards | Один или несколько идентификаторов разделов разделённых запятыми. Если параметр не задан, то возвращаются сообщения со всего форума. Если параметр задан, то возвращаются только новые сообщения или темы, соданные в указанных разделах. Примеры и способ определения идентификатора раздела смотрите ниже. |
sa | type | limit | board | boards |
recent | * | * | * | N |
recent | * | * | N | * |
news | * | * | N | * |
news | * | * | * | N |
members | * | * | N | N |