1. Installation

Ce premier chapitre couvre l'intégralité du processus d'installation de 100gérance, depuis la vérification des prérequis jusqu'au premier lancement réussi. Comptez 15-30 minutes pour une installation complète sur un WordPress existant.

1.1 — Vérification des prérequis

WordPress

100gérance nécessite WordPress version 6.0 ou supérieure. Les versions antérieures ne disposent pas des API nécessaires pour le bon fonctionnement du plugin.

Pour vérifier votre version WordPress :

1. Connectez-vous à l'admin de votre WordPress
2. Allez dans Tableau de bord → Mises à jour
3. La version installée est affichée en haut

PHP

100gérance exige PHP 8.0 ou supérieur. PHP 8.1 ou 8.2 sont recommandés pour des raisons de performance et de sécurité.

Pour vérifier votre version PHP :

1. Dans WordPress admin : Outils → Santé du site → Info
2. Dépliez la section « Serveur »
3. Lisez la ligne « Version PHP »

Si vous voyez PHP 7.4 ou inférieur, contactez votre hébergeur pour passer en PHP 8.x. Sur la plupart des hébergements modernes (Infomaniak, SwissCenter, OVH), c'est un simple clic depuis l'interface de gestion.

Base de données

MySQL 5.7+ ou MariaDB 10.3+. C'est le standard sur tout hébergement WordPress actuel — vous n'avez probablement rien à vérifier ici.

Mémoire PHP (memory_limit)

100gérance nécessite au minimum 64 Mo de mémoire PHP allouée. Pour les opérations gourmandes (génération de batches de 50+ QR-factures, import CAMT 053 volumineux, export Excel multi-feuilles), 128 Mo sont recommandés.

Pour vérifier : dans la même page Santé du site → Info → Serveur, cherchez « Limite de mémoire PHP ».

Pour augmenter cette limite, deux options :

• Via wp-config.php : ajoutez avant la ligne /* That's all, stop editing! */ :

  define( 'WP_MEMORY_LIMIT', '128M' );
  define( 'WP_MAX_MEMORY_LIMIT', '256M' );

• Via .htaccess (si Apache) : ajoutez à la racine :

  php_value memory_limit 128M

• Via l'interface de l'hébergeur : panneau de gestion PHP

Espace disque

L'installation initiale occupe environ 5 Mo. L'usage quotidien fait grossir cet espace selon vos données (pièces jointes de sinistres, PDFs de baux signés, factures fournisseurs scannées). Comptez 50-100 Mo par immeuble par an en moyenne.

1.2 — Téléchargement du plugin

Rendez-vous sur la page de téléchargement et cliquez sur le bouton « Télécharger centgerance-1.0.10.zip ».

Le fichier est servi avec son empreinte SHA-256 publiée sur la même page. Pour vérifier l'intégrité du fichier téléchargé, ouvrez un terminal et tapez :

# Sur macOS / Linux
shasum -a 256 centgerance-1.0.10.zip

# Sur Windows (PowerShell)
Get-FileHash centgerance-1.0.10.zip -Algorithm SHA256

Le hash retourné doit correspondre exactement à celui publié sur le site. Si non, recommencez le téléchargement.

1.3 — Installation via l'admin WordPress

C'est la méthode la plus simple, à privilégier sauf cas particuliers.

1. Connectez-vous à l'admin WordPress de votre site
2. Dans le menu de gauche, cliquez sur Extensions → Ajouter une extension
3. En haut de page, cliquez sur le bouton « Téléverser une extension »
4. Cliquez sur « Choisir un fichier » et sélectionnez centgerance-1.0.10.zip
5. Cliquez sur « Installer maintenant »
6. Attendez quelques secondes (extraction du ZIP)
7. Cliquez sur « Activer l'extension » dès que disponible

Que se passe-t-il à l'activation ?

Lors de la première activation, 100gérance exécute son installateur qui :

1. Crée 21 tables SQL dans votre base de données, avec le préfixe {wp_prefix}gerance_
2. Insère 21 modèles de lettres-types dans la table {wp_prefix}gerance_lettres_modeles
3. Crée les règles de réécriture d'URL permettant l'accès via /gerance/...
4. Enregistre la version de base dans l'option gerance_db_version
5. Vide le cache de réécriture WordPress (flush_rewrite_rules)

Toutes ces opérations sont idempotentes : si vous désactivez puis réactivez le plugin, vos données existantes sont conservées, seules les éventuelles migrations de schéma sont appliquées.

1.4 — Installation via FTP (méthode alternative)

Si l'installation via l'admin WordPress échoue (limite d'upload trop basse, problèmes de permissions), vous pouvez installer manuellement par FTP.

1. Dézipez centgerance-1.0.10.zip sur votre ordinateur. Vous obtenez un dossier centgerance/
2. Connectez-vous en FTP à votre serveur
3. Naviguez vers /wp-content/plugins/
4. Uploadez le dossier centgerance/ entier
5. Connectez-vous à l'admin WordPress : Extensions → Extensions installées
6. Trouvez 100gérance dans la liste et cliquez sur « Activer »

1.5 — Premier accès

Une fois le plugin activé, vous pouvez accéder à l'interface utilisateur via l'URL :

https://votresite.ch/gerance/

L'accès est restreint aux utilisateurs WordPress disposant :

• Soit du rôle administrator
• Soit de la capability personnalisée gerance_access

Vous devez être connecté à WordPress. Sinon, vous serez redirigé vers la page de login standard.

1.6 — Donner accès à d'autres utilisateurs

Par défaut, seuls les administrateurs WordPress peuvent accéder à 100gérance. Pour donner l'accès à un autre utilisateur sans en faire un administrateur du site :

1. Installez un plugin de gestion des capabilities (ex : User Role Editor, gratuit sur wordpress.org)
2. Allez dans Utilisateurs → User Role Editor
3. Sélectionnez le rôle à modifier (ex : editor)
4. Cochez la capability gerance_access
5. Sauvegardez
6. L'utilisateur peut désormais accéder à /gerance/

1.7 — Spécificités d'hébergement

SwissCenter / Installatron

SwissCenter dispose d'un opcache PHP très agressif. Après chaque mise à jour du plugin :

1. Désactivez 100gérance dans Extensions
2. Réactivez-le immédiatement

Sans cette manipulation, les nouveaux fichiers PHP ne sont pas pris en compte (l'opcache continue à servir l'ancienne version en mémoire).

Infomaniak

Pas de spécificité particulière. Vérifiez que vous êtes bien sur PHP 8.0+ depuis le Manager Infomaniak → Hébergement Web → Modifier PHP.

OVH Hébergement Mutualisé

Sur les anciennes formules OVH (Perso / Pro 2019), la limite d'upload peut être à 2 Mo, ce qui peut bloquer le téléversement du ZIP de 205 Ko (très improbable mais possible avec des proxys WAF). Solution : installer par FTP.

Hébergement local (XAMPP, MAMP, Local)

100gérance fonctionne parfaitement en local. C'est même la meilleure façon de tester avant de déployer en production. Aucune spécificité.

1.8 — Mise à jour vers une version ultérieure

Quand une nouvelle version de 100gérance est publiée, voici la procédure standard :

1. Sauvegardez votre base de données avant toute mise à jour. Soit via votre hébergeur (Infomaniak / OVH propose des sauvegardes automatiques), soit via un plugin comme UpdraftPlus, soit via phpMyAdmin (export SQL).
2. Téléchargez la nouvelle version sur le site officiel
3. Dans WordPress : Extensions → Extensions installées
4. Désactivez 100gérance (sans le supprimer — sinon vous perdriez la base, voir 1.9)
5. Téléversez la nouvelle version (WordPress remplacera les fichiers automatiquement). Si WordPress refuse (« le dossier existe déjà »), supprimez le dossier centgerance/ manuellement via FTP avant le téléversement
6. Réactivez 100gérance. Les migrations de base de données s'exécutent automatiquement.
7. Vérifiez le tableau de bord — votre référentiel et vos données métier doivent être intacts

1.9 — Désactivation et désinstallation

Désactivation simple

Dans Extensions → Désactiver. Effets :

• L'interface /gerance/ devient inaccessible
• Les tables et options restent intactes
• Aucune perte de données
• Vous pouvez réactiver à tout moment

Suppression complète (conservation des données)

Dans Extensions → Supprimer. Par défaut :

• Les fichiers du plugin sont effacés du disque
• Les tables SQL restent dans la base (sécurité contre la perte accidentelle)
• Les options WordPress liées restent

Si vous réinstallez ensuite la même version (ou une supérieure), vous retrouverez toutes vos données intactes.

Suppression complète (purge totale)

Si vous voulez vraiment effacer toute trace de 100gérance, y compris les données métier :

1. Avant la suppression, exécutez dans wp-config.php ou via une requête SQL :

   UPDATE wp_options SET option_value = '1' WHERE option_name = 'gerance_confirm_purge_on_uninstall';

2. Puis dans Extensions, Supprimer 100gérance
3. Le script uninstall.php détecte le flag de confirmation et drop toutes les tables + supprime les options

1.10 — Résolution des problèmes d'installation

« Le téléversement a échoué »

Cause probable : limite d'upload PHP trop basse. Vérifiez upload_max_filesize et post_max_size dans Outils → Santé du site → Info → Serveur. Il faut au minimum 5 Mo. Sinon, augmentez via .htaccess ou panneau d'hébergeur, ou installez par FTP.

« Erreur fatale : Composer autoloader manquant »

Ce message ne devrait pas apparaître car 100gérance n'utilise pas Composer. Si vous le voyez, c'est qu'un autre plugin du site est défectueux ; désactivez les autres plugins un par un pour identifier le coupable.

« Erreur 500 après activation »

Activez WP_DEBUG dans wp-config.php :

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

Réessayez l'activation. Consultez ensuite /wp-content/debug.log pour le détail de l'erreur. Si c'est une erreur de syntaxe, c'est un bug à signaler par le formulaire de contact.

« La page /gerance/ retourne une erreur 404 »

Les règles de réécriture n'ont pas été créées. Allez dans Réglages → Permaliens et cliquez sur « Enregistrer les modifications » sans rien changer — cela force WordPress à régénérer les règles, y compris celles de 100gérance.

« Le menu latéral du plugin n'affiche pas correctement »

Cause probable : conflit CSS avec un autre plugin ou votre thème. Désactivez temporairement les autres plugins pour identifier le coupable. Le menu de 100gérance utilise Bootstrap 5 via CDN — si votre thème surcharge Bootstrap avec ses propres styles, ça peut casser le rendu.

« Je ne vois pas les modèles de lettres seedés »

Cause probable : l'activation initiale n'a pas pu écrire dans la base. Désactivez puis réactivez le plugin. Si toujours vide, vérifiez les permissions de la base de données (l'utilisateur MySQL configuré dans wp-config.php doit avoir CREATE / INSERT).

FAQ du chapitre Installation

Puis-je installer 100gérance sur un WordPress multi-sites ?

Oui, mais le plugin doit être activé site par site (pas en activation réseau). Chaque site aura son propre référentiel indépendant. Vu le caractère métier, cela ne pose pas de problème en pratique.

Combien de plugins puis-je installer à côté ?

Sans limite. 100gérance est conçu pour cohabiter avec n'importe quel autre plugin. Aucun hook WordPress sensible n'est manipulé. Les conflits sont rarissimes.

Le plugin tourne-t-il sur WordPress.com (hébergement) ?

Non. WordPress.com (le service hébergé) ne permet l'installation de plugins tiers qu'à partir du plan Business ou Commerce. Si vous êtes sur ces plans, oui, 100gérance fonctionne. Sur les plans inférieurs, vous devez migrer vers du WordPress auto-hébergé.

Faut-il un nom de domaine dédié ?

Non. Vous pouvez installer 100gérance sur un sous-dossier d'un site WordPress existant. L'URL d'accès sera alors https://monsite.ch/wp-content/plugins/centgerance/... non, en fait https://monsite.ch/gerance/ (slug configurable).

Puis-je changer le slug /gerance/ ?

Oui, via la constante GERANCE_FRONTEND_SLUG_OVERRIDE dans wp-config.php :

define( 'GERANCE_FRONTEND_SLUG_OVERRIDE', 'admin-gestion' );

Après modification, allez dans Réglages → Permaliens et enregistrez pour régénérer les règles.