ezimage

Date de publication: le jeudi 31 mars 2011 à 15h53
Dernière modification: par Pascal BOYER le vendredi 1 avril 2011 à 11h42

24/01/2007 10:32

Versions 3.9, 3.10 et 4.0

Summary / Résumé

Returns the input string prepended with the current image directory.
Renvoie la chaîne de caractère passée en entrée préfixée par le chemin du répertoire de l'image.

Usage / Utilisation

input|ezimage( [ quote [, slash_skip ] ] )

Parameters / Paramètres

Returns / Renvoie

The input string prepended with the current image directory.
Renvoie la chaîne de caractères passée en entrée préfixée par le chemin du répertoire de l'image.

Description

This operator prepends the input string with the location of the image directory used by the current design. If the operator is unable to find the specified file within the "images" subdirectory of the current design, it will attempt to locate it in the "images" subdirectory of the fallback designs or the standard design. The "ezimage" operator should always be used when an image is included in a template. It will make sure that the path to the image is always correct, regardless of the location of the eZ Publish directory, the access method, the environment, and so on.
Cet opérateur préfixe la chaîne de caractères passée en entrée avec le chemin/path du répertoire images du design courant. Si l'opérateur ne peut trouver le fichier spécifié dans le sous-répertoire images du design courant, il essaiera alors de le localiser dans le sous-répertoire images des designs de replis puis du design standard. Cet opérateur doit toujours être utilisé lorsqu'une image est incluse dans un template car il permet de s'assurer que le chemin menant à 'image est toujours correct indépendamment du répertoire d'installation de eZ publish, de la méthode d'accès, de l'environnement, etc...

By default, this operator returns a double-quoted string. The optional "quote" parameter can be used to control the way the address is returned: "no" (no quotes), "single" (single quotes) or "double" (double quotes, the default). The optional "skip_slash" parameter can be used to get rid of the first slash within the string that is being returned (when set to false()).
Par défaut, cet opérateur renvoie une chaîne de caractères placée entre des guillemets doubles. Le paramètre optionnel quote doit donc être employé pour contrôler la façon dont le chemin est retourné: "no" permet de n'avoir aucun guillemet, "single" de placer la chaîne de caractères entre des guillemets simples et "double" (qui est la valeur par défaut) entre des guillemets doubles. Le paramètre optionnel skip_slash est utilisé pour omettre le premier slash dans la chaîne de caractères retournée (ce paramètre vaudra alors false() )

Exemple 1

In this example, the design "my_company" is used by the siteaccess. Images should be included in the following way:
Dans cet exemple, le design my_company est utilisé par le siteaccess et les images sont donc incluses ainsi:

<img src={'banner.jpg'|ezimage()} alt="My banner" ...>

The following output will be produced:
Le code suivant sera retourné:

<img src="/design/my_company/images/banner.jpg" alt="My company" ... />

If eZ Publish is unable to find the image within the images directory of the current design directory, it will attempt to find it within the images subdirectory of the additional designs. At last, it will fallback to the standard design. In this case, the output will be the following:
Si eZ Publish ne peut trouver l'image dans le sous-répertoire images du design courant, alors il essaiera de la trouver dans le sous-répertoire images des designs de replis et en dernier ressort la cherchera dans le répertoire du design standard. Dans ce cas, le code produit sera:

<img src="/design/standard/images/banner.jpg" alt="My company" ...>