Intégrer un drop ou une collection
Un widget est une petite fenêtre sur First Ledger, placée sur votre propre site. Vous l’ajoutez avec une seule ligne de HTML, et il se met à jour tout seul : la progression d’un drop, ou les articles de votre collection en vente.
Qu’est-ce qu’un widget
Il en existe deux. Le widget de mint affiche l’un de vos drops : sa progression, son prix et s’il est ouvert. La vitrine affiche les articles de votre collection mis en vente, du moins cher au plus cher.
Dans les deux cas, c’est un cadre : une partie du site de First Ledger, affichée dans le vôtre. Votre page décide de son emplacement et de sa largeur ; tout ce qu’il contient vient de First Ledger.
N’importe quel site peut en afficher un. Pas de liste de sites approuvés à rejoindre, ni d’inscription préalable.
L’ajouter à votre site
Collez l’une de ces lignes là où le widget doit apparaître, et remplacez la dernière partie par le nom de votre drop ou de votre collection tel qu’il figure dans son adresse First Ledger :
Pour un drop :
<script async src="https://nft.firstledger.net/embed/v1.js" data-drop="your-drop"></script>Pour la vitrine d’une collection :
<script async src="https://nft.firstledger.net/embed/v1.js" data-collection="your-collection"></script>Le widget occupe la largeur disponible, jusqu’à une largeur de lecture confortable, et ajuste sa propre hauteur. Pour le rendre plus étroit, ajoutez un attribut data-max-width avec le nombre de pixels voulu.
Si vous voulez exactement le fichier que vous avez vérifié
La ligne ci-dessus charge toujours la version actuelle du script : un correctif de First Ledger arrive donc sur votre site sans action de votre part.
Si vous préférez n’exécuter que le fichier exact que vous avez examiné, utilisez plutôt cette ligne. Elle désigne une copie figée et contient son empreinte : les navigateurs de vos visiteurs refusent de l’exécuter si un seul octet diffère.
<script async src="https://nft.firstledger.net/embed/v1-83e6b09dc740.js" integrity="sha384-3xmwD2f3FWFxN2xkUwqNNimABVOYQaLCT1l9aZTJ1ElFIKdiG3+hoGrWxBTmSA+j" crossorigin="anonymous" data-drop="your-drop"></script>La copie figée ne change jamais, elle ne reçoit donc aucun correctif. Ce qui se passe dans le widget reste identique dans les deux cas, car cette partie est toujours la page de First Ledger.
Ce qu’un visiteur peut faire
Tout le monde peut voir ce qu’affiche le widget et le suivre jusqu’au même drop ou à la même collection sur First Ledger pour y minter ou acheter.
Pour acheter ou minter directement dans le widget, le visiteur doit accepter les conditions d’utilisation et la politique de confidentialité de First Ledger avant de connecter un wallet, puis se connecter via une fenêtre First Ledger qui s’ouvre à côté de votre page.
Ces politiques ne sont pas encore publiées : pour l’instant, le widget indique que la connexion n’est pas disponible et renvoie l’acheteur vers First Ledger. Dès leur publication, la connexion s’activera dans tous les widgets en même temps, sans rien à modifier de votre côté.
Dans un widget, le visiteur peut utiliser le wallet Joey : son extension de navigateur, ou l’app via WalletConnect. Le wallet de First Ledger n’y est pas proposé, car votre page n’est pas la nôtre.
Ce qu’il ne fera jamais
Il ne détient jamais les clés d’un wallet et ne signe jamais rien de lui-même. Chaque achat se termine par une demande de confirmation dans le wallet du visiteur.
Votre page ne voit pas ce qui se passe dans le widget : ni la connexion du visiteur, ni son wallet, ni ses achats. La seule chose que le widget transmet à votre page, c’est sa hauteur.
Il ne peut pas afficher ce que First Ledger n’affiche pas. Si un drop ou une collection est retiré, tous les widgets qui l’affichent cessent de le montrer au même moment.
Le retirer
Supprimez la ligne de votre page. Rien d’autre à faire : aucune inscription n’est à annuler.
Le widget d’un drop terminé continue de l’indiquer ; celui d’une collection sans listing indique que rien n’est en vente.