Documentation officielle

Thème Agence Artistique PHP/MySQL

Ce document explique comment installer, configurer, administrer et maintenir le thème Agence Artistique. Il est destiné aux acheteurs du thème, aux intégrateurs, aux agences et aux administrateurs finaux.

Présentation

Il s'agit d'un thème PHP/MySQL pour agences artistiques, labels, structures de booking, collectifs musicaux et producteurs d'événements. Il combine un site public éditorial avec un espace d'administration permettant de gérer les contenus sans modifier le code.

Prérequis

Avant l'installation, vérifiez que votre hébergement ou serveur local dispose des éléments suivants.

Installation

L'installation se fait en quatre grandes étapes : déposer les fichiers, créer la base de données, configurer le projet, puis se connecter à l'administration.

1. Déposez tous les fichiers du thème sur votre serveur, dans le dossier public de votre hébergement ou dans le répertoire prévu pour votre domaine.
2. Créez une base de données MySQL vide avec l'encodage utf8mb4. Le nom par défaut utilisé dans la configuration est booking_agency.
3. Importez le fichier SQL fourni : database/install.sql. Ce fichier crée les tables, les index, les rôles, les permissions et les contenus de démonstration.
4. Modifiez le fichier config/config.php avec les informations de connexion de votre base de données et l'URL de votre site.
5. Ouvrez la page d'administration : /admin/login.php.

Exemple de configuration locale

return [
    'app_name' => 'Artline Agency',
    'app_url' => 'http://localhost:8000',
    'debug' => false,
    'timezone' => 'Europe/Paris',
    'database' => [
        'host' => '127.0.0.1',
        'port' => '3306',
        'name' => 'booking_agency',
        'user' => 'root',
        'pass' => '',
        'charset' => 'utf8mb4',
    ],
];

Compte de démonstration

Le fichier d'installation crée un compte administrateur initial :

Email : admin@artline.test
Mot de passe : Admin2026!

Configuration du projet

Fichier principal

La configuration générale se trouve dans config/config.php.

Structure des dossiers

Dashboard admin

L'administration est accessible via /admin/login.php. Elle est protégée par authentification, rôles, permissions et protection CSRF sur les formulaires sensibles.

Pages disponibles

Gestion des contenus

Page d'accueil

La page d'accueil est composée de sections éditables depuis l'administration :

• Hero : titre principal, texte, boutons, image et statistiques.
• Artistes accueil : titre et texte de la sélection d'artistes.
• Services : présentation des services de l'agence.
• À propos : bloc institutionnel et appel à l'action.
• Agenda : titre et texte des prochaines dates.
• Contact : titre et texte de la section booking.

Artistes

Chaque artiste dispose d'une fiche complète. Les champs principaux sont :

Page Nos artistes

La page publique index.php?page=artists regroupe tous les artistes publiés. Elle inclut une recherche discrète et des tags issus des styles musicaux renseignés dans les fiches artistes.

Actualités

Les articles sont gérés depuis Actualités. La page publique index.php?page=news affiche six articles maximum par page avec pagination. Chaque article publié dispose d'une page détail.

Agenda

Les événements peuvent être liés à un artiste et inclure une date, une ville, un lieu, une URL de billetterie et un statut. Les dates publiées apparaissent sur le site public.

Demandes clients et formulaire booking

Le formulaire de booking permet aux visiteurs de contacter l'agence. Les demandes sont enregistrées en base puis consultables dans l'admin, même si le SMTP n'est pas encore configuré.

Champs du formulaire public

• Nom et email obligatoires.
• Téléphone et structure facultatifs.
• Artiste concerné ou demande générale.
• Type de demande : booking concert, production artistique, accompagnement, presse / partenariat.
• Date souhaitée, ville / lieu, budget et message.
• Consentement RGPD obligatoire.

Traitement dans l'admin

Depuis la page Demandes clients, l'administrateur peut :

• consulter les demandes ;
• modifier leur statut ;
• assigner une demande à un utilisateur ;
• ajouter des notes internes ;
• répondre par email si le SMTP est configuré ;
• supprimer une demande devenue inutile.

Configuration SMTP

Le SMTP se configure depuis Paramètres. Renseignez l'hôte, le port, le chiffrement, l'adresse d'expéditeur, le nom d'expéditeur, l'adresse de réponse et les identifiants fournis par votre prestataire.

Billetterie et partenaires

Billetterie

Le thème inclut une page billetterie activable depuis les paramètres. Elle peut afficher des événements avec URL de billetterie ou code embed compatible, selon la plateforme utilisée.

• Activation ou désactivation de la page billetterie.
• Titre, texte d'introduction et libellé du bouton modifiables.
• Gestion de plusieurs événements de billetterie.
• Support des liens ou embeds sécurisés.

Partenaires

Le bandeau partenaires est géré depuis l'administration. Chaque partenaire peut avoir un nom, un logo, un lien web, un statut actif et un ordre d'affichage.

Personnalisation

Identité visuelle

Depuis Paramètres, vous pouvez gérer :

• nom du site ;
• logo clair et logo sombre ;
• favicon ;
• réseaux sociaux ;
• libellés du menu public ;
• titres et introductions des pages artistes et actualités.

Thèmes et couleurs

Le module d'apparence permet d'activer un thème visuel et d'ajuster les couleurs principales : couleur primaire, secondaire, fond, texte, boutons et texte des boutons.

Fichiers CSS

Les styles sont séparés pour faciliter la maintenance :

• assets/css/site.css : site public.
• assets/css/admin.css : dashboard admin et page de connexion.

Sécurité

Le thème inclut plusieurs protections de base adaptées à un projet PHP/MySQL.

Fichier .htaccess

Le fichier .htaccess fourni ajoute notamment :

• désactivation du directory listing ;
• protection des fichiers sensibles comme .env, .sql, .log, .bak, .ini ;
• headers de sécurité : X-Content-Type-Options, X-Frame-Options, Referrer-Policy ;
• règles de cache pour les assets.

Performance

Le thème a été pensé pour rester léger et fluide sur desktop comme sur mobile.

Bonnes pratiques images

• Préférez des images en WebP ou JPG optimisé.
• Évitez d'envoyer des images de plusieurs mégaoctets si elles sont affichées en miniature.
• Utilisez des visuels larges pour les héros, mais compressez-les avant l'upload.
• Gardez les PDF de press kit raisonnables pour un téléchargement rapide.

Maintenance

Sauvegardes

Avant toute mise à jour, sauvegardez :

• la base de données MySQL ;
• le dossier uploads/ ;
• le fichier config/config.php ;
• les fichiers modifiés manuellement.

Changer le mot de passe admin

Connectez-vous à l'administration, ouvrez Mon compte, puis renseignez le nouveau mot de passe et sa confirmation.

Changer l'email du compte admin

La page Mon compte permet également de modifier l'adresse email utilisée pour la connexion.

Créer un nouvel utilisateur

Depuis Utilisateurs, un super administrateur peut créer un nouveau compte, choisir son rôle, l'activer ou le désactiver, puis régler les permissions par rôle.

Dépannage

Checklist avant mise en ligne