EC-CUBE Routing

EC-CUBE のルーティング名を、エディタの右クリックメニューから素早く挿入できる Visual Studio Code 拡張機能です。
EC-CUBE 4系のフロント画面・管理画面の組み込みルーティングを網羅しており、ワークスペース内のプロジェクトファイルからルーティングを自動取得する機能も備えています。

機能

ルーティング名の挿入

エディタ上で右クリックすると、コンテキストメニューに 「EC-CUBE Routing」 サブメニューが表示されます。
「ルーティング名を挿入」 を選択すると検索可能なピッカーが開き、ルーティング名を絞り込んで選択するとカーソル位置（または選択範囲）に挿入されます。

ピッカーの表示順は次のとおりです。

1. フロント画面（組み込み） — EC-CUBE 標準のフロントルーティング
2. フロント画面（自動取得） — プロジェクトから自動検出したルーティング
3. フロント画面（手動追加） — 右クリックメニューから手動で追加したルーティング
4. 管理画面（組み込み） — EC-CUBE 標準の管理画面ルーティング
5. 管理画面（自動取得） — プロジェクトから自動検出したルーティング
6. 管理画面（手動追加） — 右クリックメニューから手動で追加したルーティング

右クリックサブメニュー

エディタ上で右クリックすると 「EC-CUBE Routing」 サブメニューが展開され、以下の操作をすべてメニューから実行できます。

右クリック
└─ EC-CUBE Routing ▶
      ├─ ルーティング名を挿入
      ├─ フロントのカスタムルーティングを追加
      ├─ 管理画面のカスタムルーティングを追加
      ├─ カスタムルーティングを削除
      └─ ワークスペースを再スキャン

ワークスペースの自動スキャン

VS Code 起動時にワークスペース内のファイルを自動解析し、プロジェクト固有のルーティング名を取得します。
PHP ファイルや YAML ファイルを保存すると自動的に再スキャンが走ります（2秒デバウンス）。

スキャン対象ファイル

ステータスバー表示

VS Code 右下のステータスバーに取得件数が表示されます。
クリックすると手動で再スキャンを実行できます。

EC-CUBE Routing: 42 件取得済   ← クリックで再スキャン

カスタムルーティングの追加・削除

右クリックサブメニューからカスタムルーティングを追加・削除できます。
追加したルーティングは VS Code のグローバル設定に保存され、次回以降も挿入ピッカーに表示されます。
settings.json を直接編集して追加することもできます。

{
  "eccubeRouting.customFrontRoutes": [
    { "label": "my_front_page", "description": "Front / 独自フロントページ" }
  ],
  "eccubeRouting.customAdminRoutes": [
    { "label": "admin_my_feature", "description": "Admin / 独自管理機能" }
  ]
}

使い方

1. EC-CUBE プロジェクトをワークスペースとして開く
2. PHP・Twig・YAML などのファイルをエディタで開く
3. ルーティング名を挿入したい箇所にカーソルを置く
4. 右クリック → EC-CUBE Routing → ルーティング名を挿入 を選択
5. 検索ボックスでルーティング名を絞り込み、選択すると挿入される

収録ルーティング一覧（組み込み）

フロント画面

管理画面

動作環境

• Visual Studio Code 1.80.0 以降
• EC-CUBE 4系

ライセンス

MIT

リポジトリ・不具合報告

https://github.com/TakashiHishiki/eccube-routing