---
title: "アドオン開発のTips"
description: "アドオン開発で実際につまずきやすい点と、その対処をまとめた実務向けの補足集。"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.cs-cart.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# アドオン開発のTips

アドオンを開発する中で実際につまずきやすい点と、その対処をまとめた補足集です。
公式ドキュメントに書かれている基本の手順は、この章の外にある各ページを参照してください。ここでは、実装したときに初めて気づく注意点を扱います。

> **このページ群について**
>
> 実際のアドオン開発で得た知見をもとにしています。主に CS-Cart 4.19 系で確認した内容です。バージョンの記載があるページは、そのバージョンを目安にしてください。ほかのバージョンでは動作が異なる場合があります。

## ページ一覧

### アドオンの基本ファイル

* [addon.xml の必須要素](/addon-development/tips/addon-xml-required-elements/) — 最小構成の addon.xml で管理画面のアドオン一覧にエラーが出る場合の対処
* [言語ファイル（.po）の msgctxt と間違いやすい点](/addon-development/tips/po-file-msgctxt/) — プレフィックスの一覧と、よくある書き間違い

### 管理画面

* [管理画面にメニューを追加する](/addon-development/tips/admin-menu/) — メニュースキーマ、パーミッション、`validate_menu`
* [管理画面にタブ UI を実装する](/addon-development/tips/admin-tabs/) — タブの定義、状態の保持、既存画面への追加
* [管理画面とショップフロントのテンプレートの違い](/addon-development/tips/backend-and-storefront-templates/) — `mainbox.tpl` の有無、HTML の `<title>` の設定
* [内部通知（ベルアイコン）を送信する](/addon-development/tips/notifications/) — ベンダーや特定ユーザーへの通知

### ショップフロント

* [ショップフロントのテンプレートを `themes_repository` にも置く](/addon-development/tips/themes-repository-sync/) — テーマ操作でファイルが消えないようにする
* [ショップフロントにブロックを追加する](/addon-development/tips/adding-a-block/) — ブロックスキーマとテンプレート
* [パンくずリストを表示する](/addon-development/tips/breadcrumbs/) — `fn_add_breadcrumb()`

### フォームと JavaScript

* [フォームに独自のバリデーターを追加する](/addon-development/tips/custom-form-validator/) — `registerValidator`、翻訳の受け渡し
* [フォームの送信イベントとバリデーション](/addon-development/tips/form-events-and-validation/) — `ce.formpre_` と `ce.formpost_` の使い分け、非同期処理
* [フォームのクラスに関する注意点](/addon-development/tips/form-classes/) — `cm-processed-form`、`cm-hide-inputs`

Source: https://docs.cs-cart.jp/addon-development/tips/index.mdx