Formulix Dokumentation← Zur Website
Installation / Formulix 0.1.0

WordPress / Gutenberg

Statischer Gutenberg-Block für Formeln, Rechnungen, Graphen und Chemie.

Installation

Führen Sie im Projektstamm npm run package:integrations aus. Installieren und aktivieren Sie unter Plugins → Neues Plugin hinzufügen → Plugin hochladen die Datei dist/formulix-wordpress-0.1.0.zip.

Konfiguration

Tragen Sie unter Einstellungen → Formulix die HTTPS-API-Adresse und den öffentlichen Schlüssel pro Domain ein.

API und öffentlicher Schlüssel

Tragen Sie die HTTPS-API-Adresse des Betreibers und den öffentlichen Schlüssel Ihres Kontos ein. Registrieren Sie die Domain des Editors im Dashboard; sie deckt auch Subdomains ab. https://api.formulix.example und YOUR_PUBLIC_KEY sind Platzhalter, kein erreichbarer Dienst und kein echter Schlüssel.

Schon Vorschauen und später Einfügungen senden Inhalte an die API. Verwenden Sie im Browser nur den domaingebundenen öffentlichen Schlüssel, niemals Administrator-, SMTP- oder Mercado-Pago-Zugangsdaten. Siehe Authentifizierung, Fehler und Limits sowie den Datenschutzentwurf.

Nutzung und Medien

Fügen Sie in Gutenberg einen Formulix-Block hinzu und wählen Sie Formel, Rechnung, Graph oder Chemie. Öffnen Sie ihn über die Schaltfläche zum Bearbeiten des Formulix-Elements erneut. PNGs verwenden die Mediathek und die native Berechtigung upload_files; ohne sie ist kein Graphen-Upload möglich.

Der Block speichert statisches HTML. Formeln, Tabellen und Bilder bleiben nach Deaktivierung des Plugins lesbar. KSES wird um die erforderlichen MathML-Elemente und Attribute erweitert, ohne Autorinnen und Autoren unfiltered_html zu gewähren.

Bekannte Grenzen

Getestet mit WordPress 6.8/PHP 8.3 und Autorenrolle: vier Inhaltstypen, echter Upload, REST/KSES-Speicherung und erneute Bearbeitung nach Neuladen. Nicht bei WordPress.org eingereicht. Andere Versionen und WordPress-Editoren wurden damit nicht validiert.

Der OMML/RTF-Clipboardpfad für Word bleibt TinyMCE-spezifisch. Gleichwertiges Einfügen in Alpha-Adaptern, mehrere Sprachen gleichzeitig, Firefox/WebKit und mobile Geräte müssen noch validiert werden.

Vor öffentlicher Nutzung muss der Betreiber externen Dienst, Kosten, Support sowie endgültige Bedingungen und Datenschutzhinweise angeben. Die Texte hier sind Entwürfe. Das ZIP enthält Quellen unter source/ und Lizenzen.