Cómo crear un plugin básico de actividad en Moodle (paso a paso)

Crear tu propio plugin en Moodle puede sonar complicado al principio, pero con este tutorial te mostraré cómo desarrollar un plugin básico de tipo “actividad” para que puedas entender la estructura y empezar a construir tus propias funcionalidades.

 ¿Qué vamos a crear?

Un plugin de actividad llamado Mi Módulo, que aparecerá en el listado de actividades cuando edites un curso y te permitirá crear nuevas instancias con un solo campo: nombre.

 Estructura del plugin

Primero, crea una carpeta en:

moodle/mod/mimodulo

Dentro de esa carpeta, necesitas tener al menos estos archivos:

mimodulo/
├── db/
│   └── install.xml
         acces.php
├── lang/
│   └── en/
│       └── mimodulo.php
├── lib.php
├── mod_form.php
├── version.php
├── view.php

 1. version.php

Archivo obligatorio que define la versión del plugin.

<?php
defined('MOODLE_INTERNAL') || die();

$plugin->component = 'mod_mimodulo';
$plugin->version = 2025042500;
$plugin->requires = 2022041900;
$plugin->maturity = MATURITY_STABLE;
$plugin->release = 'v1.0';

 2. install.xml (estructura de base de datos)

Ubicado en db/install.xml. Define la tabla del plugin.

<?xml version="1.0" encoding="UTF-8" ?>
<XMLDB PATH="mod/mimodulo/db" VERSION="2025042500"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:noNamespaceSchemaLocation="../../lib/xmldb/xmldb.xsd">

    <TABLES>
        <TABLE NAME="mimodulo" COMMENT="Tabla del módulo mimodulo">
            <FIELDS>
                <FIELD NAME="id" TYPE="int" LENGTH="10" NOTNULL="true" SEQUENCE="true"/>
                <FIELD NAME="name" TYPE="char" LENGTH="255" NOTNULL="true"/>
                <FIELD NAME="timecreated" TYPE="int" LENGTH="10" NOTNULL="true"/>
                <FIELD NAME="timemodified" TYPE="int" LENGTH="10" NOTNULL="false"/>
            </FIELDS>
            <KEYS>
                <KEY NAME="primary" TYPE="primary" FIELDS="id"/>
            </KEYS>
        </TABLE>
    </TABLES>
</XMLDB>
2.5 access.php
<?php
defined('MOODLE_INTERNAL') || die();

$capabilities = [
    'mod/mimodulo:addinstance' => [
        'captype' => 'write',
        'contextlevel' => CONTEXT_COURSE,
        'archetypes' => ['editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW],
    ],
];

3. lang/en/mimodulo.php

Define los textos visibles.

<?php
$string['pluginname'] = 'Mi Módulo';
$string['modulename'] = 'Mi Módulo';
$string['modulenameplural'] = 'Mis Módulos';
$string['mimodulo:addinstance'] = 'Agregar una nueva instancia de Mi Módulo';
$string['name'] = 'Nombre del módulo';

 4. mod_form.php

Formulario que se muestra al crear o editar la actividad.

<?php

require_once($CFG->dirroot . '/course/moodleform_mod.php');

class mod_mimodulo_mod_form extends moodleform_mod {

    function definition() {
        $mform = $this->_form;

        $mform->addElement('text', 'name', get_string('name', 'mimodulo'), ['size' => '64']);
        $mform->setType('name', PARAM_TEXT);
        $mform->addRule('name', null, 'required', null, 'client');

        $this->standard_coursemodule_elements();
        $this->add_action_buttons();
    }
}

5. lib.php

Contiene funciones principales del módulo.

<?php

function mimodulo_add_instance($data, $mform) {
    global $DB;
    $data->timecreated = time();
    return $DB->insert_record('mimodulo', $data);
}

function mimodulo_update_instance($data, $mform) {
    global $DB;
    $data->timemodified = time();
    $data->id = $data->instance;
    return $DB->update_record('mimodulo', $data);
}

function mimodulo_delete_instance($id) {
    global $DB;
    return $DB->delete_records('mimodulo', ['id' => $id]);
}

 6. view.php

Lo que el estudiante verá al ingresar a la actividad.

<?php

require_once('../../config.php');

$id = required_param('id', PARAM_INT);
$cm = get_coursemodule_from_id('mimodulo', $id, 0, false, MUST_EXIST);
$context = context_module::instance($cm->id);

require_login($cm->course, true, $cm);
$PAGE->set_url('/mod/mimodulo/view.php', ['id' => $id]);
$PAGE->set_context($context);
$PAGE->set_title('Mi Módulo');
$PAGE->set_heading('Mi Módulo');

echo $OUTPUT->header();
echo $OUTPUT->heading('Hola, este es tu nuevo módulo en Moodle 🚀');
echo $OUTPUT->footer();

 Instalación del plugin

1. Copia la carpeta mimodulo en moodle/mod/.

2. Ve a tu Moodle como administrador.

3. Moodle detectará automáticamente el nuevo plugin.

4. Sigue el asistente de instalación.

5. ¡Listo! Ya puedes usar tu módulo en cualquier curso.

 Prueba tu plugin

1. Entra a un curso como administrador o profesor.

2. Activa edición.

3. Haz clic en “Agregar una actividad o recurso”.

4. Verás "Mi Módulo" en la lista.

5. Agrega una instancia y prueba su vista.

Este tutorial te brinda una base sólida para crear tu propio plugin de tipo actividad en Moodle  con php. A partir de aquí, puedes expandir la funcionalidad, agregar configuraciones, vistas personalizadas, lógica de calificación y mucho más.

Si te gustó este artículo y te fue útil, ¡compártelo!.

Este tutorial fue creado pensando en los desarrolladores que usan Moodle en Colombia, especialmente en Manizales, donde la tecnología educativa sigue creciendo y conectando comunidades de aprendizaje, el objetivo es de aprendizaje para que puedan aprender a crear un plugin y a partir de esto desarrollar el que requieran a medida.

Comandos de Laravel: Guía esencial para desarrolladores

Comandos útiles en Laravel

1. Instalación de Laravel

Para instalar Laravel en tu sistema, usa Composer:

composer create-project --prefer-dist laravel/laravel nombre-del-proyecto

Para iniciar el servidor de desarrollo:

php artisan serve

Esto ejecuta Laravel en http://127.0.0.1:8000.

2. Comandos esenciales de Artisan

Artisan es la herramienta de línea de comandos de Laravel. Puedes ver todos los comandos disponibles con:

php artisan list

Para limpiar cachés y mejorar el rendimiento:

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

Si necesitas generar una clave de aplicación:

php artisan key:generate

3. Migraciones y base de datos

Si trabajas con bases de datos, estos comandos te ayudarán:

Crear una migración:

php artisan make:migration nombre_de_la_migracion

Ejecutar las migraciones:

php artisan migrate

Revertir migraciones:

php artisan migrate:rollback

4. Modelos y controladores

Para crear un modelo con su respectiva migración:

php artisan make:model NombreModelo -m

Para generar un controlador:

php artisan make:controller NombreControlador

Si el controlador es de tipo recurso:

php artisan make:controller NombreControlador --resource

5. Seeders y Factories

Para poblar la base de datos con datos de prueba:

php artisan db:seed

Si necesitas generar un nuevo seeder:

php artisan make:seeder NombreSeeder

Para crear una factory:

php artisan make:factory NombreFactory --model=NombreModelo

6. Rutas y middleware

Para listar todas las rutas de la aplicación:

php artisan route:list

Para crear un middleware:

php artisan make:middleware NombreMiddleware

7. Comandos para colas y tareas programadas

Si usas colas en Laravel, puedes ejecutar lo siguiente:

php artisan queue:work

Para programar tareas automáticas:

php artisan schedule:run

8. Pruebas y depuración

Ejecutar pruebas con PHPUnit:

php artisan test

Crear una nueva prueba:

php artisan make:test NombreTest

Flujo de trabajo en Framework Laravel o Symfony

Flujo normal de trabajo para desarrollar un programa:

1. El usuario realiza una solicitud.

2. En el framework se activa la ruta que apunta a un método del controller.

3. El controller está listo para dar una respuesta.

4. La repsuesta puede ser una vista, dato, documento, etc.

Cómo iniciar composer usando PHPUnit para test de códigos en PHP

 Iniciar proyecto composer con PHPUnit

EN WINDOWS:

composer require --dev phpunit/phpunit

rellenar el composer.json

crear un archivo, a nivel del vendor, phpunit.xml

llenar el phpunit.xml

crear la carpeta test a nivel del vendor

en consola escribir: php vendor/phpunit/phpunit/phpunit

y debe salir “No tests executed”

Si no funciona: composer dump

Convertir el formato de fecha en php con mysqli, mediante consultas seguras para evitar inyeccion SQL

Hay casos en los que necesitamos enviar a una consulta sql un formato de fecha en español, por ejemplo el formato de (Abril 11 2020) y para esto debemos hacer lo siguiente:

$query =mysqli_query($conn,"SET lc_time_names = 'es_ES';"); 

$query = $conn->prepare('SELECT id,DATE_FORMAT(fecha,"%M %d %Y"),,texto FROM tabla WHERE id = ? ');

Hay que tener en cuenta que estas consultas son  las que deberíamos ahcer en nuestros desarrollos para evitar inyección sql.

Enlace relacionado

Cómo obtener la fecha en español, con el formato nombre del mes dia y año

Cómo borrar un archivo subido en base de datos

Para eliminar un archivo cargado en un servidor debemos ingresar el siguiente código en nuestro programa:

  // Procedemos a borrar
     if (!unlink('uploads/'.$archivo)) {
          // impirmimos error al borrar
          echo 'Error al borrar';
     } else {
          // Archivo borrado
          echo 'Archivo borrado';
     }
 

Cómo enviar una variable eliminando los últimos caracteres

En php es normal que necesitemos imprimir un valor de una cadena eliminando caracteres de un valor que no queramos mostrar y para esto debemos hacer lo siguiente:

<?php
   $rest = substr("camisa", 0, -1);  // devuelve "camis"
   $rest = substr("camisa", 2, -1);  // devuelve "mis"
   $rest = substr("camisa", 4, -4);  // devuelve false
   $rest = substr("camisa", -3, -1); // devuelve "is"
?>

Código basado en https://www.php.net/manual/es/function.substr.php

Cómo crear un árbol de navegación para tu sitio web

Para realizar un árbol de navegación hay que realizar lo siguiente:


Creamos un programa php en donde crearemos uba variable, la cual vamos a imprimir
 para obtener de la base de datos la ruta de navegación. Por ejemplo Inicio/quienes somos


  <?php

        $s=$_SERVER['SCRIPT_NAME'];
         print('<p><a href="index.php">Inicio</a>'.$s.'</p>');

?>

Como proteger tu web de SQL injection con Mysqli

Para mejorar la seguridad de tu sitio web, es recomendable tener prioridad en revisar las consultas sql, las cuales son vunerables en el momento de crear una web y eslo lo podemos hacer por PDO o por Mysqli, dependiendo de cual versión usamos en PHP. Lo más recomendable es dejar de usar Mysql ya que está en este momento obsoleto y ya no es tan seguro. Es necesario migrar a Mysqli.  A continuación podemos ver un ejemplo para que puedan ejecutar en localhost:

<?php
try {
    $conn = new mysqli('localhost', 'root', '','bd');

    echo "Connected successfully";
    }
catch(PDOException $e)
    {
    echo "Connection failed: " . $e->getMessage();
    }
    //MySQLi,
  class Usuario {
  public $id;
  public $fecha;
  public $titulo;

  public function info(){
//devolvemos resultados de estos campos de la tabla
    return '#' . $this->id . ': ' . $this->fecha . ' ' . $this->titulo;
  }
}
    $query = "SELECT * FROM tabla";
if ($result = $con->query($query)) {
  while ($user = $result->fetch_object('Usuario')) {
    echo $user->info() . "\n";
  }
}
// mysqli,
$query = $con->prepare('SELECT * FROM tabla WHERE id = ?');
$query->bind_param('s', $_GET['id']);
$query->execute();
 $result = $query->get_result();
    while ($row = $result->fetch_assoc()){
       //aquí se imprime los resultados de los campos seleccionados
    }
?>

Recomiendo visitar el artículo https://cursos.mejorcodigo.net/article/pdo-vs-mysqli-cuales-son-las-diferencias-37 en donde se aprendió a realizar este tipo de código para mejorar la seguridad en nuestras páginas web.

Enlace Relacionado

Importancia del .htaccess en una Página web

Cómo enviar por SQL un texto y conservar los saltos de línea

Dentro del código php  ponemos nl2br, el cual es un salto de línea para poder tomar los textos que enviamos por un formulario con los espacios que tiene este contenido. Para lograrlo hacemos lo siguiente:

 $texto=nl2br($_POST['texto']);  

Esto antes de hacer el insert en la base de datos SQL con la información que llenamos en el formulario del programa que hace el envío a este.

Recomiendo ver el manual https://www.php.net/manual/es/function.nl2br.php para ver más ejemplos del tema.

Enlaces recomendados

Cómo imprimir los primeros caracteres de una cadena en Php

Autoincremento en Mysql para empezar a contar desde 1

Cómo usar PHP para desarrollar una web o software en Manizales,Colombia

Cómo imprimir los primeros caracteres de una cadena en Php

Creamos una función conocida como subst de 0 al número que deseamos poner límite.

$string= substr($string, 0, 100);

Luego de crear la función la ejecutamos para verificar que funciona correctamente imprimiendo un texto en el programa. 

echo $string

Recomiendo ingresar a Cómo usar PHP para desarrollar una web o software para conocer más sobre este lenguaje de programación.

Cómo usar PHP para desarrollar una web o software

Qué es Php?

El Procesador de Hipertexto es uno de los Lenguajes de código abierto más populares para programar, el cual puede ser incrustado en HTML. Es muy usado en páginas web en Manizales, Colombia y en todo el mundo.

Qué herramienta usar para programar en PHP?

Recomiendo utilizar Sublime text, o notepad++; estos dos son programas que se pueden descargar gratis en internet y muy útiles para programar fácilmente.

Qué programa descargar para gestionar las bases de datos?

Para realizar programas en el equipo y ejecutarlos en éste es necesario un SGBD (Sistema de Gestión de Base de Datos) y recomiendo usar Xampp o Wamp.


Luego de tener instalado el Software para programar y el SGBD podemos seguir con las pruebas reales en nuestro equipo.

Crea tu Primer programa en PHP

<html>
   <head>
     <title> Hola mundo</title>
   </head>
        <body>
            <?php  echo '<p>hola mundo</p> ' ; ?>
         </body>
</html>

Cómo obtener la información del sistema usando PHP

<? php info(); ?>

Imprimir una Variable en PHP

  <?php
 echo $_SERVER ['HTTP_USER_AGENT'];
  ?>

Como resultado tendremos algo así:

Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)

Otro ejemplo de variables en PHP

<?php
$author ="Julian Alzate";
 echo $author;
?>

Como resultado obtendremos:

Julian Alzate

Cómo sumar dos variables:

<?php
$n1= 3;
$n2= 4;
$resultado= $n1+ $n2;
echo "El resultado es:" . $resultado;
?>

Como resultado tendremos:

El resultado es: 7

Estructura de una conexión en BD usando PHP

<?php
$consultasql="SELECT * FROM tablaPrueba";
$mysql=mysql_connect("localhost","root","") or die("No pudo conectarse a $servidor!!!!" . mysql_error());
mysql_select_db("prueba") or die("No pudo seleccionarse la BD $bd.");
$resultado=mysql_query($consultasql);

/* aquí va el código */

mysql_free_result($resultado);
mysql_close ($mysql);
?>



Si desea conocer más sobre cómo programar en PHP ingresa a  Desarrolladores PHP en Colombia