</head>
<body bgcolor="#FFFFFF">
<h1>Manual de Estilo del Código</h1>
-<p class="normaltext">Cualquier proyecto colaborativo necesita que que la consistencia
+<p class="normaltext">Cualquier proyecto colaborativo necesita que la consistencia
y la estabilidad sean fuertes.</p>
-<p class="normaltext">Esta manual de estilo ha sido escrito para conseguir que
- todo el código de Moodle cumpla estas características. Es cierto que la parte
- más antigua del código no cumple lo aquí especificado en algunos casos, pero
- esto será solucionado en breve. Todo el código nuevo definitivamente deberá
- adherirse a estos estándares de la forma más exacta posible.</p>
+<p class="normaltext">Este manual de estilo ha sido escrito para conseguir que
+ todo el código de Moodle cumpla estas características. Es cierto
+ que la parte más antigua del código no cumple lo aquí especificado
+ en algunos casos, pero esto será solucionado en breve. Todo el código
+ nuevo definitivamente deberá adherirse a estos estándares de la
+ forma más exacta posible.</p>
<h2>Reglas Generales</h2>
<ol class="normaltext">
<li class="spaced">Todos los archivos con código deberían utilizar la extensión
</li>
<li class="spaced">Todos los avisos de copyright deben ser mantenidos. Puedes
incluir los tuyos propios si resulta necesario.</li>
- <li class="spaced">Todos los archivos deben incluir el el archivo principal
- config.php.</li>
+ <li class="spaced">Todos los archivos deben incluir el archivo principal config.php.</li>
<li class="spaced">Cada archivo debería comprobar que el usuario está autenticado
correctamente, utilizando las funciones require_login() y
isadmin(),
isteacher(),
iscreator()
o isstudent().</li>
- <li class="spaced">Todos los accesos a la base de datos deberían utilizar las
- funciones de finidas en
- lib/datalib.php cuando sea posible
- -
- esto permite la compatibilidad con un gran número de bases de datos.
-
- Deberías encontrar que prácticamente todo es posible utilizando estas funciones.
- Si quieres esribir código SQL entonces deberás comprobar que: funciona en
- cualquir plataforma; restringido a funciones específicas de tu código (normalmente
- un archivo lib.php); y claramente comentado.</li>
+ <li class="spaced">Todos los accesos a la base de datos deberían utilizar
+ las funciones definidas en lib/datalib.php cuando sea posible - esto permite
+ la compatibilidad con un gran número de bases de datos. Deberías
+ encontrar que prácticamente todo es posible utilizando estas funciones.
+ Si quieres escribir código SQL entonces deberás comprobar que:
+ funciona en cualquier plataforma; restringido a funciones específicas
+ de tu código (normalmente un archivo lib.php); y claramente comentado.</li>
<li class="spaced">No crees o utilices variables globales distintas de las
estándar $CFG, $SESSION, $THEME y $USER.</li>
<li class="spaced">Todas las variables deberían ser inicializadas o, al menos,
<li class="spaced">Todos los archivos de ayuda deberían ser traducibles - crea
nuevos textos en el directorio "es/help" y llámalos utilizando
la función helpbutton().</li>
- <li class="spaced">La información que llaga desde el navegador (enviada con
- los métodos GET o POST) automáticamente tiene las "magic_quotes" aplicadas
- (sin importar la configuración de PHP) por lo que uedes insertarla contotal
- seguridad en la base de datos. El resto de la información(obtenida desde
- los archivos, o desde la base de datos)
- debe ser escapada con la función <font color="#339900">addslashes()</font> antes
- de insertarla en la base de datos.</li>
+ <li class="spaced">La información que llega desde el navegador (enviada
+ con los métodos GET o POST) automáticamente tiene las "magic_quotes"
+ aplicadas (sin importar la configuración de PHP) por lo que puedes
+ insertarla con total seguridad en la base de datos. El resto de la información(obtenida
+ desde los archivos, o desde la base de datos) debe ser escapada con la función
+ <font color="#339900">addslashes()</font> antes de insertarla en la base de
+ datos.</li>
</ol>
<p> </p>
<h2>Estilo del Código</h2>
-<p class="normaltext">Comprendo que puede ser un poco frustrante modificar tu
- estilo de programación si has trabajado en otras coasa, pero compara esa frustración
- con la frustración de toda la gente que intente, más adelante, encontrar el
- sentido del código de Moodle si es una mezcla de estilos. Obviamente, hay muchos
- puntos a favor y en contra de cada estilo que la gente utiliza, pero el que
- se detalla aquí es el que deberás utilizar.</p>
+<p class="normaltext">Comprendo que puede ser un poco frustrante modificar tu
+ estilo de programación si has trabajado en otras cosas, pero compara
+ esa frustración con la frustración de toda la gente que intente,
+ más adelante, encontrar el sentido del código de Moodle si es
+ una mezcla de estilos. Obviamente, hay muchos puntos a favor y en contra de
+ cada estilo que la gente utiliza, pero el que se detalla aquí es el que
+ deberás utilizar.</p>
<ol class="normaltext">
<li class="spaced"><strong>El sangrado</strong> del texto debe ser siempre
de 4 espacios. No utilices los tabuladosres NUNCA.</li>
<p class="examplecode"><font color="#006600">define("FORUM_MODE_FLATOLDEST",
1);</font></p>
</li>
- <li class="spaced"><strong>Los nombres de las funciones</strong> tienen que
- ser palabras sencillas en minúsculas y en Inglés, y empezar con el nombre
- del módulo al que pertenecen para evitar conflictos entre módulos. Las palabras
- deberían separarse por guiones bajos. Los parámentros, si es posible, tendrán
- valores por defecto. Fíjate en que no has espacio entre el nombre de la función
+ <li class="spaced"><strong>Los nombres de las funciones</strong> tienen que
+ ser palabras sencillas en minúsculas y en Inglés, y empezar
+ con el nombre del módulo al que pertenecen para evitar conflictos entre
+ módulos. Las palabras deberían separarse por guiones bajos.
+ Los parámentros, si es posible, tendrán valores por defecto.
+ Fíjate en que no haya espacio entre el nombre de la función
y lo siguiente (paréntesis).<br>
<p class="examplecode"> <font color="#007700">function </font><font color="#0000BB">forum_set_display_mode</font><font color="#007700">(</font><font color="#0000BB">$mode</font><font color="#007700">=</font><font color="#0000BB">0</font><font color="#007700">)
{<br />
}<br />
}</font></p>
</li>
- <li class="spaced"><strong>Los bloques de código</strong> siempre deben
- estar encerrados por llaves(incluso si solo constan de una línea). Moodle
- utiliza este estilo:
+ <li class="spaced"><strong>Los bloques de código</strong> siempre deben
+ estar encerrados por llaves (incluso si solo constan de una línea).
+ Moodle utiliza este estilo:
<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">>
<li><strong>name</strong> - el nombre completo de la instancia</li>
</ul>
</li>
- <li class="spaced">El resto de las tablas asociadas con un módulo que contiene
- información sobre 'cosas', deberían ser llamandas <strong>modulo_cosas</strong>(fíjate
- en el plural!).</li>
+ <li class="spaced">El resto de las tablas asociadas con un módulo que
+ contiene información sobre 'cosas', deberían ser llamandas <strong>modulo_cosas
+ </strong>(fíjate en el plural!).</li>
<li class="spaced">Los nombres de los campos (columnas) deberían ser sencillos
y cortos, siguiendo las mismas reglas que los nombres de las variables.</li>
<li class="spaced">Cuando sea posible, las columnas que contengan una referencia
<head>
-
-<title>Moodle Docs: Current Release notes</title>
-
+
+<title>Moodle Docs: notas sobre la versión actual</title>
+
<link rel="stylesheet" href="docstyles.css" type="TEXT/CSS">
-
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
-
+
<style type="text/css">
<!-- dt {font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif; font-weight: bold;}
- dd {margin-bottom:1em;}
+ dd {margin-bottom:1em;}
-->
</style>
</head>
<ul>
<dl>
<dt>Problemas resueltos:</dt>
- <dd>
+ <dd>
<ul>
- <li>Algunos códigos HTML que afectaban a la estabilidad del edito
+ <li>Algunos códigos HTML que afectaban a la estabilidad del editor
HTML bajo IE6 en algunas páginas han sido solucionados.</li>
<li>Algunos problemas en las opciones de auto-vínculo en los filtros
arreglados.</li>
- <li>Modificada la barra de navegación (utilzando el carácter »).</li>
+ <li>Modificada la barra de navegación (utilizando el carácter »).</li>
<li>Los archivos de Flash ahora tienen su propio icono.</li>
- <li>La inclusión de enlaces al curso en el editor HTML has sido
+ <li>La inclusión de enlaces al curso en el editor HTML ha sido
corregida.</li>
<li>El bloque de enlaces a las secciones ahora mantiene el "focus".</li>
- <li>Los archivos del sitio ahora respetan al configuración "forcelogin".</li>
+ <li>Los archivos del sitio ahora respetan la configuración "forcelogin".</li>
<li>La actualización de bloques sin base de datos funciona.</li>
<li>Actualizaciones en los lenguajes.</li>
</ul>
<ul>
<dl>
<dt>Principales nuevas características:</dt>
- <dd>
+ <dd>
<ul>
<li>Nueva utilidad de <strong>Calendario</strong> (gracias a
Jon Papaioannou y la <a target="_blank" href="http://www.sch.gr/">Greek
School Network</a>!).</li>
- <li>Nueva utilidad de <strong>Bloques</strong>, permitiendo quelos bloques
+ <li>Nueva utilidad de <strong>Bloques</strong>, permitiendo que los bloques
sean incluidos y movidos por la página del curso (gracias a
Jon Papaioannou, Eloy Lafuente y otros!).</li>
<li>Nuevo sistma de difusión <strong>RSS </strong> permite a los
- Foros y alos Glosarios (y más adelante, a otros módulos)
+ Foros y a los Glosarios (y más adelante, a otros módulos)
publicar vía RSS (Gracias,
Eloy!).</li>
<li><strong>El filtro multimedia</strong> ahora soporta la inclusión
</ul>
</dd>
<dt>Otras nuevas características:</dt>
- <dd>
+ <dd>
<ul>
- <li>Un nuevo tipo de recuros (llamado "Directorio") mostrará un
+ <li>Un nuevo tipo de recursos (llamado "Directorio") mostrará un
directorio entero de ficheros (incluyendo subdirectorios).</li>
<li>Los recuros que son archivos (subidos o páginas web) ahora muestran
un icono distintivo en la página principal del curso.</li>
<li>Cuando el acceso de Google está activado, la página de traducción
de Google funciona también.</li>
<li>Las sesiones son ahora almacenadas de forma privada en el directorio
- de datos de Moodle - esto hace que Moodle funciona mejor en clusters
+ de datos de Moodle - esto hace que Moodle funcione mejor en clusters
y soluciona algunos problemas de expiración de sesiones en servidores
web compartidos.</li>
<li>Las imágenes de los usuarios puedens ser borradas fácilmente desde
<li>Añadido mejor soporte para la importación de cuestionarios desde
Blackboard.</li>
<li>El guión cron de PHP ahora puede ser ejecutado como un binario.</li>
- <li>El editor HTML ha sido mejorado enórmemente.</li>
+ <li>El editor HTML ha sido mejorado enormemente.</li>
<li>La página por defecto de actividad reciente es ahora calculada desde
el último acceso al curso (o dos días, lo que sea más reciente). Anteriormente
era calculada desde la última conexión al sitio.</li>
</ul>
</dd>
<dt>Problemas resueltos:</dt>
- <dd>
+ <dd>
<ul>
<li>Cientos de pequeños fallos han sido solucionados en todas partes,
generalmente mejorando la apariencia y la robustez de Moodle.</li>
<ul>
<dl>
<dt>Varios problemas menores resueltos:</dt>
- <dd>
+ <dd>
<ul>
<li>Corregidos algunos problemas que causaban que los gráficos de las
encuestas no se mostraran en algunas circustancias.</li>
<ul>
<dl>
<dt>Principales nuevas características:</dt>
- <dd>
+ <dd>
<ul>
<li>Nuevo soporte para grupos en los cursos (con muchas opciones).</li>
<li><strong>Filtros de texto</strong> que permiten procesar los textos
</ul>
</dd>
<dt>Cursos:</dt>
- <dd>
+ <dd>
<ul>
<li>Las actividades pueden tener sangrias en la visualización del curso,
permitiendo estructurarlas mejor.</li>
</ul>
</dd>
<dt>Administración del sitio:</dt>
- <dd>
+ <dd>
<ul>
<li>Solucionado un importante problema de seguridad para evitar que los
profesores accedan a Moodle como profesores si los administradores
</ul>
</dd>
<dt>Themes:</dt>
- <dd>
+ <dd>
<ul>
<li>Solución de problemas para que Internet Explorer utilice la hoja
de estilos de una manera más robusta.</li>
</ul>
</dd>
<dt>Traducciones:</dt>
- <dd>
+ <dd>
<ul>
<li>Nuevos lenguajes: Gallego y Lituano.</li>
<li>Mejorado el interfaz de edición de lenguajes - ahora permite elegir
</ul>
</dd>
<dt>Copia de Seguridad / Restauración:</dt>
- <dd>
+ <dd>
<ul>
<li>Las copias de seguridad automáticas pueden ser programadas por el
administrador para todos los cursos a la vez.</li>
</ul>
</dd>
<dt>Filtros de texto y formateo:</dt>
- <dd>
+ <dd>
<ul>
<li>Avido: Los nuevos filtros de texto incrementarán la carga de tu servidor,
particularmente cuando se trata de filtros complicados. Utilízalos
</ul>
</dd>
<dt> API del desarrollador:</dt>
- <dd>
+ <dd>
<ul>
<li>Una nueva guía del código está disponible.</li>
<li>Una nueva guía de filosofía está disponible ;-)</li>
</ul>
</dd>
<dt>Chats</dt>
- <dd>
+ <dd>
<ul>
<li>Las sesiones del chat pueden ser borradas.</li>
<li>Los chats programados muestran la franja horaria para ser más claros.</li>
</ul>
</dd>
<dt>Foros:</dt>
- <dd>
+ <dd>
<ul>
<li>Las preferencias de visualización de los foros son recordadas entre
sesiones.</li>
</ul>
</dd>
<dt>Diarios:</dt>
- <dd>
+ <dd>
<ul>
<li>Las preguntas del diario pueden utilizar ahora el editor HTML.</li>
<li>Solucionados algunos problemas con la valoración de los diarios.</li>
</ul>
</dd>
<dt>Cuestionarios:</dt>
- <dd>
+ <dd>
<ul>
<li>Las preguntas y las categorías pueden ser editadas sin necesidad
de editar un cuestionario.</li>
</ul>
</dd>
<dt>Recursos:</dt>
- <dd>
+ <dd>
<ul>
<li>Los profesores pueden visualizar los ficheros de forma más directa
al crear recursos de archivo subido.</li>
</ul>
</dd>
<dt>Talleres:</dt>
- <dd>
+ <dd>
<ul>
<li>Cambios en el sitema de valoración cruzada.</li>
<li>Nueva fase de valoración.</li>
</ul>
</dd>
<dt>Miscellaneous</dt>
- <dd>
+ <dd>
<ul>
<li>Moodle ignora cualquier carpeta que Frontpage haya podido añadir
(_vti_cnf).</li>
</center>
<p> </p>
<p align="CENTER"><font size="1"><a href="../doc/" target="_top">Documentación
- de
+ de
Moodle</a></font></p>
<p align="CENTER"><font size="1">Version: $Id$</font></p>
projects / moodle.git / commitdiff