Como obtener los nodos de un tipo específico en Drupal 6 desde API

Introducción.

En algunos casos puede ser útil obtener desde un fragmento de código PHP utilizando el API oficial, los nodos de un portal basado en Drupal 6 que correspondan con un tipo específico (file, story, event, page, …).  Esto se puede hacer fácilmente de la siguiente manera.

Procedimiento.

Obtener el listado con la información general de los nodos del tipo específico.  Para esto se consulta la tabla node que contiene la siguiente información de los nodos.

nid         int(10)           # ID del nodo.
vid         int(10)           # ID de la versión del nodo.
type        varchar(32)       # Tipo del nodo.
title       varchar(255)      # Título.
uid         int(11)           # ID del propietario.
status      int(11)           # Estado (publicado = 1; sin publicar/oculto = 0)
created     int(11)           # Timestamp de la creación del nodo.
changed     int(11)           # Timestamp de la modificación del nodo.
comment     int(11)           # Estado de comentarios (desactivados = 0; sólo lectura = 1; activados = 2).
promote     int(11)           # Promocionado a la página principal (no = 0; si = 1).
moderate    int(11)           # Moderado
(no = 0; si = 1).
sticky      int(11)           # Pegajoso (no = 0; si = 1).
language    varchar(12)       # Código del idioma.
tnid        int(10)
translate   int(11)

La consulta básica se puede realizar de la siguiente manera.

$sql = "SELECT nid
        FROM {node}
        WHERE type = 'TIPO_DE_NODO' AND
              status = 1
        ORDER BY created DESC";

$results = db_query($sql);

Posteriormente se iteran los resultados obtenidos de la consulta y se carga la información completa de cada uno de los nodos.

while ($result = db_fetch_object($results))
{
    $node = node_load($result -> nid);
}

El contenido del nodo recuperado dependerá en cierta medida de los módulos instalados que alteran su estructura.  Para mostrar por ejemplo el título, la fecha de creación, el mensaje y la fecha de modificación de una noticia se utiliza el siguiente fragmento.

echo 'Titulo: ' . $node -> title . '<br />';
echo 'Fecha: ' . format_date($node->created) . '<br />';
echo 'Mensaje: ' . $node->body . '<br /><br /><hr /><br />';
echo 'changed on: ' . format_date($node->changed, 'custom', 'Y-m-d H:i:s O') . '<br />';

Enlaces.

Como personalizar la barra de idiomas en Drupal 6

Introducción.

Después de instalar y configurar los módulos para mantener las traducciones del contenido en el portal basado en Drupal 6, el siguiente paso era crear la barra de banderas que permitiera cambiar fácilmente entre los distintos idiomas del portal.

BarraIdiomas

Procedimiento.

  1. Instalar el módulo Consistent Language Interface que provee al bloque Consistent Language Interface block (languageinterface).
    http://drupal.org/project/languageinterface
  2. Editar page.tpl.php e incluír el siguiente fragmento de código donde se desea la barra de banderas.
    <?php
        $flags = module_invoke('languageinterface', 'block', 'view', 0);
        print $flags['content'];
    ?>
  3. Personalice la presentación de la barra con CSS ya que su estructura es básicamente una lista no ordenada.  Para establecer la distribución horizontal como la de la imagen propuesta, agregue el siguiente código en la hoja de estilos del tema.
    #language-interface
    {
        padding: 0;
        margin: 0;
    }
    
    #language-interface li
    {
        display: inline;
        list-style-type: none;
        padding: 0;
        margin: 0px 5px 0px 0px;
        height: 12px;
    }
  4. Si desea puede además establecer estilos particulares para cada idioma, la clase CSS deberá llamarse igual que el código del idioma.  Además es posible resaltar al idioma actual utilizando la clase active.

Enlaces.

Mejorando la creación de contenido traducido con Drupal 6

Además de los pasos realizados para la configuración y edición del contenido traducido en Drupal 6 recientemente he instalado algunos módulos adicionales que permiten mayor flexibilidad en su mantenimiento como el hecho de tener una barra para cambiar el idioma desplegado, controlar que nodo es la traducción a otro idioma de otro, cuales idiomas ya han sido traducidos de un nodo, traducción de partes del portal como cadenas, taxonomía y encuestas, y mostrar la versión original de un nodo si el idioma requerido aún no se encuentra disponible.

Los siguientes módulos requieren que los idiomas del sitio se encuentren definidos (?q=admin/settings/language) y que el Language Negotiation (?q=admin/settings/language/configure) deba ser Path prefix only o Path prefix with language fall-back.

?q=admin/settings/language/configure

Personalizar el formulario de login en Drupal 6

Procedimiento.

Editar el archivo template.php y agregar la siguiente función (el nombre es libre).

function phptemplate_generarFormularioLogin()
{
   $form_id = 'user_login';
   $form = array();

   $form['name'] = array(
      '#type' => 'textfield',
      '#maxlength' => USERNAME_MAX_LENGTH,
      '#required' => TRUE,
      '#attributes' => array('tabindex' => '1',
      'class' => 'registro'),
   );

   $form['pass'] = array(
      '#type' => 'password',
      '#required' => TRUE,
      '#attributes' => array('tabindex' => '2',
      'class' => 'registro'),
   );

   $form['submit'] = array(
      '#type' => 'submit',
      '#value' => t('Log in'),
      '#weight' => 2,
      '#attributes' => array('tabindex' => '3')
   );

   $form['#validate'] = user_login_default_validators();
   $form['#build_id'] = sprintf('form-%s', md5(uniqid(mt_rand(), TRUE)));

   $form_state = array();

   drupal_prepare_form($form_id, $form, $form_state);
   drupal_process_form($form_id, $form, $form_state);

   $out = new stdClass;
   $out->form_start = sprintf("<form method='post' accept-charset='UTF-8' action='%s'>",
                             url('user/login'));
   $out->form_end = "</form>";

   $out->name = drupal_render($form['name']);
   $out->pass = drupal_render($form['pass']);
   $out->submit = drupal_render($form['form_id']) .

   drupal_render($form['form_build_id']) .
   drupal_render($form['submit']);

   return $out;
}

Insertar en el lugar deseado de page.tpl.php el siguiente fragmento de código o su correspondiente personalización.

<?php $login_form = phptemplate_generarFormularioLogin(); ?>
<?php print $login_form -> form_start; ?>
    Usuario &nbsp; <?php print $login_form->name; ?> &nbsp;&nbsp;&nbsp;
    Contraseña &nbsp; <?php print $login_form->pass; ?>&nbsp;&nbsp;
    <?php print $login_form->submit; ?>
<?php print $login_form->form_end; ?>

Enlaces.

Personalizar el formulario de búsqueda en un tema de Drupal 6

Introducción.

En algunas ocasiones no es suficiente con el bloque de búsquedas de Drupal y es necesario incluír un formulario de búsquedas en la plantilla del tema con un estilo muy específico.

Las búsquedas en Drupal utilizan un sistema de llaves o claves para impedir que sean consumidas desde fuera del sitio, así que escribir un formulario propio con el action direccionado no es una buena alternativa.

Implementación.

  1. Activar el formulario de búsquedas en el tema.
    1. Acceda el menú de administración de temas (?q=admin/build/themes).
    2. Haga clic sobre el enlace Configurar frente al tema elegido.
    3. Seleccione la casilla Bloque de búsqueda.
    4. Presione el botón Guardar configuración.
  2. Copie el archivo modules/search/search-block-form.tpl.php a la carpeta del tema con el nombre search-theme-form.tpl.php.
  3. Edite page.tpl.php del tema e incluya la etiqueta <?php print $search_box; ?> donde desee que aparezca el campo de búsqueda en el tema.
  4. Edite el archivo search-theme-form.tpl.php con el formulario de búsqueda personalizado.
    1. No es necesario incluír las etiquetas <form> ya que estas se incluyen automáticamente.
    2. El ID del formulario generado es search-theme-form.
    3. El ID del campo de las palabras clave deberá ser edit-search-theme-form-1.
    4. El nombre del campo de las palabras clave deberá ser search_theme_form.
    5. Incluya esta etiqueta en cualquier lugar del archivo <?= $search[‘hidden’]; ?>.

Enlaces.

Como crear nuevas regiones en Drupal 6

Introducción.

Las regiones en Drupal permiten la ubicación de los bloques en la página.  Su distribución se realiza generalmente en el archivo page.tpl.php del tema.

Por defecto se incluyen las siguientes regiones.

  1. Columna izquierda (left).
  2. Columna derecha (right).
  3. Contenido central (content).
  4. Cabecera (header).
  5. Pies de página (footer).

Agregar nuevas regiones al tema.

Es posible según la complejidad del tema que sea necesario agregar nuevas regiones para manipular la distribución del contenido del sitio con mayor precisión y granularidad.

Hasta la versión 5 de Drupal esto se realizaba sobreescribiendo la función phptemplate_regions() del archivo template.php, sin embargo este estilo de configuración fue modificado para las versiones 6 y posteriores.

Ahora la configuración de las regiones se realiza en el archivo TEMA.info de la siguiente manera.

regions[left] = Columna izquierda
regions[right] = Columna derecha
regions[content] = Contenido
regions[header] = Cabecera
regions[footer] = Pies de pagina
regions[menu] = Menu horizontal

Enlaces.

Cómo determinar si el usuario se encuentra autenticado en Drupal

En algunas ocasiones es necesario saber si el usuario que visita el portal basado en Drupal se encuentra autenticado o no en una sesión.  Particularmente útil para determinar que elementos de la interfaz de usuario pueden ser accedidos por usuarios anónimos y cuales deben ser accedidos sólo por usuarios autenticados.

Esto se realiza gracias al objeto $user disponible durante la generación de las vistas de la siguiente manera.

global $user;

if($user -> uid)
{
    // El usuario se encuentra autenticado y en sesión.
}
else
{
    // El visitante del portal es anónimo.
}