the_title
Φιλτράρει τον τίτλο ενός άρθρου όπου χρησιμοποιείται η get_the_title(), μαζί με μενού και λίστες της διαχείρισης. Ελέγξτε πρώτα πού βρίσκεστε.
Πότε εκτελείται
Το WordPress εφαρμόζει το the_title μέσα στη get_the_title(), την οποία χρησιμοποιούν η the_title() και πολλές άλλες συναρτήσεις. Έτσι εκτελείται για επικεφαλίδες σελίδων, λίστες άρθρων, στοιχεία μενού πλοήγησης, οθόνες της διαχείρισης, widgets και το REST API.
Δεν αλλάζει τον τίτλο στην καρτέλα του browser. Αυτός προέρχεται από τη wp_get_document_title()· δείτε το document_title_parts.
Παράμετροι
$post_titlestring |
Ο τίτλος του άρθρου. |
|---|---|
$post_idint |
Το ID του άρθρου. |
Τι να επιστρέψετε
Ο τίτλος ως συμβολοσειρά.
Παράδειγμα: Σύντομοι τίτλοι στις σελίδες αρχείων
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 εμφανίζονται ως κείμενο.