CKEditor 5

Plugin con widget e transazioni del modello dell’editor.

Installazione

Esegui npm run build:integrations e copia dist/integrations/ckeditor5/ nell’applicazione. Per distribuire sorgenti e licenze usa npm run package:integrations. Carica formulix-ui.min.js prima di creare l’editor e importa index.js come ESM.

Usa la stessa installazione ckeditor5 dell’applicazione; non includere un’altra copia dell’editor. Versione provata e dichiarata come peer dependency: CKEditor 49.

Configurazione

// Integra nella configurazione esistente di ClassicEditor.
import Formulix from './formulix/index.js';
const config = {
  plugins: [ /* plugin esistenti, */ Formulix ],
  toolbar: ['formulixFormula', 'formulixConta', 'formulixGrafico', 'formulixQuimica'],
  formulix: {
    servidor: 'https://api.formulix.example',
    chave: 'YOUR_PUBLIC_KEY',
    idioma: 'it'
  }
};

Senza callback upload usa FileRepository e l’adattatore di caricamento già configurato. Per un caricamento personalizzato passa upload: async blob => { /* carica PNG e restituisci URL */ } in formulix. È solo il contratto: implementa invio autenticato e verifica di PNG e dimensione sul server.

API e chiave pubblica

Configura l’URL HTTPS fornito dal gestore e la chiave pubblica del tuo account. Registra nel pannello il dominio dell’editor: comprende anche i sottodomini. https://api.formulix.example e YOUR_PUBLIC_KEY sono segnaposto, non un servizio disponibile o una chiave reale.

Anteprime e inserimenti inviano contenuti all’API. Nel browser usa solo la chiave pubblica legata al dominio, mai credenziali amministrative, SMTP o Mercado Pago. Consulta autenticazione, errori e limiti e la bozza sulla privacy.

Uso e persistenza

Usa i quattro pulsanti e fai doppio clic sull’elemento per modificarlo. Salva editor.getData(). Conserva wrapper data-formulix, MathML, tabelle e attributi data-* nel sanitizzatore del server. Modifiche e cronologia usano transazioni del modello.

Limiti noti

Verificati con CKEditor 49: quattro tipi, salvataggio/ricaricamento, modifica, annullamento, sanitizzazione e sola lettura. Verifica separatamente la licenza dell’editor ospitante; l’adattatore è GPL-3.0-or-later.

Il percorso degli appunti OMML/RTF di Word resta specifico di TinyMCE. Restano da convalidare la stessa gestione dell’incolla negli adattatori alpha, più lingue simultanee, Firefox/WebKit e dispositivi mobili.