JViewerJS ~ afficher des PDF, ODT, ODS et ODP

Description

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

Installation / configuration

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

• 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'

• 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}

Méthodes d'affichage d'un document

Présentation dans l'ordre de priorité

Les plus et les moins

• 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

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

• jviewerjs_v5.0.zip (471.68 ko - 26/11/2023 18:26) téléchargé 13 fois
• jviewerjs_v1.2.zip (471.33 ko - 26/11/2023 18:26) téléchargé 59 fois

Support

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