【VtigerCRMカスタマイズ】「名・姓」逆転問題を完全解決！顧客・担当者名を日本式の「姓・名」表記にする方法

海外製オープンソースCRM「VtigerCRM」を導入した際、日本のユーザーが真っ先に違和感を覚えるのが「氏名の並び順（名・姓）」です。

欧米仕様のまま運用すると、以下のような問題が発生します。

本記事では、VtigerCRMにおける「姓名順序問題」が発生する構造的な原因と、システム全体で自然な「姓名」順へ修正・対応するための具体的な手法を分かりやすく解説します。

1. なぜ「名・姓」になってしまうのか？（構造的な背景）

VtigerCRMのデータベースおよびプログラム内部では、氏名を以下の2つのフィールドで個別管理しています。

英語圏では [firstname] [lastname] の順で結合して表示するのが標準仕様となっているため、コアの表示ロジックやテンプレート（Smarty等）でそのまま連結処理が走ると、画面上で「名姓」になってしまいます。

これを「日本式（lastname + firstname）」に切り替えるには、画面表示（Smarty/UI）側 と データ取得（PHPモデル/エンティティ）側 の双方で対策を講じる必要があります。

環境や運用方針（コア改修の可否、予算、バージョンアップ方針）に応じて、以下の3通りの解決策があります。

一覧画面や詳細画面の描画テンプレート（.tpl ファイル）を調整し、画面上の配置順を「姓 ➡ 名」へ入れ替えます。

対象ファイルの例:
layouts/v7/modules/Vtiger/uitypes/Name.tpl や各モジュールの詳細・編集テンプレート
ポイント:
入力フォームの配置順（編集画面）をレイアウトエディタまたはテンプレート上で「姓（Last Name）」を左・上に、「名（First Name）」を右・下に再配置します。

一覧画面のリンクテキスト、関連リスト、ルックアップ検索のポップアップなどで表示される複合名称（label / entityname）の生成処理をカスタマイズします。

該当箇所:
modules/Contacts/Contacts.php や modules/Leads/Leads.php 内の getEntityName 関連ロジック
変更イメージ:
標準で firstname, lastname の順に結合されているフィールド定義を lastname, firstname へ反転させます。
メリット:
一覧のリンク表示や他モジュールからの参照フィールド（取引先担当者名など）が一括で「山田太郎」形式になります。