Dans un modèle de mise en page, la définition des blocs configurable à lieu en trois étapes.

1. la définition des blocs
2. les macros indiquant le code à générer
3. le placement des blocs

1. La définition des blocs

L'en-tête d'une mise en page comprend les définitions de couleurs et de blocs configurables qui pourront être choisis par l'utilisateur.

Syntaxe :

 smartblock [classe de l'emplacement].[identifiant de l'emplacement] "[description de l'emplacement]" [type de bloc configurable par défaut] [type de page par défaut]

Exemple :

 smartblock sb.right1 "Bloc de droite 1" calendar index

Signification des champs :

• classe de l'emplacement :  il est possible de définir plusieurs classes d'emplacements et générer pour chacune un code diffèrent. Par exemple, chaque classe d'emplacement pourrait avoir une classe CSS différente et ainsi être présentée différemment. Dans la plupart des cas, une seule classe est utilisée. A chaque classe d'emplacement correspond un jeu de macros permettant de spécifier le code généré.
• identifiant de l'emplacement : cet identifiant doit être unique. Il permet de spécifier à quel endroit le code doit être génèré.
• description de l'emplacement : décrit a quel endroit se trouve l'emplacement et comment le bloc sera présente.
• type de bloc configurable par défaut : précise le type du bloc qui correspond a cet emplacement. Il peut être changé par l'utilisateur du modèle.
• type de page par défaut : précise le type des pages pour lesquelles le bloc sera affiché. Il peut être change par l'utilisateur du modèle.

1. Les macros indiquant le bloc à générer

Les blocs configurables sont constitués grâce à des macros, qui permettent d'automatiser les choses.

1. Le placement des blocs

Il s'agit de mettre les blocs configurables aux endroits désirés dans la mise en page.

Syntaxe :

 smartblock [classe de l'emplacement].[identifiant de l'emplacement]