要望や症状
管理画面の左上に表示されているEC-CUBEのデフォルトロゴを、自社のロゴに変更したいと考えています。
対象ファイル
管理画面のロゴファイルは html/template/admin/assets/img/logo@2x.png に配置されています。
理由や原因
EC-CUBEでは管理画面のロゴ画像が固定のパスで定義されており、デフォルト状態では標準のEC-CUBEロゴが表示される仕様となっています。ロゴを変更するには該当ファイルを差し替える必要があります。
解決策
手順
まず、既存のロゴファイルのバックアップを作成します。これにより、問題が発生した際に元の状態に戻すことができます。
cp html/template/admin/assets/img/logo@2x.png html/template/admin/assets/img/logo@2x.png.backup
次に、新しいロゴ画像を準備します。推奨サイズは横幅200px程度で、高解像度対応のため@2xサイズとしてください。ファイル形式はPNG（透過対応推奨）で、ファイル名は logo@2x.png とします。
準備したロゴファイルを既存のファイルと差し替えます。
# 新しいロゴファイルを配置
cp /path/to/your/new-logo.png html/template/admin/assets/img/logo@2x.png
ファイルの差し替えが完了したら、システムのキャッシュをクリアします。
bin/console cache:clear --no-warmup
最後に、管理画面にアクセスしてロゴが正しく変更されていることを確認してください。変更が反映されない場合は、ブラウザのキャッシュをクリアしてから再度確認してください。
注意事項
EC-CUBEのアップデート時に、カスタマイズしたロゴファイルが上書きされる可能性があります。そのため、アップデート前には必ずロゴファイルのバックアップを取得しておくことをお勧めします。
また、ロゴサイズが大きすぎると管理画面のレイアウトが崩れる場合があるため、適切なサイズに調整してください。