WordPress filters – Lista completa de filtros!

Esta lista de dicas explora um conceito fundamental no desenvolvimento do WordPress: filtros!

No WordPress, os filtros permitem que os desenvolvedores interceptem e modifiquem dados à medida que uma página do WordPress está sendo carregada, antes de enviá-los ao navegador ou salvá-los no banco de dados. Você pode ler mais sobre filtros neste artigo em nosso glossário.

Não é tão fácil entender como os filtros funcionam, em parte porque o conceito é difícil de visualizar e também porque os filtros costumam ser confundidos com as ações do WordPress. No entanto, é um conceito importante a ser dominado porque os filtros são uma das maneiras mais comuns de os desenvolvedores interagirem com o WordPress.

Por esses motivos, esta lista de filtros é ideal para quem não trabalha tanto com filtros e fornece um entendimento profundo do que os filtros fazem e como eles funcionam, além de um guia de referência rápida para o uso de filtros no desenvolvimento do WordPress.

Como o sistema evolui, tentaremos manter esta lista sempre atualizada, e sinta-se livre a deixar seu comentário caso um novo filtro exista e não esteja listado aqui.

Guia de referência do ganchos para filtros

O WordPress possui centenas de ganchos que os desenvolvedores podem usar para se conectar ao código principal.

O Codex do WordPress fornece orientações sobre como usar os ganchos de filtro, listados usando as seguintes categorias:

  • Filtros de post, página e anexos (upload)
  • Filtros de comentário, trackback e ping
  • Filtros de categoria e termos
  • Filtros de Links
  • Filtros de data e hora
  • Filtros de autor e usuário
  • Filtros do Blogroll
  • Filtros de informações e opções do blog
  • Filtros de texto gerais
  • Filtros administrativos
  • Filtros do editor Rich Text
  • Filtros para templates
  • Filtros de Registro e Login
  • Filtros de redirecionamento / reescrita (rewrite)
  • Filtros WP_Query
  • Filtros de mídias
  • Filtros avançados do WordPress
  • Widgets
  • Barra de administração

Muitos desses ganchos de filtro são divididos em duas subcategorias: leituras e gravações de banco de dados. Isso depende se uma função está lendo no banco de dados antes da exibição do conteúdo em uma página ou se você está escrevendo um código antes de salvar os dados no banco de dados.

O uso de ganchos no WordPress começou com a elaboração de qual gancho você precisa “conectar” seu código e, em seguida, escrevendo uma função para modificar os dados necessários.

Filtros de post, página e anexos (upload)

Leitura de banco de dados

  • attachment_fields_to_edit – Aplicado aos campos de formulário a serem exibidos ao editar um anexo.
  • attachment_icon – Aplicado ao ícone de um anexo na função get_attachment_icon.
  • attachment_innerHTML – aplicado ao título a ser usado para um anexo, se não houver ícone, na função get_attachment_innerHTML.
  • author_edit_pre – Aplicado à post do autor antes da exibição para edição.
  • body_class – Aplicado às classes do elemento HTML . Chamado na função get_body_class.
  • content_edit_pre – Aplicado para postar conteúdo antes da exibição para edição.
  • content_filtered_edit_pre – Aplicado para postar conteúdo filtrado antes da exibição para edição.
  • excerpt_edit_pre – Aplicado para postar trechos antes da exibição para edição.
  • date_edit_pre – Aplicado à data de post anterior à exibição para edição.
  • date_gmt_edit_pre – Aplicado à data de post anterior à exibição para edição.
  • get_attached_file – Aplicado às informações do arquivo anexado recuperadas pela função get_attached_file.
  • get_enclosed – Aplicado à lista de anexos de um post pela função get_enclosed.
  • get_pages – Aplicado à lista de páginas retornadas pela função get_pages.
  • get_pung – Aplicado à lista de URLs com ping para um post pela função get_pung.
  • get_the_archive_title – Aplicado ao título do arquivo na função get_the_archive_title.
  • get_the_excerpt – Aplicado ao trecho do post na função get_the_excerpt.
  • get_the_guid – aplicado ao GUID do post na função get_the_guid.
  • get_to_ping – Aplicado à lista de URLs para executar ping em um post pela função get_to_ping.
  • icon_dir – aplicado ao diretório de imagens do modelo em várias funções.
  • icon_dir_uri – aplicado ao URI do diretório de imagens do modelo em várias funções. Basicamente, permite que um plugin especifique que os ícones para os tipos MIME devem vir de um local diferente.
  • image_size_names_choose – Aplicado à lista de tamanhos de imagem selecionáveis ​​na Biblioteca de mídia. Geralmente usado para selecionar tamanhos de imagem personalizados.
  • mime_type_edit_pre – Aplicado para postar o tipo mime antes da exibição para edição.
  • modified_edit_pre – Aplicado à data de pós-modificação antes da exibição para edição.
  • modified_gmt_edit_pre – Aplicado para postar a modificação gmt date antes da exibição para edição.
  • no_texturize_shortcodes – Aplicado aos códigos de acesso registrados. Pode ser usado para isentar códigos de acesso da função de texturização automática.
  • parent_edit_pre – Aplicado para postar o ID do pai antes de exibir para edição.
  • password_edit_pre – Aplicado para postar a senha antes da exibição para edição.
  • post_class – Aplicado às classes do elemento HTML mais externo de um post. Chamado na função get_post_class. Argumentos da função de filtro: um array de nomes de classes, um array de nomes de classes adicionais que foram adicionados ao primeira array e o ID do post.
  • pre_kses – Aplicado a vários conteúdos antes de ser processado / higienizado pelo KSES. Esse gancho permite que os desenvolvedores personalizem quais tipos de scripts / tags devem ser permitidos no conteúdo ou removidos.
  • prepend_attachment – Aplicado ao HTML a ser anexado pela função prepend_attachment.
  • protected_title_format – Usado para alterar ou manipular o título do post quando o post é protegida por senha.
  • private_title_format – Usado para alterar ou manipular o título do post quando seu status é privado.
  • sanitize_title – Aplicado a um título do post pela função sanitize_title, após remover as tags HTML.
  • single_post_title – Aplicado ao título do post quando usado para criar um título de página de blog pelas funções wp_title e single_post_title.
  • status_edit_pre – Aplicado ao status do post antes da exibição para edição.
  • the_content – Aplicado ao conteúdo do post recuperado do banco de dados, antes da impressão na tela (também usado em outras operações, como trackbacks).
  • the_content_rss – aplicado ao conteúdo do post antes da inclusão em um feed RSS. (Descontinuada)
  • the_content_feed – Aplicado ao conteúdo do post antes da inclusão em um feed RSS.
  • the_editor_content – Aplicado para postar conteúdo antes de colocá-lo em uma janela avançada do editor.
  • the_excerpt – Aplicado ao trecho do post (ou ao conteúdo do post, se não houver trecho) recuperado do banco de dados, antes da impressão na tela (também usada em outras operações, como trackbacks).
  • the_excerpt_rss – Aplicado ao trecho do post antes da inclusão em um feed RSS.
  • the_password_form – Aplicado ao formulário de senha para posts protegidos.
  • the_tags – Aplicado às tags recuperadas do banco de dados, antes da impressão na tela.
  • the_tags – Aplicado ao título do post recuperada do banco de dados, antes da impressão na tela (também usada em outras operações, como trackbacks).
  • the_title_rss – aplicado ao título do post antes de incluir em um feed RSS (após a primeira filtragem com o the_title.
  • title_edit_pre – Aplicado para postar o título antes da exibição para edição.
  • type_edit_pre – Aplicado ao tipo de post antes da exibição para edição.
  • wp_dropdown_pages – Aplicado à lista suspensa HTML de páginas do WordPress geradas pela função wp_dropdown_pages.
  • wp_list_pages – Aplicado à lista HTML gerada pela função wp_list_pages.
  • wp_list_pages_excludes – Aplicado à lista de páginas excluídas (um array de IDs de página) na função wp_list_pages.
  • wp_get_attachment_metadata – Aplicado aos metadados do anexo recuperados pela função wp_get_attachment_metadata.
  • wp_get_attachment_thumb_file – Aplicado ao arquivo de miniatura do anexo recuperado pela função wp_get_attachment_thumb_file.
  • wp_get_attachment_thumb_url – Aplicado ao URL da miniatura do anexo recuperado pela função wp_get_attachment_thumb_URL.
  • wp_get_attachment_url – Aplicado ao URL do anexo recuperado pela função wp_get_attachment_url.
  • wp_mime_type_icon – Aplicado ao ícone do tipo MIME para um anexo calculado pela função wp_mime_type_icon.
  • wp_title – Aplicado ao título da página do blog antes de enviar para o navegador na função wp_title.

Gravação de banco de dados

  • add_ping – Aplicado ao novo valor do campo pingado em um post quando um ping é adicionado, antes de salvar as novas informações no banco de dados.
  • attachment_fields_to_save – Aplicado aos campos associados a um anexo antes de salvá-los no banco de dados. Chamado na função media_upload_form_handler. Argumentos da função de filtro: um array (matriz) de atributos de post, um array de campos de anexo, incluindo as alterações enviadas a partir do formulário.
  • attachment_max_dims – aplicado às dimensões máximas da imagem antes de reduzir o tamanho da imagem. A entrada da função de filtro (e o valor de retorno) é falsa (se nenhuma dimensão máxima tiver sido especificada) ou uma lista de dois itens (largura, altura).
  • category_save_pre – Aplicado para postar uma lista separada por vírgulas da categoria antes de salvá-la no banco de dados (também usado para anexos).
  • comment_status_pre – Aplicado para postar o status do comentário antes de salvá-lo no banco de dados (também usado para anexos).
  • content_filtered_save_pre – Aplicado ao conteúdo do post filtrada antes de salvá-lo no banco de dados (também usado para anexos).
  • content_save_pre – Aplicado para postar conteúdo antes de salvá-lo no banco de dados (também usado para anexos).
  • excerpt_save_pre – Aplicado para postar trechos antes de salvá-los no banco de dados (também usado para anexos).
  • image_save_pre (descontinuado) – use image_editor_save_pre.
  • jpeg_quality (descontinuado) – use wp_editor_set_quality ou WP_Image_Editor :: set_quality().
  • name_save_pre (Descontinuado) – Aplicado ao nome do post antes de salvá-lo no banco de dados (também usado para anexos).
  • phone_content – Aplicado ao conteúdo de um post enviada por email, antes de salvar.
  • ping_status_pre – Aplicado para postar o status do ping antes de salvá-lo no banco de dados (também usado para anexos).
  • post_mime_type_pre – Aplicado ao tipo MIME para um anexo antes de salvá-lo no banco de dados.
  • status_save_pre – Aplicado para postar o status antes de salvá-lo no banco de dados.
  • thumbnail_filename – Aplicado ao nome do arquivo da miniatura ao carregar uma imagem.
  • title_save_pre – Aplicado para postar o título antes de salvá-lo no banco de dados (também usado para anexos).
  • update_attached_file – Aplicado às informações do anexo antes de salvar os metadados de post na função update_attached_file. Argumentos da função de filtro: informações do anexo, ID do anexo.
  • wp_create_thumbnail (descontinuado)
  • wp_delete_file – aplicado a um nome de arquivo de anexo imediatamente antes da exclusão.
  • wp_generate_attachment_metadata – Aplicado ao array de metadados do anexo antes de salvar no banco de dados.
  • wp_save_image_file (descontinuado) – use wp_save_image_editor_file.
  • wp_thumbnail_creation_size_limit – Aplicado ao tamanho da miniatura ao carregar uma imagem. Argumentos da função de filtro: tamanho máximo do arquivo, ID do anexo, nome do arquivo do anexo.
  • wp_thumbnail_max_side_length – Aplicado ao tamanho da miniatura ao carregar uma imagem. Argumentos da função de filtro: tamanho máximo do lado da imagem, ID do anexo, nome do arquivo do anexo.
  • wp_update_attachment_metadata – Aplicado aos metadados do anexo antes de salvar na função wp_update_attachment_metadata. Argumentos da função de filtro: metadados, ID do anexo.

Filtros de comentário, trackback e ping

Leitura de banco de dados

  • comment_excerpt – aplicado ao trecho de comentário pela função comment_excerpt. Veja também get_comment_excerpt.
  • comment_flood_filter – Aplicado quando alguém parece estar inundando seu blog com comentários. Argumentos da função de filtro: já bloqueados (true/ false se um plugin de filtragem anterior já o bloqueou; defina como true e retorne true para bloquear este comentário em um plugin), hora do comentário anterior, hora do comentário atual.
  • comment_post_redirect – Aplicado ao local de redirecionamento depois que alguém adiciona um comentário. Argumentos da função de filtro: redirecionar local, array de informações de comentários.
  • comment_text – Aplicado ao texto do comentário antes de ser exibido na tela pela função comment_text e nos menus do administrador.
  • comment_text_rss – aplicado ao texto do comentário antes da inclusão em um feed RSS.
  • comments_array – Aplicado ao array de comentários de um post na função comments_template. Argumentos da função de filtro: array de estruturas de informações de comentários, ID do post.
  • comments_number – Aplicado ao texto formatado, fornecendo o número de comentários gerados pela função comments_number. Veja também get_comments_number.
  • get_comment_excerpt – Aplicado ao trecho de comentário lido no banco de dados pela função get_comment_excerpt (que também é chamada por comment_excerpt. Veja também comment_excerpt.
  • get_comment_ID – Aplicado ao ID do comentário lido da variável global $ comments pela função get_comment_ID.
  • get_comment_text – Aplicado ao texto do comentário atual na função get_comment_text, que também é chamada pela função comment_text.
  • get_comment_type – Aplicado ao tipo de comentário (“comment”, “trackback” ou “pingback”) pela função get_comment_type (também chamada por comment_type).
  • get_comments_number – Aplicado à contagem global de comentários lidos da variável global $ post pela função get_comments_number (que também é chamada pela função comments_number; consulte também o filtro comments_number).
  • post_comments_feed_link – Aplicado ao URL do feed gerado para o feed de comentários pela função comments_rss.

Gravação de banco de dados

  • comment_save_pre – Aplicado aos dados do comentário antes da atualização / edição dos dados do comentário. Argumentos de função: array de dados do comentário, com os índices “comment_post_ID”, “comment_author”, “comment_author_email”, “comment_author_url”, “comment_author_url”, “comment_content”, “comment_type” e “user_ID”.
  • pre_comment_approved – Aplicado ao status de aprovação do comentário atual (true/ false) para permitir a substituição de um plugin. Retorne true / false e defina o primeiro argumento como true / false para aprovar / desaprovar o comentário e use variáveis ​​globais como $comment_ID para acessar informações sobre esse comentário.
  • pre_comment_content – Aplicado ao conteúdo de um comentário antes de salvar o comentário no banco de dados.
  • preprocess_comment – Aplicado aos dados do comentário antes de qualquer outro processamento, ao salvar um novo comentário no banco de dados. Argumentos de função: array de dados de comentários, com os índices “comment_post_ID”, “comment_author”, “comment_author_email”, “comment_author_url”, “comment_content”, “comment_type” e “user_ID”.
  • wp_insert_post_data – Aplicado aos dados de post modificados e não modificados na wp_insert_post() antes da atualização ou inserção do post no banco de dados. Argumentos de função: array de post modificado e estendido e array de post higienizada.

Filtros de categoria e termos

Leitura de banco de dados

  • category_description – Aplicado ao campo “description” de categorias pelas funções category_description e wp_list_categories. Argumentos da função de filtro: descrição, ID da categoria quando chamado a partir de category_description; descrição, array de informações da categoria (todos os campos da tabela de categorias para essa categoria específica) quando chamados de wp_list_categories.
  • category_feed_link – aplicado ao URL do feed gerado para o feed de categoria pela função get_category_feed_link.
  • category_link – Aplicado ao URL criado para uma categoria pela função get_category_link. Argumentos da função de filtro: URL do link, ID da categoria.
  • get_ancestors – Aplicado à lista de IDs de ancestrais retornados pela função get_ancestors (que por sua vez é usada por muitas outras funções). Argumentos da função de filtro: array de IDs ancestrais, ID do objeto fornecido, tipo de objeto fornecido.
  • get_categories – Aplicado à lista de categorias gerada pela função get_categories (que por sua vez é usada por muitas outras funções). Argumentos da função de filtro: lista de categorias, lista de opções get_categories.
  • get_category – Aplicado às informações de categoria pesquisadas pela função get_category, que é basicamente um array de todos os campos na tabela de categorias do WordPress para um ID de categoria específico.
  • list_cats – Chamada para dois propósitos diferentes: 1. a função wp_dropdown_categories a utiliza para filtrar os argumentos show_option_all e show_option_none (que são usados ​​para colocar as opções “Todos” e “Nenhum” nas listas suspensas da categoria). Nenhum argumento adicional de função de filtro; e 2: a função wp_list_categories aplica-a aos nomes das categorias. Argumentos da função de filtro: nome da categoria, lista de informações da categoria (todos os campos da tabela de categorias para essa categoria específica).
  • list_cats_exclusions – Aplicado à instrução SQL WHERE, fornecendo as categorias a serem excluídas pela função get_categories. Normalmente, um plugin seria adicionado a esta lista, a fim de excluir determinadas categorias ou grupos de categorias das listas de categorias. Argumentos da função de filtro: cláusula de categoria WHERE excluída, lista de opções get_categories.
  • single_cat_title – Aplicado ao nome da categoria quando usado para criar um título de página de blog pelas funções wp_title e single_cat_title.
  • the_category – Aplicado à lista de categorias (uma lista HTML com links) criada pela função get_the_category_list. Argumentos da função de filtro: texto HTML gerado, separador de lista sendo usado (cadeia vazia significa que é uma lista LI padrão), argumento dos pais para get_the_category_list.
  • the_category_rss – Aplicado à lista de categorias (uma lista de elementos XML da categoria) para um post pela função get_the_category_rss, antes de incluir em um feed RSS. Os argumentos da função de filtro são o texto da lista e o tipo (“rdf” ou “rss” geralmente).
  • wp_dropdown_cats – Aplicado à lista de categorias suspensa (uma sequência de texto que contém elementos de opção HTML) gerados pela função wp_dropdown_categories.
  • wp_list_categories – Aplicado à lista de categorias (uma lista HTML) gerada pela função wp_list_categories.
  • wp_get_object_terms – Aplicado à lista de termos (um array de objetos) gerados pela função wp_get_object_terms, chamada por várias funções relacionadas à categoria / termo, como get_the_terms e get_the_category.

Gravação de banco de dados

  • pre_category_description – Aplicado à descrição da categoria antes de salvar no banco de dados.
  • wp_update_term_parent – Filtre o termo pai antes que a atualização para termo seja aplicada, conecte-se a esse filtro para ver se ele causará um loop de hierarquia.
  • edit_terms – (na verdade uma ação, mas geralmente usada como um filtro) conectada antes de salvar a alteração de taxonomia / categoria no banco de dados
  • pre_category_name – Aplicado ao nome da categoria antes de salvar no banco de dados.
  • pre_category_nicename – Aplicado ao nome legal da categoria antes de salvar no banco de dados.

Filtros de Links

Esses hooks permitem filtrar links relacionados a posts, páginas, arquivos e feeds.

  • attachment_link – Aplicado ao link permanente do anexo calculado pela função get_attachment_link. Argumentos da função de filtro: URL do link, ID do anexo.
  • author_feed_link – Aplicado ao URL do feed gerado para o feed do autor pela função get_author_rss_link.
  • author_link – Aplicado ao link permanente de arquivo do autor criado pela função get_author_posts_url. Argumentos da função de filtro: URL do link, ID do autor, nome “legal” do autor. Observe que get_author_posts_url é chamado nas funções wp_list_authors e the_author_posts_link.
  • comment_reply_link – Aplicado ao link gerado para responder a um comentário específico pela função get_comment_reply_link, chamada na função comments_template. Argumentos da função de filtro: link (string), opções personalizadas (array), comentário atual (objeto), post atual (objeto).
  • day_link – Aplicado ao URL do link para um arquivo diário pela função get_day_link. Argumentos da função de filtro: URL, ano, número do mês, número do dia.
  • feed_link – aplicado ao URL do link para um feed pela função get_feed_link. Argumentos da função de filtro: URL, tipo de feed (por exemplo, “rss2”, “atom” etc.).
  • get_comment_author_link – Aplicado ao HTML gerado para o link do autor em um comentário, na função get_comment_author_link (também chamada por comment_author_link. Argumentos da função de ação: nome do usuário.
  • get_comment_author_url_link – Aplicado ao HTML gerado para o link do autor em um comentário, na função get_comment_author_url_link (também chamada por comment_author_link).
  • month_link – Aplicado ao URL do link para um arquivo mensal pela função get_month_link. Argumentos da função de filtro: URL, ano, número do mês.
  • page_link – Aplicado ao URL da página calculada pela função get_page_link. Argumentos da função de filtro: URL, ID da página. Observe que também existe um filtro interno chamado _get_page_link que pode ser usado para filtrar os URLS das páginas que não são designadas como a home page do blog (mesmos argumentos). Observe que isso se aplica apenas a páginas do WordPress, não a posts, tipos de post personalizados ou anexos.
  • post_link – Aplicado ao permalink de post calculado pela função get_permalink, que também é chamada pelas funções the_permalink, post_permalink, previous_post_link e next_post_link. Argumentos da função de filtro: URL permanente, publicar lista de dados. Observe que isso se aplica apenas a posts padrão do WordPress, e não a tipos de post personalizados (nem páginas ou anexos).
  • post_type_link – Aplicado ao permalink do tipo de post personalizado calculado pela função get_post_permalink.
  • the_permalink – Aplicado ao URL do permalink para um post anterior à impressão pela função the_permalink.
  • year_link – Aplicado ao URL do link para um arquivo anual pela função get_year_link. Argumentos da função de filtro: URL, ano.
  • tag_link – Aplicado ao URL criado para uma tag pela função get_tag_link. Argumentos da função de filtro: URL do link, ID da tag.
  • term_link – Aplicado ao URL criado para um termo pela função get_term_link. Argumentos da função de filtro: URL do link do termo, objeto do termo e slug de taxonomia.

Filtros de data e hora

  • get_comment_date – Aplicado à data do comentário formatado gerado pela função get_comment_date (que também é chamada por comment_date).
  • get_comment_time – Aplicado ao horário do comentário formatado na função get_comment_time (que também é chamada pelo comment_time).
  • get_the_modified_date – Aplicado à data de pós-modificação formatada gerada pela função get_the_modified_date (que também é chamada pela função the_modified_date).
  • get_the_modified_time – Aplicado ao tempo de pós-modificação formatado gerado pelas funções get_the_modified_time e get_post_modified_time (que também são chamadas pela função the_modified_time).
  • get_the_time – Aplicado ao horário do post formatado gerado pelas funções get_the_time e get_post_time (que também são chamadas pela função the_time).
  • the_date – Aplicado à data de post formatada gerada pela função the_date.
  • the_modified_date – Aplicado à data de pós-modificação formatada gerada pela função the_modified_date.
  • the_modified_time – Aplicado ao tempo de pós-modificação formatado gerado pela função the_modified_time.
  • the_time – Aplicado ao horário do post formatado gerado pela função the_time.
  • the_weekday – Aplicado ao nome do dia da semana da data de post gerado pela função the_weekday.
  • the_weekday_date – Aplicado ao nome do dia da semana da data de post gerado pela função the_weekday_date. Os argumentos da função são o nome do dia da semana, antes do texto e depois do texto (antes do texto e após o texto são adicionados ao nome do dia da semana, se o dia da semana do post atual for diferente do dia da semana do post anterior).

Filtros de autor e usuário

  • login_body_class – Permite filtrar a classe do corpo aplicada à tela de login em login_header().
  • login_redirect – Aplicado à variável redirect_to post / get durante o processo de login do usuário.
  • user_contactmethods – Aplicado aos campos de métodos de contato na página de perfil do usuário. (a página antiga está aqui: contactmethods)
  • update_ (meta_type) _metadata – Aplicado antes que um metadado (usuário) seja atualizado.

Leitura de banco de dados

  • author_email – aplicado ao endereço de e-mail do autor do comentário recuperado do banco de dados pela função comment_author_email. Veja também get_comment_author_email.
  • comment_author – aplicado ao nome do autor do comentário recuperado do banco de dados pela função comment_author. Veja também get_comment_author.
  • comment_author_rss – aplicado ao nome do autor do comentário antes de incluí-lo em um feed RSS.
  • comment_email – aplicado ao endereço de e-mail do autor do comentário recuperado do banco de dados pela função comment_author_email_link.
  • comment_url – Aplicado ao URL do autor do comentário recuperado do banco de dados pela função comment_author_url (consulte também get_comment_author_url).
  • get_comment_author – aplicado ao nome do autor do comentário recuperado do banco de dados por get_comment_author, também chamado por comment_author. Veja também comment_author.
  • get_comment_author_email – Aplicado ao endereço de e-mail do autor do comentário recuperado do banco de dados por get_comment_author_email, também chamado por comment_author_email. Veja também author_email.
  • get_comment_author_IP – Aplicado ao endereço IP do autor do comentário recuperado do banco de dados pela função get_comment_author_IP, também chamada por comment_author_IP.
  • get_comment_author_url – Aplicado ao URL do autor do comentário recuperado do banco de dados pela função get_comment_author_url, também chamada por comment_author_url. Veja também comment_url.
  • login_errors – Aplicado à mensagem de erro de login impressa na tela de login.
  • login_headertitle – Aplicado ao título do URL do cabeçalho de login (desenvolvido por WordPress por padrão) impresso na tela de login.
  • login_headerurl – Aplicado ao URL do cabeçalho de login (aponta para wordpress.org por padrão) impresso na tela de login.
  • login_message – Aplicado à mensagem de login impressa na tela de login.
  • role_has_cap – Aplicado à lista de recursos de uma função na função WP_Role-> has_cap. Os argumentos da função de filtro são a lista de recursos a serem filtrados, o recurso que está sendo questionado e o nome da função.
  • sanitize_user – Aplicado a um nome de usuário pela função sanitize_user. Argumentos da função de filtro: nome do usuário (após alguma limpeza), nome do usuário bruto, strict (true ou false para usar ASCII estrito ou não).
  • the_author – aplicado ao nome exibido por um autor do post pela função get_the_author, também chamada pela função the_author.
  • the_author_email – aplicado ao endereço de e-mail de um autor do post pela função the_author_email.
  • user_search_columns – Aplicado à lista de colunas na tabela wp_users para incluir na cláusula WHERE dentro de WP_User_Query.

Gravação de banco de dados

  • pre_comment_author_email – aplicado ao endereço de e-mail do autor de um comentário antes de salvar o comentário no banco de dados.
  • pre_comment_author_name – aplicado ao nome de usuário do autor de um comentário antes de salvar o comentário no banco de dados.
  • pre_comment_author_url – aplicado ao URL do autor de um comentário antes de salvar o comentário no banco de dados.
  • pre_comment_user_agent – aplicado ao agente do autor do comentário antes de salvar o comentário no banco de dados.
  • pre_comment_user_ip – aplicado ao endereço IP do autor do comentário antes de salvar o comentário no banco de dados.
  • pre_user_id – aplicado ao ID do usuário do autor do comentário antes de salvar o comentário no banco de dados.
  • pre_user_description – Aplicado à descrição do usuário antes de salvar no banco de dados.
  • pre_user_display_name – Aplicado ao nome exibido do usuário antes de salvar no banco de dados.
  • pre_user_email – aplicado ao endereço de e-mail do usuário antes de salvar no banco de dados.
  • pre_user_first_name – Aplicado ao primeiro nome do usuário antes de salvar no banco de dados.
  • pre_user_last_name – aplicado ao sobrenome do usuário antes de salvar no banco de dados.
  • pre_user_login – aplicado ao nome de login do usuário antes de salvar no banco de dados.
  • pre_user_nicename – Aplicado ao nicename do usuário antes de salvar no banco de dados.
  • pre_user_nickname – aplicado ao apelido do usuário antes de salvar no banco de dados.
  • pre_user_url – aplicado ao URL do usuário antes de salvar no banco de dados.
  • registration_errors – Aplicado à lista de erros de registro gerados ao registrar um usuário para uma nova conta.
  • user_registration_email – Aplicado ao endereço de e-mail do usuário, lido na página de registro, antes de tentar registrar a pessoa como um novo usuário.
  • validate_username – Aplicado ao resultado da validação em um novo nome de usuário. Argumentos da função de filtro: válido (true / false), nome do usuário sendo validado.

Filtros do Blogroll

  • get_bookmarks – Aplicado aos resultados da consulta ao banco de dados links/blogroll pela função get_bookmarks. Argumentos da função de filtro: lista de resultados da consulta ao banco de dados, lista de argumentos get_bookmarks.
  • link_category – Aplicado à categoria de link pelas funções get_links_list e wp_list_bookmarks (a partir do WordPress 2.2).
  • link_description – Aplicado à descrição do link pelas funções get_links e wp_list_bookmarks (a partir do WordPress 2.2).
  • link_rating – Aplicado ao número de classificação do link pela função get_linkrating.
  • link_title – Aplicado ao título do link pelas funções get_links e wp_list_bookmarks (a partir do WordPress 2.2)
  • pre_link_description – Aplicado à descrição do link antes de salvar no banco de dados.
  • pre_link_image – Aplicado à imagem do link antes de salvar no banco de dados.
  • pre_link_name – aplicado ao nome do link antes de salvar no banco de dados.
  • pre_link_notes – Aplicado às notas do link antes de salvar no banco de dados.
  • pre_link_rel – Aplicado às informações de relação de link antes de salvar no banco de dados.
  • pre_link_rss – Aplicado ao URL do link RSS antes de salvar no banco de dados.
  • pre_link_target – Aplicado às informações de destino do link antes de salvar no banco de dados.
  • pre_link_url – Aplicado ao URL do link antes de salvar no banco de dados.

Filtros de informações e opções do blog

  • all_options – Aplicado à lista de opções recuperada do banco de dados pela função get_alloptions.
  • all_plugins – Aplicado à lista de plugins recuperados para exibição na tabela de lista de plugins.
  • bloginfo – Aplicado às informações da opção de blog recuperadas do banco de dados pela função bloginfo, após recuperar as informações pela função get_bloginfo. Um segundo argumento $ show fornece o nome da opção bloginfo solicitada. Observe que bloginfo(“url”), bloginfo(“directory”) e bloginfo(“home”) não usam essa função de filtragem (consulte bloginfo_url).
  • bloginfo_rss – Aplicado às informações da opção de blog pela função get_bloginfo_rss (também chamada de bloginfo_rss), depois de recuperar primeiro as informações com a função get_bloginfo, removendo as tags HTML e convertendo os caracteres de maneira apropriada. Um segundo argumento $ show fornece o nome da opção bloginfo solicitada.
  • bloginfo_url – Aplicado à saída de bloginfo(“url”), bloginfo(“directory”) e bloginfo(“home”) antes de retornar as informações.
  • loginout – Aplicado ao link HTML para efetuar login e sair (geralmente colocado na barra lateral) gerado pela função wp_loginout.
  • lostpassword_url – Aplicado ao URL que permite aos usuários redefinir suas senhas.
  • option_ (nome da opção) – Aplicado ao valor da opção recuperada do banco de dados pela função get_option, após desserialização (que decodifica as opções baseadas em array). Para usar esse filtro, você precisará adicionar filtros para nomes de opções específicos, como “option_foo” para filtrar a saída de get_option(“foo”).
  • pre_get_space_used – Aplicado à função get_space_used () para fornecer uma maneira alternativa de exibir o espaço de armazenamento usado. Retornar false deste filtro reverterá para o comportamento de exibição padrão (espaço de diretório usado wp_upload_dir() em megabytes).
  • pre_option_(nome da opção) – Aplicado ao valor da opção recuperada do banco de dados pela função get_alloptions, após a desserialização (que decodifica as opções baseadas em array). Para usar esse filtro, você precisará adicionar filtros para nomes de opções específicos, como “pre_option_foo” para filtrar a opção “foo“.
  • pre_update_option_(nome da opção) – Aplicou o valor da opção antes de salvar no banco de dados para permitir a substituição do valor a ser armazenado. Para usar esse filtro, você precisará adicionar filtros para nomes de opções específicos, como “pre_update_option_foo” para filtrar a opção “foo“.
  • register – Aplicado ao link da barra lateral criado para o usuário registrar (se permitido) ou visitar os painéis de administração (se já estiver logado) pela função wp_register.
  • upload_dir – Aplicado ao diretório a ser usado para uploads calculados pela função wp_upload_dir. O argumento da função de filtro é um array com os componentes “dir” (o caminho do diretório de upload), “url” (a URL do diretório de upload) e “error” (que você pode definir como true se desejar gerar um erro).
  • upload_mimes – permite que uma função de filtro retorne uma lista de tipos MIME para uploads, se não houver entrada na lista MIME para a função wp_check_filetype. O argumento da função de filtro é uma lista associada de tipos MIME cujos nomes de componentes são extensões de arquivo (separados por barras verticais) e valores são os tipos MIME correspondentes.

Filtros de texto gerais

  • attribute_escape – Aplicado para postar texto e outro conteúdo pela função attribute_escape, que é chamada em muitos lugares no WordPress para alterar certos caracteres em atributos HTML antes de enviar para o navegador.
  • js_escape – Aplicado ao código JavaScript antes de enviar para o navegador na função js_escape.
  • sanitize_key – Aplicado à chave antes de usá-la para suas configurações, campo ou outras necessidades, gerada pela função sanitize_key.

Filtros administrativos

Esses hooks permitem filtrar o conteúdo relacionado ao painel do WordPress, incluindo telas de edição de conteúdo.

  • admin_user_info_links – Aplicado ao perfil do usuário e links de informações no menu rápido de administração do WordPress.
  • autosave_interval – Aplicado ao intervalo para salvar automaticamente aos posts.
  • bulk_actions – Aplicado a uma variedade de itens em massa nas listas suspensas de ações em massa do administrador.
  • bulk_post_updated_messages – Aplicado a um array de mensagens atualizadas de ação em massa.
  • cat_rows – Aplicado às linhas de categoria HTML geradas para gerenciar categorias nos menus do administrador.
  • comment_edit_pre – Aplicado ao conteúdo do comentário antes de ser exibido na tela de edição.
  • comment_edit_redirect – Aplicado ao local de redirecionamento depois que alguém edita um comentário nos menus do administrador. Argumentos da função de filtro: local de redirecionamento, ID do comentário.
  • comment_moderation_subject – Aplicado ao assunto do email antes de enviar um email, notificando o administrador da necessidade de moderar um novo comentário. Argumentos da função de filtro: assunto do email, ID do comentário. Observe que isso acontece dentro da função padrão wp_notify_moderator, que é uma função “conectável”, o que significa que os plugins podem substituí-la; consulte API de plugin).
  • comment_moderation_text – Aplicado ao corpo da mensagem de email antes de enviar um email notificando o administrador da necessidade de moderar um novo comentário. Argumentos da função de filtro: texto do corpo do email, ID do comentário. Observe que isso acontece dentro da função padrão wp_notify_moderator, que é uma função “conectável”, o que significa que os plugins podem substituí-la; consulte API de plugin).
  • comment_notification_headers – Aplicado aos cabeçalhos de email antes de enviar um email notificando o autor do post sobre um novo comentário. Argumentos da função de filtro: texto do cabeçalho do email, ID do comentário. Observe que isso acontece dentro da função padrão wp_notify_postauthor, que é uma função “conectável”, o que significa que os plugins podem substituí-la; consulte API de plugin).
  • comment_notification_subject – Aplicado ao assunto do email antes de enviar um email notificando o autor do post sobre um novo comentário. Argumentos da função de filtro: assunto do email, ID do comentário. Observe que isso acontece dentro da função padrão wp_notify_postauthor, que é uma função “conectável”, o que significa que os plugins podem substituí-la; consulte API de plugin).
  • comment_notification_text – Aplicado ao corpo da mensagem de email antes de enviar um email notificando o autor do post sobre um novo comentário. Argumentos da função de filtro: texto do corpo do email, ID do comentário. Observe que isso acontece dentro da função padrão wp_notify_postauthor, que é uma função “conectável”, o que significa que os plugins podem substituí-la; consulte API de plugin).
  • comment_row_actions – Aplicado à lista de links de ação em cada linha de comentário (como Responder, Edição rápida, Editar).
  • cron_request – Permite filtrar a URL, chave e argumentos passados ​​para wp_remote_post() em spawn_cron().
  • cron_schedules – Aplicado a um array vazia para permitir que um plugin gere agendamentos cron na função wp_get_schedules.
  • custom_menu_order – Usado para ativar o filtro ‘menu_order‘.
  • default_content – Aplicado ao conteúdo do post padrão antes de abrir o editor para uma novo post.
  • default_excerpt – Aplicado ao trecho de post padrão antes de abrir o editor para uma novo post.
  • default_title – Aplicado ao título do post padrão antes de abrir o editor para uma novo post.
  • editable_slug – Aplicado à publicação, página, tag ou categoria slug pela função get_sample_permalink.
  • format_to_edit – Aplicado para postar conteúdo, trecho, título e senha pela função format_to_edit, chamada pelos menus do administrador para configurar um post para edição. Aplicado também ao editar comentários nos menus do administrador.
  • format_to_post – Aplicado para postar conteúdo pela função format_to_post, que não é usada no WordPress por padrão.
  • manage_edit_${post_type}_columns – Aplicado à lista de colunas a serem impressas na tela de gerenciamento de posts para um tipo de post personalizado. O argumento da função de filtro / valor de retorno é um array associativa em que a chave do elemento é o nome da coluna e o valor é o texto do cabeçalho dessa coluna. Consulte também a ação manage_${post_type} _posts_custom_column, que coloca as informações da coluna na tela de edição.
  • manage_link-manager_columns – Se chamava manage_link_columns até o WordPress 2.7. aplicado à lista de colunas para imprimir na tela de gerenciamento de blogroll. O argumento da função de filtro / valor de retorno é uma lista associativa em que a chave do elemento é o nome da coluna e o valor é o texto do cabeçalho dessa coluna. Consulte também a ação manage_link_custom_column, que coloca as informações da coluna na tela de edição.
  • manage_posts_columns – Aplicado à lista de colunas para imprimir na tela de gerenciamento de posts. O argumento da função de filtro / valor de retorno é um array associativa em que a chave do elemento é o nome da coluna e o valor é o texto do cabeçalho dessa coluna. Consulte também a ação manage_posts_custom_column, que coloca as informações da coluna na tela de edição. (consulte o tutorial da Scompt para obter exemplos e uso.)
  • manage_pages_columns – Aplicado à lista de colunas para imprimir na tela de gerenciamento de páginas. O argumento da função de filtro / valor de retorno é um array associativa em que a chave do elemento é o nome da coluna e o valor é o texto do cabeçalho dessa coluna. Consulte também a ação manage_pages_custom_column, que coloca as informações da coluna na tela de edição.
  • manage_users_columns
  • manage_users_custom_column
  • manage_users_sortable_columns
  • media_row_actions – Aplicado à lista de links de ação em cada arquivo na Biblioteca de mídia (como Exibir, Editar).
  • menu_order – Aplicado ao array para a ordem do menu do administrador. Deve ser ativado com o filtro ‘custom_menu_order‘ before antes.
  • nonce_life – Aplicado à vida útil de um nonce para gerar ou verificar o nonce. Pode ser usado para gerar nonces que expiram anteriormente. O valor retornado pelo filtro deve estar em segundos.
  • nonce_user_logged_out – Aplicado ao ID do usuário atual usado para gerar ou verificar um nonce quando o usuário está desconectado.
  • plugin_row_meta – Adicione links adicionais abaixo de cada plugin na página de plugins.
  • postmeta_form_limit – Aplicado ao número de itens de informações pós-meta mostrados na tela de pós-edição.
  • post_row_actions – Aplicado à lista de links de ação (como Edição rápida, Edição, Exibição, Visualização) em cada post na seção Posts > Todos os posts.
  • post_updated_messages – Aplicado ao array que armazena mensagens administrativas visíveis ao usuário ao trabalhar com posts, páginas e tipos de post personalizados. Este filtro é usado para alterar o texto dessas mensagens, não para acioná-las.
  • pre_upload_error – Aplicado para permitir que um plugin crie um erro XMLRPC para fazer upload de arquivos.
  • preview_page_link – Aplicado ao link na tela de edição da página que mostra a visualização da página na parte inferior da tela.
  • preview_post_link – Aplicado ao link na tela de edição de posts que mostra a visualização do post na parte inferior da tela.
  • richedit_pre – Aplicado para postar conteúdo pela função wp_richedit_pre, antes de ser exibido no editor de rich text.
  • schedule_event – Aplicado a cada evento recorrente e único, à medida que é adicionado à programação do cron.
  • set-screen-option – Filtre um valor de opção de tela antes de ser definido.
  • show_password_fields – Aplicado à variável true / false que controla se é apresentada ao usuário a oportunidade de alterar sua senha na tela de perfil do usuário (true significa mostrar campos de alteração de senha; false significa não).
  • terms_to_edit – Aplicado ao CSV de termos (para cada taxonomia) usado para mostrar quais termos estão anexados ao post.
  • the_editor – Aplicado ao DIV HTML criado para hospedar o editor de rich text, antes de imprimi-lo na tela. O argumento da função de filtro / valor de retorno é uma sequência.
  • user_can_richedit – Aplicado ao cálculo se o navegador do usuário possui recursos avançados de edição e se o usuário deseja usar o editor avançado, na função user_can_richedit. O argumento da função de filtro e o valor de retorno são true / false se o usuário atual puder / não puder usar o editor avançado.
  • user_has_cap – Aplicado à lista de recursos de um usuário na função WP_User-> has_cap (que é chamada pela função current_user_can). Os argumentos da função de filtro são a lista de recursos a ser filtrada, o recurso que está sendo questionado e a lista de argumentos (que possui itens como o ID do post, se a capacidade for editar posts etc.)
  • wp_handle_upload_prefilter – Aplicado às informações de upload ao carregar um arquivo. Argumento da função de filtro: array que representa um único elemento de $_FILES.
  • wp_handle_upload – Aplicado às informações de upload ao carregar um arquivo. Argumento da função de filtro: array com os elementos “arquivo” (nome do arquivo), “url”, “tipo”.
  • wp_revisions_to_keep – altera quantas revisões são mantidas para um determinado post. Argumentos da função de filtro: número que representa as revisões desejadas salvas (o padrão é revisões ilimitadas), o objeto de post.
  • wp_terms_checklist_args – Aplicado aos argumentos da função wp_terms_checklist(). Argumento da função de filtro: array de argumentos da lista de verificação, ID do post.
  • wp_upload_tabs – Aplicado à lista de guias personalizadas a serem exibidas na tela de administração de gerenciamento de upload. Use a ação upload_files_(guia) para exibir uma página da sua guia personalizada (consulte API de plugin / referência de ação).
  • media_upload_tabs – Aplicado à lista de guias personalizadas a serem exibidas na tela de administração do gerenciamento de upload. Use a ação upload_files_(aba) para exibir uma página da sua guia personalizada (consulte API de plugin / referência de ação).
  • plugin_action_links_ (nome do arquivo do plugin) – Aplicado à lista de links a serem exibidos na página de plugins (ao lado dos links para ativar / desativar).
  • views_edit-post – Aplicado a exibição de posts em lista, por exemplo, Todas (30) | Publicado (22) | Projecto (5) | Pendente (2) | Lixo (1).

Filtros do editor Rich Text (TinyMCE, editor clásico)

Usando esses hooks, você pode modificar a configuração do TinyMCE, o editor de rich text. Entretanto, note que este editor foi descontinuado e atualmente o editor de blocos é o editor padrão do WordPress.

  • mce_spellchecker_languages – Aplicado à seleção de idioma disponível no corretor ortográfico.
  • mce_buttons, mce_buttons_2, mce_buttons_3, mce_buttons_4 – Aplicado às linhas de botões da barra de ferramentas do editor avançado (cada uma é um array de nomes de botões).
  • mce_css – Aplicado à URL do arquivo CSS para o editor de rich text.
  • mce_external_plugins – Aplicado ao array de plugins externos a serem carregados pelo editor de rich text.
  • mce_external_languages – Aplicado ao array de arquivos de idiomas carregados por plugins externos, permitindo que eles usem o método de tradução padrão (consulte tinymce/langs/wp-langs.php para obter referência).
  • tiny_mce_before_init – Aplicado a todo array init do editor.

Filtros para templates

Os hooks nesta seção permitem trabalhar com temas, templates e arquivos de estilo.

  • locale_stylesheet_uri – Aplicado ao URI da folha de estilo específica do código do idioma retornado pela função get_locale_stylesheet_uri. Argumentos da função de filtro: URI, URI do diretório da folha de estilo.
  • stylesheet – Aplicada à folha de estilo retornada pela função get_stylesheet.
  • stylesheet_directory – Aplicado ao diretório da folha de estilo retornado pela função get_stylesheet_directory. Argumentos da função de filtro: diretório da folha de estilo, folha de estilo.
  • stylesheet_directory_uri – Aplicado ao diretório URI do estilo, retornado pela função get_stylesheet_directory_uri. Argumentos da função de filtro: URI do diretório da folha de estilo, folha de estilo.
  • stylesheet_uri – Aplicado ao URI da folha de estilo retornado pela função get_stylesheet_uri. Argumentos da função de filtro: URI da folha de estilo, folha de estilo.
  • template – Aplicado ao modelo retornado pela função get_template.
  • template_directory – Aplicado ao diretório de modelos retornado pela função get_template_directory. Argumentos da função de filtro: diretório de modelos, modelo.
  • template_directory_uri – Aplicado ao URI do diretório de modelos retornado pela função get_template_directory_uri. Argumentos da função de filtro: URI do diretório de modelos, modelo.
  • theme_root – Aplicado ao diretório raiz do tema (normalmente wp-content/themes) retornado pela função get_theme_root.
  • theme_root_uri – Aplicado ao diretório raiz do tema URI retornado pela função get_theme_root_uri. Argumentos da função de filtro: URI, URL do site. Você também pode substituir arquivos de modelo individuais do seu tema, usando os seguintes ganchos de filtro. Consulte também o gancho de ação template_redirect. Cada um desses filtros usa como entrada o caminho para o arquivo de modelo correspondente no tema atual. Um plugin pode modificar o arquivo a ser usado retornando um novo caminho para um arquivo de modelo.
  • 404_template
  • archive_template – Você pode usar isso, por exemplo, para aplicar um modelo específico a um archive personalizado do tipo de post. Dessa forma, você pode manter todo o código em um plugin.
  • attachment_template
  • author_template
  • category_template
  • comments_popup_template
  • comments_template – O filtro “comments_template” pode ser usado para carregar um template personalizado de um plugin que substitui o modelo de comentário padrão dos temas.
  • date_template
  • home_template
  • page_template
  • paged_template
  • search_template
  • single_template – Você pode usar isso, por exemplo, para impor um modelo específico para um tipo de post personalizado. Dessa forma, você pode manter todo o código em um plugin.
  • shortcut_link – Aplicado ao link bookmarklet “Press This”.
  • template_include
  • wp_nav_menu_args – Aplicado aos argumentos da função wp_nav_menu.
  • wp_nav_menu_items – Filtre o conteúdo da lista HTML para os menus de navegação.

Filtros de Registro e Login

  • authenticate – Permite que a autenticação básica seja realizada no login com base no nome de usuário e na senha.
  • registration_errors – Aplicado à lista de erros de registro gerados ao registrar um usuário para uma nova conta.
  • user_registration_email – Aplicado ao endereço de e-mail do usuário, lido na página de registro, antes de tentar registrar a pessoa como um novo usuário.
  • validate_username – Aplicado ao resultado da validação em um novo nome de usuário. Argumentos da função de filtro: válido (true/false), nome do usuário sendo validado.
  • wp_authenticate_user – Aplicado quando um usuário tenta fazer login, depois que o WordPress valida o nome de usuário e a senha, mas antes da verificação dos erros de validação.

Filtros de redirecionamento / reescrita (rewrite)

Esses hooks avançados estão relacionados ao manuseio de regras de reescrita do WordPress.

  • allowed_redirect_hosts – Aplicado à lista de nomes de host considerados seguros para redirecionamento. O wp-login.php usa isso para se defender de requisições perigosas do parâmetro ‘redirect_to’.
  • author_rewrite_rules – Aplicado às regras de reescrita relacionadas ao autor depois que elas são geradas.
  • category_rewrite_rules – Aplicado às regras de reescrita relacionadas à categoria depois que elas são geradas.
  • comments_rewrite_rules – Aplicado às regras de reescrita relacionadas a comentários depois que elas são geradas.
  • date_rewrite_rules – Aplicado às regras de reescrita relacionadas à data depois que elas são geradas.
  • mod_rewrite_rules – Aplicado à lista de regras de reescrita fornecidas ao usuário para colocar no arquivo .htaccess quando ele altera a estrutura do link permanente. (Nota: substitui o filtro obsoleto rewrite_rules.)
  • page_rewrite_rules – Aplicado às regras de reescrita relacionadas à página depois que elas são geradas.
  • post_rewrite_rules – Aplicado às regras de reescrita pós-relacionadas depois que elas são geradas.
  • redirect_canonical – Pode ser usado para cancelar um redirecionamento de URL “canônico”. Aceita 2 parâmetros: $redirect_url, $request_url. Para cancelar o retorno de redirecionamento FALSE, para permitir o retorno de redirecionamento $redirect_url.
  • rewrite_rules_array – Aplicado a todo array de regras de reescrita depois que ela é gerada.
  • root_rewrite_rules – Aplicado às regras de reescrita no nível raiz depois que elas são geradas.
  • search_rewrite_rules – Aplicado às regras de reescrita relacionadas à pesquisa depois que elas são geradas.
  • wp_redirect – Aplicado a uma URL de redirecionamento pela função padrão wp_redirect. Argumentos da função de filtro: URL, código de status HTTP. Observe que o wp_redirect também é uma função “plugável”, o que significa que os plugins podem substituí-lo; consulte API de plugin).
  • wp_redirect_status – Aplicado ao código de status HTTP ao redirecionar pela função padrão wp_redirect. Argumentos da função de filtro: código de status HTTP, URL. Observe que o wp_redirect também é uma função “plugável”, o que significa que os plugins podem substituí-lo; consulte API de plugin).

Filtros WP_Query

Esses são filtros executados pelo objeto WP_Query no decorrer da criação e execução de uma consulta para recuperar posts.

  • found_posts – Aplicado à listagem de posts, logo após a consulta no banco de dados.
  • found_posts_query – Após a consulta da lista de posts a serem exibidos no banco de dados, o WordPress seleciona linhas nos resultados da consulta. Esse filtro permite que você faça algo diferente de SELECT FOUND_ROWS () nessa etapa.
  • post_limits – Aplicado à cláusula LIMIT da consulta que retorna o array de posts.
  • posts_clauses – Aplicado a toda a consulta SQL, dividida em um array com chave para cada tipo de cláusula, que retorna o array de posts. Pode ser mais fácil trabalhar do que posts_request.
  • posts_distinct – Permite que um plugin adicione uma cláusula DISTINCTROW à consulta que retorna o array de post.
  • posts_fields – Aplicado à lista de campos da consulta que retorna o array de post.
  • posts_groupby – Aplicado à cláusula GROUP BY da consulta que retorna o array de post (normalmente vazia).
  • posts_join – Aplicado à cláusula JOIN da consulta que retorna o array de post. Isso geralmente é usado para adicionar uma tabela ao JOIN, em combinação com o filtro posts_where.
  • posts_join_paged – Aplicado à cláusula JOIN da consulta que retorna o array de post, depois que a paginação é calculada (embora a paginação não afete a JOIN, portanto, na verdade, é equivalente a posts_join).
  • posts_orderby – Aplicado à cláusula ORDER BY da consulta que retorna o array de post.
  • posts_request – Aplicado a toda a consulta SQL que retorna o array de posts, imediatamente antes da execução da consulta.
  • posts_results – Permite manipular o array resultante retornada da consulta.
  • posts_search – Aplicado à pesquisa SQL usada na cláusula WHERE do WP_Query.
  • posts_where – Aplicado à cláusula WHERE da consulta que retorna o array de post.
  • posts_where_paged – Aplicado à cláusula WHERE da consulta que retorna o array de post, após o cálculo da paginação (embora a paginação não afete o WHERE, portanto, na verdade, é equivalente a posts_where).
  • the_posts – Aplicado à lista de posts consultados no banco de dados após processamento mínimo de permissões e status de rascunho em páginas de post única.

Filtros de mídias

Esses hooks de filtro de mídia permitiram integrar diferentes tipos de mídia.

  • editor_max_image_size
  • image_downsize
  • get_image_tag_class
  • get_image_tag
  • image_resize_dimensions
  • intermediate_image_sizes
  • icon_dir
  • wp_get_attachment_image_attributes
  • img_caption_shortcode
  • post_gallery
  • use_default_gallery_style
  • gallery_style
  • (adjacent)_image_link
  • embed_defaults
  • load_default_embeds
  • embed_googlevideo
  • upload_size_limit
  • wp_image_editors
  • plupload_default_settings
  • plupload_default_params
  • image_size_names_choose
  • wp_prepare_attachment_for_js
  • media_upload_tabs
  • disable_captions
  • media_view_settings
  • media_view_strings
  • wp_handle_upload_prefilter

Filtros avançados do WordPress

Os hooks de filtro avançados nesta seção estão relacionados à internacionalização, consultas diversas e outras funções fundamentais do WordPress.

  • create_user_query – aplicado à consulta usada para salvar as informações de um novo usuário no banco de dados, pouco antes da execução da consulta.
  • get_editable_authors – Aplicado à lista de autores de postagem que o usuário atual está autorizado a editar na função get_editable_authors.
  • get_next_post_join – Na função get_next_post (que localiza o postagem após o post exibida no momento), aplicada à cláusula SQL JOIN (que normalmente se une à tabela de categorias se o usuário estiver visualizando um arquivo de categorias). Argumentos da função de filtro: cláusula JOIN, permaneça na mesma categoria (verdadeiro / falso), lista de categorias excluídas.
  • get_next_post_sort – Na função get_next_post (que localiza o post após o post exibida no momento), aplicada à cláusula SQL ORDER BY (que normalmente ordena por data de publicação em ordem crescente, com um limite de 1 postagem). Argumentos da função de filtro: cláusula ORDER BY.
  • get_next_post_where – Na função get_next_post (que localiza o post após o post exibida no momento), aplicada à cláusula SQL WHERE (que normalmente procura a próxima publicação publicada com data). Argumentos da função de filtro: cláusula WHERE, permanece na mesma categoria (verdadeiro / falso), lista de categorias excluídas.
  • get_previous_post_join – Na função get_previous_post (que localiza o post antes do post exibida no momento), aplicada à cláusula SQL JOIN (que normalmente se une à tabela de categorias se o usuário estiver visualizando um arquivo de categorias). Argumentos da função de filtro: cláusula de junção, permaneça na mesma categoria (verdadeiro / falso), lista de categorias excluídas.
  • get_previous_post_sort – Na função get_previous_post (que localiza o post antes do post exibida no momento), aplicada à cláusula SQL ORDER BY (que normalmente ordena por data de publicação em ordem descendente, com um limite de 1 postagem). Argumentos da função de filtro: cláusula ORDER BY.
  • get_previous_post_where – Na função get_previous_post (que localiza o post antes do post exibida no momento), aplicada à cláusula SQL WHERE (que normalmente procura a publicação publicada com data anterior). Argumentos da função de filtro: cláusula WHERE, permanece na mesma categoria (verdadeiro / falso), lista de categorias excluídas.
  • gettext – Aplicado ao texto traduzido pela função translation () (chamada por funções como as funções de internacionalização _ () e _e ()). Argumentos da função de filtro: texto traduzido, texto não traduzido e o domínio do texto. É aplicado mesmo se a internacionalização não estiver em vigor ou se o domínio do texto não tiver sido carregado.
  • override_load_textdomain
  • get_meta_sql – Na função WP_Meta_Query :: get_sql (que gera cláusulas SQL a serem anexadas a uma consulta principal para meta consultas avançadas), aplicada à cláusula SQL JOIN e WHERE gerada pela meta consulta avançada. Argumentos da função de filtro: array (compact (‘join’, ‘where’), $ this-> consultas, $ type, $ primary_table, $ primary_id_column, $ context).
  • get_others_drafts – Aplicado à consulta que seleciona os rascunhos dos outros usuários para exibição nos menus do administrador.
  • get_users_drafts – Aplicado à consulta que seleciona os rascunhos dos usuários para exibição nos menus do administrador.
  • locale – Aplicado ao local pela função get_locale.
  • query – Aplicado a todas as consultas (pelo menos todas as consultas são executadas após o carregamento dos plug-ins).
  • query_string – Descontinuado – use query_vars ou solicite.
  • query_vars – Aplicado à lista de variáveis ​​públicas de consulta do WordPress antes que a consulta SQL seja formada. Útil para remover informações adicionais de links permanentes com as quais o plugin lidou de alguma outra maneira.
  • request – Como query_vars, mas aplicado após a adição de variáveis ​​de consulta “extra” e privadas.
  • excerpt_length – Define o tamanho de um trecho de postagem única.
  • excerpt_more – Define a sequência mais no final do trecho.
  • post_edit_form_tag – permite anexar código à tag do formulário no editor de postagem / página padrão.
  • update_user_query – Aplicado à consulta de atualização usada para atualizar as informações do usuário, antes de executar a consulta. uploading_iframe_src (removido desde o WP 2.5) – Aplicado à tag src HTML para o iframe de upload nas telas de edição de postagem e página.
  • xmlrpc_methods – Aplicado à lista de métodos XMLRPC definidos para o servidor XMLRPC.
  • wp_mail_from – Aplicado antes que qualquer email seja enviado pela função wp_mail. O valor fornecido é o calculado a partir do endereço WordPress no nome do host atual (definido por $ _SERVER [‘SERVER_NAME’]). O filtro deve retornar um endereço de email ou combinação de nome / email no formato “usuario@exemplo.com” ou “Nome ” (sem as aspas!).
  • wp_mail_from_name – aplicado antes que qualquer email seja enviado pela função wp_mail. O filtro deve retornar uma string de nome para ser usada como email do nome.
  • update_(meta_type)_metadata – aplicado antes que um metadado seja atualizado. Por exemplo, se os metadados do usuário forem atualizados, o gancho será “update_user_metadata

Widgets

Esses hooks de filtro permitem trabalhar com os widgets incorporados ao núcleo do WordPress.

  • dynamic_sidebar_params – Aplicado aos argumentos passados ​​para a função widgets_init nos widgets do WordPress.
  • widget_archives_dropdown_args – Aplicado aos argumentos passados ​​para a função wp_get_archives() no widget WordPress Archives.
  • widget_categories_args – Aplicado aos argumentos passados ​​à função wp_list_categories() no widget Categorias do WordPress.
  • widget_links_args – Aplicado aos argumentos transmitidos à função wp_list_bookmarks() no widget Links do WordPress.
  • widget_nav_menu_args – Aplicado aos argumentos passados ​​à função wp_nav_menu() no widget WordPress Custom Menu.
  • widget_pages_args – Aplicado aos argumentos transmitidos à função wp_list_pages() no widget Páginas do WordPress.
  • widget_tag_cloud_args – Aplicado aos argumentos passados ​​para a função wp_tag_cloud() no widget Páginas do WordPress.
  • widget_text – Aplicado ao texto do widget do widget de texto do WordPress. Também pode se aplicar a alguns widgets de terceiros.
  • widget_title – Aplicado ao título do widget de qualquer widget WordPress editável pelo usuário. Também pode se aplicar a alguns widgets de terceiros.

Barra de administração

  • wp_admin_bar_class – permite alterar a classe ‘WP_Admin_Bar’ padrão na função _wp_admin_bar_init() em /wp-includes/admin-bar.php.

Conclusão

Os filtros são um conceito fundamental no desenvolvimento do WordPress. Portanto, é essencial entender como eles funcionam e como usá-los, se você estiver interessado em desenvolver seus próprios plugins e temas.

A lista de dicas sobre filtros acima fornece uma visão geral de como codificar e desenvolver filtros com eles, além de uma referência útil para filtros caso você precise encontrar rapidamente o gancho de filtro correto durante a codificação. Você pode encontrar esa lista também na documentação oficial em https://codex.wordpress.org/Plugin_API/Filter_Reference.

Salve este artigos nos seus favoritos e o use como uma referência para seus futuros projetos de desenvolvimento do WordPress!

One comment

  1. Deixo aqui meu agradecimento por esse material excelente.

Deixe uma resposta