ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / lab2454c / gemition.com / wp-content / plugins / woocommerce / includes

<?php
/**
 * WooCommerce Message Functions
 *
 * Functions for error/message handling and display.
 *
 * @package WooCommerce\Functions
 * @version 2.1.0
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Get the count of notices added, either for all notices (default) or for one.
 * particular notice type specified by $notice_type.
 *
 * @since  2.1
 * @param  string $notice_type Optional. The name of the notice type - either error, success or notice.
 * @return int
 */
function wc_notice_count( $notice_type = '' ) {
	if ( ! did_action( 'woocommerce_init' ) ) {
		wc_doing_it_wrong( __FUNCTION__, __( 'This function should not be called before woocommerce_init.', 'woocommerce' ), '2.3' );
		return;
	}

$notice_count = 0;
	$all_notices  = WC()->session->get( 'wc_notices', array() );

if ( isset( $all_notices[ $notice_type ] ) ) {

$notice_count = count( $all_notices[ $notice_type ] );

} elseif ( empty( $notice_type ) ) {

foreach ( $all_notices as $notices ) {
			$notice_count += count( $notices );
		}
	}

return $notice_count;
}

/**
 * Check if a notice has already been added.
 *
 * @since  2.1
 * @param  string $message The text to display in the notice.
 * @param  string $notice_type Optional. The name of the notice type - either error, success or notice.
 * @return bool
 */
function wc_has_notice( $message, $notice_type = 'success' ) {
	if ( ! did_action( 'woocommerce_init' ) ) {
		wc_doing_it_wrong( __FUNCTION__, __( 'This function should not be called before woocommerce_init.', 'woocommerce' ), '2.3' );
		return false;
	}

$notices = WC()->session->get( 'wc_notices', array() );
	$notices = isset( $notices[ $notice_type ] ) ? $notices[ $notice_type ] : array();
	return array_search( $message, wp_list_pluck( $notices, 'notice' ), true ) !== false;
}

/**
 * Add and store a notice.
 *
 * @since 2.1
 * @version 3.9.0
 * @param string $message     The text to display in the notice.
 * @param string $notice_type Optional. The name of the notice type - either error, success or notice.
 * @param array  $data        Optional notice data.
 */
function wc_add_notice( $message, $notice_type = 'success', $data = array() ) {
	if ( ! did_action( 'woocommerce_init' ) ) {
		wc_doing_it_wrong( __FUNCTION__, __( 'This function should not be called before woocommerce_init.', 'woocommerce' ), '2.3' );
		return;
	}

$notices = WC()->session->get( 'wc_notices', array() );

// Backward compatibility.
	if ( 'success' === $notice_type ) {
		$message = apply_filters( 'woocommerce_add_message', $message );
	}

$message = apply_filters( 'woocommerce_add_' . $notice_type, $message );

if ( ! empty( $message ) ) {
		$notices[ $notice_type ][] = array(
			'notice' => $message,
			'data'   => $data,
		);
	}

WC()->session->set( 'wc_notices', $notices );
}

/**
 * Set all notices at once.
 *
 * @since 2.6.0
 * @param array[] $notices Array of notices.
 */
function wc_set_notices( $notices ) {
	if ( ! did_action( 'woocommerce_init' ) ) {
		wc_doing_it_wrong( __FUNCTION__, __( 'This function should not be called before woocommerce_init.', 'woocommerce' ), '2.6' );
		return;
	}

WC()->session->set( 'wc_notices', $notices );
}

/**
 * Unset all notices.
 *
 * @since 2.1
 */
function wc_clear_notices() {
	if ( ! did_action( 'woocommerce_init' ) ) {
		wc_doing_it_wrong( __FUNCTION__, __( 'This function should not be called before woocommerce_init.', 'woocommerce' ), '2.3' );
		return;
	}
	WC()->session->set( 'wc_notices', null );
}

/**
 * Prints messages and errors which are stored in the session, then clears them.
 *
 * @since 2.1
 * @param bool $return true to return rather than echo. @since 3.5.0.
 * @return string|null
 */
function wc_print_notices( $return = false ) {
	if ( ! did_action( 'woocommerce_init' ) ) {
		wc_doing_it_wrong( __FUNCTION__, __( 'This function should not be called before woocommerce_init.', 'woocommerce' ), '2.3' );
		return;
	}

$all_notices  = WC()->session->get( 'wc_notices', array() );
	$notice_types = apply_filters( 'woocommerce_notice_types', array( 'error', 'success', 'notice' ) );

// Buffer output.
	ob_start();

foreach ( $notice_types as $notice_type ) {
		if ( wc_notice_count( $notice_type ) > 0 ) {
			$messages = array();

foreach ( $all_notices[ $notice_type ] as $notice ) {
				$messages[] = isset( $notice['notice'] ) ? $notice['notice'] : $notice;
			}

wc_get_template(
				"notices/{$notice_type}.php",
				array(
					'messages' => array_filter( $messages ), // @deprecated 3.9.0
					'notices'  => array_filter( $all_notices[ $notice_type ] ),
				)
			);
		}
	}

wc_clear_notices();

$notices = wc_kses_notice( ob_get_clean() );

if ( $return ) {
		return $notices;
	}

echo $notices; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}

/**
 * Print a single notice immediately.
 *
 * @since 2.1
 * @version 3.9.0
 * @param string $message The text to display in the notice.
 * @param string $notice_type Optional. The singular name of the notice type - either error, success or notice.
 * @param array  $data        Optional notice data. @since 3.9.0.
 */
function wc_print_notice( $message, $notice_type = 'success', $data = array() ) {
	if ( 'success' === $notice_type ) {
		$message = apply_filters( 'woocommerce_add_message', $message );
	}

$message = apply_filters( 'woocommerce_add_' . $notice_type, $message );

wc_get_template(
		"notices/{$notice_type}.php",
		array(
			'messages' => array( $message ), // @deprecated 3.9.0
			'notices'  => array(
				array(
					'notice' => $message,
					'data'   => $data,
				),
			),
		)
	);
}

/**
 * Returns all queued notices, optionally filtered by a notice type.
 *
 * @since  2.1
 * @version 3.9.0
 * @param  string $notice_type Optional. The singular name of the notice type - either error, success or notice.
 * @return array[]
 */
function wc_get_notices( $notice_type = '' ) {
	if ( ! did_action( 'woocommerce_init' ) ) {
		wc_doing_it_wrong( __FUNCTION__, __( 'This function should not be called before woocommerce_init.', 'woocommerce' ), '2.3' );
		return;
	}

$all_notices = WC()->session->get( 'wc_notices', array() );

if ( empty( $notice_type ) ) {
		$notices = $all_notices;
	} elseif ( isset( $all_notices[ $notice_type ] ) ) {
		$notices = $all_notices[ $notice_type ];
	} else {
		$notices = array();
	}

return $notices;
}

/**
 * Add notices for WP Errors.
 *
 * @param WP_Error $errors Errors.
 */
function wc_add_wp_error_notices( $errors ) {
	if ( is_wp_error( $errors ) && $errors->get_error_messages() ) {
		foreach ( $errors->get_error_messages() as $error ) {
			wc_add_notice( $error, 'error' );
		}
	}
}

/**
 * Filters out the same tags as wp_kses_post, but allows tabindex for <a> element.
 *
 * @since 3.5.0
 * @param string $message Content to filter through kses.
 * @return string
 */
function wc_kses_notice( $message ) {
	$allowed_tags = array_replace_recursive(
		wp_kses_allowed_html( 'post' ),
		array(
			'a' => array(
				'tabindex' => true,
			),
		)
	);

/**
	 * Kses notice allowed tags.
	 *
	 * @since 3.9.0
	 * @param array[]|string $allowed_tags An array of allowed HTML elements and attributes, or a context name such as 'post'.
	 */
	return wp_kses( $message, apply_filters( 'woocommerce_kses_notice_allowed_tags', $allowed_tags ) );
}

/**
 * Get notice data attribute.
 *
 * @since 3.9.0
 * @param array $notice Notice data.
 * @return string
 */
function wc_get_notice_data_attr( $notice ) {
	if ( empty( $notice['data'] ) ) {
		return;
	}

$attr = '';

foreach ( $notice['data'] as $key => $value ) {
		$attr .= sprintf(
			' data-%1$s="%2$s"',
			sanitize_title( $key ),
			esc_attr( $value )
		);
	}

return $attr;
}

[+] ..
[-] wc-page-functions.php [edit]
[-] class-wc-countries.php [edit]
[-] class-wc-ajax.php [edit]
[-] class-wc-privacy.php [edit]
[+] customizer
[+] gateways
[-] class-wc-order-refund.php [edit]
[-] wc-stock-functions.php [edit]
[-] class-wc-cart.php [edit]
[-] class-wc-tracker.php [edit]
[-] class-wc-frontend-scripts.php [edit]
[-] class-wc-product-download.php [edit]
[+] widgets
[+] admin
[-] class-wc-auth.php [edit]
[-] class-wc-rest-authentication.php [edit]
[-] class-wc-data-exception.php [edit]
[-] class-wc-log-levels.php [edit]
[-] wc-coupon-functions.php [edit]
[-] class-wc-order-item-shipping.php [edit]
[+] integrations
[-] class-wc-payment-gateways.php [edit]
[-] wc-order-functions.php [edit]
[+] shipping
[-] class-wc-order-item-coupon.php [edit]
[-] class-wc-payment-tokens.php [edit]
[-] wc-deprecated-functions.php [edit]
[-] class-wc-product-grouped.php [edit]
[+] tracks
[-] wc-product-functions.php [edit]
[-] class-wc-datetime.php [edit]
[-] wc-user-functions.php [edit]
[-] wc-widget-functions.php [edit]
[-] class-wc-breadcrumb.php [edit]
[-] class-wc-customer-download-log.php [edit]
[-] class-wc-order-query.php [edit]
[-] wc-template-hooks.php [edit]
[-] class-wc-https.php [edit]
[-] class-wc-order.php [edit]
[-] wc-attribute-functions.php [edit]
[-] class-wc-session-handler.php [edit]
[-] class-wc-product-variation.php [edit]
[-] class-wc-query.php [edit]
[-] class-wc-coupon.php [edit]
[-] class-wc-shipping-zone.php [edit]
[-] wc-account-functions.php [edit]
[-] wc-formatting-functions.php [edit]
[-] class-wc-integrations.php [edit]
[-] class-wc-validation.php [edit]
[-] class-wc-webhook.php [edit]
[+] traits
[-] class-wc-checkout.php [edit]
[-] wc-core-functions.php [edit]
[+] emails
[-] wc-cart-functions.php [edit]
[-] class-wc-shipping.php [edit]
[-] class-wc-customer-download.php [edit]
[-] class-wc-geolite-integration.php [edit]
[-] class-wc-data-store.php [edit]
[-] class-wc-order-item-tax.php [edit]
[-] class-wc-customer.php [edit]
[-] class-wc-product-attribute.php [edit]
[+] legacy
[+] import
[-] class-wc-cli.php [edit]
[+] wccom-site
[-] class-wc-form-handler.php [edit]
[-] class-wc-tax.php [edit]
[-] wc-order-item-functions.php [edit]
[+] blocks
[-] class-wc-cache-helper.php [edit]
[-] class-wc-cart-totals.php [edit]
[-] class-wc-emails.php [edit]
[-] class-wc-product-query.php [edit]
[-] class-wc-download-handler.php [edit]
[-] class-wc-product-external.php [edit]
[-] class-woocommerce.php [edit]
[-] class-wc-logger.php [edit]
[-] class-wc-shipping-zones.php [edit]
[-] class-wc-order-item-meta.php [edit]
[+] walkers
[+] shortcodes
[-] class-wc-cart-session.php [edit]
[+] rest-api
[-] class-wc-autoloader.php [edit]
[-] class-wc-meta-data.php [edit]
[-] wc-notice-functions.php [edit]
[+] queue
[+] react-admin
[-] class-wc-order-item.php [edit]
[-] class-wc-shortcodes.php [edit]
[-] wc-term-functions.php [edit]
[-] wc-webhook-functions.php [edit]
[-] class-wc-privacy-exporters.php [edit]
[-] class-wc-privacy-background-process.php [edit]
[-] class-wc-regenerate-images-request.php [edit]
[-] class-wc-deprecated-filter-hooks.php [edit]
[+] interfaces
[-] class-wc-background-emailer.php [edit]
[-] class-wc-geo-ip.php [edit]
[+] data-stores
[-] class-wc-comments.php [edit]
[-] wc-conditional-functions.php [edit]
[-] class-wc-product-factory.php [edit]
[+] theme-support
[+] libraries
[-] class-wc-structured-data.php [edit]
[-] class-wc-order-factory.php [edit]
[-] class-wc-cart-fees.php [edit]
[-] class-wc-deprecated-action-hooks.php [edit]
[-] class-wc-order-item-fee.php [edit]
[+] cli
[-] class-wc-background-updater.php [edit]
[-] class-wc-discounts.php [edit]
[-] class-wc-rate-limiter.php [edit]
[-] class-wc-geolocation.php [edit]
[-] class-wc-privacy-erasers.php [edit]
[-] class-wc-post-types.php [edit]
[+] export
[+] log-handlers
[-] class-wc-regenerate-images.php [edit]
[+] abstracts
[-] class-wc-rest-exception.php [edit]
[-] class-wc-order-item-product.php [edit]
[-] class-wc-product-simple.php [edit]
[-] wc-rest-functions.php [edit]
[-] class-wc-post-data.php [edit]
[-] class-wc-embed.php [edit]
[+] payment-tokens
[-] class-wc-template-loader.php [edit]
[-] class-wc-product-variable.php [edit]
[-] class-wc-install.php [edit]
[-] class-wc-shipping-rate.php [edit]
[-] class-wc-api.php [edit]
[-] wc-template-functions.php [edit]
[-] wc-update-functions.php [edit]
[-] class-wc-register-wp-admin-settings.php [edit]