Téléverser les fichiers vers "/"
This commit is contained in:
@@ -0,0 +1,153 @@
|
||||
# GUIDE PAS-À-PAS — Configuration Meta (Facebook + Instagram)
|
||||
|
||||
> **Une seule app Meta** couvre à la fois **Facebook** et **Instagram**, et **un seul « Se connecter »**
|
||||
> dans le plugin obtiendra un jeton valable pour les deux. C'est le gros avantage de l'écosystème Meta.
|
||||
>
|
||||
> ⚠️ **Les libellés exacts des écrans Meta changent souvent** (Meta réorganise ses consoles plusieurs fois par an).
|
||||
> Les **principes, permissions et endpoints** ci-dessous, eux, sont stables. Si un écran ne porte pas exactement
|
||||
> le nom indiqué, cherche l'équivalent le plus proche — je t'aiderai à retomber sur mes pieds au moment du palier B.
|
||||
>
|
||||
> Tu réalises **toi-même** ces étapes (création de comptes, saisie de secrets) : je ne peux ni ne dois le faire à ta place.
|
||||
|
||||
---
|
||||
|
||||
## Vue d'ensemble (l'ordre compte)
|
||||
|
||||
```
|
||||
1. Compte Facebook (perso, admin) ─┐
|
||||
2. Page Facebook « Karaoke Clip » │ côté réseaux sociaux
|
||||
3. Compte Instagram → Business/Creator │
|
||||
4. Lier l'Instagram à la Page Facebook ─┘
|
||||
5. Business Manager (portefeuille pro) ─┐
|
||||
6. App Meta for Developers │ côté développeur
|
||||
7. Produits : Facebook Login + Instagram │
|
||||
8. Permissions + URI de redirection │
|
||||
9. App ID + App Secret → dans le plugin │
|
||||
10. (plus tard) Business Verification + App Review─┘
|
||||
```
|
||||
|
||||
Les étapes 1→9 suffisent pour **développer et tester** (mode Développement). L'étape 10 n'est requise que pour
|
||||
publier **publiquement au grand public** (mode Live).
|
||||
|
||||
---
|
||||
|
||||
## PARTIE 1 — Côté réseaux sociaux
|
||||
|
||||
### Étape 1 — Compte Facebook administrateur
|
||||
Utilise (ou crée) un compte Facebook personnel qui sera l'**administrateur** de tout. C'est lui qui possédera l'app,
|
||||
la Page et le Business Manager. Active la **validation en deux étapes** dessus (Meta l'exige pour les rôles sensibles).
|
||||
|
||||
### Étape 2 — Page Facebook
|
||||
1. https://www.facebook.com/pages/create → crée la Page (nom : *Karaoke Clip*, catégorie *Musicien/Groupe* ou *Site web*).
|
||||
2. Note le **nom exact** de la Page. Son identifiant (`PAGE_ID`) sera récupéré automatiquement par le plugin, tu n'as pas à le chercher à la main.
|
||||
3. Publie au moins une photo de profil + une couverture (une Page vide peut coincer certaines vérifications).
|
||||
|
||||
### Étape 3 — Compte Instagram en Business/Creator
|
||||
1. Crée (ou utilise) un compte Instagram dédié.
|
||||
2. Dans l'app Instagram → **Paramètres → Compte → Passer à un compte professionnel** → choisis **Business** (ou Creator).
|
||||
> L'API de publication **refuse** les comptes personnels. C'est non négociable.
|
||||
|
||||
### Étape 4 — Lier l'Instagram à la Page Facebook
|
||||
Le plus fiable passe par **Meta Business Suite** :
|
||||
1. https://business.facebook.com → connecte-toi avec le compte de l'étape 1.
|
||||
2. **Paramètres → Comptes → Comptes Instagram → Ajouter** → connecte le compte IG Business.
|
||||
3. **Paramètres → Comptes → Pages** → assure-toi que la Page FB (étape 2) est bien dans le portefeuille.
|
||||
4. Vérifie la liaison : dans les paramètres de la Page → **Comptes liés → Instagram** doit montrer ton compte IG.
|
||||
|
||||
> Test rapide de bonne liaison (facultatif) : dans Business Suite, tu dois pouvoir **programmer un post** vers la Page
|
||||
> **et** vers l'Instagram depuis la même interface. Si oui, l'API pourra faire pareil.
|
||||
|
||||
### Étape 5 — Business Manager / Portefeuille professionnel
|
||||
Déjà créé de fait à l'étape 4 (business.facebook.com). Il servira à la **Business Verification** (étape 10).
|
||||
Renseigne dès maintenant les infos de l'entreprise (nom, site `karaokeclip.video`) : ça accélère la vérif plus tard.
|
||||
|
||||
---
|
||||
|
||||
## PARTIE 2 — Côté développeur (l'app Meta)
|
||||
|
||||
### Étape 6 — Créer l'app
|
||||
1. https://developers.facebook.com → **Log in** (compte étape 1) → accepte les conditions développeur si demandé.
|
||||
2. **My Apps → Create App**.
|
||||
3. Cas d'usage : choisis une app qui permet de **gérer une Page et publier du contenu**. Selon la version de la console,
|
||||
c'est soit un choix « **Other** → type **Business** », soit un « use case » du type *« Manage everything on your Page »* /
|
||||
*« Publish content »*. En cas de doute, prends le type **Business** : il donne accès à tout ce dont on a besoin.
|
||||
4. Nomme l'app (ex. *KaraokeClip Publisher*), associe-la au **portefeuille pro** (étape 5).
|
||||
|
||||
### Étape 7 — Ajouter les produits
|
||||
Dans le tableau de bord de l'app → **Add Product** (ou « Use cases ») :
|
||||
- **Facebook Login for Business** → pour l'OAuth (le bouton « Se connecter » du plugin).
|
||||
- **Instagram** (Instagram Graph API / « Instagram API with Facebook Login ») → pour publier les Reels.
|
||||
|
||||
### Étape 8 — URI de redirection OAuth
|
||||
Dans **Facebook Login for Business → Settings → Valid OAuth Redirect URIs**, ajoute **exactement** l'URL de la page
|
||||
de réglages du plugin (le plugin te l'affichera, comme pour YouTube). Format attendu :
|
||||
```
|
||||
https://staging2.karaokeclip.video/wp-admin/admin.php?page=kcp-settings
|
||||
```
|
||||
> Quand tu passeras en production, ajoute **aussi** l'URL du domaine final `https://karaokeclip.video/...`.
|
||||
> Meta refuse toute redirection non listée ici — c'est la cause n°1 d'échec de connexion.
|
||||
|
||||
### Étape 9 — Récupérer App ID + App Secret
|
||||
**Settings → Basic** :
|
||||
- **App ID** → tu le colleras dans le réglage `meta_app_id` du plugin.
|
||||
- **App Secret** (bouton *Show*) → réglage `meta_app_secret` (champ mot de passe, jamais réaffiché — comme le secret Google).
|
||||
- Renseigne au passage : **Privacy Policy URL**, **Terms of Service URL**, **App Domain**, catégorie. Ces champs
|
||||
sont **obligatoires pour l'App Review** (étape 10) ; autant les remplir tout de suite.
|
||||
|
||||
### Permissions dont le plugin aura besoin
|
||||
Tu n'as rien à « cocher » manuellement ici : le plugin les demandera dans son flux OAuth. Mais pour information,
|
||||
et pour l'App Review, ce sont :
|
||||
|
||||
| Permission | À quoi elle sert |
|
||||
|---|---|
|
||||
| `pages_show_list` | lister tes Pages pour choisir la bonne |
|
||||
| `pages_read_engagement` | lire les infos de la Page |
|
||||
| `pages_manage_posts` | **publier la vidéo** sur la Page |
|
||||
| `business_management` | accéder au portefeuille pro / liaison IG |
|
||||
| `instagram_basic` | lire le compte IG Business lié |
|
||||
| `instagram_content_publish` | **publier les Reels** Instagram |
|
||||
|
||||
---
|
||||
|
||||
## PARTIE 3 — Connexion depuis le plugin (au palier B)
|
||||
|
||||
Une fois le palier B livré, le processus côté plugin sera **calqué sur YouTube** :
|
||||
1. Réglages → colle **App ID** + **App Secret** → **Enregistrer**.
|
||||
2. Clique **« Se connecter à Meta »** → fenêtre de consentement Facebook → autorise Page + Instagram.
|
||||
3. Le plugin échange le code, obtient un **jeton longue durée (~60 jours)**, en dérive le **Page token** et
|
||||
détecte automatiquement l'**IG Business Account ID** lié. Il stocke tout dans une **option dédiée**
|
||||
(jamais dans le blob de réglages — précaution anti-effacement, cf. passation §9.1).
|
||||
4. Si tu as plusieurs Pages / comptes IG, un menu déroulant te laissera choisir la cible.
|
||||
|
||||
> **Durée de vie du jeton** : ~60 jours pour le jeton utilisateur longue durée ; le **Page token** qui en dérive
|
||||
> peut être de très longue durée. Le plugin surveillera l'expiration et t'alertera s'il faut reconnecter
|
||||
> (exactement comme le rappel hebdo de Google en mode Test).
|
||||
|
||||
---
|
||||
|
||||
## PARTIE 4 — Passage en production (App Review + Business Verification)
|
||||
|
||||
Tant que l'app est en **mode Développement**, elle ne peut publier que via des comptes ayant un **rôle sur l'app**
|
||||
(admin / développeur / testeur). **C'est parfait pour tester tout le palier B sur staging** sans validation Meta.
|
||||
|
||||
Pour publier **publiquement** (mode Live), Meta demande :
|
||||
1. **Business Verification** du portefeuille (documents d'entreprise) — via Business Manager.
|
||||
2. **App Review** des permissions avancées (`pages_manage_posts`, `instagram_content_publish`, etc.) :
|
||||
Meta demande une **vidéo de démonstration** montrant le parcours, et des **URL publiques** de politique de
|
||||
confidentialité / conditions d'utilisation (d'où l'étape 9).
|
||||
3. App en mode **Live**.
|
||||
|
||||
> Rien de tout cela ne bloque le développement : on code et on teste **maintenant** en mode Dev.
|
||||
> La revue se déclenche quand le site quitte le staging.
|
||||
|
||||
---
|
||||
|
||||
## Récapitulatif « ce que tu me fourniras » (au palier B)
|
||||
|
||||
- **App ID** et **App Secret** (tu les colles dans le plugin, tu ne me les envoies pas en clair ici).
|
||||
- Confirmation que la **Page FB** existe et que l'**Instagram Business** y est **lié**.
|
||||
- L'**URI de redirection** ajoutée dans l'app (le plugin te donnera la valeur exacte à coller).
|
||||
|
||||
Le reste (Page ID, IG Business ID, jetons) est récupéré **automatiquement** par le plugin. Tu n'as pas à les chercher.
|
||||
|
||||
*Fin du guide Meta.*
|
||||
Reference in New Issue
Block a user