CKEditor 5

Plugin con widget e transazioni del modello dell’editor.

Installazione

npm install formulix-ckeditor5

Carica formulix-ckeditor5/formulix-ui.min.js prima di creare l’editor e importa formulix-ckeditor5 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-ckeditor5';
const config = {
  plugins: [ /* plugin esistenti, */ Formulix ],
  toolbar: ['formulixFormula', 'formulixConta', 'formulixGrafico', 'formulixQuimica'],
  formulix: {
    servidor: 'https://api.formulix.com.br',
    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

L’URL predefinito è quello del servizio ufficiale, https://api.formulix.com.br. La chiave è facoltativa: senza, il dominio dell’editor usa il piano Gratuito; quando il limite si esaurisce, la finestra mostra il link di registrazione. Registra il dominio nel pannello e scegli un piano; la registrazione comprende i sottodomini e il sito continua a funzionare senza chiave.

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 l’informativa 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. L’incolla da Word sulle altre piattaforme e l’uso di più lingue insieme non sono ancora supportati.