Joomla Tips
Joomla 忘れがちなあれこれ
favicon・テンプレート・設定ファイルなど、いざという時に迷うディレクトリ・操作の覚書
📑 目次
1. favicon を変更する
faviconは使用しているテンプレートのディレクトリに配置する。テンプレートごとに独自のfaviconを持てる。
| 種別 | パス |
|---|---|
| テンプレート固有 | /templates/テンプレート名/favicon.ico |
| システム | /media/system/images/favicon.ico |
| Joomlaルート（フォールバック） | /favicon.ico |
推奨ファイル形式
ICO形式に加え、favicon.png（32×32px）・apple-touch-icon.png（180×180px）も同ディレクトリに置くとモバイル対応できる。テンプレートの index.php または templateDetails.xml で参照先を確認すること。
ブラウザキャッシュに注意
ファイルを差し替えてもブラウザが旧faviconをキャッシュしている場合がある。強制リロード（Ctrl+Shift+R / Cmd+Shift+R）または別ブラウザで確認すること。
2. テンプレートのディレクトリ構成
カスタマイズ時に触るファイルの場所を把握しておく。
| ファイル | 役割 |
|---|---|
| /templates/テンプレート名/index.php | テンプレートのメインレイアウト |
| /templates/テンプレート名/css/ | スタイルシート格納ディレクトリ |
| /templates/テンプレート名/images/ | テンプレート用画像 |
| /templates/テンプレート名/templateDetails.xml | テンプレートのメタ情報・ポジション定義 |
| /templates/テンプレート名/language/ | テンプレート用言語ファイル |
子テンプレート（テンプレートオーバーライド）
Joomla 4以降は /templates/テンプレート名/html/ 配下にコンポーネント・モジュールのオーバーライドファイルを置く。管理画面の「テンプレート」→「テンプレートのオーバーライドを作成」から自動生成できる。
3. 設定ファイルの場所
DBの接続情報やサイト設定が入っている重要ファイル。
| ファイル | 内容 |
|---|---|
| /configuration.php | DB接続情報・サイトURL・シークレットキーなど全設定 |
| /.htaccess | URLリライト・アクセス制限（Apache用） |
| /web.config | URLリライト・アクセス制限（IIS用） |
configuration.php は直接編集しない
管理画面「グローバル設定」から変更するのが原則。直接編集した場合はパーミッションが 444 に戻っているか確認すること（書き込み可能のまま放置は危険）。
4. メディアマネージャーのアップロード先
管理画面からアップロードした画像・ファイルの実体パス。
| 種別 | パス |
|---|---|
| デフォルトアップロード先 | /images/ |
| 記事内で参照する際のパス | images/ファイル名.webp |
アップロード先の変更
管理画面「グローバル設定」→「メディア」タブで変更可能。FTPで直接 /images/ 以下にフォルダを作って整理してもメディアマネージャーに反映される。
5. キャッシュのクリア
変更が反映されない時に確認する場所。
| 方法 | 操作 |
|---|---|
| 管理画面から | 「システム」→「キャッシュを削除」 |
| FTPから | /cache/ 内のファイルを削除 |
| 管理画面キャッシュ | /administrator/cache/ 内のファイルを削除 |
一番手っ取り早い方法
管理画面ホーム右上の「キャッシュを削除」ボタンが最速。それでも反映されない場合は /cache/ をFTPで直接削除する。
6. 管理画面URLを忘れた時
デフォルトのパスと、変更した場合の確認方法。
| 状況 | URL / 確認先 |
|---|---|
| デフォルト | https://ドメイン/administrator/ |
| 変更済みの場合 | configuration.php の $live_site と $secret 付近を確認 |
| Admin Tools等で変更した場合 | プラグイン設定ファイルまたはDBの #__extensions テーブルを確認 |
Admin Tools で管理URLを変更している場合
変更後のURLを忘れると管理画面にアクセスできなくなる。/administrator/ にアクセスして404になる場合は、Admin Toolsのプラグインを一時的に無効化（DBで enabled=0 に変更）することでデフォルトURLに戻せる。
📝 まとめ
faviconは /templates/テンプレート名/、設定は /configuration.php、メディアは /images/、キャッシュは /cache/ が基本の場所。何か変わらない・見つからない時はまずこの4箇所を確認する。