Módulos de actividades (desarrollador)

Estos son con mucho los módulos más importantes, y se encuentran en el directorio "mod". Por defecto hay siete módulos: Tarea, Consulta, Foro, Glosario, Cuestionario, Recurso, y Encuesta. Cada módulo está en un subdirectorio separado y consiste en los siguientes elementos obligatorios (más los scripts extra que son únicos para cada módulo):

• mod_form.php: un formulario para establecer o actualizar una instancia de este módulo.
• version.php: define alguna meta-información y proporciona código de actualización
• icon.gif: un icono de 16x16 para el módulo
• db/install.xml: define la estructura de las tablas para todos los tipos de bases de datos. Se utiliza cuando se instala el módulo
• db/upgrade.php: define los cambios en la estructura de las tablas. Se utiliza cuando se actualiza el módulo
• db/access.php: define los permisos.
• index.php: una página para presentar la lista de todas las instancias en un curso
• view.php': una página para ver una instancia en particular
• 'lib.php: cualquiera/todas las funciones definidas para el módulo deben estar aquí. Si el módulo se llama "chisme", entonces las funciones requeridas incluyen:
  • chisme_add_instance() - código para añadir una nueva instancia de chisme
  • chisme_update_instance() - código para actualizar una instancia existente
  • chisme_delete_instance() - código para borrar una instancia
  • chisme_user_outline() - dada una instancia, devuelve un resumen de una contribución de un usuario
  • chisme_user_complete() - dada una instancia, imprime detalles sobre la contribución de un usuario
  • Otras funciones interesantes pero no obligatorias son:
    • chisme_delete_course() - para borrar todo lo que sea necesario tras borrar todas las instancias de un curso
    • chisme_process_options() - para pre-procesar la información de los ajustes de la instancia
• 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ón bajo) y cualquier constante que usted defina debe comenzar con CHISME_
• config.html - (opcional) un formulario para ajustar las preferencias globales del módulo
• Finalmente, cada módulo tendrá algunos archivos de idioma que contienen cadenas para ese módulo. Lea más abajo.

IMPORTANTE: Al crear un nuevo módulo, el nombre del mismo debe ser una palabra sencilla, en inglés, que no incluya números u otros caracteres especiales. También deberá asegurarse de que su módulo proporciona soporte para algunas características como grupos, metacursos y copias de seguridad y restauración.

Ver También

• La forma más fácil de comenzar un nuevo módulo de actividad es usar la plantilla que hay en http://download.moodle.org/download.php/plugins/mod/NEWMODULE.zip. Descomprímala y siga las instrucciones que hay en el documento "README".
• Ayuda sobre mod_form.php en https://docs.moodle.org/en/Development:lib/formslib.php_Form_Definition
• Foro de Desarrolladores del curso de Moodle en Español.

'

' '