Talen: Engels – 関数リファレンス/get the excerpt 日本語 (Voeg uw taal toe)

Description

Retourneert het uittreksel van de post. Dit is ofwel een door de gebruiker aangeleverd uittreksel, dat ongewijzigd wordt teruggestuurd, of een automatisch gegenereerde verkorte versie van de volledige inhoud van het bericht.

De automatisch gegenereerde uittreksels hebben alle shortcodes en tags verwijderd, wat betekent dat het gewoon een ongeformatteerde string is die geen regeleindes zou zien in enige vorm van output, aangezien de eigenlijke regeleindes in de ruwe tekst ook zijn verwijderd.

Wanneer dit wordt aangeroepen via the_excerpt() betekent dit dat de auto-gen uittreksels gewoon ruwe tekst zijn met <p></p> tags er omheen, in principe.

Auto-gen uittreksels hebben een “more” tag eraan toegevoegd. Deze tag is standaard ”. Dit kan worden veranderd met het excerpt_more filter.

De standaard woordlengte is 55 woorden. Deze kan worden gewijzigd met het filter excerpt_length.

Gebruik

<?php $excerpt = get_the_excerpt( int|WP_Post $post ) ?>

Deze functie moet worden gebruikt binnen The Loop als geen $post– of ID-parameter is doorgegeven.

Als deze functie buiten The Loop wordt gebruikt en de post geen aangepast uittreksel heeft, gebruikt deze functie wp_trim_excerpt() om een uittreksel te genereren. Die functie gebruikt get_the_content(), die moet worden gebruikt met The Loop en zal problemen veroorzaken als get_the_excerpt() wordt gebruikt buiten The Loop. Om deze problemen te vermijden, moet u setup_postdata() gebruiken voordat u get_the_excerpt() aanroept om het globale $post object in te stellen.

Parameters

$post (integer|WP_Post) (optioneel) Post ID of WP_Post object. Standaard is globaal $post. Standaard: null

Return Values

• Retourneert een bestaand uittreksel ongewijzigd (standaard) maar past get_the_excerpt filters toe.
• Retourneert een bijgesneden versie van de volledige inhoud van de post zoals beschreven, en past daarnaast wp_trim_excerpt filters toe. wp_trim_excerpt’ is gekoppeld aan ‘get_the_excerpt’, wat betekent dat je eigen get_the_excerpt filter voor of na de trim zal worden aangeroepen, afhankelijk van de prioriteit van je filter. Als de tekstparameter eerder wordt aangeroepen, zal deze een lege tekenreeks zijn als er geen door de gebruiker aangeleverd uittreksel is, terwijl het de bijgesneden versie van het volledige bericht zal zijn als de parameter erna wordt aangeroepen. In het laatste geval kan het nuttig of zinvoller zijn om ‘wp_trim_excerpt’ te gebruiken, omdat het een tweede parameter heeft die je de niet bijgesneden input geeft aan de wp_trim_excerpt functie, wat betekent dat deze tweede parameter gewoon de onbewerkte $post->post_excerpt.
• Voor wachtwoord beveiligde pagina’s retourneert het een string, die een standaard waarde heeft van “Er is geen uittreksel want dit is een beveiligde post.” Deze tekst kan worden gewijzigd in de functiedefinitie.

Voorbeelden

get_the_excerpt() kan worden gebruikt om de waarde op te halen en op te slaan in een variabele, zonder deze uit te voeren naar de pagina.

<?php$my_excerpt = get_the_excerpt();if ( '' != $my_excerpt ) {// Some string manipulation performed}echo $my_excerpt; // Outputs the processed value to the page?>

Gebruik get_the_excerpt() om een uittreksel af te drukken door een maximum aantal karakters op te geven.

<?phpthe_excerpt_max_charlength(140);function the_excerpt_max_charlength($charlength) {$excerpt = get_the_excerpt();$charlength++;if ( mb_strlen( $excerpt ) > $charlength ) {$subex = mb_substr( $excerpt, 0, $charlength - 5 );$exwords = explode( ' ', $subex );$excut = - ( mb_strlen( $exwords ) );if ( $excut < 0 ) {echo mb_substr( $subex, 0, $excut );} else {echo $subex;}echo '';} else {echo $excerpt;}}?>

Wijzigingslog

Sinds: 0.71