Desarrollo de módulos para Drupal

Desarrollo de Módulos Drupal
(con examples.module)

Alessandro Mascherpa (@ALMADEWEB)

alessandro@almadeweb.es
Asiciación Española de Drupal

alessandro@almadeweb.es – Asociación Española de Drupal 1 /29

Personal

http://asociaciondrupal.es/
• Desarrollador web freelance.
• Administrador del grupo de usuarios de Drupal
de Castellón, #DrupalCS:
http://groups.drupal.org/castellon

• Consideraciones previas
• Arquitectura Drupal
• Drupal como sistema de Hooks y su manera
de entender la "Inversión de Control"
• La documentación del desarrollador Drupal
• La API de Drupal
• Crear módulos a partir de "Examples
module"
• Referencias

Consideraciones previas
• Entorno de desarrollo
– Apache (u otro http_server)
– MySQL (u otro sist. de gestión de bases de datos)
– PHP (o PHP)
– IDE o editor para hacer código (según gustos):
• http://drupal.cocomore.com/blog/using-eclipse-pdt-drupal-deve
– Instalación de Drupal


Consideraciones extras
• Entorno de desarrollo II
– Módulos auxiliares: coder, devel, devel_themer...
– Drush: http://drupal.org/project/drush
– GIT: http://drupal.org/node/711070
• Coding standards Drupal
– http://drupal.org/coding-standards
• Conocer la comunidad Drupal y el workflow de
desarrollo (issue queues,etc.)... Comprobar
que lo que vayas a hacer no esté ya hecho

Hooks: Inversión de control... Drupal-way
El flujo habitual se da cuando es el código del usuario quien invoca a
un procedimiento de una biblioteca. La inversión de control sucede
cuando es la biblioteca la que invoca el código del usuario.

Wikipedia

http://martinfowler.com/bliki/InversionOfControl.html
http://es.wikipedia.org/wiki/Inversi%C3%B3n_de_control

• Drupal lo implementa mediate los patrones de
diseño Observer y Visitor
http://drupalwatchdog.com/1/1/design-patterns-of-drupal


Arquitectura

http://lin-clark.com/sites/default/files/sequence-diagram_get-field-types.png

Documentación
• Crear módulos para Drupal 7:
http://drupal.org/node/1074360
• Libros:
https://www.packtpub.com/drupal-7-module-development/book
• drupal.org, groups.drupal.org, IRC


Drupal core API
• User/Permissions/Node_access
• DBTNG (PDO adaptado a Drupal) y
SchemaAPI
• MenuAPI
• FormAPI
• BlockAPI
• Drupal Mail System


Drupal core API
• Entities, FieldAPI y Content
• FileAPI
• Theme System
• JavaScript, AJAX y LibraryAPI
• Perfiles de instalación
• SimpleTest
• Search System...


Drupal contrib APIS
• Views
• EntityAPI
• SearchAPI
• Rules
• Commerce
• UserPoints, etc...
• Drush


Documentación de la API
• Core:
– http://api.drupal.org/
– Comentarios Doxygen: http://drupal.org/node/1354
– Descripciones, ejemplos y comentarios (en ocasiones):
http://api.drupal.org/api/drupal/includes%21menu.inc/group/menu/7
• Contrib:
– http://drupalcontrib.org/api/drupal/7
– http://api.drush.org/api/functions
– http://api.worldempire.ch/api/userpoints
– http://api.drupalcommerce.org/


Estructura de un módulo
• sites/{all o misite}/modules/{custom/}mi_modulo
• Tiene seguro
– .info
– .module
• Muy probable que tenga también
– .install
– .tests
• Podría tener varios .inc, .css, .js ...

User/Permissions/Node_access
• Administración de usuarios, roles y permisos
• Control de acceso
• hook_permission


hook_permision
function node_access_example_permission() {
return array(
'access codemotion table' => array(
'title' => t('Access codemotion table'),
'description' => t('May view the table with
de results of codemotion_example table.'),
),
);
}


Menu System
• Sistema de routing de Drupal (maneja la url)
• Mantenimiento y consulta de datos relativos a
los menús del sistema
• Renderizado de menús
• Diferentes tipos de menú según donde se
muestre el enlace (si se muestra)
• Control de acceso incluido
• hook_menu() y hook_menu_alter

hook_menu (menu_example)
function codemotion_menu() {
$items['codemotion/table'] = array(
'title' => 'TableSort example',
'description' => 'Page with a sortable table',
'page callback' =>
'codemotion_tablesort_example_page',
'access arguments' => array('access codemotion
table'),
'type' => MENU_NORMAL_ITEM,
'menu_name' => 'main-menu',
);
return $items;
}

Renderizando una página (tablesort_example)
function codemotion_tablesort_example_page() {
$header = array(
array('data' => t('Numbers'), 'field' => 't.numbers'),
array('data' => t('Letters'), 'field' => 't.alpha'),
array('data' => t('Mixture'), 'field' => 't.random'),
);
$query = db_select('codemotion_example', 't')->extend('TableSort');
$query->fields('t');
$result = $query->orderByHeader($header)->execute();
$rows = array();
foreach ($result as $row) {$rows[] = array('data' => (array) $row);}
$build['tablesort_table'] = array(
'#theme' => 'table',
'#header' => $header,
'#rows' => $rows,
);
return $build;
}


SchemaAPI
• Capa de abstracción de la base de datos
basada en PDO
• Muchos plugins
• Definición del schema de datos
• Hooks para definir operaciones durante
instalación y desinstalación de módulos
• Hooks para definir operaciones durante
activación y desactivación de módulos

hook_schema (dbtng_example)
function codemotion_schema() {
$schema['codemotion_example'] = array(
'description' => 'Stores some values for sorting fun.',
'fields' => array(
'numbers' => array('description' => 'This column',
'type' => 'varchar','length' => 10,'not null' => TRUE,
),
'random' => array(
'description' => 'This column simply holds random',
'type' => 'varchar','length' => 128,'not null' => TRUE,
),
),
'primary key' => array('numbers'),
);

return $schema;
}

hook_install y hook_uninstall (dbtng_example)
function codemotion_install() {
$rows = array(
array('numbers' => 1, 'alpha' => 'e', 'random' => '912cv21'),
array('numbers' => 2, 'alpha' => 'a', 'random' => '0kuykuh'),
array('numbers' => 4, 'alpha' => 'w', 'random' => '80jsv772'),
array('numbers' => 6, 'alpha' => 's', 'random' => 'au832'),
array('numbers' => 7, 'alpha' => 'e', 'random' => 't982hkv'),
);

if (db_table_exists('codemotion_example')) {
foreach ($rows as $row) {
db_insert('codemotion_example')->fields($row)->execute();
}
}
} function codemotion_uninstall() {
db_drop_table('codemotion_example');
}


FormAPI
• Definir formularios a traves de arrays
asociativos dentro de la función miform_form
• Renderizar formularios: drupal_get_form()
• Form validation: miform_form_validate
• Form submision: miform_form_submit
• hook_form_alter


_for (form_example)
function form_codemotion_form($form, &$form_state) {
$form['alpha'] = array(
'#type' => 'select',
'#title' => t('Other value'),
'#options' => array('web' => t('Web'),'hello'=>t('Hello')),
);
$form['random'] = array(
'#type' => 'textarea',
'#title' => t('What standardized tests did you take?'),
'#default_value' => 'Un poco de random?',
);
$form['submit'] = array(
'#type' => 'submit', '#value' => 'Enviar',
);
return $form;
}


_form_validate y _form_submit
function form_codemotion_form_validate($form, &$form_state) {
if(!is_numeric($form_state['values']['numbers'])) {
form_set_error('numbers', t('Numbers must be a number'));
}
}

function form_codemotion_form_submit($form, &$form_state) {
drupal_set_message(t('MyVal: @values',
array('@values'=>$form_state['values']['myvalue'])));
$row = array('numbers' => $form_state['values']
['numbers'], ...);
db_insert('codemotion_example')->fields($row)->execute();
codemotion_mail_send($form_state['values']);
}


Blocks
• Fragmentos de contenido.
• Se pueden distribuir en cualquier región
definida en el tema a traves de la UI
• Definidos con hook_block_info
• Renderizados con hook_block_view
• Otros hooks para modificar el comportamiento
de los existentes en otros módulos


hook_block_info (block_example)
function codemotion_block_info() {
$blocks['codemotion'] = array(
'info' => t('Codemotion Data'),
'status' => TRUE,
'region' => 'sidebar_first',
'visibility' => BLOCK_VISIBILITY_LISTED,
'pages' => 'node/*',
);
$blocks['codemotiontext'] = array(
'info' => t('Codemotion Text'),
);
return $blocks;
}


hook_block_view (block_example)
/**
* Implements hook_block_view().
*/
function codemotion_block_view($delta = '') {
switch ($delta) {
case 'codemotion':
$block['subject'] = t('Codemotion Data Block');
$block['content'] = codemotion_tablesort_example_page();
break;
case 'codemotiontext':
$block['codemotiontext'] = 'codemotiontext';
break;
}
return $block;
}


A partir de aquí...

http://groups.drupal.org/madrid
http://2012.drupalday.es


¿Preguntas? ...
… comentarios ...
… críticas ...

Gracias :)

Alessandro Mascherpa
@ALMADEWEB


Desarrollo de módulos para Drupal

Más contenido relacionado

Similar a Desarrollo de módulos para Drupal

Más de Alessandro Mascherpa

Desarrollo de módulos para Drupal