📚 Documentation

Documentation

Guides d'installation, configuration et utilisation de nos plugins WordPress.

← Tous les plugins
🎬

Real Video Listing for Listeo & WooCommerce

Version 1.0.0

Documentation - Guide complet

Tout ce que vous devez savoir sur le système de vidéos sociales pour Listeo

1

Qu'est-ce que Real Video Listing for Listeo ?

Real Video Listing for Listeo est un système qui permet aux vendeurs de connecter leurs comptes sociaux (YouTube, TikTok, Instagram, Facebook) via OAuth sécurisé et d'afficher automatiquement leurs dernières vidéos sur leurs listings Listeo.

📺

YouTube

Vidéos et Shorts

🎵

TikTok

Toutes vos vidéos

📸

Instagram

Reels et vidéos

👥

Facebook

Reels et vidéos

🎯 Fonctionnalités principales

  • ✅ Connexion OAuth sécurisée - Les vendeurs connectent leurs comptes en un clic
  • ✅ Synchronisation automatique - Les nouvelles vidéos sont récupérées automatiquement
  • ✅ 4 plateformes - YouTube, TikTok, Instagram et Facebook
  • ✅ Sélection des vidéos - Le vendeur choisit les vidéos à afficher par listing
  • ✅ RVLL - Enregistrement vidéo/photo - Le vendeur peut enregistrer ou importer directement
  • ✅ Affichage flexible - 6 styles d'affichage (cercle, carré, portrait, etc.)
  • ✅ Player modal style TikTok - Lecture plein écran avec swipe
  • ✅ Page Reels dédiée - Shortcode pour créer une page publique
  • ✅ Traductions - Français et anglais inclus
2

Plateformes supportées

Le plugin supporte les 4 principales plateformes de partage de vidéos avec leurs spécificités.

📺 YouTube

  • Vidéos classiques
  • YouTube Shorts (détection auto)
  • API YouTube Data v3
  • Quota : ~10,000 unités/jour

🎵 TikTok

  • Toutes les vidéos du compte
  • API TikTok v2
  • App Review obligatoire
  • Scopes : video.list

📸 Instagram

  • Reels et vidéos
  • Instagram Graph API
  • ⚠️ Compte Business/Creator requis
  • App Review Meta obligatoire

👥 Facebook

  • Reels Facebook
  • Vidéos classiques
  • Facebook Graph API v18
  • Support des Pages
3

⚙️ Configuration des APIs (Admin)

L'administrateur doit configurer les clés API pour chaque plateforme que les vendeurs pourront utiliser.

📺 Configuration YouTube

  1. Allez sur Google Cloud Console
  2. Créez un projet et activez YouTube Data API v3
  3. Allez dans Identifiants → Créer → ID client OAuth
  4. Type : Application Web
  5. URI de redirection : https://costaplugin.com/rvl-oauth/youtube/
  6. Copiez Client ID et Client Secret dans le plugin

🎵 Configuration TikTok

  1. Allez sur TikTok for Developers
  2. Créez une application et ajoutez Login Kit
  3. Configurez les scopes : user.info.basic, video.list
  4. URL de redirection : https://costaplugin.com/rvl-oauth/tiktok/
  5. ⚠️ Soumettez pour App Review (obligatoire)

📸 Configuration Instagram

⚠️ Important : Les vendeurs doivent avoir un compte Instagram Business ou Creator.
  1. Allez sur Meta for Developers
  2. Créez une app de type Business
  3. Ajoutez le produit Instagram Graph API
  4. Permissions : instagram_basic, instagram_manage_insights
  5. URI OAuth : https://costaplugin.com/rvl-oauth/instagram/
  6. ⚠️ App Review Meta obligatoire

👥 Configuration Facebook

  1. Utilisez la même app Meta que pour Instagram
  2. Ajoutez le produit Facebook Login
  3. Permissions : pages_show_list, pages_read_engagement, user_videos
  4. URI de redirection : https://costaplugin.com/rvl-oauth/facebook/
4

🔐 Connexion OAuth pour les vendeurs

Voici comment un vendeur connecte ses comptes sociaux dans son dashboard Listeo.

1

Accéder à "Mes Vidéos Sociales"

Dans le dashboard vendeur, une nouvelle section "Mes Vidéos Sociales" apparaît.

2

Cliquer sur "Connecter"

Choisir la plateforme souhaitée et cliquer sur le bouton "Connecter".

3

Autoriser l'accès

Le vendeur est redirigé vers la plateforme pour autoriser l'accès à ses vidéos.

4

Synchronisation automatique

Le token est sauvegardé et les vidéos sont synchronisées immédiatement.

🔒 Sécurité du processus

🔑

OAuth 2.0

Protocole standard sécurisé

⏱️

Tokens à expiration

Refresh automatique

🛡️

State crypté

Protection CSRF

5

🔄 Synchronisation des vidéos

Le plugin synchronise automatiquement les vidéos via un cron WordPress configurable.

⏰ Intervalles de synchronisation

⚡

Toutes les heures

Pour les sites actifs

🕐

2 fois par jour

Équilibre optimal

📅

Une fois par jour

Économie de quotas API

👆 Synchronisation manuelle

Les vendeurs peuvent aussi synchroniser manuellement :

  • Bouton "Sync" à côté de chaque plateforme connectée
  • Récupère immédiatement les dernières vidéos
  • Utile après avoir publié une nouvelle vidéo
6

🎬 Affichage sur les listings

Les vendeurs sélectionnent les vidéos à afficher lors de l'édition de leurs listings.

✅ Sélection des vidéos

  1. Lors de l'édition d'un listing, une section "Vidéos" apparaît
  2. Toutes les vidéos synchronisées s'affichent sous forme de grille
  3. Cliquer sur une vidéo pour la sélectionner/désélectionner
  4. Ou utiliser "Ajouter les X dernières" pour auto-sélectionner
  5. Sauvegarder le listing pour appliquer les changements

🎨 Styles d'affichage des vignettes

○

Cercle

Style Instagram Stories

□

Carré

Classique 1:1

▯

Portrait

TikTok / Reels

▭

Paysage

YouTube classique

Compact

Petites vignettes

📋

Large

Grande avec infos

7

🎬 RVLL - Enregistrement vidéo & photo

RVLL (Real Video Local Listing) permet aux vendeurs d'enregistrer des vidéos/photos directement depuis leur navigateur ou d'importer des fichiers, sans passer par les réseaux sociaux.

🎥

Enregistrement vidéo

Webcam avec durée configurable

📷

Capture photo

Photo transformée en vidéo courte

📁

Import fichier

Vidéo/photo depuis l'ordinateur

⚙️ Options configurables (Admin)

  • Durée max vidéo - Limite en secondes (ex: 60s)
  • Durée photo - Temps d'affichage de la photo en vidéo
  • Filigrane - Texte personnalisable sur les vidéos
  • Emojis - Permettre l'ajout d'emojis
  • Texte overlay - Permettre l'ajout de texte
  • Filtres vidéo - Effets visuels (sépia, noir et blanc, etc.)
  • Stockage - Local ou cloud (S3, Bunny CDN)

📱 Interface style TikTok

L'interface d'enregistrement s'ouvre en plein écran avec un design moderne inspiré de TikTok. Sur mobile, l'expérience est optimisée avec navigation par swipe. Le vendeur peut prévisualiser sa vidéo avant de la publier sur un de ses listings.

8

📝 Shortcodes disponibles

Utilisez ces shortcodes pour afficher les vidéos où vous le souhaitez.

[rvl_videos]

Affiche les vidéos de listings avec de nombreuses options de personnalisation.

Attribut Description Défaut
listing_id ID d'un listing spécifique -
listing_ids IDs de plusieurs listings (séparés par virgules) -
category Filtrer par catégorie de listing -
platform Filtrer par plateforme (youtube, tiktok, instagram, facebook, rvll) -
limit Nombre de vidéos à afficher 12
columns Nombre de colonnes (1-6) 3
template Template: grid, masonry, carousel grid
show_listing Afficher les infos du listing (yes/no) yes
show_badge Afficher le badge de plateforme (yes/no) yes
order Ordre: recent, oldest, random recent

[rvl_reels_page]

Crée une page de découverte style Reels/TikTok avec toutes les vidéos du site.

Configuration dans Real Video → Page Reels (colonnes, style, couleurs, etc.)

💡 Exemples d'utilisation

// Vidéos d'un listing spécifique
[rvl_videos listing_id="123"]
// Vidéos de plusieurs listings
[rvl_videos listing_ids="123,456,789" limit="9" columns="3"]
// Seulement les vidéos TikTok
[rvl_videos platform="tiktok" limit="6" columns="2"]
// Vidéos d'une catégorie
[rvl_videos category="restaurants" template="carousel"]
// Page Reels publique
[rvl_reels_page]
9

💬 Système de Commentaires & Likes

Le plugin inclut un système complet d'engagement avec commentaires et likes sur chaque vidéo, permettant aux visiteurs d'interagir avec le contenu.

🎯 Fonctionnalités incluses

💬

Commentaires

Avec réponses imbriquées

👍

Likes / Dislikes

Vote par utilisateur

🏷️

Badge Vendeur

Identifie le propriétaire

⚙️ Contrôles disponibles

  • Admin : Active/désactive les commentaires globalement dans les paramètres
  • Vendeur : Peut activer/désactiver les commentaires pour chaque listing individuellement
  • Vendeur : Peut supprimer les commentaires sur ses propres listings
  • Utilisateur : Peut supprimer ses propres commentaires
  • Protection : Anti-spam intégré (max 5 commentaires par minute)

🗄️ Tables de base de données

wp_rvl_video_comments

Stocke tous les commentaires avec ID vidéo, utilisateur, contenu, parent (réponses), et statut.

wp_rvl_video_likes

Stocke les votes (like/dislike) par utilisateur et par vidéo avec contrainte d'unicité.

10

📱 Player Fullscreen style TikTok

Le plugin inclut un lecteur vidéo plein écran moderne inspiré de TikTok et Instagram Reels. Ce player s'ouvre automatiquement quand un visiteur clique sur une vidéo.

🎬 Fonctionnalités du Player

👆

Swipe

Navigation tactile

⌨️

Clavier

Flèches haut/bas

🌙

Thème

Clair / Sombre

💬

Intégré

Commentaires & likes

📋 Éléments affichés

  • Vidéo/Photo : Lecteur HTML5 ou embed selon la plateforme
  • Infos listing : Image, titre, catégorie, note et avis
  • Badge plateforme : YouTube, TikTok, Instagram, Facebook ou RVLL
  • Compteur : Position actuelle et nombre total de vidéos
  • Actions : Voir le listing, partager, commentaires, likes
  • Lien externe : "Voir sur YouTube/TikTok/etc." pour les vidéos externes

📷 Support des photos RVLL

Les photos capturées avec RVLL sont affichées dans le player comme des "vidéos". Chaque photo a une durée configurable (par défaut 20 secondes) pendant laquelle elle reste affichée avant de passer automatiquement à la vidéo suivante.

11

☁️ Options de stockage pour RVLL

Les vidéos et photos enregistrées avec RVLL peuvent être stockées de différentes façons selon vos besoins et votre infrastructure.

💾 Stockage Local (par défaut)

  • Dossier : /wp-content/uploads/rvll-videos/
  • Photos : /wp-content/uploads/rvll-videos/photos/
  • Thumbnails générés automatiquement
  • Aucune configuration requise

☁️ Amazon S3

  • Stockage cloud évolutif
  • Signature AWS v4 intégrée
  • Configuration : Access Key, Secret, Bucket, Région
  • Permissions ACL automatiques (public-read)

🌊 Wasabi (S3-compatible)

  • Alternative économique à S3
  • Compatible API S3
  • Configuration identique à S3
  • Endpoint : s3.{region}.wasabisys.com

🎬 Vimeo (vidéos uniquement)

  • Upload via protocole TUS
  • Thumbnails générés par Vimeo
  • Scopes requis : upload, edit
  • ⚠️ Les photos utilisent le stockage local

🗑️ Auto-suppression (style Stories)

Les vidéos et photos RVLL peuvent être automatiquement supprimées après un délai configurable :

  • Vidéos : 24h, 48h, 72h, 1 semaine, 1 mois ou permanent
  • Photos : Délai configurable séparément
  • Cron WordPress : Exécution horaire pour nettoyer les fichiers expirés
  • Suppression complète : Fichier + thumbnail + entrée base de données + retrait des listings
12

🛒 Intégration WooCommerce

Le plugin est compatible avec WooCommerce et peut ajouter automatiquement les menus vidéos dans la page Mon Compte de WooCommerce.

⚙️ Activation

  1. Allez dans Real Video → Paramètres → WooCommerce
  2. Cochez Activer l'intégration WooCommerce
  3. Configurez les libellés et positions des menus
  4. Enregistrez et allez dans Réglages → Permaliens pour actualiser

📋 Menu Mon Compte

Une fois activé, les menus suivants sont ajoutés automatiquement :

  • Mes Vidéos - Gestion des connexions aux plateformes et des vidéos
  • Paramètres Vidéo - Configuration du style d'affichage et auto-publication
  • Mon Profil Vidéo - Configuration de l'image de profil, couverture et bio

👤 Profil RVLL - Publication sans Listing

Pour les utilisateurs sans listings (WooCommerce pur), ils peuvent publier leurs vidéos sur leur Profil RVLL :

  • Dans l'enregistreur vidéo RVLL, une option "Mon Profil RVLL" apparaît dans la liste des destinations
  • Les vidéos/photos publiées sur le profil sont visibles sur la page publique de l'utilisateur
  • Le clic sur une vidéo ouvre le player fullscreen avec les informations de l'utilisateur

🌐 Page Profil Publique

Chaque utilisateur a une page de profil publique avec :

  • Image de couverture - Personnalisable depuis Mon Compte
  • Photo de profil - Avec gravatar par défaut
  • Bio / Description - Texte de présentation
  • Grille de médias - Toutes les vidéos et photos avec filtres (Tout, Vidéos, Photos, Plateforme)

Créez la page automatiquement dans Real Video → Paramètres → WooCommerce

🔗 Shortcodes de Menu

Pour une intégration personnalisée (thème, page builder, etc.) :

Shortcode Description
[rvl_menu_videos] Lien vers la page Mes Vidéos
[rvl_menu_settings] Lien vers la page Paramètres Vidéo
[rvl_menu_profile] Lien vers la page Profil Vidéo
[rvl_menu_full style="list"] Menu complet (styles : list, buttons, inline)
[rvl_my_videos_content] Contenu complet de la page Mes Vidéos
[rvl_user_profile_page] Page de profil publique de l'utilisateur (basée sur l'URL)
[rvl_user_profile user_id="123"] Affiche le profil d'un utilisateur spécifique

Attributs disponibles : class="ma-classe" icon="1" text="Mon texte"

✅ Compatibilité

  • Fonctionne en parallèle avec Listeo sans conflit
  • Les pages Listeo restent actives
  • WooCommerce 5.0+ requis
  • Compatible avec les thèmes WooCommerce standards
13

👤 Page Profil Vendeur Public

Chaque vendeur peut avoir une page de profil publique où tous ses médias (vidéos et photos) sont affichés. Cette page est accessible via une URL personnalisée.

📋 Deux types de profil disponibles

🏪 Profil Vendeur Listeo

  • Pour les vendeurs avec listings Listeo
  • URL : /vendor-profile/nom-utilisateur/
  • Avatar = Photo de profil Listeo
  • Affiche vidéos de tous les listings
  • Création dans Real Video → Shortcode & Page

🛒 Profil Utilisateur WooCommerce

  • Pour les utilisateurs WooCommerce
  • URL : /video-profile/nom-utilisateur/
  • Avatar = Gravatar ou photo uploadée
  • Affiche vidéos publiées sur le profil
  • Création dans Real Video → WooCommerce

🎨 Éléments personnalisables

🖼️

Photo de couverture

Upload simple depuis téléphone/PC

👤

Photo de profil

Listeo : avatar du thème
WooCommerce : upload ou Gravatar

✍️

Bio / Description

Texte de présentation libre

⚙️ Configuration par le vendeur

Le vendeur configure son profil depuis son dashboard :

  • Listeo : Dashboard → Mes Vidéos → Section "Mon Profil Vidéo Public"
  • WooCommerce : Mon Compte → Mon Profil Vidéo
  • Upload de la photo de couverture (max 5MB, formats image)
  • Saisie de la bio/description
  • Bouton "Supprimer" pour retirer une image uploadée
  • Lien direct vers "Voir mon profil" pour prévisualiser

🔗 Accès depuis les listings

Un lien "Voir profil vidéo" apparaît automatiquement sur chaque listing :

  • Positionné à côté du compteur vidéos/photos
  • Redirige vers la page profil du vendeur
  • Visible uniquement si la page profil est créée

🔒 Sécurité de l'upload

L'upload des images utilise un système sécurisé :

  • Upload simple : Pas d'accès à la médiathèque WordPress
  • Validation type : Uniquement images (JPEG, PNG, GIF, WEBP)
  • Limite taille : Maximum 5 Mo par fichier
  • Propriétaire : Image associée à l'utilisateur dans la médiathèque
  • Nonce AJAX : Protection contre les requêtes malveillantes
14

Modération & Détection NSFW

Le système de modération permet à l'administrateur de contrôler les vidéos et photos publiées par les vendeurs. Il inclut la détection automatique de contenu inapproprié (NSFW) et un workflow de modération complet.

ADMIN 📋 Page de Modération Admin

Accessible via Real Video → Modération Vidéos, cette page permet à l'admin de :

  • 👁️ Voir tous les médias des vendeurs (Listeo + WooCommerce)
  • ✅ Approuver - Publier le contenu
  • ⏳ Mettre en attente - Nécessite une révision
  • ❌ Rejeter - Contenu non conforme
  • 🚫 Signaler NSFW - Contenu inapproprié détecté
  • 🗑️ Supprimer - Suppression définitive
  • 💬 Gérer les commentaires et voir les likes/dislikes

🏷️ Statuts de modération

✅

Approuvé

Visible publiquement

⏳

En attente

Non sélectionnable

❌

Rejeté

Caché du public

🚫

NSFW

Contenu inapproprié

👤 Comportement côté vendeur

Sur la page de gestion des vidéos du listing :

  • 📺 Le vendeur voit toutes ses vidéos (y compris en attente/rejetées)
  • 🔒 Les vidéos non approuvées ont un overlay visuel avec le statut
  • 🚫 Sélection désactivée pour les vidéos en attente/rejetées/NSFW
  • 💬 Un message explicatif s'affiche au clic sur une vidéo bloquée
  • 📤 Seules les vidéos approuvées peuvent être publiées sur le listing

🔍 Détection NSFW automatique

Le plugin supporte deux API de détection NSFW :

Sightengine

API professionnelle avec détection avancée de nudité, violence, etc.

ModerateContent

Alternative économique pour la détection de contenu adulte.

⚙️ Options de détection :

  • À l'upload : Bloque l'envoi si NSFW détecté (optionnel)
  • Auto-signalement : Marque automatiquement comme "flagged" si NSFW
  • Seuil configurable : Sensibilité de détection (0.5 à 0.9)
  • À la publication : Vérifie NSFW quand le vendeur publie sur un listing

⏰ Scan automatique (Cron)

Un job cron peut scanner automatiquement les nouveaux médias :

  • 🕐 Fréquence configurable : Toutes les heures, 2x/jour, quotidien, hebdo
  • 📊 Limite par exécution : Nombre de médias scannés par run (évite timeouts)
  • 🔄 Sources scannées : Listings, profils utilisateurs, table RVLL
  • 🚩 Auto-flag : Les médias NSFW sont automatiquement signalés

📝 Workflow de modération

1
Upload par le vendeur

Vidéo/photo enregistrée ou importée → Scan NSFW optionnel

2
Statut initial

Approuvé (si pas de NSFW) ou Flagged/Pending (si NSFW détecté)

3
Révision admin

L'admin examine le contenu et applique une action (approuver, rejeter, etc.)

4
Publication

Seul le contenu approuvé est visible sur le listing/profil public

⚙️ Configuration

Configurez la détection NSFW dans Real Video → Modération Vidéos :

  • 📡 Fournisseur API : Sightengine ou ModerateContent
  • 🔑 Clés API : API User et API Key (selon le fournisseur)
  • 📏 Seuil de détection : Score à partir duquel le contenu est signalé
  • 🚫 Bloquer à l'upload : Empêche l'envoi si NSFW détecté
  • 🏷️ Auto-signalement : Marque automatiquement les contenus suspects
  • ⏰ Scan automatique : Active le cron avec fréquence et limite configurables
15

Questions fréquentes (FAQ)

❓ Les comptes Instagram personnels fonctionnent-ils ?

Non, Instagram Graph API ne supporte que les comptes Business ou Creator. Les vendeurs doivent convertir leur compte (gratuit, prend 1 minute dans les paramètres Instagram).

❓ Les vidéos sont-elles hébergées sur mon serveur ?

Non, les vidéos restent sur leurs plateformes d'origine (YouTube, TikTok, etc.). Seules les métadonnées (titre, miniature, URL) sont stockées. Les embeds officiels sont utilisés pour l'affichage.

❓ Combien de vidéos peuvent être affichées ?

Par défaut, 5 vidéos par listing. Ce nombre est configurable dans Real Video → Paramètres → Général (entre 1 et 20).

❓ Pourquoi TikTok demande une App Review ?

TikTok exige une review de votre application avant d'autoriser l'accès aux vidéos des utilisateurs. Vous devez soumettre une démo et justifier l'usage. En mode Sandbox, seuls les testeurs peuvent se connecter.

❓ Comment forcer une synchronisation ?

Le vendeur peut cliquer sur le bouton "Sync" à côté de chaque plateforme connectée dans son dashboard. L'admin peut aussi utiliser le bouton "Synchroniser maintenant" dans le tableau de bord admin.

❓ Comment déconnecter un compte ?

Dans le dashboard vendeur, section "Mes Vidéos Sociales", cliquer sur le bouton rouge (icône unlink) à côté de la plateforme. Les vidéos de cette plateforme seront supprimées des listings.

❓ Qu'est-ce que RVLL ?

RVLL (Real Video Local Listing) est une fonctionnalité qui permet aux vendeurs d'enregistrer des vidéos ou photos directement depuis leur navigateur, sans avoir besoin de comptes sur les réseaux sociaux. Les fichiers peuvent aussi être importés depuis l'ordinateur.

❓ Où sont stockées les vidéos RVLL ?

Par défaut, les vidéos RVLL sont stockées localement sur votre serveur dans /wp-content/uploads/rvl-videos/. Vous pouvez configurer un stockage cloud (Amazon S3, Bunny CDN, etc.) dans les paramètres pour économiser de l'espace serveur.

❓ Quels styles d'affichage sont disponibles ?

Le plugin propose 6 styles d'affichage : Cercle (stories Instagram), Carré (classique), Portrait (Reels/TikTok), Paysage (YouTube), Compact (petites vignettes), et Large (grande vignette avec infos).

❓ Comment créer une page Reels publique ?

Créez une nouvelle page WordPress et ajoutez le shortcode [rvl_reels_page]. Configurez l'apparence dans Real Video → Page Reels (colonnes, style, couleurs, etc.). Cette page affichera toutes les vidéos publiées sur le site.

❓ Y a-t-il une limite de vidéos par listing ?

Oui, l'administrateur peut définir une limite globale dans Real Video → Paramètres → Général. Par défaut : 5 vidéos par listing. Cette limite s'applique à toutes les sources (API + RVLL combinées).

🎬

Besoin d'aide supplémentaire ?

Si quelque chose n'est pas clair ou si vous rencontrez un problème, n'hésitez pas à contacter le support. Nous sommes là pour vous aider !

✉️ Contacter le support

Besoin d'aide supplémentaire ?

Notre équipe est disponible pour vous accompagner.