Formulix Documentation
Formulix / 0.1.2

CKEditor 5

Plugin avec widgets et transactions du modèle de l’éditeur.

Installation

npm install formulix-ckeditor5

Chargez formulix-ckeditor5/formulix-ui.min.js avant de créer l’éditeur et importez formulix-ckeditor5 en ESM.

Utilisez l’installation ckeditor5 de l’application ; n’ajoutez pas une seconde copie. Version testée et déclarée en peer dependency : CKEditor 49.

Configuration

Fusionnez ces valeurs avec les plugins existants de ClassicEditor.

import Formulix from 'formulix-ckeditor5';
const config = {
  plugins: [  Formulix ],
  toolbar: ['formulixFormula', 'formulixConta', 'formulixGrafico', 'formulixQuimica'],
  formulix: {
    servidor: 'https://api.formulix.com.br',
    chave: 'YOUR_PUBLIC_KEY',
    idioma: 'fr'
  }
};

Sans callback upload, le plugin utilise FileRepository et l’adaptateur de téléversement déjà configuré. Pour votre propre stockage, ajoutez upload: async blob => uploadPng(blob) dans formulix. Implémentez uploadPng pour envoyer le PNG et renvoyer son URL ; le serveur doit authentifier l’envoi et valider le format PNG et la taille.

API et clé publique

L’URL par défaut est celle du service officiel, https://api.formulix.com.br. La clé est facultative : sans elle, le domaine de l’éditeur utilise le forfait Gratuit ; quand le quota est épuisé, la boîte de dialogue affiche un lien d’inscription. Enregistrez le domaine dans le tableau de bord et choisissez un forfait ; l’enregistrement couvre ses sous-domaines et le site continue de fonctionner sans clé.

Le contenu des aperçus et insertions est envoyé à l’API. Utilisez uniquement la clé publique liée au domaine ; ne placez jamais d’identifiants d’administration, SMTP ou Mercado Pago dans le navigateur. Consultez l’authentification, les erreurs et les limites et la politique de confidentialité.

Utilisation et conservation

Utilisez les quatre boutons et double-cliquez sur un élément pour le modifier. Enregistrez editor.getData(). Préservez les conteneurs data-formulix, MathML, tableaux et attributs data-* dans le filtre HTML du serveur. Les modifications et l’historique utilisent les transactions du modèle.

Limites connues

Testé avec CKEditor 49 : quatre types, enregistrement/rechargement, modification, annulation, filtrage et lecture seule. Vérifiez séparément la licence de l’éditeur hôte ; l’adaptateur est GPL-3.0-or-later.

Le traitement du presse-papiers OMML/RTF de Word reste propre à TinyMCE. Le collage depuis Word sur les autres plateformes et l’usage simultané de plusieurs langues ne sont pas encore pris en charge.