the_content

Φιλτράρει το περιεχόμενο ενός άρθρου πριν εμφανιστεί. Για να προσθέσετε ή να αλλάξετε κείμενο πριν ή μετά το κυρίως κείμενο.

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

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

Το WordPress εφαρμόζει το the_content όταν το θέμα καλεί τη the_content() και όταν αποδίδεται το μπλοκ Περιεχόμενο άρθρου, αλλά και σε feeds, σε απαντήσεις του REST API και στα αυτόματα αποσπάσματα. Τρέχουν εδώ και τα φίλτρα του πυρήνα: τα μπλοκ αποδίδονται με προτεραιότητα 9, οι παράγραφοι προστίθενται με 10 και τα shortcodes με 11.

Παίρνετε το περιεχόμενο ως HTML και πρέπει να το επιστρέψετε, αλλαγμένο ή όχι.

Παράμετροι

Παράμετροι
`$content`string	Το περιεχόμενο του τρέχοντος άρθρου.

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

Το περιεχόμενο ως συμβολοσειρά HTML. Επιστρέφετε πάντα το $content, ακόμη κι αν δεν το αλλάξετε.

Παράδειγμα: Σημείωση κάτω από κάθε άρθρο ιστολογίου

PHP

add_filter( 'the_content', function ( $content ) {
	if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {
		return $content;
	}
	$note = sprintf(
		'<p class="post-note">%s</p>',
		esc_html__( 'Thanks for reading. Questions? Leave a comment below.', 'my-snippets' )
	);
	return $content . $note;
} );

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

Ελέγξτε in_the_loop() και is_main_query(), ώστε το κείμενό σας να μην μπαίνει σε αποσπάσματα, πλαϊνές στήλες ή άλλα άρθρα της σελίδας.
Κανείς δεν κάνει escape την έξοδό σας για εσάς. Κάντε escape σε κάθε κείμενο ή URL που προσθέτετε.
Οι page builders και τα ειδικά πρότυπα που δεν καλούν τη the_content() δεν εκτελούν αυτό το φίλτρο.