Tovább a tartalomhoz

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 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ő 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.

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 );

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 );

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 );

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_name a 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:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások