A get_the_post_thumbnail() WordPress funkció lehetővé teszi, hogy megkapja a kiemelt képet, és megjelenítse azt a téma vagy plugin segítségével. Ebben a cikkben megtanítjuk, hogyan használhatja a get_the_post_thumbnail() függvényt a kiemelt képek megjelenítéséhez bárhol, ahol szeretné.
Ha további információkat szeretne a WordPress bővítmények létrehozásával kapcsolatban, tekintse meg az első WordPress bővítmény létrehozásával kapcsolatos bemutató sorozatunkat.
Megjegyzés: A get_the_post_thumbnail() függvény használatához engedélyeznie kell annak támogatását a témájában.
A get_the_post_thumbnail() függvény támogatásának engedélyezéséhez a következőket kell beépíteni a téma functions.php fájljába:
add_theme_support( ‘post-thumbnails’ );
Basic usage
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); ?>
A fenti kódban egyszerűen megjelenítjük egy poszt kiemelt képét az általunk meghatározott paraméterek alapján. Az alábbiakban a get_the_post_thumbnail() függvényen belül definiálható különböző paramétereket láthatjuk.
Paraméterek
$post_id: Ez egy opcionális paraméter, amelyben megadhatja annak a posztnak az azonosítóját, amelyből a kiemelt képet kapja. Ha ez nincs megadva, akkor a megjelenített képet az aktuálisan megtekintett bejegyzésből fogja megjeleníteni.
$size: Ez egy opcionális paraméter, amellyel meghatározható, hogy milyen méretben jelenjen meg a kiemelt kép. Megadhat egy karakterláncot vagy egy tömböt a méretekkel.
Előre meghatározott méretek:
- miniatűr
- közepes
- nagy
- teljes
Egyéni méretek:
Az egyéni méret meghatározásához egyszerűen definiáljuk egy tömbben, például:
get_the_post_thumbnail($post_id, array(100,100), $attr );
Amint a fenti kódból látható, a kép mérete 100×100.
$attr: Ez egy opcionális paraméter, amelyben egy tömböt használhatunk további attribútumok, például az osztály, alt szöveg, cím stb. meghatározására. Ez valahogy így nézne ki:
$attr = array(
‘src’ => $src,
‘class’ => “attachment-$size”,
‘alt’ => trim(strip_tags( $attachment->post_excerpt )),
‘title’ => trim(strip_tags( $attachment->post_title )),
);
A fenti példában a kép helyét, osztályát, alt szövegét és címét tartalmazó tömböt egy változóban tároljuk, amelyet később a get_the_post_thumbnail() függvényen belül hívunk meg.