# Базовый сервис

<preview-image name="services/base" />

Основная карточка сервиса.
На основе этого сервиса создаются другие.

## Название

Заголовок сервиса

```yaml
title: Home Assistant
```

## Описание

Дополнительное описание, которое отображается сразу под заголовком.
Это поле удобно, когда у вас два одинаковых сервиса, но их нужно как-то различать.

```yaml
description: Автоматизация дома
```

## Ссылка

Ссылка на сервис. Используется при нажатии на иконку и заголовок.
Также с помощью нее происходить проверка [статуса](#статус) доступности.

```yaml
link: https://home-assistant.home.local/
```

## Target <in-version value="0.7.6" />

Поведение браузера при нажатии на сервис.
С помощью этого свойства, можно сделать открытие сервиса в текущем или новом окне.

```yaml
target: _blank
```

Поддерживаемые значения:

| Значение  | Описание                                                                                                                |
|-----------|-------------------------------------------------------------------------------------------------------------------------|
| `_blank`  | Загружает страницу в новое окно браузера                                                                                |
| `_self`   | Загружает страницу в текущее окно                                                                                       |
| `_parent` | Загружает страницу во фрейм-родитель, если фреймов нет, то это значение работает как `_self`                            |
| `_top`    | Отменяет все фреймы и загружает страницу в полном окне браузера, если фреймов нет, то это значение работает как `_self` |

Значение по умолчанию: `_blank`

::: warning Внимание
Данное свойство имеет приоритет над `behaviour.target` из `config.yml`. Подробнее можно прочитать в [конфигурации](../reference/configuration.md#target)
:::

## Иконка

Иконка сервиса. Позволяет очень быстро найти необходимы элемент.
Данное поле можно очень гибко настраивать комбинируя разные параметры.

###
```yaml
icon:
  name: simple-icons:homeassistant
  wrap: true
```

или из локальный файлов:

```yaml
icon:
  url: icons/homeassistant.svg
  background: '#eee'
```

::: warning Настройка
Подробнее описано в разделе [иконки](../reference/icons.md).
:::

## Теги <in-version value="0.10.0" />

Теги позволяют разграничивать сервисы. Довольно удобно, когда у вас есть несколько сервисов, которые относятся к одному и тому же проекту.

```yaml
tags:
  - name: Дом
    color: green
```

или из глобальных тегов:

```yaml
tags:
  - Дом
```

::: warning Настройка
Подробнее описано в разделе [теги](../reference/tags.md).
:::

## Статус

Mafl умеет отслеживать работоспособность сервисов по ссылке, которую вы указали.

```yaml
status:
  enabled: true
  interval: 60 # можно не указывать
```

### `enabled`

Статус включения

Поддерживаемые значения: `true`, `false`

Значение по умолчанию: `false`

### `animation`

Анимация статуса

Поддерживаемые значения: `true`, `false`

Значение по умолчанию: `true`

### `interval`

Интервал обновления статуса.

Поддерживаемые значения: `число`

Значение по умолчанию: `60` секунд

::: warning Внимание
Не рекомендуем менять интервал. Это может спровоцировать большую нагрузку на систему, если у вас очень много разных сервисов.
:::

## Примеры

### Базовый сервис

::: code-group
```yaml [config.yml]
services:
  - title: Home Assistant
    description: Автоматизация дома
    link: https://home-assistant.home.local/
    icon:
      name: simple-icons:homeassistant
      wrap: true
      color: '#3dbcf3'
```
:::

### Отслеживание статуса

::: code-group
```yaml [config.yml]
services:
  - title: Home Assistant
    description: Автоматизация дома
    link: https://home-assistant.home.local/
    icon:
      name: simple-icons:homeassistant
      wrap: true
      color: '#3dbcf3'
    status:
      enabled: true
```
:::
