v2.9.6

Author: algoritmika

changelog.txt

@@ -1,5 +1,13 @@
 == Changelog ==
 
+= 2.9.6 - 29/04/2024 =
+* Dev - Shortcodes - `[order_customer_order_notes]` shortcode added.
+* WC tested up to: 8.8.
+
+= 2.9.5 - 08/04/2024 =
+* Dev - Shortcodes - `[order_total_items_qty]` shortcode added.
+* Tested up to: 6.5.
+
 = 2.9.4 - 01/04/2024 =
 * Dev - Shortcodes - `[order_view_url]` shortcode added.
 * Dev - Shortcodes - `[order_edit_url]` shortcode added.

custom-emails-for-woocommerce.php

@@ -3,12 +3,12 @@
 Plugin Name: Additional Custom Emails for WooCommerce
 Plugin URI: https://wpfactory.com/item/custom-emails-for-woocommerce/
 Description: Add custom emails to WooCommerce.
-Version: 2.9.5
+Version: 2.9.6
 Author: WPFactory
 Author URI: https://wpfactory.com
 Text Domain: custom-emails-for-woocommerce
 Domain Path: /langs
-WC tested up to: 8.7
+WC tested up to: 8.8
 */
 
 defined( 'ABSPATH' ) || exit;
@@ -30,7 +30,7 @@
 	}
 }
 
-defined( 'ALG_WC_CUSTOM_EMAILS_VERSION' ) || define( 'ALG_WC_CUSTOM_EMAILS_VERSION', '2.9.5' );
+defined( 'ALG_WC_CUSTOM_EMAILS_VERSION' ) || define( 'ALG_WC_CUSTOM_EMAILS_VERSION', '2.9.6' );
 
 defined( 'ALG_WC_CUSTOM_EMAILS_FILE' ) || define( 'ALG_WC_CUSTOM_EMAILS_FILE', __FILE__ );
 

includes/class-alg-wc-custom-emails-shortcodes.php

@@ -2,7 +2,7 @@
 /**
  * Custom Emails for WooCommerce - Emails Shortcodes Class
  *
- * @version 2.9.5
+ * @version 2.9.6
  * @since   1.0.0
  *
  * @author  Algoritmika Ltd
@@ -49,7 +49,7 @@ class Alg_WC_Custom_Emails_Shortcodes {
 	/**
 	 * Constructor.
 	 *
-	 * @version 2.9.5
+	 * @version 2.9.6
 	 * @since   1.0.0
 	 *
 	 * @todo    (dev) not order related (e.g., customer; product)
@@ -74,6 +74,7 @@ function __construct() {
 			'order_cancel_url',
 			'order_checkout_payment_url',
 			'order_customer_note',
+			'order_customer_order_notes',
 			'order_date',
 			'order_details',
 			'order_downloads',
@@ -227,6 +228,27 @@ function user_prop( $atts, $content = '' ) {
 		return $this->return_shortcode( $this->user->get( $atts['key'] ), $atts );
 	}
 
+	/**
+	 * order_customer_order_notes.
+	 *
+	 * @version 2.9.6
+	 * @since   2.9.6
+	 *
+	 * @todo    (dev) `comment_date`?
+	 * @todo    (dev) `comment_author`, `comment_author_email`?
+	 * @todo    (dev) customizable glue (`<br>`)?
+	 * @todo    (dev) customizable sorting?
+	 */
+	function order_customer_order_notes( $atts, $content = '' ) {
+		if ( ! $this->order ) {
+			return '';
+		}
+		$notes = $this->order->get_customer_order_notes();
+		$notes = wp_list_pluck( $notes, 'comment_content' );
+		$notes = implode( '<br>', $notes );
+		return $this->return_shortcode( $notes, $atts );
+	}
+
 	/**
 	 * order_checkout_payment_url.
 	 *
@@ -813,9 +835,11 @@ function clear( $atts, $content = '' ) {
 	 * @version 1.0.0
 	 * @since   1.0.0
 	 *
-	 * @todo    (dev) more common atts, e.g., find/replace, strip_tags, any_func, etc.
+	 * @todo    (dev) more common atts, e.g., on_empty, find/replace, strip_tags, any_func, etc.
 	 */
 	function return_shortcode( $value, $atts ) {
+
+		// Add, multiply
 		if ( is_numeric( $value ) ) {
 			if ( ! empty( $atts['add'] ) ) {
 				$value += $atts['add'];
@@ -824,6 +848,8 @@ function return_shortcode( $value, $atts ) {
 				$value *= $atts['multiply'];
 			}
 		}
+
+		// Format
 		if ( isset( $atts['format'] ) ) {
 			switch ( $atts['format'] ) {
 				case 'price':
@@ -833,7 +859,17 @@ function return_shortcode( $value, $atts ) {
 					$value = sprintf( $atts['format'], $value );
 			}
 		}
-		return ( '' !== $value ? ( ( isset( $atts['before'] ) ? $atts['before'] : '' ) . $value . ( isset( $atts['after'] ) ? $atts['after'] : '' ) ) : '' );
+
+		// Before, after
+		return ( '' !== $value ?
+			(
+				( isset( $atts['before'] ) ? $atts['before'] : '' ) .
+					$value .
+				( isset( $atts['after'] )  ? $atts['after']  : '' )
+			) :
+			''
+		);
+
 	}
 
 }

langs/custom-emails-for-woocommerce.pot

@@ -111,12 +111,12 @@ msgstr ""
 msgid "Renewal new order"
 msgstr ""
 
-#: includes/class-alg-wc-custom-emails-shortcodes.php:174
+#: includes/class-alg-wc-custom-emails-shortcodes.php:175
 #, php-format
 msgid "Created by the \"%s\" plugin"
 msgstr ""
 
-#: includes/class-alg-wc-custom-emails-shortcodes.php:175
+#: includes/class-alg-wc-custom-emails-shortcodes.php:176
 msgid "Custom Emails for WooCommerce"
 msgstr ""
 

readme.txt

@@ -3,7 +3,7 @@ Contributors: wpcodefactory, algoritmika, anbinder, karzin, omardabbas, kousikmu
 Tags: woocommerce, emails, email, custom email, custom emails
 Requires at least: 4.4
 Tested up to: 6.5
-Stable tag: 2.9.5
+Stable tag: 2.9.6
 License: GNU General Public License v3.0
 License URI: http://www.gnu.org/licenses/gpl-3.0.html
 
@@ -146,6 +146,10 @@ Dive in and discover more tools to empower your WooCommerce Store!
 
 == Changelog ==
 
+= 2.9.6 - 29/04/2024 =
+* Dev - Shortcodes - `[order_customer_order_notes]` shortcode added.
+* WC tested up to: 8.8.
+
 = 2.9.5 - 08/04/2024 =
 * Dev - Shortcodes - `[order_total_items_qty]` shortcode added.
 * Tested up to: 6.5.