Guía de apoyo para el uso de Moodle * actualizará la instancia cuya ID de corresponde con el atributo id de $nombremodulo * Todas las modificaciones que se quieran hacer a los datos del formulario * antes de introducirlos en la base de datos (por ejemplo, comprobación de valores) * deberán hacer aquí. * Funcionamiento análogo a nombremodulo_add_instance() * @param object $nombremodulo Un objeto definido en el formulario de mod.html * @return boolean True si la operación se lleva a cabo exitosamente **/ function nombremodulo_update_instance($nombremodulo) { ///Es necesario que el objeto a actualizar tenga un campo id $nombremodulo->id = $nombremodulo->instance; return update_record("nombremodulo", $nombremodulo); } /** * Dado un identificador de una instancia de este módulo, * esta función borrará todos los registros asociados con la misma, * así como todos los datos asociados a ella. * @param int $id Identificador de la instancia * @return boolean True si la operación se lleva a cabo exitosamente **/ function nombremodulo_delete_instance($id) { ///Obtenemos la instancia if (! $nombremodulo = get_record("nombremodulo", "id", "$id")) { return false; } $result = true; ///Borramos todos los registros necesarios, como mínimo el de la instancia if (! delete_records("nombremodulo", "id", "$nombremodulo->id")) { $result = false; } return $result; } /** * Dado un curso y un usuario, devuelve un objeto con información somera * respecto a las actividades que el usuario ha llevado a cabo con esta * instancia. * Esta función es usada para reportes de la actividad, su implementación * no es necesaria si no se desea mostrar reportes de actividad. * Ejemplo de retorno: * $return->time = El momento en el que sucedió el evento * $return->info = Un pequeño texto descriptivo * @param int $course Identificador del curso al que pertenece la instancia * @param int $user Identificador del usuario cuya información deseamos obtener * @param object $mod Objeto que contiene información sobre el módulo * @param object $nombremodulo Objeto que contiene información sobre la instancia * @return object Descrito más arriba. **/ function nombremodulo_user_outline($course, $user, $mod, $nombremodulo) { return $return; } /** * Dado un curso y un usuario, imprime información detallada * respecto a las actividades que el usuario ha llevado a cabo con esta instancia. * Esta función es usada para reportes de la actividad, su implementación * no es necesaria si no se desea mostrar reportes de actividad. * @param int $course Identificador del curso al que pertenece la instancia * @param int $user Identificador del usuario cuya información deseamos obtener * @param object $mod Objeto que contiene información sobre el módulo * @param object $nombremodulo Objeto que contiene información sobre la instancia * @return boolean True si ha habido alguna salida **/ function nombremodulo_user_complete($course, $user, $mod, $nombremodulo) { return true; } /** * Dados un curso y un tiempo, esta función buscará información * cercana temporalmente a ese instante y la imprimirá * Esta función puede no implementarse si no se considera oportuno * @uses $CFG * @param int $course Identificador del curso al que pertenece la instancia * @param boolean $isteacher True si la persona que desea ver la información es profesor * @param int $timestart Instante de tiempo de referencia * @return boolean True si ha habido alguna salida **/ function nombremodulo_print_recent_activity($course, $isteacher, $timestart) { global $CFG;
80
Ana Teresa González de Felipe | EUITIO - Universidad de Oviedo