¿Qué son los filtros en WordPress? ¿Cómo utilizar add_filter de WordPress?

¿Qué son los filtros de WordPress?

Un filtro de WordPress es un gancho que modifica los datos antes de que se devuelvan a la base de datos y se muestren al usuario. Como resultado, puede personalizar la funcionalidad de un plugin, tema o sitio web sin tener que cambiar los archivos principales de WordPress. Por ejemplo, añadiendo notas a pie de página a todas las entradas del sitio o cambiando la longitud de sus extractos. Hay cuatro funciones de gancho de filtro comunes - add_filter, remove_filter, has_filter y doing_filter.

Cómo funcionan los filtros de WordPress

Los filtros interceptan los datos pasados por WordPress. Los modifican de acuerdo con la funcionalidad dada y los muestran al navegador web del usuario. Para ayudarle a entender, eche un vistazo al siguiente fragmento de código:

// Especifica el filtro y la función callback
   add_filter( 'example_filter', 'example_callback' ); // Definir la función callback.
   // Definir la función callback
   function ejemplo_callback( 1TP4Ejemplo ) {
      // altera $example concatenando sobre él
      1TP4Ejemplo . ' añade un texto al final '; return $example; $example .
      return $example; }
   }

A continuación se explica el ejemplo:

1. hacer uso deañadir_filtroestablece un filtro que modificará los datos. En nuestro ejemplo, el nombre del filtro esfiltro_ejemplo.
2. Defina la función callback que WordPress ejecutará cuando encuentre un filtro, por ejemploejemplo_callback.
3. Especifica cómo la función de devolución de llamada modificará el campo1TP4EjemploLos datos indicados por el parámetro. En el fragmento, utilizaremos un punto final para conectarlo a la frase del final.
4. hacer uso dedevuelvamuestra los datos modificados en el navegador web del usuario.

Para aplicar el gancho de filtro a su sitio de WordPress, escriba el código en el tema actualmente activo defunciones.phpDocumentación.

Se recomienda añadir el código a la secciónsubtema(utilizado como expresión nominal)papelesen la carpeta raíz del tema para evitar que el código se pierda tras una actualización del tema. Como alternativa, cree un archivo independiente en la carpeta raíz del tema para guardar los ganchos de filtro y llámelo en el archivo functions.php. Esto organizará mejor el código y garantizará que no se pierda al actualizar el tema.

include _once( get_template_directory(), '/nombre_de_tu_plantilla.php':'

Si no tiene acceso a la carpeta raíz del tema, instale el plugin para añadir código personalizado directamente desde el panel de administración de WordPress. Existen plugins para esta tareaFragmentos de código.

Atención:modificacionesfunciones.phppuede provocar un error o que el sitio quede inaccesible. Para evitarlo, antes de continuarCrear una copia de seguridad.

Parámetros de add_filter de WordPress

WordPress añadir_filtroLa función tiene cuatro argumentos. Cada uno de ellos se muestra a continuación:

• nombre del gancho. La función de devolución de llamada que desea enganchar a la función Nombre del filtro.
• función callback. La función de devolución de llamada que se ejecutará cuando se aplique el filtro.
• Prioridades. Parámetro opcional que especifica el orden de ejecución de las funciones asociadas al filtro. El valor por defecto es10(matem.) género Cuanto menor sea el número, antes se aplicará.
• Argumentos aceptados. El número de argumentos a pasar a la función hook. Este parámetro es opcional y el valor por defecto es1.

La sintaxis de la función y los argumentos es la siguiente:

add_filter( hook_name, callback_function, priority=1,
   argumentos_aceptados=1);

Ejemplo de add_filter en WordPress cambiando la longitud del extracto de un post de WordPress:

function custom_excerpt_length( $length ) {
    return 20; // cambia el número aquí para ajustar la longitud del extracto
}
add_filter( 'excerpt_length', 'custom_excerpt_length', 999 );

En este ejemplo, creamos una función personalizada llamada custom_excerpt_length que acepta un único parámetro, $length, que indica la longitud del extracto. A continuación, pasamos esta función como argumento a la función add_filter, especificando el nombre del filtro (excerpt_length) y el nombre de nuestra función personalizada. El último parámetro 999 indica la prioridad, y aquí la fijamos en un valor más alto para asegurarnos de que nuestro filtro se aplica en último lugar.

Mostrar imágenes para categorías de entradas específicas

Los ganchos de filtro de WordPress permiten personalizar entradas con IDs o categorías específicas. En el fragmento de código siguiente, hemos añadido un icono para cada entrada que pertenece a una categoría premium:

add_filter( 'the_content', 'add_disclaimer' );
   function add_disclaimer( $content )
   {
      // concatena el contenido para modificarlo
      return $content .
      "<br><center><strong>Todos los escritos y opiniones son míos".
   }

En el ejemplo, hemos creado elel_contenidoy conéctelo alwpb_content_filterGancho de función de devolución de llamada. Esta función especifica las condiciones en las que se aplica el filtro.

En este caso, si el El puesto pertenece aalto nivella función de filtro cambiará el contenido añadiéndole imágenes.

Cambiar el número de productos mostrados

Los filtros también te permiten modificar el plugin eCommerce para personalizar tu tienda online. Por ejemplo, el siguiente código de personalización cambia el número de productos mostrados en el plugin WooCommerce:

add_filter('storefront_products_per_page','alter_sf_products_per_page' );
   function alter_sf_products_per_page()
   function alter_sf_products_per_page()
      // cambiar el valor por defecto
      function alter_sf_products_per_page() { // cambiar el valor por defecto.
   }

En el fragmento de código, creamos el archivotienda_productos_por_paginaFiltros personalizados conalter_sf_products_per_pagegancho de función. Cuando los datos pasen a través de él, el filtro llamará a esta función para eliminar el valor predeterminado del campo12cambiar a3y mostrarlo en el navegador del usuario.

Otros filtros populares de WordPress

Además de add_filterAdemás, existen otras funciones que los desarrolladores pueden utilizar con los ganchos de filtro.

Borrar filtro ()

Esta función elimina funciones que están enganchadas a un filtro específico. Los desarrolladores web suelen utilizarla para eliminar funciones predeterminadas de WordPress sin tener que eliminar el código por completo. La sintaxis es la siguiente:

remove_filter( hook_name, callback_function, priority = 10 );

Ejecutar filtro()

Esta función comprueba si se está ejecutando otra función. Toma el nombre del gancho como argumento y devuelveverdaderotal vezfalsoValor de retorno. El código es el siguiente:

if doing_filter( 'nombre_gancho' )
{
// ejecuta un script si el filtro se está ejecutando
}

Sí_Filtro()

La función has_filter verifica que el filtro se ha aplicado correctamente al gancho. Toma el nombre del filtro como primer argumento y la función de devolución de llamada como segundo argumento opcional.

Para buscar una función específica, debe incluirse el segundo parámetro. De lo contrario, devolveráverdaderopara indicar que cualquier función está enganchada al filtro. El código de esta función es el siguiente:

has_filter( 'hook_name', 'callback_function' );

Resumen:

Un filtro es un hook de WordPress que se utiliza para modificar datos antes de que se muestren en un sitio web. Los desarrolladores web lo utilizan para personalizar plugins o temas con el fin de añadir funcionalidades adicionales a sus sitios web.

Los ganchos de filtro interceptarán los datos pasados por WordPress, los cambiarán según sus necesidades y los mostrarán al navegador del visitante. Para configurar un filtro, añada el gancho de filtro al elementoEscriba add_filter en el archivo functions.php.con el nombre del gancho y la función callback como argumentos.

Algunos ejemplos de uso de los ganchos de filtro son cambiar la longitud de los extractos de los artículos y añadir renuncias a las entradas de los sitios web. Además deañadir_filtroAparte de eso, sus otras funciones incluyeneliminar_filtroyhacer_filtroresponder cantandotiene_filtro.

Contacte con nosotros
¿No puede leer el tutorial? Póngase en contacto con nosotros para obtener una respuesta gratuita. Ayuda gratuita para sitios personales y de pequeñas empresas	Servicio de atención al cliente WeChat
① Tel: 020-2206-9892
② QQ咨询：1025174874
(iii) Correo electrónico: info@361sale.com
④ Horario de trabajo: de lunes a viernes, de 9:30 a 18:30, días festivos libres