# 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 keresőszűrő lekérdezése

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

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

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.

### Legnagyobb futási idő

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

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

### Cron-időköz

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

```php
function prefix_cron_interval( $interval ) {

	return 30;

}
add_filter( 'wp_grid_builder/cron/interval', 'prefix_cron_interval', 10, 1 );
```

## Az indexelő lekérdezése

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

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

## Az indextábla sorai

### Egy sor módosítása

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

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

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

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