Musique — documentation Sillon

Ce qu'il fait

Des morceaux à écouter, télécharger et partager sur le site, rangés par ambiances. Le module fournit les données, le téléchargement, le comptage et le SEO des pages ; le lecteur et la mise en page appartiennent au thème.

Morceaux rangés par ambiances, un morceau dans plusieurs
Téléchargement au nom propre, permis ou non, morceau par morceau
Crédit et licence à copier, message de partage déjà rempli
Une page par morceau, avec son aperçu sur les réseaux et ses données pour Google
Écoutes, téléchargements et partages comptés, sans cookie

Où le trouver

Les écrans que ce module ajoute à l'administration, une fois activé.

Musique /admin/musique

Ses réglages

Ils se modifient depuis l'administration. La clé est donnée pour qui pilote le site en ligne de commande ou par l'API.

Réglage	Clé	Type	Par défaut
Le crédit à copier (vide : « Musique : » suivi du nom du site)	`musique.credit`	string	`(vide)`
Le texte de licence des morceaux	`musique.licence`	string	`(vide)`
Le téléchargement est-il ouvert sur le site (1 ou 0)	`musique.telechargement`	string	`1`
Le modèle du message de partage ({titre}, {sous-titre}, {style}, {site}, {credit})	`musique.partage`	string	`(vide)`
L'adresse de la page de la liste, servie par le thème	`musique.page_url`	string	`/musique`
L'adresse de la page d'un morceau, servie par le thème	`musique.public_url`	string	`/musique/{slug}`

Ses droits

Ce que chaque rôle peut faire par défaut. Modifiable rôle par rôle depuis l'administration.

Droit	Clé	Administrateur	Éditeur
Voir les morceaux et leurs compteurs	`musique.read`	✓	✓
Créer / modifier / supprimer des morceaux	`musique.write`	✓	✓

Ce qu'il suppose

Ce module a besoin de :

media *

Piloter par une IA

Ce que ce module sait faire quand on le lui demande en langage naturel, et ce que chaque action engage.

lister lecture seule

Liste les morceaux (titre, sous-titre, style, adresse, statut, ambiances, téléchargement, écoutes, téléchargements, partages, adresse de la page), les ambiances, et les fichiers audio de la médiathèque. Params : aucun.
creer écrit, annulable

Crée un morceau EN BROUILLON. Le fichier se choisit parmi les fichiers audio de la médiathèque (voir « lister »). La durée et la forme d'onde se calculent à l'ouverture de sa fiche dans l'administration.

« ajoute le morceau « Yuki no Akari » en brouillon » « prépare un morceau avec le fichier yuki-no-akari.mp3 »
modifier écrit, annulable

Modifie un morceau : ses textes, son fichier, sa pochette, ses ambiances, son statut (« publie » ou « brouillon »), le téléchargement. Ce qui n'est pas donné reste tel quel.

« publie le morceau 3 » « range « Kage no Neko » dans l'ambiance Hiver »

Ses points de branchement

Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.

Ce qu'il annonce 3

musique.cree: Émis après la création d'un morceau. Args: [int $id]
musique.modifie: Émis après la modification d'un morceau. Args: [int $id]
musique.supprime: Émis après la suppression d'un morceau (le fichier reste dans la médiathèque). Args: [int $id]

Ce qu'il écoute 4

seo.items: priorité 35
seo.image_du_contenu: priorité 35
seo.og: priorité 35
seo.jsonld: priorité 35

Ses prises front

Les morceaux de page que ce module fournit, et les classes qu'ils posent. Un thème les habille par ces classes : il ne recopie pas le balisage, sinon il rate les corrections des versions suivantes.

views/donnees.php 1 classes

s-musique-donnees

views/morceaux.php 11 classes

s-musique
s-musique-audio
s-musique-credit
s-musique-licence
s-musique-liste
s-musique-morceau
s-musique-pochette
s-musique-sous-titre
s-musique-style
s-musique-telecharger
s-musique-titre

Ses données

Les tables que ce module crée. Désactiver un module ne les efface pas : ses données restent en base et reviennent s'il est réactivé.

Les tables 3

musique_ambiances
musique_morceau_ambiances
musique_morceaux