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
Szekció neve “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. |
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.
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
Szekció neve “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
Szekció neve “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.
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
Szekció neve “E-mail-cím egyéni mezőből”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
Szekció neve “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.
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
Szekció neve “„Új” jelvény WooCommerce-termékeken”A blokk az „ÚJ” szöveget írja ki, ha a termék 30 napnál frissebb.
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'; }}Készült: