🚨 DISCLAIMER

Version fonctionnelle mais non exempte de bugs

Cette version du plugin est fonctionnelle mais peut présenter des problèmes avec certains blocs Gutenberg, notamment au niveau du rendu CSS en front-end. Certains styles peuvent ne pas se charger correctement ou provoquer des conflits d'affichage. Utilisez ce plugin avec précaution sur des sites en production et testez minutieusement l'affichage avant mise en ligne.

effi Block Inserter

Un plugin WordPress qui permet d'insérer automatiquement des blocs Gutenberg dans le contenu de vos articles et pages selon des règles prédéfinies.

📋 Description

Le plugin effi Block Inserter vous permet de définir des règles d'insertion pour ajouter dynamiquement des blocs Gutenberg à vos contenus sans modifier manuellement chaque article ou page. Vous pouvez spécifier :

• Quel type de contenu cibler (articles, pages, CPT personnalisés)
• Quel bloc utiliser comme point d'ancrage
• À quelle occurrence du bloc effectuer l'insertion
• La position d'insertion (avant ou après le bloc cible)
• Quels blocs insérer

✨ Fonctionnalités

• 🎯 Ciblage précis : Choisissez le type de contenu et le bloc cible
• 📝 Interface intuitive : Configuration via l'éditeur Gutenberg natif
• 🔄 Injection dynamique : Les blocs sont injectés automatiquement au rendu
• 🎨 Support complet : Tous les blocs Gutenberg sont supportés
• ⚙️ Règles flexibles : Définissez plusieurs règles avec des conditions différentes
• 📱 Responsive : Les blocs injectés respectent le responsive design

🚀 Installation

1. Téléchargez le plugin
2. Uploadez le dossier effi-block-inserter dans /wp-content/plugins/
3. Activez le plugin dans l'administration WordPress
4. Accédez à Outils > Règles d'insertion pour commencer

📖 Utilisation

Créer une règle d'insertion

1. Allez dans Outils > Règles d'insertion
2. Cliquez sur Ajouter
3. Donnez un nom à votre règle
4. Configurez les paramètres dans la meta box :
   • Type de contenu cible : Sélectionnez article, page, ou un CPT
   • Type de bloc cible : Le bloc qui servira d'ancrage
   • Occurrence : À quelle occurrence du bloc (1ère, 2ème, etc.)
   • Position : Avant ou après le bloc cible
5. Dans l'éditeur, ajoutez les blocs que vous souhaitez insérer
6. Publiez la règle

Exemple concret

Pour insérer une publicité après le 2ème paragraphe de tous vos articles :

1. Type de contenu : Article (post)
2. Bloc cible : Paragraphe (core/paragraph)
3. Occurrence : 2
4. Position : Après
5. Blocs à insérer : Votre bloc de publicité

🛠️ Configuration technique

Structure des fichiers

effi-block-inserter/
├── effi-block-inserter.php    # Fichier principal
├── includes/
│   ├── post-types.php         # Enregistrement du CPT
│   ├── meta-boxes.php         # Interface d'administration
│   └── frontend-injection.php # Logique d'injection
└── src/
    ├── app.js                 # Interface React
    ├── app.css               # Styles admin
    └── index.js              # Point d'entrée

Hooks et filtres

Le plugin utilise une stratégie d'injection sophistiquée :

• Hook wp : Identification des règles applicables
• Hook wp_enqueue_scripts : Gestion temporaire du contenu pour les assets
• Filtre render_block : Injection réelle des blocs au rendu

Custom Post Type

Les règles sont stockées dans un CPT mpi_rule avec :

• Support de l'éditeur Gutenberg
• Meta box personnalisée pour la configuration
• Interface React intégrée

🔧 Développement

Prérequis

• WordPress 5.0+
• PHP 7.4+
• Node.js (pour le développement front-end)

Build des assets

npm install
npm run build

📝 Notes techniques

Gestion des assets CSS/JS

Le plugin utilise une stratégie particulière pour s'assurer que les styles et scripts des blocs injectés sont correctement chargés :

1. Injection temporaire : Le contenu des blocs est temporairement ajouté au post pour déclencher l'enqueue des assets
2. Restauration : Le contenu original est restauré pour éviter les doublons
3. Pré-rendu : Les blocs sont pré-rendus dans le <head> pour générer les styles

Limitations connues

• ⚠️ Problèmes potentiels de rendu CSS avec certains blocs tiers
• ⚠️ Conflits possibles avec des plugins de cache agressifs
• ⚠️ Les blocs dynamiques peuvent ne pas fonctionner parfaitement

🐛 Débogage

Pour activer les logs de débogage, ajoutez dans wp-config.php :

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

Les logs seront visibles dans /wp-content/debug.log avec le préfixe [MPI-DEBUG].

📄 Licence

Ce plugin est distribué sous licence GPLv2 ou ultérieure.

👨‍💻 Auteur

Cédric GIRARD
🌐 effi10.com

🔄 Version

1.0.0 - Version initiale fonctionnelle

⚠️ Rappel : Testez toujours sur un environnement de développement avant d'utiliser en production.