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

<sect1 id="zend.feed.consuming-atom">
<title>Odbieranie danych z kanału informacyjnego Atom</title>

    <para>
        <code>Zend_Feed_Atom</code> jest używany w prawie taki sam sposób jak
        <code>Zend_Feed_Rss</code>. Zapewnia taki sam dostęp do właściwości samego
        kanału i taką samą iterację po wpisach w kanale. Główną różnicą jest sama
        struktura protokołu Atom. Atom jest następcą RSS; jest bardziej uogólnionym
        protokołem i jest zaprojektowany aby łatwiej radzić sobie z kanałami, które
        ukazują cała swoją zawartość wewnątrz pliku RSS dzieląc standardowy tag
        RSS <code>description</code> na dwa elementy, <code>summary</code> oraz
        <code>content</code>.
    </para>

    <example id="zend.feed.consuming-atom.example.usage">
        <title>Podstawowe użycie kanału Atom</title>
        <para>
            Odczytywanie kanału Atom i wyświetlenie pól <code>title</code> i
            <code>summary</code> dla każdego z wpisów:
        </para>
        <programlisting role="php"><![CDATA[
$feed = new Zend_Feed_Atom('http://atom.example.com/feed/');
echo 'Kanał zawiera ' . $feed->count() . ' wpisów.' . "\n\n";
foreach ($feed as $entry) {
    echo 'Tytuł: ' . $entry->title() . "\n";
    echo 'Opis: ' . $entry->summary() . "\n\n";
}
]]>
        </programlisting>
    </example>

    <para>
        W kanałach Atom możesz się spodziewać następujących właściwości:
    </para>

    <para>
        <itemizedlist>
            <listitem>
                <para><code>title</code> - Tytuł kanału, taki sam jak tytuł kanału RSS.</para>
            </listitem>
            <listitem>
                <para><code>id</code> - Każdy arkusz i wpis mają unikalny identyfikator.</para>
            </listitem>
            <listitem>
                <para><code>link</code> - Arkusze mogą mieć wiele odnośników, które
                są rozróżnianie za pomocą atrybutu <code>type</code>.</para>
                <para>
                    Odpowiednikiem odnośnika kanału RSS byłby odnośnik o typie
                    <code>type="text/html"</code>. Jeśli odnośnik kieruje do
                    alternatywnej wersji zawartości arkusza, może on otrzymać
                    atrybut <code>rel="alternate"</code>.
                </para>
            </listitem>
            <listitem>
                <para><code>subtitle</code> - Opis arkusza odpowiadający opisowi
                kanału RSS.
                </para>
                <para><code>author->name()</code> - Nazwa autora arkusza.</para>
                <para><code>author->email()</code> - Adres email autora arkusza.</para>
            </listitem>
        </itemizedlist>
    </para>

    <para>
        Składniki wpisu kanału Atom:
    </para>

    <para>
        <itemizedlist>
            <listitem>
                <para><code>id</code> - Unikalny identyfikator wpisu.</para>
            </listitem>
            <listitem>
                <para><code>title</code> - Tytuł wpisu, taki sam jak tytuł w RSS</para>
            </listitem>
            <listitem>
                <para><code>link</code> - Odnośnik do innego formatu lub do
                alternatywnej wersji wpisu.</para>
            </listitem>
            <listitem>
                <para><code>summary</code> - Podsumowanie zawartości wpisu.</para>
            </listitem>
            <listitem>
                <para><code>content</code> - Cała zawartość wpisu; może być pominięta
                jeśli arkusz zawiera tylko skróty informacji.</para>
            </listitem>
            <listitem>
                <para><code>author</code> - z pod-tagami <code>name</code> oraz
                <code>email</code> jak w arkuszach RSS</para>
            </listitem>
            <listitem>
                <para><code>published</code> - data publikacji wpisu w formacie
                RFC 3339.</para>
            </listitem>
            <listitem>
                <para><code>updated</code> - data ostatniej aktualizacji wpisu w
                formacie RFC 3339.</para>
            </listitem>
        </itemizedlist>
    </para>

    <para>
        Więcej informacji o Atom znajdziesz na stronie
        <ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>.
    </para>
</sect1>