Μετάβαση στο περιεχόμενο

Early-bird άδεια εφ’ όρου ζωής: $199 εφάπαξ, μόνο για τους πρώτους 200 αγοραστές. Δείτε την προσφορά

the_title

Φιλτράρει τον τίτλο ενός άρθρου όπου χρησιμοποιείται η get_the_title(), μαζί με μενού και λίστες της διαχείρισης. Ελέγξτε πρώτα πού βρίσκεστε.

  • Τύπος Filter
  • Προέλευση WordPress
  • Από την έκδοση 0.71
  • Καλείται στο wp-includes/post-template.php

Πότε εκτελείται

Το WordPress εφαρμόζει το the_title μέσα στη get_the_title(), την οποία χρησιμοποιούν η the_title() και πολλές άλλες συναρτήσεις. Έτσι εκτελείται για επικεφαλίδες σελίδων, λίστες άρθρων, στοιχεία μενού πλοήγησης, οθόνες της διαχείρισης, widgets και το REST API.

Δεν αλλάζει τον τίτλο στην καρτέλα του browser. Αυτός προέρχεται από τη wp_get_document_title()· δείτε το document_title_parts.

Παράμετροι

Παράμετροι
$post_titlestring Ο τίτλος του άρθρου.
$post_idint Το ID του άρθρου.

Τι να επιστρέψετε

Ο τίτλος ως συμβολοσειρά.

Παράδειγμα: Σύντομοι τίτλοι στις σελίδες αρχείων

PHP
add_filter( 'the_title', function ( $title, $post_id = 0 ) {
	if ( is_admin() || is_singular() || ! in_the_loop() || 'post' !== get_post_type( $post_id ) ) {
		return $title;
	}
	return wp_trim_words( $title, 8 );
}, 10, 2 );

Καλό να ξέρετε

  • Δώστε στο $post_id προεπιλεγμένη τιμή, όπως στο παράδειγμα. Ορισμένα plugins εφαρμόζουν το φίλτρο μόνο με τον τίτλο, και μια υποχρεωτική δεύτερη παράμετρος θα προκαλούσε μοιραίο σφάλμα.
  • Αποφύγετε να προσθέτετε HTML. Οι τίτλοι χρησιμοποιούνται και σε attributes και σε σημεία απλού κειμένου, όπου τα tags εμφανίζονται ως κείμενο.

Μεταφέρετε τα snippets σας μέσα σε ένα απόγευμα.

Η εισαγωγή δεν αλλάζει τίποτα μέχρι να κάνετε τη μετάβαση, και τα παλιά σας shortcodes συνεχίζουν να λειτουργούν.