Tovább a tartalomhoz

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

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;
}
}

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.

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 ) )
);
}
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 )
);
}

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:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások