db_query

Executa uma consulta básica no banco de dados ativo

Exemplo

$result = db_query("SELECT node.nid, node.title FROM {node}
                    WHERE node.type LIKE '%s'
                    ORDER BY node.created DESC","noticia");

Repare no uso do marcador ‘%s’, que teve seu valor indicado como argumento logo após a consulta SQL. O uso desses marcadores é altamente recomendado pelo Drupal e funciona de forma semelhante à função sprintf() do PHP.

Outro detalhe importante é que o nome da tabela está entre chaves { }, para que o Drupal detecte a tabela e adicione o prefixo definido no ato da instalação, caso ele exista.

db_query_range

Executa uma função básica no banco de dados ativo, recebendo como parâmetros adicionais os índices do primeiro e do último registro a ser exibido.

Exemplo

$result = db_query_range("SELECT node.nid, node.title FROM {node}
			  WHERE node.type LIKE '%s'
			  ORDER BY node.created DESC","noticia",3,10);

Essa função retornará do terceiro ao décimo registros (últimos parâmetros) da consulta.

db_affected_rows

Essa retorna um número inteiro correspondente ao total de registros obtidos na última consulta realizada.

Exemplo

print db_affected_rows(); // imprime 7

db_fetch_object

Traz cada linha do resultado de uma consulta como um objeto.

Exemplo

while ($node = db_fetch_object($result)) {
    print $node->title;
}

db_fetch_array

Traz cada linha do resultado de uma consulta como um array.

Exemplo

while ($node = db_fetch_object($result)) {
    print $node['title'];
}

Se você possui o ID de um node do Drupal (nid) e deseja carregar o seu conteúdo em um bloco ou página, basta seguir os seguintes passos:

/*
 * Retorna um objeto com todas as informações do registro
 */
$node = node_load($nid);
 
/*
 * Recebe como argumento o objeto do registro
 * Retorna um array estruturado relativo ao seu conteúdo
 */
$dados = node_build_content($node);
 
/*
 * Renderiza o conteúdo
 */
print drupal_render($dados->content);

Muito simples, não!?

Alguns cuidados devem ser observados para que o módulo de upload do Drupal funcione de forma esperada:

Conceder permissão de escrita à pasta de destino

Quando fizer o upload do site para um servidor Linux, não esquecer de dar permissão de escrita (777) na pasta que receberá os arquivos do upload (por padrão, sites/default/files). Faça o mesmo para a pasta de arquivos temporários (que você configura em Administrar->Configurações do Site->Sistema de Arquivos);

Corrigir os nomes dos arquivos ou instalar um módulo que o faça

O Core do Drupal por si só não trata nomes de arquivos que contenham caracteres inválidos e não-ASCII (de acordo com a  RFC 2396). Esses arquivos, ao serem enviados ao servidor, perdem seus nomes originais (pela perda dos caracteres inaceitáveis) ficando assim inacessíveis.

Para solucionar esse problema e não ter que renomear esses arquivos manualmente, a Unleashed Mind mantém um módulo chamado Transliteration, que checa os nomes dos arquivos no ato do upload e os renomea automaticamente. Considero este módulo essencial e está presente em todos os meus projetos feitos em Drupal. Recomendo!

Ao gravar os dados de um formulário que contenha código PHP, você poderá se deparar com o seguinte erro:

A requisição não pode ser processada!

O servidor não suporta a ação requisitada pelo seu “browser”.

Se você acredita ter encontrado um problema no servidor, por favor entre em contato com o webmaster.

Erro 501

Isso acontece por que o mod_security do Apache não está permitindo a postagem do conteúdo em PHP via formulário.

A solução para este problema é a desativação deste módulo ou a criação de uma regra para o chamado “PHP INJECTION”.

Se você tiver acesso a essa configuração, poderá desabilitar esse filtro colocando as seguintes linhas no seu arquivo .htaccess:

# Desabilita o filtro do mod_security

SecFilterEngine Off
SecFilterScanPOST Off

Se o erro persistir, é por que somente o pessoal da empresa de hospedagem tem permissões para fazer esse tipo de ajuste.

Uma região em um tema do Drupal representa uma área dentro da qual poderemos inserir os blocos. Geralmente, existem cinco pré-definidas, são elas: Left Sidebar (Barra lateral esquerda), Right Sidebar (Barra lateral direita), Content (Conteúdo), Header (Cabeçalho) e Footer (Rodapé).

Porém em alguns casos, se faz necessária a criação de novos espaços para blocos. Para tal, iremos incluí-las no arquivo nomedotema.info da seguinte forma:

regions[nomedaregiao] = Rótulo da região

Onde nomedaregiao deverá seguir as mesmas regras da criação de variáveis do PHP.

Definir as regiões no arquivo nomedotema.info fará com que as padrões do tema sejam ignoradas. Portanto, se você pretende continuar utilizando-as, deve definí-las novamente:

regions[left] = Left sidebar
regions[right] = Right sidebar
regions[content] = Content
regions[header] = Header
regions[footer] = Footer

Depois, é só incluir no arquivo page.tpl.php, onde você quer que seja inserida a nova região, a linha:

<?php print $nomedaregiao ?>

Para facilitar a estilização via CSS, poderá fazer assim:

<div id="nomedaregiao" class="nome-da-regiao">
  <?php print $nomedaregiao ?>
</div>

Se desejar que a região só apareça se contiver blocos:

<?php if ($nomedaregiao): ?>
  <div id="nomedaregiao" class="nome-da-regiao">
    <?php print $nomedaregiao ?>
  </div>
<?php endif; ?>

Por exemplo, se quisermos adicionar no tema framework uma região chamada banners, mantendo as regiões padrão, deveremos abrir o arquivo framework.info e incluir as seguintes linhas:

regions[left] = Left sidebar
regions[right] = Right sidebar
regions[content] = Content
regions[header] = Header
regions[footer] = Footer
regions[banner] = Banner

Depois, incluímos no page.tpl.php:

<?php if ($banners): ?>
  <div id="banners" class="banners">
    <?php print $banners ?>
  </div>
<?php endif; ?>

IMPORTANTE: O conteúdo do do arquivo .info é armazenado no cache do Drupal. Por isso, após a inserção no arquivo .info você deverá ir a página admin/settings/performance e pressionar o botão de limpeza de cache, para que suas alterações tenham efeito imediato.

Os hooks (ganchos em inglês) são funções PHP pré-definidas, criadas para promover a integração dos módulos com o núcleo do sistema.

O programador, ao criar um novo módulo, extenderá essas funções, respeitando apenas os parâmetros a serem recebidos e o valor retornado, ficando a implementação propriamente dita totalmente adequável às suas necessidades.Outras funções poderão ser definidas no módulo para ajudá-lo na implementação dos hooks ou executar as suas ações específicas.

Na api do drupal você encontra uma lista completa de todos os hooks disponíveis com suas respectivas descrições.

A implementação dos hooks inicia-se no uso correto da nomenclatura, que se dá substituindo a palavra hook no nome da função pelo nome do módulo.

Por exemplo, para implementar o hook_menu() em um módulo chamado notícias, vá até a pasta deste módulo, abra o arquivo noticias.module e crie uma função chamada noticias_menu(), esse hook é responsável por criar ítens de menu e chamadas de página através de url (não detalharemos o hook_menu() para não fugirmos do escopo desta matéria).

O código desse exemplo ficaria assim:

<?php
/**
 * Implementação do hook_menu
 */
function noticias_menu() {
  $items = array();
 
  // Cria um ítem de menu
  $items['noticias'] = array(
    'title' => 'Noticias',
    'page callback' => 'noticias_page',
    'access arguments' => array('access content'),
    'type' => MENU_NORMAL_ITEM,
  );
  // Cria uma url para uma página
  $items['noticias/lista'] = array(
    'title' => t('Notícias'),
    'page callback' => 'noticias_list',
    'access arguments' => array('access content'),
    'type' => MENU_CALLBACK,
  );
 
  return $items;
}
?>

Com o uso do hook_menu(), o drupal irá incluir os links do módulos de notícias na geração do menu do sistema.

Qualquer dúvida ou sugestão, é só comentar!!