Funkce get_the_post_thumbnail() WordPress vám umožní získat hlavní obrázek a zobrazit ho pomocí vašeho tématu nebo pluginu. V tomto článku vás naučíme, jak funkci get_the_post_thumbnail() použít k zobrazení doporučených obrázků kdekoli budete chtít.
Pokud chcete získat více informací o vytváření pluginů WordPressu, podívejte se na náš seriál návodů na vytvoření prvního pluginu WordPressu.
Poznámka: Chcete-li používat funkci get_the_post_thumbnail(), musíte v rámci svého tématu povolit její podporu.
Chcete-li povolit podporu funkce get_the_post_thumbnail(), vložte do souboru functions.php svého tématu následující text:
add_theme_support( ‚post-thumbnails‘ );
Základní použití
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); ?>
V uvedeném kódu jednoduše zobrazujeme hlavní obrázek příspěvku na základě definovaných parametrů. Níže jsou uvedeny různé parametry, které lze definovat v rámci funkce get_the_post_thumbnail().
Parametry
$post_id: Jedná se o nepovinný parametr, ve kterém můžete definovat ID příspěvku, ze kterého budete získávat zobrazený obrázek. Pokud není definován, zobrazí se doporučený obrázek z aktuálního příspěvku, který si prohlížíte.
$size: Toto je nepovinný parametr, který lze použít k určení velikosti, v jaké se zobrazí doporučený obrázek. Můžete definovat buď řetězec, nebo pole s rozměry.
Předdefinované velikosti:
- thumbnail
- medium
- large
- full
Vlastní velikosti:
Chcete-li definovat vlastní velikost, jednoduše ji definujte v rámci pole, například:
get_the_post_thumbnail($post_id, array(100,100), $attr );
Jak je vidět z výše uvedeného kódu, velikost obrázku je 100×100.
$attr: Toto je nepovinný parametr, ve kterém můžete pomocí pole definovat další atributy, jako je třída, alt text, název atd. Vypadalo by to asi následovně:
$attr = array(
‚src‘ => $src,
‚class‘ => „attachment-$size“,
‚alt‘ => trim(strip_tags( $attachment->post_excerpt )),
‚title‘ => trim(strip_tags( $attachment->post_title )),
);
V uvedeném příkladu ukládáme pole obsahující umístění obrázku, třídu, text alt a title do proměnné, která je později volána v rámci funkce get_the_post_thumbnail().