WP Manifestindependent plugin directory
manifest / content / louange-roc-wordpress

Louange Roc

by Jonathan Guerne · github.com/jonathanguerne/louange-roc-wordpress

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/jonathanguerne/louange-roc-wordpress/archive/refs/heads/main.zip
Readme github.com/jonathanguerne/louange-roc-wordpress ↗

Louange Roc - WordPress Plugin

Un plugin WordPress pour gérer une bibliothèque de chants de louange avec transposition automatique des accords et gestion collaborative.

🎵 Fonctionnalités

  • ✅ Custom Post Types : Gestion de chants et setlists (listes de lecture)
  • ✅ Format ChordPro : Écriture intuitive des paroles avec accords
  • ✅ Transposition en temps réel : Changez la tonalité d'un simple clic
  • ✅ Page "Dimanche" : Gestionnaire de setlist drag & drop pour le culte
  • ✅ Shortcodes flexibles : Affichez vos chants n'importe où
  • ✅ Interface française : Entièrement traduit et adapté
  • ✅ Protection d'accès : Option pour restreindre l'accès aux membres (droits d'auteur)
  • ✅ Personnalisation : Taille de police, couleurs, colonnes, largeur de page
  • ✅ Import JSON : Importez vos chants depuis un fichier JSON
  • ✅ Impression optimisée : Format adapté pour l'impression
  • ✅ Responsive : Fonctionne sur tous les écrans

📥 Installation

Méthode 1 : Téléchargement ZIP (recommandée)

  1. Téléchargez la dernière version
  2. Dans WordPress, allez dans Extensions → Ajouter
  3. Cliquez sur "Téléverser une extension"
  4. Sélectionnez le fichier ZIP téléchargé
  5. Cliquez sur "Installer maintenant" puis "Activer"

Méthode 2 : Git (pour développeurs)

cd wp-content/plugins/
git clone https://github.com/JonathanGuerne/louange-roc-wordpress.git louange-roc

Puis activez le plugin dans WordPress Admin → Extensions.

🚀 Démarrage rapide

1. Configuration initiale

Après activation :

  1. Un nouveau menu "Louange" apparaît dans WordPress
  2. Allez dans Louange → Réglages pour configurer :
    • Protection d'accès (optionnel)
    • Apparence (taille de police, couleurs, etc.)

2. Créer votre premier chant

  1. Cliquez sur Louange → Chants → Ajouter un chant
  2. Entrez le titre du chant
  3. Remplissez les métadonnées :
    • Artiste : Nom de l'auteur ou compositeur
    • Tonalité originale : Sélectionnez dans le menu déroulant (C, D, E, etc.)
    • Texte ChordPro : Paroles avec accords au format ChordPro

Format ChordPro

[G]Amazing Grace, how [C]sweet the [G]sound
That saved a wretch like [D]me
[G]I once was lost, but [C]now am [G]found
Was [Em]blind but [C]now I [G]see

Les accords sont placés entre crochets [Accord] avant le mot sur lequel ils tombent.

3. Afficher vos chants

Option A : Page individuelle (automatique)

Chaque chant a sa propre URL (ex: /song/amazing-grace/) avec :

  • Sélecteur de tonalité
  • Boutons d'impression et édition
  • Accords transposables en temps réel

Option B : Liste de tous les chants

Ajoutez le shortcode dans une page :

[louange_songs]

Option C : Setlist du dimanche

Gérez votre setlist dans Louange → Dimanche, puis affichez-la avec :

[louange_current_setlist]

📖 Documentation complète

Pour un guide utilisateur détaillé en français, consultez le fichier guide-utilisateur.md inclus dans le plugin.

Vous y trouverez :

  • Instructions détaillées pour chaque fonctionnalité
  • Explication des rôles WordPress (Éditeur vs Auteur)
  • Guide d'importation depuis JSON
  • Exemples de shortcodes avancés
  • Conseils d'utilisation

🎛️ Shortcodes disponibles

Shortcode Description
[louange_songs] Affiche tous les chants sous forme de grille
[louange_song id="123"] Affiche un chant spécifique (ID)
[louange_current_setlist] Affiche la setlist du dimanche
[louange_all_songs] Liste compacte de tous les chants

👥 Gestion des permissions

Le plugin utilise les rôles WordPress standards :

Rôle Capacités
Éditeur ⭐ (recommandé) Peut créer, modifier et supprimer TOUS les chants
Auteur Peut créer et modifier uniquement SES propres chants
Contributeur Peut créer des chants mais pas les publier
Abonné Peut consulter les chants protégés

💡 Conseil : Pour une équipe louange collaborative, utilisez le rôle Éditeur pour tous les membres actifs. Cela permet à chacun de corriger ou améliorer les chants des autres.

🔧 Prérequis

  • WordPress 5.0 ou supérieur
  • PHP 7.4 ou supérieur
  • Navigateur moderne (Chrome, Firefox, Safari, Edge)

📁 Structure du projet

louange-roc/
├── louange-roc.php          # Fichier principal du plugin
├── assets/
│   ├── js/
│   │   ├── KeyMapper.js     # Librairie de transposition
│   │   └── transpose-ui.js   # Interface de transposition
│   └── css/
│       └── song-display.css  # Styles d'affichage
├── guide-utilisateur.md      # Guide complet en français
├── import-songs.php          # Script d'import JSON
└── README.md                 # Ce fichier

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

  1. Signaler des bugs : Créer une issue
  2. Proposer des fonctionnalités : Ouvrez une discussion dans les issues
  3. Soumettre des pull requests : Fork → Branch → Commit → PR

Développement local

# Cloner le repo
git clone https://github.com/JonathanGuerne/louange-roc-wordpress.git

# Créer une branche pour votre feature
git checkout -b feature/ma-super-feature

# Faire vos modifications
# ...

# Commit et push
git commit -m "Ajout de ma super feature"
git push origin feature/ma-super-feature

📜 Licence

Ce plugin est distribué sous licence GPLv2 ou ultérieure, conformément aux standards WordPress.

Voir le fichier LICENSE pour plus de détails.

🙏 Remerciements

  • KeyMapper.js : Merci à la communauté open source pour la librairie de transposition
  • Communauté WordPress : Pour l'écosystème incroyable
  • Église du Roc : Pour l'inspiration et les tests en conditions réelles

📞 Support

Version actuelle : 1.0.0