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

Материал из SmartPlayer
Новая страница: «Authorization Widget Ver. 2.0»
 
Обновление для соответствия новой версии исходной страницы.
 
(не показана 1 промежуточная версия 1 участника)
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
<language/>
== '''Описание ситуации''' ==
<div class="mw-translate-fuzzy">
Виджет авторизации — это инструмент, который позволял пользователям проводить автоматическую авторизацию на платформах при отображении, путём наложения виртуальных элементов (полей и кнопок) на скриншоты страниц авторизации. Для работы виджет использует URL-адрес страницы авторизации и сопоставляет изображение на скриншоте с отображаемой по URL страницей. Таким образом, процесс авторизации автоматизируется.<br>
== '''Description of the Situation''' ==
Новая версия виджета предлагает дополнительные возможности к логике работы функционала, упрощает взаимодействие и делает пользовательский опыт более позитивным.<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.
Ознакомиться с работой первой версии виджета можно по ссылке [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 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>
== '''Добавление виджета в личный кабинет''' ==
The new version of the widget offers additional improvements to the functional logic, simplifies interaction, and enhances the overall user experience.<br>
Чтобы добавить виджет в личный кабинет, пользователю нужно запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате .zip - архива.
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]
[[File:Виджет_авторизации_2.0.png|thumb|center| Пример виджета в формате .zip - архива|800px]]
== '''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.
[[File:Лк_контент.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете |800px]]
[[File:Виджет_авторизации_2.0.png|thumb|center| Example of the widget in .zip format |800px]]
В разделе «Контент» перетаскиваем виджет из локального хранилища в личный кабинет. После того как пользователь перенесет виджет в личный кабинет, он отобразится в списке с контентом.
After that, the user must log in to the personal account and navigate to the “Content” section.
[[File:Виджет_авторизации.png|thumb|center| Пример отображения переноса виджета с помощью drag-and-drop|800px]]
[[File:Лк_контент.png|thumb|center| Example of the “Content” section in the personal account |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]]
[[File:Базовая_страница.png|thumb|center| Пример отображения главной страницы виджета|800px]]
== '''Widget Main Page''' ==
На главной странице виджета отображается:
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);
[[File:Главная_страница_и_инструкция.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]]
* widget control buttons;
{{Note|При необходимости, можно открыть инструкцию снова, кликнув на иконку в виде знака «?».|warn}}
* steps tracking column.
== '''Общие настройки виджета''' ==
[[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''' ==
* адрес страницы вставить URL-ссылку на нужную страницу авторизации;
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);
* интервал обновления страницы указать значения для интервала обновления страницы. Измеряется в секундах. Минимальное значение — 30 секунд;
* 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;
* скорость автоскролла прописывается значение для учета скорости автоскролла. Измеряется в процентах (%). Минимальное значение — 1, максимальное - 100. Если значение будет вне диапазона, будут использоваться ближайшие пограничные к диапазону значения;
* page refresh interval set the refresh interval in seconds (minimum value — 30 seconds);
* задержка перед началом автоскролла прописывается значение задержки, запуска работы автоскролла. Измеряется в миллисекундах;
* checkbox “Auto-scroll” enables/disables automatic scrolling after the authorization process;
* выбрать изображение позволяет выбрать загруженные изображения из папки, расположенной в личном кабинете SmartPlayer.
* auto-scroll speed set scroll speed in percent (%). Minimum value — 1, maximum — 100. If outside the range, nearest boundary values will be used;
[[File:Настройки общие для виджета.png|thumb|center| Пример отображения общих настроек виджета|800px]]
* delay before auto-scroll start set delay value in milliseconds;
=== '''Загрузка и скачивание настроек''' ===
* select image choose uploaded images from the SmartPlayer personal account folder.
В процессе взаимодействия с настройками виджета пользователь может загрузить или выгрузить настройки виджета. Каждое из указанных действий можно сделать с помощью отдельных иконок в интерфейсе виджета. Иконки расположены в виджете снизу по центру.
[[File:Настройки общие для виджета.png|thumb|center| Example of general widget settings |800px]]
[[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок в настройках виджета |800px]]
=== '''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.
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана. Либо пользователь может не сохранять выставленные настройки по кнопке «Сбросить».
[[File:Иконки_загрузки.png|thumb|center| Example of settings import/export icons |800px]]
[[File:Применение_настрок.png|thumb|center| Пример отображения кнопок «Применить настройки» и «Сбросить»|800px]]
=== '''Completing General Settings''' ===
Далее виджет растянется на весь экран и пользователь должен нажать на кнопку «Сохранить», внизу по центру экрана.
After configuring settings, click “Apply settings” in the bottom-right corner. Alternatively, click “Reset” to discard changes.
[[File:Сохран.png|thumb|center| Пример отображения кнопки «Сохранить»|800px]]
[[File:Применение_настрок.png|thumb|center| Example of “Apply settings” and “Reset” buttons |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;
[[File:Изменения_добавления_шага.png|thumb|center| Пример отображения изменений при добавлении шага|800px]]
** flowchart.
=== '''Выбор скриншота''' ===
* 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''' ===
[[File:Скрин_авторизации.png|thumb|center| Пример отображения модального окна с выбором скриншота|800px]]
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| Example of screenshot selection modal window |800px]]
[[File:Изменение_шагов_авторизации.png|thumb|center| Пример отображения изменений в колонке «Шаги авторизации» |800px]]
The screenshot name will appear in the “Authorization steps” column.
=== '''Добавить действие''' ===
[[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;
[[File:Добавление_действий.png|thumb|center| Пример отображения функциональности кнопки |800px]]
* add button creates a clickable overlay button for authorization page actions. 
После создания поля и кнопки пользователь размещает их на экране со скриншотом.  
[[File:Добавление_действий.png|thumb|center| Example of action button functionality |800px]]
[[File:Поле_ввода_и_кнопка.png|thumb|center| Пример отображения поля ввода и кнопки |800px]]
After creating fields and buttons, position them on the screenshot.
Добавленные действия также отобразятся в колонке «Шаги авторизации» внутри текущего шага.
[[File:Поле_ввода_и_кнопка.png|thumb|center| Example of input field and button placement |800px]]
[[File:Действия_для_текущего_шага.png|thumb|center| Пример отображения в колонке «Шаги авторизации» |800px]]
Added actions will appear in the “Authorization steps” column.
При перемещении элементов откроется панель с параметрами для настройки выбранного элемента. О параметрах поля и кнопки будет описано ниже в разделе. Также при перемещении подсвечивается только выбранный пользователем элемент.
[[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| Пример отображения колонки «Шаги авторизации» |800px]]
[[File:Отображение_шагов_авторизации.png|thumb|center| Example of the “Authorization steps” column |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| Пример отображения колонки «Шаги авторизации» |800px]]
[[File:Расппеделение_по_шагу_.png|thumb|center| Example of step structure in the column |800px]]
Каждый шаг можно удалить по отдельной кнопке «Удалить шаг». Также в каждом шаге можно удалить действия оставив его пустым (только с картинкой), при необходимости.<br>
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.
[[File:Применения_шагов.png|thumb|center| Пример отображения модального окна с подтверждением сохранения настроек |800px]]
[[File:Применения_шагов.png|thumb|center| Example of confirmation modal window |800px]]
=== '''Настройка поля ввода и кнопки действия''' ===
=== '''Configuring Input Field and Action Button''' ===
{{Note|Некоторые параметры, описанные в этом разделе автоматически изменяются если вы перетаскиваете поле или кнопку в рамках экрана виджета.|warn}}
{{Note|Some parameters described here automatically change when dragging elements within the widget screen.|warn}}
Кликнув по иконке в виде шестеренки рядом с кнопкой или полем пользователь может перейти в настройки данного элемента.<br>
Click the gear icon next to a field or button to open its settings.
Кнопка включает в себя следующие настройки:
Button settings:
* имя — ввести название кнопки;
* name;
* координата X — прописать числовое значение координаты в пикселях;
* X coordinate (pixels);
* координата Y — прописать числовое значение координаты в пикселях;
* Y coordinate (pixels);
* ширина — прописать числовое значение в пикселях;
* width (pixels);
* высота — прописать числовое значение в пикселях;
* height (pixels);
* время задержки — прописать числовое значение, которое указывает задержку перед нажатием кнопки. Измеряется в миллисекундах.
* delay time (milliseconds before click).
[[File:Настройки_кнопки.png|thumb|center| Пример отображения параметров для кнопки |800px]]
[[File:Настройки_кнопки.png|thumb|center| Example of button settings |800px]]
Поле включает в себя настройки:
Field settings:
* имя — ввести название поля;
* name;
* значение — прописать значение, которое будет введено в поле при наложении на изображение;
* value (text inserted into field);
* координата X — прописать числовое значение координаты в пикселях;
* X coordinate;
* координата Y — прописать числовое значение координаты в пикселях;
* Y coordinate;
* ширина — прописать числовое значение в пикселях;
* width;
* высота — прописать числовое значение в пикселях;  
* height;
* время задержки — прописать числовое значение, которое указывает задержку перед вводом значения в поле. Измеряется в миллисекундах.
* delay time (milliseconds before input).
[[File:Настройки_поля.png|thumb|center| Пример отображения для полей|800px]]
[[File:Настройки_поля.png|thumb|center| Example of field settings |800px]]
В обоих случаях для применения изменённых настроек кнопки или поля нажать на синюю кнопку «Применить» внизу колонки.
Click the blue “Apply” button at the bottom of the column to save changes.
[[File:Кнопка_применить в видежте.png|thumb|center| Пример отображения кнопки «Применить» |800px]]
[[File:Кнопка_применить в видежте.png|thumb|center| Example of the “Apply” button |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| Пример отображения блок-схемы|800px]]
[[File:Блока_схема_шагов.png|thumb|center| Example of the flowchart |800px]]
== '''Добавление настроенного виджета в трансляцию''' ==
== '''Adding the Configured Widget to a Broadcast''' ==
Чтобы полностью ознакомиться с работой данной функциональности, запустить трансляцию с расписанием и добавить в качестве контента виджет. Чтобы ознакомиться с описанными ранее шагами по созданию трансляции и расписания рекомендуется просмотреть следующие статьи из Wikipedia:
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''' ==
[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>
</div>

Текущая версия от 13:43, 20 февраля 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