Formulix ドキュメント← サイトへ戻る
導入 / Formulix 0.1.0

WordPress / Gutenberg

数式・筆算・グラフ・化学用の静的 Gutenberg ブロック。

導入

ルートで npm run package:integrations を実行します。プラグイン → 新規追加 → アップロードから dist/formulix-wordpress-0.1.0.zip を導入し、有効化します。

設定

設定 → Formulix で HTTPS API URL とドメイン限定の公開キーを設定します。

API / 公開キー

運営者から提供された HTTPS API URL とアカウントの公開キーを設定し、管理画面にエディターのドメインを登録します。サブドメインも対象です。https://api.formulix.example と YOUR_PUBLIC_KEY は説明用のプレースホルダーで、実在する接続先やキーではありません。

プレビューと挿入の内容は API に送信されます。ブラウザーにはドメインに紐づく公開キーだけを設定し、管理用・SMTP・Mercado Pago の認証情報は入れないでください。

API · プライバシー — 翻訳草案

教材とメディア

Gutenberg で Formulix ブロックを追加し、4種類から選びます。Formulix 項目の編集操作で再度開きます。PNG はメディアライブラリと upload_files 権限を使用し、この権限がない利用者はグラフをアップロードできません。ブロックは静的 HTML を保存するため、無効化後も数式・表・画像を読めます。KSES は必要な MathML 要素と属性のみ拡張し、投稿者に unfiltered_html は付与しません。

検証範囲

WordPress 6.8/PHP 8.3 の投稿者アカウントで4種類、実アップロード、REST/KSES 保存、再読込後の再編集を検証済み。WordPress.org には未提出です。他のバージョンやエディターはこのテストの対象外です。公開前に運営者が外部サービス・費用・窓口・正式な規約とプライバシーを明示する必要があります。この文書は草案です。ZIP に source/ とライセンスを含みます。

Word の OMML/RTF クリップボード処理は TinyMCE 固有です。Alpha アダプターの同等機能、複数言語の同時使用、Firefox/WebKit、モバイル端末は検証が必要です。