format texte Unix (la plupart des éditeurs de texte
permettent cela).</li>
<li class="spaced">Toutes les balises php doivent être
- en forme complète, par exemple <font color="#339900"><?php
- ... ?></font> et non en forme abrégée comme
- <font color="#339900"><? ... ?></font>.</li>
+ en forme complète, par exemple <font color="#339900"><?php
+ ... ?></font> et non en forme abrégée comme
+ <font color="#339900"><? ... ?></font>.</li>
<li class="spaced">Toutes les indications de copyright doivent
être conservée. Vous pouvez ajouter les vôtres au besoin.</li>
<li class="spaced">Tous les fichiers doivent inclure le
ou au moins leur existence doit être testée avec isset() ou
empty() avant leur utilisation.</li>
<li class="spaced">Toutes les chaînes de caractères doivent
- être traductibles. Placez-les dans des fichiers de « lang/en » et
- appelez-les avec les fonctions get_string() ou print_string().</li>
+ être traduisibles. Créez les nouvelles chaînes dans les fichiers
+ du dossier « lang/en », donnez-leur des noms en minuscules,
+ brefs, en anglais, et utilisez-les dans votre code par l'intermédiaire
+ des fonctions get_string() ou print_string().</li>
<li class="spaced">Tous les fichiers d'aide doivent être
traductibles. Créez-les dans le dossier « lang/en/help » et
appelez-les avec la fonction helpbutton().</li>
être en majuscules, et toujours commencer par le nom du module. Les
mots qui les constituent doivent être séparés par des
caractères « souligné » (underscore).
- <p class="examplecode"><font color="#006600">define("FORUM_MODE_FLATOLDEST",
+ <p class="examplecode"><font color="#006600">define("FORUM_MODE_FLATOLDEST",
1);</font></p>
</li>
<li class="spaced">Les noms des <strong>fonctions</strong> doivent être de
- simples mots anglais, et commencent avec le nom du module pour
+ simples mots anglais en minsucules, et commencer avec le nom du module pour
éviter les conflits entre modules. Les mots qui les constituent
doivent être séparés par des caractères « souligné » (underscore).
Les paramètres doivent avoir si possible une valeur par défaut
<br />
if (</font><font color="#0000BB">$mode</font><font color="#007700">)
{<br />
- </font><font color="#0000BB">$USER</font><font color="#007700">-></font><font color="#0000BB">mode
+ </font><font color="#0000BB">$USER</font><font color="#007700">-></font><font color="#0000BB">mode
</font><font color="#007700">= </font><font color="#0000BB">$mode</font><font color="#007700">;<br />
- } else if (empty(</font><font color="#0000BB">$USER</font><font color="#007700">-></font><font color="#0000BB">mode</font><font color="#007700">))
+ } else if (empty(</font><font color="#0000BB">$USER</font><font color="#007700">-></font><font color="#0000BB">mode</font><font color="#007700">))
{<br />
- </font><font color="#0000BB">$USER</font><font color="#007700">-></font><font color="#0000BB">mode
- </font><font color="#007700">= </font><font color="#0000BB">$CFG</font><font color="#007700">-></font><font color="#0000BB">forum_displaymode</font><font color="#007700">;<br />
+ </font><font color="#0000BB">$USER</font><font color="#007700">-></font><font color="#0000BB">mode
+ </font><font color="#007700">= </font><font color="#0000BB">$CFG</font><font color="#007700">-></font><font color="#0000BB">forum_displaymode</font><font color="#007700">;<br />
}<br />
}</font></p>
</li>
<li class="spaced">Les <strong>blocs</strong> doivent toujours être
placés entre accolades (même s'ils ne sont constitués que d'une ligne).
Moodle utilise le style suivant :
- <p class="examplecode"> <font color="#006600">if (</font><font color="#0000CC">$quiz</font><font color="#006600">-></font><font color="#0000CC">attempts</font><font color="#006600">)
+ <p class="examplecode"> <font color="#006600">if (</font><font color="#0000CC">$quiz</font><font color="#006600">-></font><font color="#0000CC">attempts</font><font color="#006600">)
{<br />
- if (</font><font color="#0000CC">$numattempts </font><font color="#006600">>
- </font><font color="#0000CC">$quiz</font><font color="#006600">-></font><font color="#0000CC">attempts</font><font color="#006600">)
+ if (</font><font color="#0000CC">$numattempts </font><font color="#006600">>
+ </font><font color="#0000CC">$quiz</font><font color="#006600">-></font><font color="#0000CC">attempts</font><font color="#006600">)
{<br />
</font><font color="#0000CC">error</font><font color="#006600">(</font><font color="#0000BB">$strtoomanyattempts</font><font color="#006600">,
- </font><font color="#CC0000">"view.php?id=$cm</font><font color="#006600">-></font><font color="#CC0000">id"</font><font color="#006600">);<br />
+ </font><font color="#CC0000">"view.php?id=$cm</font><font color="#006600">-></font><font color="#CC0000">id"</font><font color="#006600">);<br />
}<br />
}</font></p>
</li>
guillemets) lorsque c'est possible, afin d'améliorer les performances.
<p class="examplecode"> <font color="#006600">$var = 'some text without any
variables';<br />
- $var = "with special characters like a new line \n";<br />
+ $var = "with special characters like a new line \n";<br />
$var = 'a very, very long string with a '.$single.' variable in it';<br />
- $var = "some $text with $many variables $within it"; </font></p>
+ $var = "some $text with $many variables $within it"; </font></p>
</li>
<li class="spaced">Les <strong>commentaires</strong> doivent utiliser
deux ou trois barres obliques et être alignés avec le code.
entre les parenthèses et les instructions normales, mais aucun
espace entre les parenthèses et les variables ou fonctions :
<p class="examplecode"> <font color="#007700">foreach (</font><font color="#0000BB">$objects
- </font><font color="#007700">as </font><font color="#0000BB">$key </font><font color="#007700">=></font><font color="#0000BB">
+ </font><font color="#007700">as </font><font color="#0000BB">$key </font><font color="#007700">=></font><font color="#0000BB">
$thing</font><font color="#007700">)</font><font color="#006600"> {<br />
</font><font color="#007700"> </font><font color="#0000BB">process($thing);</font><font color="#006600">
<br />