Funkcja get_the_post_thumbnail() WordPress pozwoli ci uzyskać wyróżniony obraz i wyświetlić go za pomocą twojego motywu lub wtyczki. W tym artykule nauczymy Cię, jak używać funkcji get_the_post_thumbnail() do wyświetlania wyróżnionych obrazów, gdziekolwiek chcesz.
Jeśli chcesz uzyskać więcej informacji na temat tworzenia wtyczek WordPress, zobacz naszą serię samouczków na temat tworzenia pierwszej wtyczki WordPress.
Uwaga: Aby użyć funkcji get_the_post_thumbnail(), będziesz musiał włączyć jej obsługę w swoim motywie.
Aby włączyć wsparcie dla funkcji get_the_post_thumbnail(), umieść poniższe w pliku functions.php swojego motywu:
add_theme_support( 'post-thumbnails’ );
Podstawowe użycie
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); ?>
W powyższym kodzie, po prostu wyświetlamy wyróżniony obrazek postu w oparciu o parametry, które zdefiniowaliśmy. Poniżej zobaczysz różne parametry, które można zdefiniować w ramach funkcji get_the_post_thumbnail().
Parametry
$post_id: Jest to opcjonalny parametr, w którym możesz zdefiniować identyfikator postu, z którego będziesz uzyskiwał wyróżniony obraz. Jeśli nie jest zdefiniowany, wyświetli wyróżniony obraz z bieżącego postu, który przeglądasz.
$size: Jest to opcjonalny parametr, który może być użyty do określenia rozmiaru, w jakim wyświetlany jest wyróżniony obraz. Możesz zdefiniować ciąg znaków lub tablicę o wymiarach.
Predefiniowane rozmiary:
- thumbnail
- medium
- large
- full
Rozmiary niestandardowe:
Aby zdefiniować niestandardowy rozmiar, po prostu zdefiniuj go wewnątrz tablicy, na przykład:
get_the_post_thumbnail($post_id, array(100,100), $attr );
Jak widać z powyższego kodu, rozmiar obrazu to 100×100.
$attr: Jest to opcjonalny parametr, w którym możesz użyć tablicy do zdefiniowania dodatkowych atrybutów, takich jak klasa, tekst alt, tytuł itp. Wyglądałoby to coś takiego jak poniżej:
$attr = array(
’src’ => $src,
’class’ => „attachment-$size”,
’alt’ => trim(strip_tags( $attachment->post_excerpt )),
’title’ => trim(strip_tags( $attachment->post_title )),
);
W powyższym przykładzie przechowujemy tablicę zawierającą lokalizację obrazu, klasę, tekst alt i tytuł w zmiennej, która jest później wywoływana w funkcji get_the_post_thumbnail().