Tovább a tartalomhoz

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

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:

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:

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.

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.

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

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).

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

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).

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

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.
function prefix_disable_filesystem( $return ) {
return false;
}
add_filter( 'wp_grid_builder/filesystem', 'prefix_disable_filesystem', 10, 1 );

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