アドオンを開発する中で実際につまずきやすい点と、その対処をまとめた補足集です。 公式ドキュメントに書かれている基本の手順は、この章の外にある各ページを参照してください。ここでは、実装したときに初めて気づく注意点を扱います。
ページ一覧
アドオンの基本ファイル
- addon.xml の必須要素 — 最小構成の addon.xml で管理画面のアドオン一覧にエラーが出る場合の対処
- 言語ファイル（.po）の msgctxt と間違いやすい点 — プレフィックスの一覧と、よくある書き間違い
管理画面
- 管理画面にメニューを追加する — メニュースキーマ、パーミッション、
validate_menu - 管理画面にタブ UI を実装する — タブの定義、状態の保持、既存画面への追加
- 管理画面とショップフロントのテンプレートの違い —
mainbox.tplの有無、HTML の<title>の設定 - 内部通知（ベルアイコン）を送信する — ベンダーや特定ユーザーへの通知
ショップフロント
- ショップフロントのテンプレートを
themes_repositoryにも置く — テーマ操作でファイルが消えないようにする - ショップフロントにブロックを追加する — ブロックスキーマとテンプレート
- パンくずリストを表示する —
fn_add_breadcrumb()
フォームと JavaScript
- フォームに独自のバリデーターを追加する —
registerValidator、翻訳の受け渡し - フォームの送信イベントとバリデーション —
ce.formpre_とce.formpost_の使い分け、非同期処理 - フォームのクラスに関する注意点 —
cm-processed-form、cm-hide-inputs