# PHP-szűrők: sablonok, ikonok, töltők, animációk és fájlrendszer

> Saját sablon, SVG-ikon, rácstöltő és kártyaanimáció regisztrálása, valamint a WordPress fájlrendszer használatának kikapcsolása.

Ezekkel a szűrőkkel saját elemeket regisztrálhatsz a bővítménybe, vagy a fájlkezelését állíthatod. A nevük a `wp_grid_builder/` előtaggal kezdődik.

| Szűrő | Mire jó | Argumentum |
|---|---|---|
| `wp_grid_builder/templates` | Saját lekérdezés és HTML regisztrálása a rács- és kártyarendszer nélkül. | `$templates` |
| `wp_grid_builder/icons` | Saját SVG-ikon a kártyaszerkesztőbe. | `$icons` |
| `wp_grid_builder/grid/loaders` | Saját töltő, ami a rács szűrésekor jelenik meg. | `$loaders` |
| `wp_grid_builder/card/animations` | Saját animáció a kártyák megjelenítéséhez. | `$animations` |
| `wp_grid_builder/filesystem` | A WordPress fájlrendszer használatának kikapcsolása. | `$return` |

## Sablonok

A `templates` szűrő a sablonok lekérésekor (shortcode-ok, widgetek, blokkok az admin felületen) és a frontenden való kirajzoláskor fut le. Saját lekérdezést és HTML-t regisztrálhatsz vele a rács és a kártya nélkül, a szűrőket mégis használhatod a saját tartalmaddal. Az egyéni vagy archív lekérdezések szűrésénél gyorsabb, mert a beépített optimalizációkat használja, és elkerüli a felesleges feldolgozást.

A sablon beállításai:

| Kulcs | Típus | Leírás |
|---|---|---|
| `class` | szöveg | A bejegyzéseket tartalmazó elrendezés-burkoló osztályneve. |
| `source_type` | szöveg | A lekérdezett objektum típusa: `post_type`, `term` vagy `user`. |
| `is_main_query` | logikai | Igaz esetén a sablon az archive.php, index.php vagy search.php ciklusát váltja ki. |
| `query_args` | tömb vagy hívható | A lekérdezés argumentumai. |
| `render_callback` | hívható | A tartalmat kirajzoló függvény. |
| `noresults_callback` | hívható | A „nincs találat” üzenetet kirajzoló függvény. |

A sablont a gyermektémában vagy egy bővítményben regisztráld:

```php
function prefix_register_template( $templates ) {

	$templates['my_template'] = [
		'class'              => '',
		'source_type'        => 'post_type',
		'is_main_query'      => false,
		'query_args'         => [
			'post_type'      => 'post',
			'posts_per_page' => 10,
		],
		'render_callback'    => 'prefix_render_callback',
		'noresults_callback' => 'prefix_noresults_callback',
	];

	return $templates;

}
add_filter( 'wp_grid_builder/templates', 'prefix_register_template', 10, 1 );
```

A két visszahívás például:

```php
function prefix_render_callback( $post ) {

	?>
	<article>
		<?php the_title( '<h3>', '</h3>' ); ?>
		<?php the_excerpt(); ?>
	</article>
	<?php

}

function prefix_noresults_callback() {

	?>
	<p><?php esc_html_e( 'Sajnos egyetlen találat sem felel meg a keresésnek.', 'text-domain' ); ?></p>
	<?php

}
```

Ha az `is_main_query` értéke `true`, a sablon az `archive.php`, `index.php` vagy `search.php` fő ciklusát váltja ki. Ilyenkor a `query_args` figyelmen kívül marad, mert a lekérdezést a WordPress sablon kezeli.

A sablont oldalon a `wpgb_render_template()` függvénnyel, a `[wpgb_template id="my_template"]` shortcode-dal, egy Gutenberg-blokkal vagy egy WordPress-widgettel jelenítheted meg.

## SVG-ikonok

Az `icons` szűrő akkor fut le, amikor a kártyaszerkesztő lekéri az elérhető SVG-ikonokat, és amikor egy kártya SVG-ikont rajzol ki. A saját ikonod megjelenik a kártyaszerkesztő SVG-ikon blokkjában.

Minden ikonhoz `title` (név) és `icon` (az SVG kódja) kulcs kell.

```php
function prefix_register_icon( $icons ) {

	$icons['my_icon'] = [
		'title' => 'Az ikonom',
		'icon'  => '<svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" fill="currentColor"><circle cx="12" cy="12" r="10"></circle></svg>',
	];

	return $icons;

}
add_filter( 'wp_grid_builder/icons', 'prefix_register_icon', 10, 1 );
```

## Rácstöltők

A `grid/loaders` szűrővel saját töltőt adhatsz hozzá, ami a rács szűrésekor jelenik meg. A tömb kulcsai: `name` (név), `html` (a töltő HTML-je) és `css` (a töltő stílusa).

```php
function prefix_register_grid_loaders( $loaders ) {

	$loaders['my_loader'] = [
		'name' => __( 'Betöltés...', 'text-domain' ),
		'html' => '<div class="loading-text">' . esc_html__( 'Betöltés...', 'text-domain' ) . '</div>',
		'css'  => '@keyframes loading-animation{0%{opacity:1}50%{opacity:0}100%{opacity:1}}.my_loader{display:flex;align-items:center;justify-content:center}.loading-text{font-weight:600;font-size:14px;background:0 0!important;animation:loading-animation 1s infinite}',
	];

	return $loaders;

}
add_filter( 'wp_grid_builder/grid/loaders', 'prefix_register_grid_loaders', 10, 1 );
```

## Kártyaanimációk

A `card/animations` szűrővel saját animációt regisztrálhatsz a kártyák megjelenítéséhez. A kulcsok: `name` (név), `visible` (a látható állapot CSS-tulajdonságai) és `hidden` (a rejtett állapot CSS-tulajdonságai).

```php
function prefix_register_card_animations( $animations ) {

	$animations['my_animation'] = [
		'name'    => __( 'Az animációm', 'text-domain' ),
		'visible' => [
			'transform' => 'perspective(2000px) translateY(0) rotateY(0) scale(1)',
			'opacity'   => 1,
		],
		'hidden'  => [
			'transform-origin' => '50% 50%',
			'transform'        => 'perspective(2000px) translateY(-200px) rotateY(-360deg) scale(0.8)',
			'opacity'          => 0,
		],
	];

	return $animations;

}
add_filter( 'wp_grid_builder/card/animations', 'prefix_register_card_animations', 10, 1 );
```

## WordPress fájlrendszer

A `filesystem` szűrő minden olyan alkalommal lefut, amikor a bővítmény a WordPress fájlrendszerével hoz létre vagy olvas be fájlt. Ha a szervered nem támogatja a WordPress fájlrendszert, kikapcsolhatod, és a bővítmény CSS-fájlok generálása helyett beágyazott stílusokat használ.

| Argumentum | Típus | Leírás |
|---|---|---|
| `$return` | logikai | Bekapcsolja vagy kikapcsolja a WordPress fájlrendszert. |

```php
function prefix_disable_filesystem( $return ) {

	return false;

}
add_filter( 'wp_grid_builder/filesystem', 'prefix_disable_filesystem', 10, 1 );
```
