diff --git a/changelog.txt b/changelog.txt index 0c69dbf30..73fec1012 100644 --- a/changelog.txt +++ b/changelog.txt @@ -1,8 +1,5 @@ *** Facebook for WooCommerce Changelog *** -= 3.1.0 - 2023-10-11 = -* Add - Advantage+ Shoppings Ads support in the Advertise tab. - = 3.0.34 - 2023-10-05 = * Add - Filter the size of the Facebook product image. * Fix - AddToCart duplication when other plugins clone cart. diff --git a/class-wc-facebookcommerce.php b/class-wc-facebookcommerce.php index 4d9678171..637b161a3 100644 --- a/class-wc-facebookcommerce.php +++ b/class-wc-facebookcommerce.php @@ -647,7 +647,7 @@ public function get_commerce_handler() { /** * Gets a campaign handler for the given ASC campaign type * - * @since 3.1.0 + * @since x.x.x * * @param string $type The ASC campaign type * @return WooCommerce\Facebook\AdvertiseASC ASC campaign handler diff --git a/facebook-commerce.php b/facebook-commerce.php index 673d0005f..4d610b28c 100644 --- a/facebook-commerce.php +++ b/facebook-commerce.php @@ -2134,7 +2134,7 @@ private function sync_facebook_products_using_background_processor() { /** * Updates the DB with the new data for the Advertise ASC entry * - * @since 3.1.0 + * @since x.x.x * * @param string $data * @return bool @@ -2146,7 +2146,7 @@ public function update_advertise_asc_saved_data( $data ) { /** * Updates the DB with the new data for the Advertise ASC entry. The input can be an array, which then is transformed to an encoded json string * - * @since 3.1.0 + * @since x.x.x * * @param array $data */ @@ -2158,7 +2158,7 @@ public function update_advertise_asc_information( $data ){ /** * Updates the status for Advertise ASC campaign eligibility. * - * @since 3.1.0 + * @since x.x.x * * @param array $new_status */ @@ -2181,7 +2181,7 @@ public function ajax_fb_toggle_visibility() { /** * Gets the plain Advertise ASC data from the DB. * - * @since 3.1.0 + * @since x.x.x * * @return string */ @@ -2192,7 +2192,7 @@ public function get_advertise_asc_saved_data() { /** * Gets the saved status for Advertise ASC campaign eligibility. * - * @since 3.1.0 + * @since x.x.x * * @param array $data */ @@ -2203,7 +2203,7 @@ public function get_advertise_asc_status() { /** * Gets the json-decoded array of the Advertise ASC information stored in DB. * - * @since 3.1.0 + * @since x.x.x * * @return mixed */ diff --git a/facebook-for-woocommerce.php b/facebook-for-woocommerce.php index 0b6c7f539..60da98993 100644 --- a/facebook-for-woocommerce.php +++ b/facebook-for-woocommerce.php @@ -11,7 +11,7 @@ * Description: Grow your business on Facebook! Use this official plugin to help sell more of your products using Facebook. After completing the setup, you'll be ready to create ads that promote your products and you can also create a shop section on your Page where customers can browse your products on Facebook. * Author: Facebook * Author URI: https://www.facebook.com/ - * Version: 3.1.0 + * Version: 3.0.34 * Requires at least: 5.6 * Text Domain: facebook-for-woocommerce * Tested up to: 6.3 @@ -44,7 +44,7 @@ class WC_Facebook_Loader { /** * @var string the plugin version. This must be in the main plugin file to be automatically bumped by Woorelease. */ - const PLUGIN_VERSION = '3.1.0'; // WRCS: DEFINED_VERSION. + const PLUGIN_VERSION = '3.0.34'; // WRCS: DEFINED_VERSION. // Minimum PHP version required by this plugin. const MINIMUM_PHP_VERSION = '7.4.0'; diff --git a/includes/AJAX.php b/includes/AJAX.php index 97162b3c0..00779fcef 100644 --- a/includes/AJAX.php +++ b/includes/AJAX.php @@ -119,7 +119,7 @@ function( $name, $slug ) use ( $term ) { * Retrieves the changeset for each campaign type and posts them to the backend. * Makes sure that there is something to be sent. * - * @since 3.1.0 + * @since x.x.x * * @return string */ @@ -171,7 +171,7 @@ public function update_ad_status() { /** * Gets the Ad Preview for a given ad in different formats and merges the results. * - * @since 3.1.0 + * @since x.x.x * * @return string */ @@ -206,7 +206,7 @@ public function generate_ad_preview() { /** * Gets the Ad Preview for an ASC Campaign in different formats and merges the results. * - * @since 3.1.0 + * @since x.x.x * * @param string $asc_campaign ASC Campaign type. * @return string @@ -225,7 +225,7 @@ private function get_previews_and_merge ( $asc_campaign ){ /** * Gets the Ad Preview for an ASC Campaign in a specific format. * - * @since 3.1.0 + * @since x.x.x * * @param string $asc_campaign ASC Campaign type. * @param string $ad_format Ad Preview Format. diff --git a/includes/API/Ad/Create/Response.php b/includes/API/Ad/Create/Response.php index 2bcfdeebb..0f83db274 100644 --- a/includes/API/Ad/Create/Response.php +++ b/includes/API/Ad/Create/Response.php @@ -10,7 +10,7 @@ /** * Response object for Facebook Ad Creation request. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/Ad/Preview/Generation/Response.php b/includes/API/Ad/Preview/Generation/Response.php index a35a0decd..52aa04575 100644 --- a/includes/API/Ad/Preview/Generation/Response.php +++ b/includes/API/Ad/Preview/Generation/Response.php @@ -10,7 +10,7 @@ /** * Response object for Facebook Ad Preview request. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/Ad/Preview/Response.php b/includes/API/Ad/Preview/Response.php index b1460a118..e24c5d627 100644 --- a/includes/API/Ad/Preview/Response.php +++ b/includes/API/Ad/Preview/Response.php @@ -10,7 +10,7 @@ /** * Response object for Facebook Ad Preview request. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/Ad/Response.php b/includes/API/Ad/Response.php index ffa37eca1..e9f2794ef 100644 --- a/includes/API/Ad/Response.php +++ b/includes/API/Ad/Response.php @@ -10,7 +10,7 @@ /** * Generic response object for flows corresponding to Facebook Ad requests. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/AdAccount/Currency/Response.php b/includes/API/AdAccount/Currency/Response.php index 3b70d7204..788115952 100644 --- a/includes/API/AdAccount/Currency/Response.php +++ b/includes/API/AdAccount/Currency/Response.php @@ -10,7 +10,7 @@ /** * Response object for Facebook Ad Account Currency request. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/Adset/Create/Response.php b/includes/API/Adset/Create/Response.php index 89ae18924..e6d11fc79 100644 --- a/includes/API/Adset/Create/Response.php +++ b/includes/API/Adset/Create/Response.php @@ -11,7 +11,7 @@ /** * Response object for Facebook Adset Creation request. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/Adset/Response.php b/includes/API/Adset/Response.php index 4a8345cf0..0b8ffdb1a 100644 --- a/includes/API/Adset/Response.php +++ b/includes/API/Adset/Response.php @@ -10,7 +10,7 @@ /** * Generic response object for Facebook Adset request flows. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/Adset/Update/Response.php b/includes/API/Adset/Update/Response.php index 24ccbf69d..55850e7f8 100644 --- a/includes/API/Adset/Update/Response.php +++ b/includes/API/Adset/Update/Response.php @@ -10,7 +10,7 @@ /** * Response object for Facebook Adset Update request. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/Campaign/Response.php b/includes/API/Campaign/Response.php index cbf6f17ab..699224323 100644 --- a/includes/API/Campaign/Response.php +++ b/includes/API/Campaign/Response.php @@ -10,7 +10,7 @@ /** * Response object for Facebook Ad Campaign Creation/Update request. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/API/Insights/Response.php b/includes/API/Insights/Response.php index 02f72e16e..34552ce22 100644 --- a/includes/API/Insights/Response.php +++ b/includes/API/Insights/Response.php @@ -10,7 +10,7 @@ /** * Response object for Facebook Ad Campaign Insights request. * - * @since 3.1.0 + * @since x.x.x */ class Response extends ApiResponse { diff --git a/includes/Admin/Settings_Screens/Advertise.php b/includes/Admin/Settings_Screens/Advertise.php index 2a34204d4..b1360286c 100644 --- a/includes/Admin/Settings_Screens/Advertise.php +++ b/includes/Admin/Settings_Screens/Advertise.php @@ -76,7 +76,7 @@ private function add_hooks() { /** * Adds the WP hooks to be able to run the frontend * - * @since 3.1.0 + * @since x.x.x * */ public function add_frontend_hooks(){ @@ -267,7 +267,7 @@ public function render() { /** * Renders the ASC Experimental view. * - * @since 3.1.0 + * @since x.x.x * */ private function experimental_view_render() { @@ -287,7 +287,7 @@ private function experimental_view_render() { /** * Generates the HTML DOM for a given dashboard. * - * @since 3.1.0 + * @since x.x.x * @param string @type. Sets the input type. values: (new-buyers, retargeting) * @param string @title. The title of the dashboard * @param string @subtitle_row1. Row1 of the subtitle of the dashboard @@ -358,7 +358,7 @@ private function render_dashboard( $type, $title, $subtitle_row1, $subtitle_row2 /** * Checks whether the tool can show the experimental view or not * - * @since 3.1.0 + * @since x.x.x * * @return bool */ @@ -371,7 +371,7 @@ private function can_try_experimental_view() { /** * Creates the translated text including a link * - * @since 3.1.0 + * @since x.x.x * @param string $pretext. Any text before the link text. * @param string $link. The link url * @param string $link_text. The text for the link @@ -387,7 +387,7 @@ private function translate_with_link( $pretext, $link, $link_text, $rest_of_text /** * Tries to render the experimental view. If something fails, it shows the issue. * - * @since 3.1.0 + * @since x.x.x * * @return string */ @@ -518,7 +518,7 @@ private function try_render_experimental_view() { /** * Closes the open html tags in case of an exception. * - * @since 3.1.0 + * @since x.x.x * */ private function remove_rendered_when_exception_happened() { @@ -536,7 +536,7 @@ private function remove_rendered_when_exception_happened() { /** * Returns an escaped translation of the input text, in the realm of this plugin * - * @since 3.1.0 + * @since x.x.x * * @param string $text * @returns string @@ -549,7 +549,7 @@ private function get_escaped_translation( $text ) { /** * Creates the html elements needed for the LWI-E view. * - * @since 3.1.0 + * @since x.x.x * */ private function render_lwi_view() { diff --git a/includes/AdvertiseASC/AscSelector.php b/includes/AdvertiseASC/AscSelector.php index d599c6dda..34188bbd6 100644 --- a/includes/AdvertiseASC/AscSelector.php +++ b/includes/AdvertiseASC/AscSelector.php @@ -21,7 +21,7 @@ * - Retargeting * campaigns. * - * @since 3.1.0 + * @since x.x.x */ class AscSelector { diff --git a/includes/AdvertiseASC/CampaignHandler.php b/includes/AdvertiseASC/CampaignHandler.php index cec8b17cb..b0b424c39 100644 --- a/includes/AdvertiseASC/CampaignHandler.php +++ b/includes/AdvertiseASC/CampaignHandler.php @@ -96,7 +96,7 @@ abstract protected function get_adcreative_creation_params( $name, $page_id, $li /** * Gets the daily budget if the ad is created. Otherwise it returns the 1.2*min daily budget. * - * @since 3.1.0 + * @since x.x.x * * @return string */ @@ -115,7 +115,7 @@ public function get_ad_daily_budget() { /** * Gets the first instagram acount id from the Marketing Api. * - * @since 3.1.0 + * @since x.x.x * @param string @page_id Facebook Page Id. * @return string * @throws PluginException @@ -157,7 +157,7 @@ public function get_instagram_actor_id($page_id) { /** * Updates the status of the ad. If the value of state is 'true', then it sets the ad status to 'Active' otherwise paused. * - * @since 3.1.0 + * @since x.x.x * @param string @state. values: 'true' or 'false' * @return string */ @@ -179,7 +179,7 @@ public function are_insights_available() { /** * Generates an ad preview with a message in a specified format. * - * @since 3.1.0 + * @since x.x.x * @param string @message The message to be shown on the ad. * @param string @ad_format The output format of the generated ad. * @return string @@ -253,7 +253,7 @@ public function get_ad_preview($ad_format) { /** * Returns the Ad Campaign based on the argument * - * @since 3.1.0 + * @since x.x.x * @param string @campaign_id Facebook Ad Campaign Id. * @return mixed * @throws ApiException @@ -266,7 +266,7 @@ public function fetch_campaign($campaign_id) { /** * Returns the Adset based on the argument * - * @since 3.1.0 + * @since x.x.x * @param string @adset_id Facebook Adset Id. * @return mixed * @throws ApiException @@ -279,7 +279,7 @@ public function fetch_adset($adset_id) { /** * Returns the Ad based on the argument * - * @since 3.1.0 + * @since x.x.x * @param string @ad_id Facebook Ad Id. * @return mixed * @throws ApiException @@ -292,7 +292,7 @@ public function fetch_ad($ad_id) { /** * Returns the Adcreative based on the argument * - * @since 3.1.0 + * @since x.x.x * @param string @adcreative_id Facebook Adcreative Id. * @return mixed * @throws ApiException @@ -831,7 +831,7 @@ private function get_stored_data() { /** * Gets the accounts that are associated with 'me' entity. * - * @since 3.1.0 + * @since x.x.x * * @return array * @throws ApiException @@ -845,7 +845,7 @@ private function get_current_user_associated_accounts() { /** * Gets the instagram accounts that are associated with the Page with the given Id. For this, we first need to set the appropriate access token. * - * @since 3.1.0 + * @since x.x.x * * @return array * @throws ApiException @@ -866,7 +866,7 @@ private function get_instagram_accounts($page_id, $page_access_token) { /** * Gets the page backed instagram accounts that are associated with the Page with the given Id. For this, we first need to set the appropriate access token. * - * @since 3.1.0 + * @since x.x.x * * @return array * @throws ApiException diff --git a/includes/AdvertiseASC/NewBuyers.php b/includes/AdvertiseASC/NewBuyers.php index f221a95eb..f07873045 100644 --- a/includes/AdvertiseASC/NewBuyers.php +++ b/includes/AdvertiseASC/NewBuyers.php @@ -20,7 +20,7 @@ /** * This class creates a wrapper for interacting with ASC NewBuyers campaign type. * - * @since 3.1.0 + * @since x.x.x */ class NewBuyers extends CampaignHandler { @@ -37,7 +37,7 @@ public function __construct() { /** * Gets the minimum allowed daily budget for this campaign type. * - * @since 3.1.0 + * @since x.x.x * @return int */ public function get_allowed_min_daily_budget() { @@ -48,7 +48,7 @@ public function get_allowed_min_daily_budget() { /** * Gets the campaign type. * - * @since 3.1.0 + * @since x.x.x * @return string */ public function get_campaign_type(): string { @@ -58,7 +58,7 @@ public function get_campaign_type(): string { /** * Gets the list of selected countries. If there is no active ad, it will return a list containing 'US' * - * @since 3.1.0 + * @since x.x.x * @return array */ public function get_selected_countries() { @@ -68,7 +68,7 @@ public function get_selected_countries() { /** * Creates a Facebook Ad Campaign. * - * @since 3.1.0 + * @since x.x.x * @param mixed $props is an object with values for: state, daily budget, country list, and ad message. * @throws AscNotSupportedException In case ASC campaign creation is not supported. * @throws NonDiscriminationNotAcceptedException In case Non-Discrimination agreement is not accepted in AdsManager. @@ -131,7 +131,7 @@ public function create_asc_campaign( $props ) { /** * Updates the running Ad Campaign. * - * @since 3.1.0 + * @since x.x.x * @param mixed $data is an object with values for: state, daily budget, country list, and ad message. * @return bool */ diff --git a/includes/AdvertiseASC/Retargeting.php b/includes/AdvertiseASC/Retargeting.php index 53306d79b..e7ea4bfab 100644 --- a/includes/AdvertiseASC/Retargeting.php +++ b/includes/AdvertiseASC/Retargeting.php @@ -18,7 +18,7 @@ /** * This class creates a wrapper for interacting with ASC Retargeting campaign type. * - * @since 3.1.0 + * @since x.x.x */ class Retargeting extends CampaignHandler { @@ -37,7 +37,7 @@ public function __construct() { /** * Updates the running Ad Campaign. * - * @since 3.1.0 + * @since x.x.x * @param mixed $data is an object with values for: state, daily budget, and ad message. * @return bool */ @@ -58,7 +58,7 @@ public function update_asc_campaign( $data ) { /** * Creates a Facebook Ad Campaign. * - * @since 3.1.0 + * @since x.x.x * @param mixed $props is an object with values for: state, daily budget, and ad message. */ public function create_asc_campaign( $props ) { @@ -82,7 +82,7 @@ public function create_asc_campaign( $props ) { /** * Gets the minimum allowed daily budget for this campaign type. * - * @since 3.1.0 + * @since x.x.x * @return int */ public function get_allowed_min_daily_budget() { @@ -92,7 +92,7 @@ public function get_allowed_min_daily_budget() { /** * Gets the list of selected countries. For this campaign type it only returns an empty array. * - * @since 3.1.0 + * @since x.x.x * @return array */ public function get_selected_countries() { @@ -102,7 +102,7 @@ public function get_selected_countries() { /** * Gets the campaign type. * - * @since 3.1.0 + * @since x.x.x * @return string */ public function get_campaign_type(): string { diff --git a/package-lock.json b/package-lock.json index d696b0dde..2d8a63601 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ { "name": "facebook-for-woocommerce", - "version": "3.1.0", + "version": "3.0.34", "lockfileVersion": 2, "requires": true, "packages": { diff --git a/package.json b/package.json index 2ff7a5872..326942315 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "facebook-for-woocommerce", - "version": "3.1.0", + "version": "3.0.34", "author": "Facebook", "homepage": "https://woocommerce.com/products/facebook/", "license": "GPL-2.0", diff --git a/readme.txt b/readme.txt index a1d1372da..2b7f04e5f 100644 --- a/readme.txt +++ b/readme.txt @@ -3,7 +3,7 @@ Contributors: facebook, automattic, woothemes Tags: facebook, shop, catalog, advertise, pixel, product Requires at least: 4.4 Tested up to: 6.3 -Stable tag: 3.1.0 +Stable tag: 3.0.34 Requires PHP: 5.6 or greater MySQL: 5.6 or greater License: GPLv2 or later @@ -39,9 +39,6 @@ When opening a bug on GitHub, please give us as many details as possible. == Changelog == -= 3.1.0 - 2023-10-11 = -* Add - Advantage+ Shoppings Ads support in the Advertise tab. - = 3.0.34 - 2023-10-05 = * Add - Filter the size of the Facebook product image. * Fix - AddToCart duplication when other plugins clone cart.