Módulos de actividades (desarrollador)

Saltar a: navegación, buscar

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

'

' '