Get Patterns by Pattern Name
同期パターン(wp_block)を「名前」で取得するヘルパー関数を提供します。
by lunaluna_dev · github.com/lunaluna/get-patterns-by-pattern-name · website
★ 0stars
4release downloads
0forks
Install
The author publishes release zips, so WP-CLI can install straight from GitHub:
wp plugin install https://github.com/lunaluna/get-patterns-by-pattern-name/releases/download/1.4.0/get-patterns-by-pattern-name.1.4.0.zipDeclares an update source (false), so updates arrive through the plugin's own updater.
From the readme
同期パターン(wpblock)を「名前」で取得するヘルパー関数を提供します。
getpatternbyname() というグローバル関数を追加し、同期パターン(wpblock カスタム投稿タイプ)をその名前(posttitle)の完全一致で取得できるようにします。
主な特徴
WPQuery の title パラメータを使用した完全一致検索(部分一致にはなりません)
日本語名のパターンにも対応
sanitizetextfield() による入力のサニタイズ、および文字列以外・極端に長い入力の早期拒否(gpbpnmaxnamelength フィルタで上限を変更可能。既定 255)
同名パターンが複数存在する場合は ID が最も小さい 1 件(最初に作成されたパターン)を返し、重複を gpbpnduplicatepatternfound アクションで検知可能
nofoundrows およびタクソノミー/メタキャッシュの更新省略による軽量なクエリ
オブジェクトキャッシュによる解決結果のキャッシュ(パターンの保存・更新・削除時に自動的に無効化されます。負の結果=見つからなかった場合も含めてキャッシュします)
gpbpnstricttitlematch フィルタで、DB の照合順序(大文字小文字・全角半角を区別しない場合がある)に依存しない厳密なタイトル一致を要求可能(既定は無効。後方互換のため opt-in)
gpbpnsyncedonly フィルタで、同期パターン(wppatternsyncstatus が未設定/空のもの)のみに限定して取得可能(既定は無効。後方互換のため opt-in)
wp.org には掲載していないため、GitHub Releases を版元とした自動更新に対応(管理画面での更新通知 → ワンクリック更新)。更新チェックのためのキャッシュ済み HTTP 通信のみ発生し、l2dwpghulupdaterenabled フィルタで false を返すことで完全に無効化可能
使い方
フック
外部から挙動を拡張するための 8 つのフック(gpbpn 接頭辞)を提供します。
gpbpnpregetpattern(filter)— クエリ発行前の短絡。外部のキャッシュ層や transient によるクエリ回避に使用できます(1.3.0 以降、内部でもオブジェクトキャッシュを利用しているため、多くの場合はこのフックを使わずに済みます)。
gpbpnqueryargs(filter)— WPQuery に渡す引数を変更します。poststatus の拡張や Polylang/WPML 連携などに使用できます。posttype と postsperpage の上限は内部
Read the full README on GitHub →
Releases
| Tag | Published | Asset | Downloads |
|---|---|---|---|
| 1.4.0 | Aug 20, 2026 | get-patterns-by-pattern-name.1.4.0.zip | 4 |