# Guide d'Installation et Configuration de zmb.fr

Ce document contient le guide complet de mise en production de votre blog personnel, bloc-notes et gestionnaire de bookmarks sur **zmb.fr**, hébergé chez Infomaniak.

---

## Étape 1 : Installation de WordPress sur Infomaniak

1. Connectez-vous à votre console **Infomaniak** (Manager).
2. Allez dans **Hébergement Web** puis sélectionnez votre domaine `zmb.fr`.
3. Dans le menu de gauche, cliquez sur **Applications Web** > **Installer une application**.
4. Choisissez **WordPress**, puis lancez l'installation en 1 clic.
5. Définissez vos identifiants administrateur.
6. Une fois installé, allez dans votre administration WordPress (`zmb.fr/wp-admin`), puis configurez vos permaliens dans **Réglages** > **Permaliens** : sélectionnez **"Titre de l'article"** (indispensable pour l'API REST).

---

## Étape 2 : Installation du Thème Ultra-Léger zmb

Nous avons généré votre thème sur mesure, optimisé pour la performance 4G et compatible avec vos notes privées et bookmarks.

1. Allez dans **Apparence** > **Thèmes** > **Ajouter un thème** > **Téléverser un thème**.
2. Sélectionnez le fichier **`zmb-theme.zip`** généré localement à la racine de votre dossier de projet :
   `MEDIA:/Users/geoffrey/Documents/_hermes/zmb.fr/zmb-theme.zip`
3. Installez-le et cliquez sur **Activer**.
4. À l'activation, le thème va automatiquement créer les 4 catégories requises en base de données :
   *   **Tutoriels & Astuces** (`tuto`)
   *   **Notes Rapides** (`note`)
   *   **Bookmarks** (`bookmark`)
   *   **Privé** (`private`) — *strictement masquée aux visiteurs*

---

## Étape 3 : Configuration du "Mot de Passe d'Application" pour l'API REST

Pour permettre au Raccourci iOS / macOS d'envoyer de manière ultra-sécurisée des données sur votre blog sans exposer votre mot de passe principal :

1. Allez dans votre administration WordPress > **Utilisateurs** > **Profil**.
2. Faites défiler vers le bas jusqu'à la section **Mots de passe d'application**.
3. Saisissez un nom (par exemple : `Raccourci iPhone`) et cliquez sur **Ajouter un nouveau mot de passe d'application**.
4. WordPress va générer une clé de 24 caractères (du type `xxxx xxxx xxxx xxxx xxxx xxxx`). **Copiez-la immédiatement**, elle ne s'affichera qu'une seule fois !

---

## Étape 4 : Configuration du Raccourci iOS / macOS (Apple Shortcuts)

La solution idéale pour capturer des bookmarks ou des notes en 1 clic sans devoir payer 99$/an de licence Apple ou re-signer une application tous les 7 jours.

### Créer le raccourci dans l'application "Raccourcis" :

1. Ouvrez l'application **Raccourcis** sur votre iPhone ou Mac et cliquez sur le **`+`** (Nouveau raccourci).
2. Nommez-le : **"Partager sur zmb"**.
3. Activez l'affichage dans la **Feuille de partage** (dans les réglages du raccourci) et configurez l'entrée pour qu'elle accepte **"Safari Web Pages"** et **"Texte"**.

### Séquence d'actions à configurer dans le Raccourci :

1. **Si l'entrée du raccourci a une valeur (on partage depuis Safari) :**
   *   **Obtenir le titre** de la page web.
   *   **Obtenir l'URL** de la page web.
2. **Sinon (on lance le raccourci directement pour écrire une note rapide) :**
   *   **Demander une saisie textuelle** : *"Que voulez-vous noter ?"*
3. **Définir l'authentification (En-tête HTTP) :**
   *   Créez une variable de texte contenant votre identifiant et votre mot de passe d'application sous la forme : `votre_login:votre_mot_de_passe_d_application` (sans espaces).
   *   Encodez ce texte en **Base64** via l'action native de Raccourcis.
   *   Sauvegardez le résultat dans une variable nommée `authHeader` (sa valeur finale doit ressembler à `Basic [votre_base64_ici]`).
4. **Action "Obtenir le contenu de l'URL" (Requête HTTP POST) :**
   *   **URL** : `https://zmb.fr/wp-json/wp/v2/posts`
   *   **Méthode** : `POST`
   *   **En-têtes** :
       *   `Authorization` : `Basic [insérer la variable authHeader]`
       *   `Content-Type` : `application/json`
   *   **Corps (JSON) - Ajoutez ces clés :**
       *   `title` : Le titre de la page (ou un texte générique si c'est une note).
       *   `content` : L'URL de la page (si c'est un bookmark) ou le texte saisi (si c'est une note).
       *   `status` : `"publish"` (ou `"private"` si vous voulez que ce soit une note privée par défaut).
       *   `categories` : Un tableau avec l'ID de la catégorie correspondante (ex: `[3]` pour bookmark, à récupérer dans votre admin WP).
       *   `meta` : Si c'est un bookmark, ajoutez le sous-dictionnaire `{"bookmark_url": "URL_obtenue"}` pour alimenter le champ du thème.

---

## Étape 5 : Fonctionnement de la sécurité et des notes privées

*   **Zéro Placeholder :** Les articles classés dans la catégorie **Privé** ou ayant le statut **`private`** dans WordPress ne génèrent aucune fuite de données ou élément vide. Le serveur WordPress filtre ces articles à la source (requêtes PHP et API REST) pour tout utilisateur anonyme.
*   **Affichage Dynamique :** Dès que vous vous connectez à l'administration WordPress de `zmb.fr`, un cookie de session est généré par votre navigateur. Notre thème détecte votre session, affiche la zone de rédaction en haut de la page, et injecte automatiquement vos notes privées dans le flux avec leur badge et options d'onglets dédiées.