Avanzado
Filtros
Hemos incorporado algunos filtros personalizados en AdSanity para ayudar a desarrolladores como usted a ampliar y/o modificar los comportamientos predeterminados. A continuación se muestra una lista de filtros que incluimos en el plugin. El código personalizado se puede colocar en el archivo functions.php de su tema o en un plugin personalizado.
adsanity_ads_posts_columns #
Modifica las columnas que aparecen en el listado de entradas del admin.
adsanity_ads_sortable_posts_columns #
Modifica la lista de columnas ordenables en el listado de entradas del admin.
adsanity_ads_posts_columns_{$column}_value #
Permite establecer el valor que debe mostrarse en una columna determinada. La columna se identifica mediante una clave: {$column}
adsanity_ad_sizes #
Este filtro le permite cambiar los tamaños de anuncio que están disponibles para elegir al crear un bloque de anuncios.
adsanity_ads_posts_sortable_by_{$orderby} #
Permite establecer parámetros de clasificación personalizados
pj_ads_labels #
Le permite cambiar las etiquetas del tipo de entrada personalizada de anuncios.
ads_setup #
Permite modificar cualquiera de los argumentos pasados a la función register_post_type
adsanity_post_class #
Le permite modificar las clases css que envuelven un bloque de anuncios
Acciones
Hemos incorporado algunas acciones personalizadas en AdSanity para ayudar a desarrolladores como usted a ampliar los comportamientos predeterminados. A continuación se muestra una lista de acciones que incluimos en el plugin. El código personalizado se puede colocar en el archivo functions.php de su tema o en un plugin personalizado.
ads_init #
la función ads_init se ejecuta cuando se está configurando el tipo de entrada ads. Puedes usar este hook para registrar taxonomías adicionales, por ejemplo.
adsanity_before_ad_wrapper #
adsanity_before_ad #
adsanity_after_ad #
adsanity_after_ad_wrapper #
adsanity_before_track_click #
adsanity_before_redirect #
Visibilidad de los anuncios
Todas nuestras consultas para anuncios utilizan WP_Query o get_posts()para poder utilizar los hooks del núcleo de WordPress como pre_get_post así como los ganchos enumerados a continuación.
Anuncio aleatorio/Grupo de anuncios #
apply_filters( 'adsanity_hide_ad_group', $group_ids ); - Debe devolver una matriz. $group_ids es una matriz de ID de grupos de anuncios que desea incluir en la visualización de anuncios. Todos los anuncios de los grupos incluidos podrán mostrarse. Se rellena a partir de las selecciones realizadas en un widget, atributos de shortcode, bloque o etiqueta de plantilla.
apply_filters( 'adsanity_hide_ad_in_group', array(), $group_ids ); - Debe devolver un array. La matriz está vacía de forma predeterminada, pero puede añadir ID de publicación de anuncios específicos para excluirlos de la visualización. Estos anuncios no se incluirán intencionadamente en la visualización aunque estén en los grupos de anuncios del filtro anterior.
Anuncio único
apply_filters( 'adsanity_hide_ad', false, $post_id ); - Debe devolver un booleano. Si es verdadero, el anuncio no se mostrará. El booleano es falso por defecto.
Personalización de la visualización de anuncios
Una de las cosas que nos preguntan mucho es cómo evitar la detección de los bloqueadores de anuncios. Aunque hemos explicado otras opciones para respetar las preferencias de visualización de anuncios de los visitantes, entendemos que hay algunos casos en los que no está utilizando AdSanity para la publicidad típica. Tal vez sólo esté usando AdSanity para rastrear vistas y clics en contenido basado en imágenes, por ejemplo. Le proporcionamos un par de métodos para modificar la visualización de anuncios individuales, grupos de anuncios o todos los anuncios.
Estilización de bloques de anuncios
Cada Unidad de Anuncio tiene un número de Clases CSS y un ID HTML único que usted puede apuntar en el CSS de su tema para cambiar su apariencia. El formato de estos son:
ad-{size}(ejemplo:ad-125x125) - Esto le permite dar estilo a todos los anuncios del mismo tamañocolumn-{column number}(ejemplo:column-2) - Aunque sólo es relevante para grupos de anuncios, le permite aplicar estilo a todos los anuncios de una columna determinadaalignleft|aligncenter|alignright|alignnone- Estos cuatro estilos generalmente ya se manejan dentro de la mayoría de los temas, pero si desea aplicar estilos adicionales para manejar mejor la alineación, este es el lugar para hacerlo. Nota: sólo se añadirá una clase a cada bloque de anuncios.
Si todas esas clases no se adaptan a sus necesidades o desea cambiarlas, puede adjuntar clases adicionales a cada Ad Unit utilizando un filtro como se describe a continuación.
Mostrar ganchos relacionados #
Hay algunas acciones y filtros relacionados con la visualización integrados en nuestro sistema de plantillas. Estos le permiten filtrar clases CSS y añadir marcas alrededor del bloque de anuncios para que pueda darle estilo.
Filtros
Acciones
Plantillas temáticas #
A veces necesitas tener más control sobre el marcado de tus anuncios. Hemos ampliado la jerarquía de plantillas de WordPress Core para que pueda personalizar completamente el marcado de un anuncio a través de una plantilla de tema.
Si desea cambiar el marcado de todos los anuncios, simplemente copie el archivo ad.php del archivo theme-templates en tu tema y personalízalo.
Si desea modificar el marcado para todos los anuncios de un tamaño determinado, puede cambiar el nombre de ese archivo a algo como ad-125x125.php, donde 125x125 es el tamaño que está intentando modificar. Nota: puede encontrar el tamaño mirando las clases que se aplican al anuncio en el marcado.
Por último, si desea cambiar el marcado de un anuncio en particular, puede cambiar el nombre del archivo a ad-1234.php, donde 1234 es el ID del anuncio que desea modificar. Nota: puede encontrar el ID mirando el ID HTML que se aplica al anuncio en el marcado.