Intégration facile HTML
Avant de commencer
Collez cet extrait avant la balise fermante </head> sur votre modèle HTML :
<script src="https://api.risidex.com/api.js" async defer></script>
Ajouter un bouton Risidex
Collez ce code là où vous souhaitez que le bouton Risidex s'affiche :
<div class="risidex" data-textarea="#textarea"></div>
Où #textarea est le sélecteur représentant le champ de message où seront insérés les stickers.
Aller plus loin avec l'intégration HTML
Afficher une fenêtre de stickers Risidex
Si vous ne souhaitez pas utiliser le bouton par défaut, vous pouvez afficher programmatiquement la fenêtre de stickers Risidex à l'aide du code :
Risidex.show('#textarea');
Où #textarea est le sélecteur représentant la zone de texte où seront insérés les stickers.
Remplacer des liens présents sur votre site par des stickers
Il est possible de remplacer programmatiquement les liens présent dans un élément de votre site par des stickers en appelant la fonction :
Risidex.replaceLinksWithStickers('window.body');
Où window.body peut être n'importe quel élement pouvant contenir des stickers.
Afficher les favoris des utilisateurs dans un conteneur
Il est possible d'afficher la liste des favoris des utilisateurs Risidex visitant votre site en utilisant la fonction suivante :
Risidex.showFavorites('#favoris', '#textarea');
Où #favoris est le sélecteur représentant le conteneur qui contiendra la liste des stickers favoris et #textarea le sélecteur représentant la zone de texte où pouront être insérés les stickers lors d'un clic.
Ajouter un sticker en favoris
Il est possible d'ajouter un sticker en favoris à l'aide de la fonction suivante :
Risidex.setFav('Lien vers le sticker', function(success){});
Afficher une liste de stickers dans un conteneur
Il est possible d'afficher une liste de stickers dans un conteneur à l'aide de la fonction suivante :
Risidex.loadStickers('Nom de la page', document.getElementById('element'), Paramètre supplémentaire pour la recherche);
Liste des pages :
| Nom de la page | Description | Exemple |
|---|---|---|
| recent | Stickers récents | Risidex.loadStickers('recent', document.getElementById('conteneur')); |
| top | Top stickers | Risidex.loadStickers('top', document.getElementById('conteneur')); |
| trending | Stickers tendances | Risidex.loadStickers('trending', document.getElementById('conteneur')); |
| random | Stickers aléatoires | Risidex.loadStickers('random', document.getElementById('conteneur')); |
| search | Recherche de stickers | Risidex.loadStickers('search', document.getElementById('conteneur'), 'risitas'); |
Configurer Risidex
Vous pouvez activer ou désactiver certains paramètres de Risidex en ajoutant le code suivant sur votre page :
<script>
var risidex_options = {
replaceLinksWithStickers: true,
disableLogin: false,
disableFavorites: false
};
</script>
var risidex_options = {
replaceLinksWithStickers: true,
disableLogin: false,
disableFavorites: false
};
</script>
Liste des paramètres :
| Variable paramètre | Description |
|---|---|
| replaceLinksWithSticker | Remplace automatiquement les liens présents sur votre site par des stickers quand il vaut true. |
| disableLogin | Désactive la possibilité de se connecter à Risidex quand il vaut true. |
| disableFavorites | Désactive l'affichage, l'ajout et la suppression des favoris quand il vaut true. |
API Risidex
Introduction
Si vous souhaitez uniquement récuperer des données depuis le serveur de Risidex, vous pouvez récuperer les listes de stickers en appelant différentes URL qui sont indiquées ci-dessous.
La liste en sortie est au format JSON.
Exemple de liste JSON
{
{
"auteur" : Evil,
"image" : https:\/\/image.noelshack.com\/fichiers\/2018\/25\/6\/1529708477-vieux.png
},
{
"auteur" : Volutes,
"image" : https:\/\/image.noelshack.com\/fichiers\/2018\/25\/6\/1529709828-love.png
}
}
{
"auteur" : Evil,
"image" : https:\/\/image.noelshack.com\/fichiers\/2018\/25\/6\/1529708477-vieux.png
},
{
"auteur" : Volutes,
"image" : https:\/\/image.noelshack.com\/fichiers\/2018\/25\/6\/1529709828-love.png
}
}
URL
Liste des derniers stickers:
https://api.risidex.com/recent
Liste des meilleurs stickers:
https://api.risidex.com/top
Liste des stickers tendances actuellement:
https://api.risidex.com/trending
Liste de stickers aléatoires:
https://api.risidex.com/random
Rechercher des stickers:
https://api.risidex.com/search?q=recherche
Où recherche est la chaîne de caractères représentant la recherche.