NPC Manual Generator for Advanced Custom Fields

WordPress サイトを納品したあとに「どこを触れば何が変わるか分からない」とクライアントから問い合わせが入る、という制作者は多いはずです。NPC ACF Manual Generator は、Advanced Custom Fields (ACF) のフィールド構造を解析して、運用担当者が読みやすい更新マニュアル (Markdown / PDF) を自動生成する WordPress プラグインです。

実案件での運用を前提に、Repeater / Flexible Content の階層表示・場所条件の日本語化・ PDF への日本語フォント同梱まで含めて、納品物として配布できる品質を目指しています。

主な機能

• ACF ローカル JSON (acf-json/group_xxx.json) および DB 保存フィールドグループの読み込み
• Repeater / Flexible Content / Group など階層フィールドのインデント表示
• フィールドタイプ・必須フラグ・説明文・選択肢などの整形出力
• Location Rules (場所条件) の日本語化 (DB 由来の場合は固定ページタイトル等を実解決)
• 管理画面プレビュー
• Markdown ダウンロード (単体・ Zip 一括)
• PDF ダウンロード (単体・ A4 縦・ IPAex ゴシック同梱・ヘッダー / フッター / ページ番号付き)
• 複数選択 → Zip で一括ダウンロード (MD / PDF / 両方 から選択)
• 一括ダウンロード時のペアリネーム (同一グループの MD と PDF は同じ番号で揃う)

100%日本語化対応

すべての画面文字列は __() / _e() 等の翻訳関数でラップされており、テキストドメイン npc-manual-generator-for-advanced-custom-fields から WordPress.org の翻訳プラットフォーム経由で各言語へ翻訳できます。デフォルト UI は日本語です。

ロードマップ

• テンプレート機能 (制作会社のロゴ・カラー差し替えに対応した自社ブランドマニュアル化)
• 投稿編集画面サイドバーへのインライン表示
• サンプル値の自動取り込み (実投稿から 1 件抜き出して「今こう入っています」表示)
• フィールド構造の差分マニュアル (前回出力からの変更点ハイライト)
• スクリーンショット自動挿入 (ヘッドレスブラウザで管理画面を撮影して PDF に貼り付け)

リンク

• 公式サイト: https://n-pc.jp/
• 開発者ブログ: https://n-pc.jp/blog/

作者

Azu / npc — フリーランス WordPress 制作者。2016 年から WordPress + ACF を中心に Web 制作に従事。本プラグインは自身の納品案件で繰り返し使う中で生まれた内製ツールを、誰でも使える形に整えたものです。

Third-party Licenses

このプラグインは以下のサードパーティ製ソフトウェアを同梱しています。

• mPDF (mpdf/mpdf 8.x) : GPL-2.0-only ライセンス。詳細は vendor/mpdf/mpdf/LICENSE.txt を参照してください。
• IPAex Gothic Font (fonts/ipaexg.ttf) : IPA Font License Agreement v1.0 ライセンス。詳細は fonts/IPA_Font_License_Agreement_v1.0.txt を参照してください。公式: https://moji.or.jp/ipafont/license/

mPDF が依存する以下のライブラリも同梱されます (いずれも互換ライセンス) :

• setasign/fpdi — MIT
• psr/log — MIT
• psr/http-message — MIT
• paragonie/random_compat — MIT
• myclabs/deep-copy — MIT
• mpdf/psr-log-aware-trait — GPL-2.0-only
• mpdf/psr-http-message-shim — GPL-2.0-only