mirrored from git://git.moodle.org/moodle.git
/
coding.html
58 lines (58 loc) · 2.52 KB
/
coding.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
<h2>Reglas generales de código en Moodle<br>
</h2>
<h3>Reglas Generales<br>
</h2>
<ol>
<li>Todos los archivos deben utilizar la extensión .php.</li>
<li>Deben mantenerse todas las notas de copyright. Ud. puede colocar
la suya si es necesario.</li>
<li>Cada archivo debe incluir el config.php principal.</li>
<li>Cada archivo debe certificar que el usuario esté
correctamente autenticado, utilizando require_login() and isadmin(),
isteacher(), iscreator() o isstudent().</li>
<li>Todo acceso a la base de datos debe utilizar las funciones
incluidas en lib/datalib.php en cuanto sea posible --esto permite la
compatibilidad entre un amplio rango de bases de datos. Con esas
funciones es posible hacer casi todo. Cualquier otra sentencia
SQL debe ser: inter-plataforma, restringida a funciones
específicas dentro del código (a menudo un archivo
lib.php), y señalado con claridad.</li>
<li>Todas las cadenas deben ser traducibles --crear nuevos textos en
los archivos de "lang/en" y llamarlos utilizando get_string() o
print_string().</li>
<li>Todos los archivos de ayuda deben ser traducibles --crear nuevos
textos en los archivos de "lang/en/help" y llamarlos utilizando
helpbutton().</li>
</ol>
<p> </p>
<h3>Estilo de código</h2>
<ol>
<li>No utilice tabuladores. Use sangría consistente con 4
espacio.</li>
<li>Siempre se deben utilizar llaves para los bloques de
código (aunque sean de una sola línea). Moodle usa este
estilo:
<p> <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">) {<br>
</font><font
color="#0000cc">error</font><font color="#006600">(</font><font
color="#cc0000">$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>
}<br>
}</font></p>
</li>
<li>Más por venir... este documento aún no está
completo.</li>
</ol>
<p align="center"> </p>
<hr>
<p align="center"><font size="1"><a href="." target="_top">Moodle
Documentation</a></font></p>
<p align="center"><font size="1">Version: $Id: faq.html,v 1.6
2003/03/30 13:54:28 moodler Exp $</font></p>