Tu Primer Tema Moodle en Colaboración con CodeLobster (Parte 2 de 2)

1284
CodeLobster IDE (Ambiente Integrado de Desarrollo)
Licensed under CC BY-ND

This Story in English.

WIRIS

Por Stanislav Ustimenko, CodeLobster.com
(Traducción: Cristian T. Duque)

Parte 1 aquí.

Hoy comenzarás el desarrollo de código de tu tema en Moodle

Vamos a darle un nombre. Haz clic derecho sobre el proyecto y crea una nueva carpeta (en el ejemplo, “codelobster“.)

Esta carpeta contendrá todos los archivos de nuestro nuevo tema.

Crea el archivo de tema más importante. Crea un archivo PHP desde el menú contextual de esta carpeta, seleccionando “New File > PHP“.

El nombre del archivo debe ser version.php. Incluye el siguiente código:

<?php
defined('MOODLE_INTERNAL') || die();
$plugin->version='2016102100';
$plugin->requires = '2016070700';
$plugin->component = 'theme_codelobster';

$plugin->dependencies = [

];

Aquí has definido la versión y el nombre del complemento (recuerda que un tema es un tipo de complemento). También iniciaste la lista de dependencias en las que te apoyarás, en caso de que luego quieras añadir nuevas funcionalidades.

De la misma manera, vamos a crear el archivo config.php con el siguiente código:

<?php
defined('MOODLE_INTERNAL') || die();
$THEME->name = 'codelobster';
$THEME->sheets = [];
$THEME->editor_sheets = [];
$THEME->parents = ['boost']; $THEME->enable_dock = false;
$THEME->yuicssmodules = array();

$THEME->rendererfactory = 'theme_overridden_renderer_factory';
$THEME->requiredblocks = '';
$THEME->addblockposition = BLOCK_ADDBLOCK_POSITION_FLATNAV;

En este código, has indicado el nombre del tema y la dependencia frente al tema “padre”, que es “Boost”.

El siguiente archivo es lib.php:

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

Por ahora, solo necesitas una línea de código. Más adelante podemos agregar aquí “callbacks“, que son maneras de invocar funciones existentes de Moodle, para expandir las características del tema.

Para mostrar correctamente en el selector de temas, agrega el título y la descripción del tema al archivo de idioma theme_codelobster.php. Colócalo en la carpeta correspondiente al idioma en lang/. Por ejemplo, si el administrador del sitio ha configurado Moodle en ruso, el archivo debe ser puesto en lang/ru.

Añade al archivo theme_codelobster.php el siguiente contenido:

<?php
defined('MOODLE_INTERNAL') || die();
$string['choosereadme'] = 'Este es el tema que yo he creado. Lo hice con CodeLobster IDE ';
$string['pluginname'] = 'Codelobster';
$string['region-side-pre'] = 'Right';

Sólo tenemos que dar un paso final. Crea la carpeta pix y pon los archivos de ícono (favicon.ico) y captura de pantalla (screenshot.jpg) en el mismo. No es necesario que tengas estos recursos (pero es muy recomendable). Si no los añades, tu tema utilizará los íconos por defecto del tema “Boost”.

Mira el panel izquierdo de la imagen de abajo. Como resultado, debes obtener la siguiente estructura del proyecto:

Ahora, para sincronizar archivos con un servidor remoto, haz clic con el botón derecho en la carpeta con el código de tema y selecciona cargar (Upload) en el menú contextual.

En el cuadro de diálogo que aparece, marca todos los archivos deseas sincronizar con el servidor.

En este caso, es la carpeta “CodeLobster“, sus subcarpetas y todos los archivos incluidos. Ahora dale “OK“.

Todos los archivos necesarios se han subido al respectivo directorio de temas en el servidor remoto. Ahora, todo lo que necesitas es instalar y habilitar el tema.

En tu sitio Moodle, actívalo en la pestaña de notificaciones en la página de administración del sitio.

Como podemos ver, el tema está listo y a la espera de ser instalado. Haz clic en “Actualizar base de datos Moodle ahora“.

El sistema nos dice que la instalación fue exitosa. Haz clic en “Continuar“.

Después de la instalación, activa el tema en el selector de la pestaña “Apariencia“. Haz clic en “Cambiar tema“.

Entre los temas instalados, puedes ver el tuyo. Lo único que te queda por hacer es seleccionar “Usar tema“.

Recibirás un mensaje indicando que el tema está habilitado. Ahora, en el selector de temas, vemos que el tema que has creado está activo.

Esto es sólo una pequeña muestra de cómo CodeLobster te ayuda a trabajar con Moodle de forma remota y colaborativa.