Introduction

Malgré cette page qui peut paraître assez longue, l'installation se fait en quelques clics. Les variables n'étant à changer qu'en cas de choix personnels particuliers.

Téléchargement

Pour installer ce plugin, vous devez télécharger au préalable les fichiers sur la page de téléchargement.

Installation

• Créer un dossier directresize dans le dossier assets/plugins/ et y copier les fichiers du zip
• Eventuellement créer un dossier où seront stockées à part les miniatures, genre : assets/images/cache/
• Copier le contenu de directResize.plugin.php dans un nouveau plugin que vous nommez à votre convenance. Cocher "OnWebPagePrerender" dans l'onglet "Evénements système".
  N'oubliez pas supprimer les balises <?php ?>
• Modifier les variables du plugin au besoin.

----------------------------------------------------------------------------------------------------------------

Paramêtrage

Organisation des dossiers

Suivant ce que vous cherchez à faire, il peut être intéressant de créer un dossier dans le dossier /images/ où seront placés les fichiers originaux. En effet, directResize permet de limiter le redimentionnement aux images appartenant à un dossier en particulier et à ses sous-dossiers.

Par conséquent, si vous ne souhaitez pas que toutes les images figurant dans le dossier /images/ soient traitées par directResize, créez un dossier /images/originales/ par exemple.

Paramêtrage des variables

Vous avez accès aux variables de fonctionnement au début de la programmation du plugin. Voici les valeurs que vous pouvez modifier :

• $path :
  là où seront stockées vos miniatures calculées par directResize
  ex: "assets/images/cache"
• $prefix :
  cette valeur permet de mettre un tag de prefix aux images calculées
  ex: "dresize_"
• $r :
  défini la rêgle à respecter pour recadrer les images.
  0 : les images seront recalculées aux dimentions exactes définies par le width et le height. C'est certainement la valeur par défaut à utiliser le plus souvent.
  1 : les images seront recalculées proportionnelement suivant la valeur de width.
  2 : les images seront recalculées proportionnelement suivant la valeur de height.
  3 : les images seront recalculées proportionnelement dans les limites maximales de width et de height.
  4 : les images seront recalculées proportionnelement pour déterminer l'image minimale nécessaire pour remplir un espace de width x height.
  Vous trouverrez une page d'explications plus complète ici .
  ex: 0
• $q_jpg :
  défini la qualité jpg à utiliser. De 0 (mauvaise qualité, poid léger) à 100 (très bonne qualité, poid élevé)
  ex: 90
• $q_png :
  défini la qualité png à utiliser. De 0 (aucune compression) à 9 (très compressé) (fonction inactive pour le moment)
  ex: 3
• $lien_base :
  restreint le calcul aux seules images présentes dans ce dossier et ses sous dossiers. Cela évite déjà dans un premier temps de ne pas recalculer les images du template qui sont souvent dans le dossier assets/templates/montemplate/images/. Si vous souhaitez utiliser directResize pour une pseudo galerie, mettez vos images dans un dossier assets/images/galerie/ et changez le chemin de cette variable en fonction.
  ex: "assets/images"
• $lien_plugin :
  lien vers le fichier de plugin
  ex: "assets/plugins/directresize/directResize.php"
• $lightbox :
  activation de lightbox automatique
  0 : non activé
  1 : activé pour les images avec lightbox dans leurs class par exemple. Il suffit que le mot "lightbox" apparaisse quelque part dans la balise <img>. Cette fonction s'applique à toutes les images de la page même si elle ne sont pas dans le répertoire de base spécifié en $lien_base, du moment qu'elles possédent un marquage lightbox.
  2 : activé pour toutes les images de la page qui sont dans le dossier de base spécifié en $lien_base.
  Le système ne crée un zoom que sur les images dont la taille originale est supérieure à l'image affichée dans la page.
  Il est à noter que le mode de redimentionnement pour lightbox est le mode 3 par defaut. (voir rubrique $r)
  ex: 1
• $lightbox_w :
  largeur maximale pour les images de zoom
  ex: 700
• $lightbox_h :
  hauteur maximale pour les images de zoom
  ex: 500
• $lightbox_g :
  Détermine si les images de la page avec un zoom lightbox doivent être groupées pour bénéficier des boutons suivant et précédent de Lightbox.
  0 : desactivé
  1 : activé
  ex:1