Виджет авторизации Ver.2.0/en: различия между версиями

Материал из SmartPlayer
Новая страница: «Authorization Widget Ver. 2.0»
 
Нет описания правки
 
(не показаны 2 промежуточные версии 2 участников)
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
<language/>
== '''Описание ситуации''' ==
== '''Description of the Situation''' ==
Виджет авторизации — это инструмент, который позволял пользователям проводить автоматическую авторизацию на платформах при отображении, путём наложения виртуальных элементов (полей и кнопок) на скриншоты страниц авторизации. Для работы виджет использует URL-адрес страницы авторизации и сопоставляет изображение на скриншоте с отображаемой по URL страницей. Таким образом, процесс авторизации автоматизируется.<br>
The Authorization Widget is a tool that previously allowed users to perform automatic authorization on platforms during display by overlaying virtual elements (fields and buttons) onto screenshots of authorization pages.
Новая версия виджета предлагает дополнительные возможности к логике работы функционала, упрощает взаимодействие и делает пользовательский опыт более позитивным.<br>
The widget uses the URL of the authorization page and matches the screenshot image with the page displayed at that URL. Thus, the authorization process becomes automated.<br>
Ознакомиться с работой первой версии виджета можно по ссылке [https://wiki.smartplayer.org/index.php?title=%D0%92%D0%B8%D0%B4%D0%B6%D0%B5%D1%82_%D0%B0%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8 здесь]  
The new version of the widget offers additional improvements to the functional logic, simplifies interaction, and enhances the overall user experience.<br>
== '''Добавление виджета в личный кабинет''' ==
You can ознакомиться with the first version of the widget at the following link [https://wiki.smartplayer.org/index.php?title=%D0%92%D0%B8%D0%B4%D0%B6%D0%B5%D1%82_%D0%B0%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8 here]
Чтобы добавить виджет в личный кабинет, пользователю нужно запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате .zip - архива.
== '''Adding the Widget to the Personal Account''' ==
[[File:Виджет_авторизации_2.0.png|thumb|center| Пример виджета в формате .zip - архива|800px]]
To add the widget to the personal account, the user must request a content archive from a SmartPlayer technical support specialist. It will be provided in `.zip` format.
После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент».
[[File:Виджет_авторизации_2.0.png|thumb|center| Example of the widget in .zip format |800px]]
[[File:Лк_контент.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете |800px]]
After that, the user must log in to the personal account and navigate to the “Content” section.
В разделе «Контент» перетаскиваем виджет из локального хранилища в личный кабинет. После того как пользователь перенесет виджет в личный кабинет, он отобразится в списке с контентом.
[[File:Лк_контент.png|thumb|center| Example of the “Content” section in the personal account |800px]]
[[File:Виджет_авторизации.png|thumb|center| Пример отображения переноса виджета с помощью drag-and-drop|800px]]
In the “Content” section, drag and drop the widget from local storage into the personal account. Once transferred, it will appear in the content list.
== '''Главная страница виджета''' ==
[[File:Виджет_авторизации.png|thumb|center| Example of transferring the widget via drag-and-drop |800px]]
После переноса виджета для первичной настройки пользователь должен дважды кликнуть по иконке. Данное действие перенесет его на главную страницу виджета.
== '''Widget Main Page''' ==
[[File:Базовая_страница.png|thumb|center| Пример отображения главной страницы виджета|800px]]
After transferring the widget, double-click its icon for initial configuration. This action will open the widget’s main page.
На главной странице виджета отображается:
[[File:Базовая_страница.png|thumb|center| Example of the widget main page |800px]]
* инструкция по использованию виджета (главный экран, на котором после настройки будут отображены шаги с полями и кнопками самого виджета);
The widget main page displays:
* кнопки управления виджетом;
* usage instructions (main screen where configured steps with fields and buttons will later be displayed);
* колонка учёта шагов.
* widget control buttons;
[[File:Главная_страница_и_инструкция.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]]
* steps tracking column.
{{Note|При необходимости, можно открыть инструкцию снова, кликнув на иконку в виде знака «?».|warn}}
[[File:Главная_страница_и_инструкция.png|thumb|center| Example of the settings navigation icon |800px]]
== '''Общие настройки виджета''' ==
{{Note|If necessary, the instructions can be reopened by clicking the “?” icon.|warn}}
Кликнув на кнопку «Настройки» с иконкой в виде шестерёнки откроется страница с общими настройками виджета. На этой странице можно настроить следующие параметры:
== '''General Widget Settings''' ==
* выбор языка позволяет выбрать один из доступных для работы виджета языков. Доступные языки — русский, английский, испанский, португальский, казахский;
Clicking the “Settings” button (gear icon) opens the general widget settings page. The following parameters can be configured:
* адрес страницы вставить URL-ссылку на нужную страницу авторизации;
* language selection choose one of the supported languages (Russian, English, Spanish, Portuguese, Kazakh);
* чекбокс (галочка) «Запустить десктопную версию» активирует/деактивирует масштабирование элементов, отображаемых на экране по размерам экрана устройства вывода данных;
* page address insert the URL of the required authorization page;
* интервал обновления страницы указать значения для интервала обновления страницы. Измеряется в секундах. Минимальное значение — 30 секунд;
* checkbox “Launch desktop version” enables/disables scaling of elements according to the display device screen size;
* чекбокс (галочка) «Автоскрол» активирует/деактивирует автоматический скролл на странице после прохождения процесса авторизации;
* page refresh interval set the refresh interval in seconds (minimum value — 30 seconds);
* скорость автоскролла прописывается значение для учета скорости автоскролла. Измеряется в процентах (%). Минимальное значение — 1, максимальное - 100. Если значение будет вне диапазона, будут использоваться ближайшие пограничные к диапазону значения;
* checkbox “Auto-scroll” enables/disables automatic scrolling after the authorization process;
* задержка перед началом автоскролла прописывается значение задержки, запуска работы автоскролла. Измеряется в миллисекундах;
* auto-scroll speed set scroll speed in percent (%). Minimum value — 1, maximum — 100. If outside the range, nearest boundary values will be used;
* выбрать изображение позволяет выбрать загруженные изображения из папки, расположенной в личном кабинете SmartPlayer.
* delay before auto-scroll start set delay value in milliseconds;
[[File:Настройки общие для виджета.png|thumb|center| Пример отображения общих настроек виджета|800px]]
* select image choose uploaded images from the SmartPlayer personal account folder.
=== '''Загрузка и скачивание настроек''' ===
[[File:Настройки общие для виджета.png|thumb|center| Example of general widget settings |800px]]
В процессе взаимодействия с настройками виджета пользователь может загрузить или выгрузить настройки виджета. Каждое из указанных действий можно сделать с помощью отдельных иконок в интерфейсе виджета. Иконки расположены в виджете снизу по центру.
=== '''Uploading and Downloading Settings''' ===
[[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок в настройках виджета |800px]]
While working with widget settings, the user can import or export widget settings. Each action is performed using separate icons located at the bottom center of the widget interface.
=== '''Завершение общих настроек виджета''' ===
[[File:Иконки_загрузки.png|thumb|center| Example of settings import/export icons |800px]]
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана. Либо пользователь может не сохранять выставленные настройки по кнопке «Сбросить».
=== '''Completing General Settings''' ===
[[File:Применение_настрок.png|thumb|center| Пример отображения кнопок «Применить настройки» и «Сбросить»|800px]]
After configuring settings, click “Apply settings” in the bottom-right corner. Alternatively, click “Reset” to discard changes.
Далее виджет растянется на весь экран и пользователь должен нажать на кнопку «Сохранить», внизу по центру экрана.
[[File:Применение_настрок.png|thumb|center| Example of “Apply settings” and “Reset” buttons |800px]]
[[File:Сохран.png|thumb|center| Пример отображения кнопки «Сохранить»|800px]]
Then the widget will expand to full screen. Click “Save” at the bottom center of the screen.
== '''Добавление шага''' ==
[[File:Сохран.png|thumb|center| Example of the “Save” button |800px]]
После завершения общих настроек виджета в левой нижней части экрана для пользователя станет активна кнопка «Добавить шаг». По клику на нее изменится отображение страницы:
== '''Adding a Step''' ==
* будут отображены новые кнопки:
After completing general settings, the “Add step” button becomes active in the bottom-left corner. Clicking it changes the page display:
** выбрать скриншот;  
* new buttons appear:
** добавить действие.
** select screenshot;
* в колонке «Шаги авторизации» появится новый шаг и две кнопки:
** add action.
** применить;
* a new step appears in the “Authorization steps” column with two buttons:
** блок схема.
** apply;
* в левом верхнем углу появится обозначение текущего шага в виде кнопки (является кликабельной кнопкой)
** flowchart.
[[File:Изменения_добавления_шага.png|thumb|center| Пример отображения изменений при добавлении шага|800px]]
* in the top-left corner, the current step appears as a clickable button. 
=== '''Выбор скриншота''' ===
[[File:Изменения_добавления_шага.png|thumb|center| Example of changes after adding a step |800px]]
По нажатию на одноименную кнопку откроется модальное окно, в котором загружены все скриншоты из папки.
=== '''Selecting a Screenshot''' ===
В этом окне выбрать нужный для шага скриншот.
Clicking the corresponding button opens a modal window containing all screenshots from the folder. Select the required screenshot for the step.
[[File:Скрин_авторизации.png|thumb|center| Пример отображения модального окна с выбором скриншота|800px]]
[[File:Скрин_авторизации.png|thumb|center| Example of screenshot selection modal window |800px]]
После выбора название скриншота будет отображено в колонке «Шаги авторизации» для первого шага.  
The screenshot name will appear in the “Authorization steps” column.
[[File:Изменение_шагов_авторизации.png|thumb|center| Пример отображения изменений в колонке «Шаги авторизации» |800px]]
[[File:Изменение_шагов_авторизации.png|thumb|center| Example of updated “Authorization steps” column |800px]]
=== '''Добавить действие''' ===
=== '''Add Action''' ===
По нажатию на одноименную кнопку откроется выбор с двумя вариантами действий:
Clicking the corresponding button allows choosing between two action types:
* добавить поле ввода создаёт на экране поле для наложения и ввода данных накладываемое на поле авторизации;
* add input field creates an overlay field for entering data;
* добавить кнопку создаёт кнопку, которая выполняет клик и накладывается на кнопки, которые есть на страницах авторизации, для исоплнения действия;
* add button creates a clickable overlay button for authorization page actions. 
[[File:Добавление_действий.png|thumb|center| Пример отображения функциональности кнопки |800px]]
[[File:Добавление_действий.png|thumb|center| Example of action button functionality |800px]]
После создания поля и кнопки пользователь размещает их на экране со скриншотом.  
After creating fields and buttons, position them on the screenshot.
[[File:Поле_ввода_и_кнопка.png|thumb|center| Пример отображения поля ввода и кнопки |800px]]
[[File:Поле_ввода_и_кнопка.png|thumb|center| Example of input field and button placement |800px]]
Добавленные действия также отобразятся в колонке «Шаги авторизации» внутри текущего шага.
Added actions will appear in the “Authorization steps” column.
[[File:Действия_для_текущего_шага.png|thumb|center| Пример отображения в колонке «Шаги авторизации» |800px]]
[[File:Действия_для_текущего_шага.png|thumb|center| Example of actions in the “Authorization steps” column |800px]]
При перемещении элементов откроется панель с параметрами для настройки выбранного элемента. О параметрах поля и кнопки будет описано ниже в разделе. Также при перемещении подсвечивается только выбранный пользователем элемент.
== '''Authorization Steps Column''' ==
== '''Колонка «Шаги авторизации»''' ==
The column displays a list of all steps and their actions.
В колонке «Шаги авторизации» отображается список всех шагов с действиями.
[[File:Отображение_шагов_авторизации.png|thumb|center| Example of the “Authorization steps” column |800px]]
[[File:Отображение_шагов_авторизации.png|thumb|center| Пример отображения колонки «Шаги авторизации» |800px]]
Each step contains:
Эта колонка состоит из списка шагов, внутри которых описаны:
* screenshot name;
* название картинки;
* input field (editable via gear icon or removable via cross icon);
* поле ввода(можно отредактировать с помощью клика на иконку шестерёнки или удалить по иконке крестика);
* action button (editable via gear icon or removable via cross icon).
* кнопка действия(можно отредактировать с помощью клика на иконку шестерёнки или удалить по иконке крестика).
[[File:Расппеделение_по_шагу_.png|thumb|center| Example of step structure in the column |800px]]
[[File:Расппеделение_по_шагу_.png|thumb|center| Пример отображения колонки «Шаги авторизации» |800px]]
Each step can be deleted via “Delete step”. Actions inside a step can also be removed individually.
Каждый шаг можно удалить по отдельной кнопке «Удалить шаг». Также в каждом шаге можно удалить действия оставив его пустым (только с картинкой), при необходимости.<br>
Click the blue “Apply” button at the bottom of the column to apply all steps and settings. The widget will display a confirmation modal window.
Чтобы применить все действия и настройки для шагов кликнуть на синюю кнопку «Применить», расположенную внизу колонки «Шаги авторизации». Виджет оповестит пользователя об успешном применении шагов модальным окном с подтверждением.
[[File:Применения_шагов.png|thumb|center| Example of confirmation modal window |800px]]
[[File:Применения_шагов.png|thumb|center| Пример отображения модального окна с подтверждением сохранения настроек |800px]]
=== '''Configuring Input Field and Action Button''' ===
=== '''Настройка поля ввода и кнопки действия''' ===
{{Note|Some parameters described here automatically change when dragging elements within the widget screen.|warn}}
{{Note|Некоторые параметры, описанные в этом разделе автоматически изменяются если вы перетаскиваете поле или кнопку в рамках экрана виджета.|warn}}
Click the gear icon next to a field or button to open its settings.
Кликнув по иконке в виде шестеренки рядом с кнопкой или полем пользователь может перейти в настройки данного элемента.<br>
Button settings:
Кнопка включает в себя следующие настройки:
* name;
* имя — ввести название кнопки;
* X coordinate (pixels);
* координата X — прописать числовое значение координаты в пикселях;
* Y coordinate (pixels);
* координата Y — прописать числовое значение координаты в пикселях;
* width (pixels);
* ширина — прописать числовое значение в пикселях;
* height (pixels);
* высота — прописать числовое значение в пикселях;
* delay time (milliseconds before click).
* время задержки — прописать числовое значение, которое указывает задержку перед нажатием кнопки. Измеряется в миллисекундах.
[[File:Настройки_кнопки.png|thumb|center| Example of button settings |800px]]
[[File:Настройки_кнопки.png|thumb|center| Пример отображения параметров для кнопки |800px]]
Field settings:
Поле включает в себя настройки:
* name;
* имя — ввести название поля;
* value (text inserted into field);
* значение — прописать значение, которое будет введено в поле при наложении на изображение;
* X coordinate;
* координата X — прописать числовое значение координаты в пикселях;
* Y coordinate;
* координата Y — прописать числовое значение координаты в пикселях;
* width;
* ширина — прописать числовое значение в пикселях;
* height;
* высота — прописать числовое значение в пикселях;  
* delay time (milliseconds before input).
* время задержки — прописать числовое значение, которое указывает задержку перед вводом значения в поле. Измеряется в миллисекундах.
[[File:Настройки_поля.png|thumb|center| Example of field settings |800px]]
[[File:Настройки_поля.png|thumb|center| Пример отображения для полей|800px]]
Click the blue “Apply” button at the bottom of the column to save changes.
В обоих случаях для применения изменённых настроек кнопки или поля нажать на синюю кнопку «Применить» внизу колонки.
[[File:Кнопка_применить в видежте.png|thumb|center| Example of the “Apply” button |800px]]
[[File:Кнопка_применить в видежте.png|thumb|center| Пример отображения кнопки «Применить» |800px]]
=== '''Flowchart''' ===
=== '''Блок-схема''' ===
Clicking “Flowchart” displays a visual flowchart showing steps and actions within each step. This allows clearer understanding of the authorization logic built in the widget.
При клике на кнопку «Блок-схема» перед пользователем появится блок-схема с последовательностью шагов и действий внутри каждого шага. Это позволит более наглядно просмотреть и понять текущую логику авторизации построенную пользователем в виджете.
[[File:Блока_схема_шагов.png|thumb|center| Example of the flowchart |800px]]
[[File:Блока_схема_шагов.png|thumb|center| Пример отображения блок-схемы|800px]]
== '''Adding the Configured Widget to a Broadcast''' ==
== '''Добавление настроенного виджета в трансляцию''' ==
To fully review this functionality, launch a scheduled broadcast and add the widget as content. For details on creating broadcasts and schedules, review the following articles:
Чтобы полностью ознакомиться с работой данной функциональности, запустить трансляцию с расписанием и добавить в качестве контента виджет. Чтобы ознакомиться с описанными ранее шагами по созданию трансляции и расписания рекомендуется просмотреть следующие статьи из Wikipedia:
* [[Раздел "Устройства"]]
* [[Раздел "Устройства"]]
* [[Раздел "Контент на устройства"]]
* [[Раздел "Контент на устройства"]]
* [[Раздел "Трансляции"]]
* [[Раздел "Трансляции"]]
* [[Раздел "Расписание"]]
* [[Раздел "Расписание"]]
== '''Видеоинструкция''' ==
== '''Video Instruction''' ==
[https://vk.com/video-227547238_456239099 Настройка виджета авторизации ver. 2.0]
[https://vkvideo.ru/video-227547238_456239116 Authorization Widget Setup ver. 2.0]
== '''Дополнительная информация''' ==
== '''Additional Information''' ==
Если данная статья не помогает использовать функционал по назначению, или после её прочтения остаются вопросы, их можно озвучить в разделе "Обсуждения" вверху страницы.
If this article does not help you use the functionality as intended, or if questions remain, they can be raised in the “Discussions” section at the top of the page.
[[File:Обсуждение_авторизации.png|thumb|center| Пример отображения вкладки «Обсуждения» на wiki-странице |800px]]
[[File:Обсуждение_авторизации.png|thumb|center| Example of the “Discussions” tab on the wiki page |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
Additional information is available on the page [[How users interact with the "Discussions" section]]
</div>

Текущая версия от 11:59, 6 марта 2026

<language/>

Description of the Situation

The Authorization Widget is a tool that previously allowed users to perform automatic authorization on platforms during display by overlaying virtual elements (fields and buttons) onto screenshots of authorization pages. The widget uses the URL of the authorization page and matches the screenshot image with the page displayed at that URL. Thus, the authorization process becomes automated.
The new version of the widget offers additional improvements to the functional logic, simplifies interaction, and enhances the overall user experience.
You can ознакомиться with the first version of the widget at the following link here

Adding the Widget to the Personal Account

To add the widget to the personal account, the user must request a content archive from a SmartPlayer technical support specialist. It will be provided in `.zip` format.

Example of the widget in .zip format

After that, the user must log in to the personal account and navigate to the “Content” section.

Example of the “Content” section in the personal account

In the “Content” section, drag and drop the widget from local storage into the personal account. Once transferred, it will appear in the content list.

Example of transferring the widget via drag-and-drop

Widget Main Page

After transferring the widget, double-click its icon for initial configuration. This action will open the widget’s main page.

Example of the widget main page

The widget main page displays:

  • usage instructions (main screen where configured steps with fields and buttons will later be displayed);
  • widget control buttons;
  • steps tracking column.
Example of the settings navigation icon
If necessary, the instructions can be reopened by clicking the “?” icon.

General Widget Settings

Clicking the “Settings” button (gear icon) opens the general widget settings page. The following parameters can be configured:

  • language selection — choose one of the supported languages (Russian, English, Spanish, Portuguese, Kazakh);
  • page address — insert the URL of the required authorization page;
  • checkbox “Launch desktop version” — enables/disables scaling of elements according to the display device screen size;
  • page refresh interval — set the refresh interval in seconds (minimum value — 30 seconds);
  • checkbox “Auto-scroll” — enables/disables automatic scrolling after the authorization process;
  • auto-scroll speed — set scroll speed in percent (%). Minimum value — 1, maximum — 100. If outside the range, nearest boundary values will be used;
  • delay before auto-scroll start — set delay value in milliseconds;
  • select image — choose uploaded images from the SmartPlayer personal account folder.
Example of general widget settings

Uploading and Downloading Settings

While working with widget settings, the user can import or export widget settings. Each action is performed using separate icons located at the bottom center of the widget interface.

Example of settings import/export icons

Completing General Settings

After configuring settings, click “Apply settings” in the bottom-right corner. Alternatively, click “Reset” to discard changes.

Example of “Apply settings” and “Reset” buttons

Then the widget will expand to full screen. Click “Save” at the bottom center of the screen.

Example of the “Save” button

Adding a Step

After completing general settings, the “Add step” button becomes active in the bottom-left corner. Clicking it changes the page display:

  • new buttons appear:
    • select screenshot;
    • add action.
  • a new step appears in the “Authorization steps” column with two buttons:
    • apply;
    • flowchart.
  • in the top-left corner, the current step appears as a clickable button.
Example of changes after adding a step

Selecting a Screenshot

Clicking the corresponding button opens a modal window containing all screenshots from the folder. Select the required screenshot for the step.

Example of screenshot selection modal window

The screenshot name will appear in the “Authorization steps” column.

Example of updated “Authorization steps” column

Add Action

Clicking the corresponding button allows choosing between two action types:

  • add input field — creates an overlay field for entering data;
  • add button — creates a clickable overlay button for authorization page actions.
Example of action button functionality

After creating fields and buttons, position them on the screenshot.

Example of input field and button placement

Added actions will appear in the “Authorization steps” column.

Example of actions in the “Authorization steps” column

Authorization Steps Column

The column displays a list of all steps and their actions.

Example of the “Authorization steps” column

Each step contains:

  • screenshot name;
  • input field (editable via gear icon or removable via cross icon);
  • action button (editable via gear icon or removable via cross icon).
Example of step structure in the column

Each step can be deleted via “Delete step”. Actions inside a step can also be removed individually. Click the blue “Apply” button at the bottom of the column to apply all steps and settings. The widget will display a confirmation modal window.

Example of confirmation modal window

Configuring Input Field and Action Button

Some parameters described here automatically change when dragging elements within the widget screen.

Click the gear icon next to a field or button to open its settings. Button settings:

  • name;
  • X coordinate (pixels);
  • Y coordinate (pixels);
  • width (pixels);
  • height (pixels);
  • delay time (milliseconds before click).
Example of button settings

Field settings:

  • name;
  • value (text inserted into field);
  • X coordinate;
  • Y coordinate;
  • width;
  • height;
  • delay time (milliseconds before input).
Example of field settings

Click the blue “Apply” button at the bottom of the column to save changes.

Example of the “Apply” button

Flowchart

Clicking “Flowchart” displays a visual flowchart showing steps and actions within each step. This allows clearer understanding of the authorization logic built in the widget.

Example of the flowchart

Adding the Configured Widget to a Broadcast

To fully review this functionality, launch a scheduled broadcast and add the widget as content. For details on creating broadcasts and schedules, review the following articles:

Video Instruction

Authorization Widget Setup ver. 2.0

Additional Information

If this article does not help you use the functionality as intended, or if questions remain, they can be raised in the “Discussions” section at the top of the page.

Example of the “Discussions” tab on the wiki page

Additional information is available on the page How users interact with the "Discussions" section