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

Recommended

Recommended

More Related Content

Similar to Desarrollo de módulos para Drupal

Similar to Desarrollo de módulos para Drupal (20)

More from Alessandro Mascherpa

More from Alessandro Mascherpa (7)

Recently uploaded

Recently uploaded (20)

Desarrollo de módulos para Drupal