Principal › Manuales Drupal › Tutorial para crear módulos : Drupal 5

03. Diciéndole a Drupal quien puede usar el módulo

Jue, 2007-02-22 22:53 — Ged

Tema principal descrito: Permisos

Drupal hook descrito: hook_perm

La siguiente fundicón a definir es la función de los permisos, para definirla se usael hook _perm. Aquí es donde se definirán los nombres de los permisos del módulo. Esta función no asigna los permisos, simpelemente especifica cuales estarán disponibles para el módulo. El acceso basado en estos permisos será definido más tarde en la función de módulo _access, en otro tutorial.

En este momento usaremos la cadena de permisos más general, y daremos acceso a quien pueda acceder al contenido del sitio o administrar el módulo, usando la cadena "access content". Esto quiere decir, que si un usuario puede ver el contenido del sitio, también podrá ver el contenido desde el módulo.:

<?php
/**
* Valid permissions for this module
* @return array An array of valid permissions for the onthisdate module
*/
function onthisdate_perm() {
return array('access content');
} // function onthisdate_perm()
?>

Si vas a escribir un módulo que necesita tener mayor control sobre los permisos y vas a hacer permisos de control (checking permissions), deberías incrementar las configuración de los permisos. Puedes hacer esto añadiendo cadenas al array devuelto. Por ejemplo:

<?php
function onthisdate_perm() {

return array('access onthisdate', 'administer onthisdate');

} // function onthisdate_perm
?>

Para este tutorial, empezar con el primero. Más tarde lo moveremos a la segunda versión.

Necesitarás ajustar quien tiene permisos para ver el módulo desde la página administer » accounts » permissions. usaremos la función user_access para checar los permisos, lo veremos más tarde (siempre todo para más tarde).

Tus cadenas de permisos deben ser únicas dentro del módulo. Si no lo son, la página de permisos, listará los mismo permisos varias veces. También  deberían contener el nombre del módulo, para evitar conflictos con otros módulos.

La convención del nombre es "action_verb modulename". Por ejemplo:

<?php
function newmodule_perm() {

return array('access newmodule', 'create newmodule', 'administer newmodule');

} // function newmodule_perm
?>

El setup del módulo ya está hecho. Puedes añadir el código definido en tu archivo. En el próximo tutorial empezaremos a crear contenido.

Más informacién sobre permission hook:
Drupal HEAD

Marcar/Buscar este post con:
  • Meneame
  • fresqui
  • barrapunto
  • Delicious
‹ 02. Avisar a Drupal de nuestro moduloarriba04. Declarar el bloque de contenido ›