# PHP-szűrők: a szűrő válasza, választási lehetőségei és címe

> A szűrők (facet) válaszát, választási lehetőségeit és címének HTML-címkéjét módosító PHP-szűrők.

Ezek a PHP-szűrők a szerkesztett szűrők (facet) kimeneté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/response` | Mielőtt a szűrő válasza a frontendre kerülne. | `$response`, `$facet`, `$choices` |
| `wp_grid_builder/facet/choices` | A szűrő választási lehetőségeinek lekérdezése után. | `$choices`, `$facet` |
| `wp_grid_builder/facet/title_tag` | A szűrő címének kirajzolásakor. | `$tag_name` |

## A szűrő válasza

A `facet/response` a frontendre küldött válasz előtt fut le. Módosíthatod vagy bővítheted a választ, így a frontenden további adatokat használhatsz.

| Argumentum | Típus | Leírás |
|---|---|---|
| `$response` | tömb | A szűrő válasza. |
| `$facet` | tömb | A szűrő beállításai. |
| `$choices` | tömb | A szűrő választási lehetőségei. |

Példa: dátumszűrőnél a legkorábbi és legkésőbbi választható dátum megadása.

```php
function prefix_facet_response( $response, $facet, $choices ) {

	if ( 'date' === $facet['type'] ) {

		$response['settings']['minDate'] = '2017-04-16';
		$response['settings']['maxDate'] = '2019-01-13';

	}

	return $response;

}
add_filter( 'wp_grid_builder/facet/response', 'prefix_facet_response', 10, 3 );
```

## A választási lehetőségek

A `facet/choices` a választási lehetőségek lekérdezése után fut le (a szűrő típusú szűrőknél). Segítségével módosíthatod a szűrő tartalmának kirajzolásához használt adatokat, például a megjelenő neveket.

| Argumentum | Típus | Leírás |
|---|---|---|
| `$choices` | tömb | A szűrő választási lehetőségei. |
| `$facet` | tömb | A szűrő beállításai. |

Példa: az 1-es azonosítójú szűrő lehetőségei elé emoji kerül. A `facet_value` az érték, a `facet_name` a megjelenő név.

```php
function prefix_facet_choices( $choices, $facet ) {

	if ( 1 !== $facet['id'] ) {
		return $choices;
	}

	return array_map(
		function( $choice ) {

			switch ( $choice->facet_value ) {
				case 'nadragok':
					$choice->facet_name = '👖 Nadrágok';
					break;
				case 'ruhak':
					$choice->facet_name = '👗 Ruhák';
					break;
				case 'polok':
					$choice->facet_name = '👕 Pólók';
					break;
				case 'zoknik':
					$choice->facet_name = '🧦 Zoknik';
			}

			return $choice;

		},
		$choices
	);
}
add_filter( 'wp_grid_builder/facet/choices', 'prefix_facet_choices', 10, 2 );
```

## A szűrő címének címkéje

A `facet/title_tag` a szűrő címének kirajzolásakor fut le, és a cím HTML-címkéjének nevét módosíthatod vele. Az alapértelmezett címke a `h4`.

| Argumentum | Típus | Leírás |
|---|---|---|
| `$tag_name` | szöveg | A cím címkéjének neve (alapértelmezés: `h4`). |

```php
function prefix_facet_title_tag( $tag_name ) {

	return 'p';

}
add_filter( 'wp_grid_builder/facet/title_tag', 'prefix_facet_title_tag', 10, 1 );
```
