Plugin Compatible Joomla 3.x

Description

jviewerjs

Ce plugin pour Joomla permet d'afficher des fichiers PDF en utilisant une méthode acceptée par le navigateur.

Il affiche également les fichiers au format OpenDocument ODT (texte), ODS (tableur) ou ODP (Présentation), créés par LibreOffice, Apache OpenOffice, Microsoft Office, ... à l'aide du script viewerjs

Ci-dessous, un exemple avec le fichier PDF de la documentation du plugin

Installation / configuration

Après une installation classique par le gestionnaire d'extensions, il faut publier et configurer le plugin

Configuration de base du plugin JViewerJS
  • Dossier de base le chemin relatif depuis la racine de votre site du dossier contenant les documents. Exemple : images/doc"
  • Largeur Largeur par défaut. Vous pouvez indiquer l'unité % ou px.
    Paramètre: width=100%
  • Hauteur Hauteur par défaut. Vous pouvez indiquer l'unité % ou px.
    Paramètre: height=300px
  • Plein écran autorisé L'affichage en plein écran est-il autorisé.
    Paramètre: fullscreen=1|0
  • Lien de téléchargement Affiche un lien de téléchargement après le document. Même si un bouton est proposé par ViewerJS, cela permet dans le cas où ViewerJS ne peut pas afficher le document d'avoir un lien à disposition.
    Le texte standard pour proposer le téléchargement est défini par le mot-clé JVJS_DOWNLOAD_TEXT_LABEL dans le fichier langage du plugin.
    Paramètre: download_info='text'
    Pour les sites multilangages, download_info peut être un mot clé à définir dans les fichiers 'languages'
Configuration avancée du plugin JViewerJS
  • Tag activation Tag permettant pour activer JViewerJS. Par défaut: jviewerjs
  • Force le téléchargement Pour utiliser l'attribut 'download' afin de forcer le téléchargement du fichier par les navigateurs compatibles.
  • Navigateurs incompatibles avec JViewerJS pour ODT, ODS, ODP Liste des navigateurs ne sachant pas afficher un document ODT, ODS, ou ODP avec la méthode ViewerJS. Un lien proposant le téléchargement sera proposé. Les noms des navigateurs doivent être séparés par un pipe (AltGr+6).
  • Navigateurs incompatibles avec JViewerJS pour PDF Liste des navigateurs ne sachant pas afficher un document PDF avec la méthode ViewerJS. Celui-ci sera, si possible, affiché par EMBED ou un lien sera proposé. Les noms des navigateurs doivent être séparés par un pipe (AltGr+6).
  • Navigateurs incompatibles avec EMBED pour PDF Liste des navigateurs ne sachant pas afficher un document PDF avec une instruction EMBED. Un lien proposant le téléchargement sera proposé. Les noms des navigateurs doivent être séparés par un pipe (AltGr+6)." JVJS_DEBUG_DESC="Affiche l'agent utilisateur (navigateur) a utiliser pour la liste des navigateurs exclus.
  • Debug Affiche le nom de l'agent utilisateur (navigateur) a utiliser pour la liste des navigateurs exclus. Paramètre: debug=1|0

Utilisation

Il suffit d'insérer {jviewerjs nom_du_fichier} dans le texte de votre article.

Le tag jviewerjs peut être modifié dans les paramètres du plugin.

Le premier paramètre obligatoire est le nom du fichier. Il peut comporter le chemin à partir du dossier de base indiqué dans les paramètres du plugin. Par exemple, si votre dossier de base est "images/doc", "aide/manuel.pdf" spécifie le fichier "manuel.pdf" situé dans le dossier "votre_site/images/doc/aide"

Il est possible d'ajouter des paramètres en les séparant par des points-virgules:

  • width=50 - largeur du bloc contenant le document. Par défaut, l'unité est px, mais il est possible de l'indiquer en pourcentage (50%) pour s'adapter à un template responsive.
  • height=300 - hauteur du bloc contenant le document. Par défaut, l'unité est px, maisil est possible de l'indiquer en %.
  • fullscreen=0 ou 1 - autoriser l'affichage plein écran du document.
  • download_info=une phrase - par défaut, le texte pour afficher le lien pour télécharger le document est défini dans le fichier langue du plugin par le mot-clé JVJS_DOWNLOAD_TEXT_LABEL. Il est possible de modifier ce texte à l'aide de ce paramètre. Si le tag "%s" est présent dans le texte, il sera remplacé par le nom du fichier. Pour autoriser sa traduction, ce texte peut-être un mot-clé à définir dans le fichier langue du plugin.
  • mode=O[uvre]|S[auve]
    OUVRE affiche uniquement un lien permettant soit d'afficher le document dans un nouvel onglet ou fenêtre en utilisant la méthode appropriée au navigateur.
    SAUVE affiche uniquement un lien proposant le téléchargement du fichier (si le navigateur supporte l'attribut download)
  • debug=0|1 - pour afficher le nom de l'agent utilisateur

Exemple:
{jviewerjs nom_du_fichier; width=100%; height=400px; fullscreen=0; info=cliquer ici pour télécharger le fichier %s}

Compatibilité navigateurs-documents

Ce tableau montre les compatibilités entre les navigateurs et les différents types de documents

Si vous constatez des erreurs, n'hésitez pas à le signaler sur le sous-forum dédié

Pour tester les possibilités d'un navigateur spécifique, vous pouvez utiliser cette page qui force l'affichage des différents types de documents dans les différents modes.

Vous trouverez l'user-agent de votre navigateur dans le message debug au début de la page.

Méthodes d'affichage d'un document

Présentation dans l'ordre de priorité

ModeCibleConditions
viewer.js vue dans article courant fichier PDF, ODT, ODS, ODP
+ Navigateur compatible viewer.js
viewer.js Lien pour ouverture dans nouvel onglet fichier PDF, ODT, ODS, ODP
+ Navigateur compatible viewer.js
+ paramètre: "mode=ouvre"
Embed vue dans article courant fichier PDF
+ Navigateur non compatible viewer.js mais compatible embed
Embed Lien pour ouverture dans nouvel onglet fichier PDF
+ Navigateur non compatible viewer.js mais compatible embed
+ paramètre: "mode=ouvre"
Lien téléchargement --- Navigateur non compatible viewer.js et embed
ou paramètre: "mode=sauve"
ou extension de fichier non reconnue

Les plus et les moins

Les plus
  • Assurance de procurer un moyen de voir ou de télécharger le fichier avec tous les navigateurs
  • Facilité d'utilisation. A la suite des tests de ce module, j'ai prévu de faire un plugin-bouton pour les éditeurs pour télécharger le fichier et construire le tag
Les moins

Toutes les suggestions sont les bienvenues pour les supprimer

  • Pas de possibilités pour supprimer les barres d'outils
  • Support (très) partiel du rendu des ODT par jviewer.js: Pas de pied de page, tableau, ...
  • Support (très) partiel du rendu des ODS par jviewer.js: Fusion de cellules, ...
  • Attribut download de la balise non généralisé. A remplacer par un JavaScript ?

Téléchargement

Autres articles

Support

Pour partager vos questions et suggestions, c'est par ici : forum jviewerjs

Print Friendly and PDF