Descripción paso a paso de cómo instalar el módulo Devel de Drupal. Se requiere que ya haya sido instalado el núcleo del nuevo sitio Drupal 7 (Drupal Core) en una plataforma como DAMP (Drupal + Apache + MySQL + PHP).
Contenido
1. Verificar los módulos instalados
- Abrir el panel de control de DAMP. Por Finder, ir a "/Applications/acquia-drupal/" y doble click en la aplicación "Acquia Dev Desktop Control Panel".
- Asegurarse de que la plataforma esté arriba, es decir que tanto el indicador de Apache como el de MySQL estén en verde.
- Abrir el sitio Drupal 7 en el navegador (por ejemplo "http://drupal-example:8092") e ingresar como el usuario administrador.
- En la barra de menú superior, click en la opción "Modules".
2. Descargar el módulo Devel
- En la ventana que se abre aparece la lista de módulos instalados, con una casilla de verificación que indica cuáles están habilitados. El grupo "DEVELOPMENT" no aparece cuando el núcleo de Drupal está recién instalado (nuestro caso).
- Click en el enlace "+ Install new module".
- Se abre la sección donde se indica la ubicación del archivo. Si ya se ha descargado previamente, se puede seleccionar la ubicación del mismo. Vamos a asumir que no tenemos todavía el archivo y lo vamos a buscar manualmente en la página de Drupal.
- Dar click derecho en el enlace "modules" (resaltado en la imagen de abajo) y abrir el enlace en una nueva pestaña ("Open Link in New Tab") para conservar abierta esta ventana y volver a ella después de encontrar el archivo.
- Ir a la nueva pestaña y en el filtro especificar la categoría (Modules categories: Developer) y la versión de Drupal con la que debe ser compatible el módulo (Filter by compatibility: 7.x). Podemos también especificar el nombre del módulo (Search Modules: Devel), pero para el ejemplo queda en blanco para ver qué otros módulos populares arroja la búsqueda.
- Click en "Search".
- Desplazarse hacia abajo en la página para encontrar los módulos resultantes. Click en "Devel".
- En la página del módulo (drupal.org/project/devel), bajar hasta la sección de descargas ("Downloads") y buscar las versiones publicadas recomendas ("Recommended releases", resaltadas en fondo verde).
- Ir a la versión más reciente (7.x) y dar click derecho sobre el enlace "tar.gz" (que es el usual para Mac OS X, pero en teoría da exactamente lo mismo descargar la versión ".zip"). Seleccionar la opción copiar dirección del enlace para usarla en la otra pantalla ("Copy Link Address").
- Con la dirección copiada (en este caso "http://ftp.drupal.org/files/projects/devel-7.x-1.3.tar.gz") ir a la pestaña de nuestro sitio Drupal y pegarla en el campo de la dirección de origen ("Install from URL").
- Click en "Install".
- Al terminar la descarga del archivo, Drupal automáticamente desempaqueta y ejecuta el contenido del archivo. Si todo funciona correctamente, debe aparecer una pantalla como esta:
3. Habilitar y verificar la instalación del módulo
- Click en el enlace "Enable newly added modules" o ir a la página inicial y dar click en la opción "Modules" del menú administrativo en la esquina superior de la pantalla.
- Bajar hasta la nueva sección "DEVELOPMENT" y allí marcar en la casilla de "Devel" para habilitarlo.
- Click en "Save configuration".
- El módulo Devel consiste en una variedad de herramientas útiles para desarrolladores, pero que no tienen una utilidad directa en la presentación para usuarios finales. Por esta razón, la página inicial de nuestro sitio Drupal refleja ningún cambio en la superficie después de la instalación del módulo. Para ver las secciones que implementa Devel, debemos ir a una página de contenido.
- Como el sitio está vacío, en lugar de un nodo de contenido podemos ver la página de nuestro usuario administrador. Click en "My account" en la esquina superior derecha.
- En la página que se abre, podemos visualizar la información del usuario administrador con el que ingresamos. A diferencia de antes, ahora encontramos una pestaña "Devel" junto a las demás pestañas que clasifican el contenido de la página ("View", "Edit" y "Shortcuts").
- Click en la pestaña "Devel".
- Se abre una sección con dos botones ("Load" y "Render") y una subsección anaranjada de contenido.
- El módulo Devel usa un componente llamado Krumo para desplegar la información del objeto relevante en la subsección anaranjada.
- Predeterminadamente, Devel muestra el contenido del objeto al ser cargado en memoria ("Load"). Al dar click en el objeto se despliegan el nombre, tipo de datos y valor de cada uno de sus atributos. Al dar click en "Render" se muestran los objetos (y su estado) involucrados en el despliegue del objeto en pantalla.
4. Configurar el módulo
- Además de la pestaña "Devel" en cada página de contenido, el módulo ofrece otras herramientas que haremos visibles para poderlas usar como administradores del sitio Drupal. Para configurar este comportamiento, click en la opción "Structure" del menú administrativo.
- Click en la opción "Blocks".
- Bajar hasta la sección donde están los bloques inhabilitados.
- En los bloques deseados, habilitarlos seleccionando una región para que sean visibles. Por ejemplo, habilitar los bloques "Development", "Execute PHP" y "Switch User" y ubicarlos en la región "Sidebar Second" para que sean desplegados a la derecha del área de contenido.
- Verificar que los bloques deseados quedaron clasificados en la región deseada.
- Bajar hasa el final de la página. Click en el botón "Save blocks" para guardar los cambios en la configuración.
- Recargar la página para ver los bloques del módulo en la región configurada.