RSS integracija

Tehnička dokumentacija

Kako radi sinkronizacija

1. Poslužitelj dohvaća postavljeni RSS izvor te uspoređuje identifikatore stavki i vrijednosti changeDate sa spremljenim podacima.
2. Obrađuju se nove i izmijenjene stavke. Poslužitelj preuzima njihove medije i predaje ih datotečnoj usluzi radi pohrane i eventualne pretvorbe; nekorištene stavke i mediji uklanjaju se.
3. Poslužitelj obavještava portal o prepoznatoj promjeni, a portal osigurava slanje ažuriranih podataka uređajima koji koriste taj kanal.
4. Uređaj sprema primljene podatke i zasebno preuzima potrebne privitke. Primitak definicije sam po sebi ne potvrđuje da je preuzimanje svih medija završeno.

Interval provjere izvora i dodjelu RSS aplikacije opisuje vodič Konfiguracija RSS aplikacije. Ažuriranje nije trenutačno; ovisi i o pripremi medija te povezanosti uređaja.

Opisana sinkronizacija pretpostavlja izvor s barem jednom valjanom stavkom. Nemojte se oslanjati na potpuno pražnjenje kanala kao zajamčen način prekida prikazivanja sadržaja.

Kako sustav otkriva promjene stavki

• Novi guid u novoj definiciji koji nije postojao u staroj → nova stavka; njeni mediji se preuzimaju i pripremaju.
• Prethodni guid nedostaje u novoj definiciji → uklonjena stavka; njeni mediji se uklanjaju.
• guid postoji u obje definicije, ali se changeDate razlikuje → promijenjena stavka; stari mediji se uklanjaju, a novi preuzimaju i pripremaju.

Pri promjeni naslova, opisa, poveznice ili privitaka zadržite guid i promijenite changeDate. Isto vrijedi pri zamjeni datoteke na nepromijenjenom URL-u. Sama promjena redoslijeda stavki ne mora pokrenuti slanje nove definicije; za dostavu promjene ažurirajte i changeDate.

Glavna svojstva

• guid: Jedinstveni i stabilni identifikator stavke, primjerice ID zapisa u bazi podataka. Zadržite ga i pri uređivanju sadržaja.
• title: Obvezan naslov koji ne smije biti prazan. Može sadržavati HTML oznake, ali se u popisu i naslovu pojedinosti prikazuje kao običan tekst.
• description: Opis stavke. Može sadržavati HTML; oblikovani prikaz ovisi o postavkama RSS aplikacije.
• category: Naziv kategorije za filtriranje. Odabir kategorije prikazuje se ako kanal sadrži barem jednu kategoriju čiji naziv nije prazan.
• link: Apsolutna adresa povezane web-stranice. Poveznica koja počinje s http u pojedinostima se prikazuje i kao QR kod za mobilni uređaj.
• pubDate: Datum i vrijeme nastanka stavke. Ne služi za odgođeni prikaz: budući datum sam po sebi ne sprječava prikazivanje stavke.
• endDate: Datum i vrijeme isteka valjanosti. Samo ispunjavanje ovog polja ne jamči trenutačno skrivanje stavke prema vremenu uređaja, osobito kada uređaj nije povezan s internetom. Nemojte se oslanjati isključivo na ovo polje za sadržaj koji se mora prestati prikazivati u točno određeno vrijeme.
• changeDate: Datum i vrijeme posljednje promjene sadržaja. Sustav ih uspoređuje zajedno s guid; pri svakoj promjeni sadržaja upotrijebite drukčiju vrijednost.
• media:content: Reprezentativna slika stavke izvan grupe privitaka. Navedite atribute url i type.
• content, image: Parser prihvaća i ove nazive oznaka s istim medijskim atributima. Oznaka image služi kao zamjena ako URL glavnog medija još nije postavljen. Preporučuje se media:content; ovaj alternativni zapis ne podržava proizvoljnu ugniježđenu strukturu image/url.
• media:group: Grupa privitaka stavke: slike, videozapisi, dokumenti i umetnuti HTML sadržaj.

Zapis datuma i vremena

Upotrijebite, primjerice, 2026-10-17 08:30:00. Podržani su i razdvajanje datuma i vremena znakom T ili t, datum oblika 17.10.2026 te RSS zapis poput Sat, 17 Oct 2026 08:30:00 +0200.

Vrijednosti se obrađuju kao lokalni datum i vrijeme. Navedeni vremenski pomak ne preračunava se u UTC, stoga dosljedno koristite dogovorenu vremensku zonu. Provjereni parser ne podržava zapis ISO 8601 koji završava znakom Z.

XML primjer

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
    <channel>
        <item>
            <guid>offer-001</guid>
            <title>Novosti u ponudi</title>
            <description>Informacije o aktualnoj ponudi</description>
            <category>Novosti</category>
            <pubDate>2026-10-17 08:00:00</pubDate>
            <changeDate>2026-10-17 08:30:00</changeDate>
            <link>https://example.org/offers/offer-001/</link>
            <media:content url="https://example.org/media/offer-001.jpg" type="image/jpeg"/>
            <media:group>
                <media:content url="https://example.org/media/offer-001.pdf" name="Pojedinosti ponude" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Pojedinosti</h1><p>Dodatne informacije o ponudi.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Adrese na domeni example.org služe samo kao primjer; zamijenite ih stvarnim adresama dostupnima RSS poslužitelju. Osnovni primjer ne sadrži endDate kako ogledna stavka ne bi automatski istekla.

Parametri stavke

Tablica navodi zahtijevani format integracije. To što parser tolerira podatke koji nedostaju ne zamjenjuje njihovo ispravno ispunjavanje. Pri ažuriranju postojeće stavke potrebno je navesti i promijeniti changeDate.

Stavke medijske grupe

Slika, dokument ili videozapis: u grupu dodajte element media:content s atributima url i type. Neobvezni atribut name određuje naziv privitka.

HTML ili običan tekst: upotrijebite media:content type="text/html" i sadržaj umetnite izravno u element, primjerice kao HTML fragment unutar CDATA. Za običan tekst dovoljan je jednostavan odlomak. Prikaz HTML privitka nije puna web-aplikacija i ova specifikacija ne jamči izvršavanje JavaScripta.

Ograničenje tekstnih privitaka: samostalni privitci vrste text/plain ne obrađuju se ispravno u provjerenoj implementaciji. Za tekstni privitak upotrijebite prethodno prikazani zapis text/html.

Podržani tipovi sadržaja

To su ulazni formati privitaka koje sustav, ovisno o vrsti, pohranjuje ili priprema za prikaz. Uspješna obrada ovisi i o sadržaju konkretne datoteke te njezinu kodiranju; podudaranje MIME vrste samo po sebi ne potvrđuje završetak pretvorbe.