# PHP-műveletek: burkolók és REST-visszahívás

> A rács és a kártya HTML-burkolója köré egyedi HTML-t beszúró műveletek, valamint a REST-útvonal visszahívása előtti művelet.

Ezek a műveletek a rács és a kártyák HTML-burkolójánál, illetve a REST-útvonal válaszának előállítása előtt futnak le. A műveletek nevei a `wp_grid_builder/` előtaggal kezdődnek.

| Művelet | Mikor fut le | Argumentumok |
|---|---|---|
| `wp_grid_builder/layout/wrapper_start` | A rács HTML-burkolójának kezdete után. | nincs |
| `wp_grid_builder/layout/wrapper_end` | A rács HTML-burkolójának vége előtt. | nincs |
| `wp_grid_builder/card/wrapper_start` | A kártya HTML-burkolójának kezdete előtt. | `$card` |
| `wp_grid_builder/card/wrapper_end` | A kártya HTML-burkolójának vége után. | `$card` |
| `wp_grid_builder/rest_api/callback` | Mielőtt a REST-útvonal lefuttatná a válasz visszahívását. | `$request`, `$params` |

## A rács burkolója

A két művelettel egyedi HTML-t szúrhatsz a rács burkolóján belülre: a `layout/wrapper_start` a burkoló kezdete után, a `layout/wrapper_end` a burkoló vége előtt fut le. A függvényből kiírt tartalom kerül a megfelelő helyre.

```php
function prefix_wrapper_start() {

	// Ide kerül a kiírandó HTML.

}
add_action( 'wp_grid_builder/layout/wrapper_start', 'prefix_wrapper_start' );

function prefix_layout_wrapper_end() {

	// Ide kerül a kiírandó HTML.

}
add_action( 'wp_grid_builder/layout/wrapper_end', 'prefix_layout_wrapper_end' );
```

## A kártya burkolója

A kártya burkolója körül két művelet fut, mindkettő egy `$card` tömböt kap, amely a kártya felépítését (rétegek és blokkok) írja le. Figyelj a különbségre: a `card/wrapper_start` a burkoló kezdete **előtt**, a `card/wrapper_end` a burkoló vége **után** fut le, vagyis a HTML a kártya burkolóján kívülre kerül.

Mivel két argumentumot (a `$card`-ot) kapnak, az `add_action()` hívásban add meg a prioritást és az argumentumok számát is.

```php
function prefix_card_wrapper_start( $card ) {

	// Ide kerül a kártya elé írandó HTML.

}
add_action( 'wp_grid_builder/card/wrapper_start', 'prefix_card_wrapper_start', 10, 1 );

function prefix_card_wrapper_end( $card ) {

	// Ide kerül a kártya után írandó HTML.

}
add_action( 'wp_grid_builder/card/wrapper_end', 'prefix_card_wrapper_end', 10, 1 );
```

| Argumentum | Típus | Leírás |
|---|---|---|
| `$card` | tömb | A kártya felépítése (rétegek és blokkok). |

## REST-útvonal visszahívása: `rest_api/callback`

A művelet közvetlenül azelőtt fut le, hogy a REST-útvonal elkezdené előállítani a választ. Segítségével megkerülheted a kért választ: a saját függvényed a `rest_ensure_response()` hívással adhat vissza más választ.

| Argumentum | Típus | Leírás |
|---|---|---|
| `$request` | `WP_REST_Request` | A létrehozott kéréspéldány. |
| `$params` | tömb | A kért paraméterek. |

```php
function prefix_rest_api_callback( $request, $params ) {

	rest_ensure_response( [ /* a saját válaszod */ ] );

}
add_action( 'wp_grid_builder/rest_api/callback', 'prefix_rest_api_callback', 10, 2 );
```
