moodle/lang/es/docs/developer.html

<h2>Manual del Desarrollador</h2>

<p>Este documento describe un poco el dise<73>o de Moodle y

c<EFBFBD>mo puede contribuir usted.</p>

<h3>&Iacute;ndice</h3>

<ol>

  <li><a href="#architecture">Arquitectura de Moodle</a></li>

  <li><a href="#contribute">C<EFBFBD>mo contribuir</a>

    <ul>

      <li><a href="#activities">Las actividades para el aprendizaje</a></li>

      <li><a href="#themes">Temas</a></li>

      <li><a href="#languages">Idiomas</a></li>

      <li><a href="#database">Esquemas de Bases de datos</a></li>

      <li><a href="#courseformats">Formatos de cursos</a></li>

      <li><a href="#doc">Documentaci<EFBFBD>n y art<72>culos</a></li>

      <li><a href="#bugs">C<EFBFBD>mo participar en rastreo de fallos</a></li>

    </ul>

  </li>

</ol>

<p>&nbsp;</p>

<h3><a name="architecture"></a>1. Arquitectura de Moodle</h3>

<p>Desde la perspectiva de un administrador de sistemas, Moodle ha sido

dise<EFBFBD>ado de acuerdo con los siguientes criterios:</p>

<ol>

  <li><strong>Moodle debe poder ejecutarse en la m<>s amplia

posible variedad de plataformas</strong><br>

    <br>

La plataforma de aplicaciones Web que funciona en la mayor<6F>a de

las plataformas es PHP combinada con MySQL, y este es el entorno en el

que Moodle ha sido desarrollado (sobre Linux, Windows, y Mac OS X).

Moodle tambi<62>n usa la librer<65>a ADOdb para la

sustracci<EFBFBD>n de bases de datos, lo que significa que Moodle puede

usar <a href="http://php.weblogs.com/ADOdb_manual#drivers">m<EFBFBD>s

de diez marcas diferentes de bases de datos</a> (desafortunadamente, a

pesar de ello, no puede a<>n <em><strong>crear tablas</strong></em>

en todas esas bases de datos. Hablaremos m<>s sobre esto

m<EFBFBD>s adelante).<br>

    <br>

  </li>

  <li><strong>Moodle debe ser f<>cil de instalar, aprender y

modificar</strong><br>

    <br>

Los primeros prototipos de Moodle (1999) se construyeron usando <a

 href="http://www.zope.org/" target="_top">Zope</a>, un avanzado

servidor de aplicaciones Web orientado a objetos. Desafortunadamente me

pareci<EFBFBD> que aunque la tecnolog<6F>a era bastante buena,

ten<EFBFBD>a una curva de aprendizaje muy empinada y no era muy

flexible en t<>rminos de administraci<63>n del sistema. El

lenguaje PHP, por otro lado, es muy f<>cil de aprender

(especialmente si has hecho algo de programaci<63>n usando

cualquier otro lenguaje de script). Pronto tom<6F> la

decisi<EFBFBD>n de evitar usar un dise<73>o orientado a clases, con

la finalidad, una vez m<>s, de mantenerlo f<>cil de

entender para los principiantes. La reutilizaci<63>n del

c<EFBFBD>digo se archiva en librer<65>as con funciones claramente

tituladas y con una disposici<63>n de los archivos de script,

consistente. PHP es tambi<62>n f<>cil de instalar (existen

versiones ejecutables para todas las plataformas) y est<73>

ampliamente disponible pues la mayor<6F>a de los servidores de

alojamiento lo proporcionan como un est<73>ndar.<br>

    <br>

  </li>

  <li><strong>Debe ser f<>cil de actualizar desde una

versi<EFBFBD>n a la siguiente</strong><br>

    <br>

Moodle sabe qu<71> versi<73>n es (as<61> como las versiones

de todos los m<>dulos plug-in) y se ha construido un mecanismo

para que Moodle pueda actualizarse a s<> mismo de forma apropiada

a las nuevas versiones (por ejemplo, puede renombrar las tablas de las

bases de datos o a<>adir nuevos campos). Usando CVS en Unix, por

ejemplo, uno tan s<>lo tiene que hacer un "cvs update -d" y luego

visitar la p<>gina principal del sitio para completar la

actualizaci<EFBFBD>n.<br>

    <br>

  </li>

  <li><strong>Debe ser modular para permitir el crecimiento</strong><br>

    <br>

Moodle tiene una serie de caracter<65>sticas modulares, incluyendo

temas, actividades, interfaces de idioma, esquemas de base de datos y

formatos de cursos. Esto le permite a cualquiera a<>adir

caracter<EFBFBD>sticas al c<>digo b<>sico principal o

incluso distribuirlas por separado. Hablaremos m<>s de esto en la

siguiente secci<63>n.<br>

    <br>

  </li>

  <li><strong>Debe poder usarse junto con otros sistemas.</strong><br>

    <br>

Una de las cosas que hace Moodle es mantener todos los archivos para un

curso en un <20>nico directorio en el servidor. Esto podr<64>a

permitir que el administrador de un sistema proporcione similares

formas de acceso a un nivel de archivo para cada profesor, tal como

Appletalk, SMB, NFS, FTP, WebDAV y dem<65>s. Los m<>dulos de

autenticaci<EFBFBD>n le permiten a Moodle usar LDAP, IMAP, POP3, NNTP y

otras bases de datos como fuentes de informaci<63>n de los

usuarios. Por otra parte, a<>n queda trabajo por hacer sobre

esto. Para futuras versiones de Moodle tenemos planeadas las siguientes

caracter<EFBFBD>sticas: importaci<63>n y exportaci<63>n de los

datos de Moodle utilizando formatos basados en XML (incluyendo IMS y

SCORM), incrementar el uso de hojas de estilo para el formateo de

interfaces (de manera que puedan integrarse visualmente en otros sitios

Web).</li>

</ol>

<p>&nbsp;</p>

<h3><a name="contribute" id="contribute"></a>2. C<>mo puede

contribuir usted</h3>

<p>Tal como se ha mencionado m<>s arriba, Moodle tiene una serie

de caracter<65>sticas que son modulares. Incluso, aunque usted no

sea un programador, hay cosas que usted podr<64> cambiar o con las

que puede ayudar.</p>

<h4><a name="activities" id="activities"></a>Actividades de Aprendizaje</h4>

<div style="padding-left: 3em;">

<p>Estos son con mucho los m<>dulos m<>s importantes, y se

encuentran en el directorio "mod". Por defecto hay siete

m<EFBFBD>dulos: <em lang="en">assignment</em> (tareas), <em lang="en">choice</em>

(opci<63>n), <em lang="en">forum</em> (foro), <em lang="en">journal</em>

(diario), <em lang="en">quiz</em> (cuestionario), <em lang="en">resource</em>

(material), y <em lang="en">survey</em> (encuesta). Cada m<>dulo

est<EFBFBD> en un subdirectorio separado y consiste en los

siguientes elementos obligatorios (m<>s los scripts extra que son

<EFBFBD>nicos para cada m<>dulo):</p>

<ul>

  <li>mod.html: un formulario para establecer o actualizar una

instancia de este m<>dulo</li>

  <li>version.php: define alguna meta-informaci<63>n y proporciona

c<EFBFBD>digo de actualizaci<63>n</li>

  <li>icon.gif: un icono de 16x16 para el m<>dulo</li>

  <li>db/: dep<65>sitos SQL de todas las tablas y datos requeridos

de una base de datos (para cada tipo de base de datos)</li>

  <li>index.php: una p<>gina para presentar la lista de todas las

instancias en un curso</li>

  <li>view.php: una p<>gina para ver una instancia en particular</li>

  <li>lib.php: cualquiera/todas las funciones definidas para el

m<EFBFBD>dulo deben estar aqu<71>. Si el <em>modulename</em> se

llama "chisme", entonces las funciones requeridas incluyen:

    <ul>

      <li>chisme_add_instance() - c<>digo para a<>adir una

nueva instancia de chisme</li>

      <li>chisme_update_instance() - c<>digo para actualizar una

instancia existente</li>

      <li>chisme_delete_instance() - c<>digo para borrar una

instancia</li>

      <li>chisme_user_outline() - dada una instancia, devuelve un

resumen de una contribuci<63>n de un usuario</li>

      <li>widget_user_complete() - dada una instancia, imprime detalles

sobre la contribuci<63>n de un usuario<br>

      </li>

      <li>Para evitar posibles conflictos, cualquiera de las funciones

de un m<>dulo debe ser nombrada comenzando con chisme_ (el nombre

del m<>dulo m<>s un gui<75>n bajo) y cualquier

constante que usted defina debe comenzar con CHISME_ </li>

    </ul>

  </li>

  <li>Finalmente, cada m<>dulo tendr<64> algunos archivos de

idioma que contienen cadenas para ese m<>dulo. Lea m<>s

abajo.</li>

</ul>

<p>La forma m<>s f<>cil de comenzar un nuevo m<>dulo

de actividad es usar la plantilla que hay en <strong><a

 href="http://moodle.com/mod/newmodule_template.zip">mod/newmodule_template.zip</a>.</strong>

Descompr<EFBFBD>mala y siga las instrucciones que hay en el documento "<span

 lang="en">README</span>".</p>

<p>Quiz<EFBFBD>s tambi<62>n quiera antes enviar algo al <a

 href="http://moodle.com/mod/forum/view.php?id=44" target="_top">Foro

de m<>dulos de actividades sobre el uso de Moodle</a>.</p>

<p>&nbsp;</p>

</div>

<h4><a name="themes" id="themes"></a>Temas</h4>

<div style="padding-left: 3em;">

<p>Los temas (o pieles) definen la apariencia de un sitio. Con la

distribuci<EFBFBD>n b<>sica se proporciona una serie de temas

simples, pero usted puede querer crear su propio tema, con sus propios

colores, logo, estilos y gr<67>ficos.</p>

<p>Cada tema es un subdirectorio del directorio "theme", y contiene al

menos los siguientes archivos:</p>

<ul>

  <li><strong>config.php</strong>: define los colores del tema que se

usan en todo el sitio</li>

  <li><strong>styles.php</strong>: la hoja de estilos, contiene

definiciones de CSS para elementos HTML est<73>ndar as<61> como

para varios elementos de Moodle.</li>

  <li><strong>header.html</strong>: Incluido al principio de cada

p<EFBFBD>gina. Este es el que usted necesita editar para a<>adir

un logo al principio de las p<>ginas, por ejemplo.</li>

  <li><strong>footer.html</strong>: Incluido en el pie de cada

p<EFBFBD>gina.</li>

</ul>

<p>Para crear sus propios temas para la versi<73>n actual de Moodle:</p>

<ol>

  <li>Copie una de las carpetas existentes con un tema a una con un

nuevo nombre. Le recomiendo comenzar con uno de los temas

est<EFBFBD>ndar.</li>

  <li>Edite: config.php e inserte sus propios colores.</li>

  <li>Edite: styles.php y cambie su hoja de estilos.</li>

  <li>Edite: header.html y footer.html para a<>adir nuevos logos

o cambiar la disposici<63>n.</li>

</ol>

<p>Advierta que todos estos pasos son opcionales. Usted puede crear una

apariencia radicalmente distinta para su sitio simplemente editando los

colores que aparecen en el archivo config.php</p>

<p>Advierta tambi<62>n que las actualizaciones de Moodle <em>pueden</em>

interrumpir ligeramente los temas, as<61> que revise cuidadosamente

las notas de al versi<73>n si est<73> usando un tema

personalizado.</p>

<p>En particular, Moodle 2.0 tendr<64> un sistema de

presentaci<EFBFBD>n completamente nuevo, probablemente basado en XSL

transformando la salida de XML desde Moodle. Esto quiere decir que los

temas para esta versi<73>n tendr<64>n un formato completamente

diferente, pero la ventaja ser<65> que habr<62> un grado de

personalizaci<EFBFBD>n mucho m<>s alto (incluyendo mover

elementos en la p<>gina).</p>

<p>Encontrar<EFBFBD> m<>s discusi<73>n sobre esto en el <a

 href="http://moodle.com/mod/forum/view.php?id=46" target="_top">Foro

sobre temas en el uso de Moodle</a>. Si usted crea un bonito tema que

considera que otros podr<64>an querer usar, &iexcl;por favor,

env<EFBFBD>elo en un archivo comprimido al foro sobre temas!.<br>

</p>

</div>

<p>&nbsp;</p>

<h4><a name="languages" id="languages"></a>Idiomas</h4>

<div style="padding-left: 3em;">

<p>Moodle ha sido dise<73>ado para ser internacional. Cada "cadena"

o "p<>gina" de texto que se presenta como parte de la interfaz

surge de una serie de archivos de idioma. Cada idioma es un

subdirectorio del directorio "lang". La estructura del directorio

"lang" es la que sigue:</p>

<p><strong>lang/en</strong> - directorio que contiene todos los archivos

para un idioma (por ejemplo, en este caso, el ingl<67>s)</p>

<ul>

  <li>moodle.php - cadenas para la interfaz principal</li>

  <li>assignment.php - cadenas para el m<>dulo de tareas</li>

  <li>choice.php - cadenas para el m<>dulo opci<63>n</li>

  <li>forum.php - cadenas para el m<>dulo del foro</li>

  <li>journal.php - cadenas para el m<>dulo del diario</li>

  <li>quiz.php - cadenas para el m<>dulo del cuestionario</li>

  <li>resource.php - cadenas para el m<>dulo de recursos</li>

  <li>survey.php - cadenas para el m<>dulo de encuesta</li>

  <li>.... m<>s otros m<>dulos si los hay.<br>

    <br>

Se llama a las cadenas desde los archivos usando las funciones: <strong><em>get_string()</em></strong><em> </em>o<em> <strong>print_string()</strong></em>.

Cada cadena admite la sustituci<63>n de variables par ayudar a la

ordenaci<EFBFBD>n de variables en diferentes idiomas. Por ejemplo:<br>

    <br>

$strdueby = get_string("assignmentdueby", "assignment",      

userdate($date)); <br>

    <br>

Si en un determinado idioma no existe una cadena, entonces se

usar<EFBFBD> autom<6F>ticamente en su lugar el equivalente en

ingl<EFBFBD>s.</li>

</ul>

<p><strong>lang/en/help</strong> - contiene todas las p<>ginas de

ayuda (para las ayudas emergentes sensibles al contexto)</p>

<p>Las p<>ginas principales de ayuda est<73>n situadas

aqu<EFBFBD>, mientras que las p<>ginas espec<65>ficas de cada

m<EFBFBD>dulo est<73>n localizadas en subdirectorios con el nombre

del m<>dulo.</p>

<p>Con la funci<63>n <em>helpbutton</em>, usted puede insertar un

bot<EFBFBD>n de ayuda en una p<>gina.</p>

<p>Por ejemplo: helpbutton("text", "Haga clic aqu<71> para obtener

ayuda sobre el texto");</p>

<p>y para los m<>dulos:</p>

<p>helpbutton("forumtypes", "Forum types", "forum");</p>

<p>Tenga en cuenta que puede editar los idiomas en l<>nea<em

 lang="en"></em>, usando las herramientas web de administraci<63>n

bajo "Comprobar idioma". Esto hace que sea f<>cil no s<>lo

crear nuevos idiomas sino tambi<62>n refinar los existentes. Si va

a comenzar a crear un nuevo idioma por favor comun<75>quese

conmigo: <a href="http://dougiamas.com/" target="_top">Martin

Dougiamas</a>.</p>

<p>Tambi<EFBFBD>n querr<72> enviar un mensaje al <a

 href="http://moodle.com/mod/forum/view.php?id=43" target="_top">Foro

de idiomas sobre el uso de Moodle</a>. </p>

<p>Si usted est<73> haciendo el mantenimiento de un idioma de

manera continuada, yo puedo darle <a href="?file=cvs.html">acceso de

escritura al c<>digo fuente de Moodle en el CVS</a> de manera que

pueda hacer el mantenimiento directo en los archivos.</p>

<p>&nbsp;</p>

</div>

<h4><a name="database" id="database"></a>Esquemas de Bases de Datos</h4>

<div style="padding-left: 3em;">

<p>Dada una base de datos funcionando con tablas definidas, el

intencionalmente simple <abbr title="Structured Query Language">SQL</abbr>

usado en Moodle debe funcionar bien con una amplia variedad de marcas de

bases de datos.</p>

<p>Existe un problema con la <strong>creaci<EFBFBD>n autom<6F>tica</strong>

de nuevas tablas en una base de datos, que es lo que Moodle intenta

hacer tras la instalaci<63>n inicial. Debido a que cada base de

datos es muy diferente de las otras, a<>n no existe una manera de

hacer esto de manera independiente del tipo de plataforma. Para ayudar

a la automatizaci<63>n en cada base de datos, pueden crearse

esquemas que enumeren el SQL requerido para crear tablas en Moodle en

una base de datos determinada. Estos son los archivos que hay en <strong>lib/db</strong>

y dentro del subdirectorio <strong>db</strong> de cada m<>dulo.</p>

<p>Actualmente, s<>lo se soportan totalmente de esta manera,

MySQL y PostgreSQL. Si usted est<73> familiarizado con otra base de

datos (especialmente si se trata de una base de datos de c<>digo

abierto) y desea ayudar a trasladarla al esquema existente, por favor

p<EFBFBD>ngase en contacto conmigo (<a href="http://dougiamas.com/"

 target="_top">Martin     Dougiamas</a>).</p>

<p>&nbsp;</p>

</div>

<h4><a name="courseformats" id="courseformats"></a>Formatos de curso</h4>

<div style="padding-left: 3em;">

<p>Actualmente Moodle soporta tres formatos de curso diferentes:

semanal, por temas y social.</p>

<p>Estos est<73>n un poco m<>s conectados al resto del

c<EFBFBD>digo (y, por tanto, menos "<em lang="en">pluggable</em>") pero

sigue siendo bastante sencillo a<>adir nuevos m<>dulos.</p>

<p>Si usted tiene cualquier idea para formatos diferentes que necesite

o quiera ver integrados, p<>ngase en contacto conmigo y yo

har<EFBFBD> mi mayor esfuerzo para tenerlos disponibles en futuras

versiones.</p>

<p>&nbsp;</p>

</div>

<h4><a name="doc" id="doc"></a>Documentaci<EFBFBD>n y art<72>culos</h4>

<div style="padding-left: 3em;">

<p>Si a usted le apetece escribir un manual, un art<72>culo, un

documento acad<61>mico o cualquier otra cosa sobre Moodle, por

favor, &iexcl;h<EFBFBD>galo!</p>

<p>P<EFBFBD>ngalo en la Web y aseg<65>rese de poner enlaces a <a

 href="http://moodle.com/" target="_top">http://moodle.com/</a></p>

<p>&nbsp;</p>

</div>

<h4><a name="bugs" id="bugs"></a>Participar en el rastreo de fallos</h4>

<div style="padding-left: 3em;">

<p>Finalmente, me gustar<61>a invitarle a registrarse en la lista

de "rastreo de fallos" en <a href="http://bugs.moodle.org"

 target="_top">bugs.moodle.org</a> de manera que pueda enviar cualquier

fallo que encuentre y quiz<69>s participar en la discusi<73>n

sobre c<>mo arreglarlos.</p>

<p>"Fallos" no s<>lo incluye fallos de software de las versiones

actuales de Moodle, sino tambi<62>n nuevas ideas, solicitudes de

opciones e incluso cr<63>tica constructiva de las actuales

caracter<EFBFBD>sticas. La belleza del c<>digo abierto radica en

que cualquiera puede participar de alguna manera y ayudar a la

creaci<EFBFBD>n de un producto mejor para que todos disfrutemos de

<EFBFBD>l. &iexcl;En este proyecto sus ideas son muy bienvenidas!</p>

<p>&nbsp;</p>

</div>

<p style="text-align: center;">&iexcl;Gracias por usar Moodle!</p>

<p style="text-align: center;">Saludos,<br>

<a href="http://dougiamas.com/" target="_top">Martin Dougiamas</a></p>

<p>&nbsp;</p>

<p>&nbsp;</p>

<p>&nbsp;</p>

<p style="text-align: center; font-size: 0.7em;"><a href="."

 target="_top">Documentaci<63>n de Moodle</a></p>

<p style="text-align: center; font-size: 0.7em;">Versi<EFBFBD>n: $Id:

developer.html,v 1.2 2001/12/09   10:34:19 martin Exp $</p>