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().

Napsat komentář

Vaše e-mailová adresa nebude zveřejněna.