Elle permet de générer des images de la taille voulue qui est rappelée dans un texte.
L'action facilite la rédaction et la normalisation de la requête et offre un système de cache pour éviter des connexions trop fréquentes.
La couleur du fond et du texte peut être spécifiée par son code hexadecimal ou son nom
syntaxe
{up lorem-place=250x150 | text=... | bg-color=gold | text-color=333}- lorem_place: dimension de l'image largeur x hauteur
- width (l,largeur,w) = 300: largeur de l'image en pixels
- height (h,hauteur) = 300: hauteur de l'image en pixels
- bg-color = CCC: Couleur de fond. Code hexa ou nom.
- text-color = 333: Couleur du texte. Code hexa ou nom.
- text: texte affiché. 56 caractères maxi. Saut de ligne BR: \n
- font = Lato: police : Lato,Montserrat,Oswald,PT Sans,Roboto,Lora,Open Sans,Playfair Display,Raleway,Source Sans Pro
- format = svg: svg, png, jpeg, gif ou Webp.
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
style
- id: identifiant
- class: classe(s) et style pour bloc
- style: classe(s) et style pour bloc
- css-head (base-css): style ajouté dans le HEAD de la page
Un exemple simple
Sans option, une image carrée de 300px avec un fond gris clair et texte gris foncé est créée.
{lorem-place}
Avec dimensions et couleurs
Les dimensions peuvent être indiquées avec les options width et height, mais le plus rapide reste encore de les saisir comme argument principal de l'action. Elles sont obligatoirement exprimées en pixels. Il n'est pas nécessaire d'indiquer l'unité.
Les couleurs sont saisies avec les options bg-color et text-color sous la forme :
- d'un code hexadécimal. Le signe # est optionnel.
- du nom reconnu par les navigateurs. Un rappel de ces noms sur cette page.
{up lorem-place=250x150
| bg-color=gold | text-color=800}
Avec du texte personnalisé
L'option text permet de saisir le texte qui sera affiché au centre de l'image.
Un saut de ligne est indiqué avec les caractères, bien connus des développeurs : \nLa longueur du texte est limité à 56 caractères. Utilisez de préférences les nombres et les lettres de A à Z.
{up lorem-place=250x150
| bg-color=DarkGreen | text-color=Yellow
| text=UP\nUniversal Plugin}
L'option font permet de choisir la police dans cette liste : Lato,Montserrat,Oswald,PT Sans,Roboto,Lora,Open Sans,Playfair Display,Raleway,Source Sans Pro
{up lorem-place=250x200 | bg-color=tan| text-color=maroon
| text=Oswald | font=oswald}
Format de l'image
Par défaut, le format de l'image est en SVG.
Avec l'option format, vous pouvez choisir entre svg, png, jpeg, jpg, gif ou webp.
Le cache
L'action propose un système de cache pour limiter les appels au site.
L'option cache-delai définit son mode de fonctionnement :
- 0 : aucun cache, la source de l'image est l'url vers le site
- -1 : le cache est illimité. L'image est stockée en local
- 1 : le nombre d'heures avant de recréer l'image
Le cache se trouve dans le dossier tmp/ up-place.
Vous pouvez le vider en FTP, mais le plus simple est d'ajouter une option cache-delai qui va supprimer TOUS les fichiers du cache.
N'oubliez pas de la retirer une fois son action effectuée.
Cliquer pour lire la documentationN'oubliez pas la documentation au début des démos.
Étant lue directement dans le script de l'action, elle a toujours les dernières informations.
div (3) upactionslist (1) flexbox (3) lorem-place (14) html (1) text-blink (1) jcontent-info (1) tabslide (1) toc (1)