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

   1 <sect1 id="zend.feed.consuming-atom">
   2 <title>Odbieranie danych z kanału informacyjnego Atom</title>
   3
   4     <para>
   5         <code>Zend_Feed_Atom</code> jest używany w prawie taki sam sposób jak
   6         <code>Zend_Feed_Rss</code>. Zapewnia taki sam dostęp do właściwości samego
   7         kanału i taką samą iterację po wpisach w kanale. Główną różnicą jest sama
   8         struktura protokołu Atom. Atom jest następcą RSS; jest bardziej uogólnionym
   9         protokołem i jest zaprojektowany aby łatwiej radzić sobie z kanałami, które
  10         ukazują cała swoją zawartość wewnątrz pliku RSS dzieląc standardowy tag
  11         RSS <code>description</code> na dwa elementy, <code>summary</code> oraz
  12         <code>content</code>.
  13     </para>
  14
  15     <example id="zend.feed.consuming-atom.example.usage">
  16         <title>Podstawowe użycie kanału Atom</title>
  17         <para>
  18             Odczytywanie kanału Atom i wyświetlenie pól <code>title</code> i
  19             <code>summary</code> dla każdego z wpisów:
  20         </para>
  21         <programlisting role="php"><![CDATA[
  22 $feed = new Zend_Feed_Atom('http://atom.example.com/feed/');
  23 echo 'Kanał zawiera ' . $feed->count() . ' wpisów.' . "\n\n";
  24 foreach ($feed as $entry) {
  25     echo 'Tytuł: ' . $entry->title() . "\n";
  26     echo 'Opis: ' . $entry->summary() . "\n\n";
  27 }
  28 ]]>
  29         </programlisting>
  30     </example>
  31
  32     <para>
  33         W kanałach Atom możesz się spodziewać następujących właściwości:
  34     </para>
  35
  36     <para>
  37         <itemizedlist>
  38             <listitem>
  39                 <para><code>title</code> - Tytuł kanału, taki sam jak tytuł kanału RSS.</para>
  40             </listitem>
  41             <listitem>
  42                 <para><code>id</code> - Każdy arkusz i wpis mają unikalny identyfikator.</para>
  43             </listitem>
  44             <listitem>
  45                 <para><code>link</code> - Arkusze mogą mieć wiele odnośników, które
  46                 są rozróżnianie za pomocą atrybutu <code>type</code>.</para>
  47                 <para>
  48                     Odpowiednikiem odnośnika kanału RSS byłby odnośnik o typie
  49                     <code>type="text/html"</code>. Jeśli odnośnik kieruje do
  50                     alternatywnej wersji zawartości arkusza, może on otrzymać
  51                     atrybut <code>rel="alternate"</code>.
  52                 </para>
  53             </listitem>
  54             <listitem>
  55                 <para><code>subtitle</code> - Opis arkusza odpowiadający opisowi
  56                 kanału RSS.
  57                 </para>
  58                 <para><code>author->name()</code> - Nazwa autora arkusza.</para>
  59                 <para><code>author->email()</code> - Adres email autora arkusza.</para>
  60             </listitem>
  61         </itemizedlist>
  62     </para>
  63
  64     <para>
  65         Składniki wpisu kanału Atom:
  66     </para>
  67
  68     <para>
  69         <itemizedlist>
  70             <listitem>
  71                 <para><code>id</code> - Unikalny identyfikator wpisu.</para>
  72             </listitem>
  73             <listitem>
  74                 <para><code>title</code> - Tytuł wpisu, taki sam jak tytuł w RSS</para>
  75             </listitem>
  76             <listitem>
  77                 <para><code>link</code> - Odnośnik do innego formatu lub do
  78                 alternatywnej wersji wpisu.</para>
  79             </listitem>
  80             <listitem>
  81                 <para><code>summary</code> - Podsumowanie zawartości wpisu.</para>
  82             </listitem>
  83             <listitem>
  84                 <para><code>content</code> - Cała zawartość wpisu; może być pominięta
  85                 jeśli arkusz zawiera tylko skróty informacji.</para>
  86             </listitem>
  87             <listitem>
  88                 <para><code>author</code> - z pod-tagami <code>name</code> oraz
  89                 <code>email</code> jak w arkuszach RSS</para>
  90             </listitem>
  91             <listitem>
  92                 <para><code>published</code> - data publikacji wpisu w formacie
  93                 RFC 3339.</para>
  94             </listitem>
  95             <listitem>
  96                 <para><code>updated</code> - data ostatniej aktualizacji wpisu w
  97                 formacie RFC 3339.</para>
  98             </listitem>
  99         </itemizedlist>
 100     </para>
 101
 102     <para>
 103         Więcej informacji o Atom znajdziesz na stronie
 104         <ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>.
 105     </para>
 106 </sect1>