woocommerce/includes/wc-webhook-functions.php

93 lines
2.1 KiB
PHP

<?php
/**
* WooCommerce Webhook functions
*
* @author Automattic
* @category Core
* @package WooCommerce/Functions
* @version 3.3.0
*/
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* Check if the given topic is a valid webhook topic, a topic is valid if:
*
* + starts with `action.woocommerce_` or `action.wc_`.
* + it has a valid resource & event.
*
* @since 2.2.0
* @param string $topic Webhook topic.
* @return bool
*/
function wc_is_webhook_valid_topic( $topic ) {
// Custom topics are prefixed with woocommerce_ or wc_ are valid.
if ( 0 === strpos( $topic, 'action.woocommerce_' ) || 0 === strpos( $topic, 'action.wc_' ) ) {
return true;
}
$data = explode( '.', $topic );
if ( ! isset( $data[0] ) || ! isset( $data[1] ) ) {
return false;
}
$valid_resources = apply_filters( 'woocommerce_valid_webhook_resources', array( 'coupon', 'customer', 'order', 'product' ) );
$valid_events = apply_filters( 'woocommerce_valid_webhook_events', array( 'created', 'updated', 'deleted', 'restored' ) );
if ( in_array( $data[0], $valid_resources, true ) && in_array( $data[1], $valid_events, true ) ) {
return true;
}
return false;
}
/**
* Get Webhook statuses.
*
* @since 2.3.0
* @return array
*/
function wc_get_webhook_statuses() {
return apply_filters( 'woocommerce_webhook_statuses', array(
'active' => __( 'Active', 'woocommerce' ),
'paused' => __( 'Paused', 'woocommerce' ),
'disabled' => __( 'Disabled', 'woocommerce' ),
) );
}
/**
* Load webhooks.
*
* @since 3.3.0
* @return bool
*/
function wc_load_webhooks() {
$data_store = WC_Data_Store::load( 'webhook' );
$webhooks = $data_store->get_webhooks_ids();
$loaded = false;
foreach ( $webhooks as $webhook_id ) {
$webhook = new WC_Webhook( $webhook_id );
$webhook->enqueue();
$loaded = true;
}
return $loaded;
}
/**
* Get webhook.
*
* @param int $id Webhook ID.
* @return WC_Webhook|null
*/
function wc_get_webhook( $id ) {
$webhook = new WC_Webhook( (int) $id );
return 0 !== $webhook->get_id() ? $webhook : null;
}