Plugin Chants

Présentation

Le plugin Chants a été créé sur la même structure de chants du logiciel open source, OpenSong. Il permet de référencer des chants pour une présentation en live par exemple. Ou tout simplement les référencer sur votre site internet.

Installation

Il s’installe comme tous les plugins https://www.spip.net/fr_article3396.html
Le plugin nécessite :
-  Saisies ;
-  Zippeur.

Il utilise aussi Zpip et Compositions. Mais ces derniers ne sont pas obligatoires pour la bonne utilisation de Chants.

Les balises

Voici la liste des balises offertes par ce plugin :
-  #TITRE
-  #ALIAS : il arrive parfois qu’on connaisse un chant sous un autre nom, un alias.
-  #COPYRIGHT
-  #ID_CHANT
-  #ID_RUBRIQUE
-  #ID_SECTEUR
-  #DATE_ANNEE : année de sortie du chant ;
-  #DATE : date de publication du chant ;
-  #NUMERO : le numéro du chant ;
-  #PAROLES : les paroles du chant ;
-  #PRESENTATION : l’ordre des couplets du chant. Exemple : [V1] [V2] [C] [V1] [R] ;
-  #LIGNE_PRINCIPALE
-  #CCLI : le numéro du chant au répertoire de CCLI
-  #CAPO : un capo (ou capodastre) est un chiffre de 1 à 5 déterminant la position du capo sur le manche de la guitare ;
-  #TONALITE
-  #TEMPO : peut avoir les valeurs suivantes : Très rapide, rapide, moyen, lent, très lent ;
-  #SIGNATURE : ou la mesure en Solfège. Peut avoir les valeurs suivantes : 2/4, 3/4, 4/4, 3/8, 6/8 ;
-  #STATUT : en cours de rédaction, proposé, publié, refusé, à la poubelle ;
-  #LANG
-  #ID_TRAD

Les objets liés

Vous pouvez ajouter des mots-clés à un chant mais aussi associer un auteur. L’auteur associé au chant sera ajouté en tant qu’authors lors de l’exportation du fichier xml (cf. ci-dessous).
Si nécessaire, vous pouvez joindre un logo au chant (facultatif).

Les squelettes disponibles

Le plugin fournit un squelette par défaut pour le public. Il affichera toutes les balises du chant.

Intégration rapide sur votre site

Si vous utilisez le plugin Z et Compositions, il existe une composition pour une rubrique dédiée aux chants. Il vous suffit de sélectionner cette composition pour la rubrique désirée.

Exporter en xml

Vous pouvez exporter chaque chant au format xml compatible OpenSong depuis l’espace privé, sur la page du chant.
Mais vous pouvez l’intégrer depuis les pages publiques grâce à cet appel, dans une boucle CHANTS :

[(#SET{filename, [(#CCLI|replace{' ',''})_][(#TITRE|textebrut|replace{\W})]})]
[(#URL_PAGE{chant_export.xml}
 |parametre_url{'id_chant',#ID_CHANT}
 |parametre_url{'filename',#GET{filename}})]

Le paramètre filename : c’est le nom du fichier qui sera enregistré sur votre bureau. Si vous ne renseignez pas ce paramètre, le nom par défaut sera « chant_export » et vous donnera de ce fait un fichier chant_export.xml.

Les modèles

Vous pouvez exporter une rubrique contenant les fichiers xml compatible OpenSong.
Pour cela, utilisez l’appel au modèle suivant dans une boucle renseignant l’identifiant de la rubrique :

[(#MODELE{repertoire_zip}{id_rubrique})]

Ce modèle utilise le plugin Zippeur cité en début d’article. De ce fait, vous aurez un fichier zip sous la forme « rubrique_XX.zip » où XX est le numéro de la rubrique.
Le fichier sera enregistré dans un sous-répertoire de « local/ ». Il sera recréé si vous mettez à jour un chant dans ladite rubrique.
Ce fichier, décompressé, pourra être placé dans votre répertoire « Songs » du logiciel OpenSong (se référer à la documentation de ce logiciel pour plus d’informations).

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom