Частный Joomla-разработчик · работаю удалённо
My Joomla — блог веб-разработчика на JoomlaОбсудить задачу
Авторское расширение

LeoDocViewer

Просмотр PDF, Word, Excel и PowerPoint прямо на страницах Joomla. Шорткоды, настройка размеров и кнопка вставки в редакторе. Бесплатный пакет из двух плагинов.

LeoDocViewer: PDF и документы Office внутри сайта

Документ можно прочитать прямо на сайте

LeoDocViewer добавляет просмотр документов на страницы Joomla. Вместо одной ссылки на скачивание посетитель видит встроенное окно с документом: так удобно размещать инструкции, каталоги, презентации и справочные материалы.

Загрузите файл в папку сайта, укажите его путь в коротком шорткоде — и плагин выведет адаптивный iframe. Ширину и высоту можно задать для отдельного документа или оставить значения из настроек.

Что входит в пакет

  • Системный плагин LeoDocViewer 1.1.1 — находит шорткоды в HTML страницы и заменяет их встроенными просмотрщиками.
  • Кнопка LeoDocViewer 1.0.1 для редактора — вставляет готовый шорткод в позицию курсора. После вставки остаётся заменить путь к файлу и при необходимости размеры.

Поддерживаемые документы

Форматы и способ просмотра
ДокументРасширения файловКак открывается
PDF.pdfВстроенным просмотрщиком PDF в браузере посетителя.
Word.doc, .docxЧерез Microsoft Office для Интернета.
Excel.xls, .xlsxЧерез Microsoft Office для Интернета.
PowerPoint.ppt, .pptxЧерез Microsoft Office для Интернета.

Установка и первый документ

  1. Скачайте ZIP-пакет с этой страницы. Распаковывать его перед установкой не нужно.
  2. В панели Joomla откройте Система → Установка → Расширения и загрузите пакет.
  3. Откройте управление плагинами и включите системный плагин LeoDocViewer. Для удобной вставки включите также кнопку LeoDocViewer для редактора.
  4. Загрузите документ, например в папку images/documents/.
  5. Откройте материал, вставьте шорткод вручную или кнопкой LeoDocViewer и замените текст-заполнитель на путь к файлу.
  6. Сохраните материал и проверьте его на сайте.

Пример для 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 автора. Пакет распространяется бесплатно.