Translations
Info
All page names need to be in English.
en da  de  fr  it  ja  km  nl  ru  zh

Fr:TypoScript Constants

From TYPO3Wiki
Jump to: navigation, search


This page belongs to the Core Team (category Core Team)

notice - Reviewer needed

Change the {{review}} marker to {{publish}} when all parts are reviewed (e.g. TypoScript). info


Cette page est un brouillon destiné à être inclus dans le manuel du cœur : TypoScript Syntax and In-depth Study


À insérer à la fin du chapitre 1.2. Syntax, avant "Includes"

Constantes

Déclarer et utiliser des constantes

Les constantes TypoScript sont déclarées simplement dans le champ "Constantes" d'un gabarit TypoScript. Exemple :

styles.content.imgtext.maxW = 600

Pour utiliser cette constante dans un gabarit TypoScript, utiliser cette syntaxe :

temp.myimage.width = {$styles.content.imgtext.maxW}

La déclaration de constantes peut utiliser de manière normale les commentaires, tous les opérateurs et les conditions, puisqu'il s'agit de TypoScript.

Préparer pour l'éditeur de constantes

Le module Web > Template possède une fonctionnalité appelée Constant Editor. Avec cet éditeur, il est possible de modifier les constantes TypoScript de manière simple. Cependant, toutes les constantes n'apparaissent pas dans le Constant Editor. Seules celles correctement déclarées seront visibles. Voici un exemple de syntaxe :

#cat=content,basic/cImage/a_maxw1; type=int+; label= Max Image Width: This indicates that maximum number of pixels (width) a block of images inserted as content is allowed to consume.
styles.content.imgtext.maxW = 600

Examinons cette syntaxe en détail :
"cat" est la catégorie de la définition de la constante. Plusieurs catégories peuvent être assignées, bien que l'une d'elles soit la catégorie standard. La "catégorie" peut être constituée d'une catégorie, une sous-catégorie et d'un index de tri
"type" est le type de la constante, et il définit la nature de la valeur entrée
"label" est le libellé de la constante

Types de constantes

Exemple :

# cat=basic/xxx/010; type=string; label= string: ma chaîne de caractères
t1 = Je suis un texte

# cat=basic/xxx/011; type=int; label= int: (Entier, qui peut être négatif)
t2 = -99

# cat=basic/xxx/012; type=int+; label= int+: (Entier, seulement positif)
t3 = 88

# cat=basic/xxx/013; type=offset; label= offset: (valeurs x et y)
t4 = 88, 55

# cat=basic/xxx/010; type=color; label= color: un sélecteur de couleur
t5 = ff0000

# cat=basic/xxx/011; type=wrap; label= wrap: un Wrap
t51 = <b>|</b>

# cat=basic/xxx/011; type=options[de, en, fr, zh]; label= options[de, en, fr, zh] une liste déroulante
t7 = fr

# cat=basic/xxx/010; type=boolean; label= boolean: une case à cocher
t8 = 1

# cat=basic/xxx/010; type=file[png, jpg, gif]; label= file[png, jpg, gif] un fichier
t9 = fileadmin/clear.gif

# cat=basic/xxx/010; type=small; label= small : un court champ texte
t10 = xyz

Il existe aussi un champ utilisateur "user", et un champ "comment" pour des valeurs non éditables.

Catégories de constantes

La catégorie principale définit la page de l'éditeur sur laquelle la constante appapparaîtra. Les catégories suivantes sont pré-définies :

  • 'basic' : constantes d'importance supérieure pour le template-layout. Cela concerne des dimensions, images et activation de diverses fonctionnalités. Ce sont les constantes les plus basiques, que vous souhaiterez configurer la plupart du temps.
  • 'menu' : configuration du Menu. Inclut les polices de caractères, tailles, images de fond. Dépend du type de menu.
  • 'content' : constantes relatives à l'affichage des contenus de pages.
  • 'page' : configuration générale telle que métabalises, cibles des liens.
  • 'advanced' : fonctions avancées, utilisées très rarement.
  • 'all' : toutes les constantes sont aussi affichées à cet endroit !

Les catégories principales personnalisées sont aussi définissables pour des extensions. Exemple :

  1. cat=plugin.tx_lot3blog/color/210; type=color; label=Tagcloud Minimum Color

Les sous-catégories définissent dans quelle section la constante doit être placée. Les sous-catégories standard suivantes existent :

  • 'enable': activation de fonctionnalités
  • 'dims': dimensions, largeurs, hauteurs, pixels
  • 'file': fichiers
  • 'typo': typographie
  • 'color': couleurs
  • 'links': liens et cibles
  • 'language': constantes spécifiques de langues

En outre, les sous-catégories suivantes, spécifiques aux contenus, existent : cheader, cheader_g, ctext, cimage, cbullets, ctable, cuploads, cmultimedia, cmailform, csearch, clogin, csplash, cmenu, cshortcut, clist, cscript, chtml

Source: TYPO3 Konstanten im Konstanteneditor anzeigen