#Installation
#Pour démarrer
#1. «Poool», WTF?
Poool est un paywall dynamique qui permet aux éditeurs de créer de la valeur
en mettant à disposition de leur audience des choix de compensation simples pour
débloquer équitablement le contenu.
#2. Placer le tag Poool au bon endroit
Poool s'intégre facilement en plaçant un tag dans le code source de vos pages.
Une attention particulière doit être portée à la position du tag : pour assurer
une performance optimale du paywall, pensez à appeler Poool en priorité dans
la page.
#3. Tagger les pages et mettre en place le paywall
Le tag Poool est prévu pour s'intégrer sur toutes les pages du site, à la
manière d'un tag Analytics classique.
-
- Insérez le tag Poool sur toutes vos pages, n'importe où dans la page, en remplaçant les différentes valeurs quand nécessaire :
C'est tout, les données devraient maintenant remonter normalement !
-
- Dîtes à Poool où est le contenu de votre article (en utilisant l'attribut
data-poool)
- Dîtes à Poool où est le contenu de votre article (en utilisant l'attribut
-
- Ajoutez le widget Poool en dehors du contenu de l'article :
C'est tout, le widget Poool devrait s'afficher !
#Installer sur AMP
AMP est une initiative open source créée par Google
visant à rendre le Web meilleur pour tous.
Le Paywall de Poool est entièrement compatible avec AMP. Voir la documentation de l'extension amp-access-poool.
Pour afficher votre paywall habituel dans AMP, importez les scripts des
extensions
amp-access et amp-access-poool dans votre page AMP :Ajoutez votre configuration
amp-access pour Poool :Et organisez vos sections contenant séparément l'extrait de l'article, l'article
complet et le paywall :
Et voilà, votre paywall Poool devrait s'afficher correctement dans AMP !
Voir un exemple d'intégration.
#Compatibilité
| Chrome | Firefox | Edge | Safari | Safari iOS | Chrome Android | XCode | iOS | Vue | Android SDK |
|---|---|---|---|---|---|---|---|---|---|
 |  |  |  |  | |  |  |  |  |
| 37+ | 34+ | 18+ | 11+ | iOS 11+ | Android 37+ | 11.0+ | 13.0+ | 3.0.0+ | 21+ |
#Questions fréquentes
#Je veux désactiver le paywall Poool pour mes abonnés payants, que faire ?
Pour des raisons de sécurité, le tag Poool ne prend pas la responsabilité de
désactiver le paywall pour un article qu'il n'a pas débloqué directement.
Par conséquent, vous devez désactiver le paywall manuellement si nécessaire, par exemple pour un abonné payant.
- Pour ne pas couper le contenu de l'article, retirez simplement les attibuts
data-poooletdata-poool-modede votre page - Pour ne pas afficher le paywall, retirez l'element
<div id="poool-widget"></div>de votre page
#J'installe Poool sur une application one-page (Angular, React, Vue, ...), est-ce que c'est compatible ?
Poool est compatible avec tous les frameworks récents : par exemple, notre propre
demo est une application React !
En revanche, il n'est pas possible de couper correctement le contenu d'un article
si des éléments dynamiques propres au framework utilisé (des components React/Vue,
des directives Angular, ...) sont présents à l'intérieur du contenu. Nous
conseillons donc aux applications one-page d'utiliser le mode de masquage
custom et d'effectuer leur propre
logique de masquage.
Des exemples d'implémentations sont disponibles :
De plus, pour éviter que certaines informations persistent d'une page à l'autre
(seulement pour les applications one-page), il est très souvent nécessaire
d'effectuer un appel à
flush au déclenchement d'une navigation (ex:
componentWillUnmount pour React, ngOnDestroy pour Angular, beforeRouteLeave
pour Vue ...) pour remettre les valeurs de configuration à leur valeur d'origine :#Ma connexion utilisateur ne se fait pas sur une nouvelle page, comment faire ?
Grâce aux évènements
onLoginClick et onSubscribeClick, il vous est possible
de ne pas renseigner d'URL de connexion et/ou d'abonnement, et de désactiver les
actions par défaut des boutons de connexion et d'abonnement :#Le paywall Poool ne détecte pas les attributs data-poool et data-poool-mode dans la page alors qu'ils sont présents, pourquoi ?
Dans certains cas très rares, le DOM de la page met plus de temps à charger que
le script du paywall en lui même. L'élément avec les attributs
data-poool et
data-poool-mode n'est donc pas encore disponible quand le script du paywall se
charge, il prend donc la configuration par défaut.Pour palier à cette éventualité, il peut vous être nécessaire de d'utiliser
l'option
wait_for_dom_load qui attendra l'évènement DOMContentLoaded du
navigateur avant d'exécuter le paywall :#Le paywall de Poool ne charge pas assez vite, ou ne charge pas du tout, que faire ?
Nous mettons un point d'honneur à constamment allouer les ressources nécessaires
au fonctionnement sans interruption du paywall Poool.
Néanmoins, nous avons prévu les différents scénarios catastrophes suivants :
- Si le paywall met trop de temps à charger (plus de 10s), nous interrompons toutes les requêtes du paywall en cours et affichons un paywall bloqué par défaut.
- Si le paywall rencontre une erreur non prise en charge, nous déclenchons directement l'évènement
onErrorpour que vous puissiez afficher un paywall de secours.
Dans les deux cas, si le paywall Poool n'a pas pu charger son apparence
personnalisée (et qu'elle n'est pas encore dans le cache du navigateur du lecteur)
et ses différentes options de configuration, il vous est possible de les
configurer directement avec l'API Javascript du paywall.
#Poool ne charge pas quand les fonctionnalités de script ne sont pas supportées ou quand elles sont désactivées. Que puis-je faire ?
Afin de rendre notre solution disponible dans n'importe quelle circonstance
utilisateur (par exemple quand Javascript est désactivé dans le navigateur),
nous avons mis en place un système permettant de récupérer le paywall de Poool
avec une configuration par défaut similaire à celle présente sur votre site
lorsque les cookies ne sont pas acceptés par votre lecteur.
Avec l'intégration d'une simple balise
iframe, il est ainsi possible d'afficher
un widget de restriction (abonnement exigé) utilisant l'apparence et les textes
configurés dans votre Dashboard. Notez que tout comme lorsque l'utilisateur
refuse le dépôt de cookies, les fonctionnalités de tracking seront désactivées.#Lors de la validation des champs dans le widget Formulaire, je souhaite pouvoir faire des vérifications et/ou traiter les données côté serveur. Que puis-je faire ?
Pour répondre à ce besoin, nous avons rendu l'envoi des évènements asynchrone.
Autrement dit, il est possible de mettre en place une logique de promesse au
sein-même de la configuration d'un évènement Poool.
Une fois ceci implémenté, nous attendons simplement que la promesse soit résolue et le résultat envoyé.
#Lors de l'envoi d'un formulaire avec un champ carte bancaire, je souhaite créer un paiement sur la carte bancaire de mon lecteur avec Stripe, comment faire ?
Pour des raisons de sécurité, nous avons choisi de ne pas stocker les identifiants
nécessaires au paiement côté serveur avec Stripe, pour vous laisser pleinement
la main sur la sécurité de votre plateforme, de bout en bout.
Pour effectuer vous-même un paiement côté serveur, il vous suffit de passer
votre clé publique Stripe côté front, et d'effectuer un appel vers vos APIs
avec les informations de carte bancaire récupérées depuis l'event
onFormSubmit.Pour la partie serveur, Stripe possède un SDK pour pratiquement tous les
langages disponibles aujourd'hui. Il vous suffit de parcourir
la documentation Stripe pour trouver la
version qui correspond à votre langage.
Un exemple concret avec le SDK PHP de Stripe :