repo_zf1/documentation/manual/ru/module_specs/Zend_Feed-ConsumingAtom.xml

<sect1 id="zend.feed.consuming-atom">
<title>Работа с лентой Atom</title>

    <para>
        <code>Zend_Feed_Atom</code> используется в основном так же, как и
        <code>Zend_Feed_Rss</code>. Он предоставляет те же доступ к свойствам
        ленты и обход сообщений в ленте.  Основное отличие заключается в самой
        структуре ленты по протоколу Atom. Atom является преемником RSS, это более
        обобщенный протокол. Он разработан для более легкой работы с лентами, и
        предоставяет полное информационное содержимое внутри самой ленты, разделив
        для этой цели тег <code>&lt;description&gt;</code> в RSS на два элемента —
        <code>&lt;summary&gt;</code> (анонс) и <code>&lt;content&gt;</code> (содержимое).
    </para>

    <example id="zend.feed.consuming-atom.example.usage">
        <title>Основы использования ленты Atom</title>
        <para>
            Чтение ленты Atom, вывод <code>title</code> и <code>summary</code>
            для каждого сообщения:
        </para>
        <programlisting language="php"><![CDATA[
$feed = new Zend_Feed_Atom('http://atom.example.com/feed/');
echo 'The feed contains ' . $feed->count() . ' entries.' . "\n\n";
foreach ($feed as $entry) {
    echo 'Title: ' . $entry->title() . "\n";
    echo 'Summary: ' . $entry->summary() . "\n\n";
}]]>
        </programlisting>
    </example>

    <para>
        В ленте Atom (элемент <code>&lt;feed&gt;</code>) должны
        присутствовать следующие свойства:
    </para>

    <para>
        <itemizedlist>
            <listitem>
                <para>
                    <code>title</code> — заголовок ленты, аналогичен заголовку RSS-канала
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>id</code> — каждая лента и каждое сообщение в Atom имеют свои
                    уникальные идентификаторы
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>link</code> — лента может иметь одну или несколько ссылок, которые
                    имеют атрибут <code>type</code>
                </para>
                <para>
                    Эквивалентом ссылке в RSS-канале будет <code>type="text/html"</code>. Если
                    ссылка ведет на альтернативную версию того же контента, что представлен
                    в ленте, она должна иметь атрибут <code>rel="alternate"</code>.
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>subtitle</code> — описание ленты, эквивалентен описанию RSS-канала
                </para>
                <para>
                    <code>author->name()</code> — имя автора ленты
                </para>
                <para>
                    <code>author->email()</code> — e-mail автора ленты
                </para>
            </listitem>
        </itemizedlist>
    </para>

    <para>
        Сообщения Atom (элемент <code>&lt;entry&gt;</code>) обычно имеют
        следующие свойства:
    </para>

    <para>
        <itemizedlist>
            <listitem>
                <para>
                    <code>id</code> — уникальный идентификатор сообщения
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>title</code> — заголовок сообщение
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>link</code> — ссылка на альтернативное представление
                    сообщения в другом формате
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>summary</code> — аннотация к содержимому сообщения
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>content</code> — полное содержимое сообщения,
                    может быть пропущен, если лента содержит только аннотации
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>author</code> — с субтегами <code>name</code> и <code>email</code>,
                    как у элемента <code>feed</code>
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>published</code> — дата публикации в формате RFC 3339
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>updated</code> — дата последнего изменения сообщения
                    в формате RFC 3339
                </para>
            </listitem>
        </itemizedlist>
    </para>

    <para>
        Другие ресурсы и дополнительную информацию по Atom ищите на сайте:
        <ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>.
    </para>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->