YouTubeR - уникальный плагин для Joomla

Демонстрация YouTube видео интегрированных плагином YouTubeR - шаблон "dark"

Быстрое начало

Для быстрого начала работы с плагином вам нужно выполнить следующие действия:

1. Установить плагин YouTubeR
2. Получить Google API keys

После этих действий вы можете загружать видео на YouTube и интегрировать его в ваш сайт.

Как интегрировать YouTube видео в страницу сайта

Чтобы интегрировать YouTube видео вы можете просто использовать этот шорткод в материале сайта, модуле или даже в коде шаблона сайта:

[mx_youtuber type="video" id="5vZ4lCKv1ik"]

Более подробно о параметрах шорткода и о том, как получить ID видео вы можете прочитать в разделе "Шорткод".

Как загрузить видео на YouTube прямо с вашего сайта

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

Если вы не видите эту кнопку, то скорее всего вы не активировали плагин "YouTubeR button".

Во всплывающем окне авторизуйте ваш YouTube аккаунт, кликнув по кнопке "авторизовать".

Затем нажмите кнопку "Загрузить видео" в правом верхнем углу окна:

Заполните все необъодимые поля, выберите видео файл и нажмите кнопку "Загрузить".

Когда видео будет загружено, вы увидите его в списке видео, но без изображения. Изображение YouTube сгенерирует позже автоматически.Как только оно сгенерируется, вы его увидите в списке видео.

Google API keys

Сначала, перейдите в Расширения > Менеджер плагинов и откройте настройки плагина "System - YouTubeR lite".

Чтобы использовать этот плагин вам нужны Google API keys. Вы можете их создать бесплатно в Google Developers Console.

В Google Developers Console site, нажмите на Создать проект, введите любое название и ждите пока он будет создан.

Теперь нужно активировать YouTube Data API для этого перейдите в APIs & auth > APIs, кликните по YouTube Data API и на Включить API.

Затем перейдите в APIs & auth > Учетные данные.

Тут нужно создать 2 разных ключа: API key и OAuth Client ID.

1. Создание API key

Нажмите на кнопку Add credentials.

Во всплывающем окне выберите API key и нажмите API key.

Затем, необязательные шаг, вы можете указать с каких сайтов можно работать с вашими ключами, например: *.example.com/* для сайта example.com.

Затем нажмите кнопку Create и ваш API key будет готов.

Скопируйте API key из Google Developers Console и вставьте его в настройки плагина YouTubeR на вашем сайте.

2. Создание OAuth Client ID

Нажмите на кнопку Add credentials и выберите OAuth 2.0 client ID.

Следующий шаг необязательный, нажмите Configure consent screen. Если у вас нет этой кнопки, значит вы уже настроили "consent screen". Заполните все необходимые поля и вы настроили "consent screen".

Выберите Web application и введите название вашего приложения (придумайте любое).

Затем заполните Authorized JavaScript origins - это адреса сайтов, где вы будете использовать плагин YouTubeR.

Нажмите на кнопку "Create" и вы получите в client ID.

Скопируйте client ID из Google Developers Console и вставьте в настройки плагина YouTubeR на вашем сайта и сохраните изменения.

Готово! Теперь можете начинать использовать шорткод.

Атрибуты шорткода

Используя эти атрибуты шорткода вы можете управлять настройками видео блока.

Атрибут	Значения	Описание
id	-	YouTube видео ID
display	title,date,channel,description,meta	Какие параметры блока отображать, перечисленные через запятую. Если оставить пустым, то будет показана только изображение видео.
mode	lightbox / embed / link	Тип интеграции видео в страницу
theme	См. раздел "Шаблоны"	Шаблон, который будет применен
size	default / medium / high / maxres / standard	Размер изображения видео
width	число	Ширина видео (может быть в %). Действительно только когда mode="embed"
height	число	Высота видео (может быть в %). Действительно только когда mode="embed"
max_words	число	Максимальное число слов в описании видео
suggested_videos	true / false	Показывать рекомендованные видео, когда видео заканчивается