Инструкция по работе с виджетом котировок валют/en: различия между версиями
Новая страница: «Currency Rates Widget Instruction Manual» |
Новая страница: «== '''Widget Description''' == This widget is a functionality that allows displaying real-time information. The widget operates as a ticker with customizable parameters. == '''Adding Widget to Personal Account''' == To add this widget to your personal account, you need to request the widget from the technical support team. It will be provided as a ".zip" archive. File:Виджет_котировок.png|thumb|center| Example of widget as ".zip" archive|800...» |
||
| Строка 1: | Строка 1: | ||
== '''Widget Description''' == | |||
== ''' | This widget is a functionality that allows displaying real-time information. The widget operates as a ticker with customizable parameters. | ||
== '''Adding Widget to Personal Account''' == | |||
== ''' | To add this widget to your personal account, you need to request the widget from the technical support team. It will be provided as a ".zip" archive. | ||
[[File:Виджет_котировок.png|thumb|center| Example of widget as ".zip" archive|800px]] | |||
[[File:Виджет_котировок.png|thumb|center| | After receiving it, log in to your personal account and navigate to the "Content" section. | ||
[[File:Раздел_контент_личного_кабиента.png|thumb|center| Example of "Content" section in personal account|800px]] | |||
[[File:Раздел_контент_личного_кабиента.png|thumb|center| | In the "Content" section, drag and drop the widget from local storage to the "Content" area. After transferring, the widget will appear in the content list. | ||
[[File:Перенос_виджета rss.png|thumb|center| Example of widget transfer via drag-n-drop|800px]] | |||
[[File:Перенос_виджета rss.png|thumb|center| | {{Note|If the personal account contains much content, use the sorting function and select "Widget" content type. This functionality allows viewing all widgets added to the personal account. | ||
{{Note| | [[File:Вилдет_в_лк.png|thumb|center| Example of proper sorting for easier widget search|800px]]|warn}} | ||
[[File:Вилдет_в_лк.png|thumb|center| | == '''Data Retrieval for Widget''' == | ||
== ''' | The widget sends API requests to obtain prices. It receives two price types: | ||
* Last trade prices for instruments; | |||
* | * Trading session closing prices for instruments. | ||
* | After receiving the response, the widget processes these prices for quotes and displays quote changes based on the data.<br> | ||
The widget then sends another API request containing these parameters: | |||
* Instrument relation (currency, stock, precious metals) to currency; | |||
* | * Icons for instrument display; | ||
* | Upon receiving the response, the widget transforms the information and displays it on the device. | ||
{{Note|The widget's API operation uses a token that can be specified in widget settings.|warn}} | |||
{{Note| | == '''Widget Configuration''' == | ||
== ''' | Locate the widget in your personal account and double-click it to access the widget's main page. | ||
[[File:Главная_страницавиджета.png|thumb|center| Example of widget's main page display|800px]] | |||
[[File:Главная_страницавиджета.png|thumb|center| | Click the gear-shaped settings icon to access widget settings. | ||
[[File:Главная_страницавиджета.png|thumb|center| Example of settings icon display|800px]] | |||
[[File:Главная_страницавиджета.png|thumb|center| | The settings page contains three configuration types: | ||
1. Basic settings - control widget operation; | |||
2. Quote settings - manage quote display in the widget; | |||
3. Debugging - handles information display parameters on the device. | |||
Below is the parameter list for each settings group. | |||
=== '''Basic Settings''' === | |||
=== ''' | Parameter list in "Basic Settings" section: | ||
* Widget background - select background color for the ticker (use HEX code [reference](https://colorscheme.ru/html-colors.html)); | |||
* | * Cache storage time - set cache storage duration in minutes; | ||
* | * Video placeholder - select video content to use as placeholder. | ||
* | [[File:Основные_настройки.png|thumb|center| Example of "Basic Settings" display|800px]] | ||
[[File:Основные_настройки.png|thumb|center| | === '''Quotes Settings''' === | ||
=== ''' | Parameter list in "Quotes Settings" section: | ||
* Token - specify API connection token; | |||
* | * Request frequency - set request frequency in seconds; | ||
* | * Add quote - opens modal window for quote creation: | ||
* | ** Quote name - specify name for quote configuration; | ||
** | ** Instrument ID - enter instrument ID received via API; | ||
** | ** Lot to RUB ratio - specify number of lots per ruble. | ||
** | [[File:Настройки_котировок.png|thumb|center| Example of "Quotes Settings" display|800px]] | ||
[[File:Настройки_котировок.png|thumb|center| | === '''Debugging''' === | ||
=== ''' | Parameter list in "Debugging" section: | ||
* Widget width in pixels - set widget width; | |||
* | * Screen segment height - specify segment height in pixels; | ||
* | * Segment width (segments 1-8) - set segment width in pixels; | ||
* | * X-axis segment offset (segments 1-8) - specify horizontal offset in pixels. | ||
* | [[File:Настройки_отладка.png|thumb|center| Example of "Debugging" settings display|800px]] | ||
[[File:Настройки_отладка.png|thumb|center| | == '''Completing Widget Setup''' == | ||
== ''' | {{Note|After completing widget configuration, click "Apply Settings" in bottom right corner. | ||
{{Note| | [[File:Применение_настрок.png|thumb|center| Example of "Apply Settings" button|800px]] | ||
[[File:Применение_настрок.png|thumb|center| | The widget will expand to full screen - then click "Save" at bottom center. | ||
[[File:Сохран.png|thumb|center| Example of "Save" button display|800px]]|warn}} | |||
[[File:Сохран.png|thumb|center| | == '''Loading/Downloading Settings''' == | ||
== ''' | While configuring the widget, users can upload/download settings. These actions are available via separate icons in widget interface (bottom center). | ||
[[File:Иконки_загрузки.png|thumb|center| Example of settings upload/download icons|800px]] | |||
[[File:Иконки_загрузки.png|thumb|center| | == '''Adding Configured Widget to Broadcast''' == | ||
== ''' | To fully explore this functionality, users need to launch a scheduled broadcast and add this widget as content. For steps on creating broadcasts and schedules, refer to these Wikipedia articles: | ||
* [[Раздел "Устройства"]] | * [[Раздел "Устройства"]] | ||
* [[Раздел "Контент на устройства"]] | * [[Раздел "Контент на устройства"]] | ||
* [[Раздел "Трансляции"]] | * [[Раздел "Трансляции"]] | ||
* [[Раздел "Расписание"]] | * [[Раздел "Расписание"]] | ||
== ''' | == '''Video Tutorial''' == | ||
[https://vk.com/video-227547238_456239059 | [https://vk.com/video-227547238_456239059 Currency Quotes Widget] | ||
== ''' | == '''Additional Information''' == | ||
If this article doesn't help or questions remain, please post them in the "Discussions" section at the top of the page. | |||
[[File:Обсуждение_котировки_валю.png|thumb|center| | [[File:Обсуждение_котировки_валю.png|thumb|center| Example of "Discussions" tab on wiki-page|800px]] | ||
More information available at [[Как взаимодействовать пользователю с разделом "Обсуждения"]] | |||
Текущая версия от 10:41, 7 мая 2025
Widget Description
This widget is a functionality that allows displaying real-time information. The widget operates as a ticker with customizable parameters.
Adding Widget to Personal Account
To add this widget to your personal account, you need to request the widget from the technical support team. It will be provided as a ".zip" archive.

After receiving it, log in to your personal account and navigate to the "Content" section.

In the "Content" section, drag and drop the widget from local storage to the "Content" area. After transferring, the widget will appear in the content list.


Data Retrieval for Widget
The widget sends API requests to obtain prices. It receives two price types:
- Last trade prices for instruments;
- Trading session closing prices for instruments.
After receiving the response, the widget processes these prices for quotes and displays quote changes based on the data.
The widget then sends another API request containing these parameters:
- Instrument relation (currency, stock, precious metals) to currency;
- Icons for instrument display;
Upon receiving the response, the widget transforms the information and displays it on the device.
Widget Configuration
Locate the widget in your personal account and double-click it to access the widget's main page.

Click the gear-shaped settings icon to access widget settings.

The settings page contains three configuration types: 1. Basic settings - control widget operation; 2. Quote settings - manage quote display in the widget; 3. Debugging - handles information display parameters on the device. Below is the parameter list for each settings group.
Basic Settings
Parameter list in "Basic Settings" section:
- Widget background - select background color for the ticker (use HEX code [reference](https://colorscheme.ru/html-colors.html));
- Cache storage time - set cache storage duration in minutes;
- Video placeholder - select video content to use as placeholder.

Quotes Settings
Parameter list in "Quotes Settings" section:
- Token - specify API connection token;
- Request frequency - set request frequency in seconds;
- Add quote - opens modal window for quote creation:
** Quote name - specify name for quote configuration; ** Instrument ID - enter instrument ID received via API; ** Lot to RUB ratio - specify number of lots per ruble.

Debugging
Parameter list in "Debugging" section:
- Widget width in pixels - set widget width;
- Screen segment height - specify segment height in pixels;
- Segment width (segments 1-8) - set segment width in pixels;
- X-axis segment offset (segments 1-8) - specify horizontal offset in pixels.

Completing Widget Setup

The widget will expand to full screen - then click "Save" at bottom center.

Loading/Downloading Settings
While configuring the widget, users can upload/download settings. These actions are available via separate icons in widget interface (bottom center).

Adding Configured Widget to Broadcast
To fully explore this functionality, users need to launch a scheduled broadcast and add this widget as content. For steps on creating broadcasts and schedules, refer to these Wikipedia articles:
Video Tutorial
Additional Information
If this article doesn't help or questions remain, please post them in the "Discussions" section at the top of the page.

More information available at Как взаимодействовать пользователю с разделом "Обсуждения"