SWELLの関連記事でURLを設定したときに別タブで開くのを防ぐ方法

April 14, 2024April 15, 2024

URLをコピーしました！

SWELの関連記事にURLを設定すると強制的に、「target=”_blank” rel=”noopener noreferrer”」が入り別タブで開いてします。今回はこの別タブで開くのを防ぎ、同タブで開くようにする方法を紹介します。

WordPress環境

WordPressバージョン 6.5.2
SWELLバージョン 2.10.0
PHPバージョン 8.2.9

バージョンが異なると本記事の内容が正常に動作しない可能性があります。また、プラグインの影響や、別途記述しているPHP、JavaScript、.htaccess等も影響する可能性があります。

SWELLの関連記事でURLを設定したときに別タブで開くのを防ぐ方法

手順

方法は簡単で、function.phpに下記を記述するだけです。ワプラボでは使っていませんが、他のサイトではこのコードを使っており、今のところ不具合はありません。

function remove_target_blank_rel_from_specific_class_links($content) {
    // コンテンツが空の場合はそのまま返す
    if (empty($content)) {
        return $content;
    }

    // ブログ記事コンテンツ内のリンクを検索
    $dom = new DOMDocument();
    libxml_use_internal_errors(true);
    $dom->loadHTML(mb_convert_encoding($content, 'HTML-ENTITIES', 'UTF-8'));

    // p-blogCard__title クラスを持つリンクを取得
    $links = $dom->getElementsByTagName('a');
    foreach ($links as $link) {
        if ($link->getAttribute('class') === 'p-blogCard__title') {
            // target="_blank" rel="noopener noreferrer" を削除
            $link->removeAttribute('target');
            $link->removeAttribute('rel');
        }
    }

    // 更新後のコンテンツを返す
    return $dom->saveHTML();
}

// 投稿コンテンツにフィルターを適用
add_filter('the_content', 'remove_target_blank_rel_from_specific_class_links');

解説

技術的な解説になるので、目的を達成したいだけの方はスルーでOKです。

このコードは、WordPressのコンテンツフィルターを使用して特定のHTMLクラス(関連記事のクラス)を持つリンクから target="_blank" と rel 属性を削除し、別タブで開くことを防いでいます。

関数の定義と引数

remove_target_blank_rel_from_specific_class_links という関数を定義しており、引数として $content（HTMLコンテンツの文字列）を受け取っています。

内容のチェック

if (empty($content)) を使用して、渡された内容が空かどうかを確認しています。空の場合は、その内容をそのまま返します。

DOMDocumentの初期化

PHPの DOMDocument クラスを使ってHTMLのDOMを操作しています。このクラスを使うことで、HTMLコンテンツを解析し、その構造を変更できます。

libxml_use_internal_errors(true) は、HTMLの読み込み中に発生する可能性のあるXMLエラーを内部的に処理し、警告を表示させないようにするために使っています。
mb_convert_encoding($content, 'HTML-ENTITIES', 'UTF-8') は、文字列のエンコーディングをUTF-8のHTMLエンティティに変換します。これにより、HTMLとして正しく解釈されやすくなるようにしています。

リンクの選択と属性の削除

$dom->getElementsByTagName('a') で、すべての <a> タグ（リンク）を取得しています。
それぞれのリンクに対してループ処理を行い、$link->getAttribute('class') === 'p-blogCard__title' をチェックしています。このクラス属性を持つリンクから target と rel 属性を削除します。

変更したHTMLの保存と返却

$dom->saveHTML() でDOMの内容をHTMLとして保存し、それを返します。

WordPressフックへの追加

add_filter('the_content', 'remove_target_blank_rel_from_specific_class_links') は、WordPressの the_content フィルターフックに上記の関数を追加します。これにより、WordPressがページの内容を出力する際に自動的にこの関数が呼び出され、指定されたクラスのリンクから target と rel 属性が削除されます。