Bejegyzések widget fejlesztőknek
A Bejegyzések widget műveletei (action) és szűrői (filter) kódpéldákkal, és a portfólióelemek megjelenítése egy szűrővel.
A Bejegyzések widget kimenetét PHP-kóddal is alakíthatod. A kódot a gyermektéma functions.php fájljába vagy egy saját bővítménybe tedd, hogy a téma frissítése ne törölje.
Paraméterek
Szekció neve “Paraméterek”A műveletek és szűrők az alábbi paraméterekből használnak néhányat:
| Paraméter | Jelentése |
|---|---|
$settings |
Az adott widget teljes beállítástömbje. Ebből feltételeket is építhetsz a kiválasztott beállítások szerint. |
$post_id |
A ciklusban éppen kirajzolt bejegyzés azonosítója; akkor hasznos, ha bejegyzésspecifikus adatot kérnél le. |
$query |
A WP_Query objektum. |
$classes |
Az osztályok tömbje. |
$date_format |
A dátum formátuma, például „F j, Y”. |
Műveletek (action)
Szekció neve “Műveletek (action)”A műveletekkel a widget kimenetének adott pontjára szúrhatsz be saját HTML-t. Az add_action utolsó két paramétere a prioritás és a paraméterek száma.
| Művelet | Mikor fut | Paraméterek |
|---|---|---|
uael_posts_before_outer_wrap |
a külső burkoló elején | $settings |
uael_posts_after_outer_wrap |
a külső burkoló végén | $settings |
uael_posts_before_wrap |
a bejegyzések burkolójának elején | $settings |
uael_posts_after_wrap |
a bejegyzések burkolójának végén | $post_id, $settings |
uael_single_post_before_wrap / uael_single_post_after_wrap |
egy bejegyzés burkolója előtt / után | $post_id, $settings |
uael_single_post_before_inner_wrap / uael_single_post_after_inner_wrap |
a bejegyzés belső burkolója előtt / után | $post_id, $settings |
uael_single_post_before_content_wrap / uael_single_post_after_content_wrap |
a bejegyzés tartalmi burkolója előtt / után | $post_id, $settings |
uael_single_post_before_thumbnail / uael_single_post_after_thumbnail |
a bélyegkép előtt / után | $post_id, $settings |
uael_single_post_before_meta / uael_single_post_after_meta |
a meta előtt / után | $post_id, $settings |
uael_single_post_before_terms / uael_single_post_after_terms |
a taxonómiák előtt / után | $post_id, $settings |
uael_single_post_before_comments / uael_single_post_after_comments |
a hozzászólások előtt / után | $post_id, $settings |
uael_single_post_before_date / uael_single_post_after_date |
a dátum előtt / után | $post_id, $settings |
uael_single_post_before_author / uael_single_post_after_author |
a szerző előtt / után | $post_id, $settings |
uael_single_post_before_title / uael_single_post_after_title |
a cím előtt / után | $post_id, $settings |
uael_single_post_before_excerpt / uael_single_post_after_excerpt |
a kivonat előtt / után | $post_id, $settings |
uael_single_post_before_cta / uael_single_post_after_cta |
a felhívás cselekvésre elem előtt / után | $post_id, $settings |
Példa: szöveg a külső burkoló elejére, és egy sor minden cím után.
function summary_wrap_before( $settings ) { echo '<div>A bejegyzések burkolójának elején vagyok.</div>';}add_action( 'uael_posts_before_outer_wrap', 'summary_wrap_before', 10, 1 );
function title_after( $post_id, $settings ) { echo '<div>Ez a cím után jelenik meg.</div>';}add_action( 'uael_single_post_after_title', 'title_after', 10, 2 );Szűrők (filter)
Szekció neve “Szűrők (filter)”A lekérdezés módosítása
Szekció neve “A lekérdezés módosítása”add_filter( 'uael_posts_query_args', function( $query, $settings ) { // Itt módosíthatod a lekérdezést. return $query;}, 10, 2 );Osztályok hozzáadása a burkolókhoz
Szekció neve “Osztályok hozzáadása a burkolókhoz”add_filter( 'uael_wrapper_classes', function( $classes ) { array_push( $classes, 'my-new-class' ); return $classes;} );
add_filter( 'uael_outer_wrapper_classes', function( $classes ) { array_push( $classes, 'my-new-class123' ); return $classes;} );A bejegyzés hivatkozásának módosítása
Szekció neve “A bejegyzés hivatkozásának módosítása”add_filter( 'uael_single_post_link', function( $link, $post_id, $settings ) { $link .= '&utm_campaign=post_grid'; return $link;}, 10, 3 );Dátumformátum és eseménydátum
Szekció neve “Dátumformátum és eseménydátum”add_filter( 'uael_post_the_date_format', function( $date, $post_id, $date_format ) { return $date;}, 10, 3 );
// Az Esemény kinézet dátuma.add_filter( 'uael_post_event_date', function( $date, $post_id, $date_format ) { return $date;}, 10, 3 );A meta elemek sorrendje
Szekció neve “A meta elemek sorrendje”A tömb az alapértelmezett sorrendet adja, az elemek felcserélhetők:
add_filter( 'uael_post_meta_sequence', function( $sequence ) { return array( 'author', 'date', 'comments', 'cat', 'tag' );} );A taxonómia jelvény linkelése
Szekció neve “A taxonómia jelvény linkelése”Az yes érték linkké teszi a jelvényt, a no megszünteti a linket.
add_filter( 'uael_link_taxomony_badge', function( $value ) { $value = 'yes'; return $value;} );Szűrhető fülek és jelvények
Szekció neve “Szűrhető fülek és jelvények”add_filter( 'uael_posts_filterable_tabs', function( $filters, $settings ) { return $filters;}, 10, 2 );
add_filter( 'uael_posts_tax_filter', function( $terms ) { return $terms;}, 10, 2 );A kategória meta és az AJAX-lapozás eltolása
Szekció neve “A kategória meta és az AJAX-lapozás eltolása”add_filter( 'uael_posts_meta_category', function( $terms, $settings ) { return $terms;}, 10, 2 );
add_filter( 'uael_post_offset_top', function( $offset_top ) { return $offset_top;}, 10, 2 );Az uael_post_offset_top szűrő azt a távolságot módosítja, amelyre az oldal az AJAX-os lapozás után felgörget.
Portfólióelemek megjelenítése
Szekció neve “Portfólióelemek megjelenítése”Ha a Bejegyzés típusa listából a portfóliót választod, de a widget az „Sajnáljuk, nem találtunk bejegyzést. Próbálj meg másik keresést.” jellegű figyelmeztetést írja ki, az a miatt van, hogy az Astra portfólió elemeit a widget alapból kizárja. Egy szűrővel felülbírálhatod ezt, és minden portfólióelem megjelenik.
Használj gyermektémát, hogy a téma frissítése ne törölje a módosítást.
-
A WordPress vezérlőpultján nyisd meg a Megjelenés → Témaszerkesztő menüt.
-
A jobb oldali legördülő listából válaszd ki a gyermektémát.
-
Nyisd meg a
functions.phpfájlt. -
Illeszd be a következő sort:
add_filter( 'astra_portfolio_exclude_portfolio_items', '__return_false' ); -
Kattints a Fájl frissítése gombra.
A szűrő a portfólióelemek kizárását kapcsolja ki, így a widget minden elemet megjelenít.
Készült: