repo_zf1/documentation/manual/de/module_specs/Zend_Feed_Writer.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 19802 -->
<!-- Reviewed: no -->
<sect1 id="zend.feed.writer">
    <title>Zend_Feed_Writer</title>

    <sect2 id="zend.feed.writer.introduction">
        <title>Einführung</title>

        <para>
            <classname>Zend_Feed_Writer</classname> ist die Bruderkomponente zu
            <classname>Zend_Feed_Reader</classname> und verantwortlich für die Erzeugung von
            Feeds für die Ausgabe. Sie unterstützt die Atom 1.0 Spezifikation (RFC 4287) und
            RSS 2.0 wie vom RSS Advisory Board (RSS 2.0.11) spezifiziert. Es ist kein Nachkomme
            dieser Standard. Trotzdem bietet es ein einfaches System der Erweiterung welches es
            erlaube jede Erweiterung/Modul für jede der zwei Spezifikationen zu implementieren
            wenn diese nicht von Haus aus angeboten werden.
        </para>

        <para>
            Auf vielen Wegen ist <classname>Zend_Feed_Writer</classname> das Gegenteil von
            <classname>Zend_Feed_Reader</classname>. Wobei <classname>Zend_Feed_Reader</classname>
            darauf fokusiert ist ein einfach zu verwendendes Architektur Frontend durch Getter
            Methoden anzubieten, und <classname>Zend_Feed_Writer</classname> durch ähnlich
            benannte Setter oder Mutatoren. Das stellt sicher das die API keine weitere Lernkurve
            erfordert wenn jemand bereits mit <classname>Zend_Feed_Reader</classname> bekannt ist.
        </para>

        <para>
            Als Ergebnis dieses Designs, ist der Rest sogar einleuchtend. Dahinter, wird jedes
            Datenset eines <classname>Zend_Feed_Reader</classname> Objekts wärend der
            Darstellungszeit in ein <classname>DOMDocument</classname> Objekt übersetzt indem die
            notwendigen Feed Elemente verwendet werden. Für jeden unterstützten Feed Typen gibt es
            beide, sowohl einen Atom 1.0 als auch einen RSS 2.0 Renderer. Die Verwendung von
            <classname>DOMDocument</classname> statt einer Template Lösung hat viele Vorteile.
            Der offensichtlichste ist die Möglichkeit das <classname>DOMDocument</classname> zu
            exportieren um es weiter zu bearbeiten und auf PHP DOM für die Korrakturen und
            richtige Darstellung zu setzen.
        </para>

        <para>
            Wie bei <classname>Zend_Feed_Reader</classname> ist
            <classname>Zend_Feed_Writer</classname> ein alleinstehender Ersatz für
            <classname>Zend_Feed</classname>'s Builder Architektur und nicht kompatibel mit diesen
            Klassen.
        </para>
    </sect2>

    <sect2 id="zend.feed.writer.architecture">
        <title>Architektur</title>

        <para>
            Die Architektur von <classname>Zend_Feed_Writer</classname> ist sehr einfach. Es hat
            zwei Kernsets von Klassen: Container und Renderer.
        </para>

        <para>
            Der Container enthält die Klassen <classname>Zend_Feed_Writer_Feed</classname> und
            <classname>Zend_Feed_Writer_Entry</classname>. Die Einstiegsklassen können bei jeder
            Feed Klasse angehängt werden. Der einzige Zweck dieses Containers ist es Daten über den
            zu erstellenden Feed zu sammelnindem ein einfaches Interface von Setter Methoden
            verwendet wird. Diese Methode führen einige Test zur Datenprüfung durch. Zum Beispiel
            prüft er übergebene URIs, Datum, usw. Diese Checks sind nicht an einen der Feed
            Standards gebunden. Das Container Objekt enthält auch Methoden welche die schnelle
            Darstellung und den Export des endgültigen Feeds erlauben, und Sie können auf Wunsch
            wiederverwendet werden.
        </para>

        <para>
            Wärend es zwei Daten Container gibt, gibt es vier Renderer - zwei passende Container
            Renderer pro unterstütztem Feed Typ. Der Renderer akzeptiert einen Container, und
            basierend auf seinem Container versucht er einen gültigen Feed zu erstellen. Wenn der
            Renderer nicht in der Lage ist einen gültigen Feed zu erstellen, möglicherweise weil dem
            Container ein obligatorischer Datenpunkt fehlt, dann wird er dies melden indem eine
            <classname>Exception</classname> geworfen wird. Wärend es möglich ist
            <classname>Exception</classname>s zu ignorieren, würde das diese alle standardmäßigen
            Sicherheiten entfernen welche sicherstellen das gültige Daten gesetzt wurden um einen
            komplett gültigen Feed darzustellen.
        </para>

        <para>
            Da das System in Datencontainer und Renderer geteilt ist, kann es Erweiterungen
            interessant machen. Eine typische Erweiterung welche namespaced Feeds und Entry Level
            Elemente bietet, muss selbst exakt die gleiche Atchitektur reflektieren, z.B. anbieten
            von Feed und Entry Level Daten Containern, und passenden Renderern. Das ist,
            glücklicherweise, keine komplexe Integrationsarbeit da alle Erweiterungsklassen einfach
            registriert und automatisch von den Kern Klassen verwendet werden. Wir kommen später in
            diesem Kapitel im Detail zu den Erweiterungen.
        </para>
    </sect2>

    <sect2 id="zend.feed.writer.getting.started">
        <title>Beginnen</title>

        <para>
            Die Verwendung von <classname>Zend_Feed_Reader</classname> ist so einfach wie das Setzen
            von Daten und dem Ausführen des Renderers. Hier ist ein Beispiel um einen minimalen Atom
            1.0 Feed zu erstellen.
        </para>

        <programlisting language="php"><![CDATA[
/**
 * Den Eltern Feed erstellen
 */
$feed = new Zend_Feed_Writer_Feed;
$feed->setTitle('Paddy\'s Blog');
$feed->setLink('http://www.example.com');
$feed->setFeedLink('http://www.example.com/atom', 'atom');
$feed->addAuthor(array(
    'name'  => 'Paddy',
    'email' => 'paddy@example.com',
    'uri'   => 'http://www.example.com',
));
$feed->setDateModified(time());
$feed->addHub('http://pubsubhubbub.appspot.com/');

/**
 * Einen oder mehrere Einträge hinzufügen. Beachten das Einträge
 * manuell hinzugefügt werden müssen sobald Sie erstellt wurden
 */
$entry = $feed->createEntry();
$entry->setTitle('All Your Base Are Belong To Us');
$entry->setLink('http://www.example.com/all-your-base-are-belong-to-us');
$entry->addAuthor(array(
    'name'  => 'Paddy',
    'email' => 'paddy@example.com',
    'uri'   => 'http://www.example.com',
));
$entry->setDateModified(time());
$entry->setDateCreated(time());
$entry->setDescription(
    'Die Schwierigkeiten erklären Spiele ins englische zu portieren.'
);
$entry->setContent(
    'Ich schreibe diesen Artikel nicht. Das Beispiel ist lang genug ;).');
$feed->addEntry($entry);

/**
 * Den ergebenden Feed in Atom 1.0 darstellen und $out zuordnen. Man kann
 * "atom" mit "rss" ersetzen um einen RSS 2.0 feed zu erstellen
 */
$out = $feed->export('atom');
]]></programlisting>

        <para>
            Die dargestellt Ausgabe sollte folgende sein:
        </para>

        <programlisting language="xml">
&#60;?xml version="1.0" encoding="utf-8"?&#62;
&#60;feed xmlns="http://www.w3.org/2005/Atom"&#62;
    &#60;title type="text"&#62;Paddy's Blog&#60;/title&#62;
    &#60;subtitle type="text"&#62;Writing about PC Games since 176 BC.&#60;/subtitle&#62;
    &#60;updated&#62;2009-12-14T20:28:18+00:00&#60;/updated&#62;
    &#60;generator uri="http://framework.zend.com" version="1.10.0alpha"&#62;
        Zend_Feed_Writer
    &#60;/generator&#62;
    &#60;link rel="alternate" type="text/html" href="http://www.example.com"/&#62;
    &#60;link rel="self" type="application/atom+xml" href="http://www.example.com/atom"/&#62;
    &#60;id&#62;http://www.example.com&#60;/id&#62;
    &#60;author&#62;
        &#60;name&#62;Paddy&#60;/name&#62;
        &#60;email&#62;paddy@example.com&#60;/email&#62;
        &#60;uri&#62;http://www.example.com&#60;/uri&#62;
    &#60;/author&#62;
    &#60;link rel="hub" href="http://pubsubhubbub.appspot.com/"/&#62;
    &#60;entry&#62;
        &#60;title type="html"&#62;&#60;![CDATA[All Your Base Are Belong To Us]]&#62;&#60;/title&#62;
        &#60;summary type="html"&#62;
            &#60;![CDATA[Die Schwierigkeiten erklären Spiele ins englische zu portieren.]]&#62;
        &#60;/summary&#62;
        &#60;published&#62;2009-12-14T20:28:18+00:00&#60;/published&#62;
        &#60;updated&#62;2009-12-14T20:28:18+00:00&#60;/updated&#62;
        &#60;link rel="alternate" type="text/html" href="http://www.example.com/all-your-base-are-belong-to-us"/&#62;
        &#60;id&#62;http://www.example.com/all-your-base-are-belong-to-us&#60;/id&#62;
        &#60;author&#62;
        &#60;name&#62;Paddy&#60;/name&#62;
        &#60;email&#62;paddy@example.com&#60;/email&#62;
        &#60;uri&#62;http://www.example.com&#60;/uri&#62;
        &#60;/author&#62;
        &#60;content type="html"&#62;
            &#60;![CDATA[Ich schreibe diesen Artikel nicht. Das Beispiel ist lang genug ;).]]&#62;
        &#60;/content&#62;
    &#60;/entry&#62;
&#60;/feed&#62;
</programlisting>

        <para>
            Das ist ein perfekt gültiges Beispiel für Atom 1.0. Es sollte erwähnt sein das die
            Unterdrückung von obligatorischen Datenpunkten, wie dem Titel, eine
            <classname>Exception</classname> werfen wenn diese als Atom 1.0 dargestellt werden.
            Das unterscheidet sich für RSS 2.0 wo ein Titel unterdrückt werden kann solange eine
            Beschreibung vorhanden ist. Dadurch werden Exceptions geworfen die sich zwischen beiden
            Standards unterscheiden abhängig vom Renderer der Verwendet wird. Vom Design her wird
            <classname>Zend_Feed_Writer</classname> einen ungültigen Feed für keinen Standard
            darstellen solange der End-Benutzer nicht definiert das alle Exceptions ignoriert werden
            sollen.
        </para>
    </sect2>

    <sect2 id="zend.feed.writer.setting.feed.data.points">
        <title>Die Datenpunkte eines Feeds setzen</title>

        <para>
            Bevor ein Feed dargestellt werden kann, müssen zuerst die notwendigen Daten, für den
            Feed der dargestellt werden soll, gesetzt werden. Hierbei wird eine einfache Setter
            artige API verwendet welche auch als initiale Methode für die Prüfung von Daten herhält
            wenn diese gesetzt werden. Vom Design her entspricht die API stark der von
            <classname>Zend_Feed_Reader</classname> um Unklarheiten und Unsicherheiten zu vermeiden.
        </para>

        <para>
            <classname>Zend_Feed_Writer</classname> bietet diese API über seine Datencontainer
            Klassen <classname>Zend_Feed_Writer_Feed</classname> und
            <classname>Zend_Feed_Writer_Entry</classname> an. Diese Klassen speichern nahezu alle
            Feed Daten in einer vom Typ unabhängigen Art, was bedeutet das man jeden Datencontainer
            mit jedem Renderer wiederverwenden kann ohne das zusätzliche Arbeit notwendig ist. Beide
            Klassen sind auch offen für Erweiterungen, was bedeutet das eine Erweiterung seine
            eigenen Containerklassen definieren kann welche bei den Basis Containerklassen als
            Erweiterung registriert sind, und geprüft werden sobald irgendein Methodenaufruf die
            <methodname>__call()</methodname> Methode des Basiscontainers auslöst.
        </para>

        <para>
            Hier ist eine Zusammenfassung der Kern <acronym>API</acronym> für Feeds. Man sollte
            beachten das Sie nicht nur die Standards für <acronym>RSS</acronym> und Atom umfasst,
            sondern auch eine Anzahl von Erweiterungen welche in
            <classname>Zend_Feed_Writer</classname> enthalten sind. Die Benamung dieser Erweiterungs
            Methoden ist recht generisch - alle Erweiterungs Methoden arbeiten auf dem gleichen
            Level wie die Kern <acronym>API</acronym> da wir es erlauben jedes Erweiterungs Objekt
            seperat zu empfangen wenn das notwendig ist.
        </para>

        <table>
            <title>API Methoden auf Feed Level</title>

            <tgroup cols="2">
                <tbody>
                    <row>
                        <entry><methodname>setId()</methodname></entry>

                        <entry>
                            Setzt eine eindeutige ID die mit diesem Feed assoziiert ist. Für Atom
                            1.0 ist das ein atom:id Element, und für RSS 2.0 wird es als guid
                            Element hinzugefügt. Diese sind optional solange ein Link hinzugefügt
                            wird, wenn z.B. der Link als ID gesetzt ist.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setTitle()</methodname></entry>
                        <entry>Setzt den Titel des Feeds.</entry>
                    </row>

                    <row>
                        <entry><methodname>setDescription()</methodname></entry>
                        <entry>Setzt die textuelle Beschreibung des Feeds.</entry>
                    </row>

                    <row>
                        <entry><methodname>setLink()</methodname></entry>

                        <entry>
                            Setzt eine <acronym>URI</acronym> zur <acronym>HTML</acronym> Website
                            welche die gleichen oder ähnliche Informationen wie dieser Feed
                            enthält (z.B. wenn der Feed von einem Blog ist, sollte er die
                            <acronym>URI</acronym> des Blogs anbieten unter welche die
                            <acronym>HTML</acronym> Version der Einträge gelesen werden können).
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setFeedLinks()</methodname></entry>

                        <entry>
                            Fügt einen Link zu einem XML Feed hinzu, entweder der erzeugte Feed oder
                            eine alternative URI zeigen auf den gleichen Feed, aber in einem
                            anderen Format. Es ist mindestens notwendig einen Link zum erstellten
                            Feed zu inkludieren damit dieser eine identifizierbare endgültige URI
                            hat, welche es dem Client erlaubt Änderungen des Orts mitzubekommen ohne
                            das dauernde Umleitungen notwendig sind. Dieser Parameter ist ein Array
                            von Arrays, wobei jedes Unter-Array die Schlüssel "type" und "uri"
                            enthält. Der Type sollte "atom", "rss" oder "rdf" sein. Wenn ein Typ
                            unterdrückt wird, ist er standardmäßig mit dem Typ identisch mit dem
                            der Feed dargestellt wird.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setAuthors()</methodname></entry>

                        <entry>
                            Setzt die Daten für Autoren. Der Parameter ist ein Array von Arrays
                            wobei jedes Unter-Array die Schlüssel "name", "email" und "uri"
                            enthalten kann. Der Wert "uri ist nur für Atom Feeds anwendbar da RSS
                            keine möglichkeit enthält Ihn anzuzeigen. Für RSS 2.0 werden bei der
                            Darstellung zwei Elemente erzeugt - ein Autor Element welches die
                            Referenz zur Email enthält und dem Namen in Klammern, und ein Dublin
                            Core Creator Element welches nur den Namen enthält.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setAuthor()</methodname></entry>

                        <entry>
                            Setzt die Daten für einen einzelnen Autor und folgt dem selben Format
                            wie vorher für ein einzelnes Unter-Array beschrieben.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setDateCreated()</methodname></entry>

                        <entry>
                            Setzt das Datum an dem dieser Feed erstellt wurde. Generell nur
                            für Atom anwendbar wo es das Datum beschreibt zu der die Ressource,
                            die von dem Atom 1.0 Dokument beschrieben wird, erstellt wurde. Der
                            erwartete Parameter muss ein UNIX Timestamp oder ein
                            <classname>Zend_Date</classname> Objekt sein.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>getDateModified()</methodname></entry>

                        <entry>
                            Setzt das Datum zu dem dieser Feed das letzte Mal geändert wurde. Der
                            erwartete Parameter muss ein UNIX Timestamp oder ein
                            <classname>Zend_Date</classname> Objekt sein.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setLanguage()</methodname></entry>

                        <entry>
                            Setzt die Sprache des Feeds. Diese wird unterdrückt solange Sie nicht
                            gesetzt ist.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>getGenerator()</methodname></entry>

                        <entry>
                            Erlaubt es einen Generator zu setzen. Der Parameter sollte ein Array
                            sein welche die Schlüssel "name", "version" und "uri" enthält. Wenn er
                            unterdrückt wird, wird ein standardmäßiger Generator hinzugefügt welcher
                            auf <classname>Zend_Feed_Writer</classname>, die aktuelle Version vom
                            Zend Framework und die URI des Frameworks verweist.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setCopyright()</methodname></entry>

                        <entry>
                            Setzt eine Copyright Notiz die mit dem Feed assoziiert ist.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setHubs()</methodname></entry>

                        <entry>
                            Akzeptiert ein Array von Pubsubhubbub Hub Endpunkten die im Feed als
                            Atom Links dargestellt werden damit PuSH Abonnenten den eigenen Feed
                            abbonieren können. Es ist zu beachten das man einen Pubsubhubbub
                            Herausgeber implementieren muss damit Real-Time Updates ermöglicht
                            werden. Ein Herausgeber kann implementiert werden indem
                            <classname>Zend_Feed_Pubsubhubbub_Publisher</classname> verwendet wird.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setCategories()</methodname></entry>

                        <entry>
                            Akzepziert ein Array an Kategorien für die Darstellung, wobei jedes
                            Element selbst ein Array ist dessen möglich Schlüssel "term", "label"
                            und "scheme" enthalten. "term" ist typischerweise der Name einer
                            Kategorie welche für die Aufnahme in einer URI passen. "label" kann
                            ein menschlich lesbarer Name einer Kategorie sein der spezielle Zeichen
                            unterstützt (er wird wärend der Darstellung kodiert) und ist ein
                            benötigter Schlüssel. "scheme" (im RSS auch die Domain genannt) ist
                            optional muss aber eine gültige URI sein.
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>

    <sect2 id="zend.feed.writer.setting.entry.data.points">
        <title>Setzen der Datenpunkt für Einträge</title>

        <para>
            Hier ist eine Zusammenfassung der Kern <acronym>API</acronym> für Einträge/Elemente.
            Man sollte beachten das Sie nicht nur die Standards für <acronym>RSS</acronym> und Atom
            umfasst, sondern auch eine Anzahl von Erweiterungen welche in
            <classname>Zend_Feed_Writer</classname> enthalten sind. Die Benamung dieser Erweiterungs
            Methoden ist recht generisch - alle Erweiterungs Methoden arbeiten auf dem gleichen
            Level wie die Kern <acronym>API</acronym> da wir es erlauben jedes Erweiterungs Objekt
            seperat zu empfangen wenn das notwendig ist.
        </para>

        <table>
            <title>API Methoden auf Eintrags Level</title>

            <tgroup cols="2">
                <tbody>
                    <row>
                        <entry><methodname>setId()</methodname></entry>

                        <entry>
                            Setzt eine eindeutige ID die mit diesem Feed assoziiert ist. Für Atom
                            1.0 ist das ein atom:id Element, und für RSS 2.0 wird es als guid
                            Element hinzugefügt. Diese sind optional solange ein Link hinzugefügt
                            wird, wenn z.B. der Link als ID gesetzt ist.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setTitle()</methodname></entry>
                        <entry>Setzt den Titel des Feeds.</entry>
                    </row>

                    <row>
                        <entry><methodname>setDescription()</methodname></entry>
                        <entry>Setzt die textuelle Beschreibung des Feeds.</entry>
                    </row>

                    <row>
                        <entry><methodname>setLink()</methodname></entry>

                        <entry>
                            Setzt eine <acronym>URI</acronym> zur <acronym>HTML</acronym> Website
                            welche die gleichen oder ähnliche Informationen wie dieser Feed
                            enthält (z.B. wenn der Feed von einem Blog ist, sollte er die
                            <acronym>URI</acronym> des Blogs anbieten unter welche die
                            <acronym>HTML</acronym> Version der Einträge gelesen werden können).
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setFeedLinks()</methodname></entry>

                        <entry>
                            Fügt einen Link zu einem XML Feed hinzu, entweder der erzeugte Feed oder
                            eine alternative URI zeigen auf den gleichen Feed, aber in einem
                            anderen Format. Es ist mindestens notwendig einen Link zum erstellten
                            Feed zu inkludieren damit dieser eine identifizierbare endgültige URI
                            hat, welche es dem Client erlaubt Änderungen des Orts mitzubekommen ohne
                            das dauernde Umleitungen notwendig sind. Dieser Parameter ist ein Array
                            von Arrays, wobei jedes Unter-Array die Schlüssel "type" und "uri"
                            enthält. Der Type sollte "atom", "rss" oder "rdf" sein. Wenn ein Typ
                            unterdrückt wird, ist er standardmäßig mit dem Typ identisch mit dem
                            der Feed dargestellt wird.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setAuthors()</methodname></entry>

                        <entry>
                            Setzt die Daten für Autoren. Der Parameter ist ein Array von Arrays
                            wobei jedes Unter-Array die Schlüssel "name", "email" und "uri"
                            enthalten kann. Der Wert "uri ist nur für Atom Feeds anwendbar da RSS
                            keine möglichkeit enthält Ihn anzuzeigen. Für RSS 2.0 werden bei der
                            Darstellung zwei Elemente erzeugt - ein Autor Element welches die
                            Referenz zur Email enthält und dem Namen in Klammern, und ein Dublin
                            Core Creator Element welches nur den Namen enthält.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setAuthor()</methodname></entry>

                        <entry>
                            Setzt die Daten für einen einzelnen Autor und folgt dem selben Format
                            wie vorher für ein einzelnes Unter-Array beschrieben.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setDateCreated()</methodname></entry>

                        <entry>
                            Setzt das Datum an dem dieser Feed erstellt wurde. Generell nur
                            für Atom anwendbar wo es das Datum beschreibt zu der die Ressource,
                            die von dem Atom 1.0 Dokument beschrieben wird, erstellt wurde. Der
                            erwartete Parameter muss ein UNIX Timestamp oder ein
                            <classname>Zend_Date</classname> Objekt sein.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>getDateModified()</methodname></entry>

                        <entry>
                            Setzt das Datum zu dem dieser Feed das letzte Mal geändert wurde. Der
                            erwartete Parameter muss ein UNIX Timestamp oder ein
                            <classname>Zend_Date</classname> Objekt sein.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setLanguage()</methodname></entry>

                        <entry>
                            Setzt die Sprache des Feeds. Diese wird unterdrückt solange Sie nicht
                            gesetzt ist.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>getGenerator()</methodname></entry>

                        <entry>
                            Erlaubt es einen Generator zu setzen. Der Parameter sollte ein Array
                            sein welche die Schlüssel "name", "version" und "uri" enthält. Wenn er
                            unterdrückt wird, wird ein standardmäßiger Generator hinzugefügt welcher
                            auf <classname>Zend_Feed_Writer</classname>, die aktuelle Version vom
                            Zend Framework und die URI des Frameworks verweist.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setCopyright()</methodname></entry>

                        <entry>
                            Setzt eine Copyright Notiz die mit dem Feed assoziiert ist.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setHubs()</methodname></entry>

                        <entry>
                            Akzeptiert ein Array von Pubsubhubbub Hub Endpunkten die im Feed als
                            Atom Links dargestellt werden damit PuSH Abonnenten den eigenen Feed
                            abbonieren können. Es ist zu beachten das man einen Pubsubhubbub
                            Herausgeber implementieren muss damit Real-Time Updates ermöglicht
                            werden. Ein Herausgeber kann implementiert werden indem
                            <classname>Zend_Feed_Pubsubhubbub_Publisher</classname> verwendet wird.
                        </entry>
                    </row>

                    <row>
                        <entry><methodname>setCategories()</methodname></entry>

                        <entry>
                            Akzepziert ein Array an Kategorien für die Darstellung, wobei jedes
                            Element selbst ein Array ist dessen möglich Schlüssel "term", "label"
                            und "scheme" enthalten. "term" ist typischerweise der Name einer
                            Kategorie welche für die Aufnahme in einer URI passen. "label" kann
                            ein menschlich lesbarer Name einer Kategorie sein der spezielle Zeichen
                            unterstützt (er wird wärend der Darstellung kodiert) und ist ein
                            benötigter Schlüssel. "scheme" (im RSS auch die Domain genannt) ist
                            optional muss aber eine gültige URI sein.
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>
</sect1>