From 8d3892afc7413b4edbbf1072b7b3856b191d6b65 Mon Sep 17 00:00:00 2001
From: Marco Pereirinha <marco.pereirinha@xwp.co>
Date: Thu, 25 May 2023 09:18:30 +0100
Subject: [PATCH 1/3] Add filter on get asset payload

---
 php/class-media.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/php/class-media.php b/php/class-media.php
index d3c85ebb7..feafb7045 100644
--- a/php/class-media.php
+++ b/php/class-media.php
@@ -2090,6 +2090,19 @@ function ( $value, $key ) use ( &$asset ) {
 		$asset['attachment_id'] = $this->get_id_from_sync_key( $asset['sync_key'] );
 		$asset['instances']     = Relationship::get_ids_by_public_id( $asset['public_id'] );
 
+		/**
+		 * Filter the asset payload.
+		 *
+		 * @hook   cloudinary_asset_payload
+		 * @since  3.1.3
+		 *
+		 * @param $asset {array} The asset payload.
+		 * @param $data  {array} The raw data from the request.
+		 *
+		 * @return {array}
+		 */
+		$asset = apply_filters( 'cloudinary_asset_payload', $asset, $data );
+
 		return $asset;
 	}
 

From d1943e4bf7ac05ab8534a2e8c372b2210b93fc7f Mon Sep 17 00:00:00 2001
From: Marco Pereirinha <marco.pereirinha@xwp.co>
Date: Thu, 25 May 2023 09:19:40 +0100
Subject: [PATCH 2/3] Add action on download asset from Cloudinary DAM

---
 php/class-media.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/php/class-media.php b/php/class-media.php
index feafb7045..441edb535 100644
--- a/php/class-media.php
+++ b/php/class-media.php
@@ -2180,6 +2180,17 @@ public function down_sync_asset() {
 			}
 			$return['transformations'] = $asset['transformations'];
 
+			/**
+			 * Action for the downloaded assets from Cloudinary Media Library.
+			 *
+			 * @hook  cloudinary_download_asset
+			 * @since 3.1.3
+			 *
+			 * @param $asset  {array} The default filters.
+			 * @param $return {array} The return payload.
+			 */
+			do_action( 'cloudinary_download_asset', $asset, $return );
+
 			wp_send_json_success( $return );
 		}
 

From 5d6bdb371cdba0c760c0121f1e6bc81e84dc0981 Mon Sep 17 00:00:00 2001
From: Marco Pereirinha <marco.pereirinha@xwp.co>
Date: Wed, 31 May 2023 17:15:59 +0100
Subject: [PATCH 3/3] Add examples

---
 php/class-media.php | 49 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/php/class-media.php b/php/class-media.php
index 441edb535..0e7e58571 100644
--- a/php/class-media.php
+++ b/php/class-media.php
@@ -2100,6 +2100,34 @@ function ( $value, $key ) use ( &$asset ) {
 		 * @param $data  {array} The raw data from the request.
 		 *
 		 * @return {array}
+		 *
+		 * @example
+		 * <?php
+		 *
+		 * // Extend Cloudinary support for extra data.
+		 * // Contextual metadata is passed by default.
+		 * add_filter(
+		 *    'cloudinary_asset_payload',
+		 *    static function ( $asset, $payload ) {
+		 *        // The structured keys on Cloudinary to use in WordPress.
+		 *        $key = 'structured_key';
+		 *
+		 *        // Structural metadata. Beware of key collision with contextual metadata.
+		 *        if ( ! empty ( $payload['asset']['metadata'][ $key ] ) ) {
+		 *            // The sanitize function to use should be adequate to the data type.
+		 *            $asset['meta'][ $key ] = sanitize_text_field( $payload['asset']['metadata'][ $key ] );
+		 *        }
+		 *
+		 *        // The Cloudinary tags.
+		 *        if ( ! empty ( $payload['asset']['tags'] ) ) {
+		 *            $asset['tags'] = array_map( 'sanitize_text_field', $payload['asset']['tags'] );
+		 *        }
+		 *
+		 *        return $asset;
+		 *    },
+		 *    10,
+		 *    2
+		 * );
 		 */
 		$asset = apply_filters( 'cloudinary_asset_payload', $asset, $data );
 
@@ -2188,6 +2216,27 @@ public function down_sync_asset() {
 			 *
 			 * @param $asset  {array} The default filters.
 			 * @param $return {array} The return payload.
+			 *
+			 * @example
+			 * <?php
+			 * add_action(
+			 *    'cloudinary_download_asset',
+			 *    static function ( $asset ) {
+			 *        // Store metadata. Contextual and Structured metadata should be similar.
+			 *        $key = 'metadata_key';
+			 *        if ( ! empty( $asset['meta'][ $key ] ) && ! empty( $asset['attachment_id'] ) && 'attachment' === get_post_type( $asset['attachment_id'] ) ) {
+			 *            update_post_meta( $asset['attachment_id'],  $key , $asset['meta'][ $key ] );
+			 *        }
+			 *
+			 *        // Store the tags. The taxonomy needs to be assigned to the post type.
+			 *        if ( ! empty( $asset['tags'] ) && ! empty( $asset['attachment_id'] ) && 'attachment' === get_post_type( $asset['attachment_id'] ) ) {
+			 *            wp_set_post_terms(
+			 *                $asset['attachment_id'],
+			 *                $asset['tags']
+			 *            );
+			 *        }
+			 *    }
+			 * );
 			 */
 			do_action( 'cloudinary_download_asset', $asset, $return );