Справочная информация по плагину «Uppod-плеер»

Плагин «Uppod-плеер» позволяет подключать медиа-файлы (типы файлов можно узнать здесь) с помощью четырёх разных тэгов:

• [video][/video]
• [audio][/audio]
• [uppod]
• [youtube][/youtube]

Начертание тэгов «audio» и/или «video» могут быть изменены на любые другие (например, соответственно - «zvuk» и «film») через панель настройки опций плагина. При этом внутренние тэги дополнительных настроек плеера остаются неизменными.

Общие нюансы использования:

1. Относительные пути нужно начинать с корневого слеша «/». Если его не указать, то плагин сам подставит нужный символ в начало адреса. Так, например, адрес «uploads/media/example.mp3» будет равнозначен адресу «/uploads/media/example.mp3».
2. Если параметры плеера не заданы атрибутами, то соответствующие настройки берутся из общих опций настройки плагина (см. админ-панель) «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 (дробная часть указывается через точку).

Порядок задания тэгов дополнительных параметров - неважен.

[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 (дробная часть указывается через точку).

Порядок задания атрибутов - неважен. Значения атрибутов задаются без окоймления кавычками.

[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, то в плагине такой возможности сейчас нет.

Ссылку на ролик можно скопировать из адресной строки (когда открыта страница ролика) или на специальной закладке «Поделиться» на странице ролика.

Заключение

Если у вас возникли вопросы, то можете задать их в комментариях.