Met de get_the_post_thumbnail() WordPress functie kun je de uitgelichte afbeelding ophalen en deze weergeven met je thema of plugin. In dit artikel leren we u hoe u de get_the_post_thumbnail() functie kunt gebruiken om uitgelichte afbeeldingen weer te geven waar u maar wilt.
Wilt u meer informatie over het maken van WordPress plugins, bekijk dan onze tutorial serie over het maken van uw eerste WordPress plugin.
Note: Om de get_the_post_thumbnail() functie te gebruiken, moet u ondersteuning hiervoor inschakelen binnen uw thema.
Om ondersteuning voor de functie get_the_post_thumbnail() in te schakelen, neemt u het volgende op in het bestand functions.php van uw thema:
add_theme_support( ‘post-thumbnails’ );
Basic use
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); ?>
In de bovenstaande code geven we eenvoudig de uitgelichte afbeelding van een bericht weer op basis van de parameters die we hebben gedefinieerd. Hieronder ziet u de verschillende parameters die kunnen worden gedefinieerd in de functie get_the_post_thumbnail().
Parameters
$post_id: Dit is een optionele parameter waarin u de post-ID van de post kunt definiëren waarvan u de featured image zult verkrijgen. Als dit niet gedefinieerd is, zal het de uitgelichte afbeelding tonen van de huidige post die u bekijkt.
$size: Dit is een optionele parameter die kan worden gebruikt om de grootte te bepalen waarmee de uitgelichte afbeelding wordt weergegeven. U kunt een string of een array definiëren met de afmetingen.
Voorgedefinieerde afmetingen:
- thumbnail
- medium
- large
- full
Aangepaste afmetingen:
Om een aangepaste grootte te definiëren, definieert u deze eenvoudig binnen een array, bijvoorbeeld:
get_the_post_thumbnail($post_id, array(100,100), $attr );
Zoals u in de bovenstaande code kunt zien, is de afbeeldingsgrootte 100×100.
$attr: Dit is een optionele parameter waarin u een array kunt gebruiken om extra attributen te definiëren, zoals de klasse, alt-tekst, titel, enz. Dit zou er ongeveer als volgt uitzien:
$attr = array(
‘src’ => $src,
‘class’ => “attachment-$size”,
‘alt’ => trim(strip_tags( $attachment->post_excerpt )),
’title’ => trim(strip_tags( $attachment->post_title )),
);
In het bovenstaande voorbeeld slaan we de array met de afbeeldingslocatie, -klasse, alt-tekst en -titel op in een variabele die later wordt aangeroepen in de functie get_the_post_thumbnail().