# PHP-szűrők: saját szűrő (facet) és saját kártyablokk

> Saját szűrőtípus és saját kártyablokk regisztrálása a wp_grid_builder/facets és a wp_grid_builder/blocks szűrővel.

Ezekkel a szűrőkkel új szűrőtípust (facet) és új blokkot adhatsz a kártyaszerkesztőhöz. A kódot a gyermektéma `functions.php` fájljába vagy egy saját bővítménybe írd.

| Szűrő | Mire jó | Argumentum |
|---|---|---|
| `wp_grid_builder/facets` | Saját szűrőtípus saját logikával. | `$facets` |
| `wp_grid_builder/blocks` | Saját blokk a kártyaszerkesztőbe, saját HTML-lel. | `$blocks` |

## Saját szűrőtípus

A `facets` szűrő akkor fut le, amikor a bővítmény lekéri a szűrőket az admin felületen, illetve a frontenden a szűrők megjelenítésekor és a tartalom lekérdezésekor. Saját szűrőtípust adhatsz vele hozzá. Ehhez haladó PHP- és SQL-ismeret kell.

A `$facets` tömbbe a saját szűrő kulcsa alá ezeket az adatokat kell tenni:

| Kulcs | Leírás |
|---|---|
| `name` | A szűrőtípus neve. |
| `type` | A típus, például `filter`. |
| `class` | A szűrőt megvalósító PHP-osztály neve. |
| `icon` | A típus SVG-ikonja. |
| `controls` | A szűrő beállítómezői. A `clone` típusú elemmel meglévő mezőket veheted át, például `content_type`, `source`, `include`, `exclude`, `include_choices`, `exclude_choices`, `parent`, `child_of`, `depth`, `orderby`, `order`, `limit`, `display_limit`, `show_more_label`, `show_less_label`. |

```php
function prefix_register_facet( $facets ) {

	$facets['my_facet'] = [
		'name'     => __( 'Az én szűrőm', 'text-domain' ),
		'type'     => 'filter',
		'class'    => 'My_Facet_Class',
		'icon'     => '<svg viewBox="0 0 24 24" width="24" height="24"><path d="M8 12.5h8V11H8v1.5Z M19 6.5H5a2 2 0 0 0-2 2V15a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V8.5a2 2 0 0 0-2-2ZM5 8h14a.5.5 0 0 1 .5.5V15a.5.5 0 0 1-.5.5H5a.5.5 0 0 1-.5-.5V8.5A.5.5 0 0 1 5 8Z"/></svg>',
		'controls' => [
			[
				'type'   => 'clone',
				'fields' => [
					'content_type',
					'source',
					'include',
					'exclude',
					'orderby',
					'order',
					'limit',
				],
			],
		],
	];

	return $facets;

}
add_filter( 'wp_grid_builder/facets', 'prefix_register_facet', 10, 1 );
```

A bővítmény a megadott osztály alábbi metódusait hívja meg, ha léteznek:

| Metódus | Feladata |
|---|---|
| `query_facet` | Lekérdezi a szűrő értékeit és neveit a tartalom és a szűrők állapota alapján. |
| `render_facet` | Kirajzolja a `query_facet` által lekérdezett értékeket. |
| `query_objects` | A kiválasztott értékek alapján lekérdezi a tartalmat szűrő azonosítókat (bejegyzés-, kifejezés- vagy felhasználóazonosítók). |

Példa: betűrendes lista, amellyel a tartalmat az első betű szerint szűrheted.

```php
class My_Facet_Class {

	public function __construct() {}

	public function query_facet( $facet ) {

		global $wpdb;

		$where_clause = wpgb_get_where_clause( $facet );

		$facet_names = $wpdb->get_col(
			$wpdb->prepare(
				"SELECT DISTINCT UPPER(LEFT(facet_name, 1)) AS letter
				FROM {$wpdb->prefix}wpgb_index
				WHERE slug = %s
				AND $where_clause
				GROUP BY letter",
				$facet['slug']
			)
		);

		return $facet_names;

	}

	public function render_facet( $facet, $items ) {

		$output  = '<div class="wpgb-alphabetical-facet">';
		$output .= '<ul class="wpgb-inline-list">';
		$output .= $this->render_letters( $facet, $items );
		$output .= '</ul>';
		$output .= '</div>';

		return $output;

	}

	public function render_letters( $facet, $items ) {

		$output  = '';
		$letters = str_split( 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' );

		foreach ( $letters as $letter ) {
			$output .= '<li>' . $this->render_button( $facet, $items, $letter ) . '</li>';
		}

		return $output;

	}

	public function render_button( $facet, $items, $letter ) {

		$checked  = in_array( $letter, $facet['selected'], true );
		$disabled = ! in_array( $letter, (array) $items, true );
		$pressed  = $checked ? 'true' : 'false';
		$tabindex = $disabled ? -1 : 0;

		$output  = '<div class="wpgb-button" role="button" aria-pressed="' . esc_attr( $pressed ) . '" tabindex="' . esc_attr( $tabindex ) . '">';
		$output .= '<input type="hidden" name="' . esc_attr( $facet['slug'] ) . '" value="' . esc_attr( $letter ) . '"' . disabled( $disabled, true, false ) . '>';
		$output .= '<span class="wpgb-button-label">' . esc_html( $letter ) . '</span>';
		$output .= '</div>';

		return $output;

	}

	public function query_objects( $facet ) {

		global $wpdb;

		$placeholders = rtrim( str_repeat( '%s,', count( $facet['selected'] ) ), ',' );

		$object_ids = $wpdb->get_col(
			$wpdb->prepare(
				"SELECT DISTINCT object_id
				FROM {$wpdb->prefix}wpgb_index
				WHERE slug = %s
				AND UPPER(LEFT(facet_name, 1)) IN ($placeholders)",
				array_merge( (array) $facet['slug'], $facet['selected'] )
			)
		);

		return $object_ids;

	}
}
```

## Saját kártyablokk

A `blocks` szűrő akkor fut le, amikor a kártyaszerkesztő lekéri az elérhető blokkokat, és amikor egy kártya saját blokkot rajzol ki. Segítségével saját tartalmat jeleníthetsz meg a kártyán, saját HTML-lel és logikával.

A `$blocks` tömbbe a blokk kulcsa alá két érték kerül: a `name` (a blokk neve a szerkesztőben) és a `render_callback` (a kirajzoló függvény). A függvényben az aktuális elemet a `wpgb_get_object()` adja vissza.

### Kép egyéni mezőből

A példa egy egyéni mezőből (ACF, Meta Box vagy bármely, a kép azonosítóját tároló mező) jelenít meg képet. Ismétlő, klón vagy csoportmezővel nem működik.

```php
function register_custom_field_image_block( $blocks ) {

	$blocks['custom_field_image_block'] = [
		'name'            => 'Egyéni mező - Kép',
		'render_callback' => 'render_custom_field_image_block',
	];

	return $blocks;

}
add_filter( 'wp_grid_builder/blocks', 'register_custom_field_image_block' );

function render_custom_field_image_block() {

	$object = wpgb_get_object();

	if ( ! isset( $object->post_type ) ) {
		return;
	}

	$image_id = get_post_meta( $object->ID, 'custom_field_name', true );

	if ( empty( $image_id ) ) {
		return;
	}

	$image_url = wp_get_attachment_image_url( $image_id, 'medium_large' );

	if ( empty( $image_url ) ) {
		return;
	}

	printf(
		'<img src="%s" alt="%s" width="100%%" height="250px" style="object-fit:contain">',
		esc_url( $image_url ),
		esc_attr( get_post_meta( $image_id, '_wp_attachment_image_alt', true ) )
	);
}
```

### E-mail-cím egyéni mezőből

```php
function register_custom_field_email_block( $blocks ) {

	$blocks['custom_field_email_block'] = [
		'name'            => 'Egyéni mező - E-mail',
		'render_callback' => 'render_custom_field_email_block',
	];

	return $blocks;

}
add_filter( 'wp_grid_builder/blocks', 'register_custom_field_email_block' );

function render_custom_field_email_block() {

	$object = wpgb_get_object();

	if ( ! isset( $object->post_type ) ) {
		return;
	}

	$email = get_post_meta( $object->ID, 'custom_field_name', true );

	if ( empty( $email ) ) {
		return;
	}

	$email = antispambot( $email );

	printf(
		'<a href="%s">%s</a>',
		esc_url( 'mailto:' . $email ),
		esc_html( $email )
	);
}
```

### Letölthető fájl egyéni mezőből

Az egyéni mező a fájl URL-jét tárolja, a blokk letöltési hivatkozást rajzol belőle.

```php
function register_custom_field_file_block( $blocks ) {

	$blocks['custom_field_file_block'] = [
		'name'            => 'Egyéni mező - Fájl',
		'render_callback' => 'render_custom_field_file_block',
	];

	return $blocks;

}
add_filter( 'wp_grid_builder/blocks', 'register_custom_field_file_block', 10, 1 );

function render_custom_field_file_block() {

	$object = wpgb_get_object();

	if ( ! isset( $object->post_type ) ) {
		return;
	}

	$file_url = get_post_meta( $object->ID, 'custom_field_name', true );

	if ( empty( $file_url ) ) {
		return;
	}

	printf(
		'<a href="%s" download="%s">Fájl letöltése</a>',
		esc_url( $file_url ),
		esc_attr( wp_basename( $file_url ) )
	);
}
```

### „Új” jelvény WooCommerce-termékeken

A blokk az „ÚJ” szöveget írja ki, ha a termék 30 napnál frissebb.

```php
function register_product_new_badge_block( $blocks ) {

	$blocks['product_new_badge_block'] = [
		'name'            => 'Termék - Új jelvény',
		'render_callback' => 'render_product_new_badge_block',
	];

	return $blocks;

}
add_filter( 'wp_grid_builder/blocks', 'register_product_new_badge_block' );

function render_product_new_badge_block() {

	$object = wpgb_get_object();

	if (
		! isset( $object->post_type ) ||
		'product' !== $object->post_type ||
		! function_exists( 'wc_get_product' )
	) {
		return;
	}

	$product = wc_get_product( $object->ID );

	if ( empty( $product ) ) {
		return;
	}

	$days_nb = 30;
	$current = ( new WC_DateTime() )->getTimestamp();
	$created = $product->get_date_created()->getTimestamp();

	if ( $current - $created < DAY_IN_SECONDS * $days_nb ) {
		echo 'ÚJ';
	}
}
```
