L'API Flickr est fermée ainsi que ses alternatives.
Pour préserver les shortcodes existants, l'action génère une image avec un arrière-plan coloré et les dimensions spécifiées.
afin de préserver les shortcodes existants, l'action génère une image avec un fond coloré et les dimensions spécifiées
Syntax 1 :
{up loremflickr=type | width=xx | height=xx}- lorem_flickr (lorempixel,lorem_placeimg): texte
- height (h,hauteur) = 200: hauteur image téléchargée
- width (l,largeur,w) = 200: largeur image téléchargée
- orientation: NON DISPONIBLE
- color = g: Couleur background
- number = 1: nombre d'images retournées
gestion du cache
- cache-delai = - 1: durée de validité du cache. 0:aucun, 1:une heure, -1:illimité
- cache-reset: efface TOUS les fichiers dans le cache
Methode pour retour
- mode = img: balise img ou dir pour le chemin vers le dossier
Bloc parent
- main-tag (block) = div: balise du bloc parent à l'image si options main-class ou align
- main-class: classe(s)
- align: alignement horizontal : left, center, right
Style CSS
- id: identifiant
- class: classes et styles image(s) en mode=img
- style: classes et styles image(s) en mode=img
- Version 3.0
- Les sites lorempixel.com et placeimg n'existant plus, c'est l'action lorem-flickr qui sera utilisée. Normalement, cela devrait être transparent, sauf si vous utilisiez des options comme sepia ou grayscale.
Le nouveau nom de l'action est lorem-flick, mais par souci de compatibilité lorempixel est utilisable sans modification des anciens shortcodes.
- Version 5.1
- le script de cette action a totalement été réécrit pour répondre au changement d'API de Flickr.
- Version 5.2
- L'API Flickr est fermée ainsi que les alternatives.
Pour préserver les shortcodes existants, l'action génère une image avec un arrière-plan coloré et les dimensions spécifiées.
Version minimale
{up lorem-flickr}Une image de 200x200px relative à Joomla est affichée.
Choix du type d'image
Le shortcode pour l'image ci-contre est :
{up lorem-flickr=paris,statue}Alors que lorempixel avait un choix limité de type d'image, lorem-flickr permet d'utiliser des mots clés non définis à l'avance. Un unique mot peut être recherché ou plusieurs en les séparant par des virgules.
Dimensions
width & height est la taille demandée en pixels
{up lorempixel=pizza | width=800 | height=150}Orientation
Il n'est pas possible d'obtenir de l'API flickr une image aux dimensions désirés. Elle sera juste plus grande que celle demandée, le recadrage est fait par UP.
Pour éviter d'avoir des images verticales recadrées en horizontal et vice-versa, l'option orientation permet d'utiliser uniquement des images horizontales ou verticales. par défaut, toutes les images sont utilisées.
Un peu de style
{up lorem-flickr=joomla,france
| class=border:red 2px solid;m1;w50
| main-tag=header
| main-class=border:2px green dotted
| align=center
| w=800px
}- L'appel de l'action avec Joomla et france comme mots-clés. Eh oui !!!
- class donne du style à l'image. Remarquez le mélange des styles et des classes autorisé par UP
- si besoin main-tag permet de changer la balise du bloc parent (div par défaut)
- main-class ajoute un enrichissement au bloc parent
- align accepte left, center et right pour aligner l'image dans son bloc parent
- w, synonyme de width, demande à flickr de retourner une image de 800px de large. La hauteur est celle par défaut (200px). Notez que la largeur affichée est celle définie par l'option class=w50 au point 2
Plusieurs images
Ayant besoin de plusieurs images pour la démo de la nouvelle action slider-tiny, j'ai profité de la refonte de cette action pour lui permettre de retourner plusieurs images avec l'option number.
2 modes sont possibles :
- mode=img (par défaut) retourne les image dans des balises img
- mode=dir retourne le chemin vers le dossier du cache qui contient les images
Les shortcodes avec mode=img (par défaut)
{up slider-tiny | items=2}
{up lorem-flickr | number=12 | height=400 | width=600 | orientation=H}
{/up slider-tiny}Les shortcodes avec mode=dir
{up slider-tiny={up lorem-flickr | number=12 | mode=dir | height=400 | width=600 | orientation=H}
| items= 2 } Un autre exemple avec l'action image-random qui accepte uniquement un chemin vers un dossier
{up image-random={up lorem-flickr | mode=dir | height=400 | width=600 | orientation=H | number=12}} Si aucun mot-clé ne correspond
{up lorem-flickr=xxxxxxxxxxxxxx}Une image interne à l'action est affichée.
Le cache
Un système de cache est proposé par l'action pour accélérer le chargement et réduire la bande passante.
En mode développement, il devient inutile d'effectuer une requête lors de chaque test de la page.
2 options sont prévues :
- cache-delai : la durée de validité du cache. 0:aucun, 1:le nombre d'heures entre chaque requête, -1:illimité (par défaut)
- cache-reset : une option à utiliser en maintenance pour effacer TOUS les fichiers dans le cache situé dans le dossier
tmp/up-flickr
Exécutez l'action avec cache-delai=0, une fois que vous avez trouvé une image qui vous convient, supprimez l'option cache-delai ou mettez-la à cache-delai=-1
Cette action nécessite de qu'Internet soit disponible sur votre poste lors de la première requête..
box (1) span (1) div (4) note (1) upactionslist (1) readmore (1) csv2def (1) flexbox (3) lorempixel (2) addcsshead (1) lorem-flickr (5) flexauto (2) listup (1) slider-tiny (1) image-random (1) jcontent-info (1)