Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,8 @@
{
"group": "Интеграции",
"pages": [
"ru/exode-api/school/iframe/tg-mini-app"
"ru/exode-api/school/iframe/tg-mini-app",
"ru/exode-api/school/custom-code/js-config"
]
},
{
Expand Down
50 changes: 50 additions & 0 deletions ru/exode-api/school/custom-code/js-config.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: "Кастомный JS код"
description: "Настройка поведения платформы через Custom Code (JS) в админ-панели школы"
---

<Info>
В настройках школы доступно поле **Custom Code (JS)** — туда можно добавить `<script>` теги,
которые будут выполнены на каждой странице платформы. Это позволяет гибко управлять поведением интерфейса.
</Info>

## Скрытие баннера «Скачать приложение»

По умолчанию платформа показывает системный баннер с предложением скачать мобильное приложение.
Чтобы скрыть его, добавьте в **Custom Code (JS)**:

```html
<script>
(((window.exode ||= {}).common ||= {}).content ||= {}).banners ||= {};
(window.exode.common.content.banners.system ||= {}).hideDownloadAppBanner = true;
</script>
```

## Разрешить открытие в Telegram браузере (Android)

На Android при открытии школы через встроенный браузер Telegram происходит автоматический редирект в системный браузер.
Это необходимо для корректной работы DRM-видео и полноэкранного режима, которые не поддерживаются в Telegram WebView.

Если для вашей школы авто-редирект нежелателен, его можно отключить:

```html
<script>
(window.exodeJsConfig ||= {}).allowTgBrowser = true;
</script>
```

<Warning>
При отключении редиректа DRM-защищённые видео и полноэкранный режим могут работать некорректно
во встроенном браузере Telegram на Android.
</Warning>

## Все параметры

<CardGroup cols={1}>

| Параметр | Тип | По умолчанию | Описание |
|----------|-----|-------------|----------|
| `window.exode.common.content.banners.system.hideDownloadAppBanner` | `boolean` | `false` | Скрывает баннер скачивания приложения |
| `window.exodeJsConfig.allowTgBrowser` | `boolean` | `false` | Отключает авто-редирект из Telegram на Android |

</CardGroup>
19 changes: 19 additions & 0 deletions ru/exode-api/school/iframe/tg-mini-app.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,3 +47,22 @@ description: "Как создать пользователя, получить
Не передавайте токен в открытых чатах или группах. Используйте персональные ссылки.
</Warning>

## Авто-редирект из Telegram (Android)

<Info>
На Android при открытии школы через встроенный браузер Telegram происходит автоматический редирект в системный браузер.
Это необходимо для корректной работы DRM-видео и полноэкранного режима, которые не поддерживаются в Telegram WebView.
</Info>

Если для вашей школы авто-редирект нежелателен, его можно отключить через **Custom Code (JS)** в настройках школы:

```html
<script>
(window.exodeJsConfig ||= {}).allowTgBrowser = true;
</script>
```

<Tip>
Подробнее о всех доступных JS-конфигурациях читайте в разделе [Кастомный JS код](/ru/exode-api/school/custom-code/js-config).
</Tip>