PHPackages                             bojaghi/search-meta - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. bojaghi/search-meta

ActiveLibrary

bojaghi/search-meta
===================

Supports custom field search with 's' parameter.

1.0.0(11mo ago)01GPL-2.0-or-laterPHPPHP >=8.0

Since May 20Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/bojaghi/search-meta)[ Packagist](https://packagist.org/packages/bojaghi/search-meta)[ Docs](https://github.com/bojaghi/search-meta)[ RSS](/packages/bojaghi-search-meta/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (2)Used By (0)

Search Meta
===========

[](#search-meta)

이 모듈은 워드프레스에서 검색의 범위를 커스텀 필드까지 확장시켜 줍니다.

포스트 검색시 기본적으로 제목, 본문, 발췌 (excerpt) 이 세 필드만을 대상으로 검색 쿼리를 작성합니다. 워드프레스의 WP\_Query가 지원하는 일반적인 방법으로는 커스텀 필드까지 고려한 검색 쿼리를 작성할 수 가 없어, 별도로 SQL을 직접 짜야 합니다.

이 모듈은 WP\_Query 클래스에서 생성하는 SQL 쿼리문을 수정하여 커스텀 필드가 검색에 반영되도록 처리합니다.

사용방법
----

[](#사용방법)

WP\_Query의 설정 배열에 'search\_meta' 키를 추가하면 됩니다.

```
$query = new WP_Query(
    [
        'post_type' => 'post',
        /* ... */
        's' => 'foo',
        'search_meta' => [ /* ... */ ],
    ]
);
```

`search_meta`키의 값으로 순차 배열이며 각 요소는 검색을 진행할 커스텀 필드 이름, 즉 postmeta.meta\_key 값을 입력하면 됩니다. 모듈이 동작 하면 이 키가 설정되어 있을 때 커스텀 필드도 검색되도록 쿼리를 수정합니다.

아래는 간단한 'search\_meta'의 예입니다.

```
'search_meta' => [
    'custom_field_1',
    'custom_field_2',
]

```

`SearchMeta` 객체는 init 액션의 콜백이에서, 또는 플러그인이나 테마 초기화 코드에서 적당히 인스턴스화 시키면 됩니다.

```
new SearchMeta();
```

설정 방법
-----

[](#설정-방법)

`SearchMeta` 클래스의 생성자 인자로 설정의 배열이나, 설정을 배열하는 파일의 경로를 입력합니다.

```
new SearchMeta([ /* ... */]);
// 또는
new SearchMeta('/path/to/setup');
```

아래는 설정 파일의 예시입니다.

```
if (!defined('ABSPATH')) {
    exit;
}

return [
    'postmeta_alias' => '_smeta',
];
```

- `postmeta_alias`: 포스트메타 테이블의 별명을 지정합니다. 기본값은 '\_smeta'입니다.

주의할 점
-----

[](#주의할-점)

WP\_Query에 's'로 검색어를 넣을 경우 공백을 기준으로 단어를 나눠 각 단어별로 LIKE 검색을 시도합니다. 공백까지 한 단어로 간주하려면 따옴표로 감쌉니다. 커스텀 필드를 검색할 때에도 이와 동일한 동작을 합니다.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance50

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

358d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8bbfd1d4316ffdccc98504cdbdd210c69a6add7dca21678ad402ccedb3ff4764?d=identicon)[ep6tri](/maintainers/ep6tri)

---

Top Contributors

[![chwnam](https://avatars.githubusercontent.com/u/6630320?v=4)](https://github.com/chwnam "chwnam (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bojaghi-search-meta/health.svg)

```
[![Health](https://phpackages.com/badges/bojaghi-search-meta/health.svg)](https://phpackages.com/packages/bojaghi-search-meta)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)