WordPress.org
Meer informatie #Meer informatie
Het toont het uittreksel van het huidige bericht nadat er verschillende filters op zijn toegepast, waaronder auto-p opmaak die dubbele regelafbrekingen in HTML paragrafen verandert. Het gebruikt get_the_excerpt() om eerst een ingekorte versie van de volledige inhoud van het bericht te genereren als er geen expliciet uittreksel voor het bericht is.
De ingekorte versie bevat een ‘more’ tag aan het eind die standaard het “hellip” symbool is. Een door de gebruiker geleverd uittreksel krijgt NIET standaard zo’n symbool. Om het toe te voegen, moet je ofwel de ruwe $post->post_excerpt handmatig aanpassen in je template voordat je de_excerpt() aanroept, ofwel een filter toevoegen voor ‘get_the_excerpt’ met een prioriteit lager dan 10, ofwel een filter toevoegen voor ‘wp_trim_excerpt’ (door de eerste en tweede parameter te vergelijken, want een door de gebruiker aangeleverd uittreksel wordt op geen enkele manier gewijzigd door deze functie).
Zie get_the_excerpt() voor meer details.
Een automatisch gegenereerd uittreksel zal ook alle shortcodes en tags verwijderd hebben. Het wordt ingekort tot een woord-grens en de standaard lengte is 55 woorden. Voor talen waarin woorden worden (of kunnen worden) beschreven met enkele karakters (bijv. Oost-Aziatische talen) is de woord-grens feitelijk het karakter.
Note: Als het huidige bericht een bijlage is, zoals in de attachment.php en image.php template loops, dan wordt de bijschrift van de bijlage getoond. Bijschriften bevatten niet de “” tekst.
Vergelijking met de <!-more-> quicktag #Vergelijking met de <!-more-> quicktag
Excerpts bieden een alternatief voor het gebruik van de <!–more–> quicktag. Terwijl deze meer-tag vereist dat een auteur van een bericht handmatig een “split” in de inhoud van het bericht maakt, die vervolgens wordt gebruikt om een “lees meer”-link op indexpagina’s te genereren, vereisen de uittreksels, maar niet noodzakelijk, dat een auteur van een bericht een “teaser” voor de volledige inhoud van het bericht levert.
De <!–meer–> quicktag vereist dat sjablonen de_content() gebruiken, terwijl het gebruik van uittreksels vereist, en toestaat, dat sjabloon schrijvers expliciet kiezen of ze volledige berichten weergeven (met behulp van de_content()) of uittreksels (met behulp van de_excerpt()).
De keuze om een volledig bericht of een uittreksel weer te geven kan dan worden gebaseerd op factoren zoals het gebruikte sjabloon, het type pagina, de categorie van het bericht, enzovoort. Met andere woorden, met een <!–meer–> quicktag bepaalt de auteur van het bericht wat er gebeurt, terwijl de sjabloonschrijver de controle heeft bij uittreksels. Bovendien, hoewel <!–more–> kan worden gebruikt om een echte splitsing te maken met behulp van de $stripteaser parameter, zou het moeilijk en ingewikkeld zijn om vervolgens te differentiëren op basis van kenmerken, waardoor dit in principe een site-brede keuze wordt.