Галерея виджетов (системный администратор): различия между версиями

Материал из SmartPlayer
Новая страница: «== '''Описание ситуации''' == SmartPlayer имеет огромный функционал. При этом базовый функционал пользователь может обнаружить в своём "Личном кабинете". Но не все функции, можно просмотреть внутри платформы. Некоторые возможности, можно добавить опциально в ви...»
 
Нет описания правки
 
(не показано 17 промежуточных версий этого же участника)
Строка 1: Строка 1:
<languages/>
<translate>
<!--T:1-->
== '''Описание ситуации''' ==
== '''Описание ситуации''' ==
SmartPlayer имеет огромный функционал. При этом базовый функционал пользователь может обнаружить в своём "Личном кабинете". Но не все функции, можно просмотреть внутри платформы. Некоторые возможности, можно добавить опциально в виде виджетов. Эти виджеты как раз таки можно найти в "Галерее виджетов".
SmartPlayer как платформа имеет огромный функционал. Со всеми возможностями пользователь может ознакомиться в личном кабинете. Если пользователю хочется расширить возможности платформы, он использует виджеты. Для хранения и предоставления виджетов в одном месте была создана "Галерея виджетов".
=== '''Полезность функционала''' ===
Пользователь на данный момент может получить виджет, но только напрямую запросив его у SmartPlayer. Для облегчения работы с виджетами, более простого получения доступа и автоматизации процесса была создана "Галерея виджетов".
</translate>
<translate>
<!--T:2-->
== '''Техническая реализация''' ==
{{Note|У системного администратора со стороны клиента уже должен быть установлен сервер SmartPlayer|warn}}
{{Note|Протестированные поддерживаемые форматы архивов: RAR|warn}}
=== '''Хранилище для виджетов''' ===
Первоначально все виджеты хранятся на сервере SmartPlayer. После оплаты виджеты переносят на хранилища клиентов, которые могут быть двух видов:
# Локальные
# Хранилище типа AWS
{{Note|Amazon Web Services (AWS) — это облачные сервисы от компании Amazon. Под словом "облачные" подразумевается, что всё это работает на серверах Amazon, расположенных в разных уголках мира, и клиентам не требуется иметь собственное оборудование для использования этих сервисов.|warn}}
</translate>
<translate>
<!--T:3-->
== '''Настройка виджета''' ==
== '''Настройка виджета''' ==
Чтобы виджеты загрузились на сервере есть отдельная команда «загрузка»
=== '''Перенос виджетов''' ===
./cli.js widgets upload – cli команда которая выполняется на сервере. Это для системного администратора админа
После оплаты виджета, он становится доступен в "галереи виджетов". Как только пользователь нажмёт клавишу "загрузить" начнёт свою работу cli - команда:
Виджеты мы должны сначала загрузить на наши хранилища. Мы выбираем папку на сервере и загружаем архивы с виджетами и запускаем через команду. Команда обрабатывает виджеты, переносит их на нужные хранилища и заставляет их корректно работать. После этого все клиентские приложения (фронты) т.е. личный кабинет – может увидеть список установленных виджетов и при желании пользователь может установить его себе.
<code>./cli.js widgets upload</code> – cli команда которая выполняется на сервере.<br>
Если все установлено правильно в разделе меню «галерея виджетов» показывается весь пак установленных виджетов
Данная команда переносит архив с виджетом с нашего сервера на сервер пользователя. Она обрабатывает виджеты, переносит их на нужные хранилища и заставляет их корректно работать.
Можно кликнуть 2 раза на виджет и узнать о нем подробную инофрмацию. Если клиента устраивает видежт он его загружает . после нажатия кнопки «загрузить»  пользователей выбирает в какую папку ЛК установить виджет.
</translate>
Далее идём в контент и находим нужный виджет. Установка виджета это по идее копирование нашего виджета из нашего общего хранилища в хранилище конкретно этой компании.
<translate>
Установив виджет мы можем им пользоваться.
<!--T:4-->
С локальными серверами немного по другому: виджет загружается отдельно. Разница в том что подключается только 1 пользователь на сервер а не несколько.  
=== '''Как происходит настройка''' ===
Галерея виджетов дает виджеты за оплату
{{Note|Без проведения предварительной настройки пользователь не видит "галерею виджетов"|warn}}
* Архивы с виджетами загружаются на сервер клиента. Цель системного администратора со стороны SmartPlayer занести архивы с виджетами наиболее удобным способом. При копировании необходимо обязательно указать корректный путь.
* После возвращаемся на облачный сервер и заходим в папку SmartPlayer. Находим раздел "Widgets" и перемещаем все архивы в одну папку. Все папки располагаются по пути: <code>home/smartplayer/smartplayer</code>.
* Для отображения "галереи виджетов" используется специальная CLI команда. Это настраивается только с конкретного пути:
<code>/home/smartplayer/smartplayer/backend/app</code>. В этом месте находится скрипт под названием:<code>cli.js</code>. Внутри этого скрипта находится команда для загрузки: <code>/cli.js widgets upload</code>
* В итоге в личном кабинете появится раздел "галерея виджетов"
{{Note|Версия личного кабинета для работы с "галерея виджетов" - ver. 2.136.2<br>
Версия сервер для работы с "галерея виджетов" - ver 2.132.18.|warn}}
</translate>
<translate>
 
=== '''Что видит пользователь''' ===
После срабатывания команды внутри клиентского приложения пользователь может увидеть установленные виджеты внутри "галереи виджетов" и загрузить их к себе.
Нужный виджет пользователь может установить двумя способами:
# Установка через специальную кнопку "Загрузить", внутри "галереи виджетов"
# Установка через специальную кнопку "Загрузить", при работе с контентом
[[File:Кнопка загрузки.png|thumb|center| Расположение кнопки "загрузить"|300px]]
</translate>
<translate>
<!--T:6-->
=== '''Различия для онлайн и локальных серверов''' ===
* Для онлайн серверов галерея виджетов работает по принципу хранилища сразу для нескольких клиентов. Любой клиент подключенный к этому серверу видит одинаковый набор виджетов и может их загрузить в свой ЛК.<br>
* Для локальных серверов галерея виджетов работает по схожему принципу. Только вместо несколько пользователей, на этом сервер всего один пользователь. Он также получает доступ ко всем оплаченным виджетам.
[[File:Схемы.png|thumb|center| Схема работы серверов|300px]]
== '''Итоговый результат''' ==
Пользователь легко и удобно может устанавливать себе виджеты с помощью "галереи виджетов"
</translate>

Текущая версия от 10:01, 28 августа 2023

Описание ситуации

SmartPlayer как платформа имеет огромный функционал. Со всеми возможностями пользователь может ознакомиться в личном кабинете. Если пользователю хочется расширить возможности платформы, он использует виджеты. Для хранения и предоставления виджетов в одном месте была создана "Галерея виджетов".

Полезность функционала

Пользователь на данный момент может получить виджет, но только напрямую запросив его у SmartPlayer. Для облегчения работы с виджетами, более простого получения доступа и автоматизации процесса была создана "Галерея виджетов".

Техническая реализация

У системного администратора со стороны клиента уже должен быть установлен сервер SmartPlayer
Протестированные поддерживаемые форматы архивов: RAR

Хранилище для виджетов

Первоначально все виджеты хранятся на сервере SmartPlayer. После оплаты виджеты переносят на хранилища клиентов, которые могут быть двух видов:

  1. Локальные
  2. Хранилище типа AWS
Amazon Web Services (AWS) — это облачные сервисы от компании Amazon. Под словом "облачные" подразумевается, что всё это работает на серверах Amazon, расположенных в разных уголках мира, и клиентам не требуется иметь собственное оборудование для использования этих сервисов.

Настройка виджета

Перенос виджетов

После оплаты виджета, он становится доступен в "галереи виджетов". Как только пользователь нажмёт клавишу "загрузить" начнёт свою работу cli - команда: ./cli.js widgets upload – cli команда которая выполняется на сервере.
Данная команда переносит архив с виджетом с нашего сервера на сервер пользователя. Она обрабатывает виджеты, переносит их на нужные хранилища и заставляет их корректно работать.

Как происходит настройка

Без проведения предварительной настройки пользователь не видит "галерею виджетов"
  • Архивы с виджетами загружаются на сервер клиента. Цель системного администратора со стороны SmartPlayer занести архивы с виджетами наиболее удобным способом. При копировании необходимо обязательно указать корректный путь.
  • После возвращаемся на облачный сервер и заходим в папку SmartPlayer. Находим раздел "Widgets" и перемещаем все архивы в одну папку. Все папки располагаются по пути: home/smartplayer/smartplayer.
  • Для отображения "галереи виджетов" используется специальная CLI команда. Это настраивается только с конкретного пути:

/home/smartplayer/smartplayer/backend/app. В этом месте находится скрипт под названием:cli.js. Внутри этого скрипта находится команда для загрузки: /cli.js widgets upload

  • В итоге в личном кабинете появится раздел "галерея виджетов"
Версия личного кабинета для работы с "галерея виджетов" - ver. 2.136.2
Версия сервер для работы с "галерея виджетов" - ver 2.132.18.

Что видит пользователь

После срабатывания команды внутри клиентского приложения пользователь может увидеть установленные виджеты внутри "галереи виджетов" и загрузить их к себе. Нужный виджет пользователь может установить двумя способами:

  1. Установка через специальную кнопку "Загрузить", внутри "галереи виджетов"
  2. Установка через специальную кнопку "Загрузить", при работе с контентом
Ошибка создания миниатюры: Не удаётся сохранить эскиз по месту назначения
Расположение кнопки "загрузить"

Различия для онлайн и локальных серверов

  • Для онлайн серверов галерея виджетов работает по принципу хранилища сразу для нескольких клиентов. Любой клиент подключенный к этому серверу видит одинаковый набор виджетов и может их загрузить в свой ЛК.
  • Для локальных серверов галерея виджетов работает по схожему принципу. Только вместо несколько пользователей, на этом сервер всего один пользователь. Он также получает доступ ко всем оплаченным виджетам.
Ошибка создания миниатюры: Не удаётся сохранить эскиз по месту назначения
Схема работы серверов

Итоговый результат

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