myMoreTpl - guide du contributeur
Convention d'écriture des fonctions
Toutes les fonctions devont être déclarées dans la class myMoreTpl
Penser à indenter proprement le code afin qu'il soit le plus lisible possible.
On décrira chaque fonction en plaçant avant le code lui-même un commentaire sous cette forme :
/**
NomFonctionTemplate
Cette fonction fait ceci et cela
Utilisation : {{tpl:NomFonctionTemplate}} -> exemple
*/
Ajout au wiki
On place les fonctions dans l'ordre chronologique de leur ajout, la plus récente en haut, pour qu'on sache facilement quelles sont les dernières qui ont été ajoutées.
Penser à préciser php dans la balise de code, ça le rendra plus lisible (balise wiki <code php>).
Quand on ajoute une fonction, on indique son nom (niveau h3), puis une brève description en gras suivie d'une liste indiquant le type de balise (value ou block), les fichiers html dans lesquels elle est utilisable, le contexte de balises dans lequel elle doit se trouver pour fonctionner.
On fait ensuite deux parties, l'une intitulée « Déclaration » (niveau h4) et comportant la ligne de déclaration, l'autre intitulée « Fonction » (niveau h4) comportant le code de la fonction. Si ce code comporte des paramètres, penser à les indiquer dans la partie commentaires.