L'extension Apijs pour Redmine

Sommaire

Présentation de l'extension
1. Description
2. Accès et configuration
Installation
Téléchargement de l'extension
Support

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

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 de l'extension

Téléchargement de la dernière version : apijs-5.3.0.tar.gz (md5 827b838a36940e4796cda5ec643068f6)
Voir aussi : redmine.org/plugins/apijs
Dépôts publics : github.com / sourceforge.net

Version actuelle : 5.3.0 (01/01/2017)
Compatibilité : 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 - Linux
Traductions : 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 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 !