Wpisy w kanałach

Wewnątrz <feed> umieszcza się elementy <entry>, które opisują poszczególne wpisy.

Rozbudowany przykład samego wpisu: 

  <entry>
    <title>Atom draft-07 snapshot</title>
    <link rel="alternate" type="application/xhtml+xml" href="http://example.org/2005/04/02/atom"/>
    <link rel="enclosure" type="audio/mpeg" length="1337" href="http://example.org/audio/ph34r_my_podcast.mp3"/>
    <id>Adres/wpis1/</id>
    <updated>Data modyfikacji</updated>
    <published><?php echo date(DATE_ATOM) ?></published>
    <author>
      <name>Mark Pilgrim</name>
      <uri>http://example.org/</uri>
      <email>[email protected]</email>
    </author>
    <contributor>
      <name>Sam Ruby</name>
    </contributor>
    <contributor>
      <name>Joe Gregorio</name>
    </contributor>
    <content type="xhtml" xml:lang="en" xml:base="http://diveintomark.org/">
      <div xmlns="http://www.w3.org/1999/xhtml">
        <p><em>[Update: The Atom draft is finished.]</em></p>
      </div>
    </content>
  </entry>

Elementy obowiązkowe w <entry>

Tytuł wpisu: <title>

Tytuł wpisu to wszystko, co pokazują dynamiczne zakładki Firefox

Tytuł tego wpisu. Musi być jasny, zwięzły i różny od tytułów innych wpisów.

Data aktualizacji wpisu: <updated>

Element <published> może zawierać datę pierwszej publikacji

Format taki sam jak elementu <updated> kanału, z tym że data ma być datą ostatniej modyfikacji tego wpisu. Jeśli wpis się zmieni, to data w jego elemencie <updated> też powinna.

W PHP drugi parametr dla date() pozwala podać określony czas (unix timestamp) do sformatowania. Przydatne może być UNIX_TIMESTAMP() z MySQL.

Unikalny, niezmienny identyfikator wpisu: <id>

Bardzo ważne jest, żeby każdy wpis miał swój własny, niezmienny, unikalny identyfikator.

Autor: <author>

Składnia identyczna jak elementu <author> dla kanału, z tym, że określa autora (lub autorów) tego konkretnego wpisu.

Jeśli nie ma podanego autora kanału, to każdy wpis musi mieć podanego swojego autora.

Treść wpisu

Strona WWW: <link rel="alternate">

Wpisy zazwyczaj wskazują na stronę WWW, gdzie jest ich oryginalna, pełna treść. Najczęściej używane są ścieżki absolutne, lecz link może być również relatywny do lokalizacji kanału: 

 <link rel="alternate" type="application/xhtml+xml" href="/blog/dzis-jadlem-kotleta.xhtml"/>

Podsumowanie: <summary>

Podsumowanie tego wpisu. Może to być też streszczenie albo wprowadzenie. Ważne, aby zajmowało najwyżej kilka zdań.

Treść: <content>

Jeśli chcesz, możesz umieścić pełną treść wpisu (np. cały post z bloga). Wtedy link do strony WWW, ani podsumowanie nie są konieczne (choć i tak warto je dodać).

Nie umieszczaj skróconej lub inaczej zubożonej treści w <content>. Jeśli nie chcesz w kanale umieścić całości, używaj elementu <summary>.

Unikalne identyfikatory | Typy danych
Zmodyfikowano: 15.08.2011, 08:21
submit