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
Szekció neve “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:
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.
SVG-ikonok
Szekció neve “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.
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
Szekció neve “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).
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
Szekció neve “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).
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
Szekció neve “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. |
function prefix_disable_filesystem( $return ) {
return false;
}add_filter( 'wp_grid_builder/filesystem', 'prefix_disable_filesystem', 10, 1 );Készült: