RTB — Thème & extensions WordPress

Thème WordPress de la Radiodiffusion Télévision du Burkina (RTB) : moderne, rapide et accessible, accompagné de huit extensions maison (recherche instantanée, assistant de contenu, SEO, API mobile, multilingue, double authentification, direct écrit, édition en direct).

Ce dépôt contient le thème et les extensions — pas le cœur de WordPress (déjà open source). Voir Démarrage rapide.

---

Sommaire

• Aperçu
• Fonctionnalités
• Pré-requis
• Démarrage rapide
• Installation sur un WordPress existant
• Configuration
• Internationalisation
• Structure du dépôt
• Les extensions
• Déploiement
• Contribuer
• Licence

---

Aperçu

• Stack : WordPress (PHP 8.1+), Alpine.js (auto-hébergé), CSS à design-tokens, Font Awesome auto-hébergé.
• Aucune dépendance CDN pour le JS/CSS critique : tout est servi depuis le serveur.
• Multilingue intégré (extension maison rtb-i18n, aucune dépendance tierce) : français + langues nationales (mooré, dioula, fulfuldé, gulmancéma) + anglais.
• Accessibilité soignée et performances élevées (cache de page côté serveur, images via CDN d'images, préchargement LCP).

Fonctionnalités

• Page d'accueil dynamique : hero vidéo, « Le Journal », « Nos Antennes », « À la Une », radio.
• Le Direct TV (flux par chaîne) + Radio en ligne, gérables depuis l'admin, avec repli vidéo.
• Replays / émissions (JT 13H/19H/20H, magazines) avec lecture vidéo.
• Articles + documents PDF (comptes rendus du Conseil des ministres) lus dans la page et indexés pour la recherche.
• Mode sombre, responsive mobile/tablette, page À propos éditable en direct.

Pré-requis

• WordPress 7.0+
• PHP 8.1+ (8.3 recommandé) avec mbstring
• MySQL/MariaDB
• (optionnel) poppler-utils (pdftotext) pour extraire le texte des PDF

Démarrage rapide « tout inclus » (cœur WordPress compris)

Le cœur WordPress n'est pas stocké dans ce dépôt (il est déjà open source), mais il est récupéré automatiquement à l'installation — deux façons, sans configuration manuelle :

A. Docker (recommandé) — site complet en une commande :

git clone https://github.com/onassgroupe/rtb-wordpress-theme && cd rtb-wordpress-theme
docker compose up -d
# → http://localhost:8080   (admin / admin) — cœur WP + thème + extensions déjà actifs

B. WP-CLI (sans Docker) — télécharge le cœur, installe et active tout :

git clone https://github.com/onassgroupe/rtb-wordpress-theme && cd rtb-wordpress-theme
DB_USER=root DB_PASS=secret bash install-full.sh
# → crée ./rtb-site (WordPress complet) avec le thème + extensions actifs

Installation sur un WordPress existant

Sur un site WordPress déjà en place, greffez le thème et les extensions dans wp-content/.

cd votre-site/wp-content
git clone https://github.com/onassgroupe/rtb-wordpress-theme rtb-src

# Lier (dev) ou copier (prod) le thème, les plugins et les mu-plugins
ln -s "$(pwd)/rtb-src/wp-content/themes/rtb"              themes/rtb
ln -s "$(pwd)/rtb-src/wp-content/plugins/rtb-search"      plugins/rtb-search
ln -s "$(pwd)/rtb-src/wp-content/plugins/rtb-chat"        plugins/rtb-chat
ln -s "$(pwd)/rtb-src/wp-content/plugins/rtb-seo"         plugins/rtb-seo
ln -s "$(pwd)/rtb-src/wp-content/plugins/rtb-api"         plugins/rtb-api
ln -s "$(pwd)/rtb-src/wp-content/plugins/rtb-i18n"        plugins/rtb-i18n
ln -s "$(pwd)/rtb-src/wp-content/plugins/rtb-2fa"         plugins/rtb-2fa
ln -s "$(pwd)/rtb-src/wp-content/plugins/rtb-liveblog"    plugins/rtb-liveblog
ln -s "$(pwd)/rtb-src/wp-content/plugins/onass-live-edit" plugins/onass-live-edit
cp    rtb-src/wp-content/mu-plugins/*.php                 mu-plugins/

Puis, avec WP-CLI : bash wp-content/rtb-src/setup.sh (active thème + extensions, crée les langues, rafraîchit les permaliens). Ou manuellement dans wp-admin : activer le thème RTB, puis RTB Search, RTB Assistant, RTB SEO, RTB API, RTB i18n, RTB 2FA, RTB Live Blog, Onass Live Edit, enregistrer les permaliens, puis Outils → Assistant RTB → Apprendre le contenu.

Configuration

• Contenus & identité : Apparence → Personnaliser → RTB (contact, réseaux, ticker, hero, radio, À propos…).
• Direct / Radio : champs sur les fiches Antenne et Station (URL de flux, repli vidéo).
• Assistant : Outils → Assistant RTB → Apprendre le contenu (construit le lexique de correction des fautes de frappe).
• Variables d'environnement : copier .env.example → .env (voir docs/DEPLOY.md).

Internationalisation (multilingue)

Le multilingue est intégré via l'extension maison rtb-i18n — aucune dépendance tierce. Elle fournit : chaînes traduisibles (rtb_t()), préfixe d'URL par langue, balises hreflang automatiques et sélecteur de langue. Sans aucune configuration, le site fonctionne en français.

Langues prêtes : Français (défaut), English, Mooré (mos), Dioula (dyu), Fulfuldé (ff), Gulmancéma (gux). Les traductions des chaînes du thème et des contenus (articles / émissions) se gèrent directement depuis l'administration.

Le multilingue est natif au projet : pas de plugin tiers à installer ni à maintenir.

Structure du dépôt

wp-content/
├── themes/rtb/            Thème principal (templates, assets, inc/)
├── plugins/
│   ├── rtb-search/        Moteur de recherche (pertinence + instantané)
│   ├── rtb-chat/          Assistant de contenu (100 % local)
│   ├── rtb-seo/           SEO (OpenGraph, JSON-LD, hreflang…)
│   ├── rtb-api/           API REST (rtb/v1) pour l'application mobile
│   ├── rtb-i18n/          Couche multilingue maison (rtb_t, hreflang)
│   ├── rtb-2fa/           Double authentification (e-mail + SMS)
│   ├── rtb-liveblog/      Direct écrit (live blog temps réel)
│   └── onass-live-edit/   Édition en direct via le Customizer
└── mu-plugins/            Cache de page, /login propre, récupération admin
deploy/                    Dockerfile, docker-compose, config (déploiement Coolify)
docs/                      Installation, déploiement, architecture

Les extensions

Extension	Rôle	POO
rtb-search	Recherche pondérée (titre > corps), tolérante pluriels/accents, instantanée au fil de la frappe, analytics tendances.	✅
rtb-chat	Assistant qui répond à partir du contenu du site (recherche, résumé extractif, direct, programmes) — entièrement local, sans service externe.	✅
rtb-seo	Meta/canonical/robots, Open Graph, Twitter Cards, JSON-LD (NewsArticle, VideoObject, Organization, fil d'Ariane), hreflang.	✅
rtb-api	API REST (namespace rtb/v1) qui alimente l'application mobile : articles, émissions, direct, recherche — protégée par clé API et limiteur de débit.	✅
rtb-i18n	Couche multilingue maison : helper de traduction rtb_t(), préfixe d'URL par langue, hreflang, sélecteur de langue — sans dépendance tierce.	✅
rtb-2fa	Double authentification à la connexion : code à usage unique par e-mail et SMS (passerelle configurable dans l'admin), durcissement de l'accès.	✅
rtb-liveblog	Direct écrit (live blog) : fil mis à jour en temps réel (sondage micro-mis en cache 3 s), points clés, images, schema.org LiveBlogPosting — web et mobile.	✅
onass-live-edit	Édition inline des contenus via le Customizer WordPress.	—

Détails techniques : docs/ARCHITECTURE.md.

Déploiement

Exemple complet (Docker + Coolify) dans docs/DEPLOY.md et le dossier deploy/.

Contribuer

Les contributions sont bienvenues — voir CONTRIBUTING.md.

Licence

GPL-2.0-or-later — comme WordPress. Font Awesome est sous ses propres licences (SIL OFL 1.1 pour les polices, MIT pour le code).