Справочная информация по плагину «Uppod-плеер»
Плагин «Uppod-плеер» позволяет подключать медиа-файлы (типы файлов можно узнать здесь) с помощью четырёх разных тэгов:
Начертание тэгов «audio» и/или «video» могут быть изменены на любые другие (например, соответственно - «zvuk» и «film») через панель настройки опций плагина. При этом внутренние тэги дополнительных настроек плеера остаются неизменными.
Общие нюансы использования:
- Относительные пути нужно начинать с корневого слеша «/». Если его не указать, то плагин сам подставит нужный символ в начало адреса. Так, например, адрес «uploads/media/example.mp3» будет равнозначен адресу «/uploads/media/example.mp3».
- Если параметры плеера не заданы атрибутами, то соответствующие настройки берутся из общих опций настройки плагина (см. админ-панель) «Uppod-плеер».
[video]/[audio]
Парный тэг [video] вставляет плеер, настроенный на проигрывание видео-ролика. А парный тэг [audio], соответственно - плеер, настроенный на проигрывание аудио-записи. Можно задавать дополнительные параметры отображения с помощью вспомогательных (работают только между [video] и [/video] или между [audio] и [/audio]) парных тэгов:
- [caption][/caption] - задаётся заголовок внутри плеера (вместо caption может использоваться синоним - comment, т.е. тэг [comment]);
- [style][/style] - задаёт специфический файл стиля оформления плеера (вместо style может использоваться короткий синоним - st, т.е. тэг [st]). Файл стиля формируется на сайте uppod.ru и затем заливается в папку плагина \application\maxsite\plugins\uppod\style\;
- [width][/width] - ширна плеера в пикселах;
- [height][/height] - высота плеера в пикселах;
- [pl][/pl] - задаёт файл плейлиста. Файл плейлиста формируется на сайте uppod.ru и затем заливается в любую папку сайта (рекомендуется заливать в стандартное место - любую подпаку папки /uploads/). Чтобы плеер мог работать с плейлистом должен быть указан (если в настройках по-умолчанию этого нет) стиль, в котором есть соответствующие настройки. При совместном задании медиа-файла и плейлиста плеер открывает первым заданный медиа-файл, а позиции из плейлиста открываются ручным выбором или автоматически после проигрывания заданного медиа-файла.
- [poster][/poster] - задаёт картинку постера. Подготовленный файл заливается в любую папку сайта (рекомендуется заливать в стандартное место - любую подпаку папки /uploads/).
- [volume][/volume] - задаёт уровень громкости (вместо volume может использоваться синоним - vol, т.е. тэг [vol]). Значение нужно указывать в пределе от 0 до 1 (дробная часть указывается через точку).
Порядок задания тэгов дополнительных параметров - неважен.
Использование [video] | Пример |
---|---|
[video]/относительный_путь_к файлу_на_сайте/имя_видео_файла[/video] | [video]/uploads/video-roliki/intro.mp4[/video] |
[video]http://сайт/папка/имя_видео_файла[/video] | [video]htt://vizr.ru/uploads/roliki/about.mp4[/video] |
[video]видео_файл[caption]Заголовок видеоролика[/caption][/video] | [video]/uploads/roliki/caption.3gp[caption]О проекте[/caption][/video] |
[video]видео_файл[style]/относительный_путь_к_файлу_стиля_на_сайте/имя_файла_стиля[/style][/video] | [video]/uploads/roliki/style.mp4[style]/uploads/styles/video100-987.txt[/style][/video] |
[video]видео_файл[width]ширина[/width][/video] | [video]/uploads/roliki/width.mp4[width]500[/width][/video] |
[video]видео_файл[height]высота[/height][/video] | [video]/uploads/roliki/height.mp4[height]400[/height][/video] |
[video]видео_файл[poster]/относительный_путь_к_файлу_постера_на_сайте/имя_файла_постера[/poster][/video] | [video]/uploads/roliki/poster.mp4[poster]/uploads/posters/poster_mov.jpg[/poster][/video] |
[video]видео_файл[pl]/относительный_путь_к_файлу_плейлиста_на_сайте/имя_файла_плейлиста[/pl][/video] | [video]/uploads/roliki/pl.mp4[pl]/uploads/lists/playlist_video100-201.txt[/pl][/video] |
[video][pl]/относительный_путь_к_файлу_плейлиста_на_сайте/имя_файла_плейлиста[/pl][/video] | [video][pl]/uploads/lists/playlist_video100-221.txt[/pl][/video] |
[video][caption]Заголовок видеоролика[/caption]/относительный_путь_к файлу_на_сайте/имя_видео_файла[width]ширина[/width][height]высота[/height][style]/относительный_путь_к_файлу_стиля_на_сайте/имя_файла_стиля[/style][/video] | [video][caption]Полный пример[/caption]uploads/roliki/full_video_example.mp4[height]250[/height][width]300[/width][style]uploads/styles/video100-001.txt[/style][/video] |
Использование [audio] | Пример |
[audio]/относительный_путь_к файлу_на_сайте/имя_аудио_файла[/audio] | [audio]/uploads/audio/intro.mp3[/audio] |
[audio]http://сайт/папка/имя_аудио_файла[/audio] | [audio]htt://vizr.ru/uploads/zvuki/about.mp3[/audio] |
[audio]аудио_файл[caption]Заголовок аудиозаписи[/caption][/audio] | [audio]/uploads/zvuki/caption.mp3[caption]О проекте[/caption][/audio] |
[audio]аудио_файл[style]/относительный_путь_к_файлу_стиля_на_сайте/имя_файла_стиля[/style][/audio] | [audio]/uploads/zvuki/style.mp3[style]/uploads/styles/audio888-987.txt[/style][/audio] |
[audio]аудио_файл[width]ширина[/width][/audio] | [audio]/uploads/zvuki/width.mp3[width]150[/width][/audio] |
[audio]аудио_файл[height]высота[/height][/audio] | [audio]/uploads/zvuki/height.mp3[height]40[/height][/audio] |
[audio]аудио_файл[pl]/относительный_путь_к_файлу_плейлиста_на_сайте/имя_файла_плейлиста[/pl][/audio] | [audio]/uploads/zvuki/pl.mp3[pl]/uploads/lists/playlist_audio234-115.txt[/pl][/audio] |
[audio][pl]/относительный_путь_к_файлу_плейлиста_на_сайте/имя_файла_плейлиста[/pl][/audio] | [audio][pl]/uploads/lists/playlist_audio234-221.txt[/pl][/audio] |
[audio][caption]Заголовок аудиозаписи[/caption]/относительный_путь_к файлу_на_сайте/имя_аудио_файла[width]ширина[/width][height]высота[/height][style]/относительный_путь_к_файлу_стиля_на_сайте/имя_файла_стиля[/style][/audio] | [audio][caption]Полный пример[/caption]uploads/zvuki/full_audio_example.mp3[height]30[/height][width]100[/width][style]uploads/styles/audio100-001.txt[/style][/audio] |
[uppod]
Одиночный тэг [uppod] вставляет плеер, который настраивается на проигрывание медиа-файла в зависимости от заданных атрибутов:
- file - задаёт медиа-файл для проигрывания плеером;
- type - задаёт тип медиа-файла. Допустимо значение «audio» или «video». Если атрибут не задан, то по-умолчанию принимает значение «video»;
- caption - задаётся заголовок внутри плеера (вместо caption может использоваться синоним - comment);
- style - задаёт специфический файл стиля оформления плеера (вместо style может использоваться короткий синоним - st). Файл стиля формируется на сайте uppod.ru и затем должен быть размещён в папке плагина \application\maxsite\plugins\uppod\style\;
- width - ширна плеера в пикселах;
- height - высота плеера в пикселах;
- pl - задаёт файл плейлиста. Файл плейлиста формируется на сайте uppod.ru и затем заливается в любую папку сайта (рекоммендуется заливать в стандартное место - любую подпаку папки /uploads/). Чтобы плеер мог работать с плейлистом должен быть указан (если в настройках по-умолчанию этого нет) стиль, в котором есть соответствующие настройки. При совместном задании медиа-файла и плейлиста плеер открывает первым заданный медиа-файл, а позиции из плейлиста открываются ручным выбором или автоматически после проигрывания заданного медиа-файла.
- poster - задаёт картинку постера. Подготовленный файл заливается в любую папку сайта (рекоммендуется заливать в стандартное место - любую подпаку папки /uploads/).
- volume - задаёт уровень громкости (вместо volume может использоваться синоним - vol). Значение нужно указывать в пределе от 0 до 1 (дробная часть указывается через точку).
Порядок задания атрибутов - неважен. Значения атрибутов задаются без окоймления кавычками.
Использование [uppod type=video] | Пример |
---|---|
[uppod file=/относительный_путь_к файлу_на_сайте/имя_видео_файла] | [uppod file=/uploads/video-roliki/intro.flv] |
[uppod file=http://сайт/папка/имя_видео_файла] | [uppod file=htt://vizr.ru/uploads/roliki/about.avi] |
[uppod file=видео_файл caption=Заголовок видеоролика] | [uppod file=/uploads/roliki/caption.3gp caption=О проекте] |
[uppod file=видео_файл style=/относительный_путь_к_файлу_стиля_на_сайте/имя_файла_стиля] | [uppod file=/uploads/roliki/style.mp4 style=/uploads/styles/video100-987.txt] |
[uppod file=видео_файл width=ширина] | [uppod file=/uploads/roliki/width.mov width=500] |
[uppod file=видео_файл height=высота] | [uppod file=/uploads/roliki/height.f4v height=400] |
[uppod file=видео_файл poster=/относительный_путь_к_файлу_постера_на_сайте/имя_файла_постера] | [uppod file=/uploads/roliki/poster.mov poster=/uploads/posters/poster_mov.jpg] |
[uppod file=видео_файл pl=/относительный_путь_к_файлу_плейлиста_на_сайте/имя_файла_плейлиста] | [uppod file=/uploads/roliki/pl.avi pl=/uploads/lists/playlist_video100-201.txt] |
[uppod pl=/относительный_путь_к_файлу_плейлиста_на_сайте/имя_файла_плейлиста] | [uppod pl=/uploads/lists/playlist_video100-221.txt] |
[uppod type=video caption=Заголовок видеоролика file=/относительный_путь_к файлу_на_сайте/имя_видео_файла width=ширина height=высота style=/относительный_путь_к_файлу_стиля_на_сайте/имя_файла_стиля] | [uppod type=video caption=Полный пример file=uploads/roliki/full_video_example.flv height=250 width=300 style=uploads/styles/video100-001.txt] |
Использование [uppod type=audio] | Пример |
[uppod type=audio file=/относительный_путь_к файлу_на_сайте/имя_аудио_файла] | [uppod type=audio file=/uploads/audio/intro.mp3] |
[uppod type=audio file=http://сайт/папка/имя_аудио_файла] | [uppod type=audio file=htt://vizr.ru/uploads/zvuki/about.mp3] |
[uppod type=audio file=аудио_файл caption=Заголовок аудиозаписи] | [uppod type=audio file=/uploads/zvuki/caption.mp3 caption=О проекте] |
[uppod type=audio file=аудио_файл style=/относительный_путь_к_файлу_стиля_на_сайте/имя_файла_стиля] | [uppod type=audio file=/uploads/zvuki/style.mp3 style=/uploads/styles/audio888-987.txt] |
[uppod type=audio file=аудио_файл width=ширина] | [uppod type=audio file=/uploads/zvuki/width.mp3 width=150] |
[uppod type=audio file=аудио_файл height=высота] | [uppod type=audio file=/uploads/zvuki/height.mp3 height=40] |
[uppod type=audio file=аудио_файл pl=/относительный_путь_к_файлу_плейлиста_на_сайте/имя_файла_плейлиста] | [uppod type=audio file=/uploads/zvuki/pl.mp3 pl=/uploads/lists/playlist_audio234-115.txt] |
[uppod type=audio pl=/относительный_путь_к_файлу_плейлиста_на_сайте/имя_файла_плейлиста] | [uppod type=audio pl=/uploads/lists/playlist_audio234-221.txt] |
[uppod type=audio caption=Заголовок аудиозаписи file=/относительный_путь_к файлу_на_сайте/имя_аудио_файла width=ширина height=высота style=/относительный_путь_к_файлу_стиля_на_сайте/имя_файла_стиля] | [uppod type=audio caption=Полный пример file=uploads/zvuki/full_audio_example.mp3 height=30 width=100 style=uploads/styles/audio100-001.txt] |
[youtube]
Парный тэг [youtube] вставляет плеер, настроенный на проигрывание видео-ролика с сервиса YouTube.com. Можно задавать дополнительные параметры отображения с помощью вспомогательных парных тэгов:
- [caption][/caption] - задаётся заголовок внутри плеера (вместо caption может использоваться синоним - comment, т.е. тэг [comment]);
- [style][/style] - задаёт специфический файл стиля оформления плеера (вместо style может использоваться короткий синоним - st, т.е. тэг [st]). Файл стиля формируется на сайте uppod.ru и затем заливается в папку плагина \application\maxsite\plugins\uppod\style\;
- [width][/width] - ширна плеера в пикселах;
- [height][/height] - высота плеера в пикселах;
- [poster][/poster] - задаёт картинку постера. Подготовленный файл заливается в любую папку сайта (рекомендуется заливать в стандартное место - любую подпаку папки /uploads/). Возможность использовать постеры также должна быть включена в стилях плеера (в стилях «по-умолчанию» такой возможности нет).
- [volume][/volume] - задаёт уровень громкости (вместо volume может использоваться синоним - vol, т.е. тэг [vol]). Значение нужно указывать в пределе от 0 до 1 (дробная часть указывается через точку).
Порядок задания тэгов дополнительных параметров - неважен. Т.к. использование плейлистов для youtube изначально на сайте uppod.ru доступно только на тарифе Pro, то в плагине такой возможности сейчас нет.
Использование [youtube] | Пример |
---|---|
[youtube]http://www.youtube.com/watch?v=идентификатор_видео_ролика[/youtube] | [youtube]http://www.youtube.com/watch?v=zq7crBs6Q8I75[/youtube] |
[youtube]http://youtu.be/идентификатор_видео_ролика[/youtube] | [youtube]http://youtu.be/12BdZuJCJII84[/youtube] |
Ссылку на ролик можно скопировать из адресной строки (когда открыта страница ролика) или на специальной закладке «Поделиться» на странице ролика.
Заключение
Если у вас возникли вопросы, то можете задать их в комментариях.
Код - - не работает. При разворачивании на весь экран в гугл хром видео, тупо исчезает, звучит только аудио!
Александр, скорее всего дело в устаревшей версии кода uppod-плеера. Сейчас пока некогда этим заниматься, но думаю, что до конца года точно обновлю и проверю работоспособность. Спасибо за сообщение!