WordPressで誤った記事を公開させない対策 - Advanced Custom Fields(ACF)

2022.07.07

コーディング

こんにちは、ばやしです。

やっと気温が上がってきたかと思えば急に35℃の猛暑日になったりと、お天道様に振り回されて体調を崩しがちかと思いますが、いかがお過ごしでしょうか。

暑さで頭がぼんやりするというのはままある事だと思いますが、Webの運用分野、例えばWordpressなどでの更新作業を行っている時の集中力の低下は大敵です。

間違って検証サイトのURLを貼り付けてしまい、そのまま気付かずに全世界に公開などしてしまったら・・・そういったトラブルをある程度解消できる方法を今回ご紹介します。

※この記事はWordpressのClassic Editorを使用する場合を想定して書いています。ブロックエディター（Gutenberg）を使用する場合は方法が異なる場合がありますのでご注意ください。

※この記事はACFを使用したカスタムフィールドのバリデーションについて書いています。Wordpressデフォルトのエディターなどとはまた別となりますので、ご注意ください。

1.経緯
2.実装方法
3.実際の挙動
4.公開時に確認アラートを出してくれるプラグイン
5.あとがき

1.経緯

サイトの実装をしつつ公開/更新作業も行っていると、稀に検証環境と本番環境が混同してしまう事がありました。

●例
本番環境　https://hogehoge.com/news/2022/0101/1/
検証環境　https://dev.hogehoge.com/news/2022/0101/1/

この程度普通に見ていれば気が付きそうと思いますが、人間の認知能力は杜撰なもので、意外と見落とすこともあります。

それなりに需要がありそうに思うのですが、デフォルトのUI上からは「入力内容に○○○が含まれていたらダメ」のような設定が出来なかったため、下記方法で対応しました。

2.実装方法

基本実装

使用しているテーマのfunctions.phpに下記のコードを記載します。

function my_acf_validate_value( $valid, $value, $field, $input_name ) {
  if( $valid !== true ) {
    return $valid;
  }

  // 以下にバリデーション条件などの設定
  if( is_string($value) && strpos($value, 'irokoto') !== false ) {
    return __( '不適切な文字列"irokoto"が含まれています。削除を行ってください。' );
  }
  return $valid;
}

// 全てのACFフィールドに適用
add_filter('acf/validate_value', 'my_acf_validate_value', 10, 4);

strpos()を使った判定の他にも、preg_match()でより複雑な条件指定を行ったりなど応用も効きます。

逆に必要な文言が入っていない際にエラーを出したいという場合は、if文内の !== を === に変更することで可能です。

バリデーション対象フィールドの指定方法

上記の方法では全てのACFフィールドに対してバリデーションが適用されますが、フィールドタイプ、フィールド名、キーで特定のフィールドを指定して適用することも可能です。

フィールドタイプ

add_filter('acf/validate_value/type=text', 'my_acf_validate_value', 10, 4);

フィールド名

add_filter('acf/validate_value/name=acf_test', 'my_acf_validate_value', 10, 4);

フィールドラベルではなく、フィールド名です。

フィールドキー

add_filter('acf/validate_value/key=field_12345678', 'my_acf_validate_value', 10, 4);

例：特定のドメイン以外のURLを禁止する


function my_acf_validate_url( $valid, $value, $field, $input_name ) {
  if( $valid !== true ) {
    return $valid;
  }

  if( is_string($value) && strpos($value, 'google.com') === false ) {
    return __( 'ドメイン名が不適切です。' );
  }
  return $valid;
}
// 名前が「acf_url」のフィールドを対象
add_filter('acf/validate_value/name=acf_url', 'my_acf_validate_url', 10, 4);

出典 - ACF | acf/validate_value