From b63c6c89916257d3cf9ed40c52423b7b73e43a80 Mon Sep 17 00:00:00 2001
From: mricoul <mricoul@beapi.fr>
Date: Fri, 14 Aug 2026 14:27:52 +0200
Subject: [PATCH 1/2] feat(Datetime): add Datetime helper

---
 functions.php                       |  1 +
 inc/Helpers/Formatting/Datetime.php | 86 +++++++++++++++++++++++++++++
 2 files changed, 87 insertions(+)
 create mode 100644 inc/Helpers/Formatting/Datetime.php

diff --git a/functions.php b/functions.php
index 623b7b9c..a87370d4 100644
--- a/functions.php
+++ b/functions.php
@@ -27,6 +27,7 @@ function () {
 	}
 );
 require_once __DIR__ . '/inc/Helpers/Svg.php';
+require_once __DIR__ . '/inc/Helpers/Formatting/Datetime.php';
 require_once __DIR__ . '/inc/Helpers/Formatting/Escape.php';
 require_once __DIR__ . '/inc/Helpers/Formatting/Image.php';
 require_once __DIR__ . '/inc/Helpers/Formatting/Link.php';
diff --git a/inc/Helpers/Formatting/Datetime.php b/inc/Helpers/Formatting/Datetime.php
new file mode 100644
index 00000000..40d30616
--- /dev/null
+++ b/inc/Helpers/Formatting/Datetime.php
@@ -0,0 +1,86 @@
+<?php
+namespace BEA\Theme\Framework\Helpers\Formatting\Datetime;
+
+/**
+ * Echo accessible <time> markup.
+ *
+ * @usage BEA\Theme\Framework\Helpers\Formatting\Datetime\the_datetime( get_the_date( 'd.m.Y' ), [ 'datetime' => get_the_date( 'Y-m-d' ), 'class' => 'crd__date' ] );
+ *
+ * @param string $display_date Formatted date string shown to users.
+ * @param array  $settings {
+ *     Optional. Settings for the datetime markup.
+ *
+ *     @type string $before           Markup before the <time> element. Default empty.
+ *     @type string $after            Markup after the <time> element. Default empty.
+ *     @type string $class            CSS class on the <time> element. Default empty.
+ *     @type string $label            Screen-reader label prepended to the date. Default "Published on".
+ *     @type string $datetime         Value for the datetime attribute. Required.
+ *     @type bool   $show_label       Whether to output the screen-reader label. Default true.
+ * }
+ *
+ * @return void
+ */
+function the_datetime( string $display_date, array $settings = [] ): void {
+	echo get_the_datetime( $display_date, $settings ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+}
+
+/**
+ * Build accessible <time> markup.
+ *
+ * @usage BEA\Theme\Framework\Helpers\Formatting\Datetime\get_the_datetime( get_the_date( 'd.m.Y' ), [ 'datetime' => get_the_date( 'Y-m-d' ), 'class' => 'crd__date' ] );
+ *
+ * @param string $display_date Formatted date string shown to users.
+ * @param array  $settings {
+ *     Optional. Settings for the datetime markup.
+ *
+ *     @type string $before           Markup before the <time> element. Default empty.
+ *     @type string $after            Markup after the <time> element. Default empty.
+ *     @type string $class            CSS class on the <time> element. Default empty.
+ *     @type string $label            Screen-reader label prepended to the date. Default "Published on".
+ *     @type string $datetime         Value for the datetime attribute. Required.
+ *     @type bool   $show_label       Whether to output the screen-reader label. Default true.
+ * }
+ *
+ * @return string
+ */
+function get_the_datetime( string $display_date, array $settings = [] ): string {
+	$settings = wp_parse_args(
+		$settings,
+		[
+			'before'     => '',
+			'after'      => '',
+			'class'      => '',
+			'label'      => __( 'Published on', 'beapi-frontend-framework' ),
+			'datetime'   => '',
+			'show_label' => true,
+		]
+	);
+
+	if ( empty( $display_date ) || empty( $settings['datetime'] ) ) {
+		return '';
+	}
+
+	$settings = apply_filters( 'bea_theme_framework_datetime_settings', $settings, $display_date, $settings['datetime'] );
+
+	$class_attr = $settings['class'] ? sprintf( ' class="%s"', esc_attr( $settings['class'] ) ) : '';
+
+	$label_markup = '';
+	if ( $settings['show_label'] && ! empty( $settings['label'] ) ) {
+		$label_markup = sprintf(
+			'<span class="sr-only">%s </span>',
+			esc_html( $settings['label'] )
+		);
+	}
+
+	$datetime_markup = sprintf(
+		'<time%s datetime="%s">%s%s</time>',
+		$class_attr,
+		esc_attr( $settings['datetime'] ),
+		$label_markup,
+		esc_html( $display_date )
+	);
+
+	$datetime_markup = apply_filters( 'bea_theme_framework_datetime_markup', $datetime_markup, $settings, $display_date, $settings['datetime'] );
+
+	return $settings['before'] . $datetime_markup . $settings['after'];
+}

From 4d69737637b3647c2435cfe22d811cc1d7a2a5d9 Mon Sep 17 00:00:00 2001
From: mricoul <mricoul@beapi.fr>
Date: Fri, 14 Aug 2026 14:35:07 +0200
Subject: [PATCH 2/2] fix(wpcs): update package

---
 composer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/composer.json b/composer.json
index 98a1e7d0..c333a62a 100644
--- a/composer.json
+++ b/composer.json
@@ -23,7 +23,7 @@
         "phpcompatibility/phpcompatibility-wp": "^2.1",
         "phpro/grumphp-shim": "^2.6",
         "roave/security-advisories": "dev-latest",
-        "wp-coding-standards/wpcs": "3.3.0",
+        "wp-coding-standards/wpcs": "3.4.1",
         "wp-plugin/advanced-custom-fields": "6.8.4"
     },
     "scripts": {