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'];
}

/*
 * 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!?

Neste artigo vou listar alguns módulos que, na minha opinião, são essenciais para o desenvolvimento de um bom portal, apesar de não fazerem parte do core do Drupal.

Content Construction Kit (CCK)

Todo tipo de conteúdo no Drupal, por padrão, é composto de um título e um texto. Com o módulo CCK você poderá adicionar campos personalizados sob a forma de campos texto, comboboxes, checkboxes, entre outros.

Views

As views constróem consultas de modo que você possa montar listas, blocos e tabelas apenas informando o tipo de conteúdo, campos, ordenação, quantidade de itens por página, etc.

Content Template (Contemplate)

Cria um template para exibição de cada tipo de conteúdo. Na página de criação do template serão disponibilizadas todas as variáveis disponíveis e com exemplos de valores, de modo que você só precisará “encaixá-las” no código HTML.

FCKEditor

O editor de textos mais famoso e completo da web irá substituir as textareas convencionais, facilitando a formatação de blocos de texto e tornando a sua edição bem mais prática, uma vez que as tags HTML são geradas automaticamente.

Imagecache

Permite a geração de imagens com base nas enviadas por campos de upload. Essas cópias poderão ser redimensionadas, cortadas, convertidas em preto e branco, etc. A configuração é muito simples e intuitiva, você cria padrões pré-configurados e a partir daí todas as imagens estarão disponíveis sob estes formatos, mesmo as que foram enviadas antes da criação desses padrões.

Imagefield

É um widget para o CCK que possibilita validação de dimensões e upload de imagens via AJAX no formulário de criação de conteúdo, com visualização em miniatura logo após processado o envio.

Filefield

Funciona de forma bem semelhante ao Imagefield, porém é indicado para o envio de outros tipos de arquivos.

Pathauto

Gera url’s automaticamente baseando-se na data, título, usuário de criação entre outros. A forma como as url’s são geradas é totalmente configurável. Dica: renomeie o arquivo i18n-ascii.example.txt para i18n-ascii.txt, depois, visite a página  http://www.seusite.com/admin/build/path/pathauto, clique em “Configurações Gerais”, e marque a opção “Converter strings em letras e números da ASCII-96″. Isso irá assegurar que as url’s geradas não possuam caracteres não-ASCII.

Pngfix

A solução para a incompatibilidade do nosso “querido” Internet Explorer 6 com imagens PNG de 24 bits.

Transliteration

Corrige os nomes dos arquivos enviados, retirando caracteres inválidos. Sem este módulo, você não poderá visualizar os arquivos cujos nomes possuam acentos, espaços…

Webform

Criação de formulários personalizados com envio via email, gravação em Banco de Dados e download de relatórios. ]]> http://www.rubensgadelha.com.br/2009/01/26/modulos-essenciais-para-um-site-drupal/feed/ 1 http://www.rubensgadelha.com.br/2009/01/23/erros-de-upload-de-arquivos-no-drupal/ http://www.rubensgadelha.com.br/2009/01/23/erros-de-upload-de-arquivos-no-drupal/#comments Fri, 23 Jan 2009 03:30:13 +0000 admin http://www.rubensgadelha.net/?p=103 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!

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.

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.

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!!