dev

Alterando formulários no Drupal usando o hook form_alter

Saudações amigos!

Recentemente no trabalho eu tive que alterar os formulários de registro e edição de usuário do Drupal para que o campo de e-mail não seja obrigatório.

É meio sem sentido, mas vai por mim, essas coisas são mais comum do que se pensa.

E como realizamos uma proeza dessas? Editamos o user.module para que ele satisfaça a nossa vontade?

ERRADO!

Sempre que hackeamos o core do Drupal, deus mata um gatinho. Para que esta barbárie não aconteça, devemos fazer uso do hook_form_alter. Hooks (ganchos, em inglês) são funções especiais que permitem interagir com o core do Drupal.

O legal é que através deste hook podemos não só alterar os formulários do Drupal, quanto os formulários fornecidos por outros módulos.

A sim, deixe apenas eu deixar claro que este artigo é para a versão 6. Mas adaptar para Drupal 7 é fácil.

Criando um Módulo para o nosso trabalho

Para usar este hook, precisamos criar um módulo simples, que se chamará no email registration. Crie uma pasta dentro de /sites/all/modules ou /sites/default/modules chamada no_email_register. Dentro desta pasta, coloque os seguintes arquivos (ambos são requiridos):

no_email_register.info: contém das informações do módulo, como nome, descrição versão, etc. Seu conteúdo será este:

```
name = No email registration
```

description = Remove a obrigatoriedade de informar um email no registro do usuário

```
core = 6.x
```
```
version = 6.x-dev
```
```
package = 
```

no_email_register.module: É aqui que vai ficar o código do nosso módulo, vamos começar incluindo:

```
<?php
```
```
/**
```

 * Implementation of hook_form_alter().

```
 */
```

function no_email_register_form_alter(&$form, &$form_state, $form_id) {

```
 
```
```
}
```

Observe que a marcação do PHP não está fechada com "?>" e isso é proposital. Simplesmente deixe assim.

Descobrindo o id do formulário do campo a ser alterado

Antes de continuar, precisamos descobrir os $form_id's dos formulários que terão os campos alterados. Isso é simples de fazer, basta dar uma olhada no código-fonte do formulário em questão e procurar pelo id da tag <form>:

form_id do formulário de registro do Drupal

Isso significa que o $form_id do formulário é user-register, né?

WRONNNG!!!

ERRADO NOVAMENTE!

Na verdade o $form_id do formulário de registro é user_register e remete à função user_register() que contém os campos escritos pela Form API (ou FAPI para os íntimos).

O outro $form_id que precisamos alterar é o da página de edição de usuário, o "user_profile_form". Vamos completar o código do nosso no_email_register.module com os seguintes testes:

```
<?php
```
```
/**
```

 * Implementation of hook_form_alter().

```
 */
```

function no_email_register_form_alter(&$form, &$form_state, $form_id) {

```
  if($form_id == 'user_register'){
```
```
 
```
```
  }
```
```
 
```
```
  if($form_id == 'user_profile_form'){
```
```
 
```
```
  }
```
```
}
```

O próximo passo é saber o que vai ser alterado no campo. Você pode procurar pela função e o campo em FAPI em questão no código do módulo user para usar como referência:

Código do campo de email.

No caso, vamos alterar o valor de '#required' no $form['mail'] de TRUE para FALSE. Você pode ver isso no código abaixo, que também é o código completo do nosso IMENSO módulo:

```
<?php
```
```
 
```
```
/**
```

 * Implementation of hook_form_alter().

```
 */
```

function no_email_register_form_alter(&$form, &$form_state, $form_id) {

```
  if($form_id == 'user_register'){
```
```
    $form['mail']['#required'] = FALSE;
```

    $form['account']['mail']['#required'] = FALSE;

```
  }
```
```
 
```
```
  if($form_id == 'user_profile_form'){
```

    $form['account']['mail']['#required'] = FALSE;

```
  }
```
```
 
```
```
}
```

Agora é só ativar o módulo e Voilà!

Nosso artigo de desenvolvimento Drupal chegou ao fim. É muito simples alterar um formulário, e claro que este artigo apenas arranhou o assunto. Mesmo assim é uma informação que salva vidas.

Use sem moderação, e SEMPRE PENSE NOS GATINHOS.

Sempre que você hackeia o core, deus mata um gatinho

Tópicos:

dev Drupal drupal 6 Tutorial

2 comentários

Comente você também!

SNIPPET: processar uma imagem com Imagecache através da função theme()

Aloha!
Bem-vindos ao segundo artigo que apresenta pequenos e úteis trechos de código de programação. No primeiro artigo eu mostrei como processar uma imagem com o Imagecache e obter uma url para a mesma.

Agora, vou mostrar como processar uma imagem no imagecache e obter a tag da imagem completa, através da função theme:

```
<?php
```

   print theme('imagecache', $preset, $filepath, $alt_text);

```
?>
```

Simples assim. Os argumentos são os seguintes:

$preset - O preset do imagecache que será usado no processamento da imagem;
$filepath - o caminho para a imagem que será processada;
$alt_text - o texto alternativo (atributo alt) da imagem resultante.

E é só isso?

Plus: criando um link através da função l(), inserindo html na entrada na função.

Neste comentário do post anterior, Sebastian entregou o jogo completo deste artigo. Para não ficar na impressão de já ter visto isso antes, complemento com a seguinte dica:

No Drupal, você pode criar links usando a função l(). A sintaxe é simples:

```
<?php
```
```
   print l($text, $path, $options);
```
```
?>
```

onde:

$text - o texto do link a ser criado;
$path - o endereço para qual o link irá apontar. Se for para um node, por exemplo, o valor de $path será 'node/123', onde '123' é o nid do node;
$options - um array com opções de personalização do link, como controle de atributos, etc.

Por padrão, o parâmetro $text só aceitará texto simples. Ou seja, se você inserir tags HTML as as mesmas serão tratadas como texto simples e não haverá formatação.

Você pode modificar isso através do parâmetro $options, da seguinte forma:

```
<?php
```

  print l($text, $path, array('html'=>'true'));

```
?>
```

Atenção: Inserir HTML sem qualquer filtro na entrada de qualquer função deve ser usado com sabedoria, especialmente se quem for inserir esse HTML não souber o que está fazendo. Ou saber exatamente o que está fazendo, se você me entende.

O bom agora é que você pode combinar as duas dicas deste artigo, e criar um link em uma imagem processada pela função theme(). Exemplo:

```
<?php
```

   $user = user_load(1); // carrega as informações do usuário de id '1', ou seja, o administrador do site

   $preset = 'avatar_coment'; // preset do imagecache

   $filepath = base_path() . 'sites/default/files/avatar.png'; // caminho para a imagem a ser precessada pelo preset

   $alt_text = 'Avatar do usuário ' . $user->name; // texto alternativo da imagem

```
 
```

   $img = theme('imagecache', $preset, $filepath, $alt_text); // resultará em uma tag <img /> com atributos preenchidos pelos parâmetros da função

```
 
```
```
   $path = 'user/' . $user->uid;
```
```
   $options = array('html'=>'true');
```
```
 
```
```
   print l($img, $path, $options);
```
```
?>
```

O código acima irá processar a imagem "avatar.png", gerar uma tag de imagem, que por sua vez será enviada para a função l(), ganhando um link para o perfil do usuário administrador do site.

E por hoje é só, pessoal!

Até breve.

Tópicos:

snippet Drupal dev

2 comentários

Comente você também!

SNIPPET: Criando uma URL para uma imagem processada pelo Imagecache

Olá amigos!

Este artigo inaugura uma nova seção aqui no blog, a categoria de Snippets. Nesta categoria ficarão pequenos códigos de programação PHP (voltados principalmente para desenvolvimento Drupal, mas nem sempre) e jQuery.

Hoje eu vou mostrar um pequeno código que nos permite processar uma imagem usando a API do Imagecache, obtendo uma URL como resultado. É claro que você precisa do módulo para que este código funcione:

```
<?php
```

   print imagecache_create_url($presetname, $filepath, $bypass_browser_cache = FALSE, $absolute = TRUE);

```
?>
```

Os argumentos são os seguintes:

$presetname: o preset do Imagecache que será utilizado no processamento da imagem.
$filepath: O caminho para a imagem a ser processada.
$bypass_browser_cache: diz se a imagem que será processada será ignorada ou não pelo cache do navegador. O padrão é FALSE.
$absolute: indica se a URL resultante é absoluta ou relativa;

Aplicações práticas

Este código é especificamente útil na confecção de layouts de web sites, ou de galerias de fotos altamente personalizadas. No meu caso, utilizei este código na confecção do template de uma newsletter.

Tópicos:

snippet Drupal dev

2 comentários

Comente você também!

Marcus VBP

Desenvolvimento Web, Drupal, Ubuntu, Nerdices, e o que mais der na telha...

dev

Alterando formulários no Drupal usando o hook form_alter

Criando um Módulo para o nosso trabalho

Descobrindo o id do formulário do campo a ser alterado

SNIPPET: processar uma imagem com Imagecache através da função theme()

Plus: criando um link através da função l(), inserindo html na entrada na função.

SNIPPET: Criando uma URL para uma imagem processada pelo Imagecache

Aplicações práticas

Páginas

Siga no Twitter

Assine por Email

Mais Comentados

Populares do dia

Informativo

Arquivo mensal

Tópicos

Meu Twitter