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 szűrő HTML-kimenete
Szekció neve “A szűrő HTML-kimenete”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. |
A szűrő tartalmának cseréje
Szekció neve “A szűrő tartalmának cseréje”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 );Ikonok a szűrőben
Szekció neve “Ikonok a szűrőben”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 );Szűrő elrejtése feltétel alapján
Szekció neve “Szűrő elrejtése feltétel alapján”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 szűrő beállításai
Szekció neve “A szűrő beállításai”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 );Az elemek lekérdezése
Szekció neve “Az elemek lekérdezése”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 );Előszűrés a lekérdezési szöveggel
Szekció neve “Előszűrés a lekérdezési szöveggel”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: