Installation
Installation automatique
Le plugin est disponible dans le fil RSS de chargement automatique de Spip-Contrib (onglet ’Ajouter des plugins’ de la page de gestion des plugins de l’espace privé).
Installation manuelle
Si vous préférez une installation manuelle, suivez les étapes suivantes :
- Téléchargez l’archive ’.zip’ de cette page vers le dossier de plugins de votre SPIP
- Installez le plugin depuis votre espace privé comme expliqué ici : http://www.spip.net/fr_article3396.html.
Pré-requis
Pour une raison pratique, PUB BANNER nécessite d’avoir installé au préalable le plugin ’SPIP Bonux’ en version 1.3 au minimum.
Notes
- L’organisation du plugin a pris un tournant décisif pour sa version 1.25 (version des tables 0.8), notamment concernant les noms des tables en base de données. Pour plus d’information, voyez la note de version 1.24.
Fonctionnement/Utilisation
Lorsqu’il qu’il est activé, le plugin fait apparaître deux nouveaux boutons dans le bandeau de navigation de l’espace privé :
- « Bannières publicitaires » dans le sous-menu « Edition »,
- « Statistiques des publicités » dans le sous-menu « Statistiques ».
Ces bannières s’intègrent dans vos squelettes en indiquant simplement la balise :
#PUBBAN{banner_id}
Attention, l’option passée à la balise est bien l’entrée « banner_id » de la bannière, il est donc conseillé de définir cette valeur de façon simple et sans ambigüité (elle sera corrigée par le plugin le cas échéant) [1].
La balise est remplacée par une frame de la taille de la bannière dont les publicités sont choisies au hasard parmi celles affichables. Lors d’un clic sur une pub, la fenêtre courante ou une nouvelle fenêtre s’ouvre vers l’URL configurée (propre à chaque publicité).
Valeurs par défaut à l’installation
Des valeurs par défaut sont entrées dans les tables à l’installation, à savoir :
- les quatre emplacements ’type’ les plus répandus sur le web :
- skyscraper : la longue bannière verticale, de 160 ou 180 sur 600 pixels,
- leaderboard : la longue bannière horizontale, de 728 sur 90 pixels,
- banner : la bannière horizontale ’standard’, de 468 sur 60 pixels,
- cube : le carré, de 250 sur 250 pixels, emplacement privilégié pour les encarts flash,
- cinq exemples d’encart publicitaires, un pour chaque emplacement, deux pour la ’banner’, avec divers options quand à la limite d’affichage (nombre d’affichages, de clics et dates encadrantes).
Les publicités proposées pour les tests sont construites autour du fameux écureuil SPIP [2].
Statistiques
Comme précisé plus haut, des statistiques sont enregistrées pour analyse. Elles sont présentées sous forme de graphes permettant d’étudier d’une part le nombre d’affichages de chaque bannière, d’autre part le nombre de clics sur celles-ci. Un suivi d’évolution dans le temps est également proposé (cf. portfolio).
Des tableaux récapitulatifs sont également disponibles et exportables au format CSV.
Accessibilité
Les clics sur les bannières affichées en pages publiques ouvrent par défaut un nouvel onglet ou une nouvelle fenêtre de navigateur sans javascript [3]. Ces fenêtre ne sont donc pas bloquées par les réglages du navigateur, il s’agit simplement de liens avec l’attribut « target=blank », accessibles en toute circonstance.
Vous pouvez forcer l’utilisation d’une fonction Javascript en définissant la constante PUBBAN_FORCE_JAVASCRIPT
sur 1
dans le fichier pubban_options.php
.
Personnalisation CSS
Chaque frame présentant une bannière est contenue dans une div
portant une classe nommée « pubban banniere_XX » où ’XX’ est le banner_id
de la bannière concernée. Cela vous permet de personnaliser les styles des bannières de façon discriminante dans vos propres feuilles de style.
(in) Compatibilités
Le plugin est prévu pour s’intégrer dans tout type de squelette SPIP et notamment dans les squelettes Z (Le Squelette Zpip). Il est également compatible avec le plugin « Bandeau » : une navigation améliorée dans le privé depuis sa version 1.28.
Tous les squelettes utilisés par le plugin sont construits pour être autonomes et affichables dans toute situation. Cependant, lorsque vous utilisez le switcher de thèmes de SPIP Zen Garden, une erreur Javascript est renvoyée car la bibliothèque jQuery n’est pas chargée dans les frames présentant les encarts publicitaires ... Pas d’inquiétude, cette erreur ne pose aucun problème quant à l’affichage des bannières.
Aspects techniques
Le plugin créé deux nouveaux types d’objets SPIP : les bannières publicitaires et les publicités en elles-mêmes, correspondant aux images ou objets visibles sur les pages. Chaque publicité peut être attribuée à une ou plusieurs bannières et son affichage peut être limité par trois variables :
- le nombre d’affichages,
- le nombre de clics,
- un intervalle de dates de validité.
Lorsqu’une publicité ne doit plus être affichée, elle est tout de même conservée en base et peut être récupérée pour une nouvelle campagne.
Deux nouvelles boucles apparaissent donc avec ce plugin : les boucles « BANNIERES » et « PUBLICITES », au sein desquelles vous pouvez utiliser les deux identifiants « id_publicite » pour la publicité et « id_banniere » pour la bannière (très original ...).
Comme tous les objets de SPIP, vous devez d’abord créer une pub ou une bannière puis l’activer pour qu’elle soit effectivement visible ... Cela permet par exemple de créer une pub puis de la modifier avant une mise en ligne définitive. Vous pouvez bien entendu visualiser un exemple de chaque pub même si elle est désactivée.
La mécanique PHP
J’ai tenté d’inclure au plugin un certain nombre de vérifications de sécurité. Par exemple, le système vous préviendra si vous créez une pub qui redirige vers une URL qui n’existe pas. Ces vérifications inscrivent un message d’erreur à l’écran mais proposent de forcer leur validation par une nouvelle soumission du formulaire.
Les modifications sur la base
Le plugin ajoute quatre nouvelles tables à SPIP :
- ’spip_bannieres’ : la table des bannières,
- ’spip_publicites’ : la table des encarts publicitaires,
- ’spip_publicites_bannieres’ : une table de jointure bannière/publicités,
- ’spip_pubban_stats’ : une table retenant les statistiques des encarts (nombres de clics, d’affichages ...).
Lors de la désinstallation du plugin, un mécanisme de sécurité interdit l’effacement des tables si celles-ci ne sont pas vides ... Vous pouvez forcer cet effacement, notamment en phase de tests, en définissant la constante PUBBAN_FORCE_UNINSTALL
sur 1
dans le fichier « pubban_options.php ».
Notes de version
Le plugin a été largement revu entre les versions 1.23 et 1.24. Les tables de la base ont notamment été renommées, afin, comme indiqué plus haut, de s’intégrer plus naturellement dans la nomenclature de SPIP.
Un mécanisme automatique de mise à jour est prévu dans le plugin. Cette migration devrait donc être invisible si vous passez d’une version antérieure à 1.24 vers une version supérieure, mais il est possible, pour plusieurs raisons (notamment si vous utilisez un préfixe de tables personnalisé) que cette migration vous fasse perdre vos données.
Si vous rencontrez des problèmes lors de cette migration, voici les étapes à suivre pour l’effectuer manuellement :
- désactivez le plugin dans sa version supérieure ou égale à 1.24 sans le désinstaller,
- effacez manuellement les nouvelles tables de votre base de données, à savoir (avec
PREFIX
votre préfixe de tables, par défaut ’spip’) :- ’
PREFIX_publicites
’ - ’
PREFIX_bannieres
’ - ’
PREFIX_bannieres_publicites
’
- ’
- recherchez dans la table ’
PREFIX_meta
’ le méta ayant pour nom ’pubban_base_version
’ et modifiez sa valeur pour qu’elle soit inférieure à0.8
, - renommez manuellement les tables de la façon suivante :
- ’
PREFIX_pubban_publicites
’ vers ’PREFIX_publicites
’ - ’
PREFIX_pubban_emplacements
’ vers ’PREFIX_bannieres
’ - ’
PREFIX_pubban_pub_empl
’ vers ’PREFIX_bannieres_publicites
’
- ’
- installez le plugin en version supérieure ou égale à 1.24 de façon classique.
Et le tour est joué !
À côté / Pistes d’évolution
« TODOS »
- uniformiser avec les tables SPIP
- permettre de suivre les statistiques pour les pubs et plus seulement les bannières
Achat d’encarts
Le code du plugin est prévu pour permettre de proposer d’acheter des emplacements (des tranches de prix sont configurées). Cette fonctionnalité fera probablement l’objet d’un nouveau plugin ...
Discussions par date d’activité
45 discussions
Bonjour,
Je me suis penché sur la gestion des médias, en attendant, la gestion par le plugin :
J’ai donc modifier deux trois truc pour utilisé la médiathèque :
Dans ’prive/squelettes/navigation/publicite_edit.html’ :
a la fin du fichier :
Dans ’formulaires/editer_publicite.php’ :
l84 ajoutez :
l112 après
ajoutez :
Et enfin dans l’admin : ’ecrire/ ?exec=configurer_contenu’
- >Documents joints
- >Cochez ’Publicités’ pour autoriser l’ajout de doc au pub.
Voila maintenant sur la fiche d’édition de la pub a gauche vous avez le boite de doc comme d’habitude copier le code du doc genre « » ou « » ou encore « » ou ....
et lors de la validation du formulaire la première occurrence de d’un modèle est transformé en son lien.
C’est barbare(un peu) mais ça fonctionne !
Cordialement,
Alexandre
a oui l’idéal serait de modifier le ’name’ du textarea en ’texte’ à la place de objet pour bénéficier du dblclic pour l’insertion. mais bon je ne veux pas modifier l’existant du plugin.
Salut Alex,
Merci beaucoup pour tous ces retours et ta plongée dans le code !!
J’ai ajouté au plugin les deux fonctionnalités : la correction sur le datepicker (parfait !) et la gestion des documents que j’ai un peu peaufiné.
Version 1.30.2 pour info
Merci encore pour ton retour, sacré boulot ! ;)
P.
Répondre à ce message
Bonjour,
Merci pour ton travail autour de ce plugin.
Mon petit souci : J’ai paramétré ( correctement, il me semble) une publicité entre 2 dates,
Cela fonctionne le jour même, mais le jour suivant, il(la gestion du plugin ?) me la change de « active » en « obsolète » !
Il me laisse alors un espace blanc à la place du bandeau dans sa partie publique.
Je te joins une copie d’écran de la partie privée.
Je suis en spip 3.0 et la version du plugin 1.30
Merci pour ce plugin et pour ton aide.
Bonjour,
Merci pour ce plugin bien pratique.
J’ai le même soucis que Alain.
Re-Bonjour,
J’ai trouvé le problème il s’agit d’un problème de format de date le plugin travail sur des dates de début et fin au format ’yy-mm-dd’, mais le plugin jquery datepicker à un format par defaut en ’dd/mm/yy’.
Donc lors de la tache cron impossible de faire la comparaison correct pour verifier si la pub est périmé ou non.
Donc je propose tous simplement d’altérer le format du datepicker pour le formulaire editer_publicite.html et inserer à la toute fin de se fichier :
Et voila le format sera le bon.
Cordialement,
Alexandre
Répondre à ce message
Suggestion : ce plugin a l’air de promettre plein de bonnes choses. Il ne gère cependant pas le rafraichissement d’un bandeau après X secondes.
Intégrer la fonctionnalité d’un rafraichissement permettrait de gérer sa régie en interne, sans outil tiers.
Salut Guilaind,
Je reviens sur tes deux commentaires ...
D’abord sur le premier, « problème d’association de pub aux bannières », as-tu toujours ce problème ?
Ensuite concernant ta proposition que le plugin gère un rafraîchissement, c’est une bonne idée mais j’aurai besoin que tu m’en dises plus sur le fonctionennemt (je n’ai pas vraiment l’habitude des régies) ... Si je comprends bien, l’idée est de rafraîchir une bannière au bout de X secondes, pour afficher une autre image j’imagine ?
Merci d’avance pour ces précisions :)
P.
Merci P. pour ta réponse.
Pour le bug, oui le problème subsiste. Je n’avais pas touché depuis plusieurs jours et après nouvel essai, le problème persiste.
Pour le 2d point, il est classique de faire tourner les publicités toutes les X secondes suivant un ordre défini ou en aléatoire, permettant de louer le même emplacement à plusieurs annonceurs. Pour l’instant je n’ai pas grand chose d’autre à dire. Je viens d’installer openx et vais le tester.
Salut,
Bon, j’ai fait un permier essai ... tu me diras ce que tu en penses. Dispo seulement pour SPIP 3 par contre.
Le rafraîchissement fonctionne et est paramétrable pour chaque bannière. Par conte, le décompte d’affichage fait un bond du coup ... et la même image peut être affichée deux fois de suite (pas encore résolu ce problème).
N’hésite pas à faire un retour ...
P.
Merci pour la fonctionnalité.
Spip3 est bien trop jeune pour que je passe un gros site en prod. Tous les plugins que j’utilise en Spip2 ne sont pas encore dispo pour spip 3. Bref, pour moi spip3 c’est au moins 3 ou 4 mois après la vraie sortie officielle, pas avant...
Je vais continuer à explorer openX quand j’aurai 1 heure à tuer...
Je me lance en spip3 en dev sur mon gros site et vais donc enfin essayer le plugin avec intérêt. Je reviens ds qq jours avec des commentaires
Testé avec succès en dev. Simple à mettre en place et le rafraichissement fonctionne bien.
Je vais bientôt le passer en prod.
Merciiiiii
Répondre à ce message
Bonjour et merci pour ce plug-in.
Un truc qui faciliterait grandement la gestion des pubs pour nous, serait la possibilité d’uploader un gif/jpeg/swf depuis le disque local vers le site, sans passer explicitement par un client FTP. Un mécanisme un peu dans le même style que celui qu’on utilise pour insérer une image dans un article SPIP serait parfait.
Nos admin/producteurs de contenu SPIP n’ont le plus souvent pas la compétence (et donc pas les droits, hin hin) pour accéder le serveur en FTP.
Merci !
Salut,
C’est en cours de dév ... mais un peu compliqué car la mécanique de téléchargement/gestion des documents dans SPIP est bien rodée et très encadrée ...
Affaire à suivre donc (probablement la prochaine version du plugin).
P.
Cool. C’est pas urgentissime, juste que ça paraissait une bonne idée (tellement bonne que tu l’avais déjà eue, manifestement)...
On attendra la prochaine version, Merci !
Répondre à ce message
Bonjour,
Je fonctionne sous Sarka SPIP et je souhaite installer une bannière publicitaire dans le « bandeau bas » de mon site. J’ai un fichier nommé « inc_bandeau_bas.html » qui contient ceci :
Où dois-je copier la balise
?
Bonsoir Vincent,
Malheureusement, je ne connais pas le squelette Sarka ... peut-être que le mieux serait de poser la question sur la page du plugin.
P.
Répondre à ce message
Hello Pierro,
tentative d’utiliser Pub Banner sur spip 3, branche trunk
donc modification du plugin.xml :
suppression de la ligne :
les tables ne sont pas construite du premier coup aprés désinstallation , vider le cache , réinstallation ça passe .
j’ai bien « Bannières publicitaires » dans le sous-menu « Edition »,
absence de « Statistiques des publicités » dans le sous-menu « Statistiques ». par contre présente en bas de page http://spipfactory.com/ecrire/?exec=pubbanner
via le lien http://spipfactory.com/ecrire/?exec=statistiques_bannieres
donc ça fonctionne , ors mis quelque défaut d’affichage
Salut,
Pour info, je viens de publier une adaptation pour SPIP3, avec quelques nouvelles fonctionnalités :)
P.
vu et lu
merci je test des que j’ai migré mon serveur
Répondre à ce message
Problème d’association de pub aux bannières. Les tables existent bien. pour associer les pubs aux bannières j’ai du aller bidouiller en mysql. Le login de connexion mysql n’a pourtant aucun problème d’écriture pour tous les autres ajouts/modifs/suppressions.
Config noyau SPIP 2.1.13 avec plein de plugins installés dont Bonux, sur serveur preprod mais identique à prod (dédié).
Répondre à ce message
Bonjour Piero,
Bravo pour le plugin mais j’ai un problème...
Erreur SQL 1054
Unknown column ’statut’ in ’where clause’
SELECT COUNT(*) AS n FROM spip_bannieres WHERE statut=’2actif
J’ai vu que le probleme était reccurrent mais pas trouvé la solution. J’ai installé/réinstallé, sans succès.
Merci d’avance et bon courage !
Oups... j’ai trouvé.
J’ai effacé les tables et tout réinstallé.
Ça marche !
Merci !
Bonjour,
J’ai le même problème comment as tu fait pour régler ça silteplait ???
Merci.
Salut,
Peut-être que ce commentaire pourra t’aider ?
Tchuss
PiWi
Répondre à ce message
Bonjour, j’ai un soucis sur un spip 2.0.10 + pub banner 1.28
J’ai une erreur du type, uniquement lorsque je suis logué, c’est assez problématique dans certains cas. :
Salut,
Peux-tu m’en dire plus :
- sur quelle page as-tu cette erreur (URL, privée ou publique) ?
- dans quel squelette ?
...
P.
Je l’ai systematiquement quand je suis identifié, que ça soit sur l’espace publique ou privé, dès que je fais un appel à #PUBBANbanner_id .
Cette erreur apparaît dans l’iframe du bloc publicitaire.
Salut,
J’ai eu beau chercher, je ne parviens pas à avoir le même bug. Du coup, j’ai procédé autrement et modifié un appel dans l’un des modèles. Peut-être que ça résoudra ton souci ... (?)
C’est dans le zip demain matin, ou tout de suite via la modif : http://zone.spip.org/trac/spip-zone...
Tiens moi au courant,
PiWi
Répondre à ce message
Bonjour,
en local, j’arrive à enregistrer de nouvelles pub mais elles ne sont pas prises en compte par les bannières. quelqu’un a t il déjà eu ce probleme ?
merci
Bonsoir Naomed,
As-tu bien activé les pubs ? il faut cliquer sur la ligne « Activé » dans la boîte d’information en haut à gauche de la page de la pub.
Si c’est déjà fait, il va falloir plus d’infos pour t’aider :
@+ PiWi
bonsoir,
SPIP 2.1.10 est installé ainsi que Pub Banner 1.28 et SPIP Bonux 2.2.22, aucun autre pluin n’est installé.
C’est dans la partie privée que les pubs ne sont pas prises en comptes par les bannières. j’arrive à associer une pub donnée en modèle avec une nouvelle bannière mais pas une nouvelle pub sur aucune bannière modèle ou non.
Cela vient peut être de wampserver.
Salut,
Je viens de tester dans ta config et je ne retrouve pas le même problème... Par contre, je ne pense pas que cela puisse venir de WAMP (il s’agit simplement d’exécutables, je ne vois pas à quel endroit cela pourrait jouer dans la cas présent).
Bon, pour pouvoir mieux t’aider :
Un aperçu pourrait probablement nous donner plus d’infos ... Peux-tu faire un aperçu d’une page avec ton erreur ?
On va trouver ;-)
PW
bonjour,
j’ai tout réinstallé et cela ne change rien
dans la page d’édition des pubs, je vois la nouvelle bannière et je peux la selectionner
sur la page liste des bannieres, j’ai l’erreur suivante pour toutes les bannières demo et nouvelle
Fatal error : Call to undefined function generer_action_auteur() in C :\wamp\www\tourisme senegal\plugins\pub_banner\exec\pubban_puce_activation.php on line 31
Call Stack
# Time Memory Function Location
1 0.0025 423584 main( ) ..\index.php:0
2 0.0923 3441192 exec_pubban_puce_activation_dist( ) ..\index.php:156
3 0.0923 3441192 exec_pubban_puce_activation_banniere_args( ) ..\pubban_puce_activation.php:15
la liste des pubs actives me renvoit
Fatal error : Call to undefined function generer_action_auteur() in C :\wamp\www\tourisme senegal\plugins\pub_banner\exec\pubban_puce_activation.php on line 50
Call Stack
# Time Memory Function Location
1 0.0013 423568 main( ) ..\index.php:0
2 0.0904 3441168 exec_pubban_puce_activation_dist( ) ..\index.php:156
3 0.0905 3441168 exec_pubban_puce_activation_pub_args( ) ..\pubban_puce_activation.php:16
dans la liste des pubs actives l’apercu fonctionne pour pub demo par pour les nouvelles pubs
c’est tout ce que j’ai repéré
merci
Ok, alors le problème est maintenant résolu ... ou plutôt le sera demain matin (j’ai constaté hier qu’effectivement, un bug sur ce fichier renvoyait une erreur).
Mets à jour le plugin demain matin ou de suite via SVN (version 1.28 SVN [51781]) et ça devrait corriger l’erreur.
@+ PW
merci, j’essaye ce soir et te tiens au courant
bonjour,
le plugin ne crée plus les tables dans la base, serait il possible d’avoir une copie des tables.
merci
Ok, dump sql ci-dessous, et alternative ’SPIP’ tout en bas ...
1_ Alternative SQL
Attention, ça efface les tables avant de les recréer. Les exemples sont conservés :
2_ Alternative SPIP
En quatre étapes :
Si l’une de ces solutions ne résout pas tes problèmes, ça va être plus compliqué que prévu ;-)
Mais on va trouver ...
@ P.W.
j’essaye demain et te tiens au courant merci
je viens de réinstaller, je n’ai plus de message d’erreur mais... Ma nouvelle est enregistrée, la nouvelle pub est enregistrée, l’image est visible mais cette pub ne s’associe pas à la bannière.
j’ai inspecté les tables, la nouvelle bannière et la nouvelle pub apparaissent dans leur tables mais rien n’apparait dans la table « bannieres_publicites » ou se s’inscrit le « couplage ».
le probleme venait bien du serveur local une fois en ligne tout fonctionne à merveille. merci
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |