Avancé
Filtres #
Nous avons intégré quelques filtres personnalisés dans AdSanity pour aider les développeurs comme vous à étendre et/ou modifier les comportements par défaut. Vous trouverez ci-dessous une liste des filtres que nous incluons dans le plugin. Le code personnalisé peut être placé dans le fichier functions.php de votre thème ou dans un plugin personnalisé.
adsanity_ads_posts_columns ##
Modifie les colonnes listées dans la liste des articles sur l'admin.
adsanity_ads_sortable_posts_columns #.
Modifie la liste des colonnes triables dans la liste des articles de l'administration.
adsanity_ads_posts_columns_{$column}_value ##.
Permet de définir la valeur qui doit être affichée dans une colonne particulière. La colonne est identifiée par une clé : {$column}
adsanity_ad_sizes #
Ce filtre vous permet de modifier les tailles d'annonces que vous pouvez choisir lors de la création d'une unité publicitaire.
adsanity_ads_posts_sortable_by_{$orderby} #
Permet de définir des paramètres de tri personnalisés
pj_ads_labels #
Permet de modifier les libellés du type de message personnalisé Annonces.
ads_setup
Permet de modifier l'un des arguments passés à la fonction register_post_type
adsanity_post_class #
Vous pouvez modifier les classes CSS qui entourent une unité publicitaire.
Actions #
Nous avons intégré quelques actions personnalisées dans AdSanity pour aider les développeurs comme vous à étendre les comportements par défaut. Vous trouverez ci-dessous une liste des actions que nous incluons dans le plugin. Le code personnalisé peut être placé dans le fichier functions.php de votre thème ou dans un plugin personnalisé.
ads_init #
La fonction ads_init s'exécute lorsque le type de message publicitaire est configuré. Vous pouvez utiliser ce crochet pour enregistrer des taxonomies supplémentaires, par exemple.
adsanity_before_ad_wrapper #
adsanity_before_ad #
adsanity_after_ad #
adsanity_after_ad_wrapper #
adsanity_before_track_click #
adsanity_before_redirect #
Visibilité de la publicité #
Toutes nos requêtes pour les annonces utilisent WP_Query ou get_posts()afin que vous puissiez utiliser les crochets du noyau de WordPress tels que pre_get_post ainsi que les crochets énumérés ci-dessous.
Random Ad/Ad Group #
apply_filters( 'adsanity_hide_ad_group', $group_ids ); - Doit retourner un tableau. $group_ids est un tableau d'identifiants de groupes de publicités que vous souhaitez inclure dans l'affichage de la publicité. Toutes les publicités des groupes inclus pourront être affichées. Ce tableau est rempli à partir des sélections effectuées dans un widget, des attributs de code court, un bloc ou une balise de modèle.
apply_filters( 'adsanity_hide_ad_in_group', array(), $group_ids ); - Doit retourner un tableau. Le tableau est vide par défaut, mais vous pouvez ajouter des ID d'affichage publicitaire spécifiques à exclure de l'affichage. Ces publicités ne seront volontairement pas incluses dans l'affichage, même si elles se trouvent dans les groupes de publicités du filtre ci-dessus.
Annonce unique
apply_filters( 'adsanity_hide_ad', false, $post_id ); - Doit retourner un booléen. S'il est vrai, l'annonce ne s'affichera pas. Le booléen est faux par défaut.
Personnalisation de l'affichage des annonces
L'une des questions qui nous est souvent posée est de savoir comment éviter la détection des bloqueurs de publicité. Bien que nous ayons expliqué d'autres options pour respecter les préférences d'affichage publicitaire de ces visiteurs, nous comprenons que dans certains cas, vous n'utilisez pas AdSanity pour de la publicité classique. Peut-être utilisez-vous simplement AdSanity pour suivre les vues et les clics sur le contenu basé sur l'image, par exemple. Nous vous proposons plusieurs méthodes pour modifier l'affichage de publicités individuelles, de groupes de publicités ou de toutes les publicités.
Styling Ad Units #
Chaque unité publicitaire possède un certain nombre de classes CSS et un ID HTML unique que vous pouvez cibler dans le CSS de votre thème pour modifier son apparence. Leur format est le suivant :
ad-{size}(exemple :ad-125x125) - Cela vous permet de mettre en forme toutes les annonces de la même taille.column-{column number}(exemple :column-2) - Bien qu'elle ne s'applique qu'aux groupes d'annonces, cette option vous permet de donner un style à toutes les annonces d'une colonne particulière.alignleft|aligncenter|alignright|alignnone- Ces quatre styles sont généralement déjà gérés dans la plupart des thèmes, mais si vous souhaitez appliquer des styles supplémentaires pour mieux gérer l'alignement, c'est ici que vous devez le faire. Remarque : une seule classe sera ajoutée à chaque unité publicitaire.
Si toutes ces classes ne répondent pas à vos besoins ou si vous souhaitez les modifier, vous pouvez attacher des classes supplémentaires à chaque unité publicitaire à l'aide d'un filtre, comme décrit ci-dessous.
Afficher les crochets relatifs à l'affichage
Quelques actions et filtres liés à l'affichage sont intégrés à notre système de création de modèles. Ils vous permettent de filtrer les classes CSS et d'ajouter des balises autour de l'unité publicitaire afin de pouvoir la styliser.
Filtres
Actions
Modèles de thèmes
Parfois, vous avez besoin d'avoir plus de contrôle sur le balisage de vos annonces. Nous avons étendu la hiérarchie des modèles de WordPress Core pour vous permettre de personnaliser entièrement le balisage d'une annonce par le biais d'un modèle de thème.
Si vous souhaitez modifier le balisage de toutes les annonces, il vous suffit de copier l'élément suivant ad.php à partir du fichier theme-templates dans votre thème et personnalisez-le.
Si vous voulez modifier le balisage de toutes les annonces d'une taille particulière, vous pouvez renommer ce fichier en quelque chose comme ad-125x125.php, où 125x125 est la taille que vous essayez de modifier. Remarque : vous pouvez trouver la taille en regardant les classes qui sont appliquées à l'annonce dans le balisage.
Enfin, si vous souhaitez modifier le balisage d'une annonce particulière, vous pouvez renommer le fichier en ad-1234.php où 1234 est l'ID de l'annonce que vous souhaitez modifier. Remarque : vous pouvez trouver l'ID en regardant l'ID HTML qui est appliqué à l'annonce dans le balisage.