Passa al contenuto principale

Plugin WordPress

Il plugin Tidiko AI per WordPress integra il widget chat Preact nei siti WordPress senza modificare il tema.

Installazione

  1. Scaricare il plugin dalla dashboard Tidiko o dal repository GitHub
  2. Caricare in wp-content/plugins/ oppure installare via ZIP dall'admin WordPress
  3. Attivare il plugin
  4. Configurare UUID assistente/agente e credenziali dalla pagina impostazioni del plugin

Modalità di embed

Il plugin supporta due modalità di integrazione:

Modalità script (default)

Inietta lo script del widget Preact con Shadow DOM, come l'embed standard.

Modalità iframe

Embed tramite iframe con opzioni di personalizzazione:

  • Dimensioni e posizionamento
  • Icona personalizzata
  • Header CSP frame-ancestors per sicurezza
  • Pagina di personalizzazione embed (EmbedCustomizeController lato Laravel)

La modalità iframe è utile quando il tema WordPress ha conflitti CSS/JS con il widget.

Configurazione

Dalla pagina admin del plugin:

CampoDescrizione
UUID risorsaIdentificativo assistente o agente
Tipoassistant o agent
URL appURL base dell'applicazione Laravel
Modalità embedscript o iframe

Le impostazioni vengono passate al widget tramite variabili inline nel markup generato dal plugin.

Aggiornamenti recenti

  • v1.6.x: fix variabili inline widget settings, miglioramenti stabilità
  • v0.4.1+ (Laravel): opzioni iframe customization sincronizzate con la dashboard embed

Note

Il plugin è un thin wrapper: tutta la logica chat, il modulo di contatto e il rendering markdown (Streamdown) risiedono nel bundle widget buildato da Laravel (shadowDomWidgetPreact.jsx).