Update README with architecture explanation

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)