RSS-интеграција

Техничка референца

Како работи синхронизацијата

1. Серверот го презема поставениот RSS-канал и ги споредува идентификаторите на ставките и вредностите на changeDate со зачуваните записи.
2. Новите и променетите ставки се обработуваат. Серверот ги презема нивните медиуми и ги испраќа до услугата за датотеки за складирање и, ако е потребно, конверзија; некористените ставки и медиуми се отстрануваат.
3. Серверот го известува порталот за откриената промена. Порталот потоа го организира доставувањето на ажурираните податоци до уредите што го користат каналот.
4. Секој уред ги зачувува примените податоци и посебно ги презема потребните прилози. Приемот на дефиницијата сам по себе не потврдува дека завршило преземањето на сите медиуми.

Погледнете поставувањето на RSS-апликацијата за интервалот на проверка на каналот и доделувањето на апликацијата. Ажурирањата не се моментални: врз доставувањето влијаат и подготовката на медиумите и поврзаноста на уредите.

Синхронизацијата опишана овде претпоставува канал со најмалку една важечка ставка. Не потпирајте се на празнењето на каналот како загарантиран начин да се запре прикажувањето на неговата содржина.

Како системот открива промени во ставките

• Идентификаторот guid во новата дефиниција, што не постоел во старата → нова ставка; нејзините медиуми се преземаат и подготвуваат.
• Претходен guid што недостига во новата дефиниција → отстранета ставка; нејзините медиуми се отстрануваат.
• guid постои во двете, но changeDate се разликува → променета ставка; старите медиуми се отстрануваат, а новите се преземаат и подготвуваат.

Кога менувате наслов, опис, врска или прилог, задржете го guid и променете го changeDate. Ова важи и при замена на датотека на непроменета URL-адреса. Самото менување на редоследот на ставките можеби нема да предизвика доставување нова дефиниција; ажурирајте го и changeDate за промената да биде доставена.

Главни својства

• guid: Единствен, стабилен идентификатор на ставката, како идентификатор на запис од база на податоци. Задржете го при уредување на содржината.
• title: Задолжителен, непразен наслов. HTML-ознаки се прифаќаат, но во списокот и во насловот на деталите се прикажува обичен текст.
• description: Опис на ставката. Може да содржи HTML; форматираниот приказ зависи од поставките на RSS-апликацијата.
• category: Име на категорија што се користи за филтрирање. Изборникот за категории се појавува кога каналот има најмалку една непразна категорија.
• link: Апсолутна URL-адреса на поврзана веб-страница. Врска што започнува со http се прикажува и како QR-код во деталите за ставката, за употреба на мобилен уред.
• pubDate: Датум и време на создавање на ставката. Не го закажува нејзиното објавување: иден датум не го спречува прикажувањето на ставката.
• endDate: Краен датум и време на важност на ставката. Поставувањето на ова поле не гарантира моментално отстранување од приказот според часовникот на уредот, особено кога уредот е без врска. Не потпирајте се само на него за содржина што мора да престане да се прикажува во точно определено време.
• changeDate: Датум и време на последната промена на содржината. Системот го споредува заедно со guid; користете различна вредност при секое ажурирање на содржината.
• media:content: Репрезентативната слика на ставката, надвор од групата прилози. Наведете ги атрибутите url и type.
• content, image: Парсерот ги прифаќа и овие имиња на ознаки со истите медиумски атрибути. Ознаката image служи како резерва кога не е поставена главната URL-адреса на медиумот. Дајте предност на media:content; овој алтернативен запис не поддржува произволни вгнездени структури image/url.
• media:group: Групата прилози на ставката: слики, видеа, документи и вградена HTML-содржина.

Формати за датум и време

Користете вредност како 2026-10-17 08:30:00. Парсерот прифаќа и T или t меѓу датумот и времето, датум како 17.10.2026 и RSS-датуми како Sat, 17 Oct 2026 08:30:00 +0200.

Вредностите се обработуваат како локални датуми и времиња. Наведеното отстапување од UTC не се користи за нивно претворање во UTC, па користете една договорена временска зона доследно. Проверениот парсер не поддржува временски ознаки според ISO 8601 што завршуваат со Z.

XML-пример

<?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>Најнови понуди</title>
            <description>Информации за нашите тековни понуди</description>
            <category>Новости</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="Детали за понудата" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Детали</h1><p>Повеќе информации за оваа понуда.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Адресите на example.org се заменски примери. Заменете ги со вистински URL-адреси достапни за RSS-серверот. Во основниот пример endDate е изоставен за примерната ставка да не истече автоматски.

Параметри на ставка

Табелата го дефинира потребниот формат за интеграцијата. Тоа што парсерот толерира полиња што недостигаат не е замена за правилно пополнети податоци. Наведете го и променете го changeDate кога ажурирате постојна ставка.

Ставки во медиумска група

Слика, документ или видео: додајте елемент media:content во групата и наведете ги неговите атрибути url и type. Незадолжителниот атрибут name задава назив на прилогот.

HTML или обичен текст: користете media:content type="text/html" и ставете ја содржината директно во елементот, на пример како HTML-фрагмент во CDATA. За обичен текст е доволен едноставен пасус. Прикажувањето HTML-прилог не обезбедува целосна веб-апликација; оваа спецификација не гарантира извршување JavaScript.

Ограничување за текстуални прилози: самостојните прилози text/plain не се обработуваат правилно во проверената имплементација. Користете ја text/html формата прикажана погоре за текстуален прилог.

Поддржани видови содржина

Ова се влезни формати на прилози што системот ги складира или ги подготвува за прикажување, зависно од нивниот вид. Успешната обработка зависи и од вистинската содржина и кодирањето на датотеката; совпаѓањето на MIME-типот само по себе не потврдува дека конверзијата завршила.