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

YouTubeR lite это уникальный плагин, который позволяет вам загружать видео на YouTube и интегрировать видео в ваш сайт.

Загрузка

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

Интеграция

Интегрируйте легко любой YouTube видео в свой сайт

Адаптивность

Полностью адаптивный дизайн

Шаблоны

2 шаблона уже интегрированы в плагин

Lightbox

В плагин уже интегрирован lightbox для показа всплывающих окон

Скорость

Плагин оптимизирован для кэширования

Полная версия с большими возможностями находится тут: YouTubeR для Joomla

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Установка

Чтобы установить плагин, перейдите в Расширения > Менеджер расширений > Установить, выберите "Установить из пакета" и выберите файл youtuber_lite.zip.

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

Вы также можете активировать плагин "Button - YouTubeR" чтобы загружать видео на 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 на вашем сайта и сохраните изменения.

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

Шорткод

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

Видео

Горткод для видео будет выводить видео с информацией о нем.

Чтобы его использовать вам нужен идентификатор (ID) видео. Чтобы его найти, взгляните на обычный адрес видео в YouTube:

www.youtube.com/watch?v=oxgnlSbYLSc

В этом случае видео ID это oxgnlSbYLSc, и шорткод будет выглядеть так:

[mx_youtuber type="video" id="oxgnlSbYLSc"]

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

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

Атрибут Значения Описание
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 Показывать рекомендованные видео, когда видео заканчивается

Шаблоны

В YouTubeR lite уже включено 2 шаблона. Их названия:

  • default
  • dark

Вы можете создавать свои шаблоны для плагина YouTubeR lite. Например, вы хотите создать новый шаблон, который будет называться custom Вы можете сразу же использовать этот шорткод:

[mx_youtuber theme="custom"]

Теперь вы можете без добавления файлов создать стили для вашего нового шаблона относительно базового класса mxYouTubeR_theme_custom.

Если вам нужна более глубокая кастомизация или изменение базовых шаблонов, создайте папку html/plg_system_youtuber_lite в папке шаблона сайта и внутри нее создайте папку с название шаблона, который вы хотите создать/изменить, в данном случае, это custom.

Скопируйте файлы одного из готовых шаблонов, например media/plg_system_youtuber_lite/themes/default в папку вашего html/plg_system_youtuber_lite/custom в папке шаблона сайта (копируйте только те файлы, которые собираетесь редактировать).

При поиске заданного шаблона плагин следует следующей логике:

  1. будет искать файл шаблона в папке шаблона сайта /templates/_WEBSITE_THEME_/html/plg_system_youtuber_lite/_THEME_/
  2. будет искать файл шаблона в папке /media/plg_system_youtuber_lite/themes/_THEME_/
  3. Если не найдет ни один из предыдущих, то загрузит файл из дефолтного шаблона /media/plg_system_youtuber_lite/themes/default/