Merge pull request #172 from BeAPI/issue/165

Issue/165

Author: asadowski10

functions.php

@@ -11,3 +11,9 @@ function () {
 	}
 );
 require_once __DIR__ . '/inc/Helpers/Svg.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';
+require_once __DIR__ . '/inc/Helpers/Formatting/Share.php';
+require_once __DIR__ . '/inc/Helpers/Formatting/Term.php';
+require_once __DIR__ . '/inc/Helpers/Formatting/Text.php';

inc/Helpers/Accessible_Menu_Walker.php

@@ -0,0 +1,34 @@
+<?php
+namespace BEA\Theme\Framework\Helpers\Formatting\Escape;
+
+/**
+ * Method for escaping attributes
+ *
+ * @param string $value Value to be escaped
+ * @param string $escape We can pass an anonymous function or method in native escape form as a string (example: 'esc_url'). By default the method escapes the attributes
+ *
+ * @return mixed Return value escape
+ */
+function escape_attribute_value( string $value, string $escape ) {
+	if ( ! function_exists( $escape ) ) {
+		return $value;
+	}
+
+	return $escape( $value );
+}
+
+/**
+ * Method for escaping html or content
+ *
+ * @param string $value Value to be escaped
+ * @param string $escape We can pass an anonymous function or method in native escape form as a string (example: 'wp_kses'). By default the method escapes the html
+ *
+ * @return mixed Return value escape
+ */
+function escape_content_value( string $value, string $escape ) {
+	if ( ! function_exists( $escape ) ) {
+		return $value;
+	}
+
+	return $escape( $value );
+}

inc/Helpers/Formatting/Escape.php

@@ -0,0 +1,111 @@
+<?php
+namespace BEA\Theme\Framework\Helpers\Formatting\Image;
+
+/**
+ * @usage BEA\Theme\Framework\Helpers\Formatting\Image\get_the_image( 1, [  'data-location' => 'image-size' ] );
+ *
+ * @param int $image_id Attachment post ID
+ *
+ * @param array $attributes {
+ *    Attributes for the image markup.
+ *
+ * @type string $src Image attachment URL.
+ * @type string $data-location Location of image.
+ * @type string $class CSS class name or space-separated list of classes.
+ *                                 Default `attachment-$size_class size-$size_class`,
+ *                                 where `$size_class` is the image size being requested.
+ * @type string $alt Image description for the alt attribute.
+ * @type string $srcset The 'srcset' attribute value.
+ * @type string $sizes The 'sizes' attribute value.
+ * @type string|false $loading The 'loading' attribute value. Passing a value of false
+ *                                 will result in the attribute being omitted for the image.
+ *                                 Defaults to 'lazy', depending on wp_lazy_loading_enabled().
+ * }
+ *
+ * @param array $settings {
+ *    Optional. Settings for the image markup.
+ *
+ * @type string $size Optional. The 'sizes' attribute value.
+ * @type string $before Optional. Markup to prepend to the image. Default empty.
+ * @type string $after Optional. Markup to append to the image. Default empty.
+ *
+ * }
+ *
+ * @return string Return the markup of the image
+ */
+function get_the_image( int $image_id, array $attributes, array $settings = [] ): string {
+	if ( $image_id <= 0 ) {
+		return '';
+	}
+
+	$attributes = wp_parse_args(
+		$attributes,
+		[
+			'data-location' => '',
+			'class'         => '',
+		]
+	);
+
+	$attributes = apply_filters( 'bea_theme_framework_the_image_attributes', $attributes, $image_id, $settings );
+
+	$settings = wp_parse_args(
+		$settings,
+		[
+			'size'   => 'thumbnail',
+			'before' => '',
+			'after'  => '',
+		]
+	);
+
+	$settings     = apply_filters( 'bea_theme_framework_the_image_settings', $settings, $image_id, $attributes );
+	$image_markup = \wp_get_attachment_image(
+		$image_id,
+		$settings['size'],
+		false,
+		$attributes
+	);
+
+	if ( empty( $image_markup ) ) {
+		return '';
+	}
+
+	$image_markup = apply_filters( 'bea_theme_framework_the_image_markup', $image_markup, $image_id, $attributes, $settings );
+
+	return $settings['before'] . $image_markup . $settings['after'];
+}
+
+/**
+ * @usage BEA\Theme\Framework\Helpers\Formatting\Image\the_image( 1, [  'data-location' => 'image-size' ], ['before'  => '');
+ *
+ * @param int $image_id Attachment post ID
+ *
+ * @param array $attributes {
+ *    Attributes for the image markup.
+ *
+ * @type string $src Image attachment URL.
+ * @type string $data-location Location of image.
+ * @type string $class CSS class name or space-separated list of classes.
+ *                                 Default `attachment-$size_class size-$size_class`,
+ *                                 where `$size_class` is the image size being requested.
+ * @type string $alt Image description for the alt attribute.
+ * @type string $srcset The 'srcset' attribute value.
+ * @type string $sizes The 'sizes' attribute value.
+ * @type string|false $loading The 'loading' attribute value. Passing a value of false
+ *                                 will result in the attribute being omitted for the image.
+ *                                 Defaults to 'lazy', depending on wp_lazy_loading_enabled().
+ * }
+ *
+ * @param array $settings {
+ *    Optional. Settings for the image markup.
+ *
+ * @type string $size Optional. The 'sizes' attribute value.
+ * @type string $before Optional. Markup to prepend to the image. Default empty.
+ * @type string $after Optional. Markup to append to the image. Default empty.
+ *
+ * }
+ *
+ * @return void Echo of the image markup
+ */
+function the_image( int $image_id, array $attributes, array $settings = [] ): void {
+	echo get_the_image( $image_id, $attributes, $settings );
+}