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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.feed.consuming-atom">
    <title>Einen Atom Feed konsumieren</title>

    <para>
        <classname>Zend_Feed_Atom</classname> wird auf die ziemlich genau selbe Weise verwendet wie
        <classname>Zend_Feed_Rss</classname>. Es stellt die gleichen Zugriffsmöglichkeiten auf
        Eigenschaften auf Feed Ebene und bei der Iteration über Einträge des Feeds bereit. Der
        Hauptunterschied ist die Struktur des Atom Protokolls selber. Atom ist ein Nachfolger von
        <acronym>RSS</acronym>; es ist ein mehr verallgemeinertes Protokoll und es wurde gestaltet,
        um einfacher mit Feeds umzugehen, die ihren kompletten Inhalt innerhalb des Feeds bereit
        stellen, indem für diesen Zweck der <property>description</property> Tag von
        <acronym>RSS</acronym> in die zwei Elemente <property>summary</property> und
        <property>content</property> aufgeteilt wird.
    </para>

    <example id="zend.feed.consuming-atom.example.usage">
        <title>Grundlegende Verwendung eines Atom Feeds</title>

        <para>
            Lese einen Atom Feed und gebe <property>title</property> und
            <property>summary</property> jedes Eintrages aus:
        </para>

        <programlisting language="php"><![CDATA[
$feed = new Zend_Feed_Atom('http://atom.example.com/feed/');
echo 'Der Feed enthält ' . $feed->count() . ' Einträge.' . "\n\n";
foreach ($feed as $entry) {
    echo 'Überschrift: ' . $entry->title() . "\n";
    echo 'Zusammenfassung: ' . $entry->summary() . "\n\n";
}
]]></programlisting>
    </example>

    <para>
        In einem Atom Feed kannst du die folgenden Feed-Eigenschaften erwarten:
    </para>

    <itemizedlist>
        <listitem>
            <para>
                <property>title</property> - Die Überschrift des Feeds, gleichbedeutend mit der
                Überschrift eines <acronym>RSS</acronym> Channels
            </para>
        </listitem>

        <listitem>
            <para>
                <property>id</property> - Jeder Feed und Eintrag hat in Atom einen einzigartige
                Bezeichner
            </para>
        </listitem>

        <listitem>
            <para>
                <property>link</property> - Feeds können mehrere Links enthalten, welche durch
                ein <property>type</property> Attribut ausgezeichnet werden
            </para>

            <para>
                In einem <acronym>RSS</acronym> Channel wäre dies gleichbedeutend mit
                <command>type="text/html"</command>. Wenn der Link auf eine alternative Version
                des selben Inhalts verweist, der nicht im Feed enthalten ist, würde es ein
                <command>rel="alternate"</command> Attribut enthalten.
            </para>
        </listitem>

        <listitem>
            <para>
                <property>subtitle</property> - Die Beschreibung des Feeds, gleichbedeutend mit
                der Beschreibung eines <acronym>RSS</acronym> Channels
            </para>

            <para><property>author->name()</property> - Der Name des Autoren des Feeds</para>

            <para>
                <property>author->email()</property> - Die E-Mail Adresse des Autoren des Feeds
            </para>
        </listitem>
    </itemizedlist>

    <para>
        Atom Einträge haben normalerweise folgende Eigenschaften:
    </para>

    <itemizedlist>
        <listitem>
            <para><property>id</property> - Der einzigartige Bezeichner des Eintrags</para>
        </listitem>

        <listitem>
            <para>
                <property>title</property> - Die Überschrift des Eintrags, gleichbedeutend mit
                der Überschrift eines <acronym>RSS</acronym> Eintrags
            </para>
        </listitem>

        <listitem>
            <para>
                <property>link</property> - Ein Link zu einem anderen Format oder einer
                alternativen Ansicht diesen Eintrags
            </para>
        </listitem>

        <listitem>
            <para>
                <property>summary</property> - Eine Zusammenfassung des Inhalts dieses Eintrags
            </para>
        </listitem>

        <listitem>
            <para>
                <property>content</property> - Der komplette Inhalt des Eintrags; kann
                übersprungen werden, wenn der Feed nur Zusammenfassungen enthält
            </para>
        </listitem>

        <listitem>
            <para>
                <property>author</property> - Mit <property>name</property> und
                <property>email</property> Unter-Tags wie den Feeds
            </para>
        </listitem>

        <listitem>
            <para>
                <property>published</property> - Das Datum, an dem der Eintrag veröffentlicht
                wurde, im <acronym>RFC</acronym> 3339 Format
            </para>
        </listitem>

        <listitem>
            <para>
                <property>updated</property> - Das Datum, an dem der Eintrag das letzte Mal
                geändert wurde, im <acronym>RFC</acronym> 3339 Format
            </para>
        </listitem>
    </itemizedlist>

    <para>
        Für weitere Informationen über Atom und unzähligen anderen Quellen, besuche
        <ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>.
    </para>
</sect1>