L'extension Apijs pour Redmine
N'oubliez pas que cette documentation ne concerne que la dernière version de l'extension.
N'oubliez pas de lire cette page entièrement.
Présentation de l'extension
Description
Intègre la bibliothèque JavaScript apijs sur Redmine.
Pour plus d'information sur la bibliothèque, voir luigifab.info/apijs.
Cette extension permet :
- de trier les pièces jointes par ordre alphabétique
- d'afficher une galerie photo/vidéo à partir des pièces jointes
- d'afficher les vidéos en streaming (HTTP 206 Partial Content)
- de mettre en cache les images affichées (cache du navigateur)
- de redéfinir la date de création des photos à partir de la date EXIF (DateTimeOriginal)
- de télécharger les pièces jointes avec la boîte de dialogue de téléchargement d'un fichier du navigateur
- de modifier la description des pièces jointes
- de supprimer des pièces jointes
La modification et la suppression des pièces jointes se configurent avec les rôles et permissions de Redmine.
Tout le reste est configurable sur la page de configuration de l'extension.
Il est important de noter que cette extension utilise des programmes externes pour fonctionner (voir les détails un peu plus loin).
Accès et configuration
Configuration disponible dans Administration » Plugins » Redmine Apijs plugin » Configurer.
Disponible de partout, notamment dans toutes les listes de pièces jointes.
- Capture d'écran de la configuration (1/6)
- Capture d'écran d'une demande (2/6)
- Capture d'écran d'une annonce (3/6)
- Capture d'écran d'un document (4/6)
- Capture d'écran d'une page wiki (5/6)
- Capture d'écran d'un message dans le forum (6/6)
Installation
Dépendances
Les programmes suivants sont nécessaires au bon fonctionnement de l'extension (les versions sont données à titre purement indicatif) :
- file (5.11, 5.14, 5.17, 5.18, 5.30) : permet de déterminer le type mime des photos et vidéos
- python-pil (1.1.7, 2.2.1, 2.3.0, 3.4.2, 4.1.1) : permet de générer les miniatures des photos
- ffmpegthumbnailer (2.0.7, 2.0.8, 2.1.1) : permet de générer les miniatures des vidéos
- libimage-exiftool-perl (8.60, 9.27, 9.46, 9.53, 9.62, 10.33, 10.58) : permet de lire les métadonnées des photos et vidéos
- ruby-zip (1.1.2) : permet de lire les fichiers ZIP
Pour installer ces programmes avec Debian/Ubuntu :
sudo aptitude install python-pil libimage-exiftool-perl ffmpegthumbnailer ruby-zip
Pour l'installation de ruby-zip, il est possible de l'installer avec bundle une fois l'extension en place dans son dossier :
bundle update
Mise en place
Pour Redmine 1.4, décompresser le contenu de l'archive dans REDMINE/vendor/plugins/redmine_apijs/ et redémarrer Redmine.
Pour Redmine 2.x, décompresser le contenu de l'archive dans REDMINE/plugins/redmine_apijs/ et redémarrer Redmine.
Pour Redmine 3.x, décompresser le contenu de l'archive dans REDMINE/plugins/redmine_apijs/ et redémarrer Redmine.
Dépannage
Toutes les commandes appelées sont enregistrées dans le fichier de log.
Pour les retrouver facilement, il suffit de chercher APIJS:: dans le fichier.
Téléchargement et démo de l'extension
Démonstration : n/d
Téléchargement de la dernière version : apijs-5.3.0.tar.gz (md5 827b838a36940e4796cda5ec643068f6)
Voir aussi : redmine.org/plugins/apijs
Dépôt GitHub : github.com
- Version actuelle : 5.3.0 (01/01/2017)
- Compatibilité : Linux + Redmine 1.4.7 / 2.0 / 2.1 / 2.2 / 2.3 / 2.4 / 2.5 / 2.6 / 3.0 / 3.1 / 3.2 / 3.3
- Traductions (6) : Allemand (DE), Anglais (EN), Espagnol (ES), Français (FR), Italien (IT), Portugais (PT)
- Licence : GNU GPL 2
- À lire absolument : le fichier README
Testée avec Firefox 22/45, Chrome 29/55, Opera 42, IE 11 sur Redmine 3.2.0 / 3.3.1 avec Ruby 2.3.3-p222 et Rails 4.2.7.
Version 5.2.0 testée avec Firefox 38 sur Redmine 1.4.7 / 2.0.0 / 2.1.0 / 2.2.0 / 2.3.0 / 2.4.0 / 2.5.0 / 2.6.0 / 3.0.1 avec Ruby 1.9.3-p194 / 1.9.3-p484 / 2.1.2-p95 / 2.1.5-p273 et Rails 3.2.17 / 3.2.18 / 3.2.19.
Support
Un problème ? Une question ? Quelque chose ne fonctionne pas ? Y a un bug ? Contactez-moi (en français ou en anglais), si je ne suis pas en vacances et pas loin de ma boite email, je vous répondrai dans quelques heures.
Vous trouverez mon adresse email dans le fichier README, lisez-le !