# PHP-szűrők: az elrendezés burkolója és a kártyák

> Az elrendezés-burkoló és a kártyatartó HTML-címkéjének, valamint a kártyák méretének módosítása PHP-szűrőkkel.

| Szűrő | Mire jó | Argumentumok |
|---|---|---|
| `wp_grid_builder/layout/wrapper_tag` | A fő elrendezés-burkoló HTML-címkéjének cseréje. | `$tag`, `$settings` |
| `wp_grid_builder/card/tag` | A kártyatartó HTML-címkéjének cseréje. | `$tag`, `$card`, `$settings` |
| `wp_grid_builder/card/attributes` | A kártya oszlop- és sorszámának, hátterének, színsémájának és osztályának módosítása. | `$atts`, `$card` |

## Az elrendezés-burkoló címkéje

A szűrő a fő burkoló nyitó és záró HTML-címkéje előtt fut le. Ez a burkoló tartalmazhatja a szűrőket és a rácselemeket, és rácsoknál, valamint a `wpgb_render_template()` függvénnyel kirajzolt sablonoknál használatos. Alapértelmezetten `div`; az oldal szerkezetétől függően például `section`-re cserélheted.

| Argumentum | Típus | Leírás |
|---|---|---|
| `$tag` | szöveg | A burkoló címkéje (alapértelmezetten `div`). |
| `$settings` | objektum | A rács beállításai. |

```php
function prefix_layout_tagname( $tag, $settings ) {

	if ( 1 === $settings->id ) {
		$tag = 'section';
	}

	return $tag;

}
add_filter( 'wp_grid_builder/layout/wrapper_tag', 'prefix_layout_tagname', 10, 2 );
```

## A kártyatartó címkéje

A szűrő a kártya kirajzolásakor fut le. A kártyatartó alapértelmezett címkéje `article`. Az oldal szerkezetétől függően szükség lehet másikra, hogy a kód megfeleljen a W3C szabványnak.

| Argumentum | Típus | Leírás |
|---|---|---|
| `$tag` | szöveg | A kártyatartó címkéje (alapértelmezetten `article`). |
| `$card` | tömb | A kártya rétegeinek és blokkjainak leírása. |
| `$settings` | objektum | A rács beállításai. |

```php
function prefix_change_card_tag( $tag, $card, $settings ) {

	if ( 1 === $settings->id ) {
		$tag = 'div';
	}

	return $tag;

}
add_filter( 'wp_grid_builder/card/tag', 'prefix_change_card_tag', 10, 3 );
```

## A kártya tulajdonságai

A szűrő a kártya elrendezése előtt fut le. Módosíthatod vele a kártya `columns` (oszlopok) és `rows` (sorok) számát, a `content_background` és `overlay_background` hátteret, a `content_color_scheme` és `overlay_color_scheme` színsémát, valamint a `class` osztályt.

| Argumentum | Típus | Leírás |
|---|---|---|
| `$atts` | tömb | A kártya tulajdonságai. |
| `$card` | objektum | A kártya rétegeinek és blokkjainak leírása. |

### Az első kártya mérete

A példa az 1-es azonosítójú rács első kártyáját 2 oszlop és 2 sor méretűre állítja.

```php
function set_first_card_size( $atts, $card ) {

	static $set;

	$grid = wpgb_get_grid_settings();

	if ( 1 !== $grid->id ) {
		return $atts;
	}

	if ( ! $set ) {

		$atts['columns'] = 2;
		$atts['rows']    = 2;

	}

	$set = true;

	return $atts;

}
add_filter( 'wp_grid_builder/card/attributes', 'set_first_card_size', 10, 2 );
```

### Elrendezési minta

A példa ismétlődő méretmintát ad a masonry vagy metro rácsnak. A kártyák sorban a minta elemeit kapják, a végén újra az elejéről.

```php
function set_grid_layout_pattern( $atts, $card ) {

	static $index;

	$grid = wpgb_get_grid_settings();

	if ( 1 !== $grid->id ) {
		return $atts;
	}

	$pattern = [
		[ 'columns' => 2, 'rows' => 2 ],
		[ 'columns' => 1, 'rows' => 1 ],
		[ 'columns' => 2, 'rows' => 1 ],
		[ 'columns' => 3, 'rows' => 2 ],
		[ 'columns' => 1, 'rows' => 1 ],
	];

	if ( empty( $index ) || $index >= count( $pattern ) ) {
		$index = 0;
	}

	$atts = array_merge( $atts, $pattern[ $index ] );

	++$index;

	return $atts;

}
add_filter( 'wp_grid_builder/card/attributes', 'set_grid_layout_pattern', 10, 2 );
```
