> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.poool.fr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Comment paramétrer le comportement en cas d'erreur ?

Dans certaines circonstances, il est possible qu'une erreur empêche de communiquer avec le Dashboard. Les paramètres que vous aurez définis ne pourront donc pas être appliqués, et le lecteur sera potentiellement exposé à une **action par défaut**.

Ces erreurs peuvent être déclenchées par plusieurs facteurs : connexion lente, souci de navigateur, page trop longue à charger, script tiers créant des interférences...

Côté Poool, nous faisons tout pour être toujours au maximum ! La moyenne d'uptime est de 99,99%. N'hésitez pas à souscrire à cette alerte pour être informé👉 [https://status.poool.fr/](https://status.poool.fr/)

# Comportement par défaut en cas d'erreur

Si nous ne pouvons pas communiquer avec votre Dashboard en moins de 10 secondes, nous déclenchons un timeout. Un paywall par défaut s'affiche, et nous déclenchons l'événement `onError`.

Sur toutes les **pages premium**, le paywall par défaut de poool est un paywall abonnement (contenu bloqué), avec l'apparence basique noir et blanc ci-dessous :

[![](https://storage.crisp.chat/users/helpdesk/website/-/9/d/4/c/9d4c5be534d49000/ef7e4cf2-7b3c-484b-b53b-be1ad5_lqfkyy.png)](https://downloads.intercomcdn.com/i/o/s22rivig/1208883062/ad6540bf6d1fe5a14be6567ddec1/Capture+d%E2%80%99e%CC%81cran+2024-10-08+a%CC%80+16_37_28.png?expires=1773414000&signature=2a79436db8f8e682b7794678a0562c75c70f1ac917c3a1464028c43927dbe79e&req=dSInHsF2noFZW%2FMW1HO4zctIwpezhb3bZWBxhItoCBkxe1kAeU1o%2FnUlk%2BH7%0AEqNJdI1Emm2vPGpkZjs%3D%0A)

💡 Ce wall par défaut s'affichera sur toutes vos pages tagguées comme **premium**. Si vous utilisez des contextes gratuits, avec le page_type: "free", le paywall par défaut s'affichera, mais aucun blocage ne sera actif sur le contenu.

Pour les **pages premium**, afin de vous assurer que l'expérience utilisateur est préservée et que le blocage/déblocage du contenu est conforme à vos attentes, nous vous décrivons ici les actions qui s'offrent à vous.

# Déblocage total du contenu

Dans le cas où vous souhaitez proposer un déblocage complet du contenu, vous pouvez paramétrer dans l'événement `onError` le masquage du widget ainsi que forcer le déblocage du contenu.

```
access.on('error', (error, event) => {  
  $('#poool-widget').hide();  
  event.forceRelease();  
});
```

# Choisir l'action du paywall par défaut

Grâce à l'[événement JS `onError`](https://www.poool.dev/fr/docs/access/javascript/events#error) vous pouvez gérer votre propre fallback, comme vous le souhaitez.

Nous mettons aussi à disposition, la ligne de configuration [default_widget](https://www.poool.dev/fr/docs/access/javascript/configuration#default_widget). Il est ainsi facile de définir le type de paywall que vous souhaitez afficher en cas d'erreur.

```
access.config('default_widget', 'gift');
```

Plusieurs valeurs sont possibles pour ce widget par défaut :

* 'invisible' : dans ce cas, il vous faudra également **forcer le débloquage** comme expliqué dans le paragraphe précédent
* 'unlock' : contenu non bloqué, le bandeau de déblocage automatique s'affiche au bas de l'article
* 'gift' : article offert, l'article est débloqué au clic sur le bouton
* 'subscription' : wall d'abonnement, action par défaut chargée par poool

# Personnalisation du paywall par défaut

Le paywall par défaut de poool est un paywall basique non brandé.

## Appliquer des styles et définir le texte

Vous pouvez ainsi travailler votre paywall par défaut en appliquant des éléments de styles et configurer vos propres textes, grâce aux lignes de configurations suivantes:  
​

```
access  
  .styles({  
     brand_logo: 'https://mon-media.fr/logo.png',  
     button_color: '#F00',  
  })  
  .texts({  
     no_thanks: 'No I\'m fine thanks',  
     subscription_title: 'This article is for you!'  
  });
```

Cette "sécurité" graphique vous permettra d'avoir une continuité d'expérience de marque en toutes circonstances.

## Afficher les bonnes URLs d'abonnement et de connexion

Si le paywall n'arrive pas à joindre le serveur, il est fort probable qu'il ne récupère pas non plus les URLs configurées (url de la page abonnement ou url de la page de connexion) pour les donner au paywall par défaut. Il est ainsi intéressant de rajouter, dans la configuration JS, ces urls pour rediriger correctement les utilisateurs :

### L'URL vers la page d'abonnement

```
access.config('subscription_url', 'http://mysite.com/subscribe?return_url={return_url}&user_id={user_id}');
```

### L'URL de la page de connexion

```
access.config('login_url', 'http://mysite.com/login?return_url={return_url}&user_id={user_id}');
```

# Comment tester l'action par défaut ?

Pour vous assurer que l'action est conforme à vos attentes, nous vous invitons à le tester ! Pour cela, il s'agit de **bloquer la connexion API** pour se mettre en condition d'erreur.  
Vous pouvez par exemple bloquer le domaine de la requête API, via la console (en bloquant la requête "paywall") et vérifier que l'élément qui s'affiche est bien conforme à vos attentes.

Vous pouvez aussi retrouver [notre guide](https://www.poool.dev/fr/guides/timeouts-and-errors) à ce sujet sur le devhub. N'hésitez pas à nous écrire si vous avez la moindre question !