Aller au contenu

Points d'extension

tilttek/dice-skins

Le paquet est en 0.x : ses points d'extension sont stables seulement à partir de sa version 1.0. D'ici là, une version mineure peut les changer, et son CHANGELOG dit comment.

PointCe qu'une application donneFourni
Contract\SkinCatalogLes skins que le site offre : depuis un fichier, une administration, une base de donnéesStore\FixedSkinCatalog
Contract\SkinChoiceStoreLe stockage des choix des membresStore\InMemorySkinChoiceStore
Contract\OwnedDiceLes dés qu'un membre possède, et celui qu'il a choisi pour un nombre de facesCollections\ShelfOwnedDice, Store\NoOwnedDice
Le skin par défautLa clé du skin que reçoit un membre qui n'a rien choisiBaseSkins::DEFAULT, ivory

Chaque point est passé au constructeur de DiceSkins, qui ne garde rien entre deux appels.

La bibliothèque remplit aussi un point d'extension d'un autre paquet : DiceBundle\DiceSkinsAppearance implémente le port DiceAppearance de tilttek/dice-bundle, comme l'explique Lancer avec tilttek/dice-bundle.

Stocker les choix

Un SkinChoiceStore garde un choix par membre pour tous ses dés — $sides nul — et un par membre et nombre de faces :

  • save() remplace le choix du membre pour le même nombre de faces, ou pour tous ses dés ;
  • find() le donne, ou null ;
  • remove() indique s'il y en avait un ;
  • ofMember() liste d'abord le choix pour tous les dés, puis les autres par nombre de faces ;
  • eraseMember() supprime tous les choix du membre et en retourne le nombre, pour l'effacement d'un membre.

SkinChoice::toArray() donne la ligne à conserver : le membre sous la forme kind:identifier, la clé du skin et le nombre de faces.

Des dés possédés venus d'ailleurs

Une application dont les membres possèdent des dés ailleurs implémente Contract\OwnedDice : ownedBy() liste des OwnedDie — l'article, son nom, son nombre de faces, sa couleur, sa matière en texte libre et l'exemplaire du membre —, et chosen() donne le dé que le membre lance pour un nombre de faces, ou null.