From 4c78782a389723d6a580e23af2e1b0a61b2dfc79 Mon Sep 17 00:00:00 2001
From: emanuelegori <emanuelegori@proton.me>
Date: Fri, 5 Dec 2025 23:23:51 +0100
Subject: [PATCH] Update README with architecture explanation

---
 README.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/README.md b/README.md
index 60153f9..8150569 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,17 @@
 
 Plugin WordPress per mostrare un box che permette agli utenti di seguire l'autore nel Fediverso.
 
+## ⚠️ Importante: Architettura v2.x
+
+**A partire dalla v2.0**, il JavaScript è integrato direttamente nel file PHP invece di essere un file separato. Questo garantisce il corretto funzionamento quando il plugin viene inserito dinamicamente nel DOM.
+
+**File attivi:**
+- ✅ `fediverso-box.php` (HTML + JavaScript integrato)
+- ✅ `fediverso-style.css` (CSS)
+
+**File deprecati:**
+- 📁 `legacy/fediverso-script.js` (mantenuto solo per riferimento storico)
+
 ## Caratteristiche
 
 - ✅ Form per inserire istanza Mastodon
@@ -10,6 +21,7 @@ Plugin WordPress per mostrare un box che permette agli utenti di seguire l'autor
 - ✅ Validazione input
 - ✅ Responsive design
 - ✅ Debug mode attivabile
+- ✅ JavaScript caricato globalmente (compatibile con inserimento dinamico)
 
 ## Installazione
 
@@ -28,6 +40,9 @@ Plugin WordPress per mostrare un box che permette agli utenti di seguire l'autor
 [fediverso_box]
 ```
 
+### Via Custom Plugin (inserimento dinamico)
+Il plugin è compatibile con il sistema universale di inserimento del Custom Plugin.
+
 ## Configurazione
 
 Modifica l'handle dell'autore in `fediverso-box.php`:
@@ -42,6 +57,19 @@ Per attivare i log in console:
 define('FEDIVERSO_BOX_DEBUG', true);
 ```
 
+## Changelog
+
+### v2.1 (Current - Production)
+- JavaScript integrato nel PHP
+- Funzione globale `window.initFediversoBox()`
+- Compatibilità con inserimento dinamico nel DOM
+- Debug mode con flag attivabile
+- Codice production-ready (nessun log in console)
+
+### v1.2 (Legacy)
+- JavaScript in file separato
+- Funzionamento solo con caricamento statico
+
 ## Versione
 
 v2.1 (Production)