Tovább a tartalomhoz

PHP-szűrők: a szűrő HTML-je, beállításai és lekérdezése

A szűrők (facet) HTML-kimenetét, beállításait, objektumlekérdezését és az előszűrést végző PHP-szűrők.

Ezek a PHP-szűrők a szűrők (facet) kirajzolását és szűrési viselkedését alakítják. A nevük a wp_grid_builder/ előtaggal kezdődik, a kódot a gyermektéma functions.php fájljába vagy egy saját bővítménybe írd.

Szűrő Mikor fut le Argumentumok
wp_grid_builder/facet/html A szűrő kirajzolása vagy frissítése előtt. $html, $facet_id
wp_grid_builder/facet/settings Minden alkalommal, amikor a szűrő beállításait lekérdezi a bővítmény. $settings
wp_grid_builder/facet/query_objects Mielőtt a szűrő a kiválasztott érték(ek)ből lekérdezi az elemek azonosítóit. $object_ids, $facet
wp_grid_builder/facet/query_string A tartalom lekérdezése előtt (WP_Query, WP_Term_Query, WP_User_Query). $query_string, $grid_id, $action

A facet/html a szűrő kirajzolása vagy frissítése előtt fut le, és a szűrő kimenetét módosíthatod vele.

Argumentum Típus Leírás
$html szöveg A szűrő HTML-kódja.
$facet_id egész szám A szűrő azonosítója.
function replace_facet_content( $html, $facet_id ) {
if ( 1 === $facet_id ) {
$html = str_replace( 'Facet string', 'Another string', $html );
}
return $html;
}
add_filter( 'wp_grid_builder/facet/html', 'replace_facet_content', 10, 2 );

A példa gombszűrő címkéi elé tesz képet.

function add_facet_icons( $html, $facet_id ) {
if ( 1 !== $facet_id ) {
return $html;
}
$facet_labels = [
'Category 1' => '<img src="mywebsite.com/img-1.jpg" alt="">',
'Category 2' => '<img src="mywebsite.com/img-2.jpg" alt="">',
'Category 3' => '<img src="mywebsite.com/img-3.jpg" alt="">',
'Category 4' => '<img src="mywebsite.com/img-4.jpg" alt="">',
'Category 5' => '<img src="mywebsite.com/img-5.jpg" alt="">',
];
foreach ( $facet_labels as $facet_label => $image ) {
$html = str_replace( '>' . $facet_label, '>' . $image . $facet_label, $html );
}
return $html;
}
add_filter( 'wp_grid_builder/facet/html', 'add_facet_icons', 10, 2 );

A példa elrejti az egyik szűrőt, ha egy másik szűrőben egy adott érték ki van választva. A wpgb_get_selected_facet_values() a megadott szűrő kiválasztott értékeit adja vissza.

function hide_facet_conditionally( $html, $facet_id ) {
$facet_to_compare = 'facet_slug'; // a vizsgált szűrő azonosítója (slug)
$value_to_compare = 'facet_value'; // a vizsgált érték
$facet_to_hide = 1234; // az elrejtendő szűrő azonosítója
if ( $facet_to_hide !== $facet_id ) {
return $html;
}
$selected_values = wpgb_get_selected_facet_values( $facet_to_compare );
if ( in_array( $value_to_compare, $selected_values, true ) ) {
$html = '';
}
return $html;
}
add_filter( 'wp_grid_builder/facet/html', 'hide_facet_conditionally', 10, 2 );

A facet/settings minden alkalommal lefut, amikor a szűrő beállításait lekérdezi a bővítmény. Egy adott szűrő beállításait módosíthatod vagy bővítheted vele, így megváltoztatod a viselkedését.

Argumentum Típus Leírás
$settings tömb A szűrő beállításai.
function prefix_facet_settings( $settings ) {
if ( 'facet_slug_1' === $settings['slug'] ) {
$settings['orderby'] = 'count';
}
if ( 'facet_slug_2' === $settings['slug'] ) {
$settings['children'] = 0;
}
return $settings;
}
add_filter( 'wp_grid_builder/facet/settings', 'prefix_facet_settings', 10, 1 );

A facet/query_objects azelőtt fut le, hogy a szűrő a kiválasztott érték(ek)ből lekérdezné az elemek azonosítóit (bejegyzés-, kifejezés- vagy felhasználóazonosítók). Felülbírálhatod a szűrő saját query_objects módszerét, és saját azonosítókat adhatsz át, így megváltozik a szűrt tartalom.

Argumentum Típus Leírás
$object_ids vegyes Az elemek azonosítóinak tömbje (alapértelmezetten false).
$facet tömb A szűrő beállításai.
function prefix_query_objects( $object_ids, $facet ) {
// Rögzített azonosítók.
if ( 1 === $facet['id'] ) {
$object_ids = [ 1, 20, 34, 105 ];
}
// A kiválasztott értékek alapján egyedi lekérdezés.
if ( 2 === $facet['id'] ) {
$object_ids = my_custom_query( $facet['selected'] );
}
return $object_ids;
}
add_filter( 'wp_grid_builder/facet/query_objects', 'prefix_query_objects', 10, 2 );

A facet/query_string azelőtt fut le, hogy a tartalmat lekérdezné a WP_Query, a WP_Term_Query vagy a WP_User_Query. A szűrők azonosítóját (slug) és értékeit adhatod hozzá a lekérdezési szöveghez, így betöltéskor előszűrheted a tartalmat.

Argumentum Típus Leírás
$query_string tömb A lekérdezési szöveg paraméterei.
$grid_id vegyes A rács azonosítója, vagy a sablon azonosítója/neve.
$action szöveg A művelet típusa: render (kirajzolás) vagy refresh (frissítés).

A példa az 1234-es rácson, első kirajzoláskor, ha még nincs szűrés, értékelés, ár és kategória szerint előszűr.

function prefix_filter_query( $query_string, $grid_id, $action ) {
if ( 1234 === $grid_id && 'render' === $action && empty( $query_string ) ) {
$query_string = [
'rating_facet_slug' => [ '4' ],
'price_facet_slug' => [ '35', '150' ],
'category_facet_slug' => [ 'clothing', 'hoodies' ]
];
}
return $query_string;
}
add_filter( 'wp_grid_builder/facet/query_string', 'prefix_filter_query', 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