---
# System prepended metadata

title: STB basics

---

## Articles

![article](https://hackmd.io/_uploads/rJZ3VPOTp.png)

Коллекция которая отвечает за репрезентацию статьей на сайте. У нее может быть один регион (коллекция Article Region)
Одна категория (коллекция Article Category) (news, fun, transfers, etc.)
Одна подкатегория (коллекция Article Subcategory) (Scandals, Latest News, etc.)
Один спорт (коллекция Sport) (Football, Basketball, etc.)
Также привязка к Article League, Сompetition, Person, Team, Match. 

Опционально можно выбрать расположение новости в определенной секции которая не подходит под критерии фильтрации (детальнее смотреть коллекцию Article Section).
![article_sections](https://hackmd.io/_uploads/BJY5SvuTa.png)

`article_sections:` Выбор секций в которой необходимо разместить новость.

`position_weight:` Сортировка элементов для выбранной позиции. Чем больше значение тем статья будет отображаться ближе к началу списка. Применяется ко всем секциям. Так же  для страницы Fun с `data_type = 'article'` и `news_view = 'list-with-main-article'` главная новость определяется исходя из значения этого поля и даты создания статьи. То есть для того чтобы сделать новость главной ей необходимо поставить значение больше чем у других новостей.

Коллекция Article Section выступает в роли опредленных блоков на сайте.
![article-section-list](https://hackmd.io/_uploads/r1ck_v_p6.png)
![sections-by-position](https://hackmd.io/_uploads/BJlzbOOaT.png)
![sections-by-position-2](https://hackmd.io/_uploads/Bk7HMd_pT.png)


Для каждой локализации должна быть создана соответвующаяя секция.
![article-section-fields](https://hackmd.io/_uploads/Sk9aMuupp.png)
`stb_id`: индификатор по которому определяется секция. На данный момент их 7 (latest_news, news_slider, transfers_slider, trends, scandals_news, social_networks, videos) в дальнельйшем количество секций можно расширить.
`article_categories`: опциональная фильтрация по Article Category. Поддерживает как одно так и несколько значений.
`article_subcategories`: опциональная фильтрация по Article Subcategory. Поддерживает как одно так и несколько значений.


Коллекция Sport основополагающий фильтр для статей.
![sport](https://hackmd.io/_uploads/rJz7VbL2T.png)

Cписок типов спорта можно найти в Sidenav > Sports Types.
![Sport types](https://hackmd.io/_uploads/ry_RNbI3a.png)

## Раздел News

Главная страница новостей. При текущем фильтре у нас должны показываться только новости у которых locale: en, category: news, region: ukraine, sport: Football [URL Example](https://stb-front-stage.pages.dev/en/ukraine/football)
![sport main](https://hackmd.io/_uploads/Sk5_4Z83a.png)

Slider отображает последние статьи у которых в поле placements указан `placement: main`. Лимит 20 елементов по связке locale/category/region/sport.

Секция Trends отображает последние статьи у которых в поле placements указан `placement: trends`. Лимит 20 елементов по связке locale/category/region/sport.

Секция Latest news отображает последние статьи в подкатегории `Latest News (stb_id: latest_news)`. Лимит 10 елементов по связке locale/category/region/sport.

Секция News отображает последние статьи в подкатегории `Scandals News (stb_id: scandals_news)`

Секция Transfers отображает последние статьи категории `Transfers (stb_id: transfers)` у которых в поле placements указан `placement: main`. Лимит 20 елементов по связке locale/category/region/sport.
![transfers](https://hackmd.io/_uploads/By-1r1c2p.png)


Если для определенной секции нет данных тогда она не отображается.

## Раздел Fun

Коллекция Fun выступает в роли репрезентации отдельных категорий в соответсвующем разделе.
![fun-col](https://hackmd.io/_uploads/rkUUFGU3T.png)


У каждой категории должен быть уникальный title, slug, position.
![fun1](https://hackmd.io/_uploads/H1-WMfIha.png)

`data_type: article, quiz, voting, slots` - Тип данных которые будут отображаться на странице (на данный момент реализована только article)

Для типа данных article применимы такие конфигурации:
`article_subcategories` - список подкатегорий которые следует показывать на странице.

`news_view:`
- `list-with-main-article` - Шаблон в котором отображается главная новость. Для отображении новости как главная у нее должен быть установлен `position_weight` больше чем у других новостей соответвенной категории/подкатегории. Также рядом есть список с новостями по выбранной подкатегории. article_subcategories должен включать одну подкатегорию. Если их несколько тогда выбирается первая.
- `list-by-subcategory` - Шаблон в котором статьи разделены на отдельные секции (подкатегории). Если по данным доступна всего одна подкатегория тогда она отображается одним списком. article_subcategories может включать как одну так и несколько подкатегорий


Созданные сущности отображаются на странице [`/[lang]/fun`](https://stb-front-stage.pages.dev/en/fun) в соответствии с указаной позицией (position)
![fun-list](https://hackmd.io/_uploads/Bk_q0fUn6.png)

Визуализация сущности Fun `data_type: article, news_view: list-with-main-article` [URL Example](https://stb-front-stage.pages.dev/en/fun/this-day-in-history/ukraine/football)
![1](https://hackmd.io/_uploads/H1aelXUhT.png)

Визуализация сущности Fun `data_type: article, news_view: list-by-subcategory` [URL Example](https://stb-front-stage.pages.dev/en/fun/fans-movement/ukraine/football)
![2](https://hackmd.io/_uploads/SkZ5-7Lna.png)

Если админ захочет выбрать плейсмент Trends у статьи раздела FUN - то в таком случае данный плейсмент Trends не будет кликабельным или же вообще будет отсутствовать в списке (т.к. данный плейсмент для статьи данного раздела не поддерживается). https://youtu.be/spWVvfjg6j4

Для всех сущностей раздела ‘FUN’ пока прячем тоггл ‘Ukraine/Worldwide’ и по дефолту отображаем только статьи Worldwide. Также блокируем админу возможность выбора региона ‘Ukraine’ для категории статей ‘FUN’ (но здесь strapi ограничен в функционале - поэтому к этому позже вернемся).
https://youtu.be/j21leXnGeCU 