Installation
Prérequis
| Composant |
Version |
| PHP |
8.0+ |
| MySQL / MariaDB |
5.7+ / 10.3+ |
| Extensions PHP |
pdo_mysql, curl, mbstring, fileinfo |
| Optionnel |
sqlite3 (CLI), simplexml |
Installation YunoHost
Méthode recommandée : Utilisez le package officiel.
sudo yunohost app install https://gitlab.com/anarchymedialibertaire-group/anarcosyndicalismebook_ynh
Installation rapide
# 1. Cloner le dépôt
git clone https://gitlab.com/anarchymedialibertaire-group/anarcosyndicalismebook.git
cd anarcosyndicalismebook
# 2. Installer les dépendances
composer install
# 3. Ouvrir l'installateur
# http://votre-domaine.org/install.php
Installateur interactif (7 étapes)
- Bienvenue — Présentation
- Vérifications — Contrôle des dépendances
- Base de données — Configuration MySQL
- Configuration — URL, SMTP, hCaptcha
- Administrateur — Création du compte admin
- Installation — Création des tables
- Terminé — Accès au site
Configuration
Fichiers générés
L'installateur crée automatiquement :
includes/config.php — SMTP, hCaptcha, URL du siteincludes/database.php — Connexion MySQL
Configuration SMTP
| Paramètre |
Description |
| SMTP_HOST |
Serveur SMTP (ex: smtp.gmail.com) |
| SMTP_PORT |
Port (465 SSL, 587 TLS) |
| SMTP_USER |
Adresse email |
| SMTP_PASS |
Mot de passe |
Personnalisation
Via Admin > Paramètres :
- Titre, description, citation
- Couleurs (primaire, secondaire)
- Logo et favicon personnalisés
- Clés SEO (Google, Bing)
Administration
Accès : /admin/ (comptes admin uniquement)
Fonctionnalités
- Dashboard — Statistiques, lectures totales
- Utilisateurs — Gestion des comptes, 2FA/TOTP
- Textes — CRUD complet, upload PDF/EPUB
- Import en masse — Drag & drop
- Import Calibre — metadata.db ou serveur OPDS
- Auteurs — Gestion avec photos
- Catégories — Organisation thématique
- Pages — Éditeur WYSIWYG
- Menus — Gestion navigation
- Newsletter — Abonnés, envoi en masse
- Formulaires — Formulaires personnalisables
- Paramètres — Personnalisation
- Mises à jour — Mise à jour automatique
Import Calibre
Méthode 1 : Fichier metadata.db
- Localiser
~/Calibre Library/metadata.db
- Admin > Import Calibre > Fichier metadata.db
- Uploader le fichier
- Sélectionner les livres à importer
Nécessite sqlite3 sur le serveur
Méthode 2 : Serveur Calibre (OPDS)
- Lancer :
calibre-server --port 8181
- Admin > Import Calibre > Serveur
- Entrer l'URL :
http://localhost:8181
- Sélectionner et importer
Les fichiers PDF/EPUB sont téléchargés automatiquement
Mises à jour
Mise à jour automatique
- Admin > Mises à jour
- Cliquer sur "Vérifier maintenant"
- Si disponible, cliquer sur "Mettre à jour"
Ce qui se passe
- Sauvegarde automatique de la BDD
- Sauvegarde des fichiers de config
git fetch + git reset --hard- Restauration des configs
composer install
Prérequis
- Git installé sur le serveur
- mysqldump pour les sauvegardes (optionnel)
Sécurité
| Protection |
Implémentation |
| SQL Injection |
Requêtes préparées PDO |
| XSS |
htmlspecialchars + CSP |
| CSRF |
Tokens sur formulaires |
| Brute force |
Rate limiting + hCaptcha |
| Sessions |
httpOnly, secure, samesite |
| Mots de passe |
bcrypt |
| Double Auth |
TOTP (2FA) / QR Code |
| Passkeys |
WebAuthn (connexion sans mot de passe) |
| Uploads |
Validation MIME + magic bytes |
Recommandations production
- Activer HTTPS (Let's Encrypt)
- Configurer hCaptcha
- Configurer SMTP
- Sauvegardes régulières
Newsletter
Fonctionnalités
- Formulaire d'inscription public
- Gestion des abonnés (admin)
- Envoi en masse avec template personnalisable
- Lien de désinscription automatique
- Double opt-in (confirmation par email)
Configuration
La newsletter nécessite une configuration SMTP fonctionnelle. Activez-la dans Admin > Paramètres.