9B534B8686E580E0E01768F00155B461

at path：ROOT / wp-content / plugins / woocommerce / src / Admin / Notes / NoteTraits.php

run：R W Run

DataStore.php

17.56 KB

2026-04-15 05:42:46

R W Run

DeprecatedNotes.php

13.82 KB

2026-04-15 05:42:46

R W Run

Note.php

19.33 KB

2026-04-15 05:42:46

R W Run

NoteTraits.php

8.78 KB

2026-04-15 05:42:46

R W Run

Notes.php

13.91 KB

2026-04-15 05:42:46

R W Run

NotesUnavailableException.php

353 By

2026-04-15 05:42:46

R W Run

error_log

📄NoteTraits.php

<?php
/**
 * WC Admin Note Traits
 *
 * WC Admin Note Traits class that houses shared functionality across notes.
 */

namespace Automattic\WooCommerce\Admin\Notes;

use Automattic\WooCommerce\Admin\WCAdminHelper;

defined( 'ABSPATH' ) || exit;

/**
 * NoteTraits class.
 */
trait NoteTraits {
	/**
	 * Test how long WooCommerce Admin has been active.
	 *
	 * @param int $seconds Time in seconds to check.
	 * @return bool Whether or not WooCommerce admin has been active for $seconds.
	 */
	private static function wc_admin_active_for( $seconds ) {
		return WCAdminHelper::is_wc_admin_active_for( $seconds );
	}

/**
	 * Test if WooCommerce Admin has been active within a pre-defined range.
	 *
	 * @param string $range range available in WC_ADMIN_STORE_AGE_RANGES.
	 * @param int    $custom_start custom start in range.
	 * @return bool Whether or not WooCommerce admin has been active within the range.
	 */
	private static function is_wc_admin_active_in_date_range( $range, $custom_start = null ) {
		return WCAdminHelper::is_wc_admin_active_in_date_range( $range, $custom_start );
	}

/**
	 * Check if the note has been previously added.
	 *
	 * @return bool
	 * @throws NotesUnavailableException Throws exception when notes are unavailable.
	 */
	public static function note_exists(): bool {
		/**
		 * Data store instance.
		 *
		 * @var DataStore $data_store
		 */
		$data_store = Notes::load_data_store();
		$note_ids   = $data_store->get_notes_with_name( self::NOTE_NAME );
		return ! empty( $note_ids );
	}

/**
	 * Checks if a note can and should be added.
	 *
	 * @return bool
	 * @throws NotesUnavailableException Throws exception when notes are unavailable.
	 */
	public static function can_be_added(): bool {
		$note = self::get_note();

if ( ! $note instanceof Note && ! $note instanceof WC_Admin_Note ) {
			return false;
		}

if ( self::note_exists() ) {
			return false;
		}

if (
			'no' === get_option( 'woocommerce_show_marketplace_suggestions', 'yes' ) &&
			Note::E_WC_ADMIN_NOTE_MARKETING === $note->get_type()
		) {
			return false;
		}

return true;
	}

/**
	 * Add the note if it passes predefined conditions.
	 *
	 * @return void
	 * @throws NotesUnavailableException Throws exception when notes are unavailable.
	 */
	public static function possibly_add_note(): void {
		$note = self::get_note();

if ( ! self::can_be_added() ) {
			return;
		}

if ( $note instanceof Note || $note instanceof WC_Admin_Note ) {
			$note->save();
		}
	}

/**
	 * Alias this method for backwards compatibility.
	 *
	 * @return void
	 * @throws NotesUnavailableException Throws exception when notes are unavailable.
	 */
	public static function add_note(): void {
		self::possibly_add_note();
	}

/**
	 * Should this note exist? (Default implementation is generous. Override as needed.)
	 */
	public static function is_applicable() {
		return true;
	}

/**
	 * Delete this note if it is not applicable, unless has been soft-deleted or actioned already.
	 *
	 * @return void
	 */
	public static function delete_if_not_applicable(): void {
		if ( ! self::is_applicable() ) {
			/**
			 * Data store instance.
			 *
			 * @var DataStore $data_store
			 */
			$data_store = Notes::load_data_store();
			$note_ids   = $data_store->get_notes_with_name( self::NOTE_NAME );

if ( ! empty( $note_ids ) ) {
				$note = Notes::get_note( $note_ids[0] );

if ( $note instanceof Note && ! $note->get_is_deleted() && ( Note::E_WC_ADMIN_NOTE_ACTIONED !== $note->get_status() ) ) {
					self::possibly_delete_note();
				}
			}
		}
	}

/**
	 * Possibly delete the note, if it exists in the database. Note that this
	 * is a hard delete, for where it doesn't make sense to soft delete or
	 * action the note.
	 *
	 * @return void
	 * @throws NotesUnavailableException Throws exception when notes are unavailable.
	 */
	public static function possibly_delete_note(): void {
		/**
		 * Data store instance.
		 *
		 * @var DataStore $data_store
		 */
		$data_store = Notes::load_data_store();
		$note_ids   = $data_store->get_notes_with_name( self::NOTE_NAME );

foreach ( $note_ids as $note_id ) {
			$note = Notes::get_note( $note_id );

if ( $note instanceof Note ) {
				$data_store->delete( $note );
			}
		}
	}

/**
	 * Update the note if it passes predefined conditions.
	 *
	 * @return void
	 * @throws NotesUnavailableException Throws exception when notes are unavailable.
	 */
	public static function possibly_update_note(): void {
		$note_in_db = Notes::get_note_by_name( self::NOTE_NAME );
		if ( ! $note_in_db instanceof Note ) {
			return;
		}

// Backwards compatibility for checking if the note class has a get_note method.
		/**
		 * Backwards compatibility check.
		 *
		 * @phpstan-ignore-next-line
		 */
		if ( ! method_exists( self::class, 'get_note' ) ) {
			return;
		}

$note = self::get_note();
		if ( ! $note instanceof Note && ! $note instanceof WC_Admin_Note ) {
			return;
		}

$need_save = in_array(
			true,
			array(
				self::update_note_field_if_changed( $note_in_db, $note, 'title' ),
				self::update_note_field_if_changed( $note_in_db, $note, 'content' ),
				self::update_note_field_if_changed( $note_in_db, $note, 'content_data' ),
				self::update_note_field_if_changed( $note_in_db, $note, 'type' ),
				self::update_note_field_if_changed( $note_in_db, $note, 'locale' ),
				self::update_note_field_if_changed( $note_in_db, $note, 'source' ),
				self::update_note_field_if_changed( $note_in_db, $note, 'actions' ),
			),
			true
		);

if ( $need_save ) {
			$note_in_db->save();
		}
	}

/**
	 * Get if the note has been actioned.
	 *
	 * @return bool
	 * @throws NotesUnavailableException Throws exception when notes are unavailable.
	 */
	public static function has_note_been_actioned(): bool {
		/**
		 * Data store instance.
		 *
		 * @var DataStore $data_store
		 */
		$data_store = Notes::load_data_store();
		$note_ids   = $data_store->get_notes_with_name( self::NOTE_NAME );

if ( ! empty( $note_ids ) ) {
			$note = Notes::get_note( $note_ids[0] );

if ( $note instanceof Note && Note::E_WC_ADMIN_NOTE_ACTIONED === $note->get_status() ) {
				return true;
			}
		}

return false;
	}

/**
	 * Update a note field of note1 if it's different from note2 with getter and setter.
	 *
	 * @param Note|WC_Admin_Note $note1 Note to update.
	 * @param Note|WC_Admin_Note $note2 Note to compare against.
	 * @param string             $field_name Field to update.
	 * @return bool True if the field was updated.
	 */
	private static function update_note_field_if_changed( $note1, $note2, string $field_name ): bool {
		// We need to serialize the stdObject to compare it.
		/**
		 * Getter method for note1.
		 *
		 * @var callable $getter1
		 */
		$getter1 = array( $note1, 'get_' . $field_name );
		/**
		 * Getter method for note2.
		 *
		 * @var callable $getter2
		 */
		$getter2           = array( $note2, 'get_' . $field_name );
		$note1_field_value = self::possibly_convert_object_to_array(
			call_user_func( $getter1 )
		);
		$note2_field_value = self::possibly_convert_object_to_array(
			call_user_func( $getter2 )
		);

if ( 'actions' === $field_name ) {
			// We need to individually compare the action fields because action object from db is different from action object of note.
			// For example, action object from db has "id".
			$diff        = array_udiff(
				(array) $note1_field_value,
				(array) $note2_field_value,
				function ( $action1, $action2 ): int {
					/**
					 * First action object.
					 *
					 * @var object{name?: string, label?: string, query?: string} $action1
					 */
					/**
					 * Second action object.
					 *
					 * @var object{name?: string, label?: string, query?: string} $action2
					 */
					if (
						isset(
							$action1->name,
							$action2->name,
							$action1->label,
							$action2->label,
							$action1->query,
							$action2->query
						) &&
						$action1->name === $action2->name &&
						$action1->label === $action2->label &&
						$action1->query === $action2->query
					) {
						return 0;
					}
					return -1;
				}
			);
			$need_update = count( $diff ) > 0;
		} else {
			$need_update = $note1_field_value !== $note2_field_value;
		}

if ( $need_update ) {
			/**
			 * Getter method for note2 field.
			 *
			 * @var callable $getter2_again
			 */
			$getter2_again = array( $note2, 'get_' . $field_name );
			/**
			 * Setter method for note1 field.
			 *
			 * @var callable $setter1
			 */
			$setter1 = array( $note1, 'set_' . $field_name );
			// Get note2 field again because it may have been changed during the comparison.
			call_user_func( $setter1, call_user_func( $getter2_again ) );
			return true;
		}
		return false;
	}

/**
	 * Convert a value to array if it's a stdClass.
	 *
	 * @param mixed $obj variable to convert.
	 * @return mixed
	 */
	private static function possibly_convert_object_to_array( $obj ) {
		if ( $obj instanceof \stdClass ) {
			return (array) $obj;
		}
		return $obj;
	}
}