From 1ffd9b43ac218957b172cdc3689400332e945762 Mon Sep 17 00:00:00 2001
From: Amine Kaddache <psj.amine@gmail.com>
Date: Tue, 11 Nov 2025 19:25:57 +0100
Subject: [PATCH] Update acf_render_field_instructions to use filter hook

---
 includes/acf-field-functions.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/includes/acf-field-functions.php b/includes/acf-field-functions.php
index 7826e16e..c5543c2b 100644
--- a/includes/acf-field-functions.php
+++ b/includes/acf-field-functions.php
@@ -903,14 +903,15 @@ function acf_render_field_instructions( $field, $tooltip = false ) {
 		$instructions = acf_esc_html( $field['instructions'] );
 
 		if ( $tooltip ) {
-			printf( '<div class="acf-tip"><i tabindex="0" class="acf-icon acf-icon-help acf-js-tooltip" title="%s">?</i></div>', esc_attr( $instructions ) ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function.
+			$description = sprintf( '<div class="acf-tip"><i tabindex="0" class="acf-icon acf-icon-help acf-js-tooltip" title="%s">?</i></div>', esc_attr( $instructions ) ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function.
 		} else {
-			printf( '<p class="description">%s</p>', $instructions ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function.
+			$description =sprintf( '<p class="description">%s</p>', $instructions ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function.
 		}
 	} elseif ( ! empty( $field['hint'] ) ) {
 		$instructions = acf_esc_html( $field['hint'] );
-		printf( '<p class="description">%s</p>', $instructions ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function.
+		$description =sprintf( '<p class="description">%s</p>', $instructions ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function.
 	}
+	echo \apply_filters( 'acf/render_field_instructions', $description, $field, $tooltip ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped earlier in function.
 }
 
 /**