Introduction

Le système publicitaire natif de XenForo est reconnu depuis longtemps pour ses performances optimales, grâce à son mécanisme de compilation ; il demeure toutefois assez limité en ce qui concerne l’expérience pratique de gestions :



Absence d’interface de gestion des bannières :
Les administrateurs sont contraints de rédiger manuellement des balises HTML <img> et <a>, et de trouver un hébergement externe pour les images.

Absence de planification automatisée :
Pour les contrats publicitaires mensuels ou trimestriels, les administrateurs doivent assurer un suivi du calendrier et activer ou désactiver manuellement les publicités à leur expiration.

Manque de flexibilité dans le filtrage au niveau des pages :
Il est impossible de restreindre l’affichage des publicités à des pages spécifiques, telles que les fils de discussion individuels (`thread_view`) ou les pages de catégories/forums (`forum_view`).

Absence de balises conteneurs standardisées :
L’absence de classes CSS et d’attributs de données (« data attributes ») spécifiques rend difficile la personnalisation de la mise en page ainsi que le suivi des impressions et des clics publicitaires (analyses).

[VNXF] Advertising Plus a été conçu pour remédier de manière exhaustive à toutes les lacunes mentionnées précédemment. Ce module transforme le gestionnaire de publicités de XenForo 2.3+ en un outil professionnel, moderne et intuitif, tout en respectant scrupuleusement la philosophie fondamentale de XenForo axée sur la haute performance: chaque condition temporelle, filtre de modèle (template) et extrait de code publicitaire est compilé directement dans le cache du modèle maître _ads Ainsi, aucune requête supplémentaire vers la base de données n'est générée lors de la navigation des utilisateurs sur le forum.

Fonctionnalités clés

1. Importation de bannières visuelles et ajout de liens

• Choisissez entre l'utilisation de code HTML/script classique ou un format basé sur une image et un lien.
• Intégration avec le bouton natif "Importer une ressource (Upload Asset) de XenForo : importez vos images directement dans le répertoire sécurisé `data/assets/advertising/`, ou indiquez simplement l'URL de l'image.
• Prise en charge d'images dédiées aux mobiles (pour les appareils ≤ 768 px) : génération automatique des balises `<picture>` et `<source media="...">`, garantissant un affichage parfaitement adaptatif (*responsive*).
• Options disponibles : définition de l'URL de destination, ajout d'un texte alternatif (alt text) optimisé pour le référencement (SEO), ouverture des liens dans un nouvel onglet (target="_blank), et intégration d'attributs de protection SEO tels que `rel="nofollow sponsored".

2. Planification des campagnes (date/heure de début et de fin)

• Inclut un sélecteur de date et d'heure pour définir les moments de début et de fin.
• S'aligne automatiquement sur le fuseau horaire configuré dans le système du forum.
• Activation et désactivation des publicités entièrement automatisées — avec une précision à la seconde près — grâce à la variable système `$xf.time`. Aucune tâche planifiée (Cron Job) n'est requise ; aucune consommation supplémentaire de ressources serveur.
• Indicateurs d'état visuels dans la liste d'administration : `[En attente]`, `[Actif]` et `[Expiré]`.

3. Filtrage des pages par modèle (= ou !=)

Contrôlez précisément l'affichage du contenu en fonction de modèles d'interface spécifiques :

• Tous : Affichage sur toutes les pages (par défaut).
• Afficher uniquement (=) : Affichage limité aux pages sélectionnées (par ex. : afficher uniquement sur la page `thread_view`).
• Exclure (!=) : Masquage sur des pages spécifiques (par ex. : masquer sur les pages `member_view` ou `conversation_view`).
• Il est possible de saisir une liste de modèles, séparés par des virgules ou des sauts de ligne.

4. Enveloppe DOM et suivi analytique

Chaque publicité est automatiquement encapsulée dans un élément
<div> doté d'un ensemble complet d'identifiants :
Permet l'ajout de classes CSS personnalisées (par exemple, pour le centrage, les ombres portées, le positionnement fixe, etc.).
Simplifie l'intégration avec Google Analytics et Google Tag Manager, et facilite l'ajout de CSS personnalisé via `extra.less`.

Guide d'utilisation détaillé

Étape 1 : Accéder au gestionnaire de publicités

1. Connectez-vous au *panneau d'administration* (Admin CP).
2. Dans le menu de navigation situé à gauche, accédez à *Configuration → Publicités* (ou rendez-vous à l'adresse `admin.php?advertising/`).
3. Cliquez sur le bouton **Ajouter une publicité** dans le coin supérieur droit.

Étape 2 : Configurer les paramètres généraux1

1. Titre : Saisissez un nom unique pour la publicité (par ex. : Bannière d'en-tête - Entreprise ABC`).
2. Emplacement : Sélectionnez l'endroit où la publicité doit s'afficher sur l'interface du forum (par ex. : `En-tête du conteneur`, `Affichage du sujet : Au-dessus des messages`, `Liste des forums : En dessous des nœuds`, etc.).
3. Ordre d'affichage :** Saisissez un numéro de priorité si plusieurs publicités sont présentes au même emplacement.
4. Actif : Cochez cette case pour activer la publicité.

Étape 3 : Configuration du format du contenuL'extension propose 2 modes :

Option A :

Bannière (image) et lien (recommandé)

1. Dans la section *Format de l'annonce*, sélectionnez Bannière (image) et lien (Importer un fichier / URL)*.

2. Bannière (ordinateur) :
- Cliquez sur le bouton *Importer* pour sélectionner un fichier image depuis votre ordinateur et le téléverser directement dans le répertoire des ressources du forum.Vous pouvez également coller l'URL de l'image si celle-ci est hébergée sur un CDN ou un serveur externe.

3. Bannière pour mobile (facultatif) :
- Si vous disposez d'une bannière conçue spécifiquement pour les appareils mobiles (par exemple, au format carré ou avec un ratio différent), cliquez sur *Importer* ici. - Lorsqu'un visiteur accède au site depuis un appareil dont la largeur d'écran est inférieure ou égale à `768 px`, le système affichera automatiquement cette bannière.

4. Lien de destination (URL) :
Saisissez l'adresse du site web vers laquelle les utilisateurs seront redirigés lorsqu'ils cliqueront sur la bannière (par exemple : `https://doitac.com/khuyen-mai`).

5. Texte alternatif (Alt Text) :
Saisissez une description de l'image pour améliorer le référencement (SEO) ou pour qu'elle s'affiche si l'image ne parvient pas à se charger.

6. Options du lien :
☑ Ouvrir dans un nouvel onglet :
Ajoute l'attribut `target="_blank` afin que les utilisateurs ne quittent pas le forum.
☑ Ajouter l'attribut « nofollow » : Applique automatiquement `rel="nofollow sponsored noopener"` pour se conformer aux normes de référencement (SEO) de Google concernant les liens publicitaires.

Méthode B : Annonces basées sur du code HTML/script

1. Sélectionnez Code HTML/JavaScript/Script.
2. Collez le code d’intégration publicitaire fourni par des tiers (Google AdSense, MGID, scripts partenaires, etc.).

Étape 4 :
- Définir le calendrier de la campagne (facultatif)Développez la section Paramètres avancés (Calendrier, modèle et CSS) :

1. Heure de début :
- Sélectionnez la date de mise en ligne de la publicité. - Saisissez l'heure de début (par ex. `08:00`). Si ce champ est laissé vide, la publicité sera diffusée immédiatement.

2. Heure de fin :
- Sélectionnez la date de fin du contrat publicitaire. - Saisissez l'heure de fin (par ex. `23:59`). - À ce moment précis, la bannière *disparaîtra automatiquement* de l'interface publique, sans nécessiter aucune intervention manuelle de la part d'un administrateur.

Étape 5 : Ciblage par modèles (templates)
1. Toutes les pages :
La publicité s'affichera sur toute page contenant l'emplacement d'affichage sélectionné.

2. Afficher uniquement sur les modèles spécifiés (=) :
- Sélectionnez cette option et saisissez les noms des modèles souhaités dans la zone de texte ci-dessous. - Exemple : Saisissez `thread_view, forum_view` si vous souhaitez que la publicité ne s'affiche que lors de la consultation d'un sujet (fil de discussion) ou d'une catégorie de forum.

3. Ne pas afficher sur les modèles spécifiés (!=) :
- Sélectionnez cette option et saisissez les noms des modèles que vous souhaitez exclure. - Exemple : Saisissez `member_view, conversation_view, account_details` pour masquer la publicité sur les pages de profil utilisateur et dans les conversations privées.

Astuce pour trouver les noms des modèles (templates) :

Pour identifier le modèle utilisé par la page actuelle, vous pouvez consulter le code source (HTML) du site web et rechercher la balise :
<html ... data-template="nom_du_modèle">
Voici quelques modèles courants :`forum_list`
Page d'accueil du forum> - `forum_view`
Page listant les sujets (fils de discussion) au sein d'une catégorie> - `thread_view`
Page permettant de consulter le contenu d'un sujet> - `whats_new` Page Nouveautés (messages/activités récents)

Étape 6 : Personnalisation CSS et suivi:

1.Classes CSS supplémentaires :
Saisissez les classes personnalisées souhaitées dans le champ `wrapper_class` si nécessaire (par ex. `my-sticky-ad text-center`).

2. Personnalisation CSS dans `extra.less` :
Lorsqu'une publicité est affichée, elle intègre des classes et des attributs de données (data-attributes) spécifiques, ce qui facilite l'ajout de code CSS personnalisé dans le modèle extra.less :
3. Mesure des événements (Google Tag Manager / Google Analytics) :
Vous pouvez créer un déclencheur de type « Clic » dans Google Tag Manager en utilisant le sélecteur CSS suivant :
div[data-ad-position="container_header"] afin de suivre précisément les clics pour chaque partenaire.

Installation et mises à jour :

Installation via l'interface en ligne de commande (CLI) (recommandé)

Installation via le panneau d'administration (Admin CP)

1. Téléchargez le fichier "VNXF-AdvertisingPlus-1.0.0.zip"
2. Accédez à Admin CP → Add-ons → Install/upgrade from archive (Panneau d'administration → Add-ons → Installer/mettre à jour depuis une archive).
3. Sélectionnez le fichier zip et procédez à l'installation automatique.

Désinstaller :

Le processus de désinstallation supprimera en toute sécurité les 12 colonnes étendues de la base de données et recompilera automatiquement le modèle `_ads` pour le rétablir dans son état d'origine.

Compatibilité :

XenForo : 2.3.0 ou version ultérieure (testé et vérifié sur XenForo 2.3.11).
PHP : 8.0, 8.1, 8.2, 8.3+.
Rétrocompatibilité :100 % compatible avec les publicités HTML existantes et déjà configurées dans XenForo.

Auteur :
Développé et pris en charge par la communauté [VNXF - Vietnamese XenForo Forum] (https://vnxf.vn/).

Télécharger V1.0.0 :