FM / API

/home/techb158/balacoffee.com/wp-content/plugins/woocommerce/src/Admin/API/

/home/techb158/balacoffee.com/wp-content/plugins/woocommerce/src/Admin/API

Name	Size	Mode	Actions
AI/	-	0755	rm
Reports/	-	0755	rm
Templates/	-	0755	rm
AnalyticsImports.php	9304	0644	edit dl rm
Coupons.php	2202	0644	edit dl rm
CustomAttributeTraits.php	3484	0644	edit dl rm
Customers.php	2163	0644	edit dl rm
Data.php	939	0644	edit dl rm
DataCountries.php	1149	0644	edit dl rm
DataDownloadIPs.php	4248	0644	edit dl rm
Experiments.php	1864	0644	edit dl rm
Features.php	1740	0644	edit dl rm
Init.php	10823	0644	edit dl rm
LaunchYourStore.php	5273	0644	edit dl rm
Leaderboards.php	18660	0644	edit dl rm
Marketing.php	4960	0644	edit dl rm
MarketingCampaigns.php	9868	0644	edit dl rm
MarketingCampaignTypes.php	6160	0644	edit dl rm
MarketingChannels.php	5878	0644	edit dl rm
MarketingOverview.php	3443	0644	edit dl rm
MarketingRecommendations.php	6085	0644	edit dl rm
MobileAppMagicLink.php	2147	0644	edit dl rm
NoteActions.php	2449	0644	edit dl rm
Notes.php	25925	0644	edit dl rm
Notice.php	2437	0644	edit dl rm
OnboardingFreeExtensions.php	2639	0644	edit dl rm
OnboardingPlugins.php	10920	0644	edit dl rm
OnboardingProducts.php	1983	0644	edit dl rm
OnboardingProductTypes.php	1840	0644	edit dl rm
OnboardingProfile.php	18817	0644	edit dl rm
OnboardingTasks.php	32790	0644	edit dl rm
OnboardingThemes.php	5620	0644	edit dl rm
Options.php	10236	0644	edit dl rm
Orders.php	10376	0644	edit dl rm
PaymentGatewaySuggestions.php	5998	0644	edit dl rm
Plugins.php	21729	0644	edit dl rm
ProductAttributes.php	4568	0644	edit dl rm
ProductAttributeTerms.php	4467	0644	edit dl rm
ProductCategories.php	458	0644	edit dl rm
ProductForm.php	3137	0644	edit dl rm
ProductReviews.php	1330	0644	edit dl rm
Products.php	9963	0644	edit dl rm
ProductsLowInStock.php	18046	0644	edit dl rm
ProductVariations.php	6178	0644	edit dl rm
SettingOptions.php	878	0644	edit dl rm
Settings.php	4299	0644	edit dl rm
ShippingPartnerSuggestions.php	6235	0644	edit dl rm
Taxes.php	5020	0644	edit dl rm
Themes.php	6263	0644	edit dl rm

Edit: /home/techb158/balacoffee.com/wp-content/plugins/woocommerce/src/Admin/API/MarketingCampaigns.php (9868B)

<?php
/**
 * REST API MarketingCampaigns Controller
 *
 * Handles requests to /marketing/campaigns.
 */

namespace Automattic\WooCommerce\Admin\API;

use Automattic\WooCommerce\Admin\Marketing\MarketingCampaign;
use Automattic\WooCommerce\Admin\Marketing\MarketingChannels as MarketingChannelsService;
use Automattic\WooCommerce\Admin\Marketing\Price;
use WC_REST_Controller;
use WP_Error;
use WP_REST_Request;
use WP_REST_Response;

defined( 'ABSPATH' ) || exit;

/**
 * MarketingCampaigns Controller.
 *
 * @internal
 * @extends WC_REST_Controller
 * @since x.x.x
 */
class MarketingCampaigns extends WC_REST_Controller {

/**
	 * Endpoint namespace.
	 *
	 * @var string
	 */
	protected $namespace = 'wc-admin';

/**
	 * Route base.
	 *
	 * @var string
	 */
	protected $rest_base = 'marketing/campaigns';

/**
	 * Register routes.
	 */
	public function register_routes() {
		register_rest_route(
			$this->namespace,
			'/' . $this->rest_base,
			array(
				array(
					'methods'             => \WP_REST_Server::READABLE,
					'callback'            => array( $this, 'get_items' ),
					'permission_callback' => array( $this, 'get_items_permissions_check' ),
					'args'                => $this->get_collection_params(),
				),
				'schema' => array( $this, 'get_public_item_schema' ),
			)
		);
	}

/**
	 * Check whether a given request has permission to view marketing campaigns.
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 *
	 * @return WP_Error|boolean
	 */
	public function get_items_permissions_check( $request ) {
		if ( ! wc_rest_check_manager_permissions( 'settings', 'read' ) ) {
			return new WP_Error( 'woocommerce_rest_cannot_view', __( 'Sorry, you cannot list resources.', 'woocommerce' ), array( 'status' => rest_authorization_required_code() ) );
		}

return true;
	}

/**
	 * Returns an aggregated array of marketing campaigns for all active marketing channels.
	 *
	 * @param WP_REST_Request $request Request data.
	 *
	 * @return WP_Error|WP_REST_Response
	 */
	public function get_items( $request ) {
		/**
		 * MarketingChannels class.
		 *
		 * @var MarketingChannelsService $marketing_channels_service
		 */
		$marketing_channels_service = wc_get_container()->get( MarketingChannelsService::class );

// Aggregate the campaigns from all registered marketing channels.
		$responses = array();
		foreach ( $marketing_channels_service->get_registered_channels() as $channel ) {
			foreach ( $channel->get_campaigns() as $campaign ) {
				$response    = $this->prepare_item_for_response( $campaign, $request );
				$responses[] = $this->prepare_response_for_collection( $response );
			}
		}

// Pagination.
		$page              = $request['page'];
		$items_per_page    = $request['per_page'];
		$offset            = ( $page - 1 ) * $items_per_page;
		$paginated_results = array_slice( $responses, $offset, $items_per_page );

$response = rest_ensure_response( $paginated_results );

$total_campaigns = count( $responses );
		$max_pages       = ceil( $total_campaigns / $items_per_page );
		$response->header( 'X-WP-Total', $total_campaigns );
		$response->header( 'X-WP-TotalPages', (int) $max_pages );

// Add previous and next page links to response header.
		$request_params = $request->get_query_params();
		$base           = add_query_arg( urlencode_deep( $request_params ), rest_url( sprintf( '%s/%s', $this->namespace, $this->rest_base ) ) );
		if ( $page > 1 ) {
			$prev_page = $page - 1;
			if ( $prev_page > $max_pages ) {
				$prev_page = $max_pages;
			}
			$prev_link = add_query_arg( 'page', $prev_page, $base );
			$response->link_header( 'prev', $prev_link );
		}
		if ( $max_pages > $page ) {
			$next_page = $page + 1;
			$next_link = add_query_arg( 'page', $next_page, $base );
			$response->link_header( 'next', $next_link );
		}

return $response;
	}

/**
	 * Get formatted price based on Price type.
	 *
	 * This uses plugins/woocommerce/i18n/currency-info.php and plugins/woocommerce/i18n/locale-info.php to get option object based on $price->currency.
	 *
	 * Example:
	 *
	 * - When $price->currency is 'USD' and $price->value is '1000', it should return '$1000.00'.
	 * - When $price->currency is 'JPY' and $price->value is '1000', it should return '¥1,000'.
	 * - When $price->currency is 'AED' and $price->value is '1000', it should return '5.000,00 د.إ'.
	 *
	 * @param Price $price Price object.
	 * @return String formatted price.
	 */
	private function get_formatted_price( $price ) {
		// Get $num_decimals to be passed to wc_price.
		$locale_info_all = include WC()->plugin_path() . '/i18n/locale-info.php';
		$locale_index    = array_search( $price->get_currency(), array_column( $locale_info_all, 'currency_code' ), true );
		$locale          = array_values( $locale_info_all )[ $locale_index ];
		$num_decimals    = $locale['num_decimals'];

// Get $currency_info based on user locale or default locale.
		$currency_locales = $locale['locales'];
		$user_locale      = get_user_locale();
		$currency_info    = $currency_locales[ $user_locale ] ?? $currency_locales['default'];

// Get $price_format to be passed to wc_price.
		$currency_pos     = $currency_info['currency_pos'];
		$currency_formats = array(
			'left'        => '%1$s%2$s',
			'right'       => '%2$s%1$s',
			'left_space'  => '%1$s&nbsp;%2$s',
			'right_space' => '%2$s&nbsp;%1$s',
		);
		$price_format     = $currency_formats[ $currency_pos ] ?? $currency_formats['left'];

$price_value     = wc_format_decimal( $price->get_value() );
		$price_formatted = wc_price(
			$price_value,
			array(
				'currency'           => $price->get_currency(),
				'decimal_separator'  => $currency_info['decimal_sep'],
				'thousand_separator' => $currency_info['thousand_sep'],
				'decimals'           => $num_decimals,
				'price_format'       => $price_format,
			)
		);

return html_entity_decode( wp_strip_all_tags( $price_formatted ) );
	}

/**
	 * Prepares the item for the REST response.
	 *
	 * @param MarketingCampaign $item    WordPress representation of the item.
	 * @param WP_REST_Request   $request Request object.
	 *
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function prepare_item_for_response( $item, $request ) {
		$data = array(
			'id'         => $item->get_id(),
			'channel'    => $item->get_type()->get_channel()->get_slug(),
			'title'      => $item->get_title(),
			'manage_url' => $item->get_manage_url(),
		);

if ( $item->get_cost() instanceof Price ) {
			$data['cost'] = array(
				'value'     => wc_format_decimal( $item->get_cost()->get_value() ),
				'currency'  => $item->get_cost()->get_currency(),
				'formatted' => $this->get_formatted_price( $item->get_cost() ),
			);
		}

if ( $item->get_sales() instanceof Price ) {
			$data['sales'] = array(
				'value'     => wc_format_decimal( $item->get_sales()->get_value() ),
				'currency'  => $item->get_sales()->get_currency(),
				'formatted' => $this->get_formatted_price( $item->get_sales() ),
			);
		}

$context = $request['context'] ?? 'view';
		$data    = $this->add_additional_fields_to_object( $data, $request );
		$data    = $this->filter_response_by_context( $data, $context );

return rest_ensure_response( $data );
	}

/**
	 * Retrieves the item's schema, conforming to JSON Schema.
	 *
	 * @return array Item schema data.
	 */
	public function get_item_schema() {
		$schema = array(
			'$schema'    => 'http://json-schema.org/draft-04/schema#',
			'title'      => 'marketing_campaign',
			'type'       => 'object',
			'properties' => array(
				'id'         => array(
					'description' => __( 'The unique identifier for the marketing campaign.', 'woocommerce' ),
					'type'        => 'string',
					'context'     => array( 'view' ),
					'readonly'    => true,
				),
				'channel'    => array(
					'description' => __( 'The unique identifier for the marketing channel that this campaign belongs to.', 'woocommerce' ),
					'type'        => 'string',
					'context'     => array( 'view' ),
					'readonly'    => true,
				),
				'title'      => array(
					'description' => __( 'Title of the marketing campaign.', 'woocommerce' ),
					'type'        => 'string',
					'context'     => array( 'view' ),
					'readonly'    => true,
				),
				'manage_url' => array(
					'description' => __( 'URL to the campaign management page.', 'woocommerce' ),
					'type'        => 'string',
					'context'     => array( 'view' ),
					'readonly'    => true,
				),
				'cost'       => array(
					'description' => __( 'Cost of the marketing campaign.', 'woocommerce' ),
					'context'     => array( 'view' ),
					'readonly'    => true,
					'type'        => 'object',
					'properties'  => array(
						'value'    => array(
							'type'     => 'string',
							'context'  => array( 'view' ),
							'readonly' => true,
						),
						'currency' => array(
							'type'     => 'string',
							'context'  => array( 'view' ),
							'readonly' => true,
						),
					),
				),
				'sales'      => array(
					'description' => __( 'Sales of the marketing campaign.', 'woocommerce' ),
					'context'     => array( 'view' ),
					'readonly'    => true,
					'type'        => 'object',
					'properties'  => array(
						'value'    => array(
							'type'     => 'string',
							'context'  => array( 'view' ),
							'readonly' => true,
						),
						'currency' => array(
							'type'     => 'string',
							'context'  => array( 'view' ),
							'readonly' => true,
						),
					),
				),
			),
		);

return $this->add_additional_fields_schema( $schema );
	}

/**
	 * Retrieves the query params for the collections.
	 *
	 * @return array Query parameters for the collection.
	 */
	public function get_collection_params() {
		$params = parent::get_collection_params();
		unset( $params['search'] );

return $params;
	}
}

cmd: