PHP-szűrők: az indexelő, a cron és a keresőszűrő
Az indexelő lekérdezésének, sorainak és időzítésének, valamint a keresőszűrő lekérdezésének módosítása PHP-szűrőkkel.
| Szűrő | Mire jó | Argumentumok |
|---|---|---|
wp_grid_builder/facet/search_query_args |
A keresőszűrő lekérdezésének módosítása. | $query, $facet |
wp_grid_builder/cron/max_execution_time |
Az indexelő cron legnagyobb futási idejének módosítása. | $execution_time |
wp_grid_builder/cron/interval |
Az indexelő cron-feladatai közti idő módosítása. | $interval |
wp_grid_builder/indexer/query_args |
Az indexelő által lekérdezett elemek módosítása. | $query_args, $object_type, $facet |
wp_grid_builder/indexer/row |
Az indextábla egy sorának módosítása beszúrás előtt. | $row, $object_id, $facet |
wp_grid_builder/indexer/index_object |
Az alapértelmezett indexelés kiváltása saját sorokkal. | $rows, $object_id, $facet |
A keresőszűrő lekérdezése
Szekció neve “A keresőszűrő lekérdezése”A szűrő még azelőtt fut le, hogy a keresőszűrő lekérdezné az elemek azonosítóit (bejegyzések, kifejezések, felhasználók). A WP_Query, WP_Term_Query vagy WP_User_Query argumentumait módosíthatod vele.
| Argumentum | Típus | Leírás |
|---|---|---|
$query |
tömb | A keresés lekérdezési argumentumai. |
$facet |
tömb | A szűrő beállításai. |
function prefix_search_query_args( $query_args, $facet ) {
if ( 1 === $facet['id'] ) { $query_args['post__not_in'] = [ 1, 2, 3, 4 ]; }
return $query_args;
}add_filter( 'wp_grid_builder/facet/search_query_args', 'prefix_search_query_args', 10, 2 );Az indexelő cron
Szekció neve “Az indexelő cron”Az indexelő saját, aszinkron kéréseken alapuló cron-rendszerrel dolgozik. A WordPress cron API-ja csak tartalék: akkor lép be, ha a belső rendszer a szerver korlátai miatt megszakad.
Legnagyobb futási idő
Szekció neve “Legnagyobb futási idő”A szűrő minden alkalommal lefut, amikor az indexelő cron-folyamatot indít. A cron-rendszer indexelés közben rendszeresen ellenőrzi, hogy a szerver max_execution_time értékének 80%-át elérte-e, hogy a korlát átlépése ne törje meg az indexelést. Két ellenőrzés között azonban a műveletek átléphetik a korlátot; ilyenkor ezzel a szűrővel csökkentheted az értéket.
| Argumentum | Típus | Leírás |
|---|---|---|
$execution_time |
egész szám | A futási idő másodpercben. |
function prefix_cron_max_execution_time( $execution_time ) {
return 60;
}add_filter( 'wp_grid_builder/cron/max_execution_time', 'prefix_cron_max_execution_time', 10, 1 );Cron-időköz
Szekció neve “Cron-időköz”A szűrő az időköz beállítása előtt fut le. Az indexelő WordPress cron-feladatai közti idő alapértelmezetten 60 másodperc.
| Argumentum | Típus | Leírás |
|---|---|---|
$interval |
egész szám | Az időköz másodpercben. |
function prefix_cron_interval( $interval ) {
return 30;
}add_filter( 'wp_grid_builder/cron/interval', 'prefix_cron_interval', 10, 1 );Az indexelő lekérdezése
Szekció neve “Az indexelő lekérdezése”A szűrő a WP_Query, WP_Term_Query vagy WP_User_Query futtatása előtt fut le az indexelőben. Egy szűrő indexelésekor az indexelő először lekéri a szűrőnek megfelelő bejegyzés-, kifejezés- vagy felhasználóazonosítókat; ezzel a szűrővel módosíthatod, mely elemek kerüljenek bele.
| Argumentum | Típus | Leírás |
|---|---|---|
$query_args |
tömb | Az indexelő lekérdezési argumentumai. |
$object_type |
szöveg | Az indexelt elem típusa: post, term vagy user. |
$facet |
tömb | A szűrő beállításai. |
function prefix_indexer_query_args( $query_args, $object_type, $facet ) {
if ( 1 === $facet['id'] ) { $query_args['post__not_in'] = [ 1, 2, 3, 4 ]; }
if ( 'post' === $object_type ) { $query_args['post_status'] = 'publish'; }
return $query_args;
}add_filter( 'wp_grid_builder/indexer/query_args', 'prefix_indexer_query_args', 10, 3 );Az indextábla sorai
Szekció neve “Az indextábla sorai”Egy sor módosítása
Szekció neve “Egy sor módosítása”A szűrő azelőtt fut le, hogy egy sor bekerülne az indextáblába. A sor tulajdonságait, például a facet_value és facet_name értékét módosíthatod vele. Értékek lekérdezésére ne használd, csak meglévő érték átalakítására (például dátum formázására). A sorok és értékek összeállításához az indexer/index_object szűrő való.
| Argumentum | Típus | Leírás |
|---|---|---|
$row |
tömb | Az aktuális elem indexsora. |
$object_id |
egész szám | Az indexelt bejegyzés, kifejezés vagy felhasználó azonosítója. |
$facet |
tömb | A szűrő beállításai. |
function prefix_row_data( $row, $object_id, $facet ) {
if ( 1 !== $facet['id'] ) { return $row; }
$row['facet_value'] = date( 'Y-m-d', strtotime( $row['facet_value'] ) ); $row['facet_name'] = $row['facet_value'];
return $row;
}add_filter( 'wp_grid_builder/indexer/row', 'prefix_row_data', 10, 3 );Az indexelés kiváltása saját sorokkal
Szekció neve “Az indexelés kiváltása saját sorokkal”A szűrő egy elem (bejegyzés, kifejezés vagy felhasználó) indexelése előtt fut le. Az alapértelmezett indexelést úgy kerülheted meg, hogy legalább egy sort tartalmazó tömböt adsz vissza, soronként facet_value és facet_name értékkel. Ha a facet_value üres, a sor nem kerül az indexbe.
- A
facet_valueértéke alapján találja meg a bővítmény a bejegyzéseket, kifejezéseket vagy felhasználókat szűréskor. - A
facet_namea szűrőben megjelenő felirat.
| Argumentum | Típus | Leírás |
|---|---|---|
$rows |
tömb | Az aktuális elem indexsorai (alapértelmezetten üres). |
$object_id |
egész szám | Az indexelt elem azonosítója. |
$facet |
tömb | A szűrő beállításai. |
function prefix_index_object( $rows, $object_id, $facet ) {
if ( 1234 !== $facet['id'] ) { return $rows; }
$field_1 = get_post_meta( $object_id, 'field_1', true ); $field_2 = get_post_meta( $object_id, 'field_2', true );
return [ [ 'facet_value' => $field_1, 'facet_name' => $field_1, ], [ 'facet_value' => $field_2, 'facet_name' => $field_2, ], ];}add_filter( 'wp_grid_builder/indexer/index_object', 'prefix_index_object', 10, 3 );Készült: