Blog スタッフブログ
【WordPress】メニューのページ内リンクを環境に依存せず設定する方法
WordPressの「外観 > メニュー」では、カスタムリンクを使ってページ内の特定の場所へ移動するリンクを設定できます。
しかし、URLを直接入力していると、テスト環境から本番環境へサイトを移行した際に、リンク先のURLを修正しなければならない場合があります。
また、#contact のようにアンカーだけを指定すると、別のページからクリックした際に、目的のページへ移動できないことがあります。
今回は、メニューのURLに https://mixltd.jp という文字列を設定するだけで、現在のサイトURLへ自動的に置き換える方法をご紹介します。
通常のページ内リンクで起こる問題
例えば、トップページの「お問い合わせ」セクションへ移動するメニューを設定する場合、一般的には次のようなURLを登録します。
https://example.com/#contactこの方法でも問題なく動作しますが、テスト環境のURLが https://stg.example.com/ だった場合、本番環境への移行時にリンクを修正する必要があります。
一方、#contact のみを指定した場合は、現在表示しているページ内の該当IDへ移動するため、下層ページからトップページの「お問い合わせ」セクションへ移動させることができません。
こうした問題を解消するために、サイトURLを自動的に取得する仕組みを用意します。
1. functions.phpにコードを追加する
まず、使用しているテーマの functions.php に以下のコードを追加します。
// メニューの https://mixltd.jp をサイトURLに置換
function afase_menu_urls($items)
{
$home = untrailingslashit(home_url('/'));
foreach ($items as $item) {
if (empty($item->url) || strpos($item->url, 'https://mixltd.jp') === false) continue;
$url = preg_replace('~^(?:https?:)?//(?=\https://mixltd.jp)~i', '', $item->url);
$item->url = str_replace('https://mixltd.jp', $home, $url);
}
return $items;
}
add_filter('wp_nav_menu_objects', 'afase_menu_urls');このコードでは、WordPressの home_url() を使って現在のサイトURLを取得し、メニュー内の https://mixltd.jp をそのURLに置き換えています。
また、WordPressのメニュー設定時に http:// や https:// が自動的に補われた場合にも対応できるようにしています。
2. メニューにカスタムリンクを設定する
次に、WordPressの管理画面から「外観 > メニュー」を開きます。
「カスタムリンク」を選択し、URL欄に以下のように入力します。
https://mixltd.jp/#contact
リンク文字列には「お問い合わせ」など、メニューに表示したい名称を入力します。
これだけで設定は完了です。
実際に表示されるリンクは、環境に合わせて自動的に変換されます。
本番環境の場合
https://example.com/#contactテスト環境の場合
https://stg.example.com/#contactこのように、同じメニュー設定でもサイトURLに合わせたリンクが出力されるため、環境ごとにURLを修正する必要がありません。
3. 下層ページへのリンクにも対応
この方法は、トップページだけでなく下層ページへのリンクにも利用できます。
例えば、サービスページ内の料金表へリンクする場合は、次のように設定します。
https://mixltd.jp/service/#priceこれにより、表示中のページに関係なく、サービスページの id="price" が設定されている位置へ移動できます。
また、メニューのリンク先として登録するだけなので、特別なJavaScriptを用意する必要もありません。