# 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

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

```php
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

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

```php
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

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.

```php
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

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

```php
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

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

```php
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

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.

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