50 Filtros Para WordPress: Final da Série

Portuguese (Português) translation by Erick Patrick (you can also view the original English article)

Bem-vindo ao final da série "50 Filtros Para WordPress"! Nesta última parte, revisaremos o que aprendemos e resumiremos todos os 50 filtros em 10 palavras (é tudo ou nada) cada uma.

É hora de começar!

Primeira Parte: Uma Introdução aos Filtros para WordPress

Na primeira parte da série, entramos no mundo mágico dos filtros e aprendemos o que eles são, como funcionam, quando usá-los e como devemos, usá-los. Então, nós aprendemos:

O que é um filtro do WordPress: Um filtro é um função que é executada entre uma base de dados e o navegador, realizando ações sobre seus dados, antes do WordPress retorná-los. O WordPress tem—literalmente—centenas de filtros em seu código base e você pode criar seus próprios filtros para as coisas que desenvolver (como plugins). Foi isso que aprendemos.

Como criar um função filtradora e atrelá-la a um filtro: Na verdade, é bem simples: criamos uma função que trabalha com os dados e atrelamo-a a um filtro correspondente, usando a função add_filter() (Eu talvez tenha simplificado demais - é um pouco mais complicado que isso). Tenha certeza de verifica a primeira parte da série, caso não tenha ainda. É bem importante.

Como remover uma função (ou funções) de um filtro: Aprendemos duas funções do WordPress para desatrelar funções de filtros: remove_filter() e remove_all_filters() (é bem fácil adivinhar qual função remove uma e qual remove todas as funções atreladas a um filtro). Nós aprendemos como usá-las.

Como criar nossos próprios filtros: O WordPress tem centenas de filtros em seu código, mas e se quisermos que nosso plugin seja tão flexível e expansível quanto o código do próprio WordPress? Pois bem, podemos criar nosso próprios ganchos de filtro, usando a função apply_filters(). Caso seja um desenvolvedor de plugins, tenha certeza de aprendê-la muito bem.

Segunda parte: 5 Partes para 50 Ótimos Filtros e Seus Exemplos

Após adentrar o mundo dos filtros do WordPress, a melhor coisa a se fazer seria aprender sobre todo e cada filtro existente no código do WordPress. Ainda que esse tutorial fosse o melhor de todos os tutoriais sobre o WordPress, levaria muito tempo e esforço porque há mais de mil filtros só no código base da versão 3.9.1 do WordPress.

Isso não quer dizer que devemos ficar parados e aprender nada. Escolhi 50 filtros, apresentando-os através pequenos parágrafos e apresentando exemplos de cada um. Eis o que aprendemos, de forma bem rápida:

50 Filtros Para WordPress – Parte Dois

login_errors permite-nos alterar as mensagens de erro de login do WordPress;
comment_post_redirect permite-nos redirecionar os visitantes para uma página interna do nosso site (ou uma página externa permitida) após eles realizarem um comentário;
allowed_redirect_hosts permite-nos definir servidores externos "seguros" para a função wp_safe_redirect();
body_class permite-nos configurar classes CSS para a tag <body>;
locale faz com que o WordPress altere seu idioma;
sanitize_user limpa os nomes de usuários e permite-nos alterar a sequência de limpeza;
the_content filtra o conteúdo do artigo e permite-nos alterá-lo antes que o conteúdo seja apresentado;
the_password_form criar formulários de senha para os artigos protegidos, além de permitir alterar os formulários;
the_terms filtra o retorno da função the_terms() e permite-nos alterá-lo;
wp_mail_from permite-nos alterar o nome do Remetente do e-mails que o WordPress envia;

50 Filtros Para WordPress – Parte Três

gettext filtra as cadeias de caracteres traduzíveis, de modo que possamos alterar seu comportamento ou alterar as cadeias completamente;
sanitize_title limpa os títulos dos artigos de modo que possam ser salvos como "urls amigáveis", além de nos permitir alterar esse processo;
no_texturize_shortcodes permite-nos adicionar nossos shortcodes à lista "de não texturização";
pre_comment_approved filtra o processo antecessor à aprovação (ou não) dos comentários, permitindo-nos alterá-lo;
enable_post_by_email_configuration permite-nos habilitar ou desabilitar a funcionalidade "publicar por e-mail" do WordPress;
wp_title filtra os títulos das páginas, geralmente apresentadas nas tags <title> e nas abas de nossos navegadores;
preprocess_comment lida com o processo anterior ao salvamento de qualquer dado dos comentários na base de dado;
login_redirect permite-nos configurar um redirecionamento "seguro" após os usuários realizarem login;
plugin_action_links_$plugin permite-nos mostrar links abaixo dos nomes de nossos plugins na página Plugins;
the_editor_content dá-nos a oportunidade de preencher o conteúdo de um editor de artigo que, por padrão, vem vazio;

50 Filtros Para WordPress – Parte Quatro

use_default_gallery_style permite-nos habilitar ou desabilitar regras CSS padrão para o shortcode [gallery];
wp_get_attachment_url filtra o retorno das URLs de anexos, permitindo-nos alterá-las;
wp_mail_content_type permite-nos alterar o tipo de conteúdo dos e-mails que o WordPress envia (por padrão, ele envia como text/plain);
pre_comment_user_ip permite-nos mexer com os endereços IP dos comentaristas, antes deles serem salvos na base de dados;
wp_revisions_to_keep permite-nos alterar o limite de revisões para artigos — um único artigo, tipo de artigo ou qualquer coisa que imaginar!
img_caption_shortcode filtra o shortcode [caption] das imagens e permite-nos reescrever, completamente, seu retorno, se necessário;
post_class filtra a função post_class() e permite configurar classes CSS customizadas para os artigos;
attachment_fields_to_edit permite-nos adicionar ou remover campos de formulários para os anexos;
excerpt_length permite-nos alterar quantas palavras serão apresentadas em resumos automáticos do WordPress;
bulk_actions-$screenid filtra as ações em massa das listas de itens nas páginas administrativas, permitindo adicionar ou remover ações;

50 Filtros Para WordPress – Parte Cinco

posts_search filtra o processo de busca, permitindo-nos alterá-lo como quisermos;
wp_editor_set_quality configura a qualidade de compressão para os anexos redimensionados (imagens);
widget_text filtra o widget de Texto padrão, permitindo-nos alterar seu retorno;
the_content_feed permite-nos alterar o conteúdo dos itens do feed;
mce_buttons permite-nos adicionar ou remover botões da primeira linha do Editor Visual;
list_terms_exclusions permite-nos definir exceções à lista de termos;
image_size_names_choose permite-nos adicionar nomes de tamanhos de imagens customizados na lista suspensa de "Tamanhos", quando uma imagem é adiciona através do Editor Visual;
excerpt_more permite-nos alterar o texto [...] dos resumos para outra coisa;
manage_posts_columns facilita a edição de colunas das listas de artigos das páginas administrativas;
user_contactmethods permite-nos adicionar ou remover campos dos perfis de usuários;

50 Filtros Para WordPress – Parte Seis

script_loader_src filtra a função wp_enqueue_script() e nos permite alterar o retorno da função;
admin_post_thumbnail_html permite-nos adicionar HTML após o link "Adicionar imagem destacada" na página de "Novo Post";
comment_flood_filter permite-nos alterar o processo de verificação de flood de comentários;
dashboard_glance_items permite-nos alterar a seção "Agora" no painel administrativo;
login_message permite-nos alterar as mensagens padrão de login;
bulk_post_updated_messages filtra o retorno de mensagens informativas quando um artigo é atualizado;
widget_categories_args permite-nos alterar os argumentos padrões do widget Categorias;
registration_redirect permite-nos configurar um redirecionamento "seguro" após um registro de usuário bem sucedido;
comment_form_default_fields permite-nos alterar os campos padrões do formulário de comentários;
upload_mimes facilita a alteração da lista de tipos permitidos de arquivos que podem ser enviados para a Biblioteca de Mídia;

O Fim

Acabou. Terminamos a série de filtros para WordPress — mas ainda não acabamos com os ganchos do WordPress: fique ligado para outra série de sete partes sobre as ações para WordPress!

Apesar de ter sido bem demorada, gostei bastante de escrever cada palavra e cada trecho de código. Sabia que era um pequeno ponto mas bastante útil dentro dos tutoriais para WordPress. Aprendi bastante enquanto escrevia; Espero que tenha sido o mesmo com você.

Todo o tipo de contribuição é bem-vindo, por falar nisso. Você pode:

Compartilhar suas ideias sobre essa série nos comentários abaixo,
Sugerir novos exemplos de filtros para uma ou duas partes extras,
Oferecer maneiras de aprimorar minha escrita, caso tenha visto algum erro, incoerência ou ambiguidade em meus artigos,
E compartilhar esses tutoriais em qualquer lugar e com qualquer pessoa que queria aprender sobre os filtros do WordPress!

Obrigado por ter acompanhado toda esta série! Até mais!

Seja o primeiro a saber sobre novas traduções–siga @tutsplus_pt no Twitter!