Módulos de actividades (desarrollador)
De MoodleDocs
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.
'
' '