WT PDF.js

Описание

WT PDF.js — системный плагин для Joomla 5 и новее, который регистрирует PDF.js в WebAssetManager. Подходит для модулей, компонентов и переопределений шаблонов, работающих с PDF.

• Локальная библиотека PDF.js 6.4.299 для новых и для старых браузеров.
• Ассет CDN latest с автоматическим выбором worker той же версии.
• Два готовых веб-просмотрщика: открытие ссылкой или в iframe.
• Пользовательские JSON-профили: тема, масштаб, язык, панели и параметры загрузки PDF.
• Конфигурации хранятся отдельно и сохраняются при обновлении плагина.

Плагин предоставляет библиотеку и просмотрщики; подключение и отображение PDF выполняет ваше расширение. Установщик требует PHP 8.1 или новее; требования выбранной версии Joomla также должны выполняться.

Как использовать?

Это плагин для Joomla-разработчиков. Он позволяет в любом месте Joomla 5+ использовать PDF.js: в модулях, компонентах, плагинах.

В вашем коде подключите подходящий ассет:

<?php
use Joomla\CMS\Factory;

$wa = Factory::getApplication()->getDocument()->getWebAssetManager();
$wa->useScript('wt-pdf-js');          // Local: newer browsers
// $wa->useScript('wt-pdf-js-legacy'); // Local: older browsers
// $wa->useScript('wt-pdf-js-latest'); // CDN latest; choose ONE build

Настройка MIME-типов на сервере для *.MJS-файлов

Часто на серверах не настроены MIME-типы для файлов с расширениями *.mjs. Поэтому браузер может не понимать, что на самом деле это javascript-код и в консоли браузера можно увидеть ошибку pdf.mjs:1 Failed to load module script: Expected a JavaScript module script but the server responded with a MIME type of "application/octet-stream". Strict MIME type checking is enforced for module scripts per HTML spec. 

Для решения этой проблемы нужно либо попросить техническую поддержку хостинга настроить MIME-типы для файлов mjs. Либо сделать это самостоятельно:

1. Убедитесь, что на сервере Apache установлен и включён модуль mod_mime. 

 2. Добавьте в конец вашего .htaccess следующий код:

<IfModule mod_mime.c>
  AddType text/javascript mjs
</IfModule>