Вимоги до надання джерел даних в стрічку новин порталу Укрнет.

Зміст

Загальні вимоги

Додаток 1. Технічні вимоги до Джерела новин Партнера

Додаток 2. Приклад джерела з новинами для однієї рубрики

Додаток 3. Приклад Джерела з новинами для кількох рубрик

Список відповідності рубрик

Вміст джерела

Корисні посилання

Додаткові формати

Загальні вимоги

Партнер - це сайт / інформаційний ресурс, який хоче транслювати новини в стрічку новин порталу Укрнет.
Джерело новин - RSS джерело новин партнера.
Один Партнер може мати одне або декілька Джерел новин.
Всі новини в стрічці новин порталу Укрнет розподіляються по рубриках: Політика, Економіка, Події, Суспільство, Регіональні новини, Технології, Наука, Авто, Спорт, Здоров'я, Шоу-бізнес, За кордоном, Курйози, Фоторепортаж, Відео, Lifestyle, Все про їжу.
Для підключення в стрічку новин порталу Укрнет Партнер повинен надати посилання на своє Джерело / Джерела новин.
Джерело новин повинно повністю відповідати вимогам, описаним в Додатку 1 цього документу.
Кожне Джерело новин Партнера може містити новини для однієї або декількох рубрик порталу Укрнет:
1. Якщо джерело новин містить новини ВИКЛЮЧНО однієї рубрики, наприклад «Політика», то для кожного такого джерела Партнера необхідно вказати чітку і однозначну відповідність рубрикам порталу Укрнет.
  Приклад:

Джерело Партнера	В яку рубрику на порталі подавати новини
http://www.partnerurl.com/rss/source1.rss	Політика
http://www.partnerurl.com/rss/source2.rss	Економіка
http://www.partnerurl.com/rss/source3.rss	Курйози

1. Якщо джерело новин Партнера містить новини декількох рубрик або всі новини Партнера, то для кожної з новин в Джерелі необхідно вказувати рубрику, до якої відноситься новина - вказувати рубрику необхідно в тезі <category>. Крім того, необхідно надати список відповідності між рубриками Партнера і рубриками на порталі Укрнет.
  Приклад списку відповідності рубрик:

Рубрика Партнера	Рубрика Укрнет
Гаджети	Технології
Світ	За кордоном
Гроші	Економіка

Якщо джерело новин має чітку регіональну спрямованість і містить новини по конкретному регіону України, наприклад «Житомир», то необхідно повідомити про цей факт менеджеру Укрнет. Для регіональних джерел не допускається публікація загальнонаціональних, світових і тематичних новин (наприклад Авто). Якщо Партнеру необхідно подавати на портал новини як загальної, так і регіональної спрямованості - необхідно створювати для регіональних і загальних новин - окремі джерела.
Не допускається дублювання одних і тих самих новин в різних джерелах одного Партнера.

Додаток 1. Технічні вимоги до Джерела новин Партнера

Експорт Даних для розміщення заголовків і анотацій новин на Укрнет здійснюється в XML-based (https://www.w3.org/TR/REC-xml) форматі RSS 2.0 (https://blogs.law.harvard.edu/tech/rss). Нижче міститься опис елементів RSS 2.0, що використовуються для експорту Даних, необхідні коментарі і приклад експортного файлу.

<?xml version="1.0" encoding="utf-8"?>
1. Найперший рядок.
2. Якщо це не вказано явно в заголовку, кодуванням файлу вважається utf-8.
3. В іншому випадку потрібно обов'язково вказувати кодування xml файлу. Найбільш вживані кодування:
  windows-1251, utf-8, koi8-r.
4. Увага: фактичне кодування, що віддається вебсервером, повинно ЗАВЖДИ збігатися з кодуванням, зазначеним в заголовку XML.
<rss version="2.0" xmlns:xml="http://www.w3.org/XML/1998/namespace">
1. Обов'язковий кореневий елемент RSS-файлу.
2. Атрибут version повинен мати значення 2.0: version="2.0"
3. Можливе підключення xmlns атрибутів:
  1. При наданні новин двома мовами необхідно додавати неймспейс xmlns:xml="http://www.w3.org/XML/1998/namespace" в форматі <rss version="2.0" xmlns:xml="http://www.w3.org/XML/1998/namespace">
  2. При використанні <content:encoded> необхідно додавати неймспейс xmlns:content="https://purl.org/rss/1.0/modules/content/" в форматі
    <rss version="2.0" xmlns:xml="http://www.w3.org/XML/1998/namespace">
  3. При підключенні RSS джерела в форматі Укрнет.Новини елемент повинен виглядати:
    <rss version="2.0" xmlns:media="https://search.yahoo.com/mrss/" xmlns:ukrnet="https://www.ukr.net">
<channel>
1. Обов'язковий елемент.
2. Знаходиться всередині елемента <rss> і включає інформацію про джерело і його вміст.
3. В <channel> може міститися будь-яка кількість елементів <item>.
<title>
1. Обов'язкове поле.
2. Назва Джерела rss, наприклад, "Наші новини".
3. Знаходиться в <channel>.
4. В випадку, якщо експортується вміст усього сайту, зазначте його назву, наприклад:
  <title>Наші новини</title>.
5. Якщо експортується розділ сайту, зазначте назву сайту і розділу через двокрапку:
  <title>Наші новини: технології</title>.
<language>
1. Обов'язкове поле у випадку якщо всі новини однією мовою.
2. Знаходиться в <channel>.
3. Якщо новини подаються двома мовами, поле має бути відсутнє, для кожної мови в <item> має бути присутній свій ідентифікатор (дивіться нижче).
4. Допустимі значення: 'uk-UA', 'ru-UA', 'ru-RU', 'uk', 'ru'.
<item>
1. Обов'язковий елемент.
2. Інформація про одну новину.
3. Знаходиться в <channel>.
4. Якщо не вказано загальну мову новин, або мова новини відрізняється від загальної, то необхідно це чітко вказати, наприклад <item xml:lang="uk-UA"> або <item xml:lang="ru-UA">.
<title>
1. Обов'язковий елемент.
2. Заголовок новини.
3. Знаходиться в <item>.
4. У заголовку новини не повинно бути HTML коду.
5. Написання заголовка повністю великими літерами (Caps Lock) не допускається.
6. Не рекомендується також наявність крапки в кінці заголовка.
7. У заголовку не повинні міститися назва джерела, дата/час повідомлення, сео-слова, назви рубрик, службові примітки («оновлено», «доповнено», «фоторепортаж», «відео» та ін.) та неінформативні звороти, які не є невід’ємною частиною заголовка (наприклад, «Терміново!» або «Сенсація»).
8. Якщо в заголовку присутні спецсимволи в явному вигляді, потрібно використовувати «<![CDATA[]]>», наприклад: <title><![CDATA[Текст заголовка зі <спецсимволами> в явному вигляді]]></title>.
<link>
1. Обов'язкове поле.
2. Посилання на новину.
3. Знаходиться в <item>.
4. 'link' вважається унікальним ідентифікатором новини від партнера, не зважаючи на те з якої RSS він прийшов.
5. Увага: кожна новина має бути розміщена на окремій сторінці, що відкривається за вказаною адресою, при цьому заголовок і початок тексту видно на першому екрані роздільної здатності 1024 × 768.
6. При переході з заголовка, розміщеного в стрічці Укрнет, повинна відкриватися тільки одна новинна сторінка з текстом, який відповідає суті заголовка.
7. Наявність по URL, вказаною в <link> більше однієї новини (стрічки новин) не допускається.
8. URL розрізняються тільки в частині до '#', тобто: https://www.some-host.ua/news.html#2545 і https://www.some-host.ua/news.html#5794 вважаються ідентичними і НЕ допускаються.
<description>
1. Необов'язковий елемент.
2. Короткий опис повідомлення.
3. Знаходиться в <item>.
4. В description описується короткий зміст новини - 3-4 речення.
5. В description не повинно бути HTML коду.
6. Якщо в description присутні спецсимволи в явному вигляді, потрібно використовувати <![CDATA[ ТЕКСТ ]]>.
<category>
1. <category> - рубрика (розділ, категорія), до якої відноситься Новина.
2. Знаходиться в <item>.
3. Якщо у партнера декілька тематичних джерел, наприклад в одному джерелі партнер передає тільки новини політики, у другому - новини економіки, то даний елемент не є обов'язковим.
4. Якщо у партнера джерело передає тільки новини для рубрики «Спорт» то даний параметр не обов'язковий.
5. Якщо джерело партнера містить новини для всіх рубрик порталу - даний параметр є обов'язковим.
<enclosure>
1. Обов'язковий елемент.
2. Зображення до новини.
3. Знаходиться в <item>.
4. Мінімальний розмір зображення - 1200 пікселів по стороні.
5. Співвідношення сторін: кращий 16:9.
6. Якщо в повідомленні міститься декілька зображень (фото), або зображення і відео файл, елемент <enclosure> повторюється.
7. Більш детально можна подивитись в прикладі «Good_RSS_Full.xml», де в кінці документа описані всі типи аудіо, відео та зображень.
8. Якщо є декілька варіантів одного зображення, що відрізняються за розміром, в <enclosure> повинен бути зазначений URL зображення найбільшого розміру.
<pubDate>
1. Обов'язкове поле.
2. Дата та час створення новини на сайті видання в форматі RFC-822 (https://www.w3.org/Protocols/rfc822/#z28), наприклад «Thu, 18 Feb 2019 16:06:02 +0200».
3. Знаходиться в <item>.
<full-text><![CDATA[<p>Текст новини, відформатований відповідно вигляду на самому сайті. HTML форматування повинне бути присутнє повністю та без змін.</p>]]></full-text>
1. Обов'язкове поле.
2. Тіло новини.
3. Знаходиться в <item>.
4. Для передачі повного тексту новин допускаються поля: <full-text>, <fulltext>, <ukrnet:fulltext>, <ukrnet:full-text>, <content:encoded>.
5. Містить повний текст новини з HTML форматуванням.
6. Обов'язково потрібно використовувати <![CDATA[ ТЕКСТ З HTML ФОРМАТУВАННЯМ ]]>.
Обмеження розміру повного тексту новини
- Максимальний розмір повного тексту новини:
  не більше 65 535 байт (≈64 КБ) у кодуванні UTF-8.
- Особливості підрахунку символів:
  1. Один символ латиниці або цифра займає 1 байт.
  2. Один символ кирилиці (українська, російська тощо) займає 2 байти.
  3. Деякі спеціальні символи, лапки, емодзі можуть займати 3–4 байти.
- Рекомендації:
  1. Для кириличного тексту обсяг 65 535 байт зазвичай відповідає приблизно 32 000–33 000 символам.
  2. Якщо текст перевищує цей ліміт, він буде не прийнятий системою.
  3. Рекомендується не перевищувати 60 000 байт, щоб уникнути відхилення при імпорті.

Зауваження: Весь текст, що знаходиться в елементах <title>, <description>, <link>, <full-text> повинен мати наступний вигляд.

Всі спецсимволи ( &, “,<,>. і тд.) в тексті повинні бути декодовані.
Якщо в тексті присутні спецсимволи ( &, “,<,>. і тд.) в явному вигляді, то текст повинен братися в тег <![CDATA[ Текст заголовка з <&спецсимволами> в явному вигляді ]]>.

Додаток 2. Приклад джерела новин для сайтів, які мають дві мовні версії (наприклад, для рубрики Події)

Якщо новини різними мовами подаються у двох окремих RSS

Українська:

<?xml version="1.0" encoding="UTF-8"?>
  <rss version="2.0">
    <channel>
      <title>Наші новини українською</title>
      <link>http://www.nashi-novyny.ua</link>
      <description>
        Тестове RSS джерело українською з мінімальним і обов'язковим набором елементів.
      </description>
      <language>uk-UA</language>
      <item>
        <title>Це перша новина українською в даному РСС</title>
        <guid xml:lang="ru-UA">https://www.nashi-novyny.ua/Persha_novyna_RUS.html</guid>
        <link>https://www.nashi-novyny.ua/Persha_novyna_UKR.html</link>
        <description>Перша новина українською в RSS.</description>
        <pubDate>Thu, 18 Feb 2010 16:06:02 +0200</pubDate>
        <category>Події</category>
        <full-text>
          <![CDATA[<p>Перша новина українською в RSS з самим мінімальним набором
              обов'язковиx елементів.</p>]]>
        </full-text>
        <enclosure url="https://www.nashi-novyny.ua/Zobrashennya_dlya_Persha_novyna_UKR.jpg"
            type="image/jpeg"/>
      </item>
    </channel>
  </rss>

Російська:


        <?xml version="1.0" encoding="UTF-8"?>
  <rss version="2.0">
    <channel>
      <title>Наши новости на русском</title>
      <link>http://www.nashi-novyny.ua</link>
      <description>Тестовый RSS источник на русском языке с минимальным и обязательным
            набором элементов.
      </description>
      <language>ru-UA</language>
      <item>
        <title>Это первая новость на русском в данном РСС</title>
        <guid xml:lang="uk-UA">https://www.nashi-novyny.ua/Persha_novyna_UKR.html</guid>
        <link>https://www.nashi-novyny.ua/Persha_novyna_RUS.html</link>
        <description>Первая новость на русском в RSS.</description>
        <pubDate>Thu, 18 Feb 2010 16:06:02 +0200</pubDate>
        <category>Події</category>
        <full-text>
            <![CDATA[<p>Первая новость на русском в RSS с самым минимальным набором
            обязательных элементов.</p>]]>
        </full-text>
        <enclosure url="https://www.nashi-novyny.ua/Zobrashennya_dlya_Persha_novyna_RUS.jpg"
            type="image/jpeg"/>
      </item>
    </channel>
  </rss>

Якщо новини подаються в одній RSS двома мовами


            <?xml version="1.0" encoding="UTF-8"?>
  <rss version="2.0">
    <channel>
      <title>Наші новини українською та россійською</title>
      <link>http://www.nashi-novyny.ua</link>
      <description>Тестове RSS джерело українською та россійською з мінімальним і обов'язковим
             набором елементів.</description>
      <item xml:lang="uk-UA">
        <title>Це перша новина українською в даному РСС</title>
        <guid xml:lang="ru-UA">https://www.nashi-novyny.ua/Persha_novyna_RUS.html</guid>
        <link>https://www.nashi-novyny.ua/Persha_novyna_UKR.html</link>
        <description>Перша новина українською в RSS.</description>
        <pubDate>Thu, 18 Feb 2010 16:06:02 +0200</pubDate>
        <category>Події</category>
        <full-text>
              <![CDATA[<p>Перша новина українською в RSS з самим мінімальним набором
             обов'язковиx елементів.</p>]]>
        </full-text>
        <enclosure url="https://www.nashi-novyny.ua/Zobrashennya_dlya_Persha_novyna_UKR.jpg"
              type="image/jpeg"/>
      </item>
      <item xml:lang="ru-UA">
        <title>Это первая новость на русском в данном РСС</title>
        <guid xml:lang="uk-UA">https://www.nashi-novyny.ua/Persha_novyna_UKR.html</guid>
        <link>https://www.nashi-novyny.ua/Persha_novyna_RUS.html</link>
        <description>Первая новость на русском в RSS.</description>
        <pubDate>Thu, 18 Feb 2010 16:06:02 +0200</pubDate>
        <category>Події</category>
        <full-text>
              <![CDATA[<p>Первая новость на русском в RSS с самым минимальным набором
                обязательных элементов.</p>]]>
        </full-text>
        <enclosure url="https://www.nashi-novyny.ua/Zobrashennya_dlya_Persha_novyna_RUS.jpg"
              type="image/jpeg"/>
      </item>
    </channel>
  </rss>

Додаток 3. Приклад Джерела з новинами для кількох рубрик

В даному випадку це джерело що поставляє новини в кілька рубрик порталу

Список відповідності рубрик

Рубрика Партнера	Рубрика Укрнет
Події	Події
Новини України	Міські новини
ФОТО	Фоторепортаж

Вміст джерела


    <?xml version="1.0" encoding="UTF-8"?>
    <rss version="2.0">
        <channel>
            <title>Наші новини </title>
            <link>https://www.nashi-novyny.ua</link>
            <description>Тестове RSS джерело, що поставляє новини в кілька категорій порталу</description>
            <item>
                <title>Це перша новина в даному РСС</title>
                <link>https://www.nashi-novyny.ua/Pervaja_novost.html</link>
                <description>
                    <![CDATA[
                        <p>Перша новина в RSS , що поставляє новини в кілька категорій порталу</p>
                    ]]>
                </description>
                <category>Події</category>
                <pubDate>Thu, 18 Feb 2010 16:06:02 +0200</pubDate>
                <full-text>
                    <![CDATA[
                        <p>Перша новина в RSS , що поставляє новини в кілька категорій порталу</p>
                    ]]>
                </full-text>
            </item>
            <item>
                <title>Це друга новина в даному РСС</title>
                <link>https://www.nashi-novyny.ua/vtoraja_novost.html</link>
                <description>
                    <![CDATA[
                        <p>Друга новина в RSS , що поставляє новини в кілька категорій порталу</p>
                    ]]>
                </description>
                <category>Новини України</category>
                <pubDate>Thu, 18 Feb 2010 16:04:02 +0200</pubDate>
                <full-text>
                    <![CDATA[
                        <p>Друга новина в RSS, що поставляє новини в кілька категорій порталу.</p>
                        <p>Текст новини в якому "<спецсимволи>" в явному вигляді.</p>
                    ]]>
                </full-text>
            </item>
            <item>
                <title>Це третя новина в даному РСС</title>
                <link>https://www.nashi-novyny.ua/tretjya_novost.html</link>
                <description>
                    <![CDATA[
                        <p>Третя новина в RSS, що поставляє новини в кілька категорій порталу.</p>
                    ]]>
                </description>
                <category>ФОТО</category>
                <pubDate>Thu, 18 Feb 2010 16:00:02 +0200</pubDate>
                <full-text>
                    <![CDATA[
                        <p>Третя новина в RSS, що поставляє новини в кілька категорій порталу.</p>
                        <p>Текст новини в якому "<спецсимволи>" в явному вигляді.</p>
                    ]]>
                </full-text>
            </item>
        </channel>
    </rss>

Корисні посилання

https://adline.kiev.ua/rssexample/Good_RSS_minimal.xml

Приклад RSS джерела, яке містить мінімальну кількість елементів RSS необхідну для передачі новин в стрічку порталу Укрнет. Зверніть увагу, що даний RSS містить новини тільки з розділу «Технології», тому в ньому немає тегів <category>.

https://adline.kiev.ua/rssexample/Good_RSS_Full.xml

Приклад RSS джерела, де можна подивитись, в якому вигляді потрібно прикріплювати мультимедіа файли до новини, а також повний список мультимедіа файлів. У цьому RSS для кожної новини вказана категорія, оскільки джерело транслює новини для усіх рубрик.

Додаткові формати

Ми також приймаємо rss в інших форматах:

WordPress
Якщо ваш сайт зроблений на WordPress, то ми приймаємо джерело новин, яке майже завжди доступне за стандартною адресою, наприклад https://your-site.ua/?feed=rss або https://your-site.ua/feed/ (в залежності від налаштувань сайту). Детальніше про RSS потоки в WordPress можна дізнатися тут (WordPress Feeds).