Blog スタッフブログ

WEB制作

【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を用意する必要もありません。