
Документ можно прочитать прямо на сайте
LeoDocViewer добавляет просмотр документов на страницы Joomla. Вместо одной ссылки на скачивание посетитель видит встроенное окно с документом: так удобно размещать инструкции, каталоги, презентации и справочные материалы.
Загрузите файл в папку сайта, укажите его путь в коротком шорткоде — и плагин выведет адаптивный iframe. Ширину и высоту можно задать для отдельного документа или оставить значения из настроек.
Что входит в пакет
- Системный плагин LeoDocViewer 1.1.1 — находит шорткоды в HTML страницы и заменяет их встроенными просмотрщиками.
- Кнопка LeoDocViewer 1.0.1 для редактора — вставляет готовый шорткод в позицию курсора. После вставки остаётся заменить путь к файлу и при необходимости размеры.
Поддерживаемые документы
| Документ | Расширения файлов | Как открывается |
|---|---|---|
.pdf | Встроенным просмотрщиком PDF в браузере посетителя. | |
| Word | .doc, .docx | Через Microsoft Office для Интернета. |
| Excel | .xls, .xlsx | Через Microsoft Office для Интернета. |
| PowerPoint | .ppt, .pptx | Через Microsoft Office для Интернета. |
Установка и первый документ
- Скачайте ZIP-пакет с этой страницы. Распаковывать его перед установкой не нужно.
- В панели Joomla откройте Система → Установка → Расширения и загрузите пакет.
- Откройте управление плагинами и включите системный плагин LeoDocViewer. Для удобной вставки включите также кнопку LeoDocViewer для редактора.
- Загрузите документ, например в папку
images/documents/. - Откройте материал, вставьте шорткод вручную или кнопкой LeoDocViewer и замените текст-заполнитель на путь к файлу.
- Сохраните материал и проверьте его на сайте.
Пример для PDF
{leodoc width="100%" height="680"}images/documents/instruction.pdf{/leodoc}Пример для Word
{leodoc width="100%" height="680"}images/documents/presentation.docx{/leodoc}Путь указывается относительно корня Joomla. Внешние сайты как источник документов не поддерживаются. Абсолютный HTTP- или HTTPS-адрес файла на этом же сайте допускается и преобразуется в локальный путь.
Параметры плагина
- Разрешённые расширения файлов. По умолчанию:
pdf,doc,docx,xls,xlsx,ppt,pptx. Можно сузить список до используемых форматов. - Ширина по умолчанию. Изначально
100%. - Высота по умолчанию. Изначально
600. Отдельный шорткод может переопределить её. - Режим отладки. Помогает при настройке. На рабочем сайте его следует выключить: ошибочный шорткод будет скрыт без показа путей к файлам посетителям.
Для размеров принимаются числа и значения с единицами px, %, vw и vh. У кнопки редактора есть отдельная настройка вставляемого шаблона шорткода.
Переход с ARI Docs Viewer
LeoDocViewer распознаёт и старую запись {aridoc}…{/aridoc}. Это позволяет сохранить существующие шорткоды для поддерживаемых файлов при переходе с ARI Docs Viewer. Кнопка редактора вставляет только современный вариант {leodoc}.
{aridoc width="100%" height="680"}images/documents/instruction.pdf{/aridoc}Частые вопросы
Файл есть на сервере, но документ Office не открывается
Проверьте полный адрес файла в приватном окне браузера без входа на сайт. Microsoft должен иметь возможность получить сам файл: ограничение доступа, пароль на папку или блокировка внешних запросов помешают просмотру.
Нужен ли сервис Microsoft для PDF?
Нет. Для PDF используется просмотрщик браузера. Его возможности и отображение на телефоне зависят от браузера посетителя.
Можно ли использовать файл с другого сайта?
Нет. Плагин работает с локальными файлами внутри корня Joomla. Полный адрес допустим только для файла на этом же сайте.
Текущий выпуск
Пакет 1.1.1 включает системный плагин 1.1.1 и кнопку редактора 1.0.1. На этой странице опубликован исходный установочный ZIP автора. Пакет распространяется бесплатно.