The get_the_post_thumbnail() WordPress-funktion avulla voit hakea esillä olevan kuvan ja näyttää sen teeman tai laajennuksen avulla. Tässä artikkelissa opetamme käyttämään get_the_post_thumbnail()-funktiota esillä olevien kuvien näyttämiseen missä tahansa.
Jos haluat lisätietoja WordPress-liitännäisten luomisesta, katso ohjesarjamme Ensimmäisen WordPress-liitännäisen luomisesta.
Huomautus: Käyttääksesi get_the_post_thumbnail()-funktiota sinun on otettava käyttöön tuki sille teemassasi.
Voidaksesi ottaa käyttöön tuen get_the_post_thumbnail()-funktiolle, sisällytä teemasi functions.php-tiedostoon seuraava:
add_theme_support( ’post-thumbnails’ );
PERUSKÄYTTÖTARKOITUS
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); ?>
Yllä olevassa koodissa näytämme yksinkertaisesti postauksen esillä olevan kuvan määrittelemiemme parametrien perusteella. Alla näet eri parametrit, jotka voidaan määritellä get_the_post_thumbnail()-funktiossa.
Parametrit
$post_id: Tämä on valinnainen parametri, jossa voit määritellä sen postauksen post ID:n, josta saat esillä olevan kuvan. Jos tätä ei määritetä, näytetään esillä oleva kuva nykyisestä postauksesta, jota katselet.
$size: Tämä on valinnainen parametri, jolla voidaan määrittää esillä olevan kuvan koko. Voit määrittää joko merkkijonon tai joukon, jossa on mitat.
Esimääritetyt koot:
- pienoiskuva
- keskikoko
- suurikoko
- kokokoko
- kokokoko
Mukautetut koot:
Määrittääksesi mukautetun koon, määrittele se yksinkertaisesti joukon sisällä, esimerkiksi:
get_the_post_thumbnail($post_id, array(100,100), $attr );
Kuten yllä olevasta koodista näkyy, kuvan koko on 100×100.
$attr: Tämä on valinnainen parametri, jossa voit käyttää arraya lisäattribuuttien, kuten luokan, alt-tekstin, otsikon jne. määrittämiseen. Tämä näyttäisi jotakuinkin seuraavanlaiselta:
$attr = array(
’src’ => $src,
’class’ => ”attachment-$size”,
’alt’ => trim(strip_tags( $attachment->post_excerpt )),
’title’ => trim(strip_tags( $attachment->post_title )),
);
Yllä olevassa esimerkissä tallennamme kuvan sijainnin, luokan, alt-tekstin ja otsikon sisältävän matriisin muuttujaan, jota kutsutaan myöhemmin get_the_post_thumbnail()-funktiossa.