From 1c58f0e79f2129b9e84f06958b4694db292f3d06 Mon Sep 17 00:00:00 2001 From: dixitadusara Date: Tue, 27 Jun 2017 14:32:45 +0530 Subject: [PATCH 001/361] Title and Alt tag added in the PhotoSwipe enlarged product image --- templates/single-product/product-image.php | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/templates/single-product/product-image.php b/templates/single-product/product-image.php index 1fe188f78ac..7aac4ef6f07 100644 --- a/templates/single-product/product-image.php +++ b/templates/single-product/product-image.php @@ -25,7 +25,7 @@ $columns = apply_filters( 'woocommerce_product_thumbnails_columns', 4 $thumbnail_size = apply_filters( 'woocommerce_product_thumbnails_large_size', 'full' ); $post_thumbnail_id = get_post_thumbnail_id( $post->ID ); $full_size_image = wp_get_attachment_image_src( $post_thumbnail_id, $thumbnail_size ); -$image_title = get_post_field( 'post_excerpt', $post_thumbnail_id ); +$image_title = get_post_field( 'post_title', $post_thumbnail_id ); $placeholder = has_post_thumbnail() ? 'with-images' : 'without-images'; $wrapper_classes = apply_filters( 'woocommerce_single_product_image_gallery_classes', array( 'woocommerce-product-gallery', @@ -39,6 +39,7 @@ $wrapper_classes = apply_filters( 'woocommerce_single_product_image_gallery_cl $image_title, + 'alt' => $image_title, 'data-src' => $full_size_image[0], 'data-large_image' => $full_size_image[0], 'data-large_image_width' => $full_size_image[1], From 8df6fda8f145204266234d1bac07e3963b1584ef Mon Sep 17 00:00:00 2001 From: dixitadusara Date: Thu, 13 Jul 2017 12:09:33 +0530 Subject: [PATCH 002/361] Fix minor content changes in CONTRIBUTING.md --- .github/CONTRIBUTING.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 97fcc742bbd..edc7a22d5cd 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -15,7 +15,7 @@ GitHub is for _bug reports and contributions only_ - if you have a support quest ### Reporting Issues -Reporting issues is a great way to became a contributor as it doesn't require technical skills. In fact you don't even need to know a programming language or to be able to check the code itself, you just need to make sure that everything works as expected and [submit an issue report](https://github.com/woocommerce/woocommerce/issues/new) if you spot a bug. Sound like something you're up for? Go for it! +Reporting issues is a great way to become a contributor as it doesn't require technical skills. In fact, you don't even need to know a programming language or to be able to check the code itself, you just need to make sure that everything works as expected and [submit an issue report](https://github.com/woocommerce/woocommerce/issues/new) if you spot a bug. Sound like something you're up for? Go for it! #### How To Submit An Issue Report @@ -44,7 +44,7 @@ If you think something could be improved and you're able to do so, make your cha * Please **don't** modify the changelog - this will be maintained by the WooCommerce developers. * Please **don't** add your localizations or update the .pot files - these will also be maintained by the WooCommerce developers. To contribute to the localization of WooCommerce, please join the [translate.wordpress.org project](https://translate.wordpress.org/projects/wp-plugins/woocommerce). This is much needed, if you speak a language that needs translating consider yourself officially invited to the party. -After you follow the step above, the next stage will be waiting on us to merge your Pull Request. We review them all, and make suggestions and changes as and if necessary. +After you follow the step above, the next stage will be waiting for us to merge your Pull Request. We review them all, and make suggestions and changes as and if necessary. ## Contribute To Localizing WooCommerce From 413ae3941109c6427079adb87a043facceefd73a Mon Sep 17 00:00:00 2001 From: dixitadusara Date: Fri, 14 Jul 2017 14:31:58 +0530 Subject: [PATCH 003/361] Revert "Merge pull request #16113 from woocommerce/fix/cod-shipping-logic" This reverts commit 8aa27015141ad50ec0006a2b831a011f3beb130f, reversing changes made to 940019f2456a92b70057aba110e55b51a1206a1d. --- .../gateways/cod/class-wc-gateway-cod.php | 45 ++++++++++++++++--- includes/wc-formatting-functions.php | 14 ------ 2 files changed, 38 insertions(+), 21 deletions(-) diff --git a/includes/gateways/cod/class-wc-gateway-cod.php b/includes/gateways/cod/class-wc-gateway-cod.php index d03893e01c8..d1746222916 100644 --- a/includes/gateways/cod/class-wc-gateway-cod.php +++ b/includes/gateways/cod/class-wc-gateway-cod.php @@ -150,17 +150,48 @@ class WC_Gateway_COD extends WC_Payment_Gateway { return false; } - // Only apply if all packages are being shipped via chosen method, or order is virtual. + // Check methods if ( ! empty( $this->enable_for_methods ) && $needs_shipping ) { - $chosen_shipping_methods = array(); - if ( is_object( $order ) ) { - $chosen_shipping_methods = array_unique( array_map( 'wc_get_string_before_colon', $order->get_shipping_methods() ) ); - } elseif ( $chosen_shipping_methods_session = WC()->session->get( 'chosen_shipping_methods' ) ) { - $chosen_shipping_methods = array_unique( array_map( 'wc_get_string_before_colon', $chosen_shipping_methods_session ) ); + // Only apply if all packages are being shipped via chosen methods, or order is virtual + $chosen_shipping_methods_session = WC()->session->get( 'chosen_shipping_methods' ); + + if ( isset( $chosen_shipping_methods_session ) ) { + $chosen_shipping_methods = array_unique( $chosen_shipping_methods_session ); + } else { + $chosen_shipping_methods = array(); } - if ( 0 < count( array_diff( $chosen_shipping_methods, $this->enable_for_methods ) ) ) { + $check_method = false; + + if ( is_object( $order ) ) { + if ( $order->get_shipping_method() ) { + $check_method = $order->get_shipping_method(); + } + } elseif ( empty( $chosen_shipping_methods ) || sizeof( $chosen_shipping_methods ) > 1 ) { + $check_method = false; + } elseif ( sizeof( $chosen_shipping_methods ) == 1 ) { + $check_method = $chosen_shipping_methods[0]; + } + + if ( ! $check_method ) { + return false; + } + + if ( strstr( $check_method, ':' ) ) { + $check_method = current( explode( ':', $check_method ) ); + } + + $found = false; + + foreach ( $this->enable_for_methods as $method_id ) { + if ( $check_method === $method_id ) { + $found = true; + break; + } + } + + if ( ! $found ) { return false; } } diff --git a/includes/wc-formatting-functions.php b/includes/wc-formatting-functions.php index c4e7bbc98e4..023eb96c2fa 100644 --- a/includes/wc-formatting-functions.php +++ b/includes/wc-formatting-functions.php @@ -1139,17 +1139,3 @@ function wc_do_oembeds( $content ) { return $content; } - -/** - * Get part of a string before :. - * - * Used for example in shipping methods ids where they take the format - * method_id:instance_id - * - * @since 3.2.0 - * @param string $string - * @return string - */ -function wc_get_string_before_colon( $string ) { - return trim( current( explode( ':', (string) $string ) ) ); -} From 62e34182677479fb9ab6a0b15fb62b82ebd97e6f Mon Sep 17 00:00:00 2001 From: Birgir E Date: Sun, 16 Sep 2018 12:09:50 +0000 Subject: [PATCH 004/361] init --- tests/unit-tests/product/functions.php | 28 +++++++++++++------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/tests/unit-tests/product/functions.php b/tests/unit-tests/product/functions.php index 2ed98fed51e..4ec1ccd06fc 100644 --- a/tests/unit-tests/product/functions.php +++ b/tests/unit-tests/product/functions.php @@ -49,7 +49,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { $draft->set_status( 'draft' ); $draft->save(); - $this->assertEquals( 9, count( wc_get_products( array( 'return' => 'ids' ) ) ) ); + $this->assertCount( 9, wc_get_products( array( 'return' => 'ids' ) ) ); // Test status. $products = wc_get_products( @@ -67,7 +67,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'type' => 'variation', ) ); - $this->assertEquals( 2, count( $products ) ); + $this->assertCount( 2, $products ); // Test parent. $products = wc_get_products( @@ -77,7 +77,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'parent' => $variation->get_id(), ) ); - $this->assertEquals( 2, count( $products ) ); + $this->assertCount( 2, $products ); // Test parent_exclude. $products = wc_get_products( @@ -87,7 +87,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'parent_exclude' => array( $variation->get_id() ), ) ); - $this->assertEquals( 0, count( $products ) ); + $this->assertCount( 0, $products ); // Test skus. $products = wc_get_products( @@ -96,7 +96,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'sku' => 'GET TEST SKU', ) ); - $this->assertEquals( 2, count( $products ) ); + $this->assertCount( 2, $products ); $this->assertContains( $product->get_id(), $products ); $this->assertContains( $external->get_id(), $products ); @@ -107,7 +107,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'category' => array( $term_cat_1->slug ), ) ); - $this->assertEquals( 3, count( $products ) ); + $this->assertCount( 3, $products ); // Test tags. $products = wc_get_products( @@ -116,7 +116,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'tag' => array( $term_tag_1->slug ), ) ); - $this->assertEquals( 2, count( $products ) ); + $this->assertCount( 2, $products ); $products = wc_get_products( array( @@ -124,7 +124,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'tag' => array( $term_tag_2->slug ), ) ); - $this->assertEquals( 1, count( $products ) ); + $this->assertCount( 1, $products ); $products = wc_get_products( array( @@ -132,7 +132,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'tag' => array( $term_tag_1->slug, $term_tag_2->slug ), ) ); - $this->assertEquals( 3, count( $products ) ); + $this->assertCount( 3, $products ); // Test limit. $products = wc_get_products( @@ -141,7 +141,7 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'limit' => 5, ) ); - $this->assertEquals( 5, count( $products ) ); + $this->assertCount( 5, $products ); // Test offset. $products = wc_get_products( @@ -157,8 +157,8 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'offset' => 2, ) ); - $this->assertEquals( 2, count( $products ) ); - $this->assertEquals( 2, count( $products_offset ) ); + $this->assertCount( 2, $products ); + $this->assertCount( 2, $products_offset ); $this->assertNotEquals( $products, $products_offset ); // Test page. @@ -175,8 +175,8 @@ class WC_Tests_Product_Functions extends WC_Unit_Test_Case { 'page' => 2, ) ); - $this->assertEquals( 2, count( $products_page_1 ) ); - $this->assertEquals( 2, count( $products_page_2 ) ); + $this->assertCount( 2, $products_page_1 ); + $this->assertCount( 2, $products_page_2 ); $this->assertNotEquals( $products_page_1, $products_page_2 ); // Test exclude. From e283eff149e89cf878f98795856b248998d339e3 Mon Sep 17 00:00:00 2001 From: XLPlugins Date: Thu, 20 Sep 2018 19:07:23 +0530 Subject: [PATCH 005/361] Added new filter to modify order status during orders using cheque as a gateway. --- includes/gateways/cheque/class-wc-gateway-cheque.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/gateways/cheque/class-wc-gateway-cheque.php b/includes/gateways/cheque/class-wc-gateway-cheque.php index b31752d6149..40f2599438f 100644 --- a/includes/gateways/cheque/class-wc-gateway-cheque.php +++ b/includes/gateways/cheque/class-wc-gateway-cheque.php @@ -119,7 +119,7 @@ class WC_Gateway_Cheque extends WC_Payment_Gateway { if ( $order->get_total() > 0 ) { // Mark as on-hold (we're awaiting the cheque). - $order->update_status( 'on-hold', _x( 'Awaiting check payment', 'Check payment method', 'woocommerce' ) ); + $order->update_status( apply_filters( 'woocommerce_cheque_process_payment_order_status', 'on-hold', $order ), _x( 'Awaiting check payment', 'Check payment method', 'woocommerce' ) ); } else { $order->payment_complete(); } From 2b57f955525a4eda8c8ded6d68409d426e838d19 Mon Sep 17 00:00:00 2001 From: Daniel Bitzer Date: Wed, 26 Sep 2018 12:43:27 +0930 Subject: [PATCH 006/361] Add coupon object param to get coupon data filter This makes it easier to manage virtual coupon objects created through the woocommerce_get_shop_coupon_data filter --- includes/class-wc-coupon.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/class-wc-coupon.php b/includes/class-wc-coupon.php index e4d6161457f..c3d28ccaa4e 100644 --- a/includes/class-wc-coupon.php +++ b/includes/class-wc-coupon.php @@ -91,7 +91,7 @@ class WC_Coupon extends WC_Legacy_Coupon { } // This filter allows custom coupon objects to be created on the fly. - $coupon = apply_filters( 'woocommerce_get_shop_coupon_data', false, $data ); + $coupon = apply_filters( 'woocommerce_get_shop_coupon_data', false, $data, $this ); if ( $coupon ) { $this->read_manual_coupon( $data, $coupon ); From e20ce00101f6690dcc533e1cb49fb393a2292cc9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Demarle?= Date: Fri, 28 Sep 2018 13:42:51 +0200 Subject: [PATCH 007/361] Fix ajax responses not testable when calling wp_send_json_success in a try block --- includes/class-wc-ajax.php | 96 ++++++++++++++++---------------------- 1 file changed, 41 insertions(+), 55 deletions(-) diff --git a/includes/class-wc-ajax.php b/includes/class-wc-ajax.php index bd6907d02c5..1ee0169ea04 100644 --- a/includes/class-wc-ajax.php +++ b/includes/class-wc-ajax.php @@ -647,12 +647,12 @@ class WC_AJAX { } $response['html'] = ob_get_clean(); - - wp_send_json_success( $response ); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - wp_die(); + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -897,14 +897,13 @@ class WC_AJAX { ob_start(); include 'admin/meta-boxes/views/html-order-items.php'; - wp_send_json_success( - array( - 'html' => ob_get_clean(), - ) - ); + $response['html'] = ob_get_clean(); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -953,15 +952,13 @@ class WC_AJAX { ob_start(); include 'admin/meta-boxes/views/html-order-items.php'; - - wp_send_json_success( - array( - 'html' => ob_get_clean(), - ) - ); + $response['html'] = ob_get_clean(); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -988,15 +985,13 @@ class WC_AJAX { ob_start(); include 'admin/meta-boxes/views/html-order-shipping.php'; - - wp_send_json_success( - array( - 'html' => ob_get_clean(), - ) - ); + $response['html'] = ob_get_clean(); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -1023,15 +1018,13 @@ class WC_AJAX { ob_start(); include 'admin/meta-boxes/views/html-order-items.php'; - - wp_send_json_success( - array( - 'html' => ob_get_clean(), - ) - ); + $response['html'] = ob_get_clean(); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -1055,15 +1048,13 @@ class WC_AJAX { ob_start(); include 'admin/meta-boxes/views/html-order-items.php'; - - wp_send_json_success( - array( - 'html' => ob_get_clean(), - ) - ); + $response['html'] = ob_get_clean(); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -1084,15 +1075,13 @@ class WC_AJAX { ob_start(); include 'admin/meta-boxes/views/html-order-items.php'; - - wp_send_json_success( - array( - 'html' => ob_get_clean(), - ) - ); + $response['html'] = ob_get_clean(); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -1140,15 +1129,13 @@ class WC_AJAX { ob_start(); include 'admin/meta-boxes/views/html-order-items.php'; - - wp_send_json_success( - array( - 'html' => ob_get_clean(), - ) - ); + $response['html'] = ob_get_clean(); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -1172,15 +1159,13 @@ class WC_AJAX { ob_start(); include 'admin/meta-boxes/views/html-order-items.php'; - - wp_send_json_success( - array( - 'html' => ob_get_clean(), - ) - ); + $response['html'] = ob_get_clean(); } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response ); } /** @@ -1688,12 +1673,12 @@ class WC_AJAX { if ( did_action( 'woocommerce_order_fully_refunded' ) ) { $response_data['status'] = 'fully_refunded'; } - - wp_send_json_success( $response_data ); - } catch ( Exception $e ) { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $response_data ); } /** @@ -1813,11 +1798,12 @@ class WC_AJAX { $data['message'] = __( 'API Key generated successfully. Make sure to copy your new keys now as the secret key will be hidden once you leave this page.', 'woocommerce' ); $data['revoke_url'] = '' . __( 'Revoke key', 'woocommerce' ) . ''; } - - wp_send_json_success( $data ); } catch ( Exception $e ) { wp_send_json_error( array( 'message' => $e->getMessage() ) ); } + + // wp_send_json_success must be outside the try block not to break phpunit tests + wp_send_json_success( $data ); } /** From 338f6b8d62bafa7ee915768ae466dadf3a5d6b8d Mon Sep 17 00:00:00 2001 From: claudiulodro Date: Wed, 3 Oct 2018 10:07:11 -0400 Subject: [PATCH 008/361] readme for 3.5 rc --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index a47b9feaa36..3f946071840 100644 --- a/readme.txt +++ b/readme.txt @@ -195,6 +195,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Allow saving a stock quantity of 0 using quick edit. #21447 * Fix - Change the query used to save session data to the database to protect against deadlocks. #21455 * Fix - Make sure default category tooltip is rendered when the image column is deactivated. #21410 +* Fix - Fix warning when using logger instance in woocommerce_logging_class filter. #21448 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From a2df135d38eb842e06fcb44e348bd3d9bbe6e953 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Wed, 3 Oct 2018 10:13:19 -0400 Subject: [PATCH 009/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index 3f946071840..b2ad6f5ddc9 100644 --- a/readme.txt +++ b/readme.txt @@ -196,6 +196,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Change the query used to save session data to the database to protect against deadlocks. #21455 * Fix - Make sure default category tooltip is rendered when the image column is deactivated. #21410 * Fix - Fix warning when using logger instance in woocommerce_logging_class filter. #21448 +* Fix - Use uppercase "ID" when sorting product queries by ID. #21461 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From bc760f44a3374f27cd9d692e07e8bc439a918573 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Wed, 3 Oct 2018 13:42:58 -0400 Subject: [PATCH 010/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index b2ad6f5ddc9..ffbbdeca48e 100644 --- a/readme.txt +++ b/readme.txt @@ -197,6 +197,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Make sure default category tooltip is rendered when the image column is deactivated. #21410 * Fix - Fix warning when using logger instance in woocommerce_logging_class filter. #21448 * Fix - Use uppercase "ID" when sorting product queries by ID. #21461 +* Fix - Consistently escape the gateway ID in the checkout payment method template. #21439 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 392ee564107969acc293a8bf32a4c629f8e51c0b Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Wed, 3 Oct 2018 16:57:01 -0400 Subject: [PATCH 011/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index ffbbdeca48e..a762d2839fa 100644 --- a/readme.txt +++ b/readme.txt @@ -198,6 +198,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Fix warning when using logger instance in woocommerce_logging_class filter. #21448 * Fix - Use uppercase "ID" when sorting product queries by ID. #21461 * Fix - Consistently escape the gateway ID in the checkout payment method template. #21439 +* Fix - Avoid treating HTTP 301 and 302 codes as failures for webhooks. #21491 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 1b248b099eebc7eba1226a245606377e56627bce Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Wed, 3 Oct 2018 16:59:00 -0400 Subject: [PATCH 012/361] Update readme.txt --- readme.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/readme.txt b/readme.txt index a762d2839fa..890315200ee 100644 --- a/readme.txt +++ b/readme.txt @@ -199,6 +199,8 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Use uppercase "ID" when sorting product queries by ID. #21461 * Fix - Consistently escape the gateway ID in the checkout payment method template. #21439 * Fix - Avoid treating HTTP 301 and 302 codes as failures for webhooks. #21491 +* Fix - Add address_1 to shipping packages info in WC_Cart:: get_shipping_packages to make it work correctly in address formatting functions. #21493 +* Fix - Don't fire two of the same action when saving shipping settings. #21494 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 850ff9ea25b17b95d1f6752c7241e4f7f156b85f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?b=C3=A9la?= Date: Thu, 4 Oct 2018 11:21:56 +0200 Subject: [PATCH 013/361] email styles beautification --- templates/emails/email-styles.php | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/templates/emails/email-styles.php b/templates/emails/email-styles.php index 152ec467282..e5ef89bc388 100644 --- a/templates/emails/email-styles.php +++ b/templates/emails/email-styles.php @@ -43,13 +43,13 @@ $text_lighter_20 = wc_hex_lighter( $text, 20 ); #wrapper { background-color: ; margin: 0; - padding: 70px 0 70px 0; + padding: 70px 0; -webkit-text-size-adjust: none !important; width: 100%; } #template_container { - box-shadow: 0 1px 4px rgba(0,0,0,0.1) !important; + box-shadow: 0 1px 4px rgba(0, 0, 0, 0.1) !important; background-color: ; border: 1px solid ; border-radius: 3px !important; @@ -73,16 +73,16 @@ $text_lighter_20 = wc_hex_lighter( $text, 20 ); #template_footer td { padding: 0; - -webkit-border-radius: 6px; + border-radius: 6px; } #template_footer #credit { - border:0; + border: 0; color: ; - font-family: Arial; - font-size:12px; - line-height:125%; - text-align:center; + font-family: "Helvetica Neue", Helvetica, Roboto, Arial, sans-serif; + font-size: 12px; + line-height: 125%; + text-align: center; padding: 0 48px 48px 48px; } @@ -137,7 +137,7 @@ $text_lighter_20 = wc_hex_lighter( $text, 20 ); } .address { - padding:12px 12px 0; + padding: 12px 12px 0; color: ; border: 1px solid ; } From 81e2c50b39fce6f436f9b9d0890bb0f0e674ebc2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bo=CC=81ta=20Da=CC=81vid?= Date: Thu, 4 Oct 2018 11:57:05 +0200 Subject: [PATCH 014/361] images, svgs optim --- .../images/ui-bg_flat_0_aaaaaa_40x100.png | Bin 98 -> 86 bytes .../images/ui-bg_flat_75_ffffff_40x100.png | Bin 97 -> 74 bytes .../images/ui-bg_glass_55_fbf9ee_1x400.png | Bin 113 -> 111 bytes .../images/ui-bg_glass_75_e6e6e6_1x400.png | Bin 115 -> 89 bytes .../images/ui-bg_glass_95_fef1ec_1x400.png | Bin 113 -> 110 bytes .../images/ui-icons_222222_256x240.png | Bin 7025 -> 3775 bytes .../images/ui-icons_2e83ff_256x240.png | Bin 4676 -> 3777 bytes .../images/ui-icons_454545_256x240.png | Bin 7090 -> 3777 bytes .../images/ui-icons_888888_256x240.png | Bin 7111 -> 3777 bytes .../images/ui-icons_cd0a0a_256x240.png | Bin 4676 -> 3777 bytes .../photoswipe/default-skin/default-skin.svg | 2 +- assets/fonts/WooCommerce.svg | 99 +----------------- assets/fonts/star.svg | 20 +--- assets/images/eway-logo.jpg | Bin 55490 -> 21000 bytes assets/images/icons/credit-cards/amex.png | Bin 2100 -> 1733 bytes assets/images/icons/credit-cards/amex.svg | 15 +-- assets/images/icons/credit-cards/diners.png | Bin 1108 -> 1031 bytes assets/images/icons/credit-cards/diners.svg | 16 +-- assets/images/icons/credit-cards/discover.png | Bin 1412 -> 1347 bytes assets/images/icons/credit-cards/discover.svg | 15 +-- assets/images/icons/credit-cards/jcb.png | Bin 1638 -> 1437 bytes assets/images/icons/credit-cards/jcb.svg | 30 +----- assets/images/icons/credit-cards/laser.png | Bin 811 -> 768 bytes assets/images/icons/credit-cards/laser.svg | 72 +------------ assets/images/icons/credit-cards/maestro.png | Bin 1648 -> 1383 bytes assets/images/icons/credit-cards/maestro.svg | 30 +----- .../images/icons/credit-cards/mastercard.png | Bin 1181 -> 885 bytes .../images/icons/credit-cards/mastercard.svg | 32 +----- assets/images/icons/credit-cards/visa.png | Bin 1189 -> 1135 bytes assets/images/icons/credit-cards/visa.svg | 18 +--- assets/images/icons/edit.png | Bin 352 -> 231 bytes assets/images/icons/loader.svg | 9 +- assets/images/jetpack_horizontal_logo.png | Bin 10078 -> 5018 bytes assets/images/jetpack_vertical_logo.png | Bin 11288 -> 4888 bytes assets/images/klarna-white.png | Bin 16262 -> 9258 bytes assets/images/obw-mailchimp-icon.svg | 2 +- assets/images/obw-shipstation-icon.png | Bin 5916 -> 3786 bytes assets/images/obw-storefront-icon.svg | 2 +- assets/images/obw-taxes-icon.svg | 2 +- .../images/obw-woocommerce-services-icon.png | Bin 3684 -> 2133 bytes assets/images/payfast.png | Bin 12840 -> 5488 bytes assets/images/paypal-braintree.png | Bin 4417 -> 2011 bytes assets/images/paypal.png | Bin 46126 -> 11010 bytes assets/images/placeholder.png | Bin 23675 -> 9529 bytes assets/images/select2-spinner.gif | Bin 1849 -> 1434 bytes assets/images/select2.png | Bin 613 -> 525 bytes assets/images/select2x2.png | Bin 845 -> 755 bytes assets/images/square-white.png | Bin 27833 -> 9184 bytes assets/images/storefront-bg.jpg | Bin 16420 -> 12895 bytes assets/images/storefront-intro.png | Bin 382663 -> 354158 bytes assets/images/storefront.png | Bin 23077 -> 8038 bytes assets/images/stripe.png | Bin 19084 -> 3580 bytes assets/images/wcs-canada-post-logo.jpg | Bin 138638 -> 19749 bytes assets/images/wcs-extensions-banner-3x.png | Bin 9129 -> 2905 bytes assets/images/wcs-notice.png | Bin 8797 -> 4797 bytes assets/images/wcs-truck-banner-3x.png | Bin 5086 -> 1463 bytes assets/images/wcs-usps-logo.png | Bin 45008 -> 13119 bytes assets/images/woocommerce_logo.png | Bin 5973 -> 3242 bytes assets/images/woocommerce_logo.svg | 48 +-------- assets/images/wpspin-2x.gif | Bin 9133 -> 9088 bytes assets/images/wpspin.gif | Bin 2209 -> 2067 bytes 61 files changed, 16 insertions(+), 396 deletions(-) diff --git a/assets/css/jquery-ui/images/ui-bg_flat_0_aaaaaa_40x100.png b/assets/css/jquery-ui/images/ui-bg_flat_0_aaaaaa_40x100.png index 89ee1f10d13e2c9125825a0d1ffac9b2de1a3da8..a2e6bfc085f51b392569e58b72d454586b900f61 100755 GIT binary patch delta 67 zcmYcan;>Dw$jrdNaBkHDOCZG@;1lAyYSk*iy5B#6Ts}`1$B+ufA_Z%-NWGB9v38$7$usg>S1eaYV0b7yxf(&&Ps aAC_V|dQN9`Zm}wXG<&-GxvXKcM diff --git a/assets/css/jquery-ui/images/ui-bg_flat_75_ffffff_40x100.png b/assets/css/jquery-ui/images/ui-bg_flat_75_ffffff_40x100.png index af7f4851300e3f5f546dd6e993e9997dd3270b2c..e36540bbf980dbc5369cef72757e55fdebc9177d 100755 GIT binary patch delta 55 zcmYfFnjm4s$N&U)-1@JkRnf4KbLh* G2~7Z}`VgJ~ delta 78 zcmeZDoFL)J!2kpo`E{28DGg5-$B>A_Z%=LHWnkc7R`~t@;y2cC;Tb2-`MLy(xI)n% Z8SbSAQW%4+s{=rKJzf1=);T3K0RXqA7}Nj& diff --git a/assets/css/jquery-ui/images/ui-bg_glass_55_fbf9ee_1x400.png b/assets/css/jquery-ui/images/ui-bg_glass_55_fbf9ee_1x400.png index 14ebfd7eebddb94267074cd56e5e19bf59fe0e7c..2763b5021d49e6d06ec2e22d62cecc8bded08e00 100755 GIT binary patch delta 80 zcmXTSpP=Gx=IP=XQo;E4BqJMxf=KhjwZG%d8m5@qa?DjY{Jj3Wg?m1OoRU*isPc>G kXO~)n?^*kPReqE&ZTgU((-dIliyboFyt=akR{0O`*k0RR91 delta 82 zcmV-Y0ImOTagZcUI7vi7R5(v#`19){!zdobqZm8>{qr3d{{qwRp?o0y>jRJmVwgHG o{fXhv@6SN`Gmt-uNAa-70EuUb$%^395dZ)H07*qoM6N<$f@l~f)&Kwi diff --git a/assets/css/jquery-ui/images/ui-bg_glass_75_e6e6e6_1x400.png b/assets/css/jquery-ui/images/ui-bg_glass_75_e6e6e6_1x400.png index ceef7df61f2f6db0e8582f454bd195d7a526bae8..693b8d187672328247b82fe8521d2504aff569ab 100755 GIT binary patch delta 66 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 NSmRDul$m)a{0Fb}kXQf! literal 7025 zcmZ{JbzD^6xAvK#yGFWG5Qd?VZlp^>0cq(*X&3|q1f*dQ1O#cMq;mx6l#q~4>Fxn8 z-}}4oeeds$f6hMZ?9cPrd#%0p+Ru4*l(wca0WLKz000Ck&lGe40QB$*9AcwCJQcG% zWF8uHTUiZR0H}(?Ls?)v*o;=sbTt6Lj~xKuVE}Ob@Cp7G0N%g=VA~u3#1H^L;g;E? zBk|Aywp3GA0GNaKEPp>(SY9d`idc)7AY8Ub@mCy*06_g*MM3tt&+Oi3=Xf@K-=1Is zRtOWf9X2C(Gg}Ha`}_WVnfw5ilw`$yM2W_PN8fzaJB2>NU)bIJ;;XOU6XAEvMajNm z6>7%l&UJWIt(GjK-;f6;@8%))Hp~k{D43J4lm|q*-^MeidP$w`Y@N)`UktYj1m5X2 zUn~R-KMlN=xR)xtkr?sSbi<+7=;jP9hxeE-1&ilzHx77h)_)c+d*MBm=seZ%G5+jfoY6-G{-aU>3brD}qb91Y{^Nq^>uTjwBluMB z#soq(ntQ#7UdO&XTc}DiZxb1MBXSY)qOUIKwdofL&>%L}f}nFM7ulc$I@^EFJo3Sx z*1VxHCEW_TEPx;)8^=jh0z^%y1%Ka3ma}|_Zuj5j4I1Qxu<6b*hW`$5p$7?DssH&) zWG)qID)|Nl+TA!T+Nb%zx{dB&~Kf5 z68o)P#|NAnO;I5AT7m5Oti>1@RQzg=nD`d-d{L2G{0zJ;cz!e9#enp>Z=BT7${yWz z*4|Lx0qe)evWM3RZFYhapImI1qhT(JzPSZqn%)b&7r_#t4Pq|(w^{#hCq9m2 znudIl7e&6fyY|e_-wA%%x*KR8Ci|PQ=66mLXK$7#Uy1Q#dpZ@IOn&_tV`hSQ=zP$?R#Q1xHMM$vbf%E0Z^r~(I z{k>FR5%cOLruI1#%&WoQsn}%t#U8!4p39PUlZq^K-M|?%&huBdu9bk*H+>3O7VW8$ zpPJq*BOW?rGu>oV51oCBH8Z?_O#I@}+Yf)%<-H*7Ke_NX$bVL`I3X~YG16^Jy6_Pp7{>E)QH2)F_aS;CAU8}bFaW}ay`;K}x z#h8(Mf>fKAP>6TgtIDqaQIDT8$n=HF7pBuQZ%5Gl)7kL#+CAOI?@ubvWX@6x)bPBz z@-3jt6V7UtZ}1f6CG2;FMpLYamR%|ujb;35yJQTUwd4Pgr`q=GeAB`YPaMLu`usyI zemt2C?vIAfcHA_HoC||))>rIJWiO`wQ3CvF5RdFQ;OR2d;ADTiUh13=eayWnU!al@ zDUHpFcV!Fu*-YxTi;vWjNKEKtkzRMKh1XO_0}t}%A2n@_Mgxg=KmjH(gSmQ|YkB4t zsfNuO@6i5vzHZ28c)=4RD0;jR)bt&V`nIWNeXDyZn@t2D;$1RI&Di?PeUBd8B=cRr$lZ z!lUu@t%kpMyH5Mt5SwcM-g47(EZ7fgKJRokb?&##wB(3w9dGv(Utb?{(>n*lN@#oW zDTpZpyWente$Oz=X^=OztnQ|MM?nC={kCo{MA-DMXn5BCr3AH@%6x^FMotjs=u-efUUtblU{^wNK0(uymp?|(KiDCzB|+3g z|6asCF0;ruHk8@W&?$l&W~w#VGe%WP)PChQvsYM#ehh^PKBj;!uw{B7?P9OJRGy9T z7nD+0OLbz-f?5a_zzEyoq3`p3rt`U_Uu6)Q$t6?!il+B=pK?q4vI9!VpGz*@G&l>j z|41N_!M}jAe2>_XE5Jgpx;9MSP-}IGG;}t)=t1Qg1rE?NfGT*zYbJN_b(xrgf9D*Z@?lNKW(N!5Y@kfyt(JUJ&kzf zGJtdO=x)&VSuJD;Eli@r6FC#JNoreReX?~FIG4jImcc64tJ&Gl+<1zOCy}Pd#C;6< z;%WU0H@)```q?ZvUNiJ$L zRwrJ4y7X9jL+$;xYn-&VgPs%r+N-svA%Nm8nR?$%SR3w=!81Ce5E? zxo~N%Ff+bn>F)ZN&EUjA>y|hUHn24$Ui=>WTSuWu^97BgSf8|qh#N~%KZ*lR;jw6= zE|7F*Y|Ogdo-Lq&+n|Y2I$`#62P7IkRl_+98kNYI_JfCkE8{q7?ZKl`Yo;$Qxh=`E z`j}i9m!&Vx@WL<*UVA0LOlwsMK1V>SAhjWBlAa_k#ethK+O5d5bf6Y z8aN*Myp@fI#SY8})~1mzrq@rt$NTdlCh^foUORXlMK~5{-+1jtAi(i@?NPvZ%RY)*iUmVKOJQ_NVjOh>wPPyn7(2hHLw9wlymU#mf4+(8a zc!Jyg(k=Kx!|BHI+TJB9PAPxBtnz|RJ$NtqxOsLpkE(5^tv5*!RLO{F28r!jBtv1U z^_Oj$(NMQ|M^U7vc6qi>)DUvO#K~?x+=t&jp{G$=3;ygjK}e%OrWdLv==R6Nq9*Gw zx+RYHSc={vq9CN8A;q_wE#p<)dWqkOe%juj`{?LPlFbwT454T(jxAzR*pD&;LdrEQ z&qNK>N8K#JduEtHH3r$%kBPagG=}(?L##$6_dDP27i*xVsCLB#+D!GrVVEhWwpx%% z+N_5U9&dHO&PPuK1DBpUU*~I=rFE%6v^Hco3Vw14qBzPG))!2ZvQK82oxsRki~Mbp zG#6;4x>Ypl(1hXP;2LfAMihMLvcz4Ek<+EB1h);FIi)J_RdN)bw7@WiZD#m}(FLS0 zt~$2pEt?2;;ondmL|-q*qMo$>2tM3F;Z1R>b1|Ti+7{y|-YGn|kuhEF9`J$~VwO2@ zP|3j~{gPR{P$HVz@Mxq(^5TXDH!YP2%@|I%hWbVdHc?qoCkb4brFb;g5sebja?dO@ zO8FXfT^PGbNN|4mOHd-V1j{c~t;bES6MDt#ux3Hws8}Zl8)u8QTk)<@ah;g z6`y1;Z_HI>$a@D86mSW!B_=3{0M|QA6V9<-Cx&7m#9* zzA)?Dyh>;8BJ4Ke-gqN~r8R-bI(!^TnCx@usVu0V0y({Vps)29|3+g4%YGIpFL40+3rO>qee%+AZ1Sp59kz z9Ef$wIPjFapTl`FUe#VT!R@i1nR$$gm^!Q!@jPlcAbF40BBOx3FKqX0EJLs_Za4Jow}L z5%&>^=BB>=`~b`xAF=My4d;sjlxHxV)Fy+U>vUWl75e#ZpP-nfLBkvO$;Yl9Xsaz! zwOeTi92GH}yz|?Lu8{J>UuCrqf6k@TF@w8 z$!)25F6wqC8_%fZNA5aVH6Hjn#p!1inbq~x`=nJ7-VbO2mpBJH&xrUmv1_c(2F9CM z8l{C^3ohnej{pKrwqYds%CgaPNQnds!}m|;yk*i5AGmvhQQNv5e2WqrEqptHp%sqwsLFt`;X!FqfZ|XZkoucop&pNr4ebIel{;J4#Gksx;iWeK8wo&j@N$^k(`E>cIX<5ML|p?jw~wmZi#ejF!Q! zD%Z091y|2%v5sIc1sBRbSLP*I*x-?<>Dnt~i%qPLm&gqs=LXwJ4P_k9b8gOdtr;{E zO-QcVKB$^lXLWbIE+84^jh_g-uK8O)cdzCIH5!^6ncto*-C>Y4Yw2gGCKZ3}v{D$} zGJp~vsVZ~Mk7qRHt-#UN@^k4s*I;_YR;a8WE0pg#(-U?sf zH?7dOhFlU~x|-kyWDk7xGE3a(VOVJmEpJf{T=R!FH$dQOjivG1S0XPEOG)$Tq{@w$k{bI9OP+CXL|E`@DgP5#1L33kY&3*N7qD9Ll1 zhKDyCQPf;HaXKBxuNF7IFIy3@YpZaymPeY-J*yMkb#Wo3R!TA!vwYA;x{N!w6Uvev zakx-~Jx(u~2{8VE(cKV@)sUJY$ku@2Rd2f7B&P(oLou+uG-s2-illIHc#pO_5yl=# zTzrpUHu2yvsDF9;c3pv!+!yXhCI79h+0w8=yivutBdP|=5gnAsltUJGKR^BYjeVES zB}O&kipwj+5OU<1sA*OhWGI2eC8GSgVv9*Zk;=J*&LIj4oK1BAp83IBs1$^w8ZH1~ z1xKIgXc~dqok{6S`X!(Jt&N{bzPOQo@LdM=nDwt$YxXx1Q?W z_qiL*K3*{{)Zxmhi$6a*ZECvk|D0_@s^n_b4#zuD=O=V$dmmEZZrS2Fj($%(l?+|T zbUHxo$&&wP*vRH+jJG~I?jMzihv0KEgJ})<#TJKnenFq5&E)rvTg17egs;e^j|s7a zSwSYSfrA3qyNJss_nw&8m~K*}m3)UW8qNQ$J28tXWyth6@EO_mk}+COT7tLdQ;9=6 z1SG7Iy<^&N=}I{|n?k42oGju}&>gJT?CsV5R#F>NiTR#29_)ztZh1TlDQ?}ALc3RvkxeuP#I;$8m5yHl~o;0ct>_>(Eit6ui zv|-NTH+hanp*nx^X{?pBH301cQ41D;b(lU^=kZM~^%EjB95L|UlW3b$xh_BZBBOvt z%`ZXN65W|UN|ocR2J^SG2ZXedCIMbgJZU{2%VHVd)&6*|9f+O|B;fY{SxXGyF-T83 zpF=R3f7E}eZkO`+?M75TE3At?@~dZei?6-iv*vO}LQqqcwAzgO+Og%yt69>tVKKprY)3n2lrT3j9=)(V}pr8mw{9f>LlCeg&J0b=)kC-&d zZhME%^Uj-L0RK4~+zPnp!%pkcOfi=+Y|^UDON2qW!IN zBV5LUGzg`w=LrtVD{k8vqJ8X~S#NvwC4T5P!gn05$n3d;QUby{kE9_-O_GpECy*g{ z5o5^#Xd7s5(A7O;O%v!2M7lHuJXZsRplDF^C9tMWnPSYl0TU!A((yxm65eWX8mNM^ zza8+=;|@*=Zgy9!!ivn<2PG!=O!t%2*>^IP`UCEPN4ELUmUa&!f<#-me%;sT0t!k! zO!uf5k!R4Pef_qrO?KeP>ckXiuCq3AjemIk*QLMd6&)A ziCQitmjNCAEV-(%@oh8uu3W2FgUc24YHz)?!=ibENShair-mZ*%wooCdn*FU5~aO*9R-pk?c(>=-@0(<1#6A&FqwlcfyoH? z!#->a^1zvFa?`tVk&OHnG4?r_w;pf%K$eJD5`Fd@%`J%+WEIo3czle~oc^-%Hz9L^ zz2~tqC&dnfs&Y0ttFZ6nxk@>28F#yecKdZ18wtr$ymknB1Z45}asMBCw7S|WdHEpY zt1i;(gvGbFb=Mik6rqMGDQI$=6>ZyzksBa`hM0N?>pj_d~) zX9O=_p^<==7(_$$8bqc1A{Fn{pBWn7U1Sby6+ijw?E@>!s*V5GV&WeVkGc6cn*YC~ z)3sRH{ft7Q!nr)Kg5%P&>%B_;H>Qm}qq6ki?c)8)+Au$F7wu+rB9J0@8sdZKRPrUw zlEumZzo}{=3wz{zOHU2Kfq|7UKEf=Ml}W@-vH8T+5yAnWX8CYsm0o$|vvA#?a~q`F z^XigR^+7Kg1WeO*IcC z5(6E1%nIP$5BCJrbOrsl!IWe2-2r(xxN9W=yRlYZ@iQBf{l}g z^C0iHco@x}-f_t12i@b3qD9KfWZ2Bg&osVwFEm4)7Coq{Im<@v5Asyj(mluz@e{SE zdGPMx%8AWO(a6i%!pla?%ERWN0r+8j!aT62JbZ%B`2@rS_{9XC^1uYeU@*U2(xQI@ zIJ;WgzxMqHAjAWE!0RMNNfrIrDe_0aEciA^-pY diff --git a/assets/css/jquery-ui/images/ui-icons_2e83ff_256x240.png b/assets/css/jquery-ui/images/ui-icons_2e83ff_256x240.png index 264b221358985bc548f331520991a6e7a159f812..d578ae26ed98873e9f302b533ef779efc2e264ca 100644 GIT binary patch literal 3777 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 literal 4676 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 MsB5ZIsfCXFFKV5l(*OVf diff --git a/assets/css/jquery-ui/images/ui-icons_454545_256x240.png b/assets/css/jquery-ui/images/ui-icons_454545_256x240.png index e6e41cd07813ccd9c797d487fd183d318827c5b1..d7ebd2397c7c2cc7c7b125651e499c20aff720ff 100644 GIT binary patch literal 3777 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 literal 7090 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 diff --git a/assets/css/jquery-ui/images/ui-icons_888888_256x240.png b/assets/css/jquery-ui/images/ui-icons_888888_256x240.png index 2f1cf26a504536126844b4a6bc64beaa83aae2a0..e1caba9193827af8048b779d0f9e46b5240df0e8 100644 GIT binary patch literal 3777 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

(!nAQhcR=n=ha(Vffv*9&LCE>S0vV*`tX z6BW=X`Y)*=u52hDF~;rD7KILqUUGou{^;)>AmaztJl+)Zu0SISBT~zm0LgIktm&jB(^* zF;$5gb|A_=-Klx;8syA*0S&AccZ7PqlbAQGD$aNw0Xj-Aje0o{%V#Vxd_o>!twVq% z!JDqgXK3`!`&w^4g&vO^KO?uHSuVhXG2?)m1qep-iBrFzPbZ2=T|?t|NAyoF8v-o$ zK(qxiv^ieb>51DV21dGvx|&j)5>q1^G!|ei>J}1Ks}O&51aH%oDX&D4t>9s>HVVY3 zT@Kg`+A}FsH+$T=PB|+@cTToC1Z@(*Jh0LX zziSY?BC5=2+vsrW!SkY{rLOc#p^zLx;vj*FY8I2jBk_p#kIZ-R(ef{r2We98yXXKa zjLA@-YtyRHDn6>_0!LSwX$37RKf?_X51VnMQe5wjwtXz-Q}X%_@>A_ z-8fo7&flrf$Wr(n_0oMsvYsO}`}fS1UBWyYrteDJ*{?%!A1z;>n$G$$5-$P3E0*NP6v<@P?#u>?A2$(;9GH;q2if!wME#Myf`i#wn5Bl*nZF2Ok;w8LGXacphJ#c|V&=vBk-ZCa6vQ`nuO879jmHJz*Y+fUj z*JdQce$CkJLiee1uPr&t>F0yp`cNY zy|JR{RTUkVNPE(Xv0)mtM#@d~nuxc2E!(r~_*MZkKFJ+v!CxQ!;zKx~r(~jt?|XEF zg=M$lefQRIlg`kh6{0jNYU$%#z@H((X#gs zW@p^jjs97~ATu*l`yh^_@6F+Qsi(r-dtX0#W?o!3qOm9=#m|)1$&p)fygeP6&B$lU z%q6Pl?<5}P3q)G#hF-VinNUf*0copGtn`PbthtGF$Xw|j#%{->#>HxiyY9TWMX0ww zD_g{?u*lgf8pSVeMx4oSc&$Nk zsy-^$)PANz`jlP}E3tf#b6RG}Oi5}$qmXi+cqGG$9t@AC9fJ zWSX$0iO8Zd^NQN%bx1?a+Q45u$jB@ajtrkwo(qBMv~qCuKcg(rdCyuRsUq@&^ygf0 zzf={qH}a*b9M@8mIC9x` zS_+Dk@$->+$8bZsz{9a*l4C{1fD&#PQuIOCGF8R>c}dzB87{^Lq8=)Cf*-Gg_h=sy zvXPJP|Ag?PyhEa}WMsTD+sSKu$!r=?w*OU4(yLBx?PIt0&}q=URHjelTT;Yv`yC1_ z`&b(FoJl+lU%yH51-o4POQZ)`{B<}?Hk3>1>t#ItU*VdS*F#960CXhP<~JWzq@ATR zEOtvksJzLwPK)!pleBYqwf_u7RRNxs@AK;LA;*e@vD&bw4Q5`zd#q!KM$Q05Dnt&Rf%s~z*`BM;L3z)J3f>l2fk5+CQj9en-od9 zK-h=oh&q9I949}El3ffeE=1L5e2m+Ce=;<5swEc^j$Wbieam2{-t z{E1(-tw33$*K*lNtKj4K-MZ&PO6@GCDVFGPkN(DrXN0CLTQJHF)L#OX!_2SG$L6oM zKSeigQUWn=QRmDJMI^^_vnTxgwZM_HJ%-3HXKL2zM>evwzkj6I;6=qJ%q0NESx4Bv zkRv@=5i$rD5Ea3{bo`eVfMV(ft34fF7+GVubtq=JnEy65Ip8sI(EpdS6wPAcxAPON z6PCJ@0x`?we35RdRUjGJK>+NOd#F5@T{hOLI){}(7bR>_dMxUQYhq|Y)*D7^a?<*M;Y4qBaK*TUa=|8<6mh$x zb8B%N24w2tmv;Uv*eo(DFKy;{v8Fd>m2G2yQZ*bMPlh%x&dSvf>J`XQ0@b~F zi4|@TC4-p?)T}?Ut!d%c5lY0sEOfO`6WEWx2TaJd=ReT2+ldx8CLOVJ<2M_=AIEhd z{Mi_eoJIuM+V(YzLx(U@JvLX4?4CyCA9I_DAT+m;MAfcFsR~SQDb)82 zXY>Z$8FvZ{JR;669T`m*`){AM)zu5CN?U})QjmSi?OmxyKvB=XEK;4Z()*6)XfZAb z`8CI*>Y|ei{~@~U{@4_s#%FL&7fT~W2QVfQu(>(Eu5q5yykJ^)nYE;7SGqu{Yv}Ti zBLYZRkDGVWA646|-f@{GjBA6AN##6jjh-C4f4NluYxtaQYqwn6zX9X%g(2Zp*{Oog z4`su|*5tByCWNGQgTGAwWjrZ%2&$_dWkInv>zte@7&8{0;c?OC2#aNfhCV;*Qj=%F zpR#9DS=aB;3^{GAUg;_Mq)vVGn!mI9J4>?J`Erm1vw7*0 z!jOoAU+F}EVvYvYdXa07aW++i7H4}mVV?-P%&i(;M84_2gVus2IT>gtW5BD zh4or(%SwmMULH{7_eqnFgOc@(Dq6%y@kjn)O;%B_)g&Zll~6s=$D;3b(C@>Mx^SHt zU(%$PCKTGqhmlL{qhe)9;Jngv5{~Y-T2fp}INn|TuMS`w2{5^=8-pLzAaKSF==BNl z=t{g2Uf8N3ml5WpAplv8D=ozsC~Niqc|j~NK)x-=O0@O7D%3fv1J|B&Ng~jUW}9E= z`VE}nkF%aakxM8=ZcnRCy3R`S!-eOH%%I4MB%AojCI#%Gk!J?op_#T?M*z8R(`;NW&UTvS^9 zj_Hnipn(`>e}Y!d&gl{II`xl;5r_VA*>ixm9AHN?dTq&cK`T9CUgv~%9I$@yXZ^|< z^*Dg`zN}-=f#ijK%y+~3Ya%gB&$s&#KN z>)-Caed0qB$U|^KyX!sZN%BOvsH@SmQ7)KA8!=@DjjYdTsK_rZE3vj}kZEZlM1#xrOmo_cR zSI(fx_G4!Q{D@27aI*|`;JIGMs}ooKn}a(~{|C$wg<6dJg3D%~z=B^89u%{z#~xdC zxT;=w-=x-LzPVQI39^Kb?#(sP4gSgpsP4n?iHaQgq|1qt3m3_*TC(J_=J)v*HN%NE zb+_)Qvw>dj4oheH>kE@wja_chFLRcSh?A};F^h?I;!5wA=5G`Zpy<>@KHmqU~Byb zW?%J(h%JtUd>LBms&=phga@N06TB*I2x3T$f=f1e5V#dJc7(QI+i^@RcZ!FFco zvZtnwAhqkmKbWb(spx&)LMx;5T=}9{!7pfqokIHh#d4kTKPQAN3!i&eQs)MNGD9t=9kl+wo70PSQN~z-8IE&|3rc z9h*W0{)JiM*EjEHlo1jT;Tg*6g7@$Zv|9D!*jN&P9682uNLFQ$d)vq~XC&D@pdzn) zMIx{ThzgAJ{~blX6BmjjEIx!rSb%KUVfTJbm7s^ls70K`$;KJ;d>*a@dnYgMXEt;^ ze0r}7dHH^`1@?DZLv-u^>#uh`>Do$9)SLs7ATN*(unVsa9wKIQ`Yd@8D=0x45;H)Fq$i!GBctef`xis>CcPbluVgl z+=}IZNeieTW_~%}ye}?^%7r1mvoQ`VKOgECGGv&aP3l5AtnZk`d!VA=ZP1^CHQNuL zaLu>KdNZL93;7H!ey|Wz#4gf1uYgA|-(}XJYz8#-=^%^VMM~Sn%-F?T(A3HNX#n1E za`CZo3b1kUXmD{0a=#Je7GUG#5#;3b$|ETH4}h(`*(VFne*k#dIG-?F8eE)$+;0Wn zaQzd&Bxcw01bFd}4C?k4F7C!o=75-)y@@%soUO5?xth7LnWtmF`9DtA068gT$#QX{ Gfd2uk^IpCH diff --git a/assets/css/jquery-ui/images/ui-icons_cd0a0a_256x240.png b/assets/css/jquery-ui/images/ui-icons_cd0a0a_256x240.png index ed1b23a81c2b1389423565a29deb53e883311bc2..ab58528bf97025a7d0c1b8ecf095eed228156e92 100644 GIT binary patch literal 3777 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 HQ`CO|4FKj7 literal 4676 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 z&@{bhObN3CzU^OM4st-default-skin 2 \ No newline at end of file + \ No newline at end of file diff --git a/assets/fonts/WooCommerce.svg b/assets/fonts/WooCommerce.svg index 05880716894..6be91d22366 100644 --- a/assets/fonts/WooCommerce.svg +++ b/assets/fonts/WooCommerce.svg @@ -1,98 +1 @@ - - - - - - -{ - "fontFamily": "WooCommerce", - "fontURL": "https://woocommerce.com", - "designer": "James Koster", - "designerURL": "http://jameskoster.co.uk", - "license": "SIL OFL", - "licenseURL": "http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL", - "version": "Version 1.0", - "majorVersion": 0, - "fontId": "WooCommerce", - "psName": "WooCommerce", - "subFamily": "Regular", - "fullName": "WooCommerce", - "description": "Font generated by IcoMoon." -} - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + \ No newline at end of file diff --git a/assets/fonts/star.svg b/assets/fonts/star.svg index 0f00f2e9d2e..0c606d71f02 100644 --- a/assets/fonts/star.svg +++ b/assets/fonts/star.svg @@ -1,19 +1 @@ - - - - -This is a custom SVG font generated by IcoMoon. - - - - - - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/eway-logo.jpg b/assets/images/eway-logo.jpg index 696cb01b5392abb7cdbbd71cca9585bbd1e6f9f9..627eb3b890237f5898fc54ae1a66b64db463139b 100644 GIT binary patch literal 21000 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 U7~jLD!I2}lV7Op#MBnoN0cVe6;{X5v diff --git a/assets/images/icons/credit-cards/amex.png b/assets/images/icons/credit-cards/amex.png index 9a2b07d0d5d7cbb8c02923644b6b5a1316160f28..643153e54fbc5160ea8d195c89c9c4dd1803b327 100644 GIT binary patch delta 1728 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 - - - Slice 1 - Created with Sketch. - - - - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/icons/credit-cards/diners.png b/assets/images/icons/credit-cards/diners.png index 294073d9fd9fb6851a6258131d7abf60a63b757d..91164293bde9d719a5204c98099c8a389d1f7f08 100644 GIT binary patch delta 1010 zcmV<>oj}POvqVl?x_h6W0KwORg-LSXP2;(SP`#MswSi^#cT&@Q;+# z4`1S${oFUYCWzH0saP6e$(l_pReb!*avpxCjHf=C$8(?0&+yrN-uZDUYooR9d!RmZ zd^YYEUDuemqKYqmTS3aS$O{Er8Wn~4ebIW3yy{K%JO5?&yZBZ1yW~}-tDnc5`y6+^ z@hgra5kmN$WquFR4VadL^EVxx8p2QKP-oiIDBglj2O1QH&;&^7F->@zYf^e&ARH+P2Xt0% zh|{8BAr~Gtf_xyAvXv;&q-+FUkzjd>Z@Zdhi+lD61sK`8H9s#{$I8fZ+A0x%vL#hK z@?IGgE28x5-V7lH2q-BCGNEr9j+xermJJJBX?)BA?_I?Z!dK&NY$@II_Rt#J3~%x8b^^oxcA5=d2GB z27fk^e=Y*gXe#a+I5~u_Yu@6KNL5*JVThuFa88hRNjpW>Mi!ARr=E4zfQKJ^@W@=^ gjC0TJ?{)Y12cci)pPsO2G5`Po07*qoM6N<$f*%X?mH+?% delta 1088 zcmV-G1i$--2-FCWBYy-NNklBGI<;?lcL{bzbRIOG;t$$VnUH?wLupVG7X}IPS76|4+qjX}~Z=VCbub)p~3Z zMBI_q4KondD%YC$E0sqwQ$~u2MCULtD&vdOahy0aW%J7vMlYnWP^<$8oWqg#7dHf; z(@xDWeGvfSSAPo#|2mCmVu7Wy#HA~X*m)#^n>%|UJ$eAr6Cs-ohp=Y*Ao@lopy?## zpNCy6r>LJe#e+sWRo(Q0lg8(YI5{?hrlvy((A8j^X%M+MhtgN?3KE%ow`VgDVBS*ix{gqE3J#qlU)ce+YY45j?9uL{Vw3q4ZLC5w1 zRO(I2=bDRM$jM*askYM8-QX%s&lgdmivBcl)so^W$5JF-R&d9wpOW|o82UlB#rKUY z6L;FB2X}5gic*clRrg#@)uU10irdw$H#Il7_kSj-hv#!kNEfQ;c)1@dHhzT5RPjaX z_uDr2;}&X-^RWyJ)5OMizjDN{^HdM+d-HRyxZ<9RUC4>Vqu$~T&7>Q2)Eb%_94tW< zAG@4}wT8Z%#3~Y>NM!kNuHJM6?|gh3LV)M{s^<>#fm~K`KCtf%o`t3xUb)!CavJv& zSASHKZqQLxG+$1QCy`8-_yuwD{0x%U%E%OI_~uN)65=_$`TY@=w51uI=^b=nr>>Q# z6+CmXi=qY+H~5C7y6Oe*$(HIEKAXU$>8yR2>?Z|N2!4aU9vX%8SU0zY%|ULNHLnfe z=gD~s$sRQP}g$iXg_({Fy_4LczJ{}BKuIM3{&4Ub8h7TllzIA|oy zJ>61#a$<46ama7QQnlF{wPjTQHQ0rmS`u#ySX>Vvt{LDP=+UshcX^7xwPVKvgU60-YbV~`wd;Ns^x$vvw-*M|9gTVb0000 - - - diners - Created with Sketch. - - - - - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/icons/credit-cards/discover.png b/assets/images/icons/credit-cards/discover.png index a0f4ab39ccf0c86656af8c0dc926d06b028de5c5..2d1b1ad183b493b0682594fa1fdfda0426136387 100644 GIT binary patch delta 1328 zcmV-01<(3~3&RSKB!3D?L_t(|0o9fRa3t*(hM&{O#QtsDwr$(CZQHhOb8RDD#YkRG&D4P3d~&TDh-4x!%8BQl$0C@jAA8n06-aD5MbgS4lhywul;0Lx{P!Gff6uj`#>r4bJyZ4b%A4EV+_kO2m9d_@z zSbzXMYnH0I_Lp$1Ztx!4HVbm|c;tcmc=6e1SQvb6ZffF(ufL+SsF+a|NyMOPZva*V*%o$`naV-m8xS5vxTz>uKHwqRl>I!&t8<4->S=p!C|@Bzk-96@D88OHd%94OE)xM7LKCOapaxf$84zUJCI^vGk(o;{n9 zqsQ{uXJ1lPUCY+nZbw;JDfiy{02^F&|z@<-#mJ z{roG`_`LVthqSb|@%;}!vF&!-vHBWo@YUDfvd+5e^U}+&QxybmISxy);Pq(-RWvYw zU_fD`4L9J_(@&$Kyo^8p8c8S=VvoJ{nnQ2515XnO&% zt0iN_f`5c_IA*&uxaFg{{QTpO#3v@O#~!=!(n~M%_g^E3kBK2RHio?1T-IE3P1Xpk zJsAfO9Z1GiSz@|_h(yA4w6#!FSQunwU0PdP*?g0YdHIzWnKpd}S=qT%*HqKmSc~yG za8pubI$e!vG-A(Gj7lwjRf}gA%TW9}d&l z)Do07mc<1{q^G5lo}LQ8;`~Cqh{yWtt&QtCXiGVW5cCWfgR0Wp+!{c};d_2?Zev&V zk`m()5t5S{0 z0`Lz0w-T_Nz&2X57;ny3fxku@%aEv`-9mBXHHP|`4pj;Kzk%(lk_&zWQJPA6~z{fr*}qgh2PupAJe zy%E1413&i<%%bsVLoon!0!PI&)cc+P2)77WHb`LOp>1_&MJ|5+B>Y8V(dq?V?SUNv zH>Uq#N-S`ke!wkjfKf{?q*&cX0DlARO_;g@OnDZjXd0$?7TQ#S`eCr65ZeVOih;_q zEW`>)pEQjX1sMseq;HKeETyG-Uwc1?TcNcUYV)BiBXBlaxd3ghfwo3K5IfXU0b#Hb zln9o$I4pYsQ(1|ehaP+4oGmurdIwf29}M)o;5Su4c?N#|6ijV70G1mEb}0fjR?n6& mLzNAr#89%%8l|)7L;nKb^p4u7g!WYc0000)y8a z`Q7i_wt>V*tJ@se$@%o&d-^-S^Xc!N^G{<$Q7n`sNhLt{|9>guz)+bJfX9fK`w^q6 ziU6&t0|bCMxm>O{`V|jF4lJlyt=7p=h${mNY8H#-|17S^1B&RyWpQAkiJK#ds}w8@ zETBdst^iV?7ga)Ulf#Lqi=i>~-Z({MA4E7rX3s1p7z;T_-@H)6lUbGfI%s1Sb3}0& z5d92op<9h6g;J_ZUE(MB@z6n}r={Xf z$8AiRGzrPemg9I$HR2a6K-QWss3@PJ$JPl|^7VRZ&tWI5tfR95) zS{lAJ8nI&ea`fEkL{GO3y2XoWdt}ps$>7~RP=BNVI)C1UJ4>I0Gb0wB^+Vw+8VXoX zp|G$R6W$z;v!_nNX0>4UjG1VtzlQEEt0q2Y)(6;Cu^oUMc3?y+?x$c6Lz{5oXf>uz zo{W!mIuvi(gxjsnShIRHc6?WkrSb73z66%m7Hlal(iTrjNI(O27$ zzkjU~3wLcD2zZ^iVY;qW3zAQxg%0SSbeKin1&AC}rx~iN z87kc~359aHySo6v1DSWCtGx})H*dhv)qhTJ&`RHX;IwzbW$&OlBrXY1+UuZHC7>xY zE`m78sU#PM%t^uv2!x-;2#|y}E^$nP;+*uX$uh!mB+C)raIWy&-h0YRurZb=H0A^3 z02Esjgrhm|ZHR+pcm}4=UydZsQ{uai7-#SYlC;v*0O6P(e8DT=vYrBO7y&8&C4ZPQ zUyUFxQI+_fM?gqe;IymUdJ%ym>EQFnlJH>g`r+W$Jx7cr@i9?~bB=!pp3xIJ{9Y)I z7D!ii!(Z_sRrXnM*+WQpL`ZlP<3Yr|v`F_q3dx2JJK<`F)L4tap_T9zjsw5;=^%!Y zeT5%FTqJRC_uqqa1h;|TqiqSr(SHoNp$0-tHhfzqg3lcWo>ez@IFpM2i5Jiw&lwlR z;q=-GTLkQka7CFY;R+tMyKRu0&qBOVhCpQkRrYmFmdhRtj;>6GUq32JMnd^!EE@E0 zP3c$MV{5A?6F~Ofi{uI621Hj7t`o4EfTn8T^jE;%MNo?;K*<{eB`cN~3TicH6jXg2 zRKp7o3=DA)4Wp%-S!2fcE1r>>{Mt5SsqX%4(QPYblxS=%$kuI5o24_(j@6Y;iqSAm z9i%f(i`8wNHY~{0hi4mcc*d}|uO!9v`}f3OUl6!_0n9?w00000NkvXXu0mjf^@gU= diff --git a/assets/images/icons/credit-cards/discover.svg b/assets/images/icons/credit-cards/discover.svg index b2e4636ef1a..ef41dd7d813 100644 --- a/assets/images/icons/credit-cards/discover.svg +++ b/assets/images/icons/credit-cards/discover.svg @@ -1,14 +1 @@ - - - - discover - Created with Sketch. - - - - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/icons/credit-cards/jcb.png b/assets/images/icons/credit-cards/jcb.png index 30f31a311a92b7678584218abe46ab5859992956..37498371dba339fcdaa15aa57f4be64ddf805937 100644 GIT binary patch delta 1420 zcmV;71#|l544n&*BYy>CNklz%59H@J8D%gO1}HzK7{xmzxiK_Qp_6Cn$k0A%epzqcr@h;%xg7XR3b zOwrNN4bz2xyVzv^+5qJ?B|uXCFbQ)F3=D1_xX&VYl}MmOWvYu`TiLsEI}gE% z(4zzwtVtG=EpU!D7zLqSK77*?4zD%a0k!A*qxPaWG=E*IfsSs(u)31{bW$@IMKs(M0faW3Hp>)EDW( zpH-~M@j>N#n8C}Q>O^=BFY3?}3qlS+BT@c1oG#QE0Il9A2*LZUxsRg5uAsui=O{nL zj`ujhKYxD-#?87lS*zF$9tXFPQ{mfl3iUXLQ>(POG8Ju~O`r(i7Hg7)@Ydnq&}y9^ zX7G|@o-z2PH_@>3m16ldHG@0v+=lQEpAdfk37;&nr*5$xkBSJz+h98!w7bGWA3uxu z#5U)|pe+QqT$AIi!nJx6yFsNj2qKe6&~@o8Npr@XZ;~X9{9_&tl(8NKVFpJ1bb#zXrRrVhr(J#o?A~l7&n*z>Q#Vjb0E- zc)k&z%-~dcwNVH6oqO;gUkSV|Q3=ka8p5w^Q^a%}%i&b*ZJ#f)neH9!Pn(m&E!N~! zw|@%f)lLK6e&Kb9I-W%4-uDR3s%+9ou;x04vjgaUks^3gq#PVeR5ODUma0v?e%1X2 zdr#``Q32~ygY&A}RB^gNDGbEo6kK`bfoXf+VfeN$Sa&&yea$;0na%OfPSJ?4|Ae^E zaCq(5%{Hh1f|b~;bCkP=I zAAQ3{;GIkCUyNqQA(4xniG5+}~ zmihKOG1YT3%Gmeh6}McIEM&3@r(aEKXo@67%vz;j@3VY!798t^?4zPkXqpBeKY#e* zT!n(TRJ;J2;~#3&hjaBNtW^kp$L=8tZmx~Ohnk?s`Q|8eyA?7$Z4A-J25G`6WU?79 zQ)&gFerz@OD(~^EgWeT%kf5)WT9c&1Zz7`)`GE^LDaC5F)+60Av< zpM~>rc<7ERjy?=vp(CGWc|wYWJ#V|6J;|QQ1J0bK(9ut5`l0Et;m1AwF@JH~=LQ~y zz2|6p|J2|%jYFLQ?1mJ%S`e{Rf#7H{0wa^z|CES$8GW5Xc$(on3E@#Rx9MK~{lNGr z9y*NZYf`C-zlY_TWHFdv9UhyIYqPzX2QP|GNp&6 a{0}2%fo97bzFz#avt^M579fO_1wyQhqC{ec5GWh7Auul8NgcJ$qU&`1r~0qIN?NVf&q4_MM1Mq7m5)@PAn$1?wO-SI>ZE-LR#zQ

    i3!L(!Q?20 zC)oN;1`$i-d83-5tQ6Vj8}rd zNJB^yD6A5q5;|=v!-F(dt*2}&q|+XAd5Wl>)FrHFETvknK-J!-MO_&9^Rb}{zDA5fe+O=Vz&+VTgGH;*Bzq@|SY z!yB2djk2;jOh!sY5@PgSiuQ=xowfWz9GBVR?9K6$=O>uD>FH}!XywZDe{6F2e1F2} zD;2`bG)I2&efl5RNZ-gZN~0r)TJpC}Q*9T#JN|DDoIgZUW(Z|?dHi)=n*IZa^1t!9 z!AIs)6;=7Dawr`6=QU2e(;}%CNRm@XKkYC;S`moK)Y&uKI(ddxeTcfNQ6-_4Lw)UL z-k-kAua5r)(^p37me{m(YH+hMgMY=$1AH+YXKpz}pzx82R)Nz3Nj>5eSJLivO84iq z)20YFC`?YYWmM8`4~U+L&NOri$Sf2ki1wcDOfMl`kmJaFwRxL#V!DIAFN9cF(@EZq+caL1eQKfR(?#ulQA5&1CVcdy&mb_bmlXcw?%I5N_R-G901&dnIn zc7c6x49ZD&KDiA~AqGI$mX38rxJO)(g}LGcnYZN|BUmF?3u1(4yUEp~>U!4JA~-&`sVdJtwS{Ls z?=iNF*n~zUV{BQ<`q2QLet&j6_fw<@q{dOQ3EAK<+1NVbie+qW8eaJFbC5Vlp_C-7 zs4ii1Wi`X5k4WqdaWP}9F$Ps7YA-!4vGc)|c&~_b$(@u8^-Ms7VCpP=>oAy1XYIWOL$_#p4m;X#!|IqGLsNAbZhIbxB^&f76v{(K5=SvbWd - - - Slice 1 - Created with Sketch. - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/icons/credit-cards/laser.png b/assets/images/icons/credit-cards/laser.png index 7917b0aac7e2547fc6f44ae3821bb54ce4b71f6a..cf7a656eddecc4e0265ceac43a2205f365daca06 100644 GIT binary patch delta 744 zcmVtiBZX}tr#1_lL;{E-_LqAR@ z55Dli18e?+W;AN=jHlbsk~m8oW|O7X_D+1i_XzOve+JJf4}ZS>Y7g6-2b9EUI2tG~ zE^!2nFi8e+PB5+&C>%vo)&*hC6H$X*G;;I~ZomKn^E>~#Za_e5IwJz8>{O*s@Pas0 z%Lr&}vLSmLY!EQ;W-@JTx5oih!KC*h@!~vjr9c=~1Ry%lDNmCKAn1xotP)575Q6WT zt>^PBR>d^H6IT-}L6QkW>JdBsr}yS zaXW5AB7Yf_00Y1}!7{-lptX7SQf68~27rW#UaG`#t70s(%tGRKs?1ldXlor$BnxiZZj#6#P5W}q=Ew8oMdjSO)?Vb^nb~p4?^3c|eH8&zXMk;zN!=|G#wKeY4TE`$?H|K~(k@U%mXsw=ciK a5&Q%mdw4_jWh~0SW< delta 788 zcmV+v1MB>N2CD{;B!BWrL_t(o!_Ak?j@(obg}Wj5@1 z1%!ADkXR#j*|HimK^iuoh$Wjr8A$i^-@W&+xZRnINV;vQVWy-j+j80Wxa!oYvVHpD z*I$lCgU|a-WoF_oO)^%CsQG;P)yvWFi?g%OHgEH-27~%ZGk+?e&FpT0XVHu*OR0X6 z|C)URoWB)#@X&j4IYYYJXz$G281x4{3(M&~zseA90^^>TP)b1D>s7@~#1Qw%a>@sN zDpT$ZT-$|l>&Z8rtGH2j*uuy_;viMJ0FM|8s~G^5L=XfOV7&}IK~JL2<+{m`Ec5d? z<>R`ml+kY=?XZ>uPMp0vo6Ff*Tj$)Ew62&;dB*Hj}VTSiM@VrSpn~1h*+Xhde zigE{@I7_FjU@Ricf-z5G?l4K>I=~_t(+D-<+tYw+-4XbK;`AHFwoYR$una+>r$UEe z5~FRjPg05gqm4M5IKMa0ms$&#{})s-Aa9S!jO!o<8GoWdHqf?UYr#AiKfDtdrieoB zSe!=&4n{JtEx;AVGKi&MohbJZCrNz&Fz{z>jH1YN1s;#9Du(Fi8{lS8WoT02_cX!> zYq+YNpC-<`5wc+YDo^e9I2ds!Zl1J?aakL+#E%c0KYFD(tsIac8KEOpLK_`d>of|N z7)J2dFk~}^sc8Ez!@&C+;kzM4MIY83>3H${s)cvpNrYbF3ez%wYFTZcw0eUa+ zRhnN6!ti6=6Yz$yO!JGswS2zU@1yDC$K%22CwRCo|82~cm**ER&Y$gb`v)F-cte61 Si49f&0000 - - - -Slice 1 -Created with Sketch. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + \ No newline at end of file diff --git a/assets/images/icons/credit-cards/maestro.png b/assets/images/icons/credit-cards/maestro.png index 509d99b8724d6eb3f08b8fb7b585700f54bb1557..64f3ab351c9ebc49ce30736225f75972c5081293 100644 GIT binary patch delta 1365 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 - - - Slice 1 - Created with Sketch. - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/icons/credit-cards/mastercard.png b/assets/images/icons/credit-cards/mastercard.png index c626f5e1795eeb2a43051cd260cd19a1d9cecd88..9ee5ac318a6f91d8fa487188afbcbb91cf9d1894 100644 GIT binary patch delta 863 zcmV-l1EBn!3H1h$BYy)tNklZw*FpBWpfh#xe7egn6>rx~Eotz(| z3X8+z!kTZ-1%J3ojhK>+#oN}ajK9+~1@OPqHNhPvX#GwdFlxE9aP>z6qPEqwN+*K_ z;b)a1Yu)do#PAEZiQshe5}Crkk1tLJce*4kTy^Xc5u9mVJahQiVnlGx{*=Ux-+N93 zry7*Ze5gz=N!GaAeQDveUm&72tCFnWnZmhs<;dXC-ha|BhqB(|iCX_PTvvepJx&Mw zb%J5?W_a$b-hM?^#U<35QhFIp#majT;fv9!1b+N=rIi@Jt zq_jJk`-d#mnd^wwt(iSuvnrTboxxwPl0Eunb+C>XbMufT4DIR(#q<>!chkakAs;md zw1sWrXMe-&!F`(#{!U#X_+CS>`b)q>y5;V%HoKz$?c@gPn<*$eXE1U_=AWaKU?QBs z2ARZRUBS>Q!TY%jCx}cYgTB6gj=yJPW0R0vfqQy-V$q^Sm^*hamMvQb0|NtW*svj% zRx;2K5Qw7a57q|+L;?`>2?YpH6i`ATAX175NPiL(6iP`U2n5{q1_4=?1!m6NdCuiQ z6h&B;1zpz>$1!-GN0w#KGz~!zK$c~Ao<~{6RaJ!`2rvu-uIo~cW%4}#AMs%r;QKxk zEXxw6X~JHtCY2`TNG12Z?zvnfG4ALkGgl?|=9E&Tl@MH}B01$!4>c z0ens=Jsvm29k#$ zr@JBfABFVtCCKB!T5fW12W0mqklqH0X~6CQ^_&CFUS{=3O=r|#Tn`z=NhXt_MgktA z`v)jqeIJz{mVbm&`MD6A$aB1 z9nkcVX+ry%Jcup}VXqVkTL3B_gCuX8j?qk@8?sKa!}kF5BDpI~MI_tY-yqJ!8eCQ! zLU5Wpwtvze#3uNfDgwVQE2-pl9&4r$oIKEDDT9)2o`TwCOZ}FFof zLKS}hYk5k4J8JFv20hbOZ;IPJ|L(YAQDa01PVV6@Twzw&}wnpy#iGq<+)%wQ3krNr4gA zuf1!Ut8~|a+=ffl6*5kcr=chz&~MJt&X8(GY6IVS31_CZo{=N*{m5PKYap)fpXoBYVU;Nn*=@gCg6Icn%1y3I%HV}uZ_Tt0yLHYO{ReEPDp+1 z;^eT`!nKA{0{D5Pcm(S308XZ3v)xMhf5CMl=ks~2udgE%3h5%o=GNAhD)9ULLZK13 z;S?ki3Cz#Wqf{!PqoV^;Q&U)6T*Thqo_`9ON~JJ1Him_T1=-Q8UTgF$$`Uc}>Z#9}eb%*+U(%>srmr=lnrA0J15e?O+Dr?I)Y ziNV1^$g-^ZR##WmdSGAxJ3Bk-kKGl~*VhMjUqm1fP_;gv4-SU|{ORyK>2w;y!+-33 zV1G!KpD1cq<)ERfX-C#QKry#L!JGc4F@g=gdvVzgkQA8pU^^X;c zMQ~XDM|*pFRZ#Bpcs#0~KdERms%kejHq^<{!?Ot}us`3f_g8KHa(>H - - - Slice 1 - Created with Sketch. - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/icons/credit-cards/visa.png b/assets/images/icons/credit-cards/visa.png index 43cbfcbf7a41c21755ae4d8054d2856d4e5774e7..9b5c9c7ff1697f9a878213ae25c67ac8109af44a 100644 GIT binary patch delta 1114 zcmV-g1f~0>3GWDyB!4zZL_t(|0nC;IkR-_;g}0yA(OkRRz~P%{BDWhijcPv+SC7IBeIK7TB7T>$B4Yv~4Hh(j11 zLz6~Yq>QqvsB8Qto2~;Y4WwdZBdVkFWh#%&Yx%E1kW{{O>NbKx(6c(< zS%l;WJ@R=K2U`8?m!q)dpi@mRv*}{JI8BBuk%&{0uj4K`fz!V}hG?Xj6_xGO)jPTP zUn68Bbt+rD4C_%$c|kS@GJKiCKcINe%MQ%rg6{76X};PJJ{e-Yr^dCOIS}8ftjQ6B+~{}P*85;?yv2v z-c`@Pru1cG?-FW$@?u0243ec@jdg#L)R5rT!W^+BoJ&Rbs zryWhs_o_A@9lkKYA=|Z*j(Nn@4$!+xKEwKz@x%K4xO@@L|JQId4YtcghV0mczGW=m z(ab}iRd6`R<b g!SfP9ZX%Qq0JobjhP-qS6951J07*qoM6N<$f`Mi@S^xk5 delta 1169 zcmV;C1aAB92&D;-B!6s4L_t(|+Rc@1Xj@en$8SX$irbVi9D?Xn+y@bS`KEqQvDTNt zR>jHGZLPYY17#GQFY|@D2};$WB5l1It!tu1y3MlTI#)}bEhSA|7NgB<)}=9N)8@U& z&3(UrpK}Ufj3hT7?}0xzdCtr8JJ0=}a|K0FK9*(KBEbnF9)F850l17LRFhyBh6;x@ z#*|DZ@2m+9YL;a=N~}d9k^61IP1ACeSPO^4_TYwTIZCXB>H*gc(^2B!AscWDfM%GE zl2s450YK5s$}*_W#L`nQkK>CQmQ_wg9OZ3OrUrj45abu3Lbt z85hZftZGm)(|=Hs0jRkM!#6pYf7s)_LQK801pbc+<^3x44PHpFX7JxR_ z7_NQ%8+cBg!#=kUt2cd%p}%GkPZiO;e*i0<`VPWI5r1p8_TVgSkhQ*%Y24J(gPWiC z!1wP0e?zohMG=!dII}@f(JM;UfkaNj%X{8Ns`o}1(tn6$Rjhr^gEiZFFqe8*o{- zP>{8%Qh#&<&$j!~w5<(NdJH|kMSQ{AYD+fs>O{vUg_gjxqCOkJ=TTY-Co+1 z1YpVgC;Ty7O7Z6QK`f)Uv-PuKvQ_oG#AFX%(k$lLs?rS$;>oiFD`IpafQ=sx<8rb= zFq(z`ToRWwe~qU1kMj@5AHg}Sd*KIO^|h^T{C_eL<(1vs{u@@T{|aYl&MmDT+|za# znSx4?m2)yCza4l{HIb9lsw$FS0_W4XlI+m9ZxE}V?#6}>24E48XE+Su(N63XM_~fo z|JkB~cild!d?y}!vmgFQ8dq&{;kq3^qVv}f*6rxUN?Icn&oS`IIf=<0Trnw`T2(nx zhJRr0di4lFcAJF4d_pm{ zxz*1c#5J_}<(s?t!96w}Wqz)hlbGzm7ZrnfwU&5-z2AFrH9FG4x!v$6q9-k!7`obwJuI)7LU z@WL4Xos-IQ$}yT-DG%>wOk?#_e1Qhf=Vd2|voI!maM|P&61kES#94@`o{Ag%>z2rt zoFL9psHfsZ&B9z(W}j~-h_gsK?7<_m$)IEai>fokSR%8jVBfL9>uZAV+_md=QFOJ6 jqUa0}3u9t%we&w~%`Qn^Md?`p015yANkvXXu0mjf`#L+5 diff --git a/assets/images/icons/credit-cards/visa.svg b/assets/images/icons/credit-cards/visa.svg index 115f2bfb813..515586fab23 100644 --- a/assets/images/icons/credit-cards/visa.svg +++ b/assets/images/icons/credit-cards/visa.svg @@ -1,17 +1 @@ - - - - Slice 1 - Created with Sketch. - - - - - - - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/icons/edit.png b/assets/images/icons/edit.png index 8167b2bfcbeeff0972f05f1b0ba0f1f42230d2be..650db013c5b1b6eb6e2884977bdf770cd52f6c45 100644 GIT binary patch delta 215 zcmaFB^qg^mL_G&H0|P_)#XF0ElvaRGh^u>nk1H71+uOT=0gwlzkx3xe-QE4vy1l!B zy7)?h{DK(_HVAz9e<2{D;K70e3asB*Q-LyZo-U3d6}R4=J;~T$z~K_eab&{Lf44=a zOBCbQ~AUH*#a(>yuNqT~B@ak?}19OQYQTZL@$@F?hQAxvXQK$!8;-MT+OLD3S|h!W?b)Wnj^{5*w_%-mE4BQt$deM95_p&wQO707@T1m~xf zlqVLYGB~E>C#5R5WfrBD=NDxcD>w(6z1Xv<2dGXfz$e5NNV^dSIzO720af#s1o;Is z2q+i?Bor*zaNxp&4*^D5jX;TPPZ!4!iOb0e4h-CkY$6A0$`n^MoV^>(w1Vs1z1WUb z5A?c(CN%9XmktoUvp2b6*@F)aS_vOqgB8wnEmJtIAm++=_}<|)8eB6P_e7+yzH#`f z1@o`_+1uN?8dD|WIi&{_shS3j3^P6 - - - - - - + \ No newline at end of file diff --git a/assets/images/jetpack_horizontal_logo.png b/assets/images/jetpack_horizontal_logo.png index 7a9747a694b3c58ab1d396262c78c8990964dfc2..0209c0cc16b05c6f4c910163c6a54cdb0466bb7c 100644 GIT binary patch literal 5018 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 A!vFvP literal 10078 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 F`yYwB3$*|M diff --git a/assets/images/jetpack_vertical_logo.png b/assets/images/jetpack_vertical_logo.png index f6650ba1446774ee3ac86759c35f596cfc21a76c..619fabd4525557a04efd2a281db0c23d0ef353a4 100644 GIT binary patch literal 4888 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 C4+ZD| literal 11288 zcmdUVcOaGT`|u%(B&$OS$<8s7nS|`U;yA|PSlOHGP372RZ;`zchhxjA>=80EvSoxL z!h8FCKkxVb>;1idzkfZ?bKlpxulri}bwA-6YVxGlX|F>d5K=`287&9|pBe(eOC`Dr zM!qR}N<$#9c}1CL+MXHPvrl7~C%&)jZQiC@BMyC06*T^V&+SLfyIg!2z0lE>8>=Ms zkN3peG;*`eMZ)RP_)U9NXM~-9AQ3N?zHGH^711~`3jM_=B;jh9k_-y0c}73r@&~-E z5pkk}Kv&lgki!)o^~U(Ag+k_H=((6;(|SREYQF5TE06WBL5KI@7?L*fcKo97+F#Pb zf4|2aOqOJEJLrT)rJ^0KA#die5m8IZHuR3xp~MKE?y=N0BnoI!JYuUWfJ{Q$@joN#n}$gw2Dxm%v>8C3nRQrDF&Yz) zF!G0nXOce(RH5JsR0(YqK8YW&hZSd#D4P8e!rPaug4_uEC1X4yd6>-~H&vb=hmNhT z;wH4>2_{6fA+ug;hZ19{tPK@t|J0HN)JvM43nmSRAIKStP&|Aui! zNHq4~YaJyWs+j3UbiFE6grOZ@L<`Ys#*!ti>5hrNTBeLo_Zo#q$Km#%d+~$(Y*XS` zp${J2isd*VL}!^t{aXAAllIs!zvAzqaQrHEQR+5^H7$Xgvm_{WH?BbXFvlua3eL39 zUxfe6QRgc2y*(JIqr83EojrS_ECS*p--GWd>B-ZjO?n-AHkf6Q99x?FYu}Cfh!}Dg zESFU3)Q4?7+@AI4dccw4cEITjHZtRBoWRluQPrJx{QB38V)RNU@R4xm2L;woPqaT7 zpEbJQ(Q#s0pRS65)Gx)k<4LNe`A+owNM7~+`(?1aw1zX!d?Ed&Swm{gS{GdZVt=etH_0AohZrQx&i9iMsW(T8W4 zj=ndmhB?GU)J3&UOxY#vgT?g`4qY4sruP(8Cp z>^5PjAkow}Pb9@h0BB+PJR&)$UrmNlE()xK1n}ZmFLtMYoM)g(to}*-hBh$JM4AfC z)(;iT@@_EBpHQ+vDS7~Ey)bn!Ss!UPTwX-CVvw^B*kE%#iN>4P;MyZ*&{F{oJpvMK zcs;@X2sYXfK$RuW1fw~b5jpW-tm@oya2>8aoubTC#2HLjV#C1`WG92k+plK{{>p^N zap~yu0wY5gTMY~W`>vahoSKqnSc5si6k2Yaa5>UJwmhC0S74JKEw&J}&15 zvstyCTn+jPbp5Eqye`i9j@~;1O=V^_mpmmPUwjaP#GDxmt#!{coxjEzgbGq}N-nf_ zcJU*hMeE-UHG_NxtJUGVHH(hA+WMD!7VZ6n0+XG`L`41B==l9h2c&$3evJ6HDpgD# z-oUzk&UHXEIM*HT@!h}shU_uowLDjT-qxpq*hyDOj<3PR%KmHR8Vp$KOX3Z8^=V@H zvCt@ik30}hqIUf6c?NqA!ME%Lz8*7z(elbBzKa|tZ}=+k_jGcu*n-{s_7>+m0BqRP zFRMG;kb*0=w8hh*3#^uQM~1-B9E}PxBrPNPtaF+$cvx~aU)~$o9ORDI<_DyXZWP;A z^0otVd%6h+_bedrJ^=HL2E><3&c3XQUX)oPukH_Hcp&u=sGzb?V(Y=O&Ck%;>od*+ zENaWIP(d>X>tJ<&MKOC_><6*>qKq0~ z{G|;W2sXWq+HVs-5E@MAGE&3CC_g)%>;|h+9mGOVzzVs*zD0Y!>;e{px@LIu8L-sP zvJ==qI(Gx(4eL$eaf=*UZ=eRscKknpSuEJON$GhkM3M=?cx3@kVusY^+U)hMbz-t! zsha@z*&x6LJn=4(2uPN5Y>|=ID1`Y zyqX8nFIyE@Q0I=Rz;pV|bXue;EhZB0Km* zFJS2j=3sMPFWI^3sMXJ?_q7+&SE8C{0YSfsKV)clJ%|`?!ga&nt0F-@ zTR%DI$*cLZVQi>brc-45^>%zXpoOpnu{*?A8#`;HOf#=8aIu#?ZqYe(DVa=FU?PwV z*zdCCpHVW}zuP!4HS*#AOeKLS>w_2x>%CF3%c=j3mE?|hIrR_L*;xlRGDROqoeHD| zAZ^!Y(PH1q4DJga-wxppCe(O@h5jiv!QelX1`MO!@u&f6@vGVE#S6bvP#^`u*nyb0 z{|UzC@4IKwJ^!I4srcV;{3AN;B@Dt(K$644C6JU&>+#RW+X0Zt%WOIB0)C|DN3Zog zU}>IZ?ZEk{fjDoY9Ay0+0{$j<&jY>6*>D4miGjj_4-54wX_qpSOagU@sT*v6G}eI- z6^z1Tk-;#jyTJn8z_`@Xs01Q8@W~n+Vht(`8EiT4;m5 zlW0uUp9oyJkH~R5-+Ez!l;#8zG8lXgGEhUj0c6sq${}SSSt|fLDKv=7z3Kr=`d8B~ z7D!3EOFFv_U42-H02M&Vx%lq-^n7`B+~P+x0KL>0BGrI~oN5;R*U(qO+65z3@}2M1 z1|y>F>kKv!0X70;QNL(DZ4zKD)Z>JmQWz$Q|C$NH06`P@f(ZckVFPdf100s0MrT&U z0KBEIoa9Xq5OEFO#1A6Ir8N-;yyVAJEFeIs@MIQ!W4N4SY~i-FAaJ4eDQuwGjmt8C z5@-SFa8v`6W510bUkssG;KF7l=TZFWMk>@Z@^Hwrz3bz zi$LKiKi|aHAnVQcA6na?8MjzAxA}LR|8o3Yz+c6PZ2u}AW_IvBWJo}gvS%qwqKFxH z&zV|-`z{O783Ymo+53TK*AAB-f4)@Q-FE!(_du!GHTaC}CB4h|aLEVh2Kyyg3zjBV z75D%wE#c$GiYwowF^fjMPAYgWKp<)dKB_(FbS{sD-b)AR0EF?7Vt2fvr0IJX1;g_f z=193{K>9L9p#bHQFnJG00pLVH|AzH!eZRS?5-uV4aP#`faqkS^0Ax}~dI+Mm8USWAc7rio(ns7!FtSr^ z;>Yr0p=4iiMS{qEEYyIj>+f~* zH>jYkk>a|U9318ycl0K~e*R?}QpapmarehdsDox4js3JuD#k-y*j zRYr8j-BBK&cFq+rrZpy$g+Z6a*glw1m|@i-#z>qiFYUC}@-XY_niyZ@j6wxr*TSz^ zTEv8P3+b0kz7F~d2vK)PhkAEg{J;ZdH@5T)QA83WIHpMc~(&s$#{1i@g1FhNlBve4E? zyi9u{8~G5k$Xuy+o!%X|$99+=j!R7wq@sHbKW>r>;I-pN{TOsOVKRJ+cIdjs(;-fD z8M~vN)pL-|qRGfPhd2mG1g1HZ&`0jJpD-S*uu1k~M;^cS3q)twmH=0iY&Qbjm_U|yf9 zi?^}1!Yt}*rRyjKk%2Vz1Z?y<^TYFd>Jpa=K|#yyf6|VP{4k@m;kz#F!Z_OVR?+iMyfwP*El3aWp7&pVx?Vp7xEqzkcKnY43F;3FIoHH0!TDCCW;K{*~G$jcvuBS?Z$j?Xt4vO&MW)Vy|frnwynij}ccpKpC$s*VG`Dze82SDW@#`|;w zyi$PI?^ASP&WRM^{36$kBLU*-%HsjyU%Mxc;*-(eV;MRaF#u4GM3CFKd; zaySZ4TaxGwvYCulwZZTMwvR7PfK>(Z2UH2rTPx;n6aE{N0!i`jOYg0yK)!+Ahz*L{ z%B@3P=hvf#B!TA?EH4O%b4~zd)i9{;^g}!mbBPRBZbkY8r8)!89m{c92qdlR@kHDhTEK8yqBjF~es3$fF$P!1Q3V}P&ouLOwI*?ND2^;Kp^C#?fC!Gu%y;N zLxt;r{NHu`3pGe!|NljC46}dcNfdP{y6qLcDNX1g5RLoy2uOC$RJ3rD&p!2?^_um7 z?fBMFK>q(``TrEqLswYVbf6(Ae<10?j)FS$O5S&qd9zlM4k>iw55egK*NS(hgj>kI zCR~Jh7b9`7ER!w!p2KlX`O~C$kAd>@J*5%D5tWg*3AbNTh~I9Ua-AnRoz*f4cwRlI z%A9QZ_3;FJFU{>!tNz)agSI{Rg(s_ZF0N8Ssk!yFF~TntY{xH z->@}bTbAv>R@v(mV`i_lxXGV9h7n(>YhsZ8P8T!n&(`zHxZ$jbh{6oI%CtE#QF=VW z7e5yM*Qa|X`#o#3@OJ!M^11x9nx|6_Ps>|jv%&eA%0(GlzlUDXYaWfA^Rp*7)x**L zW%oNTT6X#qpS5W??{AeJ4;h(PU2N_1KYb~|@853_f3^E`zT(u1cVtH_>d$%d0Ykr% zXVf*EeRiYN%^w+?k5^aX=Zcz==7m<{TU-Z7%SoPz-r4qvVQqFEP?c`1)gEXFa&=%^ ze*&%S;#Xw1m~hT1jOWR8O>iPErOa?Gck)kFKGFY^aVq3hwoUbO(Oft={f;feb=xUZ7~{87oUd2kV)VW;@w_v23Unhm=}HG0 zTF{bvO5cc`qHcA}doA`G`s|#hpQ{IVMR$a|Rvc3;X?ZfOS1ynR2IHv6@*j5Od96AzG}@%O{uoctqB`O1QGNit8$zz58&Hv-c&a7 zgkcFMD(mXEs(rUJ?i$c&YC5`*(Bx*N?vs8*P>C8Zb*Af;q!`qCu1PQ<>?qXU@|JIk zbSSGGC64JhYgOtuUNq&O*&B5TeLZ4Z-2N(0Y^<=Rr7e?E%CC8XE8X<)OrmTz4SASt z`u<>|3T$xp7~`p2I7N6CS;8k#-7jqJnDSlm6Bg(xTXudd(3w8;YuapKst^_SB?>Q0ahcm^Dr>n9p^;zN|vl zs=)QnJE?I|l?V3C$PUtkBPKUnCXhE;; z6{f8FOd2wl-kp4(+|W56+SY=lD+P+og82d`jq#mAZnpMv)g% zL=5j9hPxFB%ySH6x=LfIYd>i31&L@@|2?%E4Y)0?jpc+Fa+#?OYwSsMu1rZF%CKSl zP~}l|+~3ok^V8abjZ-C$^R?3B;J6ONPr^Q1=;=?l`3bS6fy~`e_~Tq2<%RXS;+P4V zYjiaCls}NcNNGyAr`X5`x|+0*bcRBVwA4-P zd3WxlpPbRkdNotFEK~<9gv>?K+t9Olhn&Q1Zm}0R$1Mt~Hu1VWpYUA)r^WMnhyJ_B}C5$Eb9t#ilo6cD(zZ3QJ0|wq6GoaJ83ygFs4w>7sTBTWxIX3mc+u<+I%=`3fH0Ts}VBSCK-?Jy2WTN z@2R=yX;R$vgJN$*d=R=V&e)>(@L)7F=FdPd&OdK4lwO&A5fSpnteja}hFbic5$l`^ zZ`bMgBr5lK{&U4AV%Fj+s!oUJ9?UVXMUvtNnsChTw#lHlD=r1;sJM3dd}g55s?np0oWXddvE3Ozz__+w1<_CpJ-m-nXPdZhg#f!Y-x zzHoRS*JCSt`yGu*WaBI1ZaZxF$ZRdMqT?AJNyK&tilT>Q-*dW;IVRbKT`nw)_*1o` zgdeS!m>q>ELv_q=SZ}mGeHh__7Q?*>PLl_(-(QWGOnwGP`e>jxQ&oO+UU^@AEplwC z=NFc^n~wE%O?8KPe=<-n*3~l3>25sjZ7xc`KsBn!23548dz&8{kbw0z|J^(O2|IEO zj(XkZhwnK|KD@Bbm9jxqX{24TWAN%j_A$jwgo`n3m?fe59D@0(^@R65fl>tFioH4V zeo8w+syC=JKQHw&#aI?tAR+s=T7KqxQ?gT%#AwExi^T6SORX2tq&EeF_azGl0Wp*ZBGV1$^_lYLJg z;$&X91ij9?-%dp@m-jCBE3Iy%<&`2e^|btGuvjA?-jQ!)wn`h4f2$<|YWea|kZ^oX2LU&ARP2MYG_O{t3CF}XtAh(6$*st?&>( zBorfN=7X%ZVtbbhV zE-Z993w`z|k$s@SxnpnM+O!JM$q;)Gowg~<;F$J|bm{8TMhgII1pI@0E2gTsG>;T+7}($-i`#K7lFGB3zBQ7K8s$1{eibH?N*fzUnZC6D!pQXjt zRtXLeGY&m21BV@E$kq6{Nw{mQrAmAhZ-#H75*24fbW^_%MRBxyNJ_}#Rnc7Kz1oqc zSJjbJF^>Lo27cBq1N|(1g=xNbh})|w4?NIxXXk=K2!cVFJI) zgEQDW@rLqbcQ{&^*>!b>v5N+_YUr^ohRdAGUbW$#`EVw>_acj-29^4IPQHxwhW<(&M42vgY3gcfi{-Uw%agguwswh1haII{{eR_I+ zdTNuxIkySjG~|b$Xq=i(n3*9HgS&>G^sp^V+uT(2D4v~a8CD}=C5&iTlxW|pu!Y`h ztEml`(4=S*ojT8bYgRS6tS`%MRT0zLUwMv{-*GIp+YB7K)BgL)y*Gz(l+nWmP%5lt zDcSCmdsef%X70p%FRQFdkCPnjYkB7j%SBeBuva6J(6LD;^>e2p{%?z7OV&$8?idU{ z5z!>97-c}cKWJZ6JpOW@@qL|W+;UT;Vdr&dyNvbxbPp$+(btA$z3B{`|E~<6^2JBx z1ylVY91%Ew3Q;Tmg0n5!C#%>~E{4gq$J8*}8vD3zaAWdzLw|1~HbsV^a<2n(Jm%UL zt5Gj7rQDR-ymRY5f?#1emVL_5WG zfO`>^+Uw97?Yl%l1xm<>0?yqa`nj4Q=Q|==ipG(H9(pwImD)}9yXD3y#TJ+l}F z??k*PYZ$sj2YaFUCstHH3<0rqKTxx$~ z=S(5AR#eX~aG-a_D#a>u$+c`!iYX!+ZR(1&9bJ=PY9Zq}PJWL$_OPK28onN{NX zCzskmS#(SRyHRh6L5U|*_V;U6B0R2Xj(hN~=W^`hVRXGd606EOwPC-WZ{Qr4?2C$n zFVo?Bk6WP$vIbt6pE)1+Hf{rD>CkY3e}u-vLciFI_bivA3r*!(yTBesib)*F_NXeMpk!z<*xa*{{E*_}0Jv^?btSROE9anrx_S>hD6z z#}qfu(mdPI=s!i$4~It=YoY1R0pyGIH&crAgSbhn5?cH*t3c>+Ro+bEnpx z1E;AYh3&U0bUuCtM<7fYnrI=f+@|G~>ONdHXKm#Kj~2^LpGb8)aiyz1blalcN8)G> zqeBqM>06DBKS<0s4r@S0eH8ls*nQXkPkScQ+-Z>n=M8iH1j z$m~?KrNRMAZJBW;X{Cv}tZvEH#EaZT&EYddrRvok0MLN;!`e4H($(|!Q*N=FL8)|b z<(9O?ubMHL$L~$G>L8C8L_ffB|IjxM5Mm3TA19+eH6pFvAworF=wW~app2k zWxS7Mco1r^aFsLqle7`Wws~HiO@4e>^kAp*%Ms#ctC{Z4ESv*$z?pOIo!-|dS>JoC z)+T#i)PFoC%@>-pyKYkZDLUqnA`sr6lFs;~hSox}kERB5?~!A?CFaesM}=Ra)3k{0 z&_mfv>W+N+;gzEsmhTrk#bUJQ;(v8Z%*4D|0BdAQ&f5Io;x_ zE0X*2V1cjRf%ZJ3)br{4j`m*}I8n}{(Yl*YcFK7gRchL0^<_l;c`x zy!z}y$ttd^(k()!ly3MBAz^fp4}?XS5L5}pvy-{rn`jbwEOF*52|;A@`YWCwx7wmoZS z3Pt~}FYx_=o{ob+in5wRWQlX7lsq;$ArJ+t)obQq;c3sIo0Wxb&oKCqK%1#zGYW?X znVfz_2yjaYfh5)nB0}Ze)f2_F6-Hv8JOeZ;qLQUL3S#0$1`82ho6YwUKXPBPYHnvL z6BCAGEwyLdVa3KHb)ccmbkFcQC?hglnH7^cd9}G%4-pJ>kiZR}iE5{TLv6zo4wy#S zjV4@8Jcbwoq4Z=?1WA1ab;{d>GYi=U@({q2rQ|qy6yJtx;6Wt&|Ek1yaA&=v#3&bm ztAtl`s&fZ(WUR>KDpe^UtDrj$PcI~NT3_iT_!8XDkDRN6mVTaPa-cTH)#KK^IS)^5VF=_9r&&crR~+vmZ01J0k^1a#sx@Nhg*E6v#oSW(j%O#IYk z|9ps?tlVL0;yhW#LC5WZrwqU){m6%)+qH|B;AFE>i-v(EXn&KYk3eSI@4-hZn{d+D zTM&rAbVxhXn&UA}H-4bQBF5_@8YsrXo|JmwJ5}Yx`8OK|Sz$38X!%QyOnq24h-7hR zQT23TgFq(D3sDp+Y6tOfFv;nd{1{xEK%V@MwGj6W(f0rLRZ(ZS;{+N*L_sVI)oO$c)k;6titlr-e zJDc+Vix74-(GNcQlAU}g+`jkNA2zGu)Z%Hp)L!{ouKRJ0UvCOSE?S~qx8qcqW*5zh z>KqSliw{zxebv4?$9z6*@eGLNJQ>)xyv~PKk(3rVA;Y7bCwS)Si-wQ1ks$3${#7d< z9&C&?XS*0G-1{`yrgicLQo?`ZKue7clpKMxJ^&kWc`dhGDzL?V!pmolITZ zYb}a;Hs_|)L+5y(M#=er#O~HdBF0{n`5R&y)feJCO5<;qJr`QKb=%D$EhXoU!IcMY z)Ex!}sYzpf9h(5grE%u5Tz4^+p|&*(ujvMFDNC*S5tmrA2FsJ$_4at z0r?W&n0iZexkYA*1w#4iqh z76Ko7=&4DEOMoM}0KJ6PK1@6?NMyIh8G%@BP||{O01{_}0@bS4Xjm2+nUE~m;s_cd z$R)~b5g?cg;I$Hlll}?vxps*{;+Q8@*JqCrIR}aE+2)kVwRJ2L4J%*uGZi)qfzRcP zapP1OalX@ao>1xj@{>jWDm5h-8HifpZ-8vtARM4t)d&v~ z83&1t)_8Z+zF%9)pb~&N7g%{5KXyxMfy96qR`#fV-}II=EsJHreO6m)(7?YZA7QiQ zwSxWNx11c__Sttb_Tu9dcpQnus~LcD<9HDs(dfRrGvYU$pj<}mn3%<6`VYEX_9xB_uv@5G;am_@Mi$_WLCrHfTBmW7g=r(m?g zk1tZJlU9#+VMnJnPCJU6QXN>zoIIb?=Ct^5>dYlt^t*QnPYUw=zby%$*Ho#SiGTO* zoeE>Kp%pFU-MhNpx%@Rh&`dmsi(AsIi6-~BvrQ^ngHk6#+0@fn>77|LqX4gsLo(tE zuZq@!oE*BA!IeN4fg%1~jx5fW7P zt8-}#Bll?ici?9pF0+|oCW36M#yz#H(*gKhZYQ(O{3tw|M_YYb$k@2-uQuDD$?(oA z4#UJN&IS)2(>JgIZKIr+qT5kJ=OPar?K!Ga8ho?|>N$mWxIg!!rp@w{yuA#|SF`uk z$DP9d{tDftBtP?MEbK}yzT`ivSgE8^{ljzbH8}R)$~EEqKNeSL#dT74Uv$$pyoQ9btC*I52Tv|;fkWx}rM-pFZR<)lNz=TP{KL1I18srNc{iB#H1?uyrImJhNE!PE#T9M2f@|62F06PKiG-eaxnN(l?FW zh4A)lXDWOyPHATa-ZXwGzLA*8)tZX~e@}HKdjG0kG_QCst?WMHw2n`@Phr&J{|4*( zn}?)3zqwlfHJ1>dg86l83+`tg+bsifq*GjX4$^EPps_PUdHy9_k2~~x8u?Xk+}Ce5f&I-g1p6_#?3Dn2=jyByTMte; zrr-sexW;7b?^}Z>rrFPSKQOnh1x{zjupXKxz0|9HKiON~{j$6^>9I?h6L^7{Z3hJH zD#c>-Jayd`BzC828PvCSnw)XC79yPEk9;E4)OjUnQ;fK%GH$JUNE)qLuA9@RO3 z2bo28ga48_R=NIuO!27j0Z**8XGA=wQb_KRwK*#WuW_nWrS=5aD=bT{*mB~I`2nU& z(d%-G?CZfRD5(z1#Qp)p>Q2b`M1+AUB^6G-8|kyOLRyTxR}8E>)i6t0TUlM<6LQK0 zzQlMNx6#Q~n>`7ce8;RCfeN{<{0a5D6jGgIbSs<;Gii(v2b>#)*A(1;V%xo;tK|2h zZFIRG(%FYi@pIIWW@t;m?vX(ntyoq#VVwBA{9Y+=!?`WLdaXe}A5yBJ;{MQHHyRTG!L%%?#mSVK?QGXy)r>oP)ms=JG!_WGInJC zxG;o*-rN^ETnm8Ayz5wP+X%BE<$8}nou)?M%a%q+=lh(%y7M6u6}L)ngU?S!xUrkg z3=)4x>N|ntt~%Hul3z(u*Yt#P7!j|x!fktQ6O>=Dk+oemw-L6dOCSkvuFbMh%<>zu zw0^B#|6im{Qwt!=-m2pJ@%c(zcT(Sm+@837;~AJ0nv5`7A{lTV7(r)B8H{B26O?hc z!b~7ewWyFXn>JuYS^#hDrf|3fm^XbDyxJAq41`{n`R{1?SE5Ap2bdw@GkQncH<;Fr z0I(*1e0*gvNY=}y#`?HS4?Xjltj(du(&dc;V*2RC>fb4_f`{+H*u_+aZ3@id7#X40 zm9j#5JsDquFUYU(oY-9WM=z_t6JAco-qPG(pol+?TKFooF#;Lmgbp`bufxx7qXL_O znA_-FnLwhm)(p{hM#g1AV-%nCi(`Mq;=zNnyKKmU-Wn$HwK5#&7Rmu>Ru&y)rNzvu5pFmAaQX~XJ`mgyxaRyvz4u31ftmS z$h@&>1;haz#IPy#+Gnj5&Sz(cp_BZ>!LrpE4$TdhL6 zqj+m}9~XJ48yVZQy~IR+2_KO97Gp~{^q0^Jc%|VF(uuxjE0qfS@R^?l2#;qaPScmq-a66@?8Znh;A(zD6c$E^+NKbx^WA^DtdSaf6`!;GMfJ(! z*9#N0Gz)FRF8*f&TEDCt&#@)E{JH0tFh#6uxr z?rDFJM=^8ad5Q4jNk;pJ5heGvj%iMu&T)$$2JPOh7vDS(@yPH8UiBTH>8Cc0_ERQX z&XH8}7q;6MBHbS>9k4&0)e);0a&$WQgOfPxT?cVXs8^GFc+X%R|4P`721{LHPTX)` zfRl|s(K?PLwP)(plEvA^8SRApNV$ygINrblRBwo?XZBp6WA&N(pME6e>qNP4`-7h< z@#xg6d$;X}lXZ&f34wb#?1Q;{8nN4?f+`NUZCY+JGh}B)?fbF5R2C5k)(Q_0krRHb%biFk_<|+_VJNs5jkEs9=S#h-*Y~$DdD;BW(hbJM zym?ZfqS}uO>0?hyQqw3OI-<|Ll?}qH?l4U_Rg4Qmy^&{5R_7a}R3N2pvE{jpcm~}1 zLN_Vn33#AQhL zWT~1oPNQMZnXR^It4JhMNqNDpM)`QsM zb9Zc(W3_;Ge!85$P?aX9HDOg~p{q$y%KGxucZ9w~uc!8wpE+pP-GLckiTPtT1ZSq3 z5}JXNBQLWtKP0nt@nYj~`OgCo6X7*!8E4U%5#kNZUGB&mMXq4OY3C34xialV^{4B_ zTF>x9rdO{cgkF;enRb3Sd?v;@*)JaBLW`C-fd_3}=kaSStZMv=q(#gznS{>Y*AU}0 zM%fw9NFY3?ohE!@&XzfXl49EIIA1ANzXOXT5wQn}->NyL;d{)o4&rmEFiUw?=~%ep zUG0S1P+%~R#JqW@n8}3vC@}@2RE_E`QbSF{?~a8=G|mhYvoK4dQ~xP<<9rXlu%MB} zW73a*CMMg6jXqP~JnV(CwZf9N}b)Li~w$AH)AF_hB5)6F#^xsIJ8K*BXr8T5IEv=Syyt|M`v^0Fi5TY&=0&Xil@Y90&Iif%#1CCP4wp)FRn8J+3RTq|(EN?1fv44o_@mXx7CEn6`} z?EbV)mM(fGL@~c1X7jY+$rJ8HxYq5o(Pq>X6v)(LQ}pQDE!%k#tK(1Ht5_@Y6I!wO zGvnyIM{-dQ!KMjz#>j#cD#=7_O~BhPj|+N}^JyJ>s>n}>LR!X<8K>rnm=)ARZQW_v z6uc^T&#|J|YO6c|e`twhV&ZvZm{@=zn@`PG+*>iv6_EA1{02~VGCMytFTjdR$}YsO zwNNo+1#dsSCOW~})zEsU{2sW`ksjq)kS07&^4`g!l86|x-IND*f=-y;<-fOD+YFuI zxD}iid*Mnhfc69TE;|-gET8Ob1H9NcudpUBlQ_lJB)n}dg~F|Q__Ziz3|V5T^d<{U z&W%yFA34KDIraNYmA+ttC}jwIRU(EnHO6!6idNei~u012`knaJOccv3P3xKQ@ za}|HEUy4C#$dG=~5d3{mNB2nvT%FU&j^S^vlI3l(GvNt zU~^ZxaQ!8dhBc@RQBD4Dm`Zj>{XiH81@%);cT_>LZ!`8VlTvv7cs!@gy^oD~?f;KF-CAkle z2(SfS8$Q9OZv`@))a|tHTQ5c>zd5>zghFT$HR3!7*7rI;mR%37N??ae zK%`rFj0if}+?sOX^#hX^Nz)+*nN54Pj#L4Ph)4LkajL9_q~hbe^Kj`naRyV)FhaEcmG5uE|}hKXY4le2qRBAR$|6W?2k)I~nrDyg<#M z-SC3e9D;wW`r|lkLBq%6jdFY62akRo_jwD1^2y9zcf)nHIEU4sBZIh*)&bvj(z!=i z=+sLEHK@$;<-54QU`KNoFP)IWrxWrx;}k?;P$f_cqi>Wo14?wVOM1do%wfZNZ3W!g z{c$svgsGtHSJ13{Fvkb+A`>v9Jz4Ly!hc4ZNc%xGH8~CN9iN&&Bkd8LoP%+nKVLt;d8D=tD7u-?BPq4)1Ww2bGM%eY947XaVcd7a z>kF^TA!@9co1IR##>A#(PIGL~i+^$@8?RhCw1m1D5|QzKbRHGgSs3P1pDT+n?xPdd zof6xWk9)MTZP2k-RQf)QPj-mZ2r_3NAEFlE}N#z zo7>48+pOhA;TFBL={?7h&4YnkhB+PlVmsi(u7=Wil+G`)Z&ssE(#mmgzIf}DZVNCu0wuh(r~3YSp!gHv9Tq{mv*YNuDO`-KYc}(!#rFINvamfHn&{5l3{V$P zKf4ZJ>T)|4e*ZdG$RG_HCxvbO&jFlZ6u5h^QWyLq+VL`Fn{Tb&aQP+^qP;)VJHh_3 z{DC>yGnO)rL33DwE>wczV$|7jV!L4cpjjk*kDF!lZi|aoNJ+Aq^T=c{vMLsG_U2g4 zfjo5uE-4QF7+LFo-=hzvb`@42E>*6HittgQk?%3Oes^f|ocbiRXZ$&SW*oZ8kc8}T z^X60P9~3rgsnpjMoARD(duP_F^Dx@TnF4aM!lHiSy6#GHe4vzSgBq-1LDPLXFV9cdlGCEaKbPYcKyPA z8tK&s(I>)~-r-cai>u=9*8(cG(#}y#(ClI}(yHp9ennb>a2RXa*$K3qT@=G5Wma65 z$vSpM@c@l%YUv(EW8_vnke|BsOUVZH~gPtKeC00b~ zfaH$+SPMGgl3pisc-9IE=^POa{a<|Dg#!6Sjz4GxLZ_u?v8=ecUBiFEDrUYC%W6yG z=Aha4RWh?uh^#=wEJT)|#`|^XD%;aw|F=L;H#1}8T;>Xjy?ziGZ*XGo2{+PBVLtP#P)I?pu#SlmyJZE+Wwz{xG=Hf@F{p1j3O$s<{c6aq3mG#dUFYNlW8ja6z*h z|D%dw^?eY`7jOzadF=(f%5LPLX^7;)mEwOq=ZMV>K#-uwxr_d|uD9{4i2{&wi{pOO zI(Y0UQ*aQ9TeIRbu{AP&aIzRS+AZ`0{lKOLT;m4TR@2P%!<90iRi2T_B}!okO_mtl zcbFX6H*JF;=saboG>W!}iYT`qi-h-I+o@su8Y-BI|{!Q;6 z*iZb?2d_Rz_u~{^L|tznL;yk*l=7wFe_Ze6E8|CGMT%wnt*e2|h42s>9YLY(xqXeo zCeMG4gq&}rTg5G`6VTGLb!rAUy}Ow_+o;|DN%Qw6wKtbUCSliO5u9|xvI%1P(fE69 zry%FyV*828+2|Y1K=l#|+O=rM4lEy%nMOZ99_Bn5Tjm1V|6*a;JZW7Fd~a2DE)f|| zL}pLRsK6${rR24&v|(tr1XIa4x`YBFB2Mp)A}U>?hTpJiBNb3%pW^izGI&}x2QO&M?jj|g*Tc(kJAa2bp>MIsCyChWx%s*EX?JumNWnQnU`qgQM3>3<0Sv< z-&al@!xiB5$UjB2KgY;3*Vh1MTWoF{SP@$)>Zf+++o0Dtz2|pQc@_7Jt6F)8NaDmF zZ>bJVe}6MtW_bxUmzMwRLUi5~G`k!>I9Op1ewdG{(9yNb%98CWL*9+=|9y&;?ilxE zGDhaAuzmC?1tpnod;!@b=4SFDO5FPHYd(=1gR>gq50KEwK-OSfq(PMAL32Vr5Cn35 zD)nY9|BBu)3qejtR?vY_Y#%cQBn@*qTG0)w;1A-jcD%IAOu^v5bK?2%AikLWPUQC7 z)|DT>MTu$=>IWxHbXoUEQ{7k=1@E2bhL|JJ%7$!qXS!Waw`%FFs%I_HR;^Xf@K3E? zs*68N&(~BB=(q9tX4iJ0+uF#}%|Y>FVUNGOg*8!PYp2D>FCx``xJ=A2z>eHt;;cV- zAs7ne<+-ZzYu!py8k{lLD7vZ|mDCJy^`>jOS@|a$EQCF&iF1}6`o<1Drt$Z60(TaR zj?8B!(7}!WPVR_a@Z&?``GckB@Ak~-aejwip?|)5o88hM&T#m$UbJz6MY!d6_=7e78`7+I#8$iCE&$krH)vb9)J_BH!NjqF>PLChqXF!Z5f5Q=PNOZLGO zLoukVStmXy`;sl&@2$`G`Tc+Yr{}5OckXhQd(S=hb-84y!a$GyQvEx1Z7SR2ZRNI)?t121$|z-!k~lgJC_XY1O`Ij&g@BLI!-k$__z_V}_M+XAT=A zK2MMzdHzVN?tX>_K9h3ccUJV8r(7)#KO`&vp$o%oMs3En2A>{&yX)9ezxvg#>izAi z`VN=#qiC%?-4>2)R(O8cfh-w^7An#87*Vwuy>{41F9Vpt77H!2B&Yw3_}>z4z!K#G z>k(ca@BT-YJ3y9*Vkv$n^Zozm>ICSTyrbfqMHfD#^BbuGSgZ^uarj}Len`em>OY4| z7Iw;w-Bp`)qT<{CM}smzL&6=8F|D}&cfISK!U%`#VuAO!!M{*aG(do2a(|hvM4&PaIYc0fFm|#-T&>TP*8s59hXI z1Gtl>)FR3pI@7m(!|eVxo&*|i8VxQ@OZ~6c-v(iHHW@wKdDtVjs0^3$VJMHq``#4! zkgq}|K+-g&K!4`CitqG2W^kDO|D8#|9+KlR)@m=|lIAFXNLdjlz;nE}@E1LC%3&`_ zt5|@rR(qi@dT80d!u;EC4O;@HzGE?J_&WAq<71$gC6D!}pCXB>pG<)(P_Tj5qBe^!=JR9NDw@A2DRQaHold7$uD_nYUN; z?zb~e5*LKNjRY?E|K-C9m@smKO;07acxG_)Kazp5PD+6+n5;+2n;gv0Fvr7YODjI# z-V{;7GvROjff6py9Tolx`CJ@&wj%=O@g~vm@H^=oaBQZZP&zE$Qr&d|iEHyg|A`CO zkRw`9xxpt@V*>DF!&84(ItLu7l-tudW;4uVb^L!_`v8heb|5#D3mV*p{_9s%fs+6! z1u8GEKvlNIn08@Ke<=zA^fD}_JcIKipb&_K;J+&Y!{HP`TE0;KJZc{Qw+RiLTEYur zkZ|wV4$*V|zkYukyH(#d-B>vi;+>%=>c^{Mld6(B8 zsq92B&xJW3uG}jxH>NzSMY{;|tjPb5@48re`lEJ+ET~zS;@b3F`pk*;yL}&92H?ESOso5 zy9jxQ{S6lyipI^nfbq~VM9Le?ZfS--Ud`0lfeh&q&88agRR*+NQtBO-*$1AX%IA*? zK;+E#H`JKX0b@vxR55t6(TyOtl{`F}7DS8^8vKotm=G)lxo2+1ye6m+t-`{KS>-Gu z^6GG#lHfu9d58R-udw&t*y%h+XPVASbyQ(PIpi znbf^CbqSZcUjvJFb}$@!nMxU=OiuUfA2<`sOr+_;k;Uo5?kjn={6QdnNRIH}E>8nE z_rfCk8%R2Mj-`~%$*~cB_jUQyz_+QU@st^*H9h7ZF=uqhPTU(w*yKL-c-gJ(N|xo& z*jGkxW)^tbOP}p*FI6b5m8>>~J8n;E@18fjN-ar&sIoh;Q}cH1U?jeMUp|?p=OCxP z?kq|g1-)LAcfd9x0Ph~Y;fQx^5ZY2La}__pUx=MxKBp0Blay^0=Ah3DH@(A)uyJ}X z)Ii5;ivB`8m$K71!bW|kp#RWq`q@R&KFqc;uFTYjE~j7%907)=N`FKK7o~^pUXg}4E&gHGw@{#eoPv!D<0+Z zO$#I{+By|SgC{PFJ?#V50oe|e1)r~Z#hp)D3?q68C*$|hGg4MWeP$4yA`c&DV zVtLjK@VwoAe={wG==^*0ngh0kRpjXIFvgJk^QpyZP;gh%~*3dixOt$C2h+e zqSF%X_&d+tJ@(jLCun>=PA634yadA7Yw{qB1>@YtAgtN34d#bK$~o7QXjU{qT47LH zSmF2_o?G`N7L9R()+jph*NLm0+zQg!t)~knuxXj*yp0ftCx$HFU)ZLFAzZ$J4i>AX zG(G%dn^jfgNC)?B)Bu9?cO3=SJnh%A7?L+8lSV!JvjB^@7Al~-A~O)vF3#^`z9yq3 zs4l3ciOBT2oH_iIhgg^TrBGi;X$?7BS-18tX)x!CtERN-TgNPy(xSc&=Tfb#5kM*a z-n)%_th4X8XSRYf>@3FYwb;DcB2yLzzH>9ZVl~+hCZOe&>0wmjtGheKvGL9he-Ki{sqlAkdR^iyZ@_=}jZn?oa48C$VG166& z84&9-sl%*m*b-F=GX^8rQtYn7dru<%TVQ&l_{ms$Pz!Ni3>@`N0v zH51w~iHU&H<9(R;L^f5(*tHd0ClnT*+`DkU2DGfjG>v^_pDcH+{Di9;lgQ8zQd2-= zZnXa#n#0Rr6k}g?UW6q~sPGE^8-YS8DvW#X(%XtI2EdF#jZXWk)|f<6s@Z<1JaaH& zfA%*+gHufofz@pxPdSz4Lp(v^?2SDzK{@6f(=h#~Xo^&wGNNSlglVT!jp`?cGdRRt zW4!)VA&4%4s0XLqnXaVN+Th=p^cqcubuu(0QHr^PxD{$ZMiU1YdbB@9-OP&`q0}im z!tkcAb}sHw@Rr*gwRJOgP7UFcVdBe>G{+js&i&v0yl=F9x)~-w==^L2li^Y-L3xW92^ zijR(nX~Y6Q+#Ymbzh4cR{!>w5vm$3)zJ6)SmRh(33lZ@@LR z2SKaHc-z`MnAWduLc?sZV%9#h=d5lyBz|Tbd}eeI)d{8GQYA{sVvjCr&5xPIn^;#E z=}L$qJf>_f_-wb-UmjSMqTu=H5ftCey@_l&j_|6C5Rr6>A}Z;*V~QulGo?wx^-1L3 zJa7@r{Moxf{GKk`lp`GAcfNn%D@|5-WM5pb#ZVCvv=Y}_McF#f_R zlk2FpZkqPbhLtx^x6_z|fU%Wr#=X98%j*uG)drJK4V;S%e>>y*eCed3d}OT?`XOc| zFB3iPNN5li`H&l6E*CVp$K=dn5DO_xAS)QE*S@kyOwy4m)MQzt16M7e?L*9fJy{4&T!6F zIX81bvOtXl;aAneO1!d!%}= z>bL{mqBMOOOj9IEX**vaPyB-{OmAK6qBRk(mihG<_(FXcjAm5NNMAd$0f&uWE z+e`D?owYf=;PCE^6}J@G$nf0RXyG!P1zI08tfCQ>rP~5=;+#$T-1Clthtj8q#I`j9 ze0dwe4#|{sp%}aKB_U8Bu$G0BbCJ!#BE*4}I-)$}VZj_?gg2SJ|NY1D{Yc2%360gT zTvmF7S~YgMq!oz?S>M{GZUl9bZfYW|XPOdO8btD_3JNAA2? zr>>2j$8NIjL#V^b=YFWr?u_ZH#3LK*u>0g!0&~dn_4&zW0*`<6?fiIlV;LKn)a~Wc z@nRX(el2bri1mj68l}c$=8_|uhU0$trM6K07H#Q`fCm!~>ucLu%xTyuMa9`i$K}R) zC$Us0ebU@$se2MJ;Z%CWDx7Kz*t2J@!TvmjPt9okt=XsJ=Qd3>9+bUs@2yH~GAMV8 zzUUhntJ$s*jK4du_%pzDVa?BV;aq4OoZ+lv$i8pBzj~i?A(Rlges(I+x0}&7{l_)dd+ zHmjD~2?>utW;?@SSQ;9%&=~7N|7a6Fo-ec|^MvL>i-B&17{69Sg!3-{$SfV_O%H+q z?nk2S)CE%gc(=4_lSiHF=$ziktV;{WGLF6V5;B)>{Vha$MhFY&tYaKm(-aBwf$0yMa=o+o$kXrEFH<p?X zJ_qeTr_}4UjK}A6&js@?lUHG$sU(l-21gw=h)3M zu>AIlCax67pYtBBP%)3^iM zLQMmKy=Px9KXz|`jCW^t)0Fa9c-3RVyz+}wjkS;N9=B1w9waot?)oE7CL%#rs{S*A zCXQMo!~L&bT{2O(c>Bq@rQ@>E3HX5wm)g?H!J830vB~1-Ux2~n$lwT|ocCx-J~Elu~QZV=UIm7$rDc zyuFenbQWjsgSjmyMmsW1}NzjaFQ*dO(@USPK5FbVk!Gh3fIC~{U?qKUZl%*V#8WWp*a-C}k`FJ;~4pp^=upBM{C zZ57e7jhQXKH>b;_OIw%@Om=so88ccNY)#O5(N8O|rZjkXTOdX6# zPinKT#Dt5hsc!2p8{$=?D@89l31`TcXV2BAM3XOet8ai3KIG6|x0d59Muh`G+AJHY zPimS1TS*4jk}L(ayBIbD_r}V(=&|AB%?7Z4X{FO-eDIHHP|wdPeK_)~ zfF;pC^puawIRo>)c$SD~l*-V5k*Mk%HLG_0*SU}0;Vc@2*TB5pa}k5ep?Kb{JY)fQ z@*X?0P3p9P`I&~JTLI*0(K&NopOL5=9_QoGeRW87dLf^<5?M=B1l}zWrH9M#A!LOE zm_bm?o#{D`^Gi3y)P!#`6rQDZP8bCN@|8*0*&(_A{#6S1Pea~)*!HWPmPPc>1Ll7% ze?-K-#AB%+-=@Y?q+Jir2LQdk8f4;YwS;?$JwJPRnXawbaIt(>0*W|gcr_`vqzt+I zLE%LR>oO`af4-sMLkuosqr{GL^w)s@GDKP^^}3R&9)vkVd>-24vOXz zoR#}sZY(~V;Q*@v4>FYh1gX%qE`7U}(06Ro$udbYC?|y_=H7Rzt0!|V_(g6e(09ZL zugO%x81?)d;ARp?sqVZ&AIj^rmL-y(NEUkDKZi>Bm4t75M{~!We~?>ylPX9_Uk&Ds zPMN-W#dRL>cffx7iZxAz_6QhY0~tT0W(h1S6eVd;`A(xRT<#YSZ8|tH z7Y|IWN2%5J6QjeU)0#fh*by#uW_MZJ7M|1g|574)vmD=cj%KsKXRzkFlBbFO0o*tj z{p8LM=|JbRNvU_a0Xfzmr@y-+o&unJnN^*PljnZ#?eYq^RbNXJk3$znu2pOK$uEob z2s|CvZ7~3Lz=l6Y-W3pg|5D_b{Xd&9b(Z1bGfB|UHS;+iS{O?Tq*R%F8Gn4RTR{2a zWQZV>>yVO#h9>Y@!dKq>FW0{jaJPdzeHwWPJbsm(rVQ4Ncv61+6^VII+C=Mlj3PJ$ z#3RF5)(uG}@V6@x%4x4?xL650o0rl)rH>MyUQg2NdPJ$ct}~+kV7$4_uW|`v$i65u zBf1Ih26wYqv|l*Fn;#@^*EQ1$mIZk}4LoMDYCcebLm5uFn&(e?q`&+VpyP0xTj+;B z^=MhC!S6X;<~imP?;9>(w#7t}?NvtDWsDWZkx8B!fHq1Qc+|Ml_GtH~1|U=EJ%v-k zz2Es1mr`y#^)Bu^_}Wp- z8H_iE3nPo+k^5QDp=KsFMh;PA3Si(p0!bAFU%{wzOh3$1B;$t`6FsHYa1N1IH7l-g z);Z*RgC$5mc`4d zOMNUx{1mLM74Bb&d>?Z|mR-AMKym!1ZH?d<`Hv%?k0soh{;|`M_TdoLC@0l;<#M7y zaHJ-pD}mHNoa$IwxU6Vp;OKFJ9uqOA+wvT~vKP$n(;oIKo>X%Rp{2L->C-S#c0M6R z?)u6npZxn!E_5P`{?oOD2E;_EgjJ19+jYH`DY*Y}04+l=i^q_PS|>VB;nFNSLW!+0hgzfFoc@wj{Nx44D$Cu48-$`m1$r&v; z5{2lBC4Jwyzx5gSgDjdE0=(dIKj6n58=se+fXC>!B%jO(F(i|m!KHaO_ri*sb*yf! zU@_>S6$<{`GS|pBwkF~@yh#aa)$&p~u&P;0%`nc(Buzzs-dV!`FG|A-h9Jr z<|j3c%IhYc!B>*47X|xY?fg2!o9G;Q1o!^O{Yu@KgGlyo41Ho&{!RA^V;vE3z*+e~ zb+y*nO>l9}7?s}W_($(4J$?HV1GbDTw5|njWgrU>u3^!u^csUa@HmT;S;>3KcW;=q zc;Us^30z;6#r)~h239LJv28hx{BT9fUGlHTy!rckuRrYdmAB=!!veI2-v8qBJ3;3h zZ?1oNx2NsqXOdc!%bBj~j@qZn2)QxFj?~WAcTA?Md2@((nP)yaI(hoXB<%{!V=0o* ziI}K(F+{8COfJ+%OhnP_{j^2gtIiUI32}r98Dk&+N>4WpSokSKa6E~b;@f3VNgd!Qe^`JpG*Zt?r- z^d89!;53}O%-14~O9UojJ!L|SK~n0nN9up#VtK4`rEm`q#1!`wnMavp7kRPuy`r>X ziC3~{HFd4JwTVd?`+UzRQJ=&lh-4-5|jF6EGO1k;m+geACHJGy7 zQh)8``9NZG0vx@2gnEcTl$*sqvUL zV1_eAn7gE!@oVQM9hePpWFd6(TN8G=ize>g-zYctWqQI0>vQDo_!IoWS;R!XN>&K< zNH_v@0L=i)Ef$-;z^q`qgy)=S$Ql`cSy5j246u!{2hjH`mofRIEgOrADu{$m#$%fA zi))2au3O5n`dKBvS~ZJ=m?6NWI;7!aS%Mv*yfPhpdS%O_OWkgwHb5g|G#lUcol=XW zH=23kZdlgW&cL2fcr=WP&}aL~)o zyu$vzTyI6-F?uc9@*|et#tEZymNmcp#T$;OWnaEu>ybVqI!V~<*Jx%Z%BKUrAf2SZ z>5!B#d&_#2MqDx_?uWbi!m=mR&()M|;c7#cN#pUsSLvz@uO6LQGELrTarQ)_sYp)! zb)E3@2n7k;4{k!B-~h7m$x>BmQ$0MCP+nR@G{n9MCrbR6XAzvt+rG2Jas#aT)e#yx9 zEs+J=`DU|Dlv<9mP^0usMNAth)yt$w`Jd3I6VfYThF4DpYSUe1=JZ=+;KA)-37p6$2$k2v~Zw#+40MLuTT}4xk zxQlea_ST-suTCN+x*< z1s~fx>vyj+z4jVbVJI&$%m(u^ZLFgzfmGih|62&v4IZ9scdjJT(+`fmw}hH7Y}nWe?{Wz=UN|U~o_>LSXoV&tg}j>x@qJ9HkH2E|j57Can&*t( zD_h>38@0%#-KC`&kh3ZWnV?T>kZ_qH;l8NVeKTaz@_Z1Ya1*e02_D7o(@b@hE3<-C z0G_~Z=kUkywoZ9k=9Ghx2S*&bK@>FN!wpg87*s&)yYd#*RQHt`>Fc%p3SJ=G=h@0Z z7DRP{`yZ2>g>-Gyr4S{aIH)!#v)F%!@3@(L6$m7*c$f>|)7-Qzg)!_5_+zncSHwah zX@ken9F;(I2Ys?W2 zz&(-T?(;r9#HG-K_AmSbjBOL@;y%rYk_KtCGEts5O_RC zs=j(}p{w86>c!}^xE_tV+^wF+vh$-c%!4Hky|<&qT+6th4y9@$6p)-jkB!{BlYaga za8JjUdY`**)mX}gf7pB`q!5Q*I}T5@5K&a`QJ#*6sv%J}hvZ$3bzXC|93bXl>)&TEW1$!hY{`!m&5X<0t`3y@DhIk;4x z>e6$$)18B9L#fR+D`-Cq#3rXH&)j0-!Yc1H9;ITqh4So)@)93SEa&bBWf~6*P`Acu z5GkZ{kS!i{lIv*kJrT@5&R4O(T@4^-KHLpd_*N3KV4@$)_r}1!5f0}Qw%e5Y_eTKY z46HAiH;jgVWx1E(-Lx^MA@S20h&sNtNuCzrhx5(Zp_fu)^@}|PWIf=_UCEl+XM|UR#nW4 zgAmIk)R>UoZDQ`V@x(TtlcCLXIAXVFGJc5*tptAT2kw!C~e$w-NpFj}D> z^MViFr21$mO{bir@=q|&`B8yC>q5@LD&l8BnPaan13ow|26UkG$f=55%bmL@JIM3P zBUz1-s^a|zH&Rvn5+PaVAKBF-5Lm&hNXa_ofsoI~QFDcv&|Go>CBA=di4wao#;I@@N*^lbfdq@wIR@_3>UaqTFj@?ytC=Xu?hO4^Lk ztCVuuFG?*5cqhs`0;?KC&Wzj!2Kgc;R9){r1g@1Hf$2Fm3BR$^71nOHRClsCC=$?_ z6D)jOK>5M*+0~`Ui+(YqgGjNql6?_3Rx*-)1Pa94$7fBcE0tw|i!FN_%18Ko?M@+1 z4D#bXDTi)f!!~vc{442kO)AvVO@EY)dY60FHDF=-Mdu0?&P}4HHwNv*==Jz@=NmW1 zWUv@2bHD({vme&jCbQAxU+C?t-N~>5Ud@=#3J3cKuKdBjwX}H9FKv9AWVLh6P{4a1 z(CRwiGs|&t&WhMvbf?LUy$_x^2w|p6eeIZ_`6>mzH!Eo7TUcE>xK;m!p)wIJS7#gk z@D^sb>>ECY;UJ1#$y-0lt^n|;8N7J0m;}xDEJL*&L&Ozl9gX$c}_uH;JNu!sgk7e&H>28EXex5oyC zOHqNgIZu+M&zfON6#U5WYaU;y%~u|*9ktr+d_Qywu@4sUKG8tsR+B+BZ1i&E)a~wU z{+rVk$YZ>IuL6Ee=poySkh@Rv1c=af^p}NocV?*T&pYZ&Q&&^=dpnOgTo*nj2)nV) z{!o>8qI_g@KXvL=@Jq^@IzSL+I)-e)&1XpW0Sv|m%k5F&?zq2~SbfOc>}823y@21w zT3!i$jwu*{!;#;k&G&D@^; zNRu_Z^7@zFslr=p34Ka|@cQzcepT?{MmZWw5+-(2bQE0)7D_#%{e2!L!P}cnMU$^` z`g3;@@y{eLED3alHLEPNc70-i`pE2DUPLO}BFBcWqP%8d~{<2RLs~;Jm%{WlhSxRnW{4 z)TMs0&09iQn$K77l8y#!{<1%J;q*O2Y+bl%aX=(&sEiC88DAvW0N|KXS@db5^T=b; z4Pt4!j^ZRS85MXs$CPWtB1+ZEUW=z#wVmfe_2zN#t?{4GxWYl`+Caho=7&At_SB-J`9cpd|c-OxK_;6V(_2)RpGJ8EO?X$l~2WhC73 zLE&pXsVE_43&UYdS~-42g{!6lYV>_rKY!>fs*R;S?V)5Ln^b=`Y^j~G5`4#g;SQ^i z8~_^PqPA@S(DG}C67SAp@xe2iJm4wcP_Nwo&#M!5SK2p6MwucIUU~(U!*zii! zot3R@M}qSKaH7qXNkVV0~Tu~C@h+u9{ZRy4r)68*vT4f9MEG8 zyJa{E(Qp8+=L|~6;G1Hzk~(}Mfco00Ev0feI3`cer%_5PZR}N-ZXVgnFt}SFH)h$R zPqZh$OnE^_6o`7nY)^adDza=)UvZ~#dM;bC5LQxPpbp-O9sRDf!}3Nj>QTFa=gFlc zc(=v;^8N$&-vPI=CBEE3xgDOp&!dzAb?fiplmaa<`~cz!NH5<}DG*hEZ*VPv1F-2= znt^PoSBQymT)Vk5A2cGFGD*Gyd!a*yBvjsrQ6btL-;&Av4JbKLmS7u%w+CmWQn-eT zn^)yAc-KSsr*QR!(nKUtJ5@)~6QnN~1^sc6NfD}ai(!m(`iQ>k2A86sKW+Qq&{{OZq0LA1H`VoY?8%w3s&)ZYO(GSx zzT8%;f8-siPX8x){Cybvzh`LxUYyj+VgpVl&^>$e2Ec6)@v<;>OV+`t3Eo>)^;y1+!QH<_!&iz`91n}hnY)Jzx1dG}1j1Pk+#km|x4O6?0x zjdA||M3$XY;M81QOAw@8Q1KdCq~MZ z0nAa_0SgdP4Wev+W;j&!jaSpt7x65qx@J=my~?2%)KKHMxP=HPkHI`M-i}n~JDVFj z;073g=^7+ugm91lL#Ztu9bTfkvN1Plh&;2}M!YRn%(y&%zMRJQe*gE^^$z^ZeG1^I zJJeepl+n`_PQVk*!vp5``2uwzfSYHd%GufGuHrqAMAN0zK6f0M(+#zVwb;>1e#y7S7KT}XVQ%Bz};$p>__qW z)*0$#z;?d?_Xc>&3Y(zB+3C7F!r|cDGuGNA)Qtrj zi^_BE%AnBi@}1K{fCLM(%KQMUH_pNAK5SZ-%U6Q)$*-g*M$#zkZqrXTMXPWuBvtP*o zL@wl~M3*VH5>V7;RS=$yDF#S31%kaB*_j>ZW9B+2wUx-bVi7EcrT#npp#AUvntW`B zWhlN<8#7DF{pYt0^QBO=uK{yHYDt?yDP>iFI7C~%(86odJ$5#&mxqU0Yc8Uy#pj*h z<9c4Vw`p&n9&45Ua(>?DTUc7YCcQk9h7Poi)$|K?XU47X-#IW|_DGSm!i*uKCZcjK z3Ulo?jvT3SUrUfD$bvRS-x_CmU0pdnCVOtzTLG5wjKa>nK`yD=q%-d^b&`MHVPo=B z1od7R0d6WF>KjBfNT#R7(dBr5Tx+6ByIMSlbH=nN2}Xvdz1DNDgS0FQeD9x$)^ zL@weTYKv@-qBy7v+8XkqTAg#t9UE~gJMzPX(dLfYvN+&^#3%_DD$baSz;A}+5PU)W z{dn<=0M`jm0)+bhjDZyoJcNZ`Ik$F)W#IPoAC=4ys)!nwn$XQpvQ(wLcU<&y)jk(* zDHBTFrt{fXV}Ri0LEMKmnh%XD?`ua$yU~r;wQZep%r+oR^*Iej+1^iUxTg4o5@YVg zT>N}ADfgUu(Pi)ZCzlf$yN1~Q**z?Fk$dFG{LeFvg%RJ=TmqMU9KH8nFm{={`%mcU zp;UMS$JTp;-|x;Zr!(#?ajj3`Fy>K1^=f|Cv6)$v(!vjMzguZjv`qnutN0lMq4*{+ z8eP!9#WMc#W^~0J05Ozxn^q)hvnZ|wlvs|xW!rt(F%!iiVzKzLS1}H)0*4>4@3u;Y z;?MX2SZN}1O@xm6X;cC8bHs|JQye$rgRvzyjWhRIyk?)t8O$c(_02_iMwI6uk==|6 zrNBysjF5PFv`Zswut&BwU=IaVd$u?@iH*>MS*F-=dOu?Gfcy>wKj#~H+DOJb+`QAMsWO<+z=|*~wB#?U2#2@{JAYu65d*qj}cIU#Injf2204&?5i{YuX z#zU!{Khh{r>JV`(g=OIRczRppjigzo0F(I0tqerJp3#9?n`UTepauj!;M@}unAp^PNlUn1~qA7rCXfEeo!QSmo@eqWkl0Aw{Xn|;^~T-Cy~b1Pp$4E8cV6qDOoIC z=gAS|*J`H&(`(0Sw6B$43E@1?k?OD?E>(8-!i<3Pe)#KE*uM1S+h_L+B7Z*MTNtZzMdA*!(x7FV?|Je73!TleQDlrO4%_zQfPwJA3fx9<+>|p2MBi!><%*4~$s}fcpId_5 zPwt1odZPDO;D!m1oIV--LjmIqm|d3Gw)~M^TTM}de$0)e+%7fl#G@(GvM31729n+w zh*u-f)AL9q6p;rw0x1w}MPKL%I1-Ll0O}83P(n1gMDCvW7G8W6WnwON%!?IBgPlIb z)B}#bH|=z5wpb&(gBv#xvK>WCbklr|uB7D`3y*A|qku^p&Qp)f8~bNuPX8`ujPwdv zCOi|Qu@eh{D1XvLW)97@_0;;C&r5x(kT|qaxJ4*xSq7k2*)IUAfaN{c)()fb|CI=4 zY(<)med{h{p5@fXtSSX+Nz(pI_;LFc8T?-599eM={KMi`h5RdsuLscGUdh}G&vuea zzA}$kcQB#>VGQUK>H!aU^Y%25@iHZOj<`oS3uF#R2GL&9I$KY5-m=9wL=88cDtkvy zpKg?S!Aj*%#R@fuyr9epMzxo(VlG%?Qy)nhc&t$;*_bbAsJzn+EyePf2lRAolbQo8 zoGuwE2+2sI#0f;Vmj|3)j09?WE~1uFkIX;b8NXIRMuS`Jsb52gfdCajL<#a`&G2Jt zqXIx3QN3=9Ee&mS1&nzMze!z*KJCJ%d*|R5VD@N?@GNA3h%86=k(w@LpeuX0;8qm! zn$J3mVI@uiF@a=4XmUWud`d0w2osS_CcYqq83Aln;>VC&gQ7LxlzaWU1zEc7s9)## zW8$R6xV~oau^V?VzUsXUc&ouZ4>D8&(hz#5@oiiHF0XEQ6{h%Dtw?AgJ_AB3*br{8lOp^%$-la02B}<1XB@ zNGAnQFiT$A|3qeuv7hCHc`c z3;YiNCJtULyKH0c#R7oJI%8x+KzShbf++5+kBc0@wf0g?n#(Z}G}79_fz!|vQ||^& zApn&*JGwvkVo$22^*rEhi&1pvP4i^zvJG80~8b?8X3mX$?+5LD!L31yB`e5%oXPI%!h0%Dk7*t)S##uN6IrKgh2h(1j;f z3_cWN#SD4s!!lNi?V9QV{WMO1D5)ccRi- zWoveXl({cB!WYQ$DC}HIm?4I+Xe+_`b}#yVvpAg(gn26>ZvpFwN)LdXl^;8`g7R-q zztVfD)!KO*V-wqugH0s?dw-JZs;3iv0;er@rsU5bi_xBU?aAgFK*f@&?-k-P@Ue6~ z#hp9Ti>=xC_^c*KDO=ZJX3XK1Eanv!45K}o{V7X}Q}G#BX5I)q$OB5VHlmsSn2^}D zX_b6eRG^XT7me2L99jZzqM4Bj92g3OodV(hpk*(i3&bn*pR)}DX^>w{ zp&fL_`tA#m0DDFTg-bAc8X1Ar)~meWm;BhW-GaseWC<00ADJ}7K$wW0f~WjMapC4C z_hUjcN#Vzq*Bkev022Ca2pzylhV2M@eRJR`oNIsF>sGk=uG?qD4Wr3a&Uqr)=QrlB zSOxi_3d}07pfH`5r;YnLz-&QfjO@YBW9gB;F+l9J zHJc?q=NEiM6my?x&Larl1gq<{bir4${jVi?Xe@mqZJk;6U~&V$m_T;G_IeM6uOB-| zYlLqZlGA?Il75B|56kb|%0`aO`<`gXVTpK7=@5>Fsy+8%s{(I;#LoYdkP0N>;egtQ zJ~c@LSXzk233xq=?+5)F^)oWonO@+`* zfLr1Y0B;38HM>i2m64dZjggPlFO*8ZJ}hP82Ab1rISs$nm6V&;rP-CQ#u4btMDn<& z%Mywa6MOI#lK*>pBWpj(8lW*pih`YIt(@T#KyGvAM|KN#lbJxw%k;8c4w zQE;iUm5tU4FSpk*R6Yv8RSBt9TGuQ2mQ|P+EZix=1W|-b9BFxFYs0AxMbsq5)h`b> zoftfWm<~HpOc$?rJ_y_&bAfX49~TG;)>%mdDg}p0HLZXU zW>uC_dEw4b>l`)u4BkTUUA?qe^f-{;ubPnH*la) zf027WR=}LTj=yqM#C}t!B?c&`I-s`|LeCK^WHM*Qr4e1I69!4s>Pt8!gw_qSmJ49q zh$VDBixx(#L`?h()NDzLHbvxv>mmBUvnC8&ws(mO4U}9Ki^`n^p9LT}S@79ASb^wA z$i~G4QX)halEp5j^h~P(ByyuXzw;>EzcC$rJxTc|zHJijuU5vne2b}S@vFx$w&AyG zBFRW%;`geh6M3Xk9fddw4rY_Gx>piY!dEsc>cCfK+u3uKln3zx( zLB8U?XxU9zMQyKJl)chM|7+Y>C_1(?VNT8e504+GpO22AuYbf1uyC(*Xc;#^p8#hDXLQ?VrvP3MRxID zo|N|Z(;{eEG|!>mP20!(PWXB0X!I0C_5#JADwEM3++{M$(Ac(k)%-Nsnmh=a#U>>= zj|(v&6J`peN~VRxgH>6pej+z+PijrW#l3ud_FiXWIGe=EA~9dEtwcGX~~+ z(_(KRrE|y`oIL%Xe{(MWmZx4T*T!_?+sN=0YC{ggA#DO)6-1~cst{kxXw8f0o2gR_ zSEPF_cy*iXiS~pWh>4Zp$V5J0NdryinpRUU0@ZGN@;YzUQ~AD0PczJwZ5uu|K83S7 zihyH}1({g9eT6@YW33U#W$&&yF^NDLLCYBf4*=IwE(=JkZEK&Ry8f!27OfEfAOuuJ zb|Ix87SbE9@p-!qZp5?GnSr29{T5fL5}%C&i)JxRD}uE*P*@K#&^6X6xq^A{e*ooK BXk!2X diff --git a/assets/images/obw-mailchimp-icon.svg b/assets/images/obw-mailchimp-icon.svg index 73f72b88bc9..4a9b616a176 100644 --- a/assets/images/obw-mailchimp-icon.svg +++ b/assets/images/obw-mailchimp-icon.svg @@ -1 +1 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/obw-shipstation-icon.png b/assets/images/obw-shipstation-icon.png index 18ad6bf02a8c2a5e7455177210e6d8197ab7704e..b546301a9455162aaa258849cfd0ed1f353442b0 100644 GIT binary patch literal 3786 zcmX|Ec|6nqAK#EPO#Asve1O1!T-yNCg>l{;?jWhB+wLSE>sGh zwk13g4Y<&rqYcnZQ63FCfDs6ED6H~SSOvqO6a!Mq5Ks!^LtuH8F??_=FCv0RDU4So z9HfB}fMfWSsaF611j2BsKH-Ch@d8aa1~_@)SZV7+MBEiWUiQKMJ5s^`+K-BSAF)Q$PXm3gdxeIRVFu5!_0VK;WYcKpvVnFbgfS zGKL4Rpv_3@)3`^&Qco;5ESzRRo&CQJ!2V80UC93fP*>_wsSjYxo?iFF>u3-(1XM5z zwVX8|5E$fp&BPpZ9C9q-Qw(4KVK2|Q*_pGKH-2BT+uyq$ZZ>Q&xDxeq?m;PZY`5mF zi);NSrnXV%$uG4kgtRKM@Khw*&1~Of{5m{Ucc(r5O;RG475D@v+p$wlE{?pHWEmhr zY7%s;M#&A|+TM9P9~@Fdxhj57Up7x8bQZevi+%3hv7mo>aczH7UkP>Ac5j^>Cd16Q z{8O$bZ*oAyr)e?2naLV0<#rM(pxNbTHyX61ZFnswJ0oeeE_zmHHiF<3qB7op z`?lBC{;sC)tIu7x&P<_wMy?)AO9kD)VRrk>1KiC*HPz(X#qREY^RK!sDOlB~iYgJC zuz46fLaDks*W|_}m1Y6xyyV>`fez6rHI;B*umGQ26DE;J*#kQ>guh}tG0SFGK%D;< zscWrV@#%$_R+FV)S3x?If0aQo`Ml#lI)#0wbL^VNC7m1&LEx+=NyT1KvgmkRNX&eN zo^xs}WlL8#zgt*vp(`op=|J?PvYYRZFYWJ|Q_d9jnYIOAnqBsjWH>KKHytp_!RX+U;05!0ypz5kt!ctH{o$ac-ljmF2T9u1-#s_d|zW$ znG0?`i^M-&4#c8#k^oli#bgUp1kuHxBPX{=#)uftki$oxGiV##bG1=G-xg$OQ+6T= zu8Tl2OdX@r=1wqG4Mp(`OJU`!>z?vl>$rNKs|39LydbN743FO*kLZD{$)dwWob9x- zM+eNOP%TU%#nX=O~(xrCF7FbP={T)WvB&YyvRt&QnlbtJ#64R-BSg=mvU zJ{IFn%Kux}yijkf6}i*k`etdAKH>WfSJ;_|@A@nD!QLoTL>agD*vCZ1`G}@1ya@P` zJ{w*(u|xgxs38&#Yh5y*$Tj_NF$Ix1Snqdd{%YK24nvwzr?7I(4%tYPk!w?z9N*pV zyVpx^6))>3@byA^;E!g-1SsTNeLqXVwGzwrdLM|9@#PX*E4g&B+LE*ywmU7wX*I|1 zEaI-0+DVF8)Rd|=#eKxGMivGN#q8S4r`nd-rg4Imki?GYAHghr-W*g=kTy+D+ zVG2ra8$_3Nl*{2v)sup`5!a-+y%KsM_z+Ls*0g6(RWOpsIIVx$RqjJ>la+9tm%R>s z&0Wd9Q!EkRr#WD%6Hpj5R?XF=tMKqQ_wAIR*wyFZ?B&_(^(XDk9Laxl>@7z`ViZDR z)Up%=4E6U@c3Zhx!$m}o1=u^V1*lK!^*A52y+p4{?3O0zPMa@7KgKUDMU9WUuZdEw zfsvx3diMI^31>^m2H?n?xOSVI85CV^3txp3Yn6!ppOdO9bak);LD^OwxiF^n6V=Xs z>DvhuPR4$`tg}o!_)6f0xZVC_MRdvvpY|zv|2mDu)|~!@36@0e-l2o()?0g> zBU#(zW~>;LBO|Fvz(ifWzvvlJRE^CqK~v@h?RV!j;ln-C)pzgQ_=&GW;Dq<+(RlR8 z2lR*yddkhBcA>4qWd3cdVQPVdWM!Q5uVGtK(f!4ZJHfpPeV9_YU%R1oHm&V)WUV}9 zeq)!t?4h+0?a^%K?{bnY2A&V2xiE#fKa#sE*J2HY%+B`soxbSpu;O2``U2wazA)b| zBp6b6;{Yr1?-$CK{)rrRcWoc$>zUEQ)sKtPy*3~5a6qyVno{n+>U4%6=u=ss`rO42 z6BkHPlhFV?un!uZREarRhoK0j^-(ABp6*RcX06)Nm_nr7wP5g>OcMG*0x^v z`Kyk4pZk72o*gj_Zi&7hG<4;Khpk^-P?r5yu{@MZ`=I|aj^lg33)3;KsV#N8Y%a}C z`BYv^*R+Kt@3PxhrMj#k$vIDQ-NyY1W6I~M*BcelQ=|CR=hK-5AnVn zm69+oIeV}w>sQ5Nx=oI@KO9ROUpN1CFjM#%+;#KG?V!Tyd!?=Qp2O(&=CK>U&C2A( z<|@BUva+=Ws{i(}V8PM#+6{`$tgY8^=a+td^Mp;|E_CWep}Hdccr;uTqL-IJfm4`aP!)9i8fN>d7Be z^(R2Vwr{&)N<70#+ndkplkAg=-ti|nm_8O_&g4bbW^&h`ORCchWW0^{nTDTmLl}G= z&ro^w{#qr%tB-YAq4Hkb#xp+7CqFzgJZoIun=;0>tWK5h?MQ^K=L3s**{NIBou8Ki zR=iDegE?3iB<0koJ>#&hbgGWJao@R>mnubEeTcS_!a zZCCTG08H#f>`uWPe#&igkN6_YI(RjkEo4uQQg3>C@R@aSO(v;GehmEfV++NXS4DgfQ*@P>?Oe^F?W8xWEmX{H ze}`Vspd2c%8!%1u$Bu%%>pHx4%N@2VUyrZbK^g7W;Y*;U#4+w~q@FSoA>KS4b_G;+ z^8T;-7WlN8nsU40t28hB8?0Ta8(!j82G)fa9iIQG{8WLG;>ghvSCj`odMp#y^s7%W z%tjAcI(K=mGU)OmYiHwO$!XutyO)0|Ej6DJa7~$f!&g{g8Jb7Bzft|KfP%Kg39ej| z+$HkfEiLE}pY&T6rTX$q9W1941iPKR6&tkr6KCTB>O-?a(TOtOKP^vYUwzGf?_5b> z7UdxM1INz(=I+~v>1`p7W=M6Cb2?(m*>-nrr|UGXHhwtnb%M<1U$qO@l3SuciAww@;KkT#~H(&p1 zefhU_?emzx*>lbMN+!G|Ozq-%W!v{}LKNJ?re8NGtOdBxbZ zOz~uqqW1gY&w|>{TmIP=U{eIJ<;N=-7x~JTq5PBUG zFemdH#kPtg*O_b>k3T&&9MM%LJ=>Gq4Z#QB(h)_4_~u*PyQ760dsVbBV+aLBzz_5SR)45hmr eueJ$~go4jcg+1O@iU0JPz`4#=S8zqS*3pO{<0W^H&+aM7)Jq*oF0e~nF002t@08U9uuyp_+ zR2Bdrx&i=d2mpXH=uOu{4bldcyRm^T;Of6t)>D;3TA>Xxveg>+=rn)$nb!G9@m5G4>A1x_$RgP;eRZr9qQ}X+i*}{e_Uo%TU%Rb z^j7FhSLplgcAI+N9vNJ%+0OJKbci8{EZ2$c`4}MKwYL1l^0{*`myobRV0L8A!CA~c zv(H-W(m~0A`gmB$0bkJn1R5Hz273D}!yz(M!V5;{F0w~PSn~$fWUU5zWgVp;)uwRj z#%P94fbCA#H|APtKQcbLKj!GrK5BTUjG|b$Qxh{4c^jo;M@2(u5C+QniC%cv_2#dx zapui0P0|l6(4k6Q_x28ZtOfaR=e!r^ zP(myJDAVt|smi($Q6OY}oDIDh1iEgFTpsK-uFp8uVHU?Lm>`$gwXdmYW@R!3VTfAh z#Y~R0-|2<_+Lh1Jaajt>rLgU3CBhV7XE0xwOG<&`>Mao*fFMYaswu5cs7)wh-8f;S zL}j~aUkMiCT#m(b^Inl(Rzu{0>-6V9l{;CP$MnlwdC3S%S_arl4p&rfybQN-ec;fA zgl_7T>=*guBM9ROe~@I8BDb+p$MRerT9{z&`bxQ^hoh6ZQ;Nj<1VfB5FK*_(7s(x@ z8DuOENBJ5X8TxOL^HKhx_M>K#%OSH*M?;4MW}3r(Tu(2fvXhkA!BG}G8cyO=ML!=R2)=il-b znnH`0KVQp0D2RPmNBs9}e#nX@x3NE9n?fKfWo98O$0yPz8rbwTVyU}F$&6pEJfC%w zpMda`QmUQi<$<>iFeRk3%dgklHfSN(pJSgtvuzQ%Civey zXk&Ct*{!9)nXuM4G}mZD;j&!+0?JJAUtogo0Fvbss2Q5D69%k#isoZJikIEM6tx_n zJwtm-4TqNU^P{fq8b4ctx+FkKdvmT+rhd||yGYO^@AaYI)d&*U4UmTuA7EjIa8u+m zm^{!mY@Uy+=|atU=MwDG9iBN6r!we20Zq5O54=NJ8J24qN#RT8OdUs~VcH}veF6J4 z;E72YS>Qt1@gh&7IaGwWjbr&R=4so_fYyVx3fNNo9p#>)A?}?m#mTcTl{^yTn>Pu5 z^Bwo9G!c|Bx4Df?HWns+ z?VL-}+m@Z_^G!)VmHZyMTS}9~bKJ=#HZ!Q}h;%6%EV1mC$ zV@B0oRYk>}J!zYU?l=@f{5Pvrw*O=68N4d&>3`JAhI;3z{01hVx_c-&cB<{)zWR&N zOj}Jp2lBm!2Px)>Pw2#^wo_4%a%Fq|x!vz1o0w}EgO$hPDEfG#GBTEzVJRfbP-yAl*$?ke zHMv;n7m!&9)Db=OQSc5Ab3#x_WF*h%lZ}7-kUUc;w^vqxIIU8Un(4W{7F6}*ly_nT zGy>cbV3~IRs{9?tTpL`0gClYv;mBiGPC~Y> zn)7BVP8Es5VA6W^c67LR{Ruv4A>FTptecQPm1{W+4{FjpQ~axArAkRyBJ=<%We(v<16ki{Q`t5nHGi@3DB!^gI(HX~b$N?N{x9 zqU&U&bN?H+i!1btc48Chz1%{Gppxb%g@mod(!8=Z!RCRn3lCy<*3Uwsj~2uQ-se&M z>(KiPp$D=4R5tkUQT;icCJq%1ZsVSB{lDRElkPJ86whk+4OjEJ$_4CsYZ;1aosTBl==5Uf-q61( z&ZwZPm+PWv9YZ~+gVSxVe_Y9Ko<1XmymUE(0!1=#N}gr82wbnhSGX-RN7L$>9NfLV zj`KwxTXPPGwZ+$yk8PJkxfbL@_-Hn(#5Y{iOT=<%e$PeVQ_A}kd zE0yySg{+HgwcQ3kzp#4up9`A5y+w zkIpcvU&TFCnkT_!YOlKyG+$an_#g1igZZR)z;OD2srgU(2-dM^EMoH@PJzw>*$!-t zI5SaR_5uelxgnq#ESNG!eQE_0Cmrs zLDz$5ylr;iVqRdDLuWF9F>j44^aup;L&*#6NJt+09xZvHl{u2HCJ6q54_4 zvK{X(&$g!bcJT|^rIkDI3Has65xNHvbrhWNj^?L0Uo21%r;N~yGXPv1^kxzdlF{$7 zs%;Wf@%Vgru&hIsax#BHV(3n9;n;1CS$s3v3ZcXQ?_xh%E3KUw#K zI?Ht39xcSX^)T`^FNMVv{LEPmKYP@;o0DFh;dHH)3%J_p@Q40?^8vpm4gKN?pwz(1 zE2eDQK%my72)S(DY0RkW!9t}s`MAett{&=cM^}e4_b}cYBJN<1r?@-JkM)f%MyGc! z=JyR!DaQTHy4rJQ1$Nm@#NUk|Sg|qPY2qMxx*Tm4g)4!ykQmurA=CF~B%3=2V4L;l zy{oZ-uENBgfGwn^_6U@h5NQB#F|0T zTfzC#tUv_OTI5?nXX9U)BXJn;GV*9-8zHanRR}mXjPlYuDaJXwJY%Gat3LV-3kNp! z9}T?;aJdChRNpx(K!@YPzmP8dmB?p`>g4rG7)%Zf}?@2xY{Fch@n!TF{A@pO9pSj$*%L;hvv^oA_K z2hGUict*3(lQ5-t=JNVLHVywmdZ|emNr@QX zm(HpN)2J|?q|MJXz8vYgW`TOdR;iO&e8iV!h(GS!cX7@qQI!14t`2_M`m zZhrWX_deEA?t9tDp$Fubm*Aw_B-iC3wXwa6D60o&*6BMP2s>M|*6a6(YOFvxW3M91 zp?rHLe4?xG&^&Ih^%z(1?(pANgw7-S>A5)7ZKYmK!I2jJ`c;`@&XKCe_^q05A#uP zd^2=GKroKJ(r-n=wQKQk;XVAdW5f7sOVx+0-)=8V*G11NncgAWhG5Mvqpy{>RWER$ zHw5<<^cK&nC!qPa zL$MR~+0oqf>Y24tdC#cuQ#~LD<>L5WH}=ZjfxPztd#G&B7@&$e%ORDmr-~K%&hjlt z`n?L4`*0)*&Ka6FaLeEkAtpvRTLTrhPu*iS8O9O>2aO5fJzX9#>__>^uOWZkx0zkF z+bmHnn@|h%2~W3OExewRjt*Raj`|?LBQ_HM2-L#qK}I!sdXVdtc%4tFOqz zeH0dr#=gI)aJDg&*a~Pn5UOpZhPeNW5a_gm`or}?mRRc_INShyeVyy~FeMwcb)6d0z)r|^ z+;<+|?_%s}$=#h*D_9rfO@WU_X}h$iS91G`-_kYf%nn5?+Hka`(CbH|yvR0d(afgl z0oGn>5nhZ|;Mzg`f%#ZGS!S+N>wMSRka_ufpOEwj^y9@c`>^iThw-SRcKnJRlS$SO z>yl%c;Ms`Vzc}EDlR!_ZYj)rV&Kp^9CpGGb@%?j-5!KzH0{|fxd-{26?&Q22yn4Mn zu5Gi#o2C;U=c-=b%6&V3EP@_JkK`zn&X4thl#)yBOC4FgREzBv$-Kky;oOU_RKr3# z#kEdv(u=5aKJp6Ip-U8VN1^0m2n>z zTajy>-4OSgG%gRwa9fMWCOb`B3O+Xdo}7|J^PjtCx=nUydSh>i#Zp6bd-* z(5Tb1Mt0kmSl4^io@=rk3PQio)v^}-jWt6C0IemHWETq~?35Ry?o6JBrz@qkn{%PV z#k4BgDnH3aKEDih8Rs44mv(3|dw%kiP?bIUYUJ*`K&Nb0=91XkbHEAMc(N3Du5hs1 z=_H-DNYm}D8E9bqw$V=rj*rDm5=ta&PM*{^OHXBJj`RE#F&AospY956`__|jdqEIj zHX$C5IpI7sSyuH-+1cFDuwa>;FHDroVDo_C#l+~~blTF52ovA@LwRC+0P~{+OVdz+ zi8JyAQYe1whjr-3wi)>*&}LQVf3kd-#0QhD}&dHeFkrhT>*vC$x-j3f{d^xzquUsy2)Av3R9Gyxd{Zt}g z^6G||;8vC0ys-Ma$(DcH-vHLFdo}zYeN}%mnuIPtZh=6NM*&l10n(E@Zje>1vPPo> z0opUvoW1)JzQR}M>TQ&>VmP>R-YeO0N^hL^ipos$=WTdP^bHBmn?K M&rG*L$MxC&0d*Ebn*aa+ diff --git a/assets/images/obw-storefront-icon.svg b/assets/images/obw-storefront-icon.svg index a61ebc722bd..4617e869942 100644 --- a/assets/images/obw-storefront-icon.svg +++ b/assets/images/obw-storefront-icon.svg @@ -1 +1 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/assets/images/obw-taxes-icon.svg b/assets/images/obw-taxes-icon.svg index ff9e702715f..d1b0469cf1e 100644 --- a/assets/images/obw-taxes-icon.svg +++ b/assets/images/obw-taxes-icon.svg @@ -1 +1 @@ - + \ No newline at end of file diff --git a/assets/images/obw-woocommerce-services-icon.png b/assets/images/obw-woocommerce-services-icon.png index b96ad2e48e25a29403ca793f8136b92cb376524e..3ef4c2da4537c83b72c6a7b4b547e8331a6e8663 100644 GIT binary patch delta 2131 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�S%fnir3(Q=nluZNFyDa$vFo%`xYJM2PGzN% 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 Nd!?=XTj_1c{{aBm+ur~H literal 12840 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 z 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 diff --git a/assets/images/placeholder.png b/assets/images/placeholder.png index d95719cea100d6c2c7c2bac3a1c0a890d9c895b3..0a03955706246580e85762e6d909bf13fd05fd04 100644 GIT binary patch literal 9529 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 E0L+U~Q2+n{ literal 23675 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%0DJT450 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 diff --git a/assets/images/select2-spinner.gif b/assets/images/select2-spinner.gif index 5b33f7e54f4e55b6b8774d86d96895db9af044b4..2525782bb8d8939f521c2e8744b13ab2439ed12b 100644 GIT binary patch literal 1434 zcmZvbe^AnQ7{@-Tr(2c_tgYKx1DyYgq_!|Uuc-JhpnCQPQJ#0N3nX9YmCZEqM+6o<3W=&vq8^DP13?OykDT(kKH z?kQN(p_I8qpor8V72@@!Q}opmeYo7J43I!VI#Te}bcc}yYsUiSFtNB}mFvO!lGxw^ z=a#-=4k-wG!JkF}?n!Rw#5L|gD(m3Kktg@Y{6`V-@dG&Dr&#OIvM*~@GG21V4Q@?a zj(jRH6jh{6V#gf}qK*01_vnfk5cH)P^kqe?4KX%?(IdSLSl;ka=hqCA<2DzD$d_0@|D&X>!0bJ;H3&`IjbRM>D#64p`_gOQ%p!AgvGAgJYfZ;jr zw2jzV^N^*hjpo+%SZ9!kAo@;WDOLvGCg>l8@$G>+ss>_M?@BF4>u;qi(a$Vo^nI$`ml%)+N0j*k6YQV7jIwXS{hP@))5XiRKo%}^j^F62 z4adN0p{-@2mZB%fuEsW-#4JT-2v*tQYzCs1;R@YN(3?w{E7kIQXQ;+OChA~{jaXVz z)E2UkB;kC^2Ypyg4al6YNV~){b3QYQ;S*z-MO*o>`h+B=?&pn2yao&!I0vex zoHj$@N4DY9iuw)Il_T-T_$Gm0&&LY^$d{Alq~uK~(JIU4hxuQK@BF%b^d9FNQKJqO zIqeEER-N|vz{1%!yA2gzhZE0KK2oe9?CXgb>bt|FQm*byDOjXJ#7a+F6?l6L-6~3= zwhsO@2)f^_DT4nmCChJ+<5a^?@2=k=ewOK#{y!ZT4rBYoW}f{jmE zjbZ)I^dw>LoJ;p$a~Qtrnx1c9nut3eqe3LaHI>J|Sw2XPnLHL5nL2V2W!+CwCBFm* zd~pA~fzQmWW^8Xs*G&Gxd#8vk!z6VByD&%jd2qrkY35P7{*OS!=ux$k@TW}Y%LaI4 zsZpT68B#ABvWrACNGXwvV&TfT%z4Oayy>8_@-3Fcp z8ga_PtFz2zFS+yaW-Ol|pE8GZ>}m4g14eYn=wiefX_2unH@LY~YAj8qG|kU@Vo(lL zAw}uyaU@_}uXC(|d5T7iS2xhl42534rr)@HuQDDRSfmW~x7JJ^$yxx_bCA0v*7Q Q55DbcS|^Aek^->dFJlhn7ytkO literal 1849 zcma*odr(tX9tZI2z31lM+(&YVk%mZ}5P~KlG2s=WSbGzm0!x7^P##Mnh7t-jP!X0Q zk_SQ}Po-L1tlDK;6l?(>v)e5ZBQx4|Y-Q?nr@Px3?9h(3ZWr3^tj=`TP57gKr87N$ zp2wWee1GRRCwo_xahnw)5cxNPJbCg2L6DV|6`#+yw6v6!mDS$f9-JvFD^n;GQ&UrZ zzh5jCkByB101O60U0q#p_1BM>Cv-vP?&s4@g_((4_1L=L$(a91)0=J91Gas#R{McE znYG^9*0A5YZ>#;~+Wkn(W5B0^yELIYLP!K}mB~<)AM@1&nqekynuaEGqPrzoH|KodRXJy)%+w_fu3nE5>@Bd_b zqC$EQ;{c`T&?EsNO|igL9gC7Ygxv?aQUEXMq?~>wg{EyW;VcJ37CUF#HjrT=KQO_* zS>M9yydXk18D(+QDJ1>r);Lav_uYKp$T?4vr{Q$lTo&pKv^?(>L-)G2*lwH!Ah7k? z7oH<8h-(KTKt5V6$8gF)C7Io&P5=SjTh)=zV=E2EUhQZP##L8S{d%UK>>+y82>+FV+#^BzW7u3F)Bb>=lYQ%%j`F>ASe zo*cw@V#u6T`A2He;70mR(V&iV&-7{qP~=SRf&jm9-T{*ZeZ}$rd0#6c&fLG^xJcf5 z+p<`wJYgW+_s*V{uI$nMB;%8`S_3>PfGOj3Rq}@Cx^+j?rk92fANSFDBYnOqQ>Vdj z)(|$AhP4t&Lb=Gvo2#3Gl%9<=Gv`Mz?Po@P4iLF!x}GUWJICDlFk-hS^Whyh7x~VH z@0vD1>HYD4&e+~yzS*-sFR{9`{QEEZO1zg7>R&7cHts-6j!xHVdA8eI+ZlVzd%`es zJT@$#GX(gvCJ1oJN%yLBK}{V=V;seo;!w|Yte!W1%5qLNFWqvZW>h&IiH+oPT=b@E zPhGzv5=(Un*X>v`>%8h_nj^NdYcE6NHS_ifkCV$*D)Tqrbu`s;<=t<4 zAHNqNV?6(g<1PY-w@#I-WYFViz?9TrkMr)u0g`O`u|>T;k|2sV*YF^punvT;$SuTy{j3Gv)yqD!R_CF>yR)MzmmYS5v+~R zXAdD%ng9?df;wd8GxR#%3O+gz};Vo;)sK%Bj-q>Oq%R7JU-KD?vYu>#2UjaDo z&8$>5xW~?KPD_#XFToU1hIb*VOMidUr6iYiO0N|i-7s`T8!cFT`rN!^1Pt78J93i6 z5HI1wIM$94m{3SLDvISDe6$ZG1;eq_D9RTaaC>=cO{@Bs>$IlPCPJJ$h$)-3vzNUQ6OsN#_zWxey!_9%hxwH2_dEJi=yY|1c7nDm2_Lm!Cof8-R_+9UkS zcBE(o47yE)oMR(Q=dp1a2wTX5KvvGyLqlWTa7V&!A*|w|)ax~1_~aJ0=_Lilg*0iQk7#ZD EAHN$8j{pDw diff --git a/assets/images/select2.png b/assets/images/select2.png index 1d804ffb99699b9e030f1010314de0970b5a000d..32c2fc3a22b27657ec7d7e7a07648725073c0a40 100644 GIT binary patch delta 510 zcmV`@keU;dOe94a@Nhrn2T*n2w@QUm7*paS#+13PRM^Qq zUNXiddNHP`^tg&KH>g!=bTf}>ReC(4%x3-Y9rAMs2FkxnZvX%Q07*qoM6N<$f|UvL AF8}}l delta 599 zcmV-d0;v6s1my&f8Gi-<005%9ng0L)0xU^HK~#9!?b**u6k#04@wEs_jD^-NVqGdI z$%qaScBy364Wc|0{h%LE1pNbsAyNl%w^ZoRp-2QH2)suW5qa%W*srCFl!bvvbTCYq zKD~wS;W@Z0Z7JK=dEj-J*@b=HJI~Axvnff-N)o&*ga5}-D1Q|0<5;jA;T~4F3nuCk zgimO~Mie0odkk*IdkB-5fGql;*Ckz#*N_=UV~XK5cndy2<}$q2m=+yc0dRXRAsPDxF6sD z;@rK4JGdR_``1S~o6Xi@2&aR6hcSrEp9HVRzEqVDqBD1?`&!%B=o z=<&LwThS0~XK=vTk}f}z;3PN+PJ*l9kwH zLFTxtV1jZGo+2IW-;HmWM!l!tLB!a)z-w0^M^kAe-C>ha}%|$gDtun la}ZkH2V3+L#Mrh_@NazQeI9WLzu5o)002ovPDHLkV1m`?7li-- diff --git a/assets/images/select2x2.png b/assets/images/select2x2.png index 4bdd5c961d452c49dfa0789c2c7ffb82c238fc24..44b188fd020108b3add25c0f7de20088b6586cb3 100644 GIT binary patch literal 755 zcmeAS@N?(olHy`uVBq!ia0vp^6+j%o!3-pyx;pL#Qo90tLR{Sod^$Qh+S}WKBoK6V zcJ}x81Gzxp=H>=r0L38;S65eL5wH#r0TisSuLm-EdU_y&$jaK<+90wJ60QKE5uy@E z0=Yny-QC^I&CL+0RjXD(#DQF(INVGi7w9(57kbe^U)Yoc`2{l+G<^6QAnP&@kSvyGKU(>{BheHQxoe5H=T%JMb)lWRj? z|BkTVx#^9?=3T0{SF8_qUd-8f{={Y#wP2~s4ck>t8m;;{M{XYbo^^^Rj~x}+zVrLD zh1zE-8X{$$p0>Yr>9E#vTnUYDr>Z!Pi%C>wtZ_hDFwa%zP0s& zMbG=MPTWjBd)DWM&Q^aWI{U1)>Fn@c`{$hpRBmj1(6=;n?fc}vPlV27F*aWJJa+&D z8oaHUW-Rr4ty?^a;lTW*mv*x>CYfk46lmVj@4WlJe*V5XnePfI)n%3&e{8ina{j)! z!@6D1MPB?@ntZA#tl**=;+pWKLsI16xLqtB`$HPaN-ptKOX_~RW_W!eA-|F~Y%1=;j zJY+AlEtT)!#v#PR$2vB3Ce N@O1TaS?83{1OO14Z2kZM delta 833 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 XcVs19S!c~F$rSFcv((>CUa;lAJP6Ee diff --git a/assets/images/storefront-bg.jpg b/assets/images/storefront-bg.jpg index 1ba57202afbfb33636ab8559fafd608f8412b07e..85f51952cf41778f2636c375a9a166fbfc93a3f9 100644 GIT binary patch literal 12895 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 literal 16420 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

    _}k@?@7GT}E>E1w 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

    -?u*taeXs`DRG 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�};&5&1WJAIyaZl9R%uGu}@qs6%RBWqhZ{`kzS8J{LzYQt_OemI`^bPs6cl=NP!~cl)Hw)jqx#FwE*!}znpB_2?^pX1O^z`_NPrpv> z>BP&=&-inpJc-NWnbW!AlTo~&^M$oGPJ;Phe0?`_Q^dh0mWwl=46EHi*TVd6GPDSv z8$LU2lUce$3cbP%9AP+9kK5RQPV?E>ux zT%c{tS1FFzSi&NT876%J6qDE)+!;K`xRrA)vDa3!2%NP6Qi4TjQXib=j977+i`u*c z!Y}U;E6@l-o4LT%1n(yCmBgVLwK_jm=ig}jDCb3Rky8cDpq12N?y(fxWQfufQd=)Q z$B)Ge6QU5{(VA^enyCY8KEwbh-4iWGA(`VnQo+EBaC3ZataGEzjkW+gD2ukJ31f$` zxVmJNeJh(Z)L0~@&yzFDH+HZv2^M*@9d0&-D0>+%F8OE1hSJ`X$Q$ z`ak~9e-91iQJ)s(4IKoS06I9!q)mQ5hSft*`y&6#9k<4|m~ohExex(U(nXgA(V_JXUJy0B1u8X<&ZfCwTecDHNV^1gyd~FB5$(4>lmM;GU;xtfEjWJBWrCh=m*@&KHtby1@`DS7?NMIz$&0!R3;H@JxHEIbh z>CH{J6yK|2KighoCy8x=79ez!ls1&>P@^+FVzp?OK@##|3>+%w<`f< z7+K0em>evW0iFgcq%qrFO+l z1wkQLKJ|S82*L&+*6YWZYaH?|+Z@2NQ|VA&AP?AWczz59U?1vc2?tH+=PB6jE=!e1 zL4jIg-or&!c*t6u?)V2iAFIby0MKH62_TLqnCfhyopXRu=`zgty=B8K41COD8t!9m z0`sxH&{~+sh#p!$vUweZb&01sAdL*dY$!utSDW)_X&~RY@}FPlwivV_?>*i+;V z_I7P(vbPNrnhdwjR(3mg+d5JpzJRj3_MYX(%IW|9f8^s2|1W;3k38+fYNHXiRsa}e|*DN>u-3s`oUWAv%#g9Cmf8cn2q*ceOv0L78b$CZ% zLZ_8tdv4!-&;7e^nU)2nLY-HReB`JTr}N6XHr!x;GjnshFwbB`_ymoWri!0nTK3Fk zrZmTD!5!*!=H=yQ&ZieN?YMpTj+^DcY=u^#0ZbD+yJhhid1bfk*)0dm8m(4bmF2MT z(mwHApJ-*qOq`ELS`{a|@JoB)M^1e36E6 zevkk3Bg@k#R3AD14G8}Dg8j16o}J6{N;UX+IHpJXcUBF)hKLH7}t%qRMyFRS(ccE8mp?;M`lj|y0jHM)IFVNGQs4+V?0Sf)pT7zEJoJ|c3=f-UN`f~_>%pp{D7Y6t7= zwAon~Xp7^UnU774BG^gn5KA=XvwXN<@8&lnk!UiC>c~b|09T3XC07Y3>zEA)%52#?*QfFkW(Zo@{Mmq8del3B8 zECWsv2l0$g97@P{4TIia3`554^>rU8jL_m)Oh1f~UdpDaIfy-#=wxyswiBP^ohE{X z5g)hih-{7wh1qNNH$sCfs7+oyvUN6v(fn2P`Xub{94K=~Getp;)eECwLR($NUHA8qJkUShXG z6i8sCY$oFfPjzOZ$p@f`60@ao9vMh=z?3eIM*M4luu;z(fvlrEEONtgx?F^)#=>DX zgVV?kqa=1BOG;zC;csG6`b_D<_dt)hr|czKZhNqdec8kqdVh^?BIP5-djKcD2D5~6 zj!Xc)EV)c@6%yFX3|_xjVa#Fi0EDrzWCN_M2S*WDyM59Sp5$tDU3!XO57O5c}}UWMd|*<{IO7BRh5ex?4apHJy)6>vpxH(8yus0qt5WGPkj0t(0w{`cl8@?ufAp~#_9Y-6YQ?; zDAR<^qI%_Uxaa2Z6>_mG2PzGdVNC!$o*t
    X07;Rk-<(J!>!!gAR2_T4?-e!Jt% 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

    DL zk7$>7F4v7q4yq&Hs7UUKH90%l4j6H~50|Ne>&kp%s4$RxgduV+A&<0z?ecsmh|7-!Fne!#! z&xtkAwgnX{uP}?bo*^59OJ2yuY#p^TCyXj$0nH18jSHhTvhLWmD=800p(c9JwHW5w*X%0wCW`!MPFshow5)mcn& zTKM~13?QzfSoMMxD5t#cttuM`-q%MONNhm38VwRB6CkD7!@F&5a79O&0Oj|&=p!Z7 z-|_pfOtJ_$*=K);FqVUOuJ3hJs&3Wun#~>bT$U68G%J@Ffa5+LwIt~c^3v2j>HTDp z8dg_017ileCKGnnb<1)xPF9&+cDbio-P`!j|G`hbs*^oSPWk&aK0s^ZX$CqnZ4Ya?k*EetcEa|Q38Ji)5GlPdcr=r z@thREM`hCOW0o4sLq!}L$~_M=KXBVyNZ?$Pm8${R`Vvz1!vbug_I2^ALn}ALlO*uW zG;ywxG{;AEo)z!FsV+>h6@Ai{z>0Oa)QU2YbM7=_Oh%nP*UOR~p0E5QT{I?p9Su%9 zJJBlf;VfNs*Fvz`uhOwLtL(p>E>4_=7=3K|{(BL^80iAsg|>*RudaXoHHv^wS6Pp-OD7L4IXvwWrhJk75JwNaSYE`PGFB%a{%G) zp?3awonLRK^nN$5)C^hBrtXmgj1SOBd7Zdzb|1;}Gt)^kzSj3mKWpYx2s`#L3O zg>WO8GFfb02&UD6xLYVxr4N6u@7c2%jX~|#?f~8Oin@=T+@3wM16cKJ*|5B8vV+$6 zKy5t5Cp?ZX$=7drKfdAX_kYaG@jb_}lL?pc$acB#QXlxmFJJiO_dvxRa8dl^vkSlb zTd(=#Y4Y}|czRX5dp_6-zI!fy`VOMt?FO$_tQSY{-L3fU0A}!Zhll4Sk$#N3Tlx+5 z2)^Io!vn+>j>Q&Uj#_H^VAjDrChunPLP6J|4wwTjS9tvje*Bcw9{khqihuC|KCFQI z16Ix}%m#%8mkHwtVg{pG;}xM3E90;8%2A3#~YU-UHxI)(xm%&wChgOL|+h8>*h-^h3)XTf8A#gjQKoQ}Qd)sr?FkVmGbb}(js}DU z!@z_`e+52>+3K|Q{ltCR646)#G}N7BtA({#neAPZ*-?HrklkZA<3IQNzx5SN-E2#v z5~^On^GkeW3JS`dJVS#+6sj#OF@1YWL&??J9hCKc14IXKd4FBy>tR;0n;y9;x&rz<2+uPt3g0)6jR-L$;j&F|@)tKz04>*_HAz$<)&ZoTFP8q}%&$|ZDS=PIW_k^wt% z3VaMm8Wg264&`ub(!}g~J~9U}N&)pzM9Ksvb8D87aOv?nN4AuqRti+DWmN-3l-G{> zxob>*huAt3<=LUQ$O93~regqlL`gWaMnCoa-jfQ`}WgvBk(I+$?zh$M#JIm?;A&Lbi%C3WU zu+_4~)aX4SC5ITQ)4kE80sstqtx@$;{*|^5P#ttRmTPE85?cXou4CJ$%$On)IGUM< z8d6uROt@^8v?ggxaklKVa8?4y`)4PjoD?Vu_eEv50+kf-7_~g|E;(Lm_W9j$L#d8F|dAT!u4+9=EcuY7b-W_lQZpS^N z@R8t}#mfzzvN}`mI>VJ|b}6{j$}5A~qzb5ZZ=Xd!h^yAXe84{H z4*uEw;@NgUY<`TT(ftd2~gC4=qt0y|ln!8e=6#W-)fOIgPcN%iqIo zX2i;$49XQ%QfKcF8a;>vs-B1HHqY7KHowZuW3u~VcwzwrSh1t^SLBlH>|vNmR?bja zmms4V--nb>wD-Uu!`Q+|GKx%Ets+kk^;<=r;2s`U`#FlD*jr#RqS;Z(Vy7~EAanE( zrUu8%HS|b0QbwLTiz%!{tW_wMFAzhRDqEBHNrS>bMWE!`SpQgIKoMrFWe|#=i2+D= z`D_h(=K;oDdQi!MTtau;bf(x{W?I24q=&7w&P7Wfp_|na4fbk*z?PpD#R7}9n#Jde z!s*HIIzUBoREJe+MAwDAnRzO%x47`|VAKXz3FkbkbLZQcmz3Ep%0akM){P~Oo^1RUwwEoV%o)oD#| zd25G#gUoV9=l4v?k0)f|eEuyYX{~eUJJl|a1*AHLLAmnH&oruS;oVtGw{-(ks8dym ztLf>QpaSsl>E;QiGU+^~!ec?o15_O7gt0`%awi@WAScg6pT|s4=-*c7K%$2*ZHc^o zw@htUQwx3#g}`^sU`B~8Uy{;@SZ;5u?K^8HH#TgGhJkWurFOJ~@zPGq*{^kQ*xcO|scaNxyRFF;F_Z29RVUmkcu3wg*9wk|$LVG+=7w$p$L` zT5?l5*RZ$ezN5@qu-O8d+tNKd#)yQri9dO1bE-E>l04fLavmu(l}jaVGXt*5z(D#^ zrjRY1S7&ajQxDl;-n@DJ6Fz(O318Zdh&g!oVdvZLzh=&zLGt=> z@ccY^_r72TpFF|e_%XbC2p%6^k-2fZ-Pmeyn+NX;jtbtbP`alrxK4;`@UGz9g#8wb zf>#4#hkO@|9eBC}pxYk2dk^2g*VlDhfU=pUTNOLSbLaQ1*oJ%z9v|Vi9+Lt5hu;-{ z{Csy(t%+)Z2E=M)bO}47g0X<%h3u~*wOKv0o&>pUqlne&n^ z%5o&>dm*H;f0U~rG$0^6oP>KkQmrJqw|1>f7(?t~=3&m|;blo+hCO(HXaTpN>s5=H z3j{7F&{{RQm0_hzWwAmnxfj!2$eU#@Q=W>m&q}ELjs}V{@|gpUz!X0ylHxz}`#<_> zfx$I1S8Rl{g)PG=(Z~f8fvaZv3KcdkfVhBOI7`TFxqrs=#)$) zy0%8^a-$D1VX6lzIsc`$uMTCooXhR8ST~`MD;83M*dHe%hZ=C7^m{2`iv_ne-n*j*Z$$FDqCeY%n5D z=hHbRAi-+OaKb#*!0nSU^O^HGQwBPFixDYSZ1hdvK_a~#kC`w= zt7mvfe_s$KaFm<@w7!dOMlh+6y}(U&5)Js|TG-Z&riwO+Jk|P%CkE9urZX}Qn7ob^ zv6gTGbfmUH8Q@)@im7`W+Lyj(Wrj(%+DwK9gT0?NXm&`)=Cb4kmMTJ11*xykZc7FY zbVxlxb);~m7+g~Kd^a~?h(+u0cmkMO7UULq9?WrPQe9uxbd?5+$%eiGkX0rZ&z_RC z0RiF?*L;Xbrp3@i$7)y{N6_Da1?anlc%_3pvXZb`NY-bgJCtxTopH55FRy!(ZY=s< z^t~eoS)dl;k)yTe{PweU|XjzWDdPFMj<83DwMy&r+ZJRNh3a|Q*k?pANJg4bR4oHnzMhw_Z5rja%K=mn^ncOw4s`e0F)u zC;7l9+XIi=h3jQwyADQ%a*taUD$ip@G=TC~1?89_wa8$Qm$5RkE*gPP5URXb4 zwf;Wppv1{DTh5M|E@EoI3Pne>DGZ^%Yl=Bs?C^~BcNGWKf2(G=L1<$LH#|<0yhcw_ zrB4-PtD_9`<;*n&3PvSWNuHBqgH^uJZ8?grfyr$QGSm7R_t&KPd89ki%lCq?zRsF7 z8`x$|mBq27qsNe2e?^idd2yCItisXPWShmrZ1+%(Shdb|2ZS$G>;*3cd&FvM9rj(% z@N+I1|LNcV@mJOIIb+7W#%>n<_iBA2gkBQ@Yqbi%t5%!@i^eQ&mFyARA`JMc7STc9 zjmch>kSy3yWHnq|9+qAk&7l8l{z-ZGq5;jp%iY!O@LEIwA|V7h4wHI`|s&U`~Oz zzVb+g$cy;!48KX4k%QLJ^f&IPbqeLPj6w8MmE12?mzG7+-_K#+F&2FQiT2ey>EQKc z`VIOIMMSu?)@$xOAiPMq_zIM-ZI^!ri0Wa~i6Hc+dxs$aXse$YD+ zfjX7AH8*aG^*UDW2cpo{6Ys#q{_4 zssmQE3p%$Jcq5j%jmKG#{aJG55r#jH`g-mqYe1w%#%DH2V?jI(HqAlI1w3chLuJ5a)C`r3NZIz4| zcWM0wF+%2oRS?z*WtHh9>zPhH4{d96G^?g#nRlu`NJ&p%_q;s7YJ4 zWLaE|N{H6;WI~kUA(&LOgj8U0ViM81H@)8spUT3Dxk#7Q->x-fax@c|>Z=2b$#gH0 z4ySMBRZ?yMh|Gc<5H8z2*e5VR+BTVay)xrtPguA=x z>}jxeVk1uS$o0DCr#>fYJG7maVD(8Z5LC#+pKi_Oks;9LnrDzze#UI6D1-`U(R6*b zwp<5uSL^F^ z*zyK<`noHK*aRY#1ts8)$!BAF7Ka@F%4at#iCt@{<$YYa8h*_Mh$Y{qAX}EuQ4UD< zsTy1j|H+(rD7brVBTK1elsYxkfLhb@%Y)b;WWl%54*WXOuJOw}gY~y-;;FyqA9Q#4c7oO+A zH!sDn-%qYU9B@0JY&V;E`{q_Hon*^pmh!S{_+~I}aIL$mX6``+@CZk;I&Iv6<^>*~ z;QDIS623_uBlr)#E&lyy_;x}ZHXd8R)ad_?m2sdBQK{UCjARguN-lXJM&22=P4^l) z!)!5U`+(aeIIhcObOQ!t7$fQCi09ujbuA7Vdo0K3X8ySY*&F1`-GwxdV%(CkC)*K> zS|CuSeo`8FCT;`MXyX{`k90p}<-E;pb{~cud1oKG?64p}y3)-kmI}BQ@;xG0b6gOlrA~I;PM-yi6@83idyun6cEC&D4_2Ssc^wmGGCm zS=POFqGSW(GoWDnCw}iQK_T>rgq(nA%hG6ivC+LnOE@dX%Eb_M+=bJ()pm-T13wV> ztH~|)-gz0$bdyGTZCCApmWx8c45z%EI3ASC=SYeYOLKBeld*!C7=-3IlN6CYMhv;# z=k>_2XQQ!N0EwB)lmiA>dijcG!DL9|;86k6-5eaQslAUCnMSnkd0NL`Zkqx?9%ApN z6nK50vm*VTUN>vt1~y1OSNJfoF?D78-GJ4kfD9DmnG-_$%jgcaOK{JY!HVXn6kF@X z$h81z&q&K@!huqV4JdP{4XoZ!nooN@U>zGJi)8;kC}kNIlc;tm^bT9vz8A!HHb15J zCXwcTHUng45m|T*;QjrwWA5l(3#C_Gm{kjfbP%I~jKxckEe{q5j6@)D(2U`|zN1I- z%po)z_+?7k(esFQ@HL0t)$%My_8L70!8!)$p!rm}17<)&`8h9knUp-!*g{>G3nZw9 z(PZY5kt-8PPMOu~p{I(xDLOp4oNumr$vVTL8 zwS3A%i#1I;j$-t3>%2(l&Q54h$-&y%y6RhLrVW)wyA(cnBoH#j{LHiODTV4XZ~MEpNv&AxH;-7BAw#+5zRb6avIxP-H&v zTfg(K67e-Zef}r>{QcLw%)^LvUHQ}RC;#8?CqJKbC_HHrxxJ8u|C)}i zJz`|}7%R|zqrLvc2Kc>uX+JHpa+1(AI;jm68HQs`59tl3pL+`m|o55teh~}yl9P9O9 zEK{dgEMX)XFdi~iq?yAeF3f1FYtd1Sq;lIc1PE6x;gLbLu}n-IOBj%?T5ip9d_9sy zl=W+vZPGbuvX0wq`KZzw_E<)rZqDd6wkE?J|MB1Z@~asE$Uvq|W)wqFMr{|f(t;~% zNje447D8Rc)4`46CF)kP-vnLEU}Tcl?7({>UWO z6EbC-vEEzTq;zbYvJ5Q`h#V~s?s@mNK&t^_2NIG!f*atNe7IDX3&!x(I*$NzV{{1| zWgw!ev57j$<{2ZMYu`qo3KFZET}>MOI=Pm){CNS)Q{+b3&08nSbYLhTV%d@X9Xa6Z zMq_uYne7a{&1(zS=SUgCC<7~{I!W}m z*x_j4t2)Gtll!K9Cs7vfa<0=GWU%Oh?rln#=WK6Tv_VA~U|coBy5^-4iD?4|4osm= z(o@3SCVlX$OuC-^UWflKAiIg#?`_b__jx=Ba{W0-5R31|RaL4}F=HZtpx<|3vx4K- zYssolhBY2Wv|yXybce~?4W4t%SA+aXoDxH`BWo&2hQ`5-SM0&stN`X30iO&e#c0sh zAeZd(l_?J^%I`O;CJ>Vd3Qb7ICW^`9E5w{ue~(m1-lcEAUl)|I-1z+?)+Q%`Wu=zN zSvb{hb|2*F;d6fUq@Tc`?}2_fXfBG z+u_{;Mq5FSVBeS7%QYB}!FWjCAH@rB3>XhEuCNDOFLz-0#oOR-esYEV2ifS(Kfb~H z2{lcmv$lgdfF5~Y4;ySF^mEeDJ}$)^Y}X~ZuYzMSvBRWsnB1&QWD;rt!pjR>KLigi z#r63P5VzZ%B^`S(Zpr1P1L=dj6|u|Fbk=>HehtR4LhNU-6^uE!%sWGtvzbOnmTa(e zuBdc_Rkt;lWYq4;-DwFLN=3m)yv>v{SJ;N$({0*CMhCSkvm~d{G=!-5cPnq$dYR zEx15mm3f1-S&7xPO$UR~ra7K#9#lsl6r>;dJm;@D+lJpSnl02K6?%WVeO2eU7TF+q zbf0^%f|2bvU@RewQ{PjBkNH((It|`NHrAh1)R1QlR-in>WC6mU@~}>i9~*1%ZYdnA zV*pEJTLi~BO##etw7AiRn=Hwxo8T46BLN(1r@kV3wwfr6;EK z#OuVVTHvs{7Vv%`Y0}U|e<~)T*K0+sz-%qEpTxZn0r+wZ0@U@5Y$T)LvGu;!La{n2 zmL({V!Z5eKwx##lL&ZVhES}XMW~i1=9pipLs`g7cTplLqtRDtQyx9+ngH7Z->LB!_ zH2`!&w%yK9_@LgRctJ7@q4;nkCdeO-WM4KuVrCLK4xj_EQ(| z0)1UVxy_>1ESWa7=avA$wol7Tkk}%n!Op7wjAgMv|IyYpB(p+||^X4U>S^DW4HMz14FwtrQPj7KzKsO^u-M z((?O)$kcLfyppKq_v{D^kdoRYXJe^#o@Q5!o*YgaG=>jYmEX$%cit7yAXI1P4^kQ= zbY`K~J7(|iSigm_olBXJEb8QxWtaB-RkLt33)=fMwN3nYEMiHrgf-Hy7g>li&XsQv zrO|5Z5Mb52Vdghcthwtr83OAJtC<^XS;5V)dOm8BDswPqq-Cl;K0ekxMfF%>J}0zN zwARqA`D)dylmEOxpxpjECda=gK|uW2luKmywR2jdmu`esRQ)}!*X5wUn6vou^S{fR zPyRX|-v2Rw_}xF@m*4%0*N+=N{`?ajxN^*Aj`_lz#qB+O^Bq*cbpS^&YVtZZc;1<} zolD&~=1xVC`^L*{^89?PJk7!TceU6n*!JMzR$N}7z2096#(<3A-LawyZVMc~Kt01g zmB0Kv3pSQv1U$W6CNmkldVt@4HTZlR{Ig%*`1hZSUl#242pR?oBcLw#cBq7Qxq7Q<~NlOmrZrd_3}wp_qE!k7%JN3^q^X@H&oAmj5}c5 zb7zjC#(=J$oIAJq!mVz+d<28HcJriIq{USI69K}j+zj4>XWEj?Iwb9oKDq&CkJ5>I{H5Kc@ZZ|kuq|zgBm!_%$0Lo z#tmh^7T8N4_{N!7i@K<0Lp8V%-JsHCqcC$qmJAkkKVFKCc8?OCno(xj6AcJEpkAP` zm6&DtYDgVOSOU9Cz8Byd|N8I#=qrWR_k~){#!(L3f|eC<)MTD&0q2_Tbu5FJW(SdE zl;Ch@qb^V_osb7A5SEnz9@Pz@5gQ`i(+$?VVzgw1i7}$a0IJvwk4@-xX(XmW0sjzdkd{ptoa%Q%pt8Jv$c$h54*t27zA<} zlPJq#F|ggTmoYh^OQ8gw>g)jPE`>QkGB69}o|u|SXLY&rs56Rv?oKPnRPB;RpA4yn zH0#x%EK*=6?6{o~_d42g%jhBl52;t{^Vh%E=(-HNR+Eg$NV{nR8GS=fG3_JB(J?Ju zelf{p1vST7Uuv7D^Vc0U&$XZ7$Pt++sO~ff50qa(33U8AS5U~mGx@39EmqV<3B;Jx z6_2_w>3UbC>13H}`*x7JwkXMWDatZHtC?x05NA68m&e64%Oy6pT+t9=t=wr@5>Y$0 zW*J?U-$&A;uPd-#Y`Ht&u9wcL1wnB*u!T^jRlm+S%w;tf!*&9c)S4%iLDrxa;3F1? z8M?*_as|M-{x5#PVO@cElZzWnSp8*m)Y+~$qv_r)VuZXb$$FOEIofXBg|!J3oHHQA2I zd@1G@?6-rL+s5;UgV=+87W=$^=3xfg3&abI_v`*UpeDRb0JtQ4SOorzRy+_5>^<^8TY%gMeS?Av6Hmcs@_GpdtY?sq0} zi$!W2_j9IpUgp7v1D>nck76(wtAAI^)p0Hv@0;m^BYB{_I)qj_{ zj1r<_Dg+M0<;ogppSge|c%9(cwOK41;b>5bEbH@8T`QUHzd%XrLBImzeO`n)l$(?2 zc5jiuIGfE`y}uJACp8=dlyCv=t%dprU8YsB+-=9?*p99%TnxF$H_EaX?|@JqDNAZv z(D5LPy@jH)K!an}$`}ofb1h-ZSrdd0*Y`A4=Q;kh-}|kvXy6x;8^|WM#NyRt&IJT( zHZtXCcPi!`494UZ#{z^)yPPaNa#{LQ3V=oc4USzFD(UJ}S4N?htFx>e7g==+{E5z| zlJduK3>(!~UYh`5N124`6< zS(%-GxT%PW&Brom!^mR5*;PN1{%$0S@Wz`>qGC^9oeIBGgPNp(Jgz9HqjU?tPNmd<%55l1Mip-SL zY{)<)`ZNCf$6QN_*-fjD^n07jtCJy#uCw<5VfWVtfd;4o`y8H`Sf>#syyw-D?tVyn z^4+PmyRSMQcBVH|)(TW$Tkp+&9soWXo>1$YtGu^n4Q(JNLluPG>Fuzts0H{c!8!}= z@Y-_mtYL98tG+OrDYWcA22t}4{AbeG%VQ&)&M0%1t(KvklnkmD^n04CZ~9Z!$Pd9f zvG3JpZWc|Ut+m2t>b-(b-~LN{_V#bFfB%p8^Ot|bpM3Wh?8nZJzj)y3v8cN7;r2c6 zKkU>kc>i5-9L3mzqk=f*(pU!bd9sZpX0RQ}tYp9K+-}ADm*SYkK1-$|mGEtH`(+VF zk=JC-V*3!pGwcQ124rvxxD`wwW@q)mo-iNac7fX!@)EEW*Gur@$K-ckJ#e`N|KZPf z{>3}^&4e4m)YI7W?5QXnqBGx`h4aq)x^6E~Y*B0@xn2g_2y$cDrM63WON@K|a^{?{ z-5Jxxr^PiuvUkCDALQj0AvI;CXpIUD>ur^4&k57 zW&tn7u}$VSsnNzK%k?!Ux3RO26?gU#5KeA$b*LxYCd?@p*-Hq_9!vf@DtNm+@cH!< zUXKShhTr?3Onr8iRa4$Ky#vA+j2dK(W^PChMipZojGAPuzxzHp58^mh*5N_Td8cE- z>>p#^fyjCdFz0NN=g#=~m`vv|mdDTa=eyisDq!A#A%vS3LIZdps#IG{o2r$Z?#oMA zdMW6?aw4{Ih0$j9U*nQvbA1pw~P|Q`DIt{N?>;U~#hM>w!d| zm>juOlH-0p9yzHI%4eik)%WMogK{nXye}(Z!pa_$x^m9tYP`bg_oYZU8Z0XFQF^yr zQ+17rg7L5X-WOk0HT4^I+g2#$8bw)DF?Wzhi6tzU%;gk1*;y=MxCR*oUTQ?t<*6!Z zsD-v0k%NbN%5=jjrCL4%p|*A|Zzx(3vm73~iE@S09= z*Gx|iiltlceN1Bo2{E%N7E(Z>o6Qf;yEy|wdfo0gs&m#QjpeZ@P+<;+C8st4-VHpu zqFlovCrq8kE;H?WpyZ{^K;iYU3E=S)z-qbXk!66e7Fdi1d<;{fr5ng(taWBzZx+!~ z-7F%72A`5{0A&mw*=$(2MAQL~h4CY4Y4+!FM%7r#bADftf$gi@NR>D-ArzV`7E+x% zBEf*1TDnVTe@Izx@mHUdsy77idS(ExZEl&9*A-SzH9$a+SS@vr*pluxs`_ICmypU^ zEC;L|Ogv6<=QRjd_MPCMY}&nkU)#24Mt9P@CtanCf0JaV)q6&nmc^OBN=f@Q7sTl< zyZxkkJ+z6`01D+6_twj)(PlBlD9$1#FtbeytiYmk1{LbPKudhm*Dw5k-yQt4;6 z2VNVn6?G|Ut#hUFuXdkTS=3g{ZE`GzaNp|V^fro@ygS+NE&r^^a}^&bo>!LJ%UlxQ zigw;?@>HO(lA~JL2A7e1a(T^X*Ec-og%P2FA*=C*a5zYq(O2IKH#iX+CFfQ*vPFaG70AVZin9UG!fT{LESOA|lmG$TY z|D?+kmx3rXATXPx@p2|7Ohks{OuP4<<-&e!0d=g&nH~jzyfz9!yaU;ToiXear<4SA<@MFjrZBx4++t#SHf4-|V02S!xJGcq$`p(?m{AR2 zdFeVHjv*il3U35BKmVxIrL>xlh&Nj(Lx=$k86DuPOi!~x9(ZSoq_B}z<6gE&jezyaafrUoizUpU56f@@OK zuCu`FPQBy108EvRyIevVL}9E?x$Mx{FLMKp2K7V~BOy9^A|wUQ97Hw)*e&!rFe~Xn z1OkUROWrqsW1iBj&L)8~^94Ag<<7e0A;5}xQEr^-KeN1EcP*33>2uam=irjc8dyyH zp5g$o*}`@p77(}0y|8*_cg@As2Iq(oukAH;Lm>t(ky(ze0|S~VKj*XLI_P5_)F}_N z&sOb|UvEL3qBW8Uf!njJT0QNH$w5`+R(*|Z;9zl1qBL9?HK1jf1Q`=Z0kT@4xMW4s zMgh(wLlR}zRfQT5rDso8w6O$u&0_&;`--PYvccUc62J46Yk_UW%s;-dqxn$@2`}eGlJ#sHLh{K==qo z3~Ek}y?CArFaTo@;(d@i@B(87aU?I-V!jIExG%Fk2bUE}e{8^Y*}~7o5DusX3iqer z@m29~fu}9_(KY!S;{iSd|Nghn{D(*J^>PsG()rvWOZUWFY+NqK&IHB=HI^|9!0Hqq z*^cIL33x?t*$3N9BEn?*z!v0|DjgkuEko6kC~Le|Ifb3Q)^P$fx&m5VHjB9c;au?+ zTp%~7jAhKRB(|4euA0e8sBs60b1S&O+!_!T^D?ik zT>G({8!7LCSW4(@eFS1~W)KOFx$(vJ37>ASdCV(Gm-nQxFRs4}my$9f88z;WWUSo1 z{MhEb1q8*&l0qXU)Ini@kT!lf+Npib@$#&L0_HpxAndllaB(tiY<~^|gneMT*?FF; z2olo_L?t)2&dU1q|{;q1Q^rH0~4h*l<0 zOE%qFWr#LF4=P#P0PLArK?6d9vA}$+(!HtZy`DFVYSX4_ z#;`buW(gN445sw~D)c>fA2VlA6>J4^Z!0rcXqiVf8`mdU5Ecz_w9QNx=`KJ?<^3dV zcO-qGl9tFmQM7Eqn&@G2rcS`nbwU}k_fs)KRcXE7frSdYL={GdM7EQgYAVcRr{}>` znEkzFc|``4AyAYzA~#Ggw4Jy&`ivyNo&dGv0ATiUIyiJ0tJSKx`9gteW_mfJ z#|!g7#<|%(8m)hNou+*H94IgakotEmxAC8fV#uQC_2cXeB#f4VCKSh-_Fa9f4&>3` zOZx#WiPHDEe!G@{I(R*~_*0pRlc->ZJ|lUWByKf>h^dp>7(8M&n4-F9nW?NW%Mt`9 z2#T0?y%M^9?dK+vtzbrU{ebEUIYoagc^N<||ARtoTTRIv%&c*JmvXsWcGO~Ke6-XD zB+es)QB>a~T^6KeT?emX@@&wcAoTv5)DKwhK#M!927t_<*88P`0j;k9bZnG>8dejC zffq8tO~&-ScsRc9yDckS>!x(g()QPi|Mu#$&J~lpdyiqs7RRcFb0;Q*3h&pE%pPQ@U3UGeI8MYcq>2nKpC zSEst^zS)3^E*4vEj8F34{Piz+dH>J(#qC%8;@j`JJPv;R zqo1(l6YrmY$uZwEwso#;lc#I&5PY2O&&l^yj3;>6gYRy|G2!!Ta2&Cs8RIr#Yf;ba0CrpvL#)|z!rqeAKJx}l3%WjH z0s8$O@PCXXFM~0X$l}OD#xfP1ZpDpaZcx|gjyj{=Xh~>8jjH9evy?oun0vvqJtyjzOV{j*p>;K#Z~Q*G>goDJIa>#&HT>3-@C*xbXy z+(I1#M4MI-WcwTRJ$<3mQE7n8aDkip6_oi=RQpXtx>AOjFtS9FtT+zgje}tH?Ud>^ zr;P(Pme2qtWhR`3>Zds%5YUUD+!@!M&2xPRmfc+x%+;Tt$dP$^U3m8~1tGA-3YZ7X z9@uT;t_cM?hJM`KnZh4^HA_16nW{IafWqufgYNWo9U+DE$4#pXL{?j5Sk0p7E4TAT zos`qRkhz09zn#3}@Xk1C^($MOxM)OO+tj+m+^o-GQqw`8j6J$g+w9`y_NR=jY{yc< z-TRcIMi@I;L^@!VaVn7nv#TVCEC8D9}&0&Zi?{3S4EHd5i^Wr_5ri8Kaz(W!A9(G6mTIsxfVUojK_I8UHCy z%cMt0EO)4w^bTff*&#*n<=kR>t~+$*CPf8!&3XlWf3Y*Y*Tl-Z==|hy^m&Yb@6>hp87Pqt69b z=yiRdXWdC=t-aSB_deg=qda~l<$fH)1|F1$DfzGfxihJ4I)j7VOtL%=G)@saL+973 z&xSHLUpbpr*ZVT;I`Gi*vYL|#24(y?<7{EWyQ~F3L$&FX?%1`o+88!7I|+-V2#WM5 znzdlp6oTh-^*X1szLI{I1{UQqS`q|sEP%Q-D+eSp2-SdO18IE+LoD4a-7-qRPBn(| zs;pj5j0W9MaT??mBU?2!;K#~2)|Y3`=%ngUjjP^XHuk=Lc)Y&l0SX)SLgoArFAeUf_;L8jA!K*9p-yi%xezWr*yi8uU;5*<$t0h~JdBB)(nXnyj zSwZ##Qw@#o6e2^Aw7AvAYDaLHG~ggJ*~UGykd2mOvd3*XJq`+1nNV<0Vs>Vdvonz9 zGJ9Fu9>uZ2ZPim&!9+0^v#Wb9z$K_=j?2yZAQP%TlW^OL+Xly_8O3|6vDmF!5XXgw zdf=0M%@^YppXVb#xxD4CJ-p#3pPTbjKxu9_kD`W!L&T)S|D`BT+@EN zY5>DPSz^SQVtI7e?3j;W&V|#eh-sSr2@^4fN1&KMi;&93FF@4kw`)Yeazd9YH_gVW*(~bYni8y=zAfV6vxI$ z=%4CzdV5kbooz9_4o5XU?j$<$BpGbL;jB-pHpv(=xtzLlVN8LnelO*$7@?K{<)Pfh zu4TsnctLGD!u31=s}FQ(DTxKym&H}scjv5*Y6b`*j>$vGO9mYV z9PRsRFqi_nRaVzn>N-PMWPm`D;uo5soCfI{Xp|v48BbIyOg7#0!8*34%R;y=bYm}p zuyA&u%GklKxyti-tr5EZ3}#T{*4WiD(P6B*8HX&y7qp9EXI>70$~Kl!9a7og10MeliyEKycF=?}DnVETzi z=3%jNR>{Bd%bkDoR{S!S zY`*R;rZs_xj*2x=piMFUr- z213+qxT=9#O5PxI-htrUsd+5B7@)kL?NpP%n34&KQomBuO1~eIcF#|2eyJW+#aUK@ zGLx|7!v&i*2uqYnHM@p&F4;0I86|SL)Ner`>1Y!!4h3eTmdctNTVT31Y zLH2-)2?NL9{mY!fMz*aNp7fWM986AtRDjWPOt8uV{3ms8WSt!8Ku_$4EUw+2--`f^ zbxaAA*4)H>j%tlSXR{l!qt}mT?w$pnJt!au>L61Je)JqNum3BSl#bOJx|Y}aG0d9Y zFEj-71g;Q3sx(m5+v#9>t3T|Hwlfr7NPDj9>(>EZ59Rf6fCE0sT_x?CE)O*6#B^Dz zTm6bnJMWttT;u|v-FzQYfGq<+9s8M6211x?V;=_s77)hDN)lMB@mD!c`uU=ZOe1#v zo@(60R$6DsZI(kBT>^Kw-1f|)d(X}?=2+{s*q6XVqf_!hQp=~uQ>^t2x9QSvgP;Fq zWHQ1BKSH+QF^REQL145wQfCpi?Xxq4dAc?RkSLxao4p_H50fOj&~k<*%tn3CeKVDz~F?Eoy}6?|$;>M&+=XyAwCQd*-`1Oi&BSd*Kk z86*{F=Uz=ksuwUiBB47dJ~FPSUU4>{q2u#e`zP5_Gj2ha&LNt0FGYOlxzfK3Oz!Vz zHMj#C$~g^ou90OCvZHA}=ySoMmkeO%q23Mi{PtPpssmKZG-x!K-13B0b;2BqwF z=wfTX3qle|-mdw+ynwT7pps%v7~_F2fB!$r_3fwJe)*61^B-8k55HhW@X70qw{I@+ z^32%h-NBIo^MGTn0KbFF7HlKA6wITz?X9sIJUj#+j>-EOyu=;Qy_>-|6W$*%-WAv9 zAa=M`FlJDDaAfh_6MWda512}3qj}AC4YaiP{tj8N>Gn)6~ zj0313bSxT#%V5+UpvGUhzxbtk`HQ-!n>W~hpAGv_oY{MC4KSrs(Z>_rlZqlVl8p4|tC|N-_X*sW| z9=+E7Pmd2o^`aq+7Hue;>#jc606pv4|AXKE@+;M)6*Hn`MTVD?S(1)Yc?z|}ZKNe6 zGGLbt-*6i{q*WIC;hkTtqS+P?X!hKxWhx`mdbxT9mgy1cj4t#I zT>#c`N@L~%H=&tg4749&#{?LaQ-}jZcPK13@aUi-#`-&q;?59YLLgK7=wP(9`I61K zOQ>qgvfmRRbN~s%XnED!sHJT&8(3|1JHv8{D~Byw|EG`rX`A$n*7D;v3^27b7$hVsykvom@AA%m(bn#wXB#FJWXh zJILteQc_ld00d$btzm4i*l$HtNJ1%D^~p4ali5?V!w!_2F=dc3*8C#OI3_bl3@p;R z4pR;=fYfgW)Y=aTB0cV8P$mHkw@L?-o%U-*Ty&-&lB%l#kuEFNmNTF-2|JfEwNGN> z1)!VF)^WJ|t=QOBHmq;T7_gph0?3tX3Sed|bo4_)9LDaY>i#M_zGXRDTP=0f0!r$7RxRDoF?P3FrV-j%tg zUN!C+r`{>?`-iKNPj&w~BEMzGcl_oT{}zAx z{?B+n4<5F`mp^*q@gd>)doFQdun`p;`;FtaGj9iDBy(3BLNYjBiq{#$V((rmcsK9T z(w8XS?ZtZ_Gnnt;@do1=9x7qRNA_`M@v_1DE4+Jwy1^I$M=%S<7JLA18`KpZAK=S} z;InPx_a85OaSZ;0U*7mP-cSDGfR|-@as##j4+EY9xwZoX6F%MEesmvw%nO$o60294 z3PSt3MY4?xV{GIiNu;tbM$UVSse4M@0b$mp<|I0(o?|iolj{2627w(QaU9I~!qE|2 zVHu$)s!T5SA=9=9Ib}D~wgn?u8Qp6Tpr2updX8IfKP^u)$&*YJm@?hU!oM&A?~~B= zs?7|d4NUb3BD^U>xd9Q2brS?!?yLG+2|>Xe_S`?27&a?jKxMaFAX4RbVhM|**-uye z0U4$ByV_?0J!gg}>rxz_N*hD2qay7jS?$43K>@Lo>#gzozx%~k&Hw^J&jHnlla`Lg zTCv=TgluIdZHLrguH`uXP|)auxTKS%wM%Vq_Jbge(eu#yjfw%8t=|R*GUw6c@Q1Ht zrV2zB%SeVg-JZoI2O$AD0XNlRITLsWLq?6C8NJAJJcPiQvR+inmpOa;4l1dfZqIM~ zQ1)7kpE}FS;y9*EK-~JDwB?Px%h0^eI?Ji`<|I8jVC4(ySXIZ^u?DEdP;EItxp^(_ zluDU1X%c9JN5B_>QE&!RAW2g(!Rn)Gohf;7qR0(Ow)(OdkM-JsNV#~bbH{Kn33l_S zvQXF#vi92DIvbnduCoGp?hYAiT5e3Fn}{=t`mJz#>8=~}`UuM{l%uTNM%QPSRJa{U zBL|stO_%NTpdVZe$&2sJf4As)wqJzi=k)8%qh5$*qIGtkb+=Yd0k|1*`HS?2tVv)a z$sF2_0b|eZi=M_f)pp{Ncv6FTiW89Yt}^qTuIq34a#CUIDrdA=+w3z#rbbjYHPi+nfX^;oz4{Svf9oF* z-~ODR{qq0EPv8HP$P1sndCjMvJyOSeHi`?$7FV)hpEqvL2iHnwC0ky}oWwrZxU%m% zuQPaD(yQm^q86+0{jKZiZ~fw#f9J#Gr^mepaqcDoE4W5*6x_O>F`5*C3viuD z-hy!?Ia}GGYq9H@_S7jb)(RHxCRu^>M=+*E^9-nQsPj9a4wwhrfSZ+|4I5YMytTUV zu^sc?R=&FWlq;U2Swa%V0v+_T?11Y5mpvJKFb+u8_KpRH_hj5)ybRvtEB@BwXZ*q2 zPxSGG`%Q!eR^ntRaNa_G7( zFu0h+8B2y59W7C7UMZh2n^)Ppfqi(aWd;6$3~8HBy2(gNsVR;^t4U}BE4rz-oF zJ9~NC_=Dg3@~Z-eNNYRg4x!TB5*&zhXj-&<{2`3!b7?3cMD0cVXHKTdN1(wi*b8T3 zY%4DB%hd@P9@KndTY7&49EIEDz7)tn!%zNP^@HJcg;8b&kAX*QxgtBP9s^(q7%G%n zEn{7nF$Ki30iX;Syhe*tU6KP#XGba>yegKVXuvkjkfp2!ufbiYzHV9kX88J=F_@%* z)XWA^McKal{?YrEz^N9q42VQz14)4y?AR$X4%HbYj?k%-S%=#tcMY2Urc;8uK1cw~ z9YRs3Tx^WVx6F-Cnd!p-VFCE)zvmGe_)RFYHWpI$?w8g2w4CqE8Z|eW4cg?Y8(w>t zq}S8ohBwJ*hA(HIyNvZat!rRSyM}OGe~Fm*5zQb%w%ic|nL(_UcXX&I2O7-$RVGS+ zJvel&9p+>@Wl!ylA4LZG4%UE-fN_tk=6c^FB=8V@h(YBPP)Y&PUccndiOx)^4nR`E z4jR|z(Ym|#tr>0v?iT1%WX77NSViTrX8-PH(;ZW6>8Ue7n3P^pb2-D2V38FrQP1jY z$}>S1psoPY@398ZQljrNS7QbNX7n;7JY9gUC`CGuOfcYO^a}GNcUr7%U0mYg%MdgZ z+jWP-f#a!`KFytT5Du=YC8L;9My`WFXa1&Qc1l2X)(V0@PHy1k1G-RU=UmmA>V4?_ z={X*>57l{weOx|3Y|r}Gs0la?w+q`-6H;He4&ab}vBfg%$;qmnYUw-ig zm$CEm@@qyj1#^-lH7EPajhJ<33dew|1vU=mKDmy;t7mvvAmiOpeAwZV!G|OGelLy* zaSP(P-~(*$V9O$7aJ(ap4nkLlC9--14Zy`>Z2WFP20Gn?{BoJ7i@E~ zvGQWaVr0gW3oet3eNOg(W3`f@g$7mUDrkC6crMtB*dbo--y=KF^-tN1FlabZk27R&T>ec-c)H+-_a;xPsTi`6liX=bpE!8RTkxiQxDJD6n5 z27`=MXFp<+bKS${LgJ`!EbCCV=$Z!|T)#7q8*}b(7yL3)gB=m$J{@ zBt|lFkl74jGRCUuPsqq6GltAu^JBfY05+K6Vl8=WOGaCjVSO4?LzMOLBb6mxuz;Wp z21OS1c7rgtQ|PG-wPpjt=2eOHEj5cLPZd%mO<7hrqm5(+WoCA`;u7Vtb~|wC?n14W zHHt^vm9lPYHbb}(mALhLvxYI7ZcC1iuYevrSuZGj`<6+^MkD)z0CrWtDC3N|beMz&cT>aNKh)N=uO{ zP)5C3=z89kOW-=A%j`*pB<(Vggd`q8V7uA&m8TH+_kg zAsX9QeT-2u=qQZwY1XfSENdGDF;utXq0TXVgk5#3Uhi6BRj5gfAU#qA8c3UrIVb}Z zc-^UFR+1=Vh6^=MS(+0cL>yF<$6^>D ziZ(_O6PHpHP$6ekbM^I1KmSa6*nIT+eLYWI$4UR5WQ=yPTwv{3`=>z|NX6L%29jbu zxH~SxkI%!ncChFkN*PVz?y}C}_h5ua#gJ{JWuUWU1eTKVDk@`;b+P)(wDmQDbST{B zNZ9dDlA*|iShaL9NU&=2cI+HW_0i$*l9Uz=)&e+#t#ClDzb!wsyv(?o`GZ7}A{n|D zWP`j~K+yqJsHR>DfR!N?bAi_ZX}}Ojqt>EkGl$IHk9H@7wLiJs?~OtVWt%$dTJ(G< zCla;PS$=BOm@RQ?H|SRL^a>THqo9x8o+69he(`sB^~K+2|MkD%XW#u1@8ccUx5r24 z(YU=(^^UA!j6qf~=j1v!IChF6H^}Wm=F@$Dj-9&Q0p9gUE5LUk1Y}&2fV$&hY1tNj;1)^`U2zS&hBkvQ&mCdrw%9sZ?geh!o?g)BOxnz zD7aW0P{EQ6j`bU^sEJYc+Q2|HhF!O~nBCZexDB|`!PdkMxz`=U?GT0fU#o2cGT)j&mAZyzmSoo~R3bRk zzChn0f1O#3m0`$=beKTQS~avgtn9*K8L%vcO~il^3kW8e8!-mCe&ZZtf!IN8J>Z(H z?pY>8 zOAj;ewLRxN@3;5Mv)23N|3639S-^15eeb=m>-yE4pxdg7ROF20d-m+1Qo3#T?z6B}k;K2vo!55U%=Ec>IbC9B@*(5vC z#PL5YS*18yDTac6vwbv^cba@vWT*SlswLV={ha*E$#V4Rg1ezjw9~wh!iSutqI!Blf`J?`*qH06NOJmm;L6c|{){GbW+ZDV z@0u15RD1jQNNbbPoc`WXv7uv&q3dUhyYcVK4op12$>yz*)VN&Z2C*2@sqv8GXKDYt zijFK?#I<9${I0U^tpln5-A>&~okW=?-0Fk8-8cHw|Gni?^T2(w@8I62_5SD9dE^qE zhf3_E&i?nELOX`X$bL0pAyFjeq|NY|sYYnnBl=J`ROw?VHm%u0LANp_c zo=yk7jUfN;$2?}&Y5(sR|9`E4M#X`D7QQYasPvR=p8nwpUbRRz&WzD@JXhN7e`?J` z^L0v!rI#0D-UVwFk2%vk^R-_+C3<;fyA{El|CZe7os!-^8yit8mE=k#If zoORi3607~}yD`$dJk|X5LnsxK=u#?;@ALKqvDSmf|9$m@t8Q#s;n4ib?_%7_=2V1` zh={zA5$n*$2UFi}@|*kk5EOsu2d9lw7;Wyu?hawwfB)vuv&}6HjfhxXaL3+LDF3fT zjK!LBkgFw%e_kXmEIKu_xC@Ah1!|DvnXThLJQxxsj*jhkSFa{5hR((X(y-2KU`QLf z`uaau7Cp$sMqEzl#@3j3;Fl)qeI_W3j2}J>XHybrdQ)oA^Ij|02utL348=*WQkIRl zG0CeJy3OkmC*%l$!i-d&+y6ZY@23yP16Eg838Ra^S~uFYz~y82YfRHD1Javxs%4s4SGzr9)6c;%n-)KvT=Nm?awG-adV2 zstySS1%=V$&0E9HxMe(sh}W@&8g$+yBaO3uiQ@RT$Jrl?4TIlb?l+5A4&e9MnoSv(;DrG~w{QB{cnLX1& zO@$>T*R#5>*s8!5v|Fr-Jg{4pZq^IY2gxjiwb)$2?~DZEgP;|S`yHWHOb59o_!M?yiXkGJcGw8MLzxf z`E$8-Zs|w-=FZNJ(fRl!=O3Qo&iQzusu4a43W`0Hl#~rAfwmsM`vv3M*?aZA31@JU z!(%8#{?Who-vJ!;iH+f`CJ}dZb#%_OUg9es-$$Is?v~}=E2B1}RE#)1JrT%i0Z(q% zU-%fG>>W;a+T)QTt1oSyh%(n{@85!n&f@s;-yd4b7b@o*I?$e+_F1};j3IieCP~W2 zXQJQZ&M$v5Qsv%lQ~F3ld=!qd^v19=I(nLNYnsf`9xn=f=WVMAE3LWu6_F{VtrW|V zO4r{5#espRy`IMzdIfE5dBV2$m)g?x8DV5>dvib2*VEN59jx7Iw{HqhA9)x@TEi0Q zc6WEHH))?nSS@D)G78VsWP*hmE#cv^~ZjlRa`uiJP6ZmR-wMduh&~ZRmM{&cNm6;s2I= z^X!M*+~qS1Z*qC1;kV{`^Uk+k5`8#KZ@W~|EB&YQ8ljA|K6ay9SfM-F>lYXLJ2)@e zA(3CRu7{S@Z?4QQgd^GGNk+zn+|oTzI}6pTs(uT2zi=AgpVx#FRG`jBy%(qXNh|yV zAIvGPUAso;V%4`dd@jGLd}Gvm zON=x#CLk)>L?Vun68y<%(xR{0whs?8qq^0NbzG>xJB|5n{4FH3kkE=&6)}GlrMG@W z!BNhyUQu3=#&;>QPM2YJ$_9!pY2b|0o0-xst)`HqVbA3n$F`&}fp>En+uA5oNCdou z!}uPkHF%_jszq5t&*_uFX?xBn9Y5{);~23Uv#o~iQVp}+-PX|oH^bEko3dFiN4U0U zdwaWl{0YTB1H=BvRrWUb?bl27*KAqlFX5Sc^%9+(Ob$$t)&}(WINnE3riJjOby>ZM zHibea%wcv5wla*iFVt@L6kHM$>l5m_uX{>UqW*rjohZZU(-!ydKeZ_Sitds4C(Co` zGnuZQ9;^glIC@rA4xDp1vqT++v`9*VsyO4P@Lc$`oL}M?aei#30-t;y=gb&(2o9@> zlT+l_PR-a=zOeA~cgWSv?8M&FF@>8V5^l;dV1Q$=NwL zwo*u|m=&}g%f-2+I=0qjLxcj-8nz#{q1{3#*wU6aLUx-IomMMhMwnR}Z>!mr>N-1* z*4Nit-YPf=jrb|+q2l6Vp9SZXsm7b6u4o2$z!!jJ9In&$L6DGFMY` zGddOp)hpymk)03AJeM2k;D&1J{ApxwKp{>wh27U}>dm|7x#&ICdXvAV0Z_KO^73OE zpGQX98Ag-!tVDr0eWxS*)l2(Qw!dd_20vj_+T^+?-H{LPAj2L>r4hiUjjSUS4u$v*+FZ_f$euo|{?PYDun)WdCLB}Us<79GQ3W&c7 zoCeI}(BKi2lZ$W;zZOXCSWhKpoHu>bX!|(q#bsUXEoZq6XF?8UtpE-mK8PdvlOEs< z)J8wk_`N{)k59oQL$k{*wHq#fsphv5HSE;Ni<%kia)4w%(yT-9{(8XrAKsn3nxn+Fp`DM@KQ7 z*`)p%m5geCnWSfObNK8S)r7u%)x0R`Rn#n!4aGRw)*`d!erP_vzP@AYyGoG)Qc|s5 z>559-e|82B)^yK0;AA!g1O>aMa!Gz^(UV_Zo|j&3I05&)?Cn>u)Ku6DXWj2@a-LYr zhn68GM#jl0R+2dMd3)cvd(#J(vP0D5c7?IqIoK8o{_0O-q#aDk#DvMALx7Pd} z{rt(vB=+#_fL$bBf<}6258w$wa?iQEvTrt}^eimX(9EZ2vr;Uqt%I^s{Nm$`{9exw zl{K3=b`*K7*$`33N%UPGxcvItHenUlY{AF6`%_UD>nGDh-&)*2KGGcSd|>gi?YGE1Fp`iK`t_{C*bdw8I`#VLpT@)`;0mgn{Y+`*rC-;a`hn z0~{sWd*_+iaJ6T#of6__)fo;QMSiBj*R#Dg=ZTjZ3vv#xTC7cgBiA)HhT9q4sO3C;>eQ+7l@{)S zQd{lc+=Vth7avwHD?AGf+**|*IX^6)ICM8x=d-4oOk;mPy>&c7oKfZs{8+*z%OuxR zRql&3UpZ3l1Ns{n(1q)5?0&lbmF7gA$j-(hK3r` z9APtpv^huK#-`-4H66D#*jIb1I6EIp^n!O=W;9_HkK!!A@)7QF1(e3Z?KU1y?3SDR zvw;yy@!sAk?d9R)bNbz1)R$;9V&brE+0oXv1f$)tU8Jw!&QRYDwTWkO?)6lSVA$!^ zMdAo{D#VCz&V9s{4&V)7h-Mig5pLjBaff6`3gK&tPy7B88gi+$8t~%~>`;ZXWnySa zZ?10fv#u`nQ*?CDdeIb-N$b>Wr4k$dG}E3ig#&12HmDqHP8dkpWq@mI`|JV~o!rl2 zXc;;y(cDd<%6L=-PzkN>6fQF>3wqO4t^mPjFhh&I)_!g7tm5S4yyQa#nPq)m!D%S4 zJeRGwrI&XqOyRs?O6RdszxLV@LBtU2XinJj?%%&3ihK1}PQf=AS#zg#sk1H}+Fn-w9wau^^n^}UaF zd&i5KPfsBf6?^aD1Z?FG=r-f=w)qpE9`AQ#k#YS+3&UC={qqSm>Cbs(qb&h+hF_B0 zN56XFlbV~tm;jvG7Syaim~#+mT0&9<9yw0mEs8@`JG# zKCJ+77v@nS+)<_LTpCLZUV=k45#X$ag@sO$=|QLkxUy-eiJxCGyat*B0NX~r)?Yn2 zX2zy&Zn4?fT(A{p+1*fPO5M@0zpBa7O2q^Bjg21xyLfqC@uyqWty{Momd39bdQ2RI z8*6Q7xNeu<4;9nU(D32;qa$N1tsm-}H#fyGJNBdpev=%2PXH%J|D7oq(r%)(XCzz- z0ZQ-D)nt3A3Q0VSf0?v*3$G=7TZ08&eurmS@Qf&pmBvkBX;@_m@m|#@x$nNfOF$nP zTicSv(=#*w-qO7>bQrrhH#fIj7=Q_El31Jal3~Lc09D;o$5*d*Ol4;!Lj!vBVCbXc z&(5;|{QRFg6gUXP|K2`2Y|{2nyzR49v>ec z5>){LdI>-?kg->Wz1u>ov(U_wtJG$@q9k&z9QSf41U-M$zhvra$PSCG{`+hFm; zd;K@U`8D1fPS7)ofucrhphf`9)nU{VpISQ8NN4l|>ce7jw5Iycx0`l@B|###y@ePO zv43g;?qe!5;o&))^FqyrVN+AntJklCrl#P$8^apr6x7C}p&Ar)x@yXUEff@BmKLW2CNbUr0zu(K}C5)5*}NJ4piB*BC~; zNjqaWsnO+dAsDtSQngvma=TTq9iVMNs{F+!jaMjR=iKOJVjt{(1MxnuOcaI5#Kh zuwUfq3>pA@NqGI?ROW&c1m$AhovGqdHS$VNTuu%L6_lhJ2#4g7gakvnJPi4wV=dpl z9rsLz5q09hb7RZPrO6jF;C$Q9?ZDDN>tPmmcm&e`7UZ$uA-sNQG8Gk-@6e9dL;&3- zQPEQy8MTwa+#bKO0m+>s{|zYSquoFq04G=u=mdtoYg%w{AN9rqk3_hOw2LLhL3@mV z@h`BTnO8akN8b#No{J=lDySEL-@F!j7DlROfx0~=J8f)ZLvBV1+-0pt8}6~bTTQM# zOld(-t%b&z?6dOq=N;AV=vIDgB9=IZoq?GE5&%LAMP_71r0qU4 zp#tNFmzGq!2+_fqvzvsE|{_hLru@9m^^@U43yck zCaH2LIFTJXWL2t%))N(l_r^oXB-Lun*?>O1n`J{8JvNP$*+;vmHaJ>8^fBLzWE0Hc zA<)@%+^##&AQ+d)<(b?)?>2>x;JFa&v{>##7C@meoBWhFKN!{Fxdk?z1U?o<`3W*!qW7zA1pZNV>EC>3vla`U*@% zzui7e640;cn|u{-vrcIuLDWwNaeh|PGAk^jjv4DO(zRXPNH)8%+8U0F8KpBb3HBCF zPM3PwE@piB5E|k4C%x+!V|>p8;3R3B^h``3cgSvjrg2*Np|riTW2XBR)gd4Uy19m{ zlGg7$ZAl_+`PtwXSe+(ml*i!2&wdjMFs(^*rOd8u_0Yrp$+$hC+L4vP# zb5dwfuZjLIumOn&rU*-V0YWnyV;DI)eTOTwo~i3E!wl&SmnmwOLkJUCP@;UABrWRJ-s2pz?@XCAIElYoQeRyES!(=E~5)^_Xn z<@eF&R5U^3LA%8Pp{>H+uz7D9X?wR?662}v_X#8%8#1k&t@Gxk7+ z2e249%n}*qawOYZ>tMlWz+)m27-v(eP3OF$>A6SQ%g&4@D%ok;dxFqt1LMYssw^Mb-*?L56T#=S9_ zTx8VDNbp9O1xCQ#e0_#=FBmvTJb-5cA>X5~YP1nXCkS$h?xUX4&?1T+cGA~Ff&!L7HE${oDb{t->LAit}A?F1jo9V*$gF z%7avTIlCt{4z0Xpg%<6M6=&oQBs$ZZ^_M%EwZ)Qu>>M9IgP!!S_ySt7Qe<_ex6jch zsp>c1eI2Ut7K7d>dwcEj<|i`Qqw~UeeIJ9Ps!EX#yK8;TqZAzyfUw*fWH_&l1-^K~ zpz(4HzI>6%rDq!|2&^(ai`fd!0ii*Sa9uifX|5-ctWm<(`{Aaccd|ch6P= zq+m4jz*ETtiBMep3m_Qr#p+d4Dw8C)s`e-~*{?!4>1!bP030xDrsk_&suO2GBLlkq zCD9M)8cw|MrVlV4CHXB6W0ny%@Yaq~kNoc>STOk;6HIm@x3i`J+kB9~L8!bx1gz79AOKhHxXad-~Gd?rAsYyi(wY zxuv(%)WG)v10}tC7J48;FW<8@;k!bYF4aLZM1&5U33HHyfMu2Nl>*7I0I>dOdD#)< z^X~3$a5yY1ExYuJL57NCgSqBF*mTS-MdBF^vLMI+@@jVwK?PF{v~Iw^APHQ8I)jzcEw-QnZ4s~+U&W8(iOxJcJOUsu zz{}Fp(>XIXj zrDQyuh9bD-$`L+bZRr3gK>SFJo&?T_t`8;vTp!pC5-uJ;-V4-oa*ZeW$y9TMS*VGr z>64c)kAY6G(P<@yjvAP&I6X!JmbhiL)08I;NoJW;Q2{sm>%0r!^Z@m3tIyLb9n zfc`egDZ=xqxTKO$uv5?fXpNtymd?md) zwrD*OM+cSv_h4xVbh)SA3l)JN6@ZBqUv#Qv63YHM>h=%VG&m32^TxWSzkXQ8)O{>W5T0R0nnOhsU|9B~-}F*$zn>oy!ZU-fpzpiZqwnoZnGP1d;PfLFR{RIsUfGNmz1L_F#?JqHX^=cfwVQz89BnP75shO*q51Hy?U^^ zX-7fE;szcE3j?Kn{``5Fu`1713uF?aCH?q-2^IicDSibpOG`_$${7$Jl2plTc|lJS z6x)lN6dIKE{`6SR!(RIM|`a81g57OyB`YXr7 zI)Ji*B-|!;sDIRLpqOD(fv5G320Rn))e99wHIMWZ=sZFY(*V8#4+VV-X*RIPy?VK& z%d7QxyP=O^ZdEF<;Q(Qwmp3j-)O>9LG%gMW2QvZMS7%=zou*-o28v^#>WA)a=(lAK z>vp4?*6bE-AasUmSiMAX$0wG_p3mH>SPrfNLPUn_bW4o-yJu5}&WVPMzqul&Gk;xABVB5ac)SGU9%xW(1~pz}0O=GxL5@}t`$M=TfY8gI z_R}E6905S65jC(vLAFGFk@wz50HgnyrN4`sq1z)_)^+YKDAiwEVz^&};;LeV%&Fj$ z+?(5d*bWdcTM*`2pC1Bcc?O8;UsnbK2hf3_`G8w+A6Oe)`1-^;k^sRh{Qz{8Qv=S+ zaB?C+SVaQ7U6`yhAUuI21%Lyb!_!a*$OO^MQbl(Q)cF(eU=YiHfTE0AF{no16hS}L z{@Y*wakHIqGI7v^7{e5DOAnYb+8%X6`v7za8C2+40gnh3MBxhQ-9O!EVj=%cdhNR= zf>LOmkkFU;;xvpZWECZX)PgKeBGC^m0JH*#Mxhx7bP1sGRk(u+NHTZ=X#)|W)V5FA z_dmE-y*K)vh0JbVsf_iT%eRbjLG$rWQ#0A|?;i8c#O)Yjv7Et+{cIPmPu0dPZX1SA zxP%I_DXlz{#hxCa7_-cqmryjjrS{8iw?EO@lCU5&;=edEc;w%!FKz$7AQfQI9iANp zq5t0aa4WLx7GlVUXbmL99$szK-s_)LWvBZT!0c}!W7JO z4WaN&awl7jBR(-6-{%nu?Z#-$4FAp;6WE#X%oUB z+2<*21#yeW6;p|3u!_*tV2&Xrd$^()F9MeAXT4S!Mt~n$*)<;wJg3FYTU#4?A%La5x0RQ{;rajwtwVB-2S|nF-#j65<&Zc4*|jfV4>Z7J z1R@7*-*6&n(T4*VrQ&JNr{LEhciL%ZzN{Om{mu|;spdKz1>>6dM~xJXT^1uALX;s) z!M~!SLOfdz)(eHAn(6D|QeQ8`>0brPgs5#SP{^i477yvRa@c3J9Yy{S!U7(bUOEE^0DS|2 zJh`1>x%3_zuFpmzY#))c}I4o^^M;k*D)0ehi|9u^63 zbY!K%UzJ+6tFI4S5!jnoGbl$4Up7PLqe~AMKYj_I5IFUKs2`a%hXZky0B8vYZ5E(r zfF%y##3O4PTs^32Naz5F2lr5NYTFmY4D>z>3|DO1flrxcE2+~$@d57_hft(4SBLD5 z9o#=G#2&!OV1j;vJ<@^f34|Gdn*q>~aGXSg03y45q9RAGIs>pYRU;fl!946%0`@Ds z9!eNCV8Yet-aiV^Rx6fpQCZ|q z=Hc1>q9|Jj5V8Y6AROL0y;fG@1nWvygkLlyZhaGh{StcZcTWKWfE;_N9wgle``};$ z-$Nl?C(u~2)^)Q`(I!9}5X6QFu?(^(NEy_i65YDBz<_#6Pw>GBynyRKYe3lFqA1&Il!<9{|F00@tF}+H(z>EOft`ri7WqDKN=q zkZKLT!me~YRPZmw2T4T7wqmXKUd2)!1-PvRSr;Eba#vX4r3M9;F(L zh|@-YIdc|fI}3(KQ2R=>22e>Dukz{*BGT6vuCi<9^q7Jo7{#FmlGNd&Oiw`~s$LLu zkxZhOzZJ=*uo}sB7UzuYr+>l~Z@|WNiiL;1BrM#3rae3bP(4^iFq{;U{kE-vpTSr| z$_}JXfPU(L#s&K!cv8z_6_i0digklaH&{Di_?>jRu=fK9>L66c25{=%?I}i@HCmOe zEYhEp74*>3gr$1$i+bZ9KYlD;^pqMo{ZQvDd9KWqsmt(vVHI^{L2%}Whlg#S_RvJ4 z;0wxjk8OsHA+vG@-Z67%zA1>;Wlq1s=>mWel!;NzI)Ot}h~5kk3ua{Twz5f{Z#P9A z85tQw(m&C6udWJQAyZ50jfaE+Y=>f2_gR(hpRSZx{@{JKyiKn>R3PQE`6o-R-JY~= zzY22zWJXA$LsSQ{&X0Q~YkTSaovF=2Z%rZ~zT}(MWAishiVh*Dm2L>yM;IKuJnOq$bsO%vEChj=-^lb$3C^B)d>$cb?&^|F!_5>;vERh=9 zQhivnb{BkDJS4fxAqr6r(vT+#et<|oT9zX!g637ilaB*e2M#!hhRlzU$&SV=RMDEp z;a^eLA+Q9&VMxZAgd&ZSGs9H!eDpa8eZ$FY+T7esU{8#Vjs5$15*&$uTSX=h@@GMf zbp~~_q*wjGv}XszG#OY~Ej>J5Srjv*ztPmxRKISntB}?GnI7C@2#_?*rIv!sCZ@IY z5W@YSv#kFffHVwXSeR@u_F>Ed2)&_BOK*lOW@yQdkuu$m$$Zq1NGCQE>!K~*%$_X*p2@DJbZjC+~0Lmx;bZFbA|7Zn} zTWQj@Oe(d@Z~x$^jkqe9n?@#Jet=3tAV@<#S&3(x>V(4cqt| zLrfY@$vBKm5Q>+l`7y6S@%ye2C_#99t zL@ptkIEAn%B*X}Sri9&x9m(K$AOsY`U;7FLI35fsfYJrQdmmb36Afwju)^ky820Nm z8kq)=)<&cAxR7YDGe+`5W*osy8z^Z9@k&t%z>8Z@0){y;R(s0@~xQ!1iooNXD^5LjbwX}4kVCO z0V-0iK~*eL5&;+1{>k89M(q};(?9Zu--sCmC@%cteGv!*+jS3WjJ7fgBLZ%P-=>v6 zW_!jzPaT7sJ?CO!ap+M|kszQ2T>o1I4`*;KkUj*c0@fUw_LA_Uk!&W=<`P|dbzzKyBY~Cz(JMG*kl_a3 z6q(itlcD@S%t+*vSI-$Nrg4%Z$s757V)J|L%Z7fB)<``oF6~9n3r7ZwVY-?#@Bs@1 zWS6CJ0MP+Yyh=(kZ;j<8^hfN{12&+fp@I9ffOIPAKPU(YupcQ_FfE{I2{ys1RoW*! zTi%6F6TlTw)EO!nj7K;>=yNxaroIm)0Kfz?>6LT&QxKDa#1POS^bwQ1yA*k@e~5_q zA$=Nn0}4TakklL;k~*svn5`&Vw>qz$AjaB|SERl9G&lo1JoL1qJ+W*>=K=Nc6KyTZ&gmzXBiR z;)0JX!Tx;U3BkB`bUiGC4gSKBYYJC>W`@62~9GR2P- z=VG)f9g%XvhANWHQzg~$ot*UU&i#mUf8i?8aXYys%YMQ*bXFJdZ=i|6Skdcb)izu`#sOfdM}r_Ga9bA6|y8VrCJr4g~{FVOX{H+ zSFRY{yY$R)tS{Y5=-Kn7kr8#R1g6@)D#C8f_g{f)jh5i2yC({&rC^2`WTyj34K>SZ z8k|X!w4AmMy}hcXm7>ZyD>f2j%Bi~3S=CoaN9SJl!* z<@EDD__B(@7Oq66={=66X4K7Z^*yOnnQX`dsV(Pe2brXU_J?s}7F*=B=4~2NDwY`d zI=CiEsRP$jG?O38DdGtRhnp8jC2tCs%d1uHNcB2o>AO;QG^SW%w_`TO?#j9MIIbHC z-EO%{^D?LQ))tm~&7i}PD0?xhW#Degx{daZz{Y&?9u?-p-I%sJ)1L|eXHKkML^s2wup+LUvE0}=E0%6LjCln@46yNsT0;G;$zJyc62#o3pq8? zKVKxD`f}sThqFzAy=Fr~Je5=8F0diCkYi%n*iSIb>>NV@m%l-aWC7NcUo+g$mP z`n{9BIhU}IRYqqUt?nV+v>PWni3$NREs}K2xnW`>7_2kVhrpvNBsOfF{CrePL*DyK z56|}{;_0M!-W(gkN(?rXLTSxbm!5D7cW?%)GNn_o@9*9d^+fPcoL=-r{#O@;m9(S! zooc@6>UE^_n#5o{1jcy=56rcumaL!eoYZJp>^c=Eo_m)w=8ck4qJl)&$AdwxZ$Bok zorql7iB_-<_%^+rwkOM_BL7g8!hlU%`HIeMgTz)r(PrbD94Xk_gBLQWhNp(Vi5#0H z)D(+b7I`pz8!PiLG}$c_%@^$`;OF#TYqmNW-TLIShM`zUij@Am1yf5<6DdwdCHC!G zYq{)S9GWUFy-(ggRykpJ{&VJ$>~C!OF0$;S^6zr%b^VJB$cNa)R$bbJSx&*nbW9bl z%ua5SN2QZbwcfQYEbbX*ZlegS)756GzbJXb`~JI}WbC&}j&PDOzrww%+B7K(o`+hF z+~Ydw`gq+rb=^jlOMW|mpI{>K`rX@0wRb%FwO$$4Sp6})m!TYWYnJm=j(;BI`K-vF zRDAO+Bu_p0&pNg21XWKnA^PVnwgO=q?-PHxY8<)j;`#0K)Nk#R(=OFUEpk6Px}<^> z27a~6Xq~S37{kf4SeE~krelm+i|?u5xo+ai8+F*EbMjH+U#j2SOuS|``Q+sFyOTVF zdeP2ScC?0E)F%%m2yyBQAF2!MJypVu<*!z&T6!Ma9r7{e6E8=|x1YR=(RA-l2~W^d z4xXI0tv;!7I!9jW=5e|UOm;6k43u|9G*li?XXvYZN}i$W9$j)TZ5-NqX;ag7*OkLR zf9_2=xdcW&%_xpp)Y_m-mS-Ngqq68)Ht4&aQCL-+J%$ zX)32hOGdUjhT^mQvThusf+ERZ%<3Z9k@x!F{iEIz85}j%!dZsSYv$m;XB!s0S^H4e zs5BI!g8yWl_+k2bwoMlUf9M0+z)>speD*JOtBaHR>Z(_#v0CMESHypDj&u@##Jqp1 zKTZG5afKozN<(QjbU7+{CF9HDYu#?x@6b(@9H0rxDLk5cag0fNw>LzE zj!wtkN@A|hd9KkwJiV}7BJ^UI;PjJEE;{^2AE?ku%4yiqGx`0d6cH5^98riU)A5;r zPY`Z6<$Aw3pESk%dOp%!V}+V>(C@BgeXdoQ1{>8WMha#fuNe706PGvglZ=UpDd&~m zJXYw&T{mMI3D9htQM~a@cDwixi;POKxm7l8fQ4-9?4qXdJ^vq~92ZRd9FJtM?6;OX z5_@5ghxWy{w3j6gA0NAMTT$w_ZueUJ{v0SVN@U;aRMNluMnk?>;g!PAhgi=!PCIK#YciELYTWU9QC#xxZz{6+-O{oADS2(- z%*MG-dfMcSa(xz+gwV6|%4RZ;h1J>g)cHpIh`q#tKU2a79>j1r#*0n|>g90erhj2E z*gwDT6eW+&Pw}7e8lUi|$SDj+&QmE9cdq*(?G~hMGEPd@yli6A zae)6(5((#ZUPzqEz<}1PD4FerxxhEF^xfdp*fcE7q4;2h%rBS1)~EU^SG>bq>9Yzu zVw(!JbTqy8hw{$z!^ifw*S;Rgx?6fmG3?iq^uiSj&O0joIZg`{9Xj^L8A>g|#3M~R zeL^onqdLUYN7(bDZkInvo3#?-^{iLty!O)lvh|^J0d~e;^H#%$YNH4ceS^qxqq@UivnJ~M9d3F~hSw4%Bac;-c<{kPNlh$oPImz}`xa+O*H51OZ zSXsFx)+Ao&Grb8$(AGZbJnJpGn$oq~?n{I!&Ty@hyN8b%(^boTJViAd zRwqxhue6ov`kfbM`74r7Z>HDbpLzeTt10QKO0zYr9j84Ua{tAiN`2SrpnH4?q6&Al zgpKQc)kU;}f(@DGW$u|QzdxX4{dPz^R(bF7>hg)~d};mZz}TyGP4W_<^!H>=sHW;q zS{@m44jnb9pS`5JwKEsJ@YO4O!V^62cAs5zkr2UtN)yr{)6?yxDsyOyv=9(@)0yA;wXvqH z|3Yl=K7${*UG?{ct!WSD31`GuY0Q6#M*r`M43$WcpEvKd@$kN=q|ReI+kJ%B@)K{G zeq841%qro=iGV;8kL0WTFESXKgbS4z9+bGezL#kE(ag%G{qp&-%1gSo43#?zh4YsP_d^@$Z{*gS{$#vHEuP+05rXqb zwe=fpU>d2^Cmq*Fk=Ky?prJ*+el(i=SmC~a?(jR0?@lw{X5@&`RN5-VNwU;j)|1kZ zqdpn_o$L6$@ZxXAj8gl|@)dgN@4b@b ziw(t>Q<)Xw!aG}LZqv_wQK!9qI%og<`AhlhzIxXfF9oN?wPqdLc@w1hG2Z=2vGz67 zli6aa&hzQX)BXV$FI(UIrgVdeJn5o-TD8F1geYDpw~m%6Un0m|c<$S=2SKUg=C+2K zbmyLRC~DiPs?izTHMTuAY~#3;V(-{w%&TMjC5bov4Yg!NI;S0%AFoTW#uu{lw-mE3 ziDL{q3K}~qGnO3c}VpFB=fxroO;8NE~2 zELB1Oe^6a-l_KtN3vCwc}-b5XkA8lLe|+<9|nIk zcr#ah;r)Y?Oj>8_GpjRudxYlixE#{e&c}(*v*c&^*AK>P)>xFqg@@~14%x0b66+9A zu`s_Df4=(k1#Qu%YSqdvU5Acz91A?Z=9MK}=sGR$Xc!%HB7$OZHPu{8>V{U%fb-|% zoKU8Vsnd7tOOx^gF2`J?>VHv3%NM!QjG%5?+(K;+q_K|Bg=}t;93IpE#qd)T(G%Frz&vsGUN2`17eIQWj`-ijgfX%u33XRUn zc(MLQpU3eb?AO(6#5fcVv51@dSmfu+@aHRYuH&lm6np*so761cCBIGmC2{1Kdf&Y> z(=IW722lxq$?82%jcuJ%XyiA-=f*o7W1Q2I&;5ELXp-*y>HRBRx|Omtwc?8_PBI%3 z`UPhqOPp$4IrEjHjvSNCQ8r1}7csiS(3x?#du`T0{_DwrhoL{WXcJoIf0|w|1PZHV znH9a!c07qgu;xOhrwz0GmiyvMHidvW>bHeD8^g8TM3Z!SO6sHOmCW-C&55tfOdZZ& z8z7%ymuyRvew^g;C+dl#3+Ed($Ld$90tS`Dfdh@hR|B`c3%sB-2|4I8VI|5kQqtb} zCIg%5*d*8=H!(=HvQ9bcaOJ#;(jDvXL;FgUtt`0YHQuPZtR!AP$w}o)6=3*{GwDqi z&%nV-3;rETwbT-`m!6WIdoRaJI`x@bf4x+Ezbo6UsFPAyDDs&?AkX2smXaGS!n{%9 z-x@k?*y*zzMjl!pJvnXs+s*k_)j@fU%*4TcW>f*Zc`RY)%VLKabBo>{EU~e^%I=@f z*L*+IfWbg>^j)Dzt`~{M4p3ltY3HFP(;GuPZZOy&DoMfZtzc4NW!9CGufETWe%}!14%eS~) z**(vgl5d&HNg3cs>&dmRDjDO$-t>}6yd-Cd`=pm;nloEvb;QTm3vYKTtfT3kcHPL9 z_?m>9T$+30EF8&ht8Hhp8cbo`PE#ygc0E~-(%_cu5t(Z_YoXi*!S6*D@lG1M&QgO9LX`e}xsLFY2ZJ8;fiCI*HG|pOPUb&DY zD4U?IDI@tVSZ~JL5e`dUrjn{E{n1kR@rch*v9&a8SB=5=7?hbU1!cOZtBF8Mj&+b@ z$dw}pa==t+mOeJJW<8Qk= zQQ+vUmh}Ft7s)ErI^6y=U5|t5;dQDrsDk(gB+W9Y}l_)V9a_=3*4Dy2kYgqpRJk()plH6H>OE_^U8W`Q7!;w6%NS4PNC`6hFbn*FG)8 z`H*B3tx87$P^FhtpZA)2Uhg2OVmi92u~QahRj)8~rH9fw69=VIHA${it$fxm^0tba z#Z+uns{mEHiiFl9-MBJJetLQ+^;!?rTbt&+%U1W+1XlhS9fg5YLEz}xcYEW*D-3&@ zyCOuPLh7UnKCPOQr#^wX+E29(6QQd`{B(~eT1SUddHpM+O2yjAm{J_-7lIc#G!;=j zRd?Po=C7Le3BpmU_BvCXO3)Y|Y6Y$evclO-f!1d$i!nA*UNf-*dg*4O5`Ak0*) z6-iB~#d~UYvT$_o;N9s!rFq|bt#<1s4^oUQDB_In$o~+gw#J>8tf)1BROUIdjU4VVMtJ< zG3u1~h+AHYm2m$w^KdyW))d|ty45qT&TpS{T7NMx8$j&n?RPA>B?n#vL!`f5*vddReEgbOHf<$ zqdnz~ZLMPFkq!gSM_QtTIArO>Xp473JA+m*Jh+}sYc61XbPHzQvCy8Ua9vy@MGa;+ z=V;I86sNj0+KM#o2W3h6Qd~2^nJ(m@bXhLoFjxadr`Swk1`15WVf!q3+NH>s$Z1pf zHAQ88rL|}Z8V(w+Nz=5*a#dcdPEKkpseeWiyoX3xlry-*mu6+Sk&S z+Gjy&jdP|a_t&|^&(5H&#*(4P%gbg%mPp~PZ(lCq(pbWPcWyct91p$}$=c||4tA)+ zVRcc~d@DzxG)7yDGG%6{hOY8y*dg+rgULa69GTHHRg+dSKqDO?(?c}%09i6bnhv1S zK8jWY(@Zdp1e@qGjgr!dlWIriLiALF%W>9VDX=QXs5X{PbkM6{f%s^B5;JT{=S;AJ zja8iP-6Ahi)K-%+&Cyct(sx=1C+)?H4;94dpaYbT z3Oa)#LF;;h4;8KOSnuF(Sd1@*h>K4Ht-NXUG|#ZwRZ$_QUUNNNU7XaSJxaOQ_$8#a zYOGI93*t`I^4V+Q+S3G4t(%RXWPMoL;?v&Bw9(S0w((xXhB8j|$S)OdkL#HTLr;S6 zbuqO(2!S9JeH}wQ${x?7jn^oq-cm&w%R3SB{Y+IN6&wquOkHqM9jID!AJ-!^sYT0l zEVA`~bHN+z(@jIyL02kRRZD+zNf0J3F1+C>a?ZxlSALPdGOBt2f(N-0mv|=y(c7r} z!>enz(|Uuz21Oq{cD3T<`a>SCZise;apF{ra>dl<+A|qbhZJ$LMOEU+`tk%CGQyE)Wh)!d&ue8Guuo}=1F!z~aG`9?MdaebQWd1vvL0f}ORZs) zPe+a7!G(xqy-kgZ*CQg0W5J^DYfEnN3)t&0wk-OcYiZw4KA` z7K39cFVo_}WYz6}%N2=nG*TBG9olMiQhJEBb)a$zZLv<5^@z&QrNH{eBwA}!;yu|` zk%f+}-dWhry|8hvtQ*A8hob?c){?oTYJis1)@N07z(8qO##DIg)3VAaWOx>wEw7VJ zsLBQC?YtXOL!BxkfQ3&TwMs=JzMNOe*nss@Y(m-OrKuDxECkUTEe%ikqfoBAkm(K%eRrnp^nip{O;wFqE}<<s9e*w3-HS$F z>uw!I;mC6+iiF%2RfLHh^`4q<4OTzE#yV% zMCl~ZOcmW+k?QhUQn6P>HKsxxx3(dYVdK0U90I`^-`kkORoON!)++7_erBm1% zL!k=t%u+NpdDfvwiZX3Bb6D5(eJc{5M%{YdF+zA1#;Ie zZ4^~L%2oZWFM;wIQZWcq^FhP_TCJ?e`beRrUh3tr&O7T})!@#BlCe-afL28Uycc?_4A>H9V9U>&6PH7%R`V5@~3!_Sn@vj_%`>q%OSe!7~0>wGVt zT6Z2Q-Syh$kuG*MiYaQ&_~KX}>h=+`U{sfavPvt{^^SiwB-OfD^B1Ew?(}YmF1)ms zqfgJ-)j}KI8&&2+N8J#OU*!d8)dew5nzaeNx8-l;5>T$H*VM88i+IyCH6yqd`c>W= zsFd*{ts2N7%_gCWRK`@-Q2!U2-T3d*j!HnH%O%j&J1P3eOH6#Oa``K-rmG6<>%Xf< z|NKC9wN9n=*77Q(afbTKP)Ff(Y@ih`N~o&ni7-*-^lMue-qrZ6)?F_&eN+w=YVuBN zVH|2mbk)OE`CM~Xi__JU^I|G$ykGV4uTG0ls#wQWMUQn)A57(RPpccJs$+|(TCrGG zRjJs)6GhdWsp@rUt0*8<^UUC7wysKZRo>&}oR0S`M8u*v@u^tll%}K3v#M4D5oPj0qv#H4wl3D$#BWyh)Zd!dT7mW6>CmXg`U>@`J6o`<%0?g698@j<);GbyM-{Da zF=%UIEvRl+OLeW9Uic-+*(%+(7UguR)=IaY!2q?UGcE)xyjU#f=T3JKy^zpCF=QJ| zcRQr6Y{NBcrop8oG)TH>8Qr5GO$?1h(?`NwXOUK-8Et0tX;9YCmq05iBiM;b%eg8k zaLSR}oFa!t(m}h_3+n=drk&^Hxngd~l553K0hzWm(k26Gi@r=@U4e53jU!cxzI2E_ zl~5F23X{{9S_)@Klq0dBlOGhO?2_7bmH#Mpkms;u9qm+MEEGk#@McMsLah@^k~-1` zm~PqBtDIq7X#`nQHb2nSoSnIc>N%`xOH_~Z z*!lF!nCkAI$=t6wiH4Si)H-yc$U8oXCL)oCl_|$f%%PxUojj}ZzWKAUu363qzV~impR742kxwRM9@YH>`=&(#wdBbX8m1tJj2e zhM1+HVr0K2nnLD|s~kXKz16l%O*6I>gWbHKTUd-K8@rV0o#mf}2BTF^1Tgj)@OD=0 zpK7ZVQdJAYIjVAcrOR5tGFk{l3PtW{Bw&j&lCO;ao}`Q}Dp%`spz3QvXh2x@Z*Z=P zc2{drSZ_k@RlSLqMXRza<;dV_)(mf_rH05Catd_{+n1L4uEwHmgLDq`oWU*RsKGu= zGo>h7_F)T4VLD~!(FSz&JVuoQ%4G(VS&Gb}ntiCO592i5V%nE9HPO07N&}@560OOS zgp>wZZb^$SO0_YWZ%S6)lvqovw8m;zHk8q+7sr%QLlSVNmNOTEFG;KqjZKU~mWwKU znt*pgT3svQ@--mdX=1(IXnlji7!gz!ZRJ!iLY9z!_HB5bD}|to z_O&V-4tXcLp?dahEm+XgWw_P@#W@ul%9OX*#&(7}IHgqWJyAGPHMLZbT5r54*V`Vx z^iC(wxzn0m_~Wsz5-KsZGAxc^n}K@kWvcYjkW!jBs&1dPx+EQDa7&ETX;(Fa&~-D_ zM~q^cTaPv4OYVK$2Y>zwKlUs-1pSuRe8uUvmrJTs%>}U za8;U_4vl(T^pv59wO1kC+o`&ROz(NQuvJ9wwiof9XrI#VbgXCc4Z2J3Y;;li=S5dz zrE0$AC38J}6ui}Csvs_*d4TP4JULaLoqf;Hn)fnXD_2>WRWLDhAq{CQ)WoK;<>FQs zihk^dnuJc?L9>oQCK%2ZXzC6|fzl1E%E`?_>5*(CWHf2o3}d?_O0m#3baO+0rdZjR z(VrL$1)25k0UKGr?7fBjjoU?IjfxMW*`PxOTN^xZ^=*%(NOqp*xW{ssU1J@|P z&624GLwzGyatwyT84Q-bWQ3(|hs9!wB(-EZp`j8AWpK)1y}Pr|mJN%H7w(A$)paa% zDC>Q+A~(JfN*e0%O6x7nyeq{ybfHSY=`&|?pld^lQz@8~gT!f?zE-?cCyqRYP6CB? zbb*#~^eN{fhrVTf;-l-XR%fECbwbtFJr_OMimrpgm7*hd8+DE}CAK$r@p*DF#mf0i zENm%sjW_TLsuWb^>j!nH3)IzC7)q6mNQ{s8JL}5V>L5a@8Zzf9N3(Hd=Vn(cQ&vjV zYVXT=E2oS+woTbECvys&lp?bTSwv3xXoZVHG!$mU&VixJr+X%3^z654dJ&Y(<2sv9I}gG6ak4Jiq!g@i6TvtyJXP)^qJE1C65q4KRwV^t z4yZdFoduitHKfWbamxBMY+Xj|wWUZbh0>*P^4*4w^POUIAa|sNqDdcpUIaF>5wdKM zRys_Q^+TFr(gc$!@`fVMGq)b}40t|CEG8XK`>VYry6hyGX~((Xn$FyHwhb zx^kyi+QIqeMrCflvenipp&Y~6;3W37*S-`WHtGxZu5UzD)nNLJt!R7sbZ!*&ZP}c5 z)m#_4sN+l7>RL-zcAV%|!;EceLvC#?PDKW#v zQSV||c6QS~n5%0pw0a{%e8;PJVN{sVE8{kHE>)rHyz1F&q>6f!kuj`)xN7xVvEgd^nt`1<7J&*sI7}#L4(-zsj@+6+Ir-; znkgzt>U{m6SK8J)OUphWaMk^^tTnc=@v5uM z9JRi-rx$PgRCc98hu(0Zb@YA)K~;ISyz8YV7_0fG%6YQb*nFcDp{mLpj~(nn8jK1O zE($Xn`Y6`gKF5f#3X{H16ZYM0%h#BysZ6b&2xWSrwbA+u_Fgckuw|qw3ijG!POUi( zzN=ep|A1&b_l}gF6qax)ZLN@~?g{PbCShwaP@l_eu`IbRcJ*0|Ev78aSmqiDlTF85 z-u7(@5?oT&kaXQ5!`UF28$#=ZrKOy9*Wet?H9Iu=OJ$eo3|n-`R6ltRZPTV{%jkbY zJ4$_(pmd8OpGRv;sx*DtP$Z7Dk#T4yC(B^4KcO#4Nu8sSCN$F)#$_xN^K@;OBAuZx zYmsINt}xMI7q-aJ=yKefGW~KWfsQNFCDDqd0*)^^TB)LyR!xiAPLU*Kq%m}+F1v{O znsgH)D`jNK0l9V*KC<0VUO3une1r~lhO)-ccd4gPuIzZ2l<$kqH$T>#FRh?f`VhMB z+Ir00mD?}WOD0mv&kU)d<#XugKkJ*Mg}F!Bs9%gKJD;LU@m%kY=W2p7o&*L`!FbtJ=XE6`~l`-dpun`C+~-EVL=3uSpUdy$YkN*82GCnumHz|J}NpC}VnU zaPB$dND9cihBVQnU4u?ENoY!>d{c_hkRs+@x?1T4RoBfJE%aB!)NCwQl>pH5Z%!*E zDaVwxuG~}8IC57uGAf)Yg|scBh1PGID0)fx_Xa9! zR3Sxc>(}fYlqnrnZH2O$2CdQtahlYEE;?xC_s9%Qa&(SO3tyL~(54LGm`)efRXCTC zx>7*f(6YoOB*r%&@;TSeU-Ysr*hYtISYKnoujMq`QpM;ru5{oQu^7U}NFg?-QVce( zBG%UsmbHpu&2>E~z(!fDb`;7|XjeuE(G)(CR&GO5)($%3ydc!{=@!j&lvcKqMq>qy zY?!RkN1FEGvV@?A5EPiQyE&Pv7LLlHAoj@7wOu$GE(Te zwH_G6pbEaXgtE3)UteDyRV^yo+lVn_^Yrc|Ttxuu9S>~XQRjQMSgT{utX8BG;^nam zY0r)Us#X>gW_VjG0r2&jsjD@DsT%S5^rW7Gx3Hlmv3@V^&#bCWi*IH+j=m(y4hQz-wq_T!Kw#rr;j#O!-wWt}s2~8~$7HjT8>Ynq4drXm|me!$a z5kP8@l<=+fg)T&qYQilnK&sYUBi&i2)T(N{mDkq`pW0Y;J&l0M2f*se`O%YTtE$Le zH1L$)8?m-;U)A(DY};U~8bqqp<0=hA)kMCjMR{u_B}!Fkm8y#PCBF7Aq{=HtEv3>$ z$sfj`jkVF`0!qE^peN#}qu07h+wopiRZY~vuCZa(*4k%1Sd6n($GjM&glZ#te6ycW zXJz986e6inN7`!sbNd1w=vbd+MN?sZG92_L>incP&zG}RhWzcwUL#2ieXMM z%`C=tD6kYR7F3`T=LK9syQ^?rN530jeqoXQoi40|!GbFA+XkDHB)T-9eWRDK*?Qp=sedlo*2T8q-ra+8z8Q(Cd4g(<0m{wh zl^0%scGv{kNx5L_q>O;7LZJ&+)-AfS!)NZw&9if=eF&BJ>H{>W3~S{h_lB^im7iH$ zRsZJdK3P|aqONkJMzQ3hq!8|(ckae#H)H{M;i|XKKnV zr>dnkq`4{ox-tzpOB6*np|m;6YpW6+*SN5ee5gye!K(BbL}k;8>bT22l)YB8-YFmU zAPv#M&_z8oqVaZs^-;pI=FM*vpllg&RTe{OpvP@;RJG<6H79RK39ZIh*c!y!5xS?E zBStf;J_e;_YmD+jRN)GLExdpUV>C8}qfGaU+cD{KuRPu3sw>B&RY`1669h;j9c0DO zdRC6?KuCJqy;W@evevBl6OexCshr!RV0N&)4|d8QV5(b_bIfAE!*U3 zTW&ewLp@F@tg<9NhuKZ2V|q=8;m>mSsWQL^0?p&#zO7 zcXlT@mB;l2zs-UsQZyMUSrCNU z`XXk7GaYifK-bMv*rk{yQ*9$xbHF;=lM$xseIjd_1g@5%6Ss}BDn=G#e1`f?2eoxN z24QTB9$FlUF6{=b%I875nnNy@jJYcHTv2OiRb>@e3$CyzqezvnpVBC*F7CCDRW-vu zc)4N>s(g^+V&JNRYUf-{c!j}cV_i;ckQ0nDUl3WPN`^^E$0%MsYE+JS<2^-5Er6qY zHgP8wEY~9wwahSOtNO9fM8Q&P6j3vtsTS{$!>fF^OijJTG|@X!HMDTCcB8yTy^*x4 z64NhRwZVt0wt)zHImT3-&@{y22S!c$)*_Tugw9qAT8z2W-5H^-&h-rbB;Mmv_=Ki9 zVK8e;EjH$Ah4EEwKuj~VDjuh*jw~FM5yLOQ_m*55c$NR4wZ0Dz8w8CfCn1 zdY2Tg){rPTG*qpTOF8M*LbOp_`uz)oC{dw7jE<>CRdY7)S+Au<_OwKD(eo4UQ|x)` z-=lp>tFE`hij61KYio)tE7WhyPEXXq#(n`|Q*}k+8*`|*H)%aGT#ZMi()hcO!XNkc zRH4q$*1DM1+v(U^L!YWP#nn<|Lx)?XLX@&T)szCzhB^+ay;|#HF{BbIT{ViS8e}-? z>8w?St&7o22%StrqpqZ{TgK2{-DKL#`Ot&EEHd&eV)5Ku&oUSU94oCYH z?WLTfvkU0N(M&Q%vI$gL&^1%!&XC#^SEOam z$GMaSO_IdW(H)?JPMc&&3WcxJ)+R>7Fy7(j1yQ1)<(rl?6KJK-pFv-vjLtY)Mnv%C zWyY!UzgnC8npUnBbf5iIXeg8-jaxsJ?@Rnzm!QbK1I+rSEM;jx`G{)g_je1%-w0px8U}M0d zsvlEcEEbgFx2MmU_nZf#%4c_#bwa*2F=*bzl~KyrUf&DFPPl$a`Dfv(b-2)F3bOHY zkG5r(!c3RfCJkLzUFFT!*4Ha4%IyQXj;vA6lg`&7Dc{{#xvD)_tkVjPQC!VILp0!f zOEp47U)4HWgoba#tgqPF*p)nhkP=!GmgEpW| zlcdnlE&M*a2_zb$5^R#8b<;mD84cGYD-tr7kXVa0dAZJd+o0^WX)sBFO#w1gMlCX` zAxl78TsOrQI&K}4s0K-G>k~)fpKDinT5afr7`CBEDu;OV1gW0>1v(ZzSs$&^J=@E~ zk|1A481^w%-ceE&NBLF9H*ATiqm)gy3cpU4QEQDY95#25D^#vX4YX7reR_;mI!e|U zq0v}Dnhl||21S-&GRT`6o24Q30qx!8r7fmOeZE)L9sYyC4EuAKXW2(Y#c_!earN*aom>JhP!-&7gNH48jMBziWv491dvO^r=;_&OR? zs`ehIOD~F5J#jo-Oa(N=Eg54(tezuXOOK=4)VvywI_@c0?LS_ntAx~97b>R1CH4!V z=}BXx))_H)dTT|WwE(21+JI75JJr5sJj8v_oT}>m;%zi>>Z^yKlW=@-!nVH4s_$$W z0{XVzkIPmjoquq{qEn02#u^M<)d5z!T2vw)jqfuZJHM8Nv`Kxlbl3aPs9LJ14gy7~ z=sB&6|9W3m)!R*`CVOl3deH%J+G`ax-?NJm<*H$d@(WnC51y?@v2^tXVX=S1*sj9;(Q{hv^;&zb zRn^uf%uA})Afd`|SG^5gP8WP}ja8*k)X*uxnJ+U@Sy` zT~v#eqsIDv^vZ7_t#kveGpw~NP9JB)H0gHc=vYTnjWUpSadwVw*OKALG$h(G+CM-$ zpJO034D?&t`69YV=r3A~q@#2?GaQ@A=?p1W3|baC1uKU%dAq}@WD4gxWNEuhF*VTX z7#f+T(=~o;3b5U>GvtCZ%L(wT|_4Vnb2`qV=(C9K!)Kb2&f{W=57;IUC>}&W;?fFp-GVh=$T-lUm zF_b>oavUU9#crKps|Hn@sZ}j4IRzRx`gFC0nvU+kO4KI)aWj4m&Yj;cF=V@`DpH6F z!WSBja$HgEPp3m;Dc{rGg^V0qZc&o^R8n+#e4){daUtck{E{?e16fC^sENTUBg9Z1 zR8m+>Zn0g1?I>(gc2BpdMTe#wwf6OXA0z*Pem%4XNYH){KCEw>62zW8tsz!Ofej9N zSIZoU8#bmmFASaED7>(ys=!cH=g=?!v>!~18sdCkfw zVzFtN3FJ}-X-30B!(?POrCBs+I74bJNoe|m#*mivs7}Q)4@ZvG1x{z+lCl;~rM~GR zsI(MoS~(JzM)9wdu2MroA#g2F5w?+0DkX0B;WOY$W1y&gi%BWT-D{;Xj^+L@m6T6HW@Ef_8DaF<}R1Uguq1f#^JhPJLGPGj+-O5i_sZd zmJHNwHPw?n6?=XV>{(lLq1Rluv8jyhv5D{{31#-5t95yIu>{Vjs(xD40s}5=A?Itn zwF-6G)wY6FVwj41>*8EY<#xHl6=iyQTK6}rV4y?UX_Rs!;HnzY`AH*m%BhUEdIhwK zjUDRgqJG0;U$E&^Qch%ExM)?6MbzrzRAt)6`kk0rsH>_mS5GaZH$oSpM(PZyg}ov@ zcJ!;->+6_O8`43`loVInYRpwBmCnXaWV#*(rXFUtr$r${RJPoH!qwVQ_iSYm7BfZc z!g_ia6c-1MJuT%;$M1EH-hKbVXR9i$Ek4+;T*Runzgo?ys>Qv%peaI4fvb7&Vvc&% zuhz!wU0o9awsugq3Yo`_v8IY9R<4NBpaHZswZzYw*bidCr=U1p6U~bB z7$tH&4`NmOQl3j~WA(UIh>H7AI=_qFIuZZ?fB;EEK~zPFt91eGX&_SNMaIvr+Mz3- zj+IeG-0OlgL@cWax{E;}U7Ps*76r9Vz0{r+OVy02UK>z#{!}q7#MT6)RXsAe=3b~G zm$6wB+Sf-`X$mb$KNbFRw98Y=aT zL^K#}DO^sXQWC3hg+|+Q&$KcE)WkVO;g)FXl-xD2wkY>oOAMxPsKhsvbUs7FPpAc; zjbku@W(sKneJJ`Uh1sdZF=r^#=ZxQ)!7u9N9$hLn>?n$80w=E=a(okQcSC z&2=ZV@6y@v+4x-xx$jQfk0K4uHdEIB7;Q1S+|xCb7lq~(+BagdUYLdcXik@gTr(}x z1|5!EQ>%6L%{_c-pZ1QErgpTHBGaz6wLmqxV#$LyD6Oq(9ScR(m5-QlNb1UFL!pal z5+drZs)MeVyBJqZqj}AdoYY5o&}gc*mMeU;q1=}dZ^GmbjH)7j+E8wpk{2ZH6qPu# zkV=;ppwg<-u+_btHeKaTCvG=kt8_H0YFo#YQMIxhzMMId`nEwnnrMurutm8CVb@Vu zMb|luPgAwN_Dd-jo!UBVM^kh3#<3QzW35ipdI7IpZ8?iR#@F4Pv5H?-W+SI70- zDTOnBk6~4H+>YA}d55V&ktP{Q(jv`G^`<0I=0F)KB`Tj>4DloW6&2=oOj7@l@qI`au-8pa|Vb^KxCaIyRNFDg;$*)g(|=>7)cP80t}# z#i}wLyL6muABit0Fc{;TQTZA|o0n;f+Bj09>1&i7MjNdW8qHC%<}kW3gl#m-eFsww zjieOh;hC&u&m`VSn>tOStR$tWvr^lH)KP1}bTM|0B{NIM%wcSodT;t9R^quHeSx#J zz=Yo!*;Q%Y^?laM%tq5w0#?m?r#a^90Rv^wR>y5iV?Avw-SZvYYaPNv4RcJ^bT;ly zN~qZ^ykn-&UKm=^p6;MN{V?wK7rXKKl5H1^2kS3UxCFW?gjQABUQfiv)$-NDM&cn= zLOGvurQ=o!u2vU;s%_t(bS0x)ePG6&4QdT-eAF(aw$!>qQuB<}6QyFRVCdc#nq|~N zBC!szE|jc``+U`;Ow4+($&WY~!UmYy)yhgkTBofxyzc2ggYQV>RIO1A(LuOHNqqFRe4!4|>7F?!cBXVH zM*f_$G2-WZPi+yX(zDpr@IQ z@6uGZ&9BEUo%Y*9s95I|ny$pXGF9-{1;>PqqAW!1>vf%VJIAWp^Q5W>uMYRz)uWX$ zA=qb1RExE%SxMn4#-miOXM_0A#n{C;)b`YyTB?YC?M%F5L;2!=;%Cy6&0=e=fNGAe zH=qeMgrO+C3|^GirZA5FWQgX=FQZ>Q#nJhFqzf&KDM)mS#ic{!woNllX<->mVR(3u z;l7oenwtb&b`ebsB+im*h0Zb-lY#|Z*71!beYhn{ze~v5mO?8|%blu1w4JU~^r|e4aC$r8I4VvI!{}D)lLJ)?o^Rr3-0-(v7mYnCSzZf@_x@ zsCBKP!j=2@nQ{t3TNv|ELZciF>bpaUq>CW+9^z(1qVVDA+e%yeS1;KUPB;WT+i#p?x&8{Ek99I=*|URizkBl_FKX zsaSAOdcl!fnD?ThWff^sj%|~aDY0dJo$KjVtSHlL8ycF4qp6e^AytG>yE4726hP&( zWy<}d7>hA=-9_UnG`4Kl#7?c34BC}xuAsa) zF55+E?~p5e=h0BlY5d7Faz~%G7!5WlBemLElvSuCbTia`yB_D8$%Xkn`ljQajNlti zMUSHP(fpcYsGdII8{`<{$c>?697|n8w$*^=z#*O#Xi*3Yq>xqBlm?}0%c29|)=Uv(0+$6;2+RwZ-4sY{LQA(z z5aom}&kLHEF+05G$U$+@`iCq??E~oKFgexk&xj61AJ0I-wCyIuuRR;Mn~|RsJ+kvC z5N!cZo{%H2tswE|fK=SoCtTLAurBXWH=~S}^$vPj&{peu)N0f!jh;(?z6#Mq4-!z- zIteQ=YGetEVNF$Tp#BBB{EBP;6?^}LuDd(s!fAuyd?U=W@@eWmu^(_cf6`d)(1^DU z5lnSh!ADmAmEc2~1tbkNj>EM4T*@>SJEUYbZJp=EnElagIMl<3!o#{+Whd0Ao}jRh z`8Gx<+2ultq)Bt6(KE(AeDI0HIkGn~h((SoR3WDWvTq;_#-g?*ipe>tcglJKN(hYN z#-Tz|mSX9YgOXR-to(1MRn86%MAOctn8OzhD+SH%ejb@9TV>NbnG_?!D^Ia%A_wX4 zX_J>qa~i9BFX|5|noi!KYI2(^#sndCv2%uB-Aff~q$e3{QYCC*zcRKA*{g8%$oT1{RIz{p5 ztf?4KnWRn+`{xJ>&cib~NJc3s#>3J>1Hu%9U#0V)dIC?y_3ys>dGndmqAI&#bZ*@S z-Z)LQ12ar8WOwBCk{T{V1F|yGL_|Z$lVPj&v4Qds6Ez2uPB=be#N%flR`PWJK+xJK z-8VSY;eZuQ#bT<_{vZlAeR_Y54*A+bJeAF{-J`j&BUp)fW)8+U9L2BGVJaXN%o-jU z_SP8K#4|cfI6-j6>!9)HQPNX%-tWeP#NQ|O_BxeGatwz8y@Z$4~w9B4x33qQbETRPYcji!9QMqLDdD{Tvl9L z$FH9c++EE6Qdq&e;BGyDZk>jm8Wtu)@Ez6w6rXn6 znpYyM8l*h4E7lQF&_O(2+%~j$SNe^BTQ|ifoF?o;;?1uU_9y5D8m=25#m>O9t8rY6 z2);6~GI=YTy)WHC6o*qhU)X>*)pJW4ARDovB#4%U&Dy!J4TdY(;5+l?u2T66X23y0 zgWE&>c^35E;{SXT!W}6dVD`}HafZJK;<3D6OO3{CO`{6Tzi}O9gS6XUVW8OPUKM7OiDkxg{SIy~1KVgT!z7 zjNTQkd)%f&!wK{~vqB>d{mSwg3M2FQqEQby4YNy;@Y)JvG5GvOD*BOge ztVhMNS8PI9m9Pp>-SS&}%N#J5Xm8R&Kqcr>pjAPIP^ns7lK|Aa_azFr3aB>F0@PZu zPzCYoj+FV#8tesN4uu+LAf$~)5Jdfr6;0=MJNI?;k!KS3A` z_W_QQ>nVe)ssalY%Mvo11)n=e4p6_M$!EOCZ@Bhfar7@xX#>;~ZbQU5TP6@v9mYsW zcpc|`Rqr&MzkjmcWI}(^Ib8fc8%zOKK(w5OyKn+gS}Rdln^h--(7)GUMrh=D5A|UX zkVa^SqV49Ot(;dpW5YjTCKJvOs#iIwUYZVU^W_&GB*L;-=7AXL1nkEWCZ4pyaZuv9 zpLYy&=71!}t$*EFIU!VBH3;ihhYJ1@#k|6>wF zbr#OQj%m{rdin_O&p%I7K4|v-C5s}_?3s#R$Fc3vlpKoTfM2a1<7-L+wa`>H6UIJ+ zR_1W+j|)}LKfDq{hkD58gT1c@UcZk-Gut_oV44t_ku6J#MGS}edm1CZ&WzZ&o-vE< z&q^I7b#8vL>0iy}ud zNs3GHBv+Q(R3Xx*c2I5+%%C@f|aK)9+IGLV0OnHrkUH9jA^SdXh z5j*#;cxgc4!<1!W>&j-aBr3ph-s;>nH4^vWC*)eeQ?nqt{P%=cD2{>tt1lk-=~nws*vEA;v>!-Cm=` za!h{TH*i|qw<1SjyD!&u!s^%;D$L!_QEcLl ze`XD|Qm1-1&OB|NmEue(WO9*;yI6XB5sdm2bcfAYpKD~+X%NIG`Ug%(6#_adnyZSj zTDDF}%a9I*Q0yGRU9ixGyY&s0%LlCW9hT)SO1%fx3uLKg(_I<5FqGLv4;u*0ieJWO zMbK@*Xem`JRIqRXm?uY}cW8gXO+Mq=KjEsMakxsDmvEe1JaLa0id+IcMK?N0S~Dxs z{NYb-ogTtzZ+AsLf!!kioOGsFHlNvWV0Lky=M6DcQhmc8H85%cb@ZDNv5#GG+yL3l z9zQd9n#h4MnB>C_2+%%>q?i_}=mn!>8w-mXB~S^aELMbG&)KT1pUm9XD>v30%!2+t zTW`}Q+!f5|Mp4Y0=lJ;)XJ}#S;nDfsM4>aQo=WJ?(qCX|IVm?Y6EJf?bG;VA6Aufg zrtN_awS)c7j70SOC2-jD zhBZ1JDAPd5G?BXa3k49bDhtA9A!qVZ+Db*vEM3SaP=e*MQepF?6pbFEpn=jD&}7&V z$nzp|^%7}mh;S+g2{_(k@A&uh?>K>oN}tOiX^tqbAVSGkCtKM+!m1SVWU*JBGfqB8U{ik865Rj1}O~WoZL?4|BBYu>DO7 zeR}WxdW`oqhA?6|t8&9H5+fJ?EB72uT({FP%|0()_6$i@77APHysK+kSoCqzXCD;P zHIs%yIPfAWhlqd%L4ETT?)Ep(=O6J*2ktK48vLa-ytx!SRAA$;@OS_4E56(s`T$r! zr@sO$%Zkc7Hd=5YTM{<9M>~GPJ=;TS<${NmabFalOT+c$8Q6RD5WF z53_MFhym$nz^*Wh8|?QLSJq{x0rphC}I}g$=aNx+2T+wI6c?H8Qy)Uy>(z| zf@eBFTCfy?bOtrcL17VaQM0j)Xbh*#&Wz)zAJBsiNlG(cENStnfQX`r;wBAOJT1VexEmIn7*3w(k}UQ-l6dfQk_tmF$BiBfz!3*mrIYcFq;Z;C{VlQVp$#B zsb-NaRI#o1`0CB~`1alZh&TKl%CVr|cI@p1H~NIm4aY***Mfa1=&Rkc`5>$}McD=1 zV0J-TA>0k#vJ?mvtKkqyBvwnm_5z?3vjvA0ngG-l$^}5hA}gv?tc|d?1M5w&cEzHE z!t5>-vfLUJO4iG&g`kCuXbV@>Ig~7d$Oc6*fK9I`on56b$$IPeZFcIm_(E5!pDnFa z9x0|}zI4G1&H7L>NJ+lb*Gaxt?NB`+v_rK)zz~$c+L=m9NM}NiPEa@NIMkFzHh`6= z_4$!^y!Ni6yuEawG)AEXm-P|rA!us9)^ySe6tDZ31s2;$6Q?!F{+z7|6 z=r>z9raFcAp*T$h2}d$G7ikb7do<7qr>KdC5jQHoi^t(62C_I@#oaX7^(GB7`PK9B zCzU*B^7=e<#zkQzpK+iZH`1hRjBVLCRAJUf#6Q(IYM)0zAunym>@kd$W42-pkts{X zt`I8eDf5@b1WqJLPH>$J8VUNEQogXJ@)IA9pc?TQ(foTJxLwVsM0+@nyq3W zcy^xhNrl!|#RzlQ(KN8pSS-y~C~mdI9+)Jl#=}lAoaw|g37Y|~VVr?fvodqm@2D>Y zLbYck)icylnj>;7wIn$j;G5~wYZkul>Aa5sBSZzWc~r-c9~D3Y4&w?ZQCtfY`8U?v=X-G^1Fi&YpEVyn(@)TJ^3jnVZ$>x5cYXg?rb zPgUS5SgoPnYfLCn_ok3 z7Q!Fy;KWgK5+>ULAEqeYy7eHce`pT@ngeGRomkE`t6ST%w^o(0p7Mx66iYvH>`{S;7jun4IS_CtPebEbNY~=KzP$V7iT^A(N{uV$T#i zj!#l6lhs3PaK)5uuv`4+X$Y$)TyYM2_k6Z#dO}VTfsbafxuzbv4y&d)~LY3c%Hu*cQt{&hCbFOlervX6691#6kg)j$3cI^^RRS z4(;gLadff2N5|p$)L7`m94eD+Z;{+rkG|nyaTPY;C;2%UnZho9L5&)) z?7(se)+iOKYcW6%`CswlkdA$N!3F3odfOD3SvFxK>tq7rNwM9zQ7@^qvRIKw? zsJUaNn^Q{VU$Hh?$>*BceB>X*LWRaF}MF>d@yVmEja+%EP4}t;YQ+gyH6kvoJu#P-rtS zx(|l!MmTPYb|dryI1X0|2drguWyu)C80Sn?lu-{(7rlPbrj%?qj5e%mW6S3UIT=&0 zjNvI80g;AP)`@WEVNEQU)|N4 z)uRt<8dCmjI6_i>K}iOFHjeZmfls5Lj6qS|x|*%LpY@tpP3|;- z@Bne(WT_Ru&}YA24#&(vA+KCBg%kgZl6sPE#;+VaR#$Q`)LlLIIg-(wn9p>kp;iU< z$dx>+Jeh->`Y+UzurmLilNuC17l%qivz~#7(q1U3+8TxO^M)~+?_Mn&7)CY)w0 zP6q9B_H&NcDQ7Ixl&St_g;ko_kt-ChZb`}+J9tJ%)>R^0%_)cK11%+s?JRLex>hN{ zpXPwcOerrJB-;4njkUbT-~9Bq_@^(wKuQI*Pk4XdQJAq|!A1*Of5yja!=W3x7+j&U)jVuiP_s zexUCMiY`zb5bWS;*1o-U5EGWZc!!|fOOI}f*8Qre#ZmJMgF6N!YAL41+zuOV$n(4) zU}eRH6!%QHEcX4|wMSUo7A!*86}TS!b|Z8FzBI*)0-t;kyC|^u zGxW}%QM(UtN4i%xqzo8rW9^qN+{Gp4j2h=o|D){C#A*#bC6tQ z^e%QEAe#sdX}EU9OFwY!HX!cOu!~?v$03TF+lNOjh!S$el4fgGP)P?>88~Cy^fWk% z+Cm`i)?IunAO_rm+C2hN?fK3fS_+ga zgess5Sc~P+v|7DHC#<`GkB%aWQrXl`r@}%luG9g54kK8%gDv z>>^vFk!*j{D(UiLQfbQG<*s9Sfmo>^(!y*;7H%v);I&7Vw zP0rwMY- z%5l4+7j;NTp=u=fkbhG{sY0TxCI)LB{i7phY$q`>_r!_N5Zf=Bw&h8vO@k)Q0cpHH zp$>*ZEy#SKq}&8;jnd~lKNty_$rqNhJ+liP;;7Z?~4oaG9Oipn2#&u|(BWFcpma z_b8hWMVe*?ab9Y(mPSrJw&6cuOyY%KlhV-J4XajcOjsCrz7qb7kGQ-1J>Kc>@q9EZ z5pM@*>$t1;SXsd&5V@jm1keMpGu~VpRwbx(FcmNgq!EtR&~JiOfZybX+sh44+Xa8k z_xR_R8$RtFix1L|8*tqLxq1zR0y_jRFIO8v-HNiny1S}e{PW%XeX`}kZNH&xgf17L zb)x{f8eX_!D=QXiMyG^=y&FNgf<$rQY6m1~VDi_Gt*cRmurhF81zRPo)!{B~+hpG) zn*~r!0k&d#C)AU7t*d5J5&<&Q;OSKtUm)hEQR zf2_Gqg3l>|by=3!<+IEC6>#-B;9O!Eykl5um$U2YEydPzsb4je!FP zb{yEF6Hhus8k#hN#*o!LfI5U3#CKq>AX-6Ke9=Hyb-~&TR$=QI^d1yqQ`5xN8gk!= zBH}dN-p@i{wn_$Y0Z}zlF~qJ9*nN(CD6~#JTYjQcBR?^K>QMtlp$i|d zSnc^y*sY^B{G%Vx_JUjch?n*W`|%O2-G++I;RuLhjM9MlMJ0@V3?=nG`x(+fG%*j% z?naz|ZAkNnoWv$u+CglYH>jcFH!F`3AhPEER#R87*Gy=i%RKEq4DL=E-F+B5Y+k~PTPICN6ttGLxnhv94xN^yccNF;@)#WZEgcpNy>&10yM?6e&LbF!}5ooQ^$ zd06Ks;W18~L7b$pSLvB(mQ0}Yy`VV^Ojn~1tTKlPO8#C>SND2Me759`gaI z(a$*SG--Djuf4>d&t6_C;KW>v#Vltrl2aW;41T$kHDwyZj;g02`&9;Yyc7v$L`h=g zybYqUC8gn{)pNKvJEa9_OO_T!C(0;>+M~%ztXYK*2v`ao5`~q3(rr$M8Z?GVziuUs z=Nbj->EMrCO%dcumf3L_up5%}lc+;t{3em;n6b^D9j9?f@%4Kgs!AdZ7Cq%4K{0I0 zlmNUcV(cD3BV%YU-2^Q~=zglYebjK+{7chHJAg5hj4Gk`6OA50&Bl$WFCjhIV59gx z6yec*s2S*^(;}0uN71ynD zXDHIw@k6qlm!DqyG2u3FK+#yV5YTl;mn-VZxT~v$+-t#a*N%_3XFRPhs8mtZva@e4 zE1uTP9(vTUE`nMXyzBz$H=`(10hbC@#>?#)*ITzOzuSiv0zNZvaL51n^>=vt%NP9l z5DHWqAi$!VU*C`uu860~kg*;)yAD`BaYeRLSF z(JEoo!$xM098FKmXr%bk?eO{x#Z~P9!$q+&;o{d_JAhla{Bk$^wQdeB_!p?raBQ4|Zz`#A- zZLS9hz1iW;ER4I^nR`JyI(jQu*8(nLLorYEj?QC_@56jis|J%f#4@|r-m$BJQTDFG zKH8+?s$xoWEL_7jO4%NN-U}5!gO<2g5>gPv@7Q@S6hpbrN{U!`G65Si-d$FF_x1^Y z`0x$B|K@wVfAcjS_z|T6*bf}Fqp=zzMQsVdH=t-i*%#DSP=v4uqX`pwb;GHn)iuR4FK}W9ftij8zNjU?2#D;ZU6J zKX~(Hvqb_rx^;aryE;`JBnFT$N*7zSgfcV$8D6eLoZxft;V>PVluhl6fjzww7Gvu0 zQkpTQjgD$HJ_wDoK=QP!Lg2L}=r$BePZb_s-^249V!3r+I=X5tYI$aKQ?``mIfO48I6LLVBXd5&;b$N}``9iZ-fAOh+Flm#do zq0RtH%IIVrEVc*@Gg2snvX^~>kvo%t?`KYfryuNeh_y7WQ%b4+ zf=>|0RGs*K;>b(0(?*1 zUM?Us%Btg_JHb8qU>t&v%po%HA{2x2lmV1dE)c2eLXnh?*-sdF<9NvNIQRo+0?qVV z$6=HeC-}!0E?xtaDE;{(pMW&r#R1vBTgHU#oE}AIBPaRcTqu)1)1raW@aOqL+umm? z=6t2{b|(vZv&LnT9f8@sIaxS5G06kw#IA5-z8hrrprQKsW1kc&7R{7bfvT@iaF&geR+&c|`ZuB*9lEIn)(>lKFa`?8lny zN;rX`rm{Rgd!bP3$fhD$I+GZj?A4)q(y)VI)LH~_Z?3=PG?4R9AKDpQHEi)-rGupG zrB(VFs5QUGLDr2=H_5P;A|G1m6i*%p_Rv{pXIV-hQ+{y90exDd$Il2E7N0>7beIt3 za%{gQ>~-4F_Fqu$3huWDT-Hzc@?r$PPd5SHGq@5|8{R)X;;V-Rm%2lm;ze!{Uch{h zcKr<-uMob0q@gh5xpf@31C=dTr;%RRZKHa3SMi^J`3*mRI`G}L0bTLqmmOak@ZDMr z$fX_oP4F87Zyp#+?O19xD9e{GSk}!B++6`aAavlmcYN9fbv323%K=3LAB;u?D;O08 zmr`BP1B4FLQgK&T^sabj+tSx!DD>vgn?e|e4KQ%ofVUg)P^^~_aAf;#`J)=2zmjgE zo}*JyXz}GP1NUr}%DZYj6Bgh~z^7&;()cVaaeC=M>z++@xJpnpjXM;`b@iX|RO&Qn zpo20Q&s|N%63ki{85J!if)M3HmiIt1#?s}^zuz01!v`Ixs@CU7H1dcVIlP1^i1t>W zJyE#r+B*&rbnUo_;1I>34L23MbT3H{yC_ra+{f$2 z^eQ)qnJLs)AU<{I&%B?}$Rv_0r%=oHJ{HFJmplBs@4v@i{o$|h;oS$^-```c7ZhDV zw`M^ncXKeWc25$kktjW$`vfVjwl$zpN9SfekkzU^x^^@imV@&eiKfLWIN0uwy{uLz zQ51y>3au!#V#S6v;4WQJn}EALkqUW!E$+kO90fm{DBI^EJ452xC1ijXav~?|GGIq! zfoVT-1o4UIW<2Oi91?Y$Q`x*N<9#`jb<8FRvalIM4=A^B?j&(aX8;tzfG$w4Xi~AB z)=mdRyA6lhy}HB)!pO}*9OM7rY~nmz3F48KcpW0#VZDTm!eyRaMSymowJ&%%KI7UyWAD53 z8gxG6BCZq9@PGzt@)!+}C4s#hKBY5q`UmI6W1ZHUI75mL)S^J+WZwXA=m5o_`LNjR zb?t}eznjsG(a6f^#qxt_fVQ}y8{wUcngG25%LXhfP&S})fDZEiX|4x&bvR2N*(ry1 z(;aaJgKDxC4dI7o&qn+?(aSMV?CIZW+C-0E8*fMqvKbLe^NGNi0ce}buxvIB#VITq#Vw$b}WgFu@9!{=%jf*$y2?(SYA1FLAPx>O|?|{IFnog~SW>3o>#Gp-c_pYI^t%$$xy4 zJc7aJeMOk~^04P80U|4;jlur(no>dybIRhGwX?@ChI6I@bRJ|+`Li?S1`>sHI%j!r zv^!TzBzzm|%zEX%!O;gft~E{M(ph>iH&>pSP5Dhz12G20DMo5~kWf+;!xw+fQTk6e ztfiC|Jd9V$sGf6_@m`!rqOhAdW0n<!dn|I&{Uh!rG!`z%YlM`ENsA;*+98In z8E>#;d{!!^&v!bSRHI?(&QPit>|{RFld?+4mg?w@l(|wLPmYYT4j%yxn(sWgMh|0Z z6;#bWfHde%7l8t&&-VFVom6N(myc&VKE{D?zVD)fmv+PBR#5ILw)+a*U$9Wc(FC{S z1^0zkD2M#qV&%UsuNW!ua7PxGNP`?IUY>+ksz;V7U-@Vd(9^r31_j$8n%`fEGpLhSq>D zyW(LL?ES#DERpOt+fA|F$yy336)-an5)>vZSfJEUN`c4@Vz0>H=;rcgv>)~_6}Xhy z<%hy{Na&UqsZ>$9V<)S!u;-@zOqHww$i!U%LqRbXsT^d*)XkByIlIk+D1tM~VsOqRHaP z`9cw3CqgYc7B=vr``!T7W*v`2IGR~M*G{O#hg>SdLRg%x2nCu7nhLryZqjk|j=d{( z2f7^EaFdQ5ikli0_VCwNqQ9J+3X#o3I9otjEw@>42DyozT|NVfrgOh|$H4o`ia))3 zi$A{qfZu=k8ef0&J8TbcK;4L$)GJ6U&~_*Ftf*Shm9dwOMpr=EIHIwb?NJv7FFX`2 zVMVXI+jq?#+NGh3DRf#1Z81Bkl6O7Rimhx|X~U))YPVwZwHK7$z`dLBr-0I7@DOrH zni{d41S7-Nsg0^DA^}rz1(4^0P`lZ|MI4G!h80u|Z#yGdA^?>Xi*h9rI${XZlBkoW zIi7hD{UOU%>M^Xx1h&t&mSK^k$Ox*%PCDE+islMnhwzS$=ADf?I;JIwE#_E_+#3>% z#lCiN$kI|SxLcmE;yqS+i^uvN+j@_(T%gr5gi@=!lX|KV^E0_q^C?Ab6b8Z(4my7a zGZ_?&*j#IX6IQP1`!k;R&v-t5!+yM&#We$*@@hK`f_9IYE-vF0Izd;bTgT2klqeuM zhB0qG!*Ld2cUS*BCTjML9nfYs9oeH_Fa~V`4*O?lYD!=O^dM*p`?`an7@)=eDvK$E z^#ZILp=RHzbd>yyw!63>+~00r zwoj{|PS#o2E_JAXX5AavBf=blPuZ_L4moA20;%uF215tU$UK}=OsR&)8?ULs zZ_WhF_;cd0$TU^B$a9RJZhB>Hs}@LbS6Jq^O<9*h8iUh%f%DPzw51lB%1>C@G^xHh zlX?o!i@1WNvnMkKSDqTAWbi66|sF#BK7yS9-XUpJ_Vm|=Lg74lw;=lZP$N%=*4Yv(= zyd%g4{M}2(?;GQPxqpvU8UOjy&$ty+ze+XI=|K#6dBI&{ESEc=JDkUrms=6EUhw4* z-1(ndv7oS^V@DxIl~~_QQ4@RTnYD;@IVUgz*fUbWrOVQ=SXS5+6?F;K0vfSpmo?` zxx>Oh=?;z4xila;-;ev)t15PX%&wF;WdTp?mg5bWO`${;PxpGu58AJ-P^_>Xz#jKl z0$4n^=B$pcHXL%U?1}zRnrh#$NsE6zXeJ7XUWMk;;gFJbB!4q8?mJ`hSl>ObZob?{g^>sV9^*>Y5wp;TR0v?pgJ z@@`Y{ZQK>wKI69khUeoKytI!v`fhVLl5nNo`8P8IQh* z2bP6UR-kI2YwU61LdzNOGK^o^(_Vg<8j>=R6@}QOzd9NXd7CF46y!H>8pzgZ_e-AY z3_}PSXgUDyWo@BxBR2sp~8O8A1h< zBqvWgq6{gSh6S@v1qV27BVzbFIcMdp_=dtpsdo-B?9FqdTT>(fZCq;zd#n#B;{zEo zJrdYOQ|DYfT*B*}vlpCIohTN@`15ptK9Vpq$g4boMn07BxWxL*loBU-Bq=^&BTix8 z0fEsnZFKRW&cM`RrNXdYOm{h-RdwK$O_|=R#H$Qjs3slB$&_RJm0>=9V#!&!6AWhn zX5^L1Inv-KSjen+ptNc9<chzT*Fe9l%-G*Rm}xLuhuB@TAk3A zP^(7I;CSz1XmLd@Rd-Aqu6Re$9NdwzhLP2@mft?E!%+A}GLriEdSO$g^wmyI2~4TL z+vuk9pHMLKphctCb^Lps@D70i2PFBc{S`*ye!A^5D647Nf~nG~56Skx>SLQDq4ddI z%P3`aKj1gXs?SsHjL3CQbXNwW^&1xY8Y^8;dckpP(AKf>9rmN)>B6{dgtFd&aX4wx z6hrAZP!)(2@Ur088y3F{AGa$?Rn%%3!Q%^IQC254?UWuxb+w6R$()jpQ{K?5vk@rh8bY%x^|p?XiKilEozB#@-4DR3b& zS5z@;VJ+5!xGAAl#Rf$Mp};Ws&tmlyL&*~_ya(_FIUDFy<(^=+(O1CPHtoa8$XHW+ zf}n^VKqG|4>StQ} zS$a@OhlpYA<|bN3&!8Q;Z3!aCz*4f1ri+;-!E_f&MQv$Qq+ng{u+}GRc!N8<$9?^P ztv+Dk3&0m>EkFgNx>cC$DvPIW@$TrckOzCrL2UU!VxMk@V=`F|l+BZA6II)Bv}b(U zf5GS5kJyjjAia<0IB5pJq+nGDMIp?(RXt)~B<8svisU$c(DbLf#X!46uzIR_jfTy0 z40eb8B|9LUY!LJzQ4iR!KfLZ}x4)004zcYc%R(qsQ5Hg70ou$a$_uc#Qn;*)WdX|K zglA2+MKfvm!#}nZlny_bIjT_mrd?5omqbZV0_-@BYO+9499YD&RQ854of2+P&dMOA z%vC-(>byXc-;a`xm^eAwCdlk?lJbsB2cx zUJ)(hBu44LoxUvzwU(1%QoZselN>cGM4FZj{#l^;dj+XrIIP2YAPPk>vXSXpoS8(N zUXS@t1jH#pNoN~#w%}^&2A#mx7+g|TcL;4dhpy9?p842WtuP0par)G0sXV>*NKh5e z57xh9kS0?lvQrnET#*$bIRb z&=io{6)Fdo!r1!`=Ebz|a>Ke6a3w6YgX)5n3wqm8uo|{sb|@*+o zZ!d~vv0>we1Jr#-uHuwsEG+;hdk#cfsWXd zBOAsF2wW_i2d8%4EAWYJc#s97XRS7~c^xB@hgpl@!vkeEHT1NDl0gmkA(LkHMF1$^ zOQINX1G>qv>hfm{$8%}q94rqQYFQ9W$Ffd=1{vyIbE_%553G3&#}R6q|2Mg+7|-_} zy`M5w%c(9VLMLYW8kwPx2FG1zwbNK)`#CYb5BBe^bZ09lP|#77a0QHbDb@Q8c`hzV z(6r$Y#V#E;QtSoTD~ztmbHF8<&(T8GrRek1sV*c*og-SpDLYvRxRio7+k)>O?(w^~ zkND$vU*iv7e~+i_3AI)*-`Pq~I;eN>A<%A0Ri}o|YRiivXhqN$Lg%Zgi7NgK1BBQ* z@fx5~ObrqvDXMyBUSUXKJBw2B)rZkL3sx+;;DQx*`hYuGj9A-&MHU;};!TligM$dT zyA6?OC}dE!^OKr|G$3;T`|(UcYH%r5gX2)|AZZSzkrA63c{o=4uu>VWjg*hT=o^R+ zNjj(5*(5p#B0?bk&lCz91Us5{1zPUVKvK=rG-X$~X`Dkv8#=mCMzKS2Oj_Bp=iZrdBj?uu;3jwJmFH`VOyS1>IGCQWU1(t&}u=iu}l)b50FnM z?6%Pm6r7*VcJGT=1G|NHB|;rHrw+6$+VLB{>_6f2{!e&5enjiHlp@n{wx9uxnQlAD zXF+{sBZwWD=S~CSZFLc9q~T_2v-*6G!zv`g4jSs8MuyP;Io)DVBpU{guyA02XIxwc zFP7#j6`%@m41k-07E=eyO5oL&taSzIDyR#A7oeVD8ZL`x+up##Y9x*W?yUKFkKp!ymJl9Za0oa;W|F}QlJOvxnf ztOBxP^a3J{2$X;j=Estm>(Q*syiRRS8z!axM9FF=a@U~Wh$Lr{awuHqU^>?mGcM*z z3CVnLQBp5QAl?9EhGX@1tMjJ~@WPB{ALQVyIg$-}vwoW=9GB#j|4ZZC zG#8N_-pMVunnqL5dD*1rD;dbw#!#~DGko1Y;`!Gf@E{vDs<`kIq`Y8V8Fy>NQV+a+ zxZvad8KrEv+ZZedsN2${AB2Tg6k4Dx=yITt9sci^4f|2>-+yiRug?eCrucRt++U2y z`KAJ!0!vfe7vN1L{B%>i+zVP&d{YSWLO6EdR{#&bZ0gm2j$N$KyI8;6OILh4jBdzm z2e<<}R^GsISnYyJ6$=%txPY{y_Z?E)%qus5OhsJi0^$Q)8idRzv^K_0f>Mo$%2iPp zLM;`_9mO+DDh<02sf7tE+3=9BONiMuOy3QbP7jzS!e5cT)Ue6i@mou`uc{NZ%dKl zUnIJNMeV=^QAfbf=jp+OL*qW_>S2oR%xCX(IdsjS2tDNq1!sTd=toB4iPOwi64~H4 zhu(P)jrdsaMg@Iw^`VLlYz#sbps1jVV3Ce01>6fbA@2`W+*GV`q0E_ad_QT&m-l^{ zVUqs}tUi?N@)y_&x?;jaZdxK<SDyGZn(Ua#mys^xN5*8F}%RMgjJr=yd z!f$Y2-(#zHRy$D_^rfONgrkrx3&<2HmV?j(^0bt(<(bG?>hbZo*&E6VMfq97HA$7f+)h`3+zWSN0O?_R7#{n?97nmAwo_|g*Rb<)`C29f15H7~4alR3So> zz#CWD*jm#>8tPCEri~@%euiN!%gJe=Pm>!0kV0t%bAIK*_%>x-9ruw$%otS`^Xrl? zm&gZvr3t1IN0ZIh>($~Uu3M3xm?^xR~KVMiW=BI`+Q)YAZ) zR7%2$A~`?!vr2<}L3ij2K3$)2d3nTL`x*Dl(9-aDPoT0x3*qtc3H?jMQVB}|7#p}+ zzEtFj`}GZ8oh0RN8<*n6$cvX zK{HRy1;v+kT#6AD^%xuevY1_n0Bp3_*A{_lfudnqtU3Y(s7pazDheBI+j3lt4#FW; zz+Bk?AT}(D;mgOf2q+||3|yE{+5CfDtx(#-at6mC!bO1%z(=-$abZ)KHnM{I=dRE~ zSfN-7P}s=Y)>}qHL5l->sDZ)BDL#mfp~Imzls=Ez6^#ft5QxLRbS9rjik}R9n#n1S zWHx3tBs=?gqq8Y~&9i+fKGVv~2C7b2oXF|1H>iVxROdqW{l(8zMxJ*rF4fI=^bm^7Y^n;NhxhujNjvJ08tN`RIh`eRY3DxJXM??imj-Fvj)5IQ4vLX(_X#y} zXb1(Q4XVZC3Nly(-E)Lp8#?TBE@BlNB4$yKEF24lJB9RB1AsCXzF?~tZ1pWJ`~e%i z!&V-!mV5BBf_Q-}701G8i-YzU!xrOvz{ZDtcKtEqzQLmw{$UIkpq2SWxI z|FsLii=tKqm4b?~?Z_6-r0S>`amhCdnckIEDKL*-p!nBAOH>RioL|Q{Gw&h?6IRP{ z%(iWl!)lby#K5pg3F)*gCYxqf24)C@y|`7zz&G~fF6-M+R%VH|CRHjEME&4A=!Keg z@;X%q(a8!N9V=pg4lDjbeK@NX(>uN?8su z7>i$<;-AGiPskX`FwBqsu;;T~RFhruG&n^cqJKsyTN{&t6(E<<*hw=tJO@9Fe;$Jv zC)IEYdHPCla<$EsQ&uD^wNIJ;{pSI6EC5Dalv1UMACg)B!q32i{5e0n6R0&88`CAP zu1rW8Kyh}t`e%w$jCEx3W{PxbzvD^5QvucY|Y1mE2ilq>MxpF6IXuuT%S>ZR%}Hvfv}20R>! zO!C*s9YRaMc~5dyranh+nX~46}KjU9Jnl&MHB|M zx?)}K02~luFI~6Iex>GgcAlRXUv7@KgzOns0yj=(W2?&8T`k~Z8~4>qkqsK+eR^!l z-3t_SI4v_U@(gTDSp2!tJcC#gpkxdh8c-V>gsRtHEbQ50rs3FudTp33#c{xg7O$F^ z&r!cuirufeAU&(j;4Ni4d}VP{V#%*|up?oLsggcV z;|VB6y##>8K{;{H;81~zXAE_w(?@K~6~?0W{T8vwRwN*}6N(1%d?=@yjl8T(jsQJv zNN09G7S9U^k9QaR?!z1W{;%HSt8d@o-Q#=Q)kiF{fu(@272JG?Y=kZiLTsIZFrug& z>Qu)D_`%+)B?Og?AWJtx`IA(iWS4pWbG5FMEhl8D=nJE7fGz~CjJj+nv|!VMRSH&R zR4G`Av1*WHc^;g^%iH<^^c~s`2*nTtSDpO5Wc7je80Sf&i~2JHbtqaOo_2mXOv@+qYVOP{26Obq ziiM{3k=-&CQiLT86h><$7Lb6D0=4+0LcXTxYf}`O8GIoL}EjARE3;92%F(|SReKr7++e*cr4;3)TD}jo^ zkm|`2M#;LS;u)wsSWW8Qpd^xYwb&cT$gDk0hqWwv%`U{5&gPJ7lYMmpK-h)>2ij<0 z#!mUD{0HdR^wH@AXCD$ic^~O7)GF%_G}CVx(12tlQNN+bhGf7TrnPm@5nZL5!f0$& z;`d|t)+s3igP@p(*wzQ;sGhBN0k`-FU>gtnSD>6Y+>DW!GO~NBN-;c)RDiOpFrijYHAczpQ1PG0KI)|9ArV~T z^TJA=^R+{auq$3czf0p$K|CxR-;)lPC)JHI7j{}pN5u){3~$;eo&4kenanEU+#aPZ zqo%kjCET_R)I&23Tcz7c19o+01IN2QoeI<3!sn$_xFS?WwaXO2X{yT+)`uWh+n9yN z9uk~@IawVBrIPt^kCe2ym;-1JOVc>0N?JC}_Xrg2q_bCa=1K$p#G~56tf+SXjG>X7 zAUYMnY=@Q^aZyRC<*S@w`h0)U-|(rv!H4n zjIuV|Zv}TK`1rZuvJn39P9Y29e<~I2w<~_UDSlzajetiYZ2lgsLO8njMJb_ms}Z1M z$D#sV7qni$Sa9@))(`tWhN5eoYqh$~vuxPAKzheU_h1Ej{}uUGw~*PM7Fr=-?07L3 z12I;%^5r;uwNTB;n1@BJ48D@pQ52%lYdtbhDo}1?IN+uO;L%|RgI0j+0W={rQ7rCa z^Li^&`ikX*7ExD~tXiV8+j0G)$D~*pxUdaUTLD(K;V5rZG?YZo1~;|upZpLMRBKI^ z&n{*K4Ion#tE;OSJ%76WH=4?!5YHsG(dn9EWtjg>4$25cu%>~q#C?tuz$Pn=*}>qi zT@xM9mpG?XpH<@d(eqNB?a%4OzJ4WNfIEHCNGH=)=!U0p&(2C=+;;$!Kx@CcQ(Gmu zzlkxH)C&>5xx2%kzWspT|Lz-n_1#x^eD{P)dBD1FsJ)t+*P9Ke+C6$J5WlC0ms^rn zn``!Fq8tE1MIlCK>-MvuVv=)|87Lh>j7EaamM@m2pf3e|VYDjXVrB59GFHCB9adaK zu(pD=nFV(Y-R!$raZF=xUW2hix`U!ra8UCB(C?YdPPA07l``H17IiXsIOdGa3hFKZ z7`TN|z#JJwdyd7kN9BNs_`p-aRKeU)ihUqOtwe-^dl1HBwQYnwHw;Ha(gAj7n)y0G z+Q#uwo%RyN^E^5Ro9`ysO30`|=@{1PriWdRk%yCRmeFvw#+fCpTWyI!D0RiM++(Xx z*vdPs`+Ei2o-Bl zER`%+UBs@zV@Jo1U2hQCC*TS+*&!$SASm^5YLt9H^S(-WZICaJ4uy91tf2jK9E9Eg zITUm-^sqrsb{_%{ML%pXG%KkNODPUlWc~h#O2DdM9|CDLrH@v%|9t^yHL|D?Mgc4~ z_yur=sxJ%+jlW886$+tJJ{xJWb)+NushS~$sUz4)o@tr2YZD?d4_%7Fd{WUy9*p!< z*c{ssbs^Jl|9%%Mr|eh`ohEtgbR3+NQypZ(lXXl_qVVZR*&&959vc|A%GmrMOGBj_ z7nQy$h#wg_4;d?s+@gA35T~KhH?wMVFN6X(Xr6wdhV?fMkK{6TsDUbT&{Q8-C@BsT zk}(7SNL$nKx{d5Vow9^+nAcN@U{*#b9lg&(U9Kz`hv*^e&|h4K3bzTU!3G9lG7Vni z7_E62qZ3?%Qm>)9Wr8BZLbFVOUil)Yb2KGl@8IOY`7lpy`wRsF8udTB1!ADQh^i%=IvH?@Qjn_^{r+Ryu-qYWt;V%Zz zdChPd1kUOAzMGgDOizr!ivz?XF{fp+{7Z%nDh>=7!O$wgpq30m@Dw#|< zXgvwGQ?OLbqVchc8w;0FG@kksvz10wEF-6W-7Bzvc)-8^!~YZIm;Znt{?q>pkQ@50 z*xMsoFZiMT1jT_$6ak@9?QB{^P&=jK90?XbL=4;G2!{KfHOwz3!+B zflz_tz~k~@ihogbW%Nq;xWAw>;{w6n1sg1j_NEeExZ!VKI=+7-;92p*i-BG~-)#F@ zE8(iZFE`71feg~JuGN$WAxJaCdtF?P1EaZ33)1bJSjiNNSyfq3YeS(~P_8PdvJSg9u?>98c38YX2O9qX z&{)AmEo0K{bvwkayDkQ9DP$EDD}V=h-=Pwo*&waNz*2#SYPrRg$%@+juj2i8Dj4+= zlE^vY2(q4FCrDOiaXX~wV1t;=Q-GV$uwzPc`iP#BzT^K(9?HyGOGyE(P;6v5%i?{j z;i!OOXhEQu_ysA?FQtr70PxCmkE z3zjCRV(tm|=-M!-hfRijIKuyc$d2Bf>Wc;?gW!ZsQn`4YLcFWp21KH$AB3t5GBjsP zCkQMJ+!^s76jv;LKvOv!#iyR-Ev874Q_$J&_mv|JTgGa80MK~e)9o+2uhMC_ykPGcaNZaFxoLaFCmG_r$APWzQ15{=$oWz@1@SuR+Xw^-^sRDJ^S z1}dxlY}E#QExvJKTc}dd>x0|ijtBx!bQvy~PR2(aECCmYhzi&(qqVptVF@aWZS&+cun5sL=#2^*wO78_^(?5UyAZl%0L8mxW7wl6kb^*nJCqNvjyM3_71-6X zgomqzH=y5u*6i!RZKI*a+Tf<3LO=|HtCi04s^FDCD}gowE&k7|kwl4UsEJ(dYZV^| ziGA_JandXxEvPCHaGmNN4e2EAm^^8GNO!%{3GHkL9ppsM5zQiNom9fXexTEKZ5Gh` zW{0eM1Q>`8lZzcGKP-CVP-qWNRt&DHiY8HT9(>I5_^Ja>6I?U4A&GuT5njyjhsfv+ z?C*T7#-Ob8Fo*F#n2;D&@m{5{m?ag{GZC8oAE7#WSUL`l>3n$_)5iC%a|kEVv@!9* zQKSLg->Vo=D8X7r_}{xG^`sMrB>^~fI{9lVlZWp&7ETHX&5XloIHZ|(qPz)qVk7H3 zcw=s4HK8ptdc%IsGL;*hDvnTAG+z&>lc<@9Hd7ss3tOx>Ha;U^^BbZy&#^{N*|%)k zm2pwdVpXKi6Ha?A_5QnIDGOUM$*{MC1y*=&>uHRfY`KG^MA?Bny>dzoP67^q~q{w5l4S76OEVR=O!c_Hx7!^qMYrtIBUy()U<_Gkoe*iSDkkqmiwV1V1(p^)2SQF4E(0}*2tFx zHB{LxqiHyF|5yZfjqvqG_Tt_M&VhbmML6lUD|ZRGBPm8Swot3U_#o8XY$EO9XV zj&xJ{csy%5_I@=84XoVSf$)ZVP^VL}sct1A6=L68*hedicc0PlB{}`m zj;sfn;uz0pd9|M=O_^`FHPeT(u2#blWcR~gHBE%k_}t`L2{#~&M{}rvHHJVUtfbhK zu=o;?(|xc5IHJzMi1O#UAF)K4%Cy*)^bw52S@m;5K3WW(4^3jLdUuFSFSrEeGD=q|gE=u29bhj-@jJgyt4w zd!ZX{P_pbQ+=dxKE}?*>qlo=_8}=G{@%*IU1>;R>84o1u|3;u&Mv?;xI-1GM`P*v00}uumV88cGMy zJNa;^Ljkl5A&o3yKWr$J0LygGGB*r+Cslwp&;D(u1kz%)64(f(npKom1vUaL1gb_8 z1=|ojyH|JpQpPyjA%X(&RkzgG!0uRL+nBCr!n@yaU}akTD$wE%JIPQBoNK_GX%PL zsC$?>Crvgx&BfbE7|aUAIUDGQ4!5R`R*a<1oy1(CVgIzRIBm!0GLm@J`INF8$Nh8- zP@0uTrMc3m8<^K`8tlRrN=X~eKiYX71zsKMNuxxThmvi;8Nn2PGf5OfRh@QGJt?a? zv>}3=a&J>U! ziepq94Ai`PvM7L6UbM~>J&iiDp}Cgg+?hIU+sd<`dhQU;x2nm zsD&7L%&?UcO&txx`m3WxCtKuC-JD}@kd|+0SRVMK1R8oZecHX2XDWDre^in)B3ngy zeE%oKQRQU$RM3FVOu)yPKs+jh#wUPrzdYe-`vyDZPP>cDgeux^hAQNfPBR%lrv*DtuM3sz#V*eUSZZruei2Z|(_)m{s!k zO!%j(;)f0_D^NQiVEnXq+~3c~UQxE}8yOL=i@{))-hh=s+$_MMjEXqO6zuzs+fA^y zE4cIl8ClAPqwS-Hz-}+i?&YqalS}5rKqCS*Q?8=hOqD>w2BS$`eU!reN{U{Z-wS+E zySlC1^FT#y2oeAnGS?D{Q6jOpPovEmhntu+z4}45z<@QZ23DyH@Kgy84y`E+%a9eb zLDd9k>79H~QtW=M^~f5}Qv@o4HtIPxw~+2iLsbi=Lzu54HyD3u$|VPxwa~n?7X~T_ zi(7G5QmjsDU3_>e=`+1kDt>n=rHJQ!B}F#a7R5!({S!Zz60nM&Ux5Lr2`g!FaH5o{ zND}J+#AIbr91z=)>*?;E4;qS{8hNcfs!-AMx$GZ}8o>U*X%Yzs2MIJFM8i zz1Tq1)Bax+I2zEziL!#;1pBe$=m(lM`z$h9O~gU~A68CZkFg{pW=Jh)8_+ia)dDI7 z>}W)C0xdZ5l8Pb+Ad00CmL1r3!P*2DVJu2mSy7^kj>SvcrX60%Kr2LorX6VF_CL3a z;_$9)>$p=^U~$TLyosTHl6%OyFE6NB2W*^GDCpM=lEc70YD10`U-CH2iqvwZQUt=? zpPS7buZ6+f?2je31knfURsSr&zTleZP5W?2i?tHUpqr4wc3f9Hq1L~ zL3o1xC@rjoz`CH84RyI-S)WkLJ1l%}mQlU{^#UmyXsysvoaI0%szhKdiTcZP*$)^A z*1}Nselhvyp?k)fZ73|(?MjuL$fQ8)=9~B8SQw1G$Yuuratn3HBwSuT{ID= zt7@}>TbqpP2tCN+qTY2Q2LUkzHUe(uST=&FSwxL4YQ^+&IE+T7Yk*gCtrUmF&}Q%$ z-T+=r{VN-RHUU?)pVuoTs2W+6t1l+1f(zNgi|tzBs9{qba!&{(6`0d{l3oT>g65hW zqp&;3N`809NB{+O5=El$P12vFjJx660YYQjY#M!hN}NQIvvIn_R#~@ zdZL<28Z>BFOm$`tkw~i&S--GYQX1|e?}SNJ9MBk=SlW|M*)Qpt7f!$lj4BK|DS;Tl zWDbE$G?n~D4Tj{jmn(C9o+t6j10Fxe;AZDMhOVT1EL=O0!X3HDhykFi~$AT?r^ zTc74+=8+e(xrisPRHxx{D9M~m!esf&000aHcMO-NaL}n1MMrIcQkv;ger_y0bb8n0 zy&jbkk5+u95vqrb>cy zJoN-V8LB2yH_@otNOOUjm1n$vlv}xEs=7FXWQgM{cejU5r5TY^PBhY-`O8DN#(+p^ zlNDJiomVF@&dY?M6o%SJgU*&SznW@w0xJ#AmX1MrSY;Xd6dbcd@`BFV5f0!)~xKxuq|sMu!bs=Av+kB;<wf-+9?8kxDo}pT>dB0+HTjxDC9KHB@S?0aSb3RIKQgOY$ zfgF4y2N?uHY)~|7r+;?Y?2|m|pS)n10I>Lh6X>gLs?BAsScaq8zQ2uuYtcdOgaXwG zo`)~VJ1qATy>i8eq{l*dTL}+UvAC0OfHHVGOcYkfAY*u=K`@Q`MpPihbJ~m|volv+ z$qn+R*f|i*`oaf|b5vrm+h6_rjoXR%y@gyw8*m&bRwyEJx<|8|fXgAJE%wR7waAQ5SqtKsK^}UaSnh__b;szhpzS2&5mNcA(yX?aEjV zMePROsW3~ll378mQ^aB+LV&XU3=%YW@y1I03u5F1ea74YxNY{r8+ zO6U8jpm|-IgAa*J)gwUs;vrW1_W*}LvA!zV5Eg1SASuJ>4~ z)lQUBQTX24(aQo_2wH9EH?9VI{~!j_peWg&&z`L;W>>d7tT{n6FV=mQD8vpJE4E-G z{{fB;*{`_nAMttr1uy%r=*MoIexSs>OZ0J%X3hEy&kwff614lT9&RJuZMf58f@6#v zYMH^l1AX^e30DZ=U#G{ig&nF@?B0xp!54rwQwQq`&{}*bRFoB{F(ej(Rzv7hRd8h+ z3YiD6t414GV0)A&&%-x~>Z`eWdPxS%Ax+HVgqD2oua@y6dlptgnnXNPQ$m=u0DcS# z>UKqYXZWQ2VdM|tX6EpA^RO>MoJgwdmeUCr3EGko`sN@vd86}C8)0*f4>82EMLcX= z^Wlm~cZyrG4_7lmr>}B`>cgClB3K^U=9xfBQ4XwPoi~mjrf>(OgKCspC#`3`e*QCw zDhe`ihvxS;Afxd$VhHC+F-@Zbjl5DCwv*O}+|i;K15EV)vFa&LHSD=VbmXD@xbB&h zWu2-YrYe*3Xc5Rp5Uez+qA{4}&nZp2k>;fe z4?maES@Grx&z%(+!%6R-2Rf^lg!DQw&7?vsMN+OW@8>2YD|MhohI`m$^<;=1wrrL2 zwp?`#fk7di6*IBq=yOSwJm?()?S!x2{2Tn~{@>vO#y__I6aVeyZ}HR1GwzP>(RRj{ zFF#mLLJ3?N9^XEp_7&ylU-5D@tjxHpg0J5&9>@uWWGDDbS@EfV25ZB;7TlKw%njS7 z=<5w_V?2L;hPH~e8r`#30H_YC`3w+Y*{b*Z0Sgu^WI;Aj!K#F(#jK2nSV!N_3*oX6 z{w)(eH9=LvkI#x*0j?gE+;_t5=x9|@%L?*33F3~%yJeDuK*h3l4IMB0f#>4}Cg5Sa zGn*)?l_?jX@*U7_IQk1f2bjwM7(|v>q+4A^H$cP!MlmlWdM7`$_$NQ?^DJo5Vdaa> zrTDXm+;ZwNy`)0#)Dzgx!P_P*ZRx+!S~g9o>duM}lvoR|f71aL2$B z*~ZAF#zKvJnDaBOa~BXM0hZ}_fDfu7_T21o+aAz1UlgdKb;~u5nuh>5dIoagIS>|2 z+1a!(WSC{IkP}puu)v6|vukkniE}3(#OyVJs5vibf+7omMQku+AAp;GKo<%M?rA?X zY_8o^M5FJY@7bAr%6^_+3-C}YzS=JM_Td5VA0P1H{tk~1Pk4L(h^L3Qc)WXq`{ja_ ztGPRNLes+ut%9yQ8V)qb%#?K-s6?A(LA@ic<3J~)W2=~2V&B(puYr4J$q&C)Qf{Ap z>fN0hR}kL-WfUr4T5aeMc2BUNUK{F-QJWQ+8zjZwY*-c-VyY=|u?6f9WzSR$yUW#R-M`(I`hRwFLQ2q4|zGSArePxyTO8DDNcpb-)p!yqw-{d>7hNQ~@WO24a9L_I^;2M5xwjm1CLi<$+z5_lu%g~1oK z+~CIGMZg=Qtc0@4D5>XS%f7g&an20-IgetY5DpeSgZX5f9oXoj$ZvK!0Syj=-w5*o zEDjx^u<(eh1Rh;R-{y(rlVAvAW3RS3G3BqPucxQpG&58N{Guj`DLkV#hnRW8BoF4( z$Vd&Vl@1*f1E@2AFms@b%aUa>3rD>K)Hj!z-09ZOp$_#|7a#l0M5m`2*?OvR4jkkv zmcZqzJG%w~WaI?L*QIGw4Xnu+d&bxIPQnx8LQnQKvl!CJn)n(+gxH1>P8Qg+xiCHe z@w(E9Xn#@(K}q%X?}v3H$cE>95G3PrvgHGZ)qxY1g>qJJOaT7pQaVcONkJU#50W#l zaVP4@^e67GpK6jswS`-{;;`SxXUE@{8K|eFPIoM0-^-Y7x_=yAjmsqoz{Q zprev+ZAaNPO@`R`#HK~Wpx*i$!8(g@`Lte{_VP(6o0)?_E5wA(P;^ix+AKxY4ZNq2 zr#m44HrXyZs(lij6dLMyWVIzFPAOdjJ&{Z?RLxmgAw!uS-@}la?X?Rct$nry(gmeH z;!l72zu`~6|G#7ZZ~qbh^zlF7AL}pp;r5JQuQ%ZOGxV9Ul?|8Wf_43bZ@ziLo68-j z-{Y~o#mARF?n7xZ>B(H!Nkra#5@sz;yww574DU z(6RReWxb&F8~Xl&3vF1*RERE()B>$qDB zgl|x7Sn7&WSAWe5YQ3Pt`VR>V=?x+sl?)Is+R;eS4h422I*Qn9(49D0iBWi}@&R4x zIu|-Zu)_P4UoK?*R%Vr^L9;HtoZ%@-qttl1+hK{#xP`+(F-z=ji`g<4Vu!`&zrhVjz}vtmI$>zlBG)FgwU;R3)hs|D6IV=~k^|+xLa6-*IvKYSrn2 zQtOpQ=lSfap5>|v)MD7XLNqHlV2~eD+tQ=?-G+F8wgecKJ976=^bpS55@8i!Gw_X0Z_b_qbQ-V4KQtbQS zVqJR%!RcV`s9+Sf!@C_W&4zBzXct;W1)49m#fCxao9@#&;`e(Q%S|I>ck1XlH|G+2 zWIqFJIEJMmrNmOCqSh5_y`a>4@bYK_VR?gPc|xVtgdJW%r9zhi;$j)gvEaA!C3Ept z52xr*_diV_QTc}su``s;`ud8FO4X`v#_Q35_JY2D!l(Tge7^mN>-AT(c8p{M4};H) zU9pM{dGHLH|G}Z3S0qd0CusA;LQfXzWa>6D_WZ{tZ`mrKr5id20<;B z9W0eWO98C{z60p4SjEI9W+Pq2{#w{8Bpf=$7FkkuxJ)d`nP(sQ7zWuH3=Wq;28^=Z z7l)b^2NVruC!5h;inM0z$`A%&6u%IT&-ef+|ussnnSyYmhk4Hvm zfH6F~C|S|L1m+AFaQ}Ew-zqXDHz*a_9JeJ?9Fu@-p&S{z6L1 zjE;40t_)Gjp~MDCot!tQurX%QS=o&`2x3ZHm%n7i@;G?#N&P0gmbY^`MWQ$c4LAK# z&4PL4WrvD7Gp-mnFpR-BhSMqBd4?fFVmJXs{O24^BP8iMjzMBpIcQe%T@kSJh|J7c zfKOi8AJ0>{p7N8);W_J&yu?1gg7aDk`j;ThfR%C=8E9p-2dgB%i* zNR5c!uTwz=r@=DUO3+;7%!d*qcXl$<$!@_`0Bhv&yIhb_?j4 zt(6+YIIbN@)X><9QqrcUVvO``3wt<{mM>|jol7|#8G`8Jg7`p)uy-@=?%&|;+kcDS zz5Ac>)ZXIdAO049^W*=9zd8N}zp3Ek@d5>-wNFrCyj#D<-70u`zvAt~2BrpP#rylW zxb9cHyJx(+0IWBx_wUhfU$F0=P-+Di#Y5S!;1SS<%TnziyDez4R>V3f@+OpAZUK>!=O*P=LJxf9`@0rQ&@d zEaLgGu6SvL%L@Faid7WLmGF3RyI!&Ql5v~}v?y-31J4KHb`vbcx)a;pK!vcVA?P7? zw`L+RZ*~Og4cZPYes4a!Nc#{QVD}sFF zp*EhiHuzOXx%WP;-;(IH-8#k5KqJgK_l11LB{iea|KX>j2nVq%t2`NA&)FGSm9YhcB>~(ke2#= zMPf0@G#~Z>$<+yE*u?5PuE{A7Dq&5)nNV5_ z6e|-R*A?#{9`V)VJ>EV(;NkurcaIy^hdZoK8 zD61W2xiyro;QfYjZJq^C-g_-U(e9qdgIiXMLW|fyu@a;Tu!dvCvR%Xk;XWwU@%bo9 zD73hvXrgzc^U(&>?x2~&YAA3((V*I_bl%Ss@H}xRjC;J9+}PB?Q7_}$hw&6Ezz8z9 z3s4Gbxu7l=aJdK9N38V;r97b2dz7+3X|*AcZBa*5oKZlt6Oh#Z-p?-sCgYujzLZo~ z4Lby`bppgFBEGyTs5VMF^soc{KtG=GW&eaP*B|la`Xl!J8R)qm5|jVvHUVjF9y|PV zd=T{TjgbRl`cA-Atvm2$y@Devc=P38qj5hPXB}3%hq|>wsv1$Zkb`l|X+n#lZWZ+o zD0gE0gDVf1Oj(L`4Kn$Xob8Urc4nZ_3PDMz@>xp!6cqi}67R9!+)%3c92EA*Fjx(I7dg9%HLFevhQ@CJi_v6+fee zMeLw6uVNW%#9;x%EA@wTVzA@u#^!BG2*ZNFO0Q_8wnYfFCJ%&Ave0erRYb}>$0e2f z4qZv{v*#&jf5yk;8i+J_5FwWf3@s=6Rl?iMNOdEe)W`&8p^}s>9l)9(cMd+>D3wc? zx`Yy+3lo|HLfl_eo%onv@wg^Rg4a?4|4faF!tSXj49V1#R8xj9h6wSk^jv5RYHnPU zbROtVFM&@nGCDTH+MDdf{%?iOIATfzCQ-&kyNf;5RWPO+574-t65I_DmSfpPn?$sGhYm3f-RD^P2=@N8X!+nxkGlCkf1dfU6tn# zkS%63h?8^YJ6#S0oI4KFKa1_XPu8Lnd?Pte=x_{DLhThr2D$e#WPI;L8E*hgjtRHr$sBo)*PrIk2)o+7-OsV}aoJkMBU& z8`k9+MV|q=qO}6iW>!Vsuq}7!a>G&F>g8FP{n#OTU@a9#dj<+{|MU)@pFaZ%Y|A}x z2=3}V8aEUYtiD;fmK#1x$E_c@zu17lVDL_O0#K_>OZN)w3-IUTz*k$r|9nsQKdy?O z7JD=A33#{=J|Bv@18+976?G_%BR~)ezII&E@bNI~;ltu(?SAhqR8Zs&N*xTsO&YX| z=gkk#Q~|AbG)MmLjj-PopPmJ+0dE$2CRhd4v`(r5dsBSwmeY$|U_1}TP~o4yjji91 zSs=xflgO?2ZZMgf!1@~5hJ%|I%4<`I-|9kmO^vow_zE28Vnvvx`CGkf&x-W))eu)4Ai zcn=SIDUYqt64c=4&x$hdT|2v#+Lei1J%OYg7Fea)#sAgL>9ONK;{w8cAzX^$p;Wxv zR($>D5g*<@;py=S504MHyL&=i7pz-BSufz#{Jf;af|gy-`^|wLH>hB821GtbY?z%M{$vq6_?*9ep46o(tgh{@W6mEO&X!JdoKg3=j98C3|} z4^R^uW_tmTg2i~p3WRK+qLI~iE8Wte3!yJ!fR_q1c1)I5Tb@cYOCzbPq2!Atx6%tu zAX^aMg@9f`y^rS~6I*v)H~%%W+gc?=0TVj33DCOL23!i5d~hPmD_T{H{eE_`bBSxm zzQCDqJzCO-i5L+%5!@iu(WTjt>SqLu_sqBI;~MHd?g%OlEi zLE(GU@??Ks?@@|XPuP&cpt{(CAU%`kY0ro9#I1<4g~B=&J9RWNoAp65K)CA9je-hx zi#JOEcCP6C6Ta-f;M46#e7XG#_Wf5#Yo>Nfz;pbJ?6w6GyNQVq*!u&+A}YHngSr!N zQ|JxQD}WnY-{20=0bdrFQYRE@pn;;K5~R@hd+U5PC7Yr*FggWS1}+`g1hles6BZ|n zE^#kngY3omMizk0Njlp8gkLFGz806M4hn36Gc@1{@0f>qa!aRXmF`p$FVkV1HtA7A zLkaV4|2!2+Q+E}LPejL29p{egFMIgtD&}*|jA8 zd10+9q#yvzZ}{=OCcB(dOUGhSC;g8{j&SbugBm(kmvaZ0)JL2ioS`C;tFM#_>N%^4 zuOxyo7)2>{d=D}Y2@@>k)xgh)1JyGNfk>=iC6Sb$`;h5DhJGB4pNGlOXTr0@mLZinACWC=Cnt2 zUTN?vRhxo98uu8QwqMF0jre+5dZSD~POqIm)Fi-2#M5M>ua+DBDn-8-lhf}~2PH^w zHk0avH+cq8koq|>^MU4Y=%5pF3d5or1M0Xl5YHM7-teLS0q=hJh?nCh{Ji`#KGK1I z`QazXfBR3^mxhmg;FG+dFCC~CT(1NHW8)Rn4-_T5zkkHL%Vsn*HBzDSjV{Iy8h5u6u3hoY&n3U9;8qm>=CR--1V1;yOH=%I zo7E@p7gNggARKO2S2cY5=UvcA@wowS?qI!7zHL_(>}|)QH*Cvll?uBDP)NYOO;>4X z(s2N|bzpCTy%Aa`Yz1b2gkljwp<+jCF)-wdC|;TkXq#6+tlkZ%tOgMQ4_anLg#tLx zU12cg@MzX$C?3~p-E(a$IAChvJu7M_)Mk*I2B2|(8r*n!eqCcAaj z%Hq`zed>sRzn@M@{78u%V#9C~%QbGrl(Yq@PRT)VcBq=mpqgA11Y4-{$iV3+s<(k} z{w$$-RrQ|0Y_0K+*^$6|-YIVVbYd3Y_)M=#xM21L_aKKV@K_7}?ZXrP`1pW_Rk2+v z9-kiZ=IK4|@1JnFyTiKPp_bJaA3hwl-q5xAdl5Z@3&a6-LTPE~Vp~^*(BbzpwjqcX zfZgR%Z8#jU4NMypGl7Z)odP1pVSSNMgx&5412<7MC5hB3EUd?wQN0R9g@pAhaeQyTja=s8;8AbCbX#=QxX0Qi1hHMbL0k{$5 zrqHXRd#|ASf5#qsRRUJFvstxkK%Af}6_7&cMW&_Lt4Ne>OSLegmWrh?Xj97$E(K*_ za8>ZqLB&4XF%$+rL#dyfm6V*1|l8xQ~3G+e>4hCOzla`Gl=bs+b1#Z2G(t2?aR)eNu<~sjkTO&6y7k z$%fN7Nn^2~W8jzu!8|aWri#WhhZtgH#&1XH4Q} zM*hTb7#YFwb0uroxnD99c2Z?TRs`c7=UKr?%Z+bAW+&t;r5?$?aT?+f1EDK8BY&(T zuP9O5qKO3R%ImDf;pu@G?ul916J)$N1W8&d2=%d+seHlv_E)%k`G|j%U-4i2XZ*Ta z4yLQ(a}#v7GIJ5e9V+D5(L_+GpeXSEsp7l$_qbz1gFuU7;l+B)=!Ug2?k+2+5^522 z+_07n>PSuI1C0gS-5pAKgXfnYaL^0Z%2;ZFbjvyc_8=wg)<<}`V8Mb?Y=Kx6mMNqP zX2$L1GgefTvH^6MtyCMd7A$uwv;g=0!0w-~ri7oW;!=SB_5B0>_s=i*)H=S9;IYI+lmKHsIFmGJ0BV>kO$VBkcV5Kr4C|^uu|2MmDhnt{?7N zw?S_|2-llk#t#l|Vdsg3ZBqo;yJ!5wKCR25Sc_%V7AKH&VKkDldQhiMkZ;S6W<%vm zGsUcn4Tn1^j<|gk8rJW~d|lLFGz|(7wcpnhd@0mpZG<`irqCEI#1rswNM%e zkuxiCZ*!Yr34&^fbga;7s%YzTAsDco!bUhH_eXWHpX2RT@bBKd!~ga7f5La)e!#;W zgUW%rJ>jyx#kSm`a&>r3Hx)(f`9mOZuOMA)pi;9}O5aCyhH_BM%`z%}{fHAyqYp%x z{dvNJ2CkayaRDtO1BkGgdPA*2x|kBFmWLHmgFn@3L{BcB$!1duo1(M^?%weyu))y+ zuNGMfdnQQ&$k=Oa8;=Sp3RwtJ-5F7e@7Jw%f=QuXcR+rB?{N;HGCKJtmjLL+6}oW4 z`0xWSf)7%;Eq?tx7>jl;2963VagcPKc3-%lh}A0;B2wpnf7Y` zISAa z31I~s!^>39PH8Wl01Z$Y1jZpvPL{Hh5T|9B$p)sKcnpL($Io$4D<{xNe19?yi*^I# zlTsJiKSq{gbb@MBUj6f#7aWxpt~8Jnk2nQ=gLXxU_!*>_0nS;n(Am!{A}2acXjI`MTVL6*if9z$#3;whzgHCZo{6304w49Op& zLEH=sIMH7!h;z9ztyyRDbXpkDR4YfF&6sYJU3J(sQ(ebtnIUtKOz0@QR;P8Mn`l&X z_-89%K|z}f@@=}t!DqbnRBGif=Fg#evv(lI{b(?_q6$aHq649jWXSN?(x+Ukf#Ww;rHfG%JxHbANARu7L) z==%?#Wi_gtE@la=1<(Bj`*D~eqKxO4XWa9Kl?#}wJ(Fa`zBg3Z;lZ3Bg385Jp=ueG z-f_7Q?gY5r6psKt0=Tl^%W>e37siiW@XuGfwQZ#M48mGq4{5)LUzPCeHo;Ff;C=L}iQb$wR6+<=EV9w7!p2zLrOGCdYt zzMQK}*eYQwWY#0tp`)q~2Qa{oaVi9@DQ*pT@!`@4o?Z~|*2z*lGpImU0y}NBFmMqY z%DP(3$4v-#-D@A>9zdx;$%l_nBrD9`yRy+UgOrMteJ>8ku9!vhlqiKAX3JXHzR#5n z5M%e~XN`c7XNh+f(ikZEgMIKqNa{94avaNGjtn>yDiGOi&Y|Y ztF{oeOdpB@g{<7Z)&ck;B^!u3S>428xjOcxEi?O~i;Y_97E)n?dSZ4kK^f3xhm-=X zHWZo-u0Zv0LzNSWdY>(7YEc>pd?C+v-gN?K41ydf6NQr>t!-Rj)@pccMB@BO?Dk6WD{AhACS%Bknso)-lbmG4luM=bRL3qPRn#Vn%B1zaz{asl&d)>2-;rH*J4h1#4M z4j2X*TSTznU^N;liGj7a;UKe&9^S$&5%AK20=0X9vdt!<(0)T}UvS+&;(7lCFV|nO z-(JwJ-YFtgPaO&u?k;B|#B9SL z^r+cN(7_;(+WCQ95Gbf8xJLG#>g+=^>Y!i5!)z!cv_22GG_6d?%27U<>QsRICMyX_ zn=NmeY;HQ#C{Ejbo_stDiC6wS1icdxj>S34 z$LUvcs(pxl!f^8PmwOjdoy4x=|{% zpUt~8JL_S%8`SgCAUia2aG^rf3`TcU-+Xg5;#xv8$oyLDI_KSF6^1Z|EPGta-DAnym|Jgtf`iGY# zF_IjdB@mE%^@kvy0X;f%ms#%(yXtsFhq%tustO&7^ymX5tFXz-l_(x23iNthcLRek z7BF*E3`HC1_vkCJU(vAR$NL{~|Ht?EYy3a3{rCS9KRo?C=s|JpSN!|$zQ)EYmbKt| zz2XP?3Cp|9y7F4Xx-#B9JfJ^6yFGA)HlqPHeSzwM6$^SlJm|ilE_Wzp!*BaXwEYET zzr(}!fTaioUr^VAOZgg=c91rs#+A+KYInHaoVN@(Oa`uYpKu|LfO01Jv~+;MzH+A1-AqE|J<(lrZT>-jE`5ruOfJ1!bbw+YS#M2 zfhb2ao6wiT)WWCg=yDP}7;s0|j-}eY;OGZl+86Y;1Ip-P*iI3k?ajIYRk82D#}`up z@5ua0l)k32H$=44c@;0fXBD* z@$m2t%W^k?SYiW(Mk+@LDhzJLU>nmRX^RBE$fcRBuoFSGpcA8`LD(Ubo{s|wh>Q0E zD~eiWie)mZs}+PIrUH_5uilC?jSrqs&+<7)Ww9-S#UeV0EGt-qP#at&6jV|W7o$qB zKg-C}kkN604rTRz%PDF|v8oJ7V?9*fQosXnGH0xr0Ehe)UQwKY2Fl=n<;LhEg2NUz{5F+)Vkce@p$kyFa8y>H6n`GGxdoIN!nRlu0y^%oN(4;RB9zBKyifV0k4adlyYt$MqX$LQW${}koEd8Qst1#!ZF=rq_5iepxMGl4NFMdM&i zX^AifSsn$hpiop~A|Czsokw2J`|%u?CeuTc21;Y7nFFBH*J!pQ2ApH)H{FLo-%$40FE0);?f1bmsR?3Z-UvNG3`qF&>y-OS4Kh&MDIp&N81E{d7w> z$Sf?TRGOcQJPdBO89BZ7lxTb7#*S?6K!1ZNr+OM_G;r0)2$Rb&8jM!`5z?F4YXPEM#A&uiq($XF=I$!e+zX*#Y0 z)l(gX!j++61EhrTnV(_-pO+~Kwj`AMHLVKhr9NZ(>W}#DA3o#QpYhy(#@&4fmlxdj z25k@6^bNkfUvZS5ar7Os5N_=m*UuGq&1juU2af&)_uB)O#U3%Yt76wHdb@#(0=+_R zkNEYsD+JHD-wsoV^bwbO0nv_!%Xg6D8Lj<-dbyzTJ-QrtdHDgvf|o;3$zTxcT5+dh z%46N2LfB|U69q4J&8~cJ==!?iMlWb8*qaSL>`D;GhLXSg(y=eVk0e+G_;>de|K<6> zk5|RYz_tR?$8z-B-M6+%0JE*Yt*l95GlcR27FbbP*f?T|lD0U2zq{ z?!(}?x&^pr;E{m`Unq5D>`;7G!V46gEo-M8*xW|DJACHSP3>7A4)AcRttxJ+*j2In zwYd@Do(Yd^6%b1B%-#IlMn1oSu(-{#cs{wZDW@9)k3@I~dnrwLOSnlm?Z1oId7;O> zF+UH*p5cf0&2^fNedpRiEv8g43!JKvJfo6H38JRX!EL3|4zpp4 zpmB3Wl-(v;F_39&WY9R@8R(>Yq(v;}2RQQ)VCi*ujteu-G<(->aUk^`UgA1N=}DsWIit$ z6)U#O8?4*cSe8c=T2OFjbs=SeECsYIU~;P~FQ{C6aez5f#9?Ca5rV@pJ9D9ePKPUm zii50Hq$_!Gz3GI-tJ#V&Rw~%QSd>t@K#v{!@deNOZ}{@^EB5D4IBthoKD{WOb~1G^ z`UYLcb?&nK|JnM}CP|VcOAvd^B6^tl5s_D2UERIg!0rq! z0r-Uf{|hi6!Y(k2CJZps(_PhFl}8-zZlA{cR)!0Km zwKAB-(VqUr?ug#(pw)`tWELy;svfdyKy;kF?Ocy15!INnPNTQ34!kr-{6=OY4Dnw+ z*ivN;D?=gO??!z~QGG7#U`9t|s@^fkJ}Aq;bTx1xO_~Svf_QbdfgLz#3spG}NI)Vd-3)E79&(dvq>O3rw2@7njatq1v*vi25M*=UW=uOO41P0=a| zC2C)9ud%eSn{i}?4or{W?DfQ%y=y*`Dm}!%SLiVQa|JeinAd8+CmHZsmHc(Tm$vw2 za+!fMxkP;ma8s~S__buvf9{!dv4dB`KWO;;sU>e}lNz4F9?|b->aq|Wf|M##tRsu; z!@dquXC0Z=S|8CowbcA74S4#oXd>XoxyMuU-+Q(@(@Gxvp9QZh#ttB(#FgK6Ek-g(5U0diJJ`K~6ll6Z|1h zZun8I16?10`@*W8V?$UEb=er4g{>h?O_AV3a0_mw8viVVR9)RuD1NPv@_XB0*Fc?m zZ)^Rip580tRn=~NrPWR}HeN>wxSsM)P43*ma;uT?1m)2rQ1EV9=l6D10pbN8F2BW} ze*Q0@4>PXM0Y^^Q@fE4u5afdA^|y#gaNqxIOb{=4`}`G;55KjCZb)F4lFf)X4`E3PtOC3w;A;XNqxaAiGIpvc_^=d6WlLg|lo0kRnW~?+)kx%G zzQlVbqyxy=?h%I&j$-HQ#OkHes~YGw4h z8lV+5fJ7iXN5zHB%Xnb}J_QE&;2yobjtij!rd)t~u*!;{UG1R&3KMn_>;U#cNC4)b zm?E&UVs*I`;JFW?4bXBMF4e;~s67i7m$|Q`xDs%2@3ML_YJuAKm407nzIR{NMN$j3 zsS))qa}PcWiI>MjjHS;Yl8i%dK$hb(ANgxz4fZ{v^&QsKdj^|lG6N-Bf@a|{HQvo2L4X)+nHoYq$eBmG&z8Y! z%_3k4=I3LZZ#i0}Kvgi+USIMhy}Be&+H;;jTCB?w(Pr5!tq!cRLL7j=(JCllH7=}m zp3MGOus|J>(mDwh2NcCXzGh??OIV~Ji}gmTR%xs_OB#(aWJ?_F&BN3zQWIUUE+4S0 zA2ChOh;%W=lvZe%fGL8afx$=-ffr0Pd3Pvv2K6+*aDTpWClm_XqD!DioRLAs7Wz9D zFIlbDiJ-M>G+;(V%nIa$k`5fl9ozi{x7!Q0+kvuEOAxh=L4ww#&_h8xfWv)*3DAv9 z?k_fvOmRV&C(vvXQA`10hSB+x0#QJ-%b*?WBL*N8-*ym`%%;F3uHv!tMaWrwRG|`q z+50KorwX<}P5TvX{^Dxi>G>=@m0?f-G#O^;sln(=bITm+Rs(4vbv1Nr^!3mv9b})u z1!DvEIJ8wAcB>>%g;k)A%+Iiuug1m}NYNU|28vRA?R-<>_K=g#h z8iQNcSKMApBVDyL0|1S{uleKzwKAJ4%Ty!cwfpU82%o9Fj6S3Ju^VKUGFDW$*;mfT zr-j+r-F*O_+DJg6bA<#3SwQ2PMmFT+M?_;so9wl*Cv*yfG{9X>L*$uE<`z%_9lc;< zhv9Gt=vNt-82c}|`A)e3iCz}irJ#+W;~phWVSya?iciKIfwdb>O*!muPbqtzh|b@{B0 z?7McLO&GkZJxqz(c|ZF9P7yZ)a76dk`T*FaHO|%xE-&EFwyCVaaZW2gkYG4R(S_(LH4 z$4K~>L-CpjmjyVarr;_5?GC&Y;5nMDq)PZTCzNDC0jU6zJ$WR1LSV3-$dm;sSy0Sd zAxjfI40JBu%$%C@qAyhHO(+RaO1) z6^fM!7xHp-aS5gW-~__q%b>vKCtIP|6*!XO78sF@jqy-Qf(*E-0>>b=8XqMiLtob|+&t2DNf%!r z@#(JO_pDm|Z>=YM{R0@y96xcnXZ)t`q+L`2+s=;ahzF&G-2D@f$pS`yH+i z-(XrFfpCG+pdcGCv_?0Ww=cE)FmXf-lfjiv?~J?_&*SF_Pe^rP1rR5KVe7V)r^2 z%U%1n)k8r}&j^a^UJ8q6!ET zirzi2r=aNFK7SA2%4+Oj@$N?TFc}f8=rF#6VF(eXUvyx5T{3zi{b(bGc-g{ z3{Z{;95B;j9zu$3wp9(o>{Qh~b#X64D4RG}ok$Yx!A)vaJTn_p7zLnm zAeB3|^c8R0XS}?9!tLc1aw|}00ZnO3<`eYl2;BkRs&^1TVbAsmm?lP?XT)^|FWf=k zJi*rJ{Jq5w)yv5D>r+W%KE}r`mkGz7%#DcBBXnvj-q%V~@S+rB>n? z`NS>7yk?x3>c@P;?10*->qdZxKL=`EM*Z(a&+};j64g7_6BeaX(haHlRN)hYEG zNPBWujKtiAe1~_Q)=1s&R$1KP=a2GKb#}Iuu!4pVkDk`lK%~D0ZDufkz_dyWX&%I8 zCU27JK~j414|0Xx*1h+DbSv?9}{(?_y6+K|;glUjZQ1dxZ8y#IP8m@!W4LD2?$??bFg09^)Hs zrGNjt9JSmy`&cXEcw#;4mJ`K8v_?5~?<#D|pdq-bB{EluZ)I(%%S>AWv-V|$Iu%L7 zu~ZsrDe6E-r^vPejB8uY>2RGWmBIF?UBat_s;A!n)x48$Z$IPXC4f@E%#YZ&&sMq~ zpHRvT$O2jmcKHQ>;vrn|6?I5KcACJ>XX z_;dg%c*u;iX0;A46CsI#Mj~T6llvp7c(;}(F;ehAH1YZ!B1kF7Sz3rn4Sdm}xIpnp zWM0CW1nL)pb^Q^F0v7^qL^%8r%v5tk2uD%8xkAXhyDjuUOsaZQ!!}K{5Naq*7e}$B z;o0|A?%NZ;HW-9Jf=JX-kV61sAeSF{!mn6L;ilAAoP#XA+6uCEG}^*BhScI3b`xE$ z8bSx8)utk-VG=-&CdU;a^J@D0{XRteA3uDD|HE(ofZu)l2Yh_~4iDFlST2u<*Q@pX z)gpK(v?ODWN&=1y%^9WaNOGVcBdK_YsmsaOnIdFgoQf+wEYQTBsUEyX^%M1Z#}~3( zx^ywXf{U0&>Ax+*gsW#=0Et5aGDCwcc!@^=T7eb@A@{vJ?Jcp=NRr^phgi=YM;o^L z2HSvaa3L^RFDObxjXo=tm66mF#)FsggaBcaeyX}}5^SK0vP+2#R59`p!shlQEqy^( zm(MK2d}7gzk!LWBMXNoRHV+msTj6?ClkC~zE1Nu5oEg;I=1fI~;DE}GOb1j2)@CZm zDkzeWB%7a5(USQM6bEBSReB~un~MO#j2ITI%Qslo4+!xI999so02XMB1`5NBz!N44 zh&;gxUwS2X#T8cSA)V8t2P!f?#f0Oc}F4>f&17~w0535=N{W&lwIMH5oK z+P?2`}#A|%MRR~{o4t0SjoIGgO(mj3C;@I6wT29FHeLxF~Vg5U+f-kK+t5O zG_f&+5#Z>Xi%{j!+?;J@uPF}t`jSSRsTKta2M>lb1y>+|U5d|`5SS4-dM!?!i%Xja zJ2BTWOX0d0uFA~_W@!;7%I1}BWfQ1syHI205xZ=X2Nvb*fopz1blYLus*QvXwEO)A z-{FZJp+U|_18vhJpt8CD~ zwstS!@D3`_>Hb3xqM-L8%Jp^nW*kr+VHsnWo?*3q>!5rxwmpH&*o~C;i;SDU-ATD;=pAX!DX) zwi`9IQ{nOuYHN}P42HjLuTk}+*sfB_I@C+u1kfnau7s<031wT$NCRf-4^&NyITA^XBXRY2^)O-kqN((1=}2Sjy1?_JI-81s%>&J=gaXk~sY6Il}yrAdq5 znQ#a2EbbquKHKqz)6PVdo<-$AR>b76%rmAiK?|@)!Tk4shwGpI8@}j|m^9$fJ0vS+ zoxyWKO1nu2%PW``{P6e@uiFcDNr<-t*O?G;K-Lws09zs4wgL_X2i^b;_&EK5MHb}a zhDa-l9+>FCr2oeT4Ksj%$mVq_bVm*^P-TQT0lO`4NeJu11%G;d1Ce6Rf*&4Nd|X$g z+gIdt$Jc$s5fpP)Jn)1v5%zqb6yUCkSF*wVQvsHl@F>6s7~mm2>kOa@CM*JuZ*ZDqa6Nw@bfO-kVyy&V0iFR|h;e1b z%#6i7R8@SZ-tjfn1-hDtu+%WG-iU*Hu^}WuF&AU@RDoT!0a~WsITos|g8K4GOCO8j zX`My7r<>VI>h15S1?9AyfFYoY2WBvNl|>m$E5)U=rKv2?fKc#6SDz6PgZ(~XNdNX< z!j?Fg-H(_^k=-Nxfg=8wkH5oz{2%`Ve*44k@%->dT;^wlI9nPgvn6Y0@8FXIBpE6R zC?=IFayS^s$PjZWkp+e*6(36Ns8%0%U;?u_0VBu8GPIkxR-d}D98AN#Gm-_#w0n>h zp(|mK-h_6asRV)gz-;fy{86lvogczbvP4a#9`;qkWbAcVHyfOx196jpDivFZanA^_ zIV!Z74=|e_G^50>zA(R5Y!w^obC$XZRmr8eTJQhv4de=>YG7e$3svJStc*Tr0Ml&1 zkArpgwV*Kn`99CtdGGZdQV^toC7Cx<1w_S}odm&#g2RJkjMdB#WKAftBa2{8zwjRZdGAdy-k?HGp6MMas3G5D-F{3?JT!*DGlS;{nj&~6gc+a-n63ddS5U~H$k1rLn#SBo3p}h) zkEk_z`^*%e$PJa$-cI#62X1*10NgXkWaoOIfapO))?Zt1T(Md4dJaLA#aS(rqM#P0 zk%va9FO0P^wk-#gdkVAP1>;cV*BJz**1cs3PF}^}J|UAw)uB>{O@UV|6Ai+&Ze$Jb z(n)1ts=DW|52M1B$qVN|jS;YroP0qHOPlJfmkdn9DD^^1BxI_xEo#GQ>sRv~S_hq7 zDyl<-YTf>m13NS}Kzdw^cKMp>pug4ru1N`F|6gSR&oa3B8vJ{R^eTaxj!C2cafG%5 zLZuOW42e_&^C>Nvwf+;GJe|KT%cip^aipvq7}n%RMNh?SpKT*|^u#>%g6=`UI;L3l zTJEz%t_9YPbsE(dIFilvJSJPSJ77_qK8nUj3+ten*XAj#37?&r>YHX6e(spNSzqWW zi&Ibd4DxIG3uqaiGAv-KJx&HtMvXabk3brUzD7-B3@f4P`J^H7wDk^lrixDK!szB1 zde1-WsoKI)y!&)yHE&?>?lKB-`0SyT|Y;Tt>;* zgMf&2{uU3{A8@6QSke`NF3@|y>u1K74+-?)d+eY8f-1c~Z}MB`Ma$ ztXau@b_wPOocb0ASxoL)VCk54DsNb_CB#0ZX+5j=9bcKEO#LX@1!``D=h$gKVR{i zryp>+euHIs#yYJCJb9;vxcb1V2PoeG*`Okja-gUnNr7O8kcD!H2gX=_LIm27YLY-E zM&yXVgo$SaTHI@1tD0;ZK;CnQ7EA{q2(*;;Y_rlp^x?nu^i_Zfm!_fE-?(p&nJinA zfJq}*)KYo17RrZ~(5=){-j&$cBTjAcTbU;{Lf$@GR%jsW3A|5!# zD}*M0^cFi3GJ!Qi+=qp1Ogds)6Zn1G&+Sq-33MvE*OIqcB=-T2|#`_81wI zUOca@6uTaGQXROTYNRmG*F!9{GfFx-9P|tq+Q2L53E4U-GaZk2=7mlsC$xlULlMlgPuAo-Q}0vOFKy0E32qo%swU$w`+*T${n-_@zJX}-UnNkW|itx z)t*`O1jjGA^-zHK2$M zy$2~?vIU;p)jWLP1mHn{YqS(h6(A+W)n-Q&08haH-M?hTKZJm7DQWRW# zkEU%-vVv(cHuPY^=1HCG_d8MRGz0^SDi$S7>ILwFpPefMM&yz87GqyiN$tKN?YYeg zP_Ts4><=axy@DPZQ*TB>UfJibNw_kG!{dm6sD!A%tmHCSe~*?Y(eKaNwN&D@8kuX& zhqgIGvOxC(tOv^R3$(l-FoWj_TFj?JlAv-RmyF__f`t?*)Mu1=O@F!aKOA`nje6$BI)e&wSrkdY}YJN1oL7Gh1xBnm9-tW%hba(dWeK|8FTR>dMk?) zWjm*}KvaAeOP)($e%=bb>b)+6fF;=Z3>6f)VUt(f(+jq@7wli|kY6(BE1}wToYKU8&Z-zldEwWGi=5Zb(OR zBu;b5skseg3mUZ$Egi!KdrT}kqO3!88x;K}+zSizRC+1zs~4ye^j^wL!%)^_8hQc~ zXz7c?s~O_|YYOK%nGolpxV{EGd+O@Y&cjBZhr}fH4I}li(9ZO=aeVln3NTbRNR{S6 zPeDA^-&4VXOZIdW45G*3H=j}mP~_=np%F3KBy9g~-NE3U8jaDX@WE4P32^Raq&5(! z-&~puQAbA5HWEC@f_uF~-=ef-kQe<5jcJl-nnyZqB0ED>Yc|^1qdn0_N1&vz{w8Nf z-XYAk*;D9=R-)D)H;(g+(|A5wT2OyZ^$CjC094a-N4FznR}3EAj#a@fEgZq%`8*q0 zLp}XnW9=H4<3aYR-P2d~Q0Rdy?eJFCs?}4_y9JPVci{*U`+I4}nz{_Mc^<)@-Z`9F zqiVQj&kkQxrAewCDjR4l{{6HSS1bB8OM~=*JROftUPEru-C6+B4qWZMlu;VeS!b^P z%|T*OW3?+wcsB1>$vZcHuKGaJl4^%VL-Y5xUa!iEbPzb=cOBk;Uy0aj`#Aj_mVe%H zyZlffoP~g2Rf)HKVYL)W|xIOI^AX8{-rL zI84Suk*CYTQfC zGL}pXpo<526bcYx_h&^wXb7P-8ke%s`$aQC_N35a^9L0LXGKUJdg6(ZM5YTTHc%Md zn?@9j(eWh?ivS#K{;O%Ls1+aCJcK2KGH!7mQp z)vk+ao6IdIQ zKg?gm+MiV7@!9RT$pE~X7Lj{Mjh2B_aLu|Ms1d<67(RBb)ryZ=uKhj^rk0tro{@(7 z7ORG8^ceqvg*jy&x|EeV{yf>78pvg@kGzNb-!_YL2!)y+=>o&?u!^WdMU%(4#2r&LSC{5Xhz+`$>0 z;kDN9?}Jr?N;(9=4$M4GpO68r1}+C_Zk2D4ANR&i`SnUeA7mq9sk6){0+9&kbW{Iq zn~V{t#q3)5@zfVG_47Ps)KsbY$v8bMs+#<`PhebctV2w0eRwnp^1J@RQ(EH?rPNj7 z18{6=g5g#uXdsSA-d!QU=wCdC4D|%V{>_RXXYSs`R#AfUHK1kK({P)l#SfaIcSq_e zP>Qh9@9;w+{M(=ZEB@v78MhCg@xOlh@7PMgo&=i|PzYGJ0|)NdwIG1-NHf+Y;=8Bs zacpl;-I3)0DR9Lz^7MxL{)#ySXnepw{^=JK06#2t9ZN3wF}>orPxxQ{=I@bq#y@@i z1+^?%lHk+Nzu@uV0n@_;L|66`TS~vn1VvHO9``uoqT{N>5+Sm6*$y_ zS?)sElH$u@SKkaptZCOiYfWsDE|9SUd-dFrB4^-BRv-cwXCC*gSV93{61_tTl31{e z4vXEzzjySdT?0bQU8cn1stCANgRqJvN6rB5)(!20kX?V1@AC?iS0(hvUW7?7mtx7K zT&#K^1jc*yi>g(;WKTd9HK}J+szkQM@xm5=5j)9g(lb~ptoY)(ctB37Gl_#uanRN8 z%``~0xmiP6(y_ltMhBvY`0H}X=@Nluigp4G0R@7;Y5@iM3KJoaZ0^YAFnr$v_>=NHRf=V5zQ=pxLh3$X1mxA)3Dp z!N9YFVC@MPet=51RcM!v3KtwKI6MHWR0*rs&shqsHoKP1MxNY>2o?r$LLkP>&JvP9 z^}wz-+>Xze>u9+u$}Iz=FUzSd^=sw=>N1)FltPox*7L&VKl|P$doLii^OmXBf7RJ!^8ap7 zCUW%aMH@qIP=n5q%0ymVpV3(y1D+ zt{o6+^JsaJRlTXY28^l8tuQ8^df1C956Ozue0!(=(ZCvw07BofmzE3OK1^!dO=<6k zTMB1SJLGD9t-R1w1|X9+EhwVo!~0k90{Nd^YB4w+tZ+B1zCTiH4nYZ7H01Qjh> zyaJvk;VV3BYUG0X@K?_25xwFguQ>1`fMlu`|DP8lHWq z7(r~4`VE7-YTK-xOn?N7WcIO!U6w4>%nLoUosDSJe~;@O$V6@an}LoQ_*Ojuh(5NQ z1jhEx*+Ln#iVDTAv&y!eF5Ur*J4>oMcvkxr(vvxdtR8XcMk{S6J<)NkoVHeo_y$4i zmdb&ZaK9eaT1wX(2Kai#cU)LFVzvAt7;AKwO0PLke5@8C#JBlJ^ zTJgMI@HA(9`;B4^FCfV%@@kKh0;Jwy8w8I;xJ$-#e?z8>JTop~wcrB)6Fxxh0x4f0C`k8&Oq(%nVsb?k z!OQE0+dbj?$e1%gNf4(16amN8hOB&`rdCIeIFPX=t@*+D@#T&^6?}6cTmujbVXC1V za|9?MtH-Ac@HhdNNing3i5FEYDEK`SZUy+~gK#6oFA-Rx;sOhD$M|AAO}f7d z4y^nfiZD;*L~vr!M8(`Q55S!6p zsjZZ4F~*@PH|z;t{Fze72Fpy;*vD#9S;#=@;;d&F5_YTHw5mImtf$&4FFeszDvRNF zF8A$7lWn`iRLP{e>L62q5U4$?S-B=m(-qgpZ?UXTn5PFU z(-jNPn9O|&DfZkj8C__;ZFZ?baRr3C5v(jbD!>Uu!IlVcrmxEU$s%!wcmR`Gib6_4 z&Iy_oR02Y_`VY$bw-k{Z(`zStt`A+nw~QCL0aH2ofsKXMj%w7!!yih%LYbks+ZNgIJ%Vp@yee(g;Jq zVsj|FIz(a8QQ>UKqADnQKqRA3LeXp;lc>NE9S~}19`#y3q-^zVQW#RAH(W4CS0taW!3!+XYsa5W5bF&={6>oKZV|yMI7UMaqWVFtoN+4$@P3a!m zyr8hfQPAMWl@Vyd#DpoBG#5w^*|Dcr-0m;9{qlz6F9-0Vh!hal8DWj!l@V73T?6<6 zU^S*NOaz?-VXmK5K?ngva}SAuUwfX+sVL2ddsgdk7hpMq&J8Sk9T1r^h#M}ldWvQ( za*3{C4%4?2xz`UK(j@i1+hvPw!j)itLMD*7cE3&`9@c1<#6G) z|z3goMlOorD+J(ac1+!csP^I6oi z!X^pWr!PPfHO{dm?tNKH)&W0`Zr~cYSaUOMqGfI7*OvhzQOaAXV>vt7nNc{!~wu2Jk=xoci*{xMTQ(sZpOa zg1><)8bS&>q0C+W=Pb@i-(CGnTZeJWw_q^!=T?ZIytKaQh8mdHf^(FZ>Vq z{PwT-$J_sgZP`JW2<#7dx!aXm6A;C2MqKPnn$`d*ic}2LJqO@$K=PuB9DuL0bt`-~1B(Fv zlz|@wcu-&u!0eLC0NcRV3IkFgWs`8eWyReqBVN7Gy;fueF|aeUD^?1%PT*3U11P{z zfSVfIcZGTNpac@kFPj3p zSmI_2Tu}RbvWMe{*z1io#nYdwtX5OSh1#u#TxMHEI6^iE=OLk&e1-@@7LG%}3Pl|D zf`x22?pykr{%628c^w4}Oue$zTLkxXR`0O*Eu<7@RRg()(xj^t8P9>Sgaz055$pUB z^YVykS~0B?rt1aE`T>{eiX~hyc?diefl9sm1gPYuh7l&eyA(^YbSa_Mg|l|SXd?2; zEbFwh8n57qlP=#C3nj@ZBc}}|S+85jD`HZFV(&SK7&$Bni8sispcnvM?7A~VXv65c zK(hLrGexi<$pNO-Uw45+1|;k#l#uDLf&wy*OqkkG4Hgh*Frop~P%NAVf*fsdCt`?* z%R2p$q7#C~&ZJb8g_1L=49*Ho0_+)-6fB`JzwF7=td@AmL3I35XJqpUNeFEIZ6+)8*&At+8GKU ziBU3v5J9*?^btiD6q%5fkdr{!dh$pnXk0+D*s&*z&2FsJ1vbbk#uFcVtHCJ~>c;w`s;d;!k3 z&=KmhkhZo5lQn~?T}|C5XzRGjE;pGjYnww(AzTn&Fpw<=xb#p=x9X|dc~f7b$k01p zb5KOwhii*2_jlQcz*W9^3KMh*1<)?I9>h?6E$4ucF?6P-Gm$p$M3rOqQM$8)ICYeD z*+dJ4@aT4KWm{FwB~3Tm)?r>_z!>$*+O~^5h_NSns?(`DY>S#M#1lr_PZ1v)>%geu z{WjVW4@Ui%%UFd5FyVbVemqz^aH}bA6|^@lQ~SoYGB4cfCWiM&w%H^aB(F5ck4J1RXqesV1A2xq78wQSqm4K_1gS2cE7)>brhh&P=3MlkDgL9Ea|fKBA2U zhHrFH0giOvo3tgzuL)^SjeO0O4E^J4-HY|_B`=&1D` z5`5cPK-HJ#Nt+~HQd&*L)NdGEnZh9sx~W#`|H%UY+QW+4b=Lr4W&K+0xO@6odsPID z*+AO=nTAMk;3WUVSQk;Zi^Iv-jM{bkHr#Z(H`e7il}Q^GRdrcLjaBRtWTw9QV&z}= z0k*eIW3EvPzMy(-HykU&XN@tAX&?!WPN;oe^{q;iMhu=;9TREmGm1_ymuO%dS(+D^ z3uBTA>$W0(WlZ}DIU=@$L4WrF(~@Gfu(}aBou4}==8WE#ly<9*kVMa#gh&>aoYGE{Y&N#B*`Lg0q zKi{Eu!EpheisC5-+|mY`FGx8-;O4`g^^;Mw~VJ(I+~zSP+By7cJjw)l1?mAuN1M#o03Uq+OpuNZ^4b zeelggC`^D2H4_MN=!^~Sd#}n9@#jb(VDWIEq>50;J#E^aM-c}0qI=_NC>*@kkqEdl z<3bZ+m@&^+%-2UO%ST+MZ!pJa#A!kZ5z{;)&J(6-Z9Q)$S4^(%q83AIl?2I{-JGFx zKsdK52B3H^nLmSt`vO$i3fSc^@Zja(D1wp;4mptXft38(*bC@BVaZRJcJqnG280xZ z11at(Nx^eKC<|h_AgdsXV2)OSKzXX#OfJV`Aeekp1t^pu9(Ds1+qU?VxR&K@vdLItO4Y1r2GnueLt zLDVoSVsygwWYU3^!SH?X4pjM2%v5U)_!L5e_ZX3I3iWB7huZxVd>XO`XyX$NF7 z$~blWQHma#A#HeR$CA4EPE^mYcTB~7Uu8mPB2EWyTkVGIokzt@#xj0-?KSHl{~Wx# z?JGK=GbYMPTUK;#UNA}+Ta}7?;TrYJX0Y$6n*B3rj3i5!Y&saUgU)Ro*IpCXbkH81 z+{2^Ldv$mKR)is(MH|2-_@Ff^2!<4#?(f4X*rkDN8l98p^i>*rDu?sf&fVCO%HZC- z#+E7#%rh;|n9rZo1{j~2YdSn3j0bqI{oAt6*xY62Zp5hqzZ zjjTHc*4<<_3tu6(4VjXqJo-Z_Yzn$5cvtA#fm|3b>5lZO_=*GR>(7ws0$CN02ZK0c z3Rb@Tw;!Hygd5f;!FmPuO>n$qh<73gN(8VL zY$@S>WZY4(GmryAlyIFDTLymKfpsCQY(A=@1)Lck<*8)lp=>mp_mi3kF~ggph%67zkPMYB?L&BH;kxBMbh(z@NmbCEkdTi{jZ6 zMmN6+ir7DEv6_l%qssz>s9qgWs}&TXX!rjYOT%No9)qh$9trqBgeS76{v6xg)teO0T-*45ba9FSiuzea)vFra~6}omaKRYs}j(z zM{?GHtXiN5q!5@HS&SE}@-~L`BG!C@LW<-`qXbJkwIoQmjJ%GSGG;4-#Msdpgrthe z{f$BUbBhFs&i+kg%wzOLlnE=W2X2W0kMw{`yx=lFVOgIstOW?gnU z9Y`f1mxPpe=5#?48?=!CZ4a-4TGFwt;0K!B79VpSH-n=m4ydz9E#I$0X9x%rX zI9@@{GZF&?vynprDpO%I>9PlL#7tk=#~f-IF4_mC|d1${kr;E?SRE1@A+C0kWF zRD&#>xr87i*%GQQB7A71V$~b96SK7E9koo7x{wXT2*ikNbt)XIEHWdPJ8t_YY%gDs zz8pXj#5Eu;3c3>L!r)5;uNmP&h%J3JCWgzJZKk zXKuUA&9RX91n>7SvWFd1O?lIRS({(!T+mG(n$iZe$}}|K=l(aM=24?2t>Z2qL-*{E zx({rS5n}jxqb#uk5LNOW&KS>c!hfbg+EPPRoc&bM(bnuZP)>45q5ye7hQA*A(tr+8 z2Z34*_R>Hi#^4tJnp!I{@PuTT20Jf<=NibA#pqX8nS zju3wcP#JM828mwvXAKrj>EbuX8QpZHW?<9pa zz@~#1X>!W}lMfzCYReCddR@DNvUp0R&@#eN9xFQ36sT$crp;X6=Xu@GV61EyxtO~$B43LEFQ*k*Mzr}u}&+hlgHWy}<@ zl>?6xYAzNe5JI%%O09%&WN5ZaUc^!jrXRBHtTM_RRvNXpDg~m zv@#|B_$~(ON-*FjBA{&dHoGU8^s^>+FAhKh8Pq$V*hwM9Ex4!0WR)`3#OcsdHQ5=* ziA<`S#M4~;e$IBIHU^0avl60c_fL6M#RV74^nfKk;bHlRhxH?-`2jILVVxflr>n0+ z3s81wJ|J-2Z+mt)pi@C93CVTAS_+D6NRp7`hRho@SZTeIK!R9j9a|D*q1}l_8)UV> z*rl9sNWzhBNGTx|MaqJFD2^RCZi;x1c--%JI3m_!VI6T|#3)e8kf@M_EZTo&gcvX_ z6XN`WX?jMOuHZP^{gq*~dWa~Tpj-^(u|h*eMm8{{2^qUBK?Nut7$cm#Hg`5@sCe2m zDzMDZLCGUjkflJfKYw&V)MEEsvHNr=HjEpv%g(Y@5l940+E`%LU{w*VT7?j+&r1j# z0w_l7mkWSS3Y`=j89EI?hb}F!nYcSvl`ObTu6_v`DjDS@wlVn4=Cguoa25(&}oW90s}*h^$PX;`Glw^Z^6ttHW10 zcLfe3x19D6(gNch}a|~YTTQG4S zs&=0ky<-IZ{BJVO>gAKpjJ7}-MFVDI#w)eN$~L{9!gQL4ap*?0odBKmxatduo{`g| znt5O@X)Jno%Bh8T`Hi4n{7fB|DM?FrRpQPTR@o?58Fo(y)g~>~<`Gm+%{xg*{f1YW z`_WTKqyKXFoOlQcqF<%7Ggegi+*r?Xg&_{S=p=!s#@N-L9)@KH6SoxDwoDt& zy|#9818!F%a9;q`fSw9Ab*#!DFGbdttPB7`sSobx@?KFMQfakC-E;dHL)z=u)yik~ zn_mg>-@am!19v{~mvYBFAGj6ZB?yja<-i3%P6=u=86M*mD<>?|fe+tbFojph&WO4o zrwtljFvTZ)`ocI~-te$2Sf&Xf3*@+iHKK6D8lE6LBlA}jNmv%f>)Q^HV2uk%2_;yv zpB!&^c!=0u6Sm{PIukam_~j+xOM1nd06{|^8ApFZJpI&cky?^y8~0-hp}iXayo zgtps(TZXX|SAqsc%8FoA4!$JdDHv2`$iD#h%*@g zbI;+-1P+8u1qp1)a18KbfDsvZy#cwXC5C1LVzUB2?#2#s1eO5&O)*CAzZCDQQwyiL zJHu8PuRH8>+p>L+8v!5105Q+dtuyXplFQ7`X=he(s&BFe@WA&%QhD2r? z(1?sxV+Obw`y05|`-op`T&lkiJ`|2h3||)ey|p+AAg&Ck!%`jwK6u?n@M?$TX{AYx z8C72jLF_%5eAS=BYN?_I2rZShK8Zve^tM}2mzC2={UJ?B1Xb@ERQCtnm?RSP{Zv&+z1oKslg#v!Nes3KW0d*Y&1oM#WC^ zNV@`i!9&h?&;^SSt~_CxfWY=MGy=Q@#5sUh21i0%CQNa|6nDgFMwl+(FoD=TsG+i% z2Q>K7GZYAI5IQV~h72T=hfmr`S(nfWjKyTnwVuH1dZb#HydyZvfmAj`VX!0kCIlw>$D{u~4y#vDe`mz!$Y&i`eUB`1}xD^;N-N zonINfE?6CN^f{sPf5QyhY-`%8+1h-pHPd07^XrUIRfz$m`7-U^)9wKjd`VH>)x%Zw zBYS;BB`w&h&`1G|?l<-<1O!hlw)woE_ zVd&V>O2v*+s2X6>{dnZElp1!;br2gWEHL=xP9C}@w(E@0DHF2E|ELwp)^VQ&j>3l^ z6SWSX$~v*~@ZtK;(y=N7%}+!paHSXv;`_KOjg~nJ*-V94AYyW+T|d!Ax|+Sa507vZ!Q&?*ydz);&wpp!`F*qGD*YL}%B z>|i5b&r1kuKwL4Na@u~E#`bCha4t0+JK#EOu!xr$9#R1ZQx&Q<4{a-<*Y_Z&o{N<& z_w!l?8>!ZNS-*Mo;NQMtA46=qbkI&>9l?70qCWj7j}lF^02rkX2$hEF2lt~8li!s6 zx*J1oz&H_sBOA~{X1HOZ(v}6o6+m5HOM|HR{c>rPShjA;?xt<7V+<+;G!QqOUC#V7 z7~&oxG*?(4hg)q=0fZFN#}xjp_AgE-v|72k)gvA z{Xs&fI-s81{Q0l{8}NC;efo?~*RS|V65jTJmr}5Mg7QNMm;^|{9!MY8fZsnoW0rzB z3LcjQDFu}K4v_?k1mc3*cE{`6fyc*)kO^zJVxojd0l6rO9M&zx2j*$Qq{T|%=YY$) zf+v%g-tRk959nqC&NA6~vK@*yF?QlQ5f0h$=>P)bX*Gbtur9$VTIwC3NUSIm;n;QqpTTTW$)%@BfY)MRZdKsNjqp!daapaH z{szS-5T2vrj~V#6nCI}-*|kY4(4<#0rkULkL)>1xvhO;RQ1VOp?KpK*t89 zWJ9}d$g&~nZubYC0FDsNo?(!Ca7fA6j{|AjAp3!Q95`~qu6HC##&89*r6f75|BVVV z39=9JNi7JcdQG(`B->&jWx{b-eaVr5lr5wv6=0Hr50vmk5ifE_C>BZ~te^nI#F$e+ zJZ#|{S5< z$ZSE80a}{3P9acXOHoa`r7>!R%51zc2XG+AZuU$F)w3$v`ju^l^?}+|nZcPI3f3{m zWToOn3<~xu7~1`e0yUcp^nm6K+xCL{ z+Y8E;!O;LAUj$)=F@+QCGveCW8Jy^%mUKGAPF88qF!?G}L$jHYFK}p>M{NX~eD1OU zxkji}0H}3UE&#GgnZW=Zec+|~bE7San$>Nv4N+*V4OGvkAqr7X!uX-ff$aRY4oGd@ zMhvq?+oCmgjuC16hK-(Zz)(R)s~YGjc-?Qi0DzmkbgzZ4VGu9oSGBQbsYb1Jo|!9*OTK zKGkXgZN|@*bx82^rGbSybtzVm%l2?iP*w5}$ z)LKC?q<(5+?K=2rtRGWnJZV609zCpMX*~^Slj+Rdw-A~BvoXj@Pd|TPbzAzC8?^(~ z*z=QvuL0_|SVBJ+we=Fw5JWRD=`Ka<-Jv}kh}y9jz0aZl$^ET@8YV-PRB!!}L}M9_ zwt`xs0inBsgWz2D5f)=s!<-XpK zzn?&_0av|3!hu&USmTP{KSdB9*3LCcd!RloPnd;pzrSFaJaoY~j1jhVBq_+UVJ{gE zWkxCqsoXHl0n;*r0Hkt5h=Qnskbp%a;yQul08&Oq0)irH0VQCe0L%eL5ZqOeHbs^L z->i0q6eWDhuizu&x7QUv-3rtb&|Y^BFenzTRI3AysCc-p_~|VprHl^~FzrU+TrLEi z315o&;vU$X5wQp~2|~%Z06-+{BzT?!@?o3W3FQ7t8~&3hQec#v!4O=csUG%hphkjK zMj!$!fWO=ne-_0&1J9EsYVHF3GTFfS8xUevd;zd48Oy1J=z(Jr6q73UVr=4*m&mUm zMCmFVaW6$ytFhQgaR_1es)uI+CSuI0=J6B)WvfddsFjEl5ZDqtgDYK_4QK_7DbNNM zLsfO?*iYCsQVK$1#ioQCfWxdvIBErj*E%pPp>}pP)HHy?yAozn1BK!;?Q8?82&@Or zI|w5MOvE1eV&_tXdHxF3*mVq5KsMa5_z+zso1)F$&0b_*E4kZ!N_tQYse%eH1;P>; zOAMH&h-G@fC0wwE3sx)$Iiutkl>OB_LLg)^Rw(I?LdATZL^i!DTi6H+N=_){u=8&} zkhUG^cE`5gvE>7IDoAXF)fKp>Vl3;fVt*DGIEOJlDh33}y{kr2iAkZ=Jg-H8?5VDS zflU&=X!ejIyBF7*&$$TZqhN}P$iN&91P+)2A%GCVY(6ko>hYxD8K9X#QJ|clL55H> zX;~HU>ysnde>Vlhu!ExY(=kG;rvOjZJE#WkBr7x*!~#GUs3rgz91d`p5MoB)=rd(; zDoxvYZ9X$Q*PyPFaS*{0tUHq};nL>*V3m4I_I`rBb_$k8tD$(ZrGlh@igRhjyB@XJ zLO_$Tgq|>}njxM>DwK^c)IR+89z!dDFP<)1M34(ZN~nAk5HC=AM3yI{ydsqe;vT{z z0Y$xMQnf)&5kW2mDKm~NNF`yD04jD&7O_HjyY>q*C-Wj#U#Ev1at_x2C}jTG76NFC z=;Cs9A!E5Ec%r8Upjc07aA0RQr2^!Hly10hUy-*vm^v*(zdaLZINm zKs7NT_B*rt4f_$#DT6S>B42p;=Q9D3GcyL z?4w5MiRhJGAnsWgE!0!}d=&?L)mk7e$ca!ueqSLEHL4T3)E;z|p1CrpxgwYc502fv zc^Gn=fRj659BS3Z>>FdgMtWO$K;Y7J{e5U0de_<<>iYsOLhXV79>ri8$o9X z2Rgb3$n;$RYiG;E2g-KLhsb^__3Td29@mWqdQVjZ!=`r(+UTDxojhkWB)hV5V=+%# z7na8EHkL}d*Q6f9(X-ejbfQCau60~iiKclDYS@f-8RPF1Ku`Hp2XI8<9>3u@kvbDuPhRd@ z*_x)zXHTc4DvxFL=tG^ejg?I_OJN6Ph6iO>4h?Cf6-*5pa2nEB>Et6MoU&6!s{5T3 zv~kR$p3K^TV%u{JU(NO0^STPDH7x$xMjS`lK{E|CFtu#Adz#D8(=v3bDs_J&YM<&m z2DF}sy~$-b7JU)cGo6NRMC#HtrXl&(|NSu^Se_p69sdU3-V6S!pCR#%57!kxT)%)IJZi`1tq%+t;5kA)ugOiUE-#C^0xj6uu!Hig}87pk#^OnQ+el9fa$Yu*ThJ3*plypb$Zs@GmbnENlTbToji;(A@x>a)8V;?&ZLPcL82P zu(VGIq5`v;Z|xd^YvkrP#00##;-Mrf;ErTHW7<*(O-FgX5OPxdd8F=*K z^fxkz=TDPjRmC@CEZA4C#n_~>UM7Pq0=#6qhC@(zx_t{J5-a*L_LP8w4Glef}{4(Vz3gzA*9UNN_+kX-_g%@l;<|IY2F`E_k`276TkvfsGWe1iS>r zO&J>$J6Q){l77z>vdRs&^jPPc*H@4i-`_x37zjn2?FcrP1wsgf7%cHIx=*q5JA_C! zR7zz!3p|j`?xAft=L>w5VL|3f@Bo}uINI|9RIF@#<%s8L#WF3{F&M7~3TeTDXkCY- zC}l_1f}+{`_X@IRWG%?ZJxSVA2So%q@5a#NjI<~0DPuc!+)}}fh}Fh z26yWmR4L6r2r14AXNV?<-XYjfusKjPADI1K{gU1LRTtw$Y`!W*QA$B60Yy9wGelsz zLirJ?T#)pFBqkTl!pIU$5=xMcW zVm>$)^IlTX=D({Ug~HNg;W-!!ZHeIwE|xeNLqrJC%Tfy<36gHO?VoVFe?~bDP*m_# zz#$l87ztrw^Ltj7kg9Pcw9mPE{Kzp4(U4ow=397$O|7QV7O2I_t(ibu#fc8;K(C9b zzlOX8tElsiMk;=t7Ps^ie{BI{E`*Q{6E)iBRI6RIem^9a-e+4xSlW=|F2Cp3Fu`Vf z(T1l4)hAscSM{VdW{8{gP={&-(h*SgNcRSgh+Absr8--baHU?Uo5rgItK!c3ca?eM z#-2$7a1BDXv{D_iEF5^e^U;x3e;Z*`C^ptaePcB+3O1X+4=|}k_u9(kxrWa`8*#%e zt#n8wxEV`wW&d2Rq{Ol|8MB<nKG19Iou8SOS=~#Ne8A>t9*@lfx3HiA$+_BK0IS?rE{= z{abnhx;oq+rG4&pJ(OPGQkM`kBGm_`uY@TA z>xFR7Z}{>xfdvS30Sa(Pz`uR@gy$z99t9c_j@KPnikb7*fGsh$Y-yg#j48|rl7NH3 z(-rH)$mM`&!A=_jP2emjWdpAP(>&qW4}=&oF(GHcp*yf2h!gO%JmAyI9oGoZLeL3V z4yz!TGVn4Tw!}X@dr{g?rTK_Zp6n>s{4Zq@ZF$UN--si1j0G z3cLXL%7nWDcU5fej}&K}Ccoo}1D1mcQ!wBTR$9s=*{V4YB;;3x@O670p!%^L$ZCG65= zo>|P7dPqIr2xHfD9RA!a2<)pYYB_Fa=L?-~_wN?|a9+aMa{pBtn_L4o(4@*!QN#n7 zcDtUY$r5%c+I7V~|J42F1n-3mgcyxsjI)9#0!M%YfjE2DpL_L8d5cg8ANT_11tDAz z;sZjsBJu^1=Hc^6#usTc4{1}-kuy7JGi-&bM2tW#C1^?R&Qje z9H5dRx*JF&f$9Nhg5YL-gjDM(ToT)QjHxa7?K-Lqy4ZCn;=wRJOUDVcJVNLJSssvd z!67RSnUG~h)&L>4^FW3mJ?$F6oC;C^wn;$AWWT~05+-DxF-!E&9_{CyhqIB>fFukm zgiv${FO=rdws0gtVMPg^FCivXXYU7XDVvgjbjQAZ#q0fNY};3ql1-u;fDj2h5kfFV zmptXy@Cmnk4AL4d!)=r@Hox@bQwq)k_U6Y5n2lz)nvS|CvP=f?=lw7TIHPOx2>X0g zpuv+qm0A^*Rgn3^fU7K+8c$lT4vCAq)d@ALDr(-?im|x))DQytHQ#pwVdBAb(nqf;F($?X^=)>38yoZzba0Dvdi_m~)x8-**h{2gh-Rw?n z_g0UCw&Tey30vF4PPGeRyBu{WeNa6`+3=ux?*H@j&4Dq|fepmFx``3Y(XY5#J@?Ix zL+i=rNCWu8Dey(1&e)DYAOlc#)>NvDRC?HnHU@QAUlMRuc(TQN*C-zy`|*6+LjzAZ zT%U@*2yv?BT?%tghowe=V(^=FWpPXG9P2$A79V@(9Pn`kchn9;183-AFyK+P@G6T8;6!0}2xP=2t zP`o4{AB=C-3D3)nE$vwM0zG!Dv-OI;ykwMMf0mNKk|0GP6c85kOB^MmSGr0inR^0^GpLL$8Eim%xK;mW`y zgl7gGBXDytwR`IIJlo%WQQ-H5@U1FtFzH@mV1-F0cc?LC{_NicnEg7kVafUiZ_dUE zOpcn_hV8%#wn|6q@@pX}_Phzo?)8(#=2(hhU08Cv{)YHDhyZg@Cpi>Z37c9K#|shO z0NnjG6^|E~0Zc;|-~p3076sPeY?TLa-c+#(a0|dHy#iw?z~uKAWxGC^`#qGr`=a(2 z26LymqQ+(hk?}sDZD}M*{tL}UFlHrJxvqG^X#nsTRy@qlxJ-{&v@7VK!LlP2-cRyP2i7odWTm)*KtR!|UcLFlQ??QGr>Y+UL?@AMW z^s222wwRhz&Ucx{0B5P;Jv~B#PxDH38d%jyy$1)eeofE(u=H6!MtK+sm<%J;blR3$ zxjTTY=jwp%qX3gwn9p1nFSD9&F)Da6#u%ZhQ>5K1Nr8_#fu~1=k;);1% zu*4ZmS`RlO*j|T7OKXQOYDFw58XVhVz)`IIqH5pp^Dy{paG+yK6+5v-tV@u@03l&_ z@4EmvTt1p1NcLx`Rw65Vx23iN3k_aJ5g|_|i2_D`4g+1p#kwFvL1sar2@_0~+0utSv6aMTSr!lL@!3~= z(QSYb5LT~NvClJjj8Gu9G|_szB?D!L?627OFSs3Fk@9XIp_XI&vmTnf-|QiLxMdy=&Ebr(iB31)aOh88uq%7u0j(KTl5R-VAZQE1F;ss8ndQ7HXdj8rG?m_O4EGUtAJyW4~~pLhm#&K)4IxdV9@Mt)_|)xOE*T@ zk4a?cMU6C+nb)}D5de=28i@`P(+WnbgRXQHpKr&wrE88A4*kYmUw1X)cBQFW7!Hkn zW}{Y@PB3e%oH&IP;e7>y_IZ>BklDgj(9m-oRDpNJ^IbGLFoxQ_ou@BljD-PJ4%(_n z21W#RLtlY)3kTp94nR7hS2+W~7SF4vj?G%%p|$2=WNXPc@Tc+Kp#fDVSC>h*;a&%y z=)maq&j}~S+N7Q)ryZrI?f5&3CRK(q0&DkLSZxMQeowCJkDgTAfnJs6)Q}nSWlr-2 z4j<zhCt5 zC1?GH2YF{`>yRKO;ThBmL#%GUPMS2?>xxy~%TW#5)pS;C;sg!Na%Tz3!M|#5ESolVC^2asQ0J`}TYM z@^)a`Ua_Z)+f?uvf%R!ZDRwW)S@5tj9w$Jy9htAlU?hBnP5~)z2w?@62$TafPY5Eo z#(Pr#3!LaIgar4Tl!Y^*MzPmZ0p6A<~Y94g4cLVk!nsKx)x!X~SOfjw1Y#sU-*%=enqWVgA>f7On) z`up|A?`Y;Q2_IDtl>a++AE6(kTH(HK>?G6_PV(pX|Mbg2aLnGFD`$E)dL!EQrRz`mwZMR1{n);IW0actW~T zZdRT`Ua93v0S~Li#K9FB1&{-h-f+)f@b&nF`|%kiABNk5^$v0fh|FLn1hP;WCa;%p zKuE(3E2vn4hIs$riw5b~!oi>4jmzES`WNEjvRiSKnCWZl$YGMQf6}7MIR?_n`+JSrD^&T4}A{vP-S+skH+* z9lFpk1V*&*g*G*d3kbC_FN7X@--2b(nI}FmaA>lJQ94-tYjh%NMkde8r-z}5YqA(= zYcs4LWFOzjT{hTtC3PhosF@nI6F&oHBl9uRKEs~8DZ7d&#h~o-AhiVr8 z+Ro;i9D#iiqfBkEJcZVbY~<(*L{E_IWvJcXq$hcD1@wc2cw`Cn-3i}3q?M`b3}j~; z!@yDw^2#A$n1)RrwXYTT5Ky}h={UkJUj%jL_{tSNjUC;3kP6J2$7*{1lAb|2ev&U zfH4K&US2SV2ZUq6bo>II6+1C5*N-UM3rex{I?fB|m9cz?h!Y`TMj+rdANDy2}BCnwOpg&c1M($dWr92svbCHe zgn-BkO4%SW;JRE835WMve$FPlG|!NM&Q~!eVv=gH zAl#$kUR=hf2C^Q=O4#c?(nBXv{2ERSBoaK3ViAk>k5wM-qiS&(a}q(e8aU7(tt<|N zQy|<_@s$jm9z{{B#}vREfGZJJKh<{y5(Wtwi~-{+J0!xaR@1Qw;f2(DqU{^5Rm!gh z{zxn_6+`NEQDaU-?RD2Zr>KL6_GddT$&+9YAHfSO`Snl>KoX-`Y%>o)Zv~ zVs>>$@LaE&yAjv`pAPr(_IQ>7R9ESL4ZIrVV5B%4{fXkF3~3AS(-I3!hQ$+lHW=zwBz`;}AJx#Y5=-{ept|}QN0MQpPu*6ZGEuD$l5wJxAyZnQ*4_0n7&}5!L zIbhuXVft3e&fciWM)ffNo|eumI`JVY&QNn>f<)E4lSNUg)E~)Gd6yN_{1F~#;s)xr^*wTXuf2iF=hDlO@|b}d>`IJs{R4xma)xwm_eSl=Q5RSzwytejMZQ)whb zJ!V`r7?izHVzgD2UVF}NJ9EWgWrE3X=$2$F!!_%mPivc2X+tv!S*4Vjth@Xa+5n;b z6$6?Lpbwd#ebeDdgWY4M19L=;eXGM+z0iXWSO1VWT04`p#jR_j{;Sl1PL&97k6-Uz z8#@U>L$tL2oEpwTVo2OzL3tY%GloZ%+oVQ}5X0G5}u(%k_KP z4b`_Q?e7QB(tuMRT)EN79X$4f5eB}-_7FXDMo)}TAE5i^IGP5DdYA&*aXU)@Yjp2; z{CbefFlY~U&gxZdSsqm$spoR@cIx;Rsr@&Nb(0>1&y2GRFQ z#lDn)Z`7-kO@~U5cEO)Qi={C~C-5?)Nwz|jflO5|PN$j%Iw0^~BH#bsHcZmNSzG1$ z@u^*eEzPapYzSzbhvN;%G!|$j!`)opJH0BiSUW&_cj=Jz=?|`VYmSo_Rh53_&OCWi zsk5s67Q@X=!6*6h2sn9IW`#kLN~d$GO267wf093QOPsC2F)}>NDlTlIc2bb!0i>cW z6zXTMIyxs?M9%35jg>Ss$co3nA0F^cyy9is@bz9Sar83dUKB@BtXIaYggprY4oI57+m8HtAR<6x zL3muSrB{@kK(BXCZ(M+|Bfq@>MKL`-BFF>MSH{Eg0TeS1YzPXJ49xQt_w5z;e8aLZ zF3A!R*T)O~>C1-Cx4+;Yo*(c(ee)52{=DH!R{Y_jSPu)I5fUtMGKJA$sTZ4MOcX$2 z#xzAN5>ZHiP!QNWCws|uoa6vU^NLDVEWucTz!4>6(9}J-DQDcXV#|bkHZS4B415T{ zBbkpd)v%6etlHJn8VeCVlQDT;jKIbxXQlo=DE=5`eBFWnqB}U)y)QYta#O3oSV#?Y zvf?0@j*_uk0t22Csj)~dBNSg?7f}@PAr3%-;3Afg*dne}kw{R~JefsoV2&zaS2!GO z(!os?U&TCbcY;-S_^oUv;6lKYr;HXcMrl%ezmAy=MEI>Wz>-pT0EZH8>T<(j)+hqx zLYP%Sq1aWS61Vx2mZA35O47eq|X zhS-}CP6qa6$98BXuCxJtV$o1 z8tbUkOA7|8`{)FRjI5&1z$Iu?X%zvIC>EtI^W@4h+5K>ejHl@VPtylnmj|rt1?y$S zx?Btt24|f-vC;ge>_K^A62eLnRH`}Dl+)Tj$o`Dgw#2I;VFZT2B z>J$>4f>7#QRNw$a3$y^oQT&=^B<=D>A_8*;0^7Zxt$4k5esaCDXiZJ_FeR>`Pxc&R z#|)D)Cbdq&DF#sV6E0^I-LT0U-i{Y+`zvxXPbp3A2W2*|DG_RE4Jm_bo-)-YLiVqr zVJ@aIu%MO4SE;sC8K@R#)yOS;>Z$)|VI3B-X&_T&AZxgiQ`Cqw>maP@>b9`gkWJmh z2L3_8@-!H&eoMW6r-tdlQ%@PDc(A6(;&M>+E}ELS>_59M`lNKGrKt(+RY!7(RF%k4 z^VLuXM(C-6V@OGpHZ_bvXN6iz$~-4)R>p;g6wNjOdMYOkbrzkUQLu22$N!b@&;P6) z3UJlP4M^@DM5Id}DtjYROTW!uD$UQw4LsEw?8*CBBY96D zFI|3GFPfH6Ilgm3v-0=9<+C5Gv9Isgq5=5Y#<8cfHhoU*B4lcWuheU-_9-^T&~@;2 zNT~A91|+$6QIeX()a9JY4xM;dPH+#k;kFOp;ZaWQW;C8fRnDWs;)pz`qcVH7OOgkd z?O0}Gz-sL8Bl8UpyetiYKAi>RmLl2;WQWhxf@tI&TdOCKKPdhOs#kjO)#-8>JO@?c zT2o`SZj}4^Q)S=+oK)HEy^jW;;eOWq4ns(5mK%0@0Y}CqT=9k{?D+;lHs4{%U^UcogsEI}{TpgklfuIS`Kf z4b$?7)8URwltxMwIUUXQPsCXfA>6{Lr4!An873!Vev9!)~{FirTH z1e*#T9)LgJ->iR3Y$(pj?F$6#hu}>Tp4JuNL2>wTo8rY|#|07;JTEBa4U+dZEElq{ zA_{~l`1+G4gb=aP1fmSgiu-X#mI89Hr2#0}f>M5%P2zSXLaZ7&-=LEMF#`{3Qp*7U zx}umw@yb?E|8E35K`;~H16z`)svV2q>%E__Krz>Qa8U$SQ0SFWl^qLWV5zA;*p69EN=<6O^X|tu ziLtW@Uf}?3a#8i6?F!(kGqey=I*`MG%+UtBl9A+&TY14-`hrdGI5?SXZ$Va*14qA)SC2Li(@7vBswRS0Zy10Q>Pf3j(Jv+&Hb12Y6X~#TsvbWFRc^m; z&xOV?`;E5B`ReS_v>WYv_51eh_cjp+gVbfF${kbIzpoPEhBc`RB{H9FCZyWyLfrmS zkIN6!iXWB_cv>ECxn6L2Sa7|pSe6xQoDkeE&uv!qN()~c8fK==_dZMW6;lQs}5oCZWJ1EXr?+`uQrcj!43F-xIRG}JLn2ZIIKqA;pL= zPYBCL(DZ~X7v#KRPYbpju;&RGv8kup>{ROwpq_AQOBM5o8tZPKp}ns|fTK*fO6vI^ z6u?}-EQlpQqc(h1Q#ol!N(IpnFk|-@C}UD9sE@*!h%vbo)H+!Y2;Okl7rd08@tS_Y zp6^gi#u6$as0V{dv_x81+9eQ2#u_erogFAYVCkZq*b1%Ykak6KhbL- zjP!w(v^ZNhWMxo2CTh>;3Zb0ZQ>EsOHNc*o4IGtj)B$Rn_04NtWumHfPLlgst4~aa z3Z8Z@)~1LdM5o>}Vg*>rU1HcrBOVsl)VjB7d_UKn010pkQ>jtE_;oj;>dAMo9=Ko&rP;!n+>1RcoL>B)~PL)R99gFdZbEI%Z;0ONYdmE;$?q_WNLH zDN@|}4$tJzyLy4~@0*oQny0kEg(`=u314H%>gZb}!C>U;Y$MlhLf?9v++AaT&k)v8 zA5~2SsOOY%8ik!hV2!8!v;{t2RPVG>JVEou6j_jb$!x?H)t^rDRAW0`s31SC>!-YKb^>j8gG(CD_ z@oNI>$doqeDW4eYCR5cOmqc`SGglXAhv8l^T|FV~T<;09Es&=9^msV8bWD97*lHO_ zJKqYsbfjKGwTu`oI7){Vle7StexUrE)$T!2=&(lDcWh!mmu*?14LB+R83`}P3y31t z+3H^^+&4cA~&l}!k@Y&`16&H@qyurE@bUgFjyd8by<(XZ1sR+J zuxG>wWEM~$Tww*(+ZyrLqu}S41K+O3ARRN|r|k_N<_G*%7QChnpIIRX;Tr*_pm@tW zR30&cQFNWdb^El>n_ zNs5mX;R6FP64vN)rBIqWAqudt`2kZlX6IGBI>DuUTQKJ6|C=+uQ{eXzKq0(kh0cT> z7QQmu=GF#nH5n?LMcKuCH9Ab!T&)xS{7Z1~(jb=hl+aGN8Pzp1)cy4Ti@bV`}F)-kx8)vSOk!0 zSH>jvd-Q9I0YndLt8<0TYK$TlK2zM2cT@6U8*PlNI0&tPkhEtXOumiVvtZ)`^L_^e zC~*d4!)yM8ulWUUwBZOIAJ6^SKtU12nBEDBQdKNf?(5eV4QipLygDtGt6Wo?GOF$m ztH-j=k0wi`76#Mjn?856&%o!a>9q|q-gD6y6My(s^$pvzMW`o6tA}{Ny9DjO%K#Eov!_s2QF8s=!emqmiX+(*mNJ@W>@s05Gj?GV4c#hJrG)-H#0j9H zV!xbeDk6Rz*uN8Bv>kGw2t$>@8Zc48%*N77l$MoeA!E zjHrys`yVMp2kMGU8{Y5*Z{-vA{DM+8jQ!3cYM|c(Cz&j+hLufD$?P)BFsKgE{r@f0 zPurQOQrwqk$4-h`l4k>k1TE5BAN3rl{^N=ZdZxb591ikYDBh5_pzZIopOdbHaQ`A$ zhRh6Y$~CP^EQtFYJ)O4nB~X3s4ajQE(IICI>w7P4R*7|(!3hk$8=U+Gg#jG$Am{QH zk}l))6N6DZ_Wa;@sv&D11mV>b)$26YMwpaBPe4QmAXULzV-1F=RUYSX#XC-8EI=5C zw+>`l(r2^2d8I{jaLUN9*=DxZafqJ^m9q8k8`|H|z^YZ>btEXaso5y^^5QH76a8o|wS1*P#BC9_pbjwwYv*^fsW@fnvi{ z;;a=>OW%TDyYTHtzPiWn8!U=f1x@HNe&v7I;CCN z``WeCv0h&WSgC52Wq0{Z2i&143QjeR)z8_^u6GP8hTpWyQM!DVPX4=I5yHO;qf*pl z;bEagXYP@`*RrySee4~iO!d0(EvOm8rBALpY(o16s%^3>XWRq^13OsH$9|1!Tlk!A zJj1mNRQa@??-3HgWkSg_!XN(!JpJ9@;LHE(|AwFM|A=M2;_15Jc`hK?vF{AQihuiZ z;H4CN7a1QZ;KMQ@l^v@JUZA*B!Jc>g-Qxp3y}n@Aj4cAUUGW_=WF>6(f;|E;3XV;& z7si_ia8LNi3zp0X*9&5tu%(0;BWPpfJ%M*)S~CvtvLcYt93mMpL`;}45wL`Sx!m!$ zE5MPk%mF`cg1Z)cNgMu$56}32{x#u8DcDI71Msjico$2v1Yynr%guJ_h!K&q#c^}A zK@5UvvLJ&PW;{+8lXu0?SlS}R1KI?L*28trz?KO=-R-o0oD^$}h`~176oG|3Odrx+qLXrTfU*rFz|OcxGZcLN0p5VAgm0mp-a;v zIWSdY_jnlg;lU`efspE*rY4ybSnx}|&Wo3^X9hx1EL8tos}PJA;2JRJshgq&*`@E< ze|A^S zN(A>gGI*$rdP1mr%{To3TR^10`Z%3bU4wh2Xb;P-#pQU%6rT2HY}ZdsjV1PUq6T__ z3o*WrSNyO(;`w?pKzLbkSr)8Q#8jo9r|ocmmiE|I8DtpR)ESkHZQ~HsmPyFY3>rH~ zlKgvEzOH%2cOP6#&ZlZp(jq&AHh&&j*JS(o(ifOg8c}5oq1y9XNTD%cS}&L$z6Hl; z6kL$Ygsc+|2{;Pdf71?Thu+<0<18VGmCg$xYwfT?0SlLA$`)tx^ijUiIOhtBQLCg*wBjJ&U2X z7xcW0(w0Tl1{SHSl-`eS4&ufzk#h>=81cY9at#5VrrU-#7EK2RvHgfaYDvyKwjohR zgR-0w3u#C(>^*@aq&nZ6T2wP+2p%~L$+X^FYeXw`xk8n1_RvXcWDdFJmobE2s19C8 z8Zw`xQ`>}r4eVKtRr^eBC~i>h#N>_%A;aRseV3=S6R%weZQyJm13kIyB>ZRkcT#CF zoTLVVS$jxI{hV+LG@-s=Xzxl+%w`Q%A@MEcu)Q9>+#0r;XLNKlcCTLh(6xh$S~}i* z7i~i{WZV*COpKyY0^0bgkvgsN&2xQ3t*tow@`fN6_r%s9nfiXU-Mk0Q`w&0_rXlyI zhRRUee2Jf|y_0YN|2*~()|&{o1x_6fPb?<)1&hf|O>%d-4^Z{AO1qBjdgBJfPdzs$ zZ|}IS?)Q`v!&a*uTFniH&zro1u-8Mh2W-2-qa+cuTD^r^aJ9W3WZRW5uOBVcDKg?gcOV4L=_Lg7n8H z+_pCq+%ZMQ!xBJr$G#s>toZSB!Jl6?tSjNSVZv|A1=tdDQap;{aV3161OD{o70&qLys$e<@4{1W?fKBcwK@o`X`9*L{0ry?;fhPpbnC}VKj_;O$a1>(}-W0nCUI_SWKJeGKSN!esg8%i? z4Y(3081tl_B6-n(3q?$hd?brScq3q$7l;;=1CU6VLc|&w6ek=0f*{KqG6*5e2vU%t z)(OXCCCkO6Rli*rkCXe9$m$(5D<%Z5M-uB)gSxy)F^eFO;s(Vn08h?t6}MMxk?^A` zegN9ikp}Ow2r5Z%hL4U$e`ZA!l2 zp31|4=Uh|!)VdxMtM`K`!0hRoz7SP*ADpFLYYm#Ie)AU8)$J@Y-~k$yGd0OofSVjx zg)t=q=W8fn*|3#2dR)lF=PPRzrc7 zrqJ~vQd4w=y+GbO(sM|mf>4s-@_Z=N%(tM#eFpX}KC0e+UxX|7UqJ5nL;{vV#_B~cS)Bk( z?yuDBVNI{tk5}YlYoZ)g0t>nPom?r@J)Y!VJ3Fs=ShD(z&_Z0OC%$T*z>F2FAw1nCh?lA;hx{1bWqu!rdQ-N7m*wSV^@JZTyC^bujxz9i18tEaUV<;==c?KS+CsM02 zJhZZCCqHTmsZ@!opA$5elyXCM5%0r9hM|mfkZZLepIe|yy^(O+1ok1F2S8W*a?rNw z)BqR{0VwP~C926iKA4Sx6OCPIeSq#xdfyK?fS5ISAaom-4vCNWW7_KAR9Gip}u1sO|=bJ z4v?7!m=nT~O2nStLelklRm-x%pb5^kQcIuPrS>8PjE>ZIT8fT{Tf2PNqk3)(g~ zK<7V4-(sif!8|IqJcEN5wlZ5I;J~oTY?4D7d}?Jl{_nzTXp9#g))ckyb^v|# z^HuljF?Ci+soqG@l381`0fPwze_#UAyv1adpzlsz*=RQy^HGn z6UKCe5xX*s4Qc(YZPPBpR&9{eH{F1?^G2wGRT_M^dIH2c1a4uF^VYd!qKK8h!GnGW zJ|Z$UyiITTiWhwS^dmm~_*d-dhJz*p?M&E_k#WJ6BmVUH7t9Oc;}Y=Qyx{xg177bx zfd#lED>1$&!P5k6vg4J2zy1Ap`0{U`a1+5#L2=)A%ti72L&VE#hF&9HlyJWv_%2L% zcvz9KV>@m@5nMuqEP|a0d)cA9AtB*7tP-7h0+JwD$fylpcR7BY!zRqj?R0+XfmNt2TLW*gLs>}%i* zQ?uwGs)64wW3=b*Qa!vX$$KhT}6>RFlHv3d8(HwsP&IhQ#zqdfJHiR&Xv_1 z*){EqUK>bVz0nnsc7KiaJ-O$;5J6a5K3AO&wXrboL$AD#F#2aunNBj_VW=;Jhqy1l zy-w6gpfZFGB|o3bdG~9}Ql*w^%PJjWRy*DEfU74y1cUMI}Uj5tl8xU?b4 zB%|t~e16t(JcoOE#6R^-u$9XX9{Jh%P=P0j~?@=Wh`&-+|}>T2_bxi3qzA4k4F@%4vCD;m(-TE*_|o zRghc23|jn5v*CD{AzZpHg&`$CGl8?$R)sp=P?IFXrK5!vg$s(;b}#~F5M~WsSy;8n zlW$2RqiDh|cWmhuN4i6kojfWgL2q4N8bHBwaBC$4*L(+G7`Z}GiN}21p$EL)Cx#T! zQF`lan>f&FX{}B^h-$Ak)Z7zIwYR-e_4y8+?&JYeUP#$hh&6c0wcjc|`=PS9;NkPE zWR>)PR@id2EwG2YkA6Wjdaq&6C5eijb9v6~8%Elb9PHh{t8A7JIxL+LXgb)zqsP=k zIa*x<)p`Z-3W%=3r4}CHOj|V$H94Un?&{~OiJwGcqn|Xkq02+M53=ehT7kTvud&8} ziPJ#Z19PZ(=Cu0}26s?1WowO_rv89x53KRQ)yrgS!mGBh4zEnmo~+npcSB-IEqotY z-U@13nq+W?Q8Zc0+iTn}cd2X*`{02rqIVgTTKgJhV6ldvmc9{@ z9(PSNi0X8ZICGN)(BSO^QHvACIi9F7PVe^~INdb*FjN6<_Xujc@nDp0)lZQJ7SW{u zG`_FVFiHdCR#&jpGdRyoVSQirwNkge?PuuFKUgKB+PgW?{fWfdgIZ{qY#M{b1B3lu zOHdQNc(_mac~(;{bR4w&dSeq)x8z+1k>d?Zee+NB??{YVbprr|Vbjn3=05lY>IRK| zl|9>&P0@OXe78z?#|Zj0u5|YQvB$g*JTu5jVKHp?+E-NY?D5yblfRktr?BGb@;f|V zehYp(@OFH`&*3NhEMM@N1h2P@v;lN%cr7o;(Y)08YrVF2Lmg3JK!+faz_+g9^f|xYGgNU-7%=6+ctPf8GyVgW&gbz++snBjZ&FUk=5E z0hSC*7tqrMc`KOj0-k2b<$~MG8%oXq2P9+^5T@yZEP^TThyrZ!hB8O2e1%9tP8o5T z5VN8b!TkTH>tA{;+p;u4=o@3swbtJIoMUG9;qDP085J3knL%b0m6fGRrBo^bLUbyT zs)+=GPW=HS8Z_Z2Aov3yK@UWWhoD1=MkP{7g{XW`R7PaR(>>hpwdXl!Kh|1vjzMFL zG3VUo5H1V5*Y2_XT#xaM?^OtI4un?-RswG8hCh1qfdA~r9bX`LoCyaaydy&8idR^T z1||Ex>n5OGvAI7nO&+HXLeU-Pa>j`#EWDsF;VLU2JEokB;aN>~c`G*DyvZh?%L>#g z&}?PbDOs{9*z1hMXc6|%Aa&dyZC`B|O0vl$f}IO6mXh1T7i~z5 z>pO>DlBg{MQb=bh0_j}T8V}{s1 zmx&o~P6wP$3l66v4yOYS#|85;gXaT4v(FOJJ@GO)9d&C7+Q%r7b%BnI|c zy;M9vVRUg@Fo=q48>M(3pLq|VyUX=00Rmej$IFp{bH2pJk;vPn%JMgdr{HrJIu=(y?>E-mqC>s zq)}g(l7|=)ThJ0KN)nV{3th>vP{JfVGX#mO%VxGxRN4i#thnuGtlKNA7&ghO(yw(i6rPQ-DTjUn7624b_ngaxkk zpGoVP&Mla_Ng1j2wcU?1{Ylu_LLPvPd0xW%(pkSIU`I$tr7?fen>MCza)g!05Za={ z7GLkj!{nPk9*P0Ti>U2!YvX=+OwrQO|Jd0$R=KBsd?Tg`%`2#i-w;jMQR$J5K0{jgbC4Ba706r}`D&>v9^7&2{U19MUp}n~*Za5{xs$5GPlB!|?pkj9*GNe1Uv2;a4c2pDOqK4&Zr^?JU5H8hWCtyF z0Ay)@m+sR=33u|={`tg79bmI3!%~x-`t#F$Wkm$Qj3w~!EmdRhBG$Tjd(dR1#3M`R zrJ{5n`XsR8)?Pe6u)!Xo9r9LopsCcE=T>n*>;Q7?$%^Oa_IG|mLQH-Zw{$HXyq)Ny z#8*tUk___5E{`51*^NxqJ0o8oSYYwd%_E?}S~7ZPqV$wg_fU4PZ2OiQqZzJfjew!> z{)&Ct;eFC7O}MK%ej_~(ceJO();8o=jV1K!PY>QvWXgE^=J)XKC;t`9>4;L!__+TW ze!YFhCw#%@dco_ZV7<(s{eWB;RZpl`aVs}mUw1stiZ>5Ho)q6sNBq|5XUORzlrH$P z{sMVX)N0@Dw%#ypJHDA2XV`G@e!JpU6W%^NU{k?s+3{Bp%=?DCB)qPQFPDO+1EDHo zqXPO;a9C&LJVTK2^0HyQT2Lxb z7=L{mkOf!HTl?v8U@wzKEF{x(u&3C6e9ef7HU8Hxm;ASi}?kWz5i=mfRS(L z-Cw2x6pyn%_$*wjeMU`)p^+R(K8)L`ci^Eez`c%j2tu+{NdIT`iscl3DZdi*+leVp z;XFJ3d9w!18#&@~~hz z9FV33$Vb0t*Cv^>F_e5BiCo{>-iFrE{SqGphTc>=r>whdT8mJ{e z*-}|ct`)GcZ4s7@eOu&6VL2_n@JJUvvhx@I>iyKGb=xU;pF47S8OFb1C)Xqbu^ z5e(@HM0U*NX{uJN;HCCT4ZKma1rGD8U`P^?9*h(6-vGMGzPOMf@Q%Jx?!|)N4uITP zBbQY&GsZ&raj$MOB()G1W9WL?V2Yy1!6(=xl@vh^+>1|TOx@C9BjtXc_)?u>{}6XkVDc!qz2&n)m*FW{et}+a)g-#2pT*~oqRHRLol07I@j1d@`J6vj~3{t zGB9)@gQW)GxRq>683vDsA5S7Uh?)uFKCx3f_-hPP(B;FoB%nL>Xw*B%pmQ4Q$?t*S za9r~UVtayR7;Zz(M}DEz@XCc=JW?TtWKm<@9Kd-;jp1zZ!KDK&u(MZU3mJziROijbG?0jgFKuf@yh`y4T(YH*<@if z+LLdaT$b(wlynSyqJcSVC(T_LR!B}2T_WB&Ob4nV(-{7|Nn0Y3wn?77HAzE}5Q$&| zAXRBGG0kJpq|$zOkUn5*r|id_NWXzZb%hX^5>C?-9+x+GeEc2kxZ-*JGyGWo8h>^B z6+XS(u-*!8w;i`lq55c{DmtMuqrl`*qKdUDst~?;^Mu#(iiuuvBnuyyveh4K3nNbt zxO~1~DvBh6Lt?B4#zuncBKYO?72h8Zcq0e=YCq#o&ILbxyWo$1ydh1d36m+~b=`6J zvLhG8`rV9joAC1b49Wy50+3+60Xzw`2(B;?bM_(hRL@vm6{l%JDvbFygJv7xrdPq~ z1e_iSZ&-nu@Oj^mbH-cE__*&#S&^BrW#H3R@lb&IV8_@7#g`S3P4U19sD$Tp!Ms>% z-AW0wDt6hy69CQ@zMv~E)hYwTd)!VLIQogYQ9(-F7B&@vbJ?2YdlS2p>hROr;C+<5d?*H0r_tj-*pwtG1}3AH*S zxwBml9!O`9U4raUEm$dPR|bzI8(3!|ygeT9^l-xAal!mJV>ul#PX{0`K+Ziq%nRO0 z#O{G@QQ=X=THR(Kt*#1E&4Qvp5(~1@Qr!umLZz9>Ki=wTK@#(!$KzeP~Fc zjg-+H?kV(iVL>E=vXd{#LS!g`lc#!y63AbBRbV5*OoE97g$T@w>gm$9m=aVn0G`y2 z%`8r7SjrM~QXo|$aMl7@S6tRtTyM|VFE`Xpp}XS}F$Rx`pzJFtWdqm%gxIqNqOaOJ zCw-=1P9`}88RJXvUcZ=c5{ec;#OocxUpV;nL|Zy6HNTRcbVZuytH-IJg|>7;N82w9UIF&5KbA2$Qkt=Q z3~ZrsP;_%W4}m06F0VaJroHEo6!-*r7qr95!|UPZ6}n61(m}GOV`NX4)lqk7I@lP( zW}1|=CzA#%*nS_n6ULwy4d9Q#!$qSbv?sx~L`NM$bK-FF;lL!Lawn@rldEdWNr}YI z&Z7-?DIIyGexmgJm~NI1Ktc{I!^fthVwUI*94NXpQTWb9HbC94Kq57DPa9T(F_ZXd z!jM$flQxa{qrp%S2RkzC+*AMvRr!y{RhTIsk5=00j z?suzV>6GGkC|2xMak~i)GvV~eDA!M@C4-?@Xu%8urGk8VLfs1TUTwQSXROy9s6d)c zMkGmb+6h0OAMvYo#XtS46*p3Rr@-@BK+}e|q@bCQbO)^)F0TUI037|Myid4poB4*A zaP|%Cbexfv6TW+>>b4P$Cs~*5wAqjZdO_{WcfUk#|-TI4w4K|Mdh0Tt&|~}Agh(>5zGhn zmJ?1EA!2Hrv?JR*iI-ZTTrG`M6h-X2-@yW;=CIGS`uNe zijM?55b)?>E?2f>!slYL#uF^A{#LBeK3FhStBtri!?MAGYG$&c_{l*-1dZ*!dA^DD z5bh=+!jvo=h9rVddI5`o+Ri8X^#s)9Zm~G3EarEDhvTTa&(XOWmqONIp~PyZ#ua32 zYy)K-;6yR|p%_w`*d%eWFpFzw%pb-~8M6t$mgd1Su>1X`1~b)f^-T%W^9r=dA+r~& z^PoifT4@wBr@%dR3haJeWVU05-Q&m9>j&U-((Km|9u^2&yjJaA!#1yxh1u}Hjl^|Z z9e_)44Ag7Z=<5(pzfp$VH<-eZF}GR?Ut~%!*28=DczatQ_+>V*Sw_!w$-x{t=x@oe zkznbs^_UoMml>zS0n>8CG*6h944w|4bg%=vRZuh+qPgEJ1_TwGNlCRh-z|e*(|aUU8o0N53N=9K46!7}{PYfw?|z1d zX+^0OHO|rIs2^m|T2Zwah!hXU(qNZ@L5&1r25I(8^Nd7k zAbZe&k9eI$QAR<<>dw%V{QOA{3jMR5Bw+$!66*6Q+eOPjxBy!Pt}AZWXS`lN;C6n& ze%&BzpF7!qRGC2HX9Hz`y^~SRXV_!ZofV98R~f8%NTl!4hgM#1HAFS${;~XBxcT#1 zyVU3}lsF1aMC(Z7Rh3RA5lZalM8jzH$FvLZQ_Bq=NpL z#5Ibff#?3J?Voa(ii0`20|Ffe59G=S2EFv1?*F`LI7c z(1gIz^Wi6a(>k|dQ2T4pp3q1`erjwrEz0(*9y4G7ooFk4k{)B*!Y~NFL2}vR;K`;| zkUjXAo8PfBmt)!?-Dx;Ri6RZYMYOP&m*AbTpTda_*hFput! z97Ae`I~>QwC;2f}?Vy&g{DJ}A_&$oIi9aK0iM}pB_pZL7FHW1B$-xEdR|#x%Cv|D; zA8`vrYH6ioO5|PmOi$?SJ%d9GICZey5+;LP;~{yA2G%TCH?s7p=zk&)T+m?j0!jza z3kN@8u!?rjr!@3ZIqMWmBDI5ndQmHLkC<&T&LQQLhjVlYs%f6WU^LrqJ$$WxbL3bgxW67_q+!2%?@9hOcX7I#Y?x`caI0cMJ0_Bi8$z z(N_9;_qYidWU_q$Kb*h*y6%oS1(xLvzN6nk`Sj26>+=QAN5TGG#_f2)wHDOr7dWpg zo^KTo4@Z3alP6p+g4e6!d{tmmqyl7`QHwQ-6}p)Toh%q3Ghvk#dr4qsJiI;Pyq!^1 zF%w(4HzmyT0k`WJ(`g1$McoT_CTwRlzt2^1nrED);)^`v+kC)pF9&?S?ASA~WWr90 z*WDSeB;bb`QVOoLfmCs%1GcH)^XmntW5(xF@wp1pdj7QZ<%cBi~vZ;I2y0u{xdzHa!f zBk<1ev^5u`%2-N9+8LEIasp}fR(&xTww`#T97##Q&Os3 z!;*FE<; zVu5edJ>=%5zzV`j22|~Eb^z%qqq_sEqqf@&76*jINBbM~+ffJsvjR&+3o0Y=u!>OJ zID5hDeTKu<-f9;5QdJ$C3@ZE9pW1@*{1Ts(tbALI*<`t=!a^jk&Pqn9d$Cj5;{Pd@ z<8Z$mwZzUCDN_J4B~%BAv8)p%6#pEfMud~yhq5%Xth2kI;jz&`;h5(ZjY)B>&HgJ5 zB9mAU!vX2us+;U*iUaFvgbSu{D3OPC4hoLAXQ$!&%m6mA#}Reb&_UxVXFMziOfw@z zB}~dzI}=M(KY&z*>v>xShI=%`{zGe`3aA$UG4X`a+82~mn%XM7VWRFQL;++6q&ibr z+r2^{em;cs&%jax<~~!2`+bE7)58-U-uxVIj=zm#{st30xVfr2GszY}R4ok4l0@k) z!P}(ByEi8a3aZIPT_&zBi;OFY$(&OIgiHz9y|QqiBWeugj*49iSQINf-POBFC5cs; z_yoloMx}H|!gMpU7~Q$;*l#zy+&<&w@&UKkSID(OH}~lw8V&rwuC}aI@7zP{_6yL) zcb2#|NxQuy2pIMNIRnRoDXy`HwME#quI&i5QLF4|iT1#65FTyTk?=svkm2GA&0>CR zVqY$clR};c(Qul@8hNM~zLJ$|4=MB$wD%A?jtWqzz4ERF^7wzt80326rbrreh+q`H zt53in&5SKlgCV4MUxYn|7uWj7JN6gF&5Z|5APqkgz8`AapFw5{9b}!|Bq8MvI0XJd=%8 z#9inMlYvEb)|i`*Fo4dmMWP{fli4qDgMW@YJl7!%s4X(c771N4+^-ihT!Y$~Bt31k z$A#126QE(OqQifW6+bnvC&w2~qrY_sI#L?WO>LXq!S(O{#1MKoZ>+tXRwLHGe+rH1 zR8o}ng6sP~$67w&hkVAzr;N)|@KLXL6~X>xMIkF0|7l(@y=Gj$RBUI$wkc|@c)$z@ zqv-B$(PT=QCV-N6Cl!=gz|2U*;5_5yb~DWz6o=`6x^AFyMV$!iZ9^>zO@jHDu-+;j zIH68Q{PBlpeDenQQLm8ehQIahgn#k=j9(PNcSqo-i+yCDH^SpGcpge#Q4W<7Y_tajW=t0&Yq1x(lcRwJL4^4r#)rV z@nGBfy&@^&O*(>7#TCFzHuQvtunmQNez5@SCb(9`DJhOAl0iLWr5b=xAKt|!NFu!_ zZgaodtOmSx7zn5YoEf-^;u~bV72rWDUi<9}(UO+o-X2w40IWpTZ&(!*yr(<8UFcD)r*c{l`idc zpCHvP{|r$^vo|;p5b*?2XTWa$8HgXxnF65Ntd*47OcA%4)x`yzh^@P;Q$NGMXV>k6ULci?~pf3&42d)G6-Cq-NS~LaWeOOe;KbY#b=8C`fLf5$ zKxYrLNM92Va?Q3Z7E=YlyoM4XcGXU><{EMvT95|fTNMMzg1*X5t;1V~)Y+C8PlL*m zJQs!BRufGMY)ifz{y`$@C5#krWq>OU4RZr)DST)eh4ejLG&vB8i*cM&X{=@lYL!M| z7;qOyuK^C-v)Ae{I*=TJSM(s-fv&+N-pf+^ov}O4w5Kiw4NRka&FS8|qJaTuSV^`v z-%$5DX&+o=02u8(TeW6)eD@?&4E*J93?d-|4S?BLw_YSn-oo0Xgl6^jf0jW6+y`@N z{dL;Y0d$ajQukci=br8G;{d~+0@dD%8C_esd)z>Hs5lrt$M6U0V8)WJtL$|H=EtFoHbtno z=PG1IkX=_bx$_;p`zh3_x4iAF!84j1MDI>zq7dpfmso(>$P z->ADxo|^PS@0N1ZZv=jG0Cg5y+l62Ic?4ji8(!bup#R1rjvo@fKW4n2Uhw1jY67Fo zSkjDzCe-zSPw!u`o-5>*P`83rfy4qv0YtIWip*?r=c1Ufn0EyX=mwP)*dDPQ-k{2c zk}~Ri#LM*+)4n0?ic%R97&BMw0CrRy4he7S5r6XO3S`Bt*jvcQiqG2xfAGx-e|}!^ zvhVom>;v-x{Hy0zJP6^Nl)w)YF4rAjN`Yj;uP%gdzk9&C7rg8%(j<6DKqkSbFRysF zSl9=a87~BEpFZJHXXvh=OT_~ivIuY_EXM`=Wd+UFBly$hfM2~{@yvppfX}<)kbsL4 zPBY=po?k&AJTdS#0}lXjvy?%eCS1!EQ%aaMc`Ze0Y<5l=i(k`r*+ImZa<(F4Q6ysQ zMNkXj0!68cJP{V=CRc8oV9nmorbv+1+p9|0JnHTz*7x(L}&H`F8Az_L71Nil{y4oO?WKA70mW_9B9Fux?p9h#!4`@<#prz3$ zid`*)$3P%qbIEWpWpZ~128yRj3V^FWkCn0$j($!TZxz^mK)u0yl$DGrO950`+_m|Y z?iZ9g*fIKI*_NX=&rC{~U>?2Bu=UhIc9oJ!-)fQ5apH+9;n5F2P=F-o!wo2_`OAnb z7h&>cTJme`n4dtdY+@helFwejtd#&z5vtCux_01_)L6&{bzNL^=S>ViIN^hUVyv#K4}$aS}4pnFuGf@W4_xkQPjd ze13|wq)5FspaLx(IO9TUl403b>^K)Pwnw6qt`76BC6n6ne%K_dnsn3)?Uk&00dO9jmW}Q4i|W zR;8)b$t3lZO>H)!0DxXSL9yf>47<43gSQ#Vdxps8OVJJ*4ZJrQCwqkN0CM7n;9CMh zKVjnpXO}!A#mIxXYA|G<{Ra6pONg&7IIQu4>mBPBzQg!X6R1fY0bw;T{7A~oAKlw zBCewnp!o#{>Q&om-7l~4b0I5?*XxhZt$_SKrLxE1a!mL4eyi|kd(kQl9Y@@b?%aFb zNLxijg|?t0y>}lD{=(>FVgH$dR%;<97&bFHRG|m!iMuYk_&9~A6~0Gm7sZs|>{*SA z$(^RTAHXsEk4c?6gwOP{dbwl2D8hLMa7ND71tB*wg{@r6L7m}DxdVc@3)6{^A*+88 zPce;tLmJEKLjg}6P*YrJh+8F$c8P#35C&#dhR_`vwk8(Zgwa@gf8h=vVO;nF>?#eR zSHrn9e78|)Gvso`f!D4%5ls1AwTdklS` z9t$34;AK&y-^%#e_rHVr^?+}-kKnrC7xjXdx+2Z*Ajqiuj)H``9e|CY+XV$1u2OKC zpRg!l#SI0!`&AWHE2s!gobhHN9O@BEeFLsH+zPPm8`4%mu#glc#-xPA8AX9q60Sc>B!} zU)Bxly5cwk-z)HKv2&}CBBhKgEAmW8FBON2SlZ`KpqfC!Sf+{vipyoiiR^Q~XvJA} z{Jp0c|DTr|ex<;-6R>7NnhC$U+OhNftaw*}LopxOqym}P*orh^qk;p?KxOL)V}aCy ztc+SKHg^WitdIiRc!MF;w&pt7>^UdG!qjC_5l#R$S(Q{kdf1SNAH`L1B;d(YF*i0( z;Nn1H6T&Krzb3_ZAS?|0HUS@C4C5J!RR|M1bEGEUlVDl2Gkrjh#kcM}8%jztuu{~1 zk9&X7C>pmibalBWOAjEKhBI<^+d_q66?zEnADO156+sM z9Z*JJ>l&X8nS7Chy%TjSwOb?9{E9LxK6UIY9~2vtU+ZUQT&pXb5O>h<`wfYk5%kg$ z1;aPy9)Hm;fek=d#e#PtF|;}wilrMzf7vic(2(ev{BzIRuVy;bP7oPDtSvx>+F%*s zGQn(SCL~W&-?rI)tdAV23&BiFRH01iU&3K=!hBP65nzfT3x ztqY%1Oetk-p#9H$gQ^?U|1P;l(LAII5pg!q!eoRhDvJH?;Ze#7c{yR3zrj)8;-HVn z`~dKwF>4kgBiL22OT}IbY83;9eh{jIOw|B`f>QmMmDE5msZWRMAkoiTrUa%)r8jSJ z@&PI=5w!r@UXeDt&ZgPEOw|OE36tiC18g}N97IMazLJ_&xaDJ^W-2lxfFJcnRAdu*(bybB1VnANnwa4kW|Mv z@g1`>gECk``lK3i(pWABj%W$}O=3^(`RiexqUv)VHS#NDCe&;#{>M=~$hA$j!pY^U zeXf;39j9);vEQOKf?H>Y;T375gA$p1G^kJ_8W=okUO@&SdxBQ$7YrGIgRS`JSx0tH zz=6C~Vpre^o1xR^Ceug*GH(EGkaThjY0)9>8UBhe#I$JhhtW{n7zZkbGHce6fS~SM zk_esg*U&tK<7Ndzry*MB5AFyJ>Rs!^V-=7AakT&jqAn@LAh2Vg`>@);-2-EyD=t2T zo;=D;8elR~YGt8~!_*!!qeGlIQ*1wbCtNG#y?cMsx!uqy(-_oa45GGj%sBA8yG47r z$LQ1Rj0<(Me_PTqhBeTT@I>8LLflSBbuVfphBo^z!Ta(E$~;lI{P~>WA`9xlcR=YQU)JloO$m3jSW`>LyVu3vkMv>h3$XCfDy}r2tW$i zsNPpTj4lct;-9()06i(R^8y|(4uqEiEwsi9Y-2mx62M$F(1Hgt9+q!0z29*C^FPJ& zgP?wY!gQLzd_T~|@u?mQE@{W(x4(-g`2(c-7mzQ1fs}8!DdD=mS~PYg6k*%!GDCMl z$_ZKpbq99cAW1Nj0TO-Q?13E#vxZ@^jw z>2$#PTJcw(t~gD=TLn%laP-6M&BWNs6;~p>n-jKO@nuqc_*C&gz;a}~R^Xrvu8LO$ z($fQ;_kz#Y8{Q`18%{Wo;6D{!fT-zMOV7`T1oo-u&2-wIfE%*%vyNR~dS z8#XPVy&^-AQo^D(C`ihH?vPqhh><+`auW+qsTDY7#l#tz%poPH05gPvvRewFR0UOI zMhm&WNP!0i4oof5|LEt=P0j095^yEpm#TOq;86*`4XaAH2(Woa>`b06$}xm^dh^{P z-4be7H6NldVXJ~2)MSoRYGqY^Z}vn>PsdE?OW{P_KTIAZUWIiwBjeiM`tO_}t?0G{`AR}czD8Yq zppKB9W=B(nrrxJlrH9fawYrUl<-|ZAoC#$=0X73@y2naA$u$Pa#uP~S8U6Vp zfJ<=)Oi>LGmRQ=WwooA%BG&SdLam+*SqH$2A#|(X0=pV4^0z`pEFR?_&qX~Gu#ZE@ zzUR&Ts8h9LfpxgO%J3fBJxGo1E(NLX$m9%7EmkzIJE#^9)EJhCEhZApV?#|7Z2gnr zCp52B?Xi+ndw5yv4e4M|ysyxLW_GAM{^D*@VAT%-uTMa2y1D}x6jLyN@`BOzut1+de?x=Nx)ZN2ta1TUPTs8`?Hb^d;x3w0$!!G$fpZu&Q zqLwz=lIqDo5!5P;_DzwKV4DhP0iBF%%I86x|zhG z%N|;7g%9tMXxV37Pc7}vv<5aCLpA^?7U=`!7-~a6@&bF3egL!gi*Xww^)5KFC6emk zdkZtCmx_*p#5Sr9{-a1v?TiQC`H)67tDV@*+eb~Z*XkyQXxN^fuku1)vv|Y*ry)f+B$qKL5Mgu}ihGCSAPM)3jzn;P zvb(-a8rBFyj+RrgIwpw@Tlcp0gANkWq32Zljpt5D;RnD$PB=aT`pXM`I9%|$UvT>A zTbxb@D^aKDOtj}eOmFb`@Kc=VdmN9y3oR4gl!ABk1v?Zs5*+i4*Yk$ga>KO>HZK;| znviqGb$bQxj7k-?R!P6|v@R2Wt8UV&Y36vey|Xi3-)g1T4mEa0R-TCm;(#{|r)NmHi9 zq>;b6t@s;H56~;)rEd6K>@$1ER>3f5!f67ym`qnRp(H+V zU}tArO(ru)#=Dog0jwy94n;-yk*F)HSh|Wr2=^5Z9>+hXSQ_J_t&T5%oKRo(c_du- z%KJSkMVDglU_zz<6n)mMG2F(jk?!`KZPZC@NxG?71$rQ(5JoE#l&qE}NW6@$B#fXL z1NZ*9g!fW`R0RhlOnGvvkCn!2-F)tuEoC$ey-_hVS_YzIPDa0B9pqib0zXE~EQmmvYSj!TAngl^svwy$;fQIQvCxdu!vjv!1Ey*5%}(#l z5-BJm*hNsJqSS&?6jDw8D$Y7q5r~L+2*s8XB2GA{dCeo-&{({DuS)a$3X>P>orNpr zwrx|SR6#d^ECgAAv;#E}Die@W^DtXtZE9ARSYlgB(T1|!@OpX1^Ot9wzr13-6qHc? zDq%F4h(w<-Lxcm{_cX%r3C6501WxRD1x@B2=_tnN8nYXjC9Q=(yR9Tr^ha-@O0O8{ zTM!xM?rup^pM#0etwK6vHiRls*)f$97}{sz+7kMuCBe7k(ILFAdl0GN431@ZoUSBa&;Ehu$1>Z`yS zL|5P-lW5v=z{QarOmcv~)_K^qv^^QsFNST)b{}KkQ#-r&KnE#Y9HP|R=RIU)$jP~* z4DUkvsZ09gD}HlK#xx+98bhQ5`0FQbPa+KfK!bFTn!ywpMY26xjP6orL#rrWq8l22 z@ryk9V1s*Sr88rCPa?L|$R1MC7{ch1V{PA;jFQ5;&z$ZaSE+A5lzsz(bkE@6<5NWF z2(^rbyO5V&IB^#mbT7pWz0sJ+Nq4k6hQ!VYItUil4mxfVR=Lz;Cd_trteSzm&9xQZ=`rFQWueTVV%)Re*TdK#OrEUj_;8 z_jdk0NguQzg3IT>LVCGE4-=R(%D&=qeMZ@L91aT(hZ%`7G6N6O8@zk?Jsh5X52Po^ zO>lkw06olj{QetU&#$1{8M-qr#Uw!@K;5l=A}NrPAhF;=JF*fM_auo3QWhMS1%(UF zw-rY{;CP%sVxcrTDau|@m90vE30Vn;+k(dhcwH1fyjHwyf^Qe#8xW2l98{5+K~uu( zdB>6x-a?^S@TF{cmlLoOK9-8p5qQ5U-egOO`+i>V!w)ZbJSo1N7~iCfWvy6>U@n9! z1j{!w^ipu#G7gUq!0ifsAV?x?YXQ$d$_qpiu1RpLgu`Yu6zz&H3Ajy)ec$j$rziZ& zFVFZz-Eqo5t%P&{CRdf|k)dfqy%o#?954YQHk|E(nN7O6MSqx7Fxv+CcH1!#gHi%B zd9=TvvLK69MyLV+l|X90w^EU(>{1_stOc@Hn?3!WQ#^=f@&)J7!C`nzW(p~z7p{Bl z0SUlvxcgF!ZFxh$8zt1L_~gJb&X^+hYvSk%G*4s1tTPNO-WXW3`xC>f2EsuNAaO!p zQUORz<~0j#fQQzI*D6SOqtP#!*>CIp3f?{ld{&fyz-inE^Y$DKyzd*M3@e{ z=bc&(flY6fZJ{6(S<_wd5rL8HK&2%{dq7NFhwCsqw3RPmNV2r?pkyz;w>`Y&#CU*g zfXk$c48_ERB?C)Nm{Z2Y1olojL@f`*y@b;G+G5!5($FYGiQhW_q|kP^L}@>O)C(;A z?x`|iAZuvtm~rqpHvie+oe89wtdg)G{WHY0U* zQ*aXSG9k~3k_9yZH92b@N<(5Wk3Gr$z_kMFj_rEI`TT;*^E1}#in3SKYK*cD*nt{2 z^RGBkM~PiJ3TF%1M_Ijh`#3KehFEIWsfwtTQX0`kSC3I+DY;c?_4AEUn<9;dOpX9* zI!ur{WOXL7ltODYT9$%=p-a>7U-?Bcyo{teElwk{Dm;6&t1q%X4rDu$I zdA+vbomd^@F_LoIl0_<2lD_c?rZ2X64QRD-alCj8+okp^001}O*q%%Dp3NJBX$BgU z2k=TS!d5fpz()w*JGOc!)bjjrHDB3jHeU;_jcd$wX-wUYlLDMb@S!wF|i? zC}g+E*plW|8+B+M3^E2LD7;~|yKPdxIOvG@4yd-osj&v5BdT^mq@gD;B%$ik7HS6N zd+^rX2VE9QcVHsRo-TQ&{hB7RZ{dV1;zS!wY5 zX=AE+F8Z`#0FV1``M0cO@*Nh_C(l1V0|5=Ve8@*$6d%cC;e>Yxl(L!wo z-(q*O4LydD>dDjsQSJh9T5_uUptuZTm6ku;rNd3iU^mJbyn6Rv04OvsUf;kDZ)1os z?~zN~J*s+t3B5b#hPB4{pm#Z0qwGq1_!7o&QViKN!%LL-{0CN%0sw2jcy33*<>w1d zKlwZOc`4Yh{}NX`qt;hkpBHSO4>;rpJRTlU_=Zm({{$ufYsm5qsw~i*P?rhYYk^*X zePwKyg0dHv)>QCjL(xpYyx#EUX+q|N+qGaK0!;w8;CLWp6x4Oai6$&$ol#20D(Z9q z(hecQhJu6%X-dY{GeJafSvNc_gr|vdsDfF5<3^Y(Asr^vbHRMDlJPYYE{oz)Dt>Z0 zpsqX4w;gE)Zc6z1+c)_0_ZRFCOcl_Zf~SJV!g$;g>TAX8iI6ITZ#x(}wkkLt2x$h^ zYr$ST0Rx2ne8GHVV+|@WUj$MJ4^K91{p!5ovOa^sjUijIV#XjB78(W_}VKl47lauzy{Fn){*9|Gh^_81EGcrHegHt%64V9Cif!^c+3p-hw z;zZ`>+u0bZ)i0hi8Ts3pR7h{i8+%3uE!ZFW9gImJAOFQ7w4s{8ywv<;I>?N_(OJc`W+%r=HgXG@H zAu}Or8hq@mbl-Uhf4r={E+fH?!^fQPxEwLf89Xs^N=Ru2r)(@C&sMSu@06vkI%!mV zld06ME5RUou##v1Yv z&^N%SL}o{c)&Oyb&?b2RRRgkKFd!Q6=oSRxBSnmSHe4hXql-6p3XT)HKv z^EX5SNQMrxs(qFrw zaO80kjs#N;52E-1<*~VBvC>g5FarMQ$mb@4DODM%d0UD$0V6O+#c+8K> z&V~rfq0%A`adsFgCeXDP4a{=${Fx7u8W=VyDGdy0n2G(wk3U0S=SFx@$Tp=NHywD5 z3xfy~Ft)WPmBxQHPpJ;e0(M`n%j1S)?VeUw3V>W?T8N@X!&BpWtV0iGcmPg^clg=iEiV81J$`Zhfcb60lm+Yh zf-ma}K3*2ArI>8+D9G}N1>Yc*2j~U3zI?`|tavFKu4}Ie zFaZyXy^_;IMiPRq701jtGDGVPm+fi{1qdt~Pzuttfc65?g1t_tY+)sJPmrQ`$b>ga zc#?#P7#RiA4y)Aj==P0!diA5RiQJmPFDLcS4$Qx04`M_w-pbsifNvaP6<+W>`+hwo|tgk zY^c6y!OtHa@#9Ou3j}pne6v{j_k#j;GqXMuK^DeUHta-L#C)Jt%tuK12wg3iunJ?> z3axe=CeBCzimo^$;2kSItcsfepY{M$HgHanu*^Ptkp0|BYJ0F^EK~L>rHQ+JBEvvv zMIVZ@pE^Yhm`DQ7$$-}z0p9r>d_`|!OMYFhu)vp_O9)v4oDeEmdg!RB3^S45>oL{6a}W%so*S~pxIDj=uc$tFB2h)0WOV@7>@FD1BkmS zc9&RfM7XNr0IMv?ggc)dVyi9&EZODqNpYtdiQSaAG*crz^eY8RTqny=qcOpNp#g8V zNeG#z5*~;HtKYCR*bdx6Ae5!*KMl5u(db=A)8x>(AzOlx|CDWJmp4T11^X$W)CWCTZ3 zKaF!uS5A@Fb~HKjs6=e?Zy87{?kBs?p>e$$n=>$`ozmBU(^$ro?6XmEg&I2%=;1ZQ zktxEyhjoBJet`}Umi>T+ff;K4zORY%exc{K;}}^GwEBuBH|>Rv zh?t;2E8;gw#u#TlJa43>v@MT7oWV1>b<|YEi5ctN6s8H^&E9w3ja%tfA>jZxe1$sJ z7tnn{0fy4{7P>>j=fhrOa@V1VUM%A8D>U7e`f))Vz9Z`Tai*~r(v_4ZQ_<$K4Js~X# zBQ<0A{Lv>J>SjX!D!LStS{1~|)=OIggmlXt-Ggy}+7(CdA`C)&8uHOD8z8-RtacY- z_%+1KTwTH!67r@18G4EOkpu-$NN`?1;w?Sl-S#~`u73rY1o^98v}`@VsqUX~FF(cub0S1Uy~@4+Y@N*i@m3 zkq#43E2vof|Fi;6neppYpofb0=L>%4c!I1qWC8x{`Ha^L{3H_|Gq4aaA1363f+bJTZg>FNtuy!a55RV;4p~7XzbOaNTyy6*wIytPteaiiH*P43r7Dlodx1 zK2-w)S5d40zF3JHrV3mXxUnFsVwnIzb?{=LLs|u8+krfRSaI8TA5a;k?w-0!U`aT! z;)05e%}?`j126-RlXXtQL!qh}22uSIG>J(t=fs#i3`V@0a{@5?ptcb(b7#SJPYtC6 z9FqO)mJ}BvoCx>{ES%;C??6n@2C&%wtTu0+4PUD&R`1dy2eSz#HRR|9D1CR65?VPm zc{zN5flzb@+cv{IsRW=3-3@qgEw+?H18R%=WQq?s6~LB&$$O472nR7>WnM^Q9ybQI z=7n|!%YBjU_9r@kAb6r|hL<~3A`h%1-aIe^_@ zzR3;RO4;K%?^I+1yE%G(+G~P?Zymh$p@#CH7#XGtcEC^_`}l0wg5Hu)>mY3Q47Ejt z>d>}I!(F8Lu5hQq;sG>Q^uU>jybq?s`Z)(RSdW#v>--hp@y@DvJI(m^^oX}lZ}9l$ z5zFHdoM))_(%F#hx<=H&kU2~ap1N-O`P_2@eAtg{0npy*`5_=pwffNQy@FIA*iccd z9A0-6_8vm00iOz_jer|rTGfEyO+eQjv?t`_0n=$gJ}yYd2hef^&9gX9lPvMDj{nEbMoLwBNmu?upE)LboWRf4Wf&DK(2_sMfJcN z26n-`CF~W*Wk)UzKifR z0T2589#`MDRSjUa-<>T}_Bsr0vepPDF^TGs9NB^-{6p2jv-XvQwDlPJ2^Wk@GmVbP zh%|z}@v%p#o8J9w6m5pKnZqMSqXC#Yv(gas7>t84Q>H@!r9n=qo%akXkaS2#<$+`C zOyiKx+BO%FUKUco=Alz+emfmNgtiRoYE_Dn; zK!5|NDC_L?5jv!8ic{<9D?i^bXn3#-xP$gc)9U!1nw~v62QfTXueeL?riAbv-X)vH z4J-m?{8Jb@E-A#=bT7cxJNXN`j{olFILaReZwPd_5Ytz{>#HO=@|YqT7dV3tXJBf> z1U`N{{d^gbyxr8p&vGC3B<;kx&*!cFHfpPni4%avO+WR)s}3xF=ONksBh*qF?}Knc zI_=jfPMD?%EE(&*t~r5H!c7EcsmRP0Pd_utL`aEHw+!J0>$+i5fMzp2$+conipPhHt0?|> zyeUqT4gv+hqri%J>!2Gn} z)5{A^%M5uH933GXazZ^sL4-X$DnTMTROwiVsY7Y-Sh}dI3{SjXJ>4DcBrjt(CRAM- z<{;89o3YYe#J2cwiECwGQ}Y)R8RHlg1}luEGxn2kMI>x$3pAN95J$s25&c|u^;ynN zg&)r3z1N8^J=_MQZU&znWQ8yN8P7Gl=Ea;D-suG>jR==dG5)KHfsKSIynkRy0r;vRPl8 z#&@ILR+6C&9IM2Dq_QeZ{SCVN0Q$|8Y z=4?HL4wS5ium|MXag^Gfk;Xw)4SEO&RlL3i0xk+JgtY+kPME6G=%pah!R{&WU>i|0 z1MUjF?Wng4&bL>*Ud}jQR_w*RgrYqVtMAhN^@$|_hmEv~g{>tuZzn_yIN4gl$itKx zyUE1E`P372O(`dS@8_lgkC_{g7D_w38dt56snlZT7?p#uAo$8dXvBlw^`iv|LSnO2 zb$M`$n(=d|lT_$)a44q;5O#^IGiU7;F%5w>9)izjRkbdH;m9i z%@EDr@xoou*Zq8;p`HS*__hHv?+#-OrS;l zxC}8AW5^7eM!XN=15G^)+#$$or+rI{^dJPVOLY51og1+07sxS~y8FO}^dffILG%8Z zM57k~d-|H9%O1mo8(uq&bhaVRTBXAm?Vv^n$xp-Sbni0jU4bL(<=`pG-ZA*|h+A+9 zn*XmqmvUzh;~1bpE~+i%6L;Vo6#atSZ#F&RcaW;~ZEY_&P0Daz9V#epR5u&Yg7l?0GmhVhczicH%BqYD$G} z)DDSH>l)Mn@;AA+wt5Q@8vKyj*vOWGd$+3j>T_{3dB}xA)*A(B>QU&&=?&gJ{tgc5 zEz(&~US6?gMSlD(VEYl}xFXLJ4*P^h-66DN&l5geH@sY}uV|_Xq&JH(Uj%oTF)!&Ou1;`nK<9!(V!V*zb|mbuRE&u-K3rE+0M{(| zRk`7J(j&f~Cw#0cmWgpLiccHxv>8L5_7!CiX zF3G|ivf@^Xg;XqzE7=V@C1YVu#|b~J3IFPH15Y-CU7+|_6eqSW!PRC5d?^ar6tfbR zYHZa3z!QL{ETA38)u^+A9XVM~C6OROJRHUtt_?QJtt;@k8pC%YAd7{hBp7qV3Y^%$ z7bRn`n5^@SJ%KUe+taWCsjyC~H_1Lbh+C_bm zJL6ZCBES`di4Cwrf!XsF#M!`Affd$qS=7RDr1e0OCkl2DnmkpO+3N+U&mJ;#9#+77 zn7C&JW9GWMSH`U6OLcYy7mKrh+Gn=qy73)c6irhRhIz1HuN{V5rNz4$7fb zAB^L^9ZAzxw_%<_)*eJSVYZFY5`iqfC6NlH>fv(XWi0MpB$oz~FD|n&a+J(JP8Kqghzz8~qPmR> zjIpto2clyP)DPcq9M2GeR>D*(j(dibsr3h1GIm0ai%+#pi>^E5ddB&3#+TP;Jik8U zwp~z)v}%n;Tnu&_Rz(F{rV!ctwRBYj%R4)@^o+$r&(Mq zk{Xf@Rx$j%ZhQ4`mkv5eze++4CZ{od+M{KmE#lUajR zHw9)L=r*K12F*0{GVX@P?$g3om&7iOkno1N+_Gt+hrTz8P8Hv>M0iZ}8m3V^JY1Zk z^gA}DI^am3)APdjiI+Sv2-3jsj|IWTZzX z117329W|$V4f;QTrHScxsGPOHRd|Li0`u6iZ7CmY1k|7@4<9z3=g=CdCWoBEvj# z8w?O`J`1;QLb8s?u_3Bf|CvE{FBk)9Z1AlEK&#sO7UTO%gPbG$dPIW&&;K%Um-lkB zn>Z5{lDxavI0Jf-wn#(LY0DLmp6DKjhQwtF!Xu#M}eS9 zK^5~EQ&sD@F92->z8UbtCeSOOR|TB~a;dW>=Xpy4vVYVcWiov5IU+ZTIxt zLRQ4FQ$O&FZ#PmQP-UIg3zzL$+0AeYO0`US_ilc zbFsKwRqwzp-9_VRv!>CVI!l|s(5ffy(g2&5K-~`+=S=vBX?RSPup4=u4Rt$@s>>BP zUQKG}eNGWpB4XQ0_t>$QH*@m}O0#YPQ7+0Yt~D+!tXA7gO0MCL6wIE|6BnfD1%U%T zq8=JUF6qP|LyZA4!e`pHPsyHhWEHhb5k~g1H2}0!No^lCJa}TvHEf>3FyIa_JyL+8 zP?NQTfV-*(>fMGhc1mn(bSyOQ@=-gAG6n(eaMIq-^`rl>y_cpb@8$7uFCKZ(eDmP7 zupWQ?p+OhX5CC;4Xr7XpmzDBSa1O>R0KXJ@8X3@I`g#|LZ=*STqwwg@uF57Rft? zx_teAI`}0AUt-&GrY1$b^Kqgxvk~6Zq{`GoT;c*746b;jMXM2s=O0sa<9N`1d80cf zIDC-QP!-Yr!P+Z8#sgS9^o`ompvjD=8_rwu>K%K1w=(nBT!vLz4H~=qenUEsWNe;X(M7V?Wf!|nA8o^P-C@xu@Je0{-1&(I^`z%!I@pmfDy z$tceccs}otZ3R$Kbhk~eX5?+hyaI=8TEks|wHD}Z=b~r@l3>rkD*;l(m_|`78Tj^e zz^9iBZnIGwHvtZ;c&&gO8ATKmD=zzvWzRTi#-a*g0nN7Hn_Nn?tDwvZ906uQksUi# z%n#NLN1NcVDe9cCi=ym`heTM4LMOr(0&cwH*IUK!Kfb}g`f|n>-SKI!c${Z^d98MD zcmVbdI7r2LQ@jXaIWjJ{f}bYf+tuiq0ze-#F1HFgXO-`89SfuJr z>mnJtICCQks=zy9>{UR?q@bk`9@v0iR-?uy@>D=p*?@lXzix@@t>=F5$&lM^QqFx&41hB=v`qwiIdn+H^bP9 z6((1`dhi!DuuFrlS%*Q;KK}^3(^iRO+x6&S%noXb_Mxo~o;i?#)eW6(BzO=I!G5Xv zkm6ojBd|qXZj1hTS5Q^g7JubrROP+ z5+(F%eQ2%oQu{m~&lf8GJfJ%kBjwsX!N-_jNyMRy^%j!#A9~N_xK}snqn%I2iU^bm zr3h*zvt3|;l-a6FSdrK&Uzi0c0SN`nW#|u%Z%pszf?*hJ6=QMV@4hp;CyMS?94{3j z1t=A?nQu_{0=g>r2FR^Kt~+Gip%;dp1-KIG8Ng~lvSuK^ouG#VI%ecU0?iX>PS9mC zxxpg#%NaJMuvHX9m6C;{z`;Qr?FmH5?NeSsLFNtSw)7rVMs1~YmkmP7EzvW24vPwQ z2yPG*(iR3|9f|}Jlh-CFW+cqWmP--`ugmh+eZ!Y^$A{Y)A8yZhEf)*(@_9Ab!m(f6 zf{Sc+s;*S9U(s3Eu@(PbE9(gh4f(jiCXxOD5Vp&Y_*M!;w{j;;d+p}|TXqDg`s=+U&n?nrx|A)#r- z*I)Ysot;pxf?!Y&0O1~7!k+v&b`w&|DH|CaYQQ66Y3VoqKZdxFF>FMdw4{}u>*#R| zKc%!AVXp><%UNxccZa`*z?CS|Y_$U1S)#^X4x6};$qp#5U(gjM2=XADu09#1gxtLZ z4IB;BVgOI>p)+vVH1mB}thyAmg{KmIMXW^$JwqrK4_~u`+W#(TlQ3yZC+(?J95UPR z!g^(eaxkm+z;R@2(M;s%47W2{5f>g^T#-;~@74VX=wAkbTjwD{-b8o2d6Q>GN^2|$ zdI__4J^4eotuPPldQ0q;e!S{eatI8S9XcE%jad(%_L~cmEhki&Ur(P5`dEq8=E>Me$h_ue)N( zz_V8T&4&Zd`;O1P_}eN$lH&11*mvN=W??0n3U~+J&en@JF|b#~ep~UF2&onj2#aLs z9jXvOuB;LptmWP?U(e2d!zlu^_G+}0K4y?!GSEB!Ub0#V}LOctQiZWaD_W};RG zUIe(Y-TM>uhj2p8004jhNklPu@z?{YR@B=x{8 zziovONyL}f&DP>Y!iw@au?JS%!=XOCzwrH{Q|8(M2>4Ic(3(B*VI zNLAfY(0>PzRX|eOy`~gFT`Q0hQqCwT+54dtlL%B4QvxVcU+lG>k$e|6*L#Pv=U&LL ztaM9@SeQ$#u5aG~-3YQWWK-x3&})HQE9#{}ZUyyLA(x7JRp3I<-RemUXA0^8kfR_S z1UeIBV#~gnV7)E5+6AG+31T%A_W4$;8R`%Yq|O&BgJ`n3of23r;E)?*tWftA4ta%l z_M#qavf}f0!-sOlr*g&1e#0si zb&#m)@R}m8f`o{74Gdj+<4vJ4J34gAIf5p3|E9)gApJEHw?QLLlzZAewc_9I ziIYJ(sqJ&?iAw`h#odPn;>KB#OJriZ8AA)Pbsp(>Fa-ci)OwfD7)TxZ|9rFL2Rq$K zYt=6#3>SY9*+36AsJomIW+5{fLE zZPC$Iynf7dL1^<9Mn;w@fYOuyn(tIwAVOp9JcYLTccXMRF2tm5(WK4aDBX)1KkE|F z9{xpOnX%LZc-`>2ov~$r5+mtu*Q=Clme2~S0xAWEL=gRg4=?ZWa{Gc0+ZTK(D_(A| zctwTi5%YEctqEm+z`7Oe+iusr`G&(2<6BKAE3j2X62^>#w}*spli-0WC}q6JjO!-g zt)lFLQWP}-dnQP-LHcR8^vMm1M1s>PgIB`mtKiCv^RP*@Ni5r7flCAvV-+B+!1SWn%hf>8gLNJ)0CH9wH(;uY?dO4{Y(HAlWs0X-a-N>dv?LB_PpevJHS$0(kdeVs`)yQL@;ZA zPbUI)2Y7c4J^p>&9JHrMcy-VjV3x^VqYMBl?!}_oe3g65LlJu8zjg(7vE{+|+$r)H zv}Xq-G9b9a*#B{^34qvqmulZ(9hf~Dq@$y6Ndah$u44CsM!B~4(L#I{bk$TyTr1hK zqKbMG6*VG(g@z?wPe%>8awdC?kcy-`QmsHO(0xPI0$wJd9#A)v!n1Br%HSzOvc=MJ zf>%6Dp4{jukscaHO)~1Kq^Jn(w5kGihg5~^1yVNDt)gxfvR0IvKyDl4rl?mzy>6&y z`{!~?sJ9)m!+dmX$FmSa4g@|5^q`n#Ky!95=w+ojjK!|XBIj9YN5$qd3-?eI4@^@} zrza(3GRY`W>VC9AF{C;!82r0!_fqdBt#SM2CsYJSu=cQ+0E`?(ldfg{jly~NvT>tr$sdRA6#(dciG(gl zq*iCq6b;S5+?fe#YCgHMUd74wHR!V6k^|EKL8 z1=wZkWwRit7Zg#AJlNF0K~I1iQW4ts7(lOkPL(^e)wnk14s>{sONIxp1;QAVX%dqL zMyLUg28#XYlLmy)*t$rvz4JwqdeBM_vx)aF!)qAJ-R~t;_HWWWjcm0N5r}ek;X&V+ z;@;EIE-0!4NJP6ZHfDSX>luyD@Wn(sV;f-a5ePagae`@$)Y)zuv`gN&Fwo`~ybqmG z<&MJ9zgxRLbgwLVT3>`pY3K$NKrNWhSEOIQ;_}NM@X9O7Q$l`J&{A8V&ml1~c5qVY zVaBBh_O0T4KI6;Fir1B~5^#e_D`{igr~(ItkRXX*ngGo^un10X3Ew>@yqpXkK9YA$&1pzPmkdJh98pR(@Q~C z#oGy3m~iBbT?F6>=OV~^L9P|p6f$LGGTD(bp)7tw%`;xFJC2JjsCKcG#Zn6>C6t>< z6yFwLnI_CP#at@3MEIgR-T-(`0x1Q5^Wlj9@^Zx&QoMV}5GX$F6`UByQF{}XIlcn{&Rp4iSp8X(-LZ*_)E(44n!{U!$yk}2bbs#Pmm5_#()&vAi z+9Kq4wa_BZhO&-owK|5Ing?+8xq@Ayy8D^Aku5H^05)VHE}@Dkey*?Hdpxm%tMw_0 zvsD}QJI&-mobX9z9_pnuJX3=j#F1O7#xhQ7-G?(PHXhc;p@i_?cUA0O0!@s@BBVif zFTNZr5)wHBiOGR=@wIXc$2}F6oT2I0>zH%W5Op4D?;(|wcAwCewj2y3aks*c0t*aP z8a2{QDRKw;s3fF~xflaT$O8$Z4xx}UN>Sxg(G)#ByP{i(lKW~WHfDUOCYPS-4qh)% z&d_;=Ogn@KvR4#wYl&1O7NmJb(a8W&NzlB2QUnEBYAq;Y z*RQ&5D4U>c74^2FtOfNZsJCK(@KR7N1?8%ctD^4IytlGYOCpz~&<8cq`ux*|=Dt%TQ zy{u@wWO+uC1y_%4Vh-rvBsiD9^3xHzLXq*WazQs z_;3QWg>ON%jn=)g!og@O^wHi=IItNpQ@0*c+)G#at1tCFeK7ikcu43Rw-sH!*-}Bj z3YG~?OP39f+-47oA*YdqA_CvG2*D1@U5y2XGE5y{uinE1x(ARLUU`JE=v`S}hn?y` zhQ1b^dNLJ~J0Ti9fYRM>tr{YdJEIR# z`uB6kD0cZlV?T{b>`Y`kGP#8k&=5p{F)keR)sjK_b+4tWHaFt1gBpU6w8znCQ+dg7 zK8-Fv8Ngxm`V7F7`cz>OVHwit#^d$AG@gbi=WZkIdVLvm^V}F)?d+oxN)p_T8xC)F zJiecR&u4t7AMwl;D^+ZIL&_5#mLu{~AY5%yUm5krxNaL>w-xKYK+*|&6{Kwi_6hrW z$7Q}@J}Dk28~(K@O0Af);+vBJp3mzBN(@RFMP@vI5qx~UV6O?O5*{+)VNL)m_S1w) z1+^4BY=pz=-}6+#4~&g~OD!lVk$<81m!=#&okFrN@o%aw&K^0XhMfWFE?&O&RZ{ z;M1;HvfXnIP~29;`;e7@#&ZU z0xw1JHd$2p;^o|%-zN(b{<;+W;qin=N%*I)SCmY6Ou$qWnh1v(IA!zI9jbzNK&ng6 zCVQN`SEwlVM8Lt$h)M0wi3r6vsv0Sxek9I`u!-WmC~EQN@t_9|MS(B63lv*c?3G$y zU}Au(Jr^Q<&;2PiBKv*&oEbQ&i#_;`#ECku$yYXn_XdSq&VOW0ab;m@+QBwP{eTt%NdJp_r|fyeiJEjw(qnK z)~L2b)+n)eA0u@oh$$AeNw*@fB`$m6vr8T@S<+y4^8X&vSg+Z%>m2t$>qLF#VQ1FV zRbA}BGJH>USfVoxa^G>Gthi(O3Wky*KMpLYM!V#12-)cw4byMhR(x$@=$%YEhm@X#y`3C=+x^&^ZCiZ1oOP_Af>{Fe1-R z0C`xRBDxM#Dx?;avSTkBq*Uzdin48}w+;2OV_SFBt3a=ca;?~}CK)Zee|L!?lgaKi z6O>I6p$-bClVCbj)X99lm51aWPrX)Em(f}~WpzlXQXpELNbpWQOdj~iLr5Xoe5TD> zaW@`%%>!Efl8Qiu8$-BPu?iFsY+A6Z$ymix+nMb;cSs4xlyT&Y6E9dOc~w`S4#ie) zxRe*1_ZM7lXI!@pd#$|}7{$ZiFi0{7p%W1j5wa#^;$gYq^=&N&CD?d%UuyMve293D zg?%J%x)fg3{!ZJWk2`Kp>1yYK-lzUI29xN1IZb*u2lFr$HtEO^k|+Tz-FGYKhThf( z5F>9StMZ`l`pTYVEUgm`1I8tn28UWp{C(v3pe=sdC8Hi$93eF9sd&j{hN&fujr}+g z3gZ$`?T=+c@K8+w0sC;sEnYqt#0bRby@)(SWXG``#q_N`!0F&%Be)$TI*gUw>)49y zLG6GErb9cxG zA2B{hY5kDuLtPwm(jxY`gV>g$>P}rET&E2B$y+?;Z*hA5IntLu!*zd;59bS>QK1<) zQAS3A@(M~5_y*K7aJ%hzU3YBmiPpL!kzmUkm@4u`@yJ$8p0ho7EsD$po(qmg;I;!R z1Rt4DUn`zpE2<O8H~K>1u4+X}4pk{A|H16xD zyj0-q_u9j(__S{LHqA)FxQQZXlS00mO)kiVa7e(cwsR)|Zq=lL3xJ10;0oMkL1hI` zKrVu*n!=&v-o2NFFp~|qH&4_1P~AVKfMh!cOtu-fWn`-#h?#=l;QGP%DZrJ``-Kc=cYvre5l!uHNmfGk&Ihdyddcz<5)_=AL6%+_5|6!8m#8ug z%V(ce>JU`ZEg5lKXzS$zQ;Wgx>CM`fw{fG9kO>dIZ`Mdn)M53jjWK9Ll$DUB zBCR*1=>>XL)O~?6Sr6XB0r@y#Ivy|`CrpP4)3PAVb7Kf2BLQrn+ETzHh@&+3gDRs6 zu#2Eb!CE$y?S{Gu%C%s>Z7A1*a;+%03cU#So5}nIWI%8sh)eyE)qo%=BoTxOI0$gu zQKr%WVNDgng47NgG2fdc4}q#yQt#4p74-^=j7$@h6BrpR(J$y$6N-EMNWF#R*YB6o zze@{}5|kxoF^QTS)q`VnW&3GrD88DZu<*v z>la*ZuUOa3*{?2n>`RIv>%#9P2^ljcOq`J@AyI_sco!nEpD$f`CLSgy0Mb zw~+5~t| z9-zb2!ai)pp^c&*h#EU-TCR@V@rI4T8V_r_2Wsu-sGHF-uxmYHcjzN(^${47QF~y@ zS3foKxfnb00{le>B9k2zLgL#JUqFm?4FhWn{HEL%cObM&PFwu~hBcJ}m1SUrJA9&l^G82wkFH zqY;ZFMfiD}>A)V>)eX>|Fw0;ZM>^ zNY@H^skq$~s}c$klr~t;RmGMHQWDISP+l_XwW2&I(qx6=hiV}R%LzE{KwT4lxE8z? zK~4!L&X_9Ulnb&F^dd+sz_R0!fPDu}DOoVgCb(T0TM@He8Lwr-n+14OAn!Ji7go%fQBZNd-H>*{HydMi z0C6Njs)_?EX0dt#?20KH!Xa33d?DZ?3aBc6HWU7=2#OG<$)t|go$)SP`l>2$^^GiN zvqc!6o7IfSB$X(7;9RPt8 z)q&~WDiR2VJ*>uUSO;|f-sV@1;*6JLcuW0cZL(4hKZGkJj4|4zsV%g5U;+z5Jw|uiejQU&RgGy1CXW0yewB{hXPxfD4EPfgRHhyb zQz+O?9eM~y&}WN{_8^_m=u1=w_97kJ(wN=gpkpFnV(X85a!{Dndo3MoliFe>e$Q$W z+f;2OE9-`mZcq@?F(J=K1cp(o-r@;00{F?8>MZS3x}5N34IIT=iM$9TiLPi z8`iy`Yz1|#DC>^>wxiq%$`$r!d$nV6v04O844nXEUrr_q{IW_#%VfYzsIvt@l~hrZ zxKy_yp;%3q_JzNy0W=GFQHUm}%z!9ZJtvnl82L9UyyPx!&;f%=Q%sV2?Ty;<&k{XN zGP(;K5DIow?B2^4%kr#*83_-GaheFrlyJxs=A41-3~jcpmTJK+8}@y}^}6A5-BI@4 zEiSeBRdpCCknC7a045KvnK5COgq$)GnM^pk7o%>2g+bhL0!b|SrRkT#GNayYu3BB< z>`Ca_>uGe5k+uYO^d9C&njgo-un@IsF`u(yF2N9-S;L+qBLRYrHMGx>>dFBc?h#Gs zMV_1*($q!)v_a3a6$mtj`Z!B0zR=G^Lzf?Vr;q`{*u)!1eQi^$Cv*Q}zgYJ!^FBiK1=17Me{#*^?^VjZBaxBLu< zdl;k#DA-DcBOpY31w|LjI`Ct6W~!AQiv#b*D*0s7y!F$N)Icd}@IEKfU05?qr+ns}gQR>;jb#%iIsBq|o7yt|Iff)JE zk#=?q)Q!F}Fk7I0P{$`CO}cbixBUNHoTtpRNXzM$8F)Rrx?+EFV_b4k%mEeEXbqFvtXhs_nbdI6stnxKc~v z7)9gVdr5^cT^GE&9`NpqV*mAfeB8d^%l-l9X*ZcnEx2tJw@r|dfQ3MF#SDgC75hez z!(xTIw;enWg6yi;R8e#@577)fE@W8;*^d1Jg=FAB6E0`L4J(!`ATF4aK)Ir>2k=Hn zD`CFvm`)kD$-qxh#qww|9r*$*6JyOcTtEF9htm^&|L^`I{HOn?|2_7TwU5i$ZgO=Y z6zfI6VYSbVPfvLFcmG`+zW;47C%pZGe}wn{@?V%Is48y6&`g*Qgl8puK5v+(gqjHT z>3h8U!+(H$JmKSC|1s)f2k&7c9528z32qDF+XupnDl}F6{cj%ePkwyHbjYal=EcyMico>0rfR)|n z?C4)ru{%q1_SgDY3Ezl$DL)ACtkxAdc}U78inD`(EZXi4@atO0|4@y|Y4(n4_XhUi zWp&TsMh?>ad$w>EyG|F6pl4@lvwLewOZ+qm?E>>0P81%yNRRC%g6!R@yybs%Ys zVI>dki2#05LbltNp5jvCumv^ew)PjGBik@ct?Ke(xP&+0IH4Q9w^iM7Tj@5cLkFawmg#@rYZ^ZZ;C=5w&*zW^uYi95=Aw4bNHwUEC z1EwWoo)dV=<|X9GdfG?~%~N&NltNJ~ZCV*jGYX3(9TBepA$q zyeyp|OQigWwHW0D$_h;h%wn}a96@z{53(9T2onkyRNn6vrqG_?9oj{Kc?d)_~$L2wNgYO)sj|sh*b`$psK*(AjFY7J4v(<lV-1wkNLy_2eVxRlR?kwO}E+Mz%iSiW%3YTx5G)f^29 z#rBhf!q1ps_Q#W9HnpDNkakPsT%>_YrCt}(G9LVza7UMg0wI(qI$CJDOua3j9Lwa? zgp6b*@NQSNUPAZ0I*_qc&>kj3E;EY_4?F9{(7WIl_+yb5-bWm&^IpA&5M2tIsHY@y ztC<)%I=lHK>3Urr8es!81%gho&1&$ET0C^1=k{kYhs3Zv=&W-0#ZWs}bVxFzLcmJM&w|63XVB#{ zF6)lx^%H(2pYa2|;zt#HzOA^5r7ubm>_w1oGdL&kQtenylXd#-f^_wz(`2B4eDkfD zu&UzAN|_56%~<8S@jpgH4Lx?;U5em4=0E}4>QV2>67FO2!8KgFBB@rT$yy~py+ zPw?iC{%g4Y@BUZFZ!O_;r;Nkth+ltthE~NPLLf--<`4c&*3?1cveNZyy72z^MpTtx#BNwg2Q5i(v_`;@ht<@r_y636fyRSlJ=og zt@xfMm%b=LHlUJ8Jm;kNvJ)tWsUFZ;@ht(r5a3cwk~jl+$$lJd09WgVP!?oQDUsx1 zA7b~I+a_53^e!&(oCCl?QPfggPojAC`)6k0Qq80Gx*5QDmkF7ygD-ly*b_9R8uO;G z>X4fNw*+i1g^#%Owv%CF@@i9`*copj*1AxZvWkiss$v_i;8Rq+4#Lk!SL$db-l6GmUXlH2DLo%2Wc%Grh z1Ue@0!vXwo#B@4gIxd)UMw-YN!ju6{pcYAAt#-l-6-cWib!pV7XvOX+o2wLTRk4+d zQg)P8QFcO&#NEZaYnh;2p`2P`D5Vw$YhatXEm*57el%qS)T*c`*ip0~t9M3646%FO z1l1P-z7WySoslcRhSfmKFEQ-L@!_9unC?{wQpJxaMwN=q0a6hMgKF~gO5)2V40Trt zr>s~KaF`N~Q%26&HgZd{13+RyA=q`pT6gT51F@#8OD1>pSu@z~i5Qb+%t#IhCkKS) zDNO7t$5{5lb5O+XFT#!V2w!2Zi=Za6#&CYNrTgHQZI&_zhM~X^?!LfACQ$0CD%1w{ znmSRtV!&$kBDiw|bK`V2cnsSg4*)SzsCBSDDYvKKL0^XP`qLPMAt2DxPIHQ~R}Xb* zrLTkjv<2RZHs&sZUb+I#}&$G&pm7FyG3T8OvHJ$$fGe7a`2^BQ-*+*K1Xr3osuDGYH#m zU?MGc+|K~s?g?M6it97sJS(QeAhAIJLXcG+0cI6ZxX>-q_GA#7T(UN(Hb37%%c0}zY&WCAV;kjbTR zl|avm?D;>pUGat#DFMrok@t!RGHL1A!$SXRD|pI;#~rwM(e^R}X9Z?aEMkk#DnKcU zyZ}2fCbhI&5#UlQ*3Di^g<=6=fyoCWkgK{HBSCNk@GABluS$3=CR+u7r2q%E?=2}@ zim50S;OZsL0&L1SC-Zd{zgJDIpU-&?_as*8prJbJkzA|DelMz|xDeq%Ovd*Xz)t}D z8XbgPt5q>%H973m)II9G^~SJqaoHaa%UbshikQ@OAC_2gpJta6MgnNWulG=gSm)%F5_OE6p9nUXzp<7E$s2bdnww3aKbO7Etsz}l^O-$ zI`lM3*nu3Z4bs;L544QS*1X)l2V?SVj>}}8zy-i0b`DPtzOw_t?2^C;N>c4HZz8eC zvnrA*3KE5I!hD#aPY+0MkH~LNNKX%#jt}6|f_yk2rDTAFGLUApzTc)elD0(k3$%en zT_NJKQMG`rwN~s!v8{rA7nD+sMap8=Aa02}7HXG(lmM`G027;E*nEVY&7rt=W%K3< z3aVCY*s!5s#%>{7#lMJJ0TGjSYDJZbDufy}3`ku`q~V>^AvBYm2@CeCw?~OTt}VRm z`c}m%C#p-mOBB^ZTN-%sK$nSu$3%EIBpgl|$K#B&Oa=%SHaW*;Pgr!vsvB-)!&(cf zbY59e9XHtfNdDGmO_*s$CTg`WnHdu&^OAy_w=k*qt;4@t>P(?s_L2*&q=(M<2BI_U zwmy;oZ%P)Z(~LfS5pBKGL-3+s47$oGR8=~h@11QoATI->IjGgfe;OXY5mUo#CW9hM zn-VLk|Lp!jtiu9*2>xqH?lIfj^*y)#K*WtKpp(Z&Q!t3)p||$WM2sYnM%pP;19`n5 zI;op3H6m;Q7H)4N{0B6omtxpdF?DfcXz@Es;aQ13VA3FK+ta2G|CA+N6{N zAZP%9@ASkyD1=&Mb~|VrbJMrA!N}>o;_?5_|7qWd42PTyF22qf>Htc(*JaSq4$?fF z9q1|z8MY18OA8CI3t|s7j%e`aBBbu0i{g51($T(Ik&&H^Ae#a3Y5zbG6&Q^K4XH+? zf(@ZW9UzkLR#5*N`i$qi;WYsl*|F||^R3`klHbRYc`k}g zGy(-`!M*{Q%wMXzP52SkL)CgnYjG#XOrXgU=dP?cLLnPrzX54d98QGIs<-fXup;&s z5!9;48}OvI`K|!u)jSXBVR8woqC_#(3BUM%{9p0#dw&-{|M&kfp8noH!2AFFKgP{L zZ7Ienr0Rn_11V*E_qYBX5E1_JpZ+Jfl@;GC46KT@yFcYyAf2qz;aVeTjqy=#ID+xh zX~rMlZkQK4e+m<1&UlpCw%tc!q*<}f6*bxOFFWJS*{=hKgt``B0yrluoG?|vn`B-( zFk`Ji&369$BmuwJfO#f-DT<90$4ur0C4hH;c1s`KMSD6k8KAp~;>9Z;xEh<9$pX5f zVr*jX?^5%ruo50w@axTda8DpSJF6Dm&g7=OS_nxxQ?#mAfdE*AFfov&x_7RpSr_U$ zmAFt$L_Q2T6GH&80oPYjtFj=%cS@+$e23x-v(0N9q*@3Mv)`ZnF{WyRKTE%F3JanN zX7j|-y()^=PsH6jk%71H{D`0xV~bdD%PPHNmzt`_`|AeAOW$o`GeG znLd}c?_LIA9)8SNmU1&Lc;_TVa8Flpwed!})LL;5R@1-~(vay8-oIJ8+%u}ZSd1_r zwZ6>BLxLt%%zi#tE(JAdU+X*^QX2(u)|`4Ejwh5p92V54M@-*8A-!FYA0IFsXYg@G zI?Tw+1m@ZL2#Gvg1`g4KNg8O#S^+5#*^MC-!HOMg-Ek{|RTNuMtfit9uV9#}F;JP1 zCUwwhGp%}Mi+ZRH+_TCKN-GUMHc6HqtQC7TS>;}D*k!>g6H;LiXWQ^>gi;ixRFqOs zJpiUw2G!J)J6$KplDcXL=9eTD^9@!5fFcntqo_(KE*VvUD^&bkY;0br)VTRtCQ5jk z5}uX`PsamJrv>vegXRf1GO$#OHr@oH1vkCnwO(+pH*9rxlAx;+t-G9j*~DfIAjU-5 z03lh>Oy=B}!c5u!oZ2srCI!6@S0Wh_c14&X3xEw05u4i7q9 z)`7zsymRbwiHK6Brjy3de>f&+4u$i8r6DPI;6!NAy)g>nO(N=-SEgYb z5buTE|3?i7aP!wSo^l8a_5bF6H^G=H8szUiXl$@iyOfn_tQ-h{C#_~-?3g2$0FNFw zqT~mgdLjKibWrVu>RsNWjoHGmAr7d~J~LGZIrrf_s`oNi0frJZP{ z^4lY6l00#AWD1$uRWgbgPhcL%rP~ zw;OaXs8q3~9k;ZiQndh$x}&T&fHLIFSX0571h;ENxhm={VVB83NwB=47K*9_Vns#4 zS}UXoDBF--BYUX&-je{`$Yg8PZb0eeX^1;v-4(K11;XruQc*>k1mC@3T(sizxniCe zk1BZFY>6gUMq));2mk{`0j82Te!XdH9r0GKfw?G$^RX{^I!iD@mv4!zlA^l zXa6xO1DF#2zij<^ysg)34|n-%1~7qs!~I0zIDel?7g37t@Z6c z)^`p2@`Kk+ZtlHjpMCc8JZr7b_cLj7Y*S_}bqnLlvAXUiu6xNV&=h(4qrZn6Aq7Pi zj{PvA^UQjNO;B_pS!xSa^8Zvi=FG6*+QD%lB*IeIB=Fv|b@|_p;+SGG8L_>-YEJ(Y zAw^imLr;Hqx1DsQ25*Ay{Qq57= zsIruNohDU+gGmy{Hch|A(lUJlnKOG>wu!-j*RdV8rl=%!tnKeZuC!!NhZ70E>Ob2Q(M0>8*|3ixnLkJdj%nAMg?nxrzIzn?gQ7Q%mQ2zWm~+{ zC>whohO!c*%(86_tc1dnIrD&#LEuJ|Sl2V3WJ=#KdWQ!lIE}mR4DOU?Smkt4zZe+2!+8(B}Udq@$S~97Jk5a6L&$ z18&vomKyQV4`j-@O)bo)T(g?AREB936>P__)iHlrCsU^Y+fCw-uG70@Z#eSszqB@J z@jGhC9I+9P4fTrpqSj|X0z_1axq3(2AL z_&OYZ9vH3+_@kLA&1`)%NtBQ#EAooMxJ`^#BCC@%E^LS{uo)8D>6oMGg!LSl9GoCb zBqm+wkO>7QWqF*#Nz%Ts9hLQ@gsn~5ohQzTWb}=s+>0en32DxYuS=v*_S+mg?k5-~ z*jwb@yP%0F=7VI+WF|*z@RM>dn3rb*=~7N>3^5-%mVD0p(zdc}gzAI9Pp0 z61FFy4r}5<*!sjeDPi;+$BD;2`7vJogkXA_l+k}CmJU@_<511EwXui^Ad zU%|zPKf-o8=DGL%9vUMzzxMMPhf{>@5yN6h)Vzf+ov;cHe+*~tdI_s*Zsg?LlU#cE z0VXfZixHWW!#T1%@VOIlR<=_j&52VB>$7tM{$R=FqYXDXxVTX+55mF;SJo4Ym>D}9 z_^1rIMiCA6`FWTZ`MI5w;>IN>>xsoy8AoB|gi(~$o^T~8o1~-(f_H2eOKzHHPPVx- zaa<`IFKB=?3QI4zZLS^}&gLqD+=r~pA#n&C4UV;2u$d>^lo(M?d8tf_#5`mj$GmT? zLq6~h0^0-^Lt>ra^pM$we7`C_DLyD}7&$#I*v=Dkn5}!z)(~3T+wP7FBXu&Egk<0GtjiN;hJ39n05k4JB{Er|x{D8Qc{xo$TIRXsLj(E=iNw zj+%X?d6<>|%$F>Q!WNd$C99zr%CI#xZA=c%$$)!HX2CaP8E~*Soys1gS&4Z1)RN)G z({Rlmvhw)F0=FD-N~wa6l8l=a(xhy+GvgE) z7J*?5EaSu!hZ+1sQ%a(K=;ULLPLbDLYUdcV-CY* z4!3KL*UB7yEw6NzDdHIz#D)%{cy)}UYNa-X4*$_Nar=Q63wOsbp|RLICKV%v#g^q8(Uk*+&&5xWZ1-{983aloH0$ zO*8vRB)udvwbahe*)E-)T8nzipQvkfr2n%HU+aZ&n6;35sJK{$P|inOGtYBbg^lt=n!z!oRz{FzlM z;cUd*n8~sv6`6F4M`y>lEPX%$Chw;&=gD7r7j+aK%rogCi!7 z&Ld2Y6dW^=ICvxs%+aw@Ax_r6O{4+RAXQPb zMA&nlGb5mZt-^^W*1$HvMuo+g12Md2Ki<4CrHy1ZCTil$%5(j!Je3j`4wTd0F&su# zD`6OxthX?2HweOF^z7ff$KkkTD}nV4hug%npT3_kZMpSjuVVkY>(I*=xjaR-lEYjs zI5;&5rv_o~=9@Tk`&~T!2fu;%iOWws%+X_yuz%Z2Ik@qqES~r%K_Z(e5JT?Slck_r zrP$6ouB)~-2IlX;`&=}XISoY zbaau64}Fy1`qlryeV@FSLl-#)ZW)E;U`iDW97&_p!}U7BkxA8(b4)3*4a(9xMiEx( z!3E|y5R>PHuXqb@`JAud1uuU+`=_tLZPq;h)MLE!J-^1oA9^R}ubktCrEr`ivqUL( z|D_q$QSl+Mzg%*|J#XT!H+&h_-Sq|*2iG!BYfheen8)w^ZJzts?-I{F$82kA5J*9Y zE=&4EU|+LLczMf9c*&iw;nL#|@R=tc2FVQ9OK*P#ulu4u!;4<^R+h_s)`u7P^ap>3 zKlt^3$I*pn8AoBy7M(#(Sxg zJZh6xrIfBUb2Q zsMs2C%-$qr&lsmQ`I#@?y4V3qF)--tMWPLK61fT@m`t@WLdkU@HIluTv!$VyEql;b z>fY~#Rh?4Oz@!YZ$<`2O85q_Rl4r*WWi(Y-PnpC#O-eHw10imiV`NH+jc(ZLmN{mY za64sCxY-7_GfXiM_Lx|Fi|XuK2a;rkPB~X55mIu5DCh)f z6B(9U#${wN2ey8~t0%aS({*EF6K6K_hV8UwJ4L3+5dvsf;MG?qsU+Kq6vofqlgU9t zN*M^+#}X4=4Tu zMGHdQM%LRCjMnXMjWHKE@jj+;B&8f`Gqi;jVMc< z9o>dqypC9{@bx)MC2+NYYd{E=D#mUf94ZOX%)+=y-(|y~tDUo^mUCwHe!22qQ#)8Y^~RfbrS|2M zm2Si){e@_~bA_=hdiNw!(;N#6k~-|)r#PxKu-QC#jlC(ap~_A!tLs&G2L+)8BldIH@Jn520I{;Zid9(v2u@{8XQP>C^jsq8nY*Ql6)Z|FD2UmQS@yt>2K5}Mn;L5BV&WQ_qiE#qI$Anvz94h;x;AUms7bLdS3yI2Ycf6J_{qDcZ%isJ(I6si)i7;;&R{O}CzJ%9*`Jd(I z|NTGZ=l`Go3pcMBQ)Y@zJ3&1RUKm$7&;fxkLReTa`ARs_$ilUa_}Jwn&9isBkvD(K z_w&-v`zo9tQ4%RkxM9KVuX`J>|MEY>W1qN}|M+7+z^6a*F7_qmu#lw%Z`i5n#ydZo zH~yLbh1)*&%j;A<#u@KD^4c%pwO{d_T>Q+Z_{hKi|M8jM`Z;voqF&h4_JAefziY%##oCAAj=y z;J$bMER!Zq>~&Hqa>2aj&C*Kb16JBjOQ%ky+tk?KQgNydlFt!;Sap4aR> zk|JBQb3`Dka%NRdOcFcT0ke4JHkM3U@InDKTa&IjX*P;jR4bJ|Y@n^2p}e%r)S*ae zjSW&~XPwjmHrdG#tDtRXi{@(kOqbNDEx4^nM2m;Y+50bB@K8KODgS<1fL>I*eX&bY zL2()Q4<=C_VyO_z_gn6hY%FF=yR?doZWvrpPywB>-Vd7ZHOYW*mTV0#vRw>t<6z-o z*k7=BaDZPf@Pn_mAdQLWB1r>i{%jnlb)BrN9_mFx-*E+&#h-~;W)kTxc0zv&1ui6GoCYh3s$Q|HuLT&>_x<9FCnv% z!o*QH;>vo>(UB)^Mf!AC zS8Z69W02C$k7sPI)*OSD{;9haEjAF6F6ll0K`ZMKWk6fCnt71R{~Cyr>@ z39W3lNC|vXZq-;+3-_y5f)Y$9Wd<)VWm$qDtB%_ZLGJf`3(!gOk5=!q#ckV4QRG1PggxK>_Eg$ zve>g!B8@HU0$im0`%>LtNtJ15Bcg)&D&<6XgJ8tB%qZ#DR+~9g%H{n7xj%V`#NXi|OQ^HRwf*Yg1QNg8D>Iq{3IBy~^G?X>td4 z!JpFm`N}in8|W^yqn6)W(~hK_d+Tc1tk~qA8V=;DmsC2o&@!`iYI72#m!D^CZY@6Wx6!`M{|qoJ(+dP|lvoMbEB(?!Dp`kYZ%s zI(&pvcU+p+`q)`5-=cWOacZ&@ysI0(m@2*GprmwhX5 z{YyWH-#^2JXCC7Zf9q#>=p*ms@X~YW@_-lJb`PKb#oxqBU-ve?{crsQKlQ_ZnFrtZ zt3-+T0j|u-zIyKdoUi8d|HpsA-nBPz;mJq%;P3n#4}IjfIe-2fH|`zqikH8Umwx`A z=GIreh0ps-Kf;5zyqx?0{STqx3MkBT^OOmhRg0Ps=NOj)2mv8x7|C;~%`@fD0Pd&`)>`i?3xBd<8`HFAl z+=KV>@n8EXo_*?*Y*XOIJ73KkzWTd(!QF4-YyOvi$G`t;e}d+;sbA@!x#uH}i)7=BxSczx8kU zzZ|Gm-4Qjb!Ozj`hz#%WDfkRxR}+CX2PenmmwK zD~itmXf%KEV8AvRtA~NU$-s-VS{_gCWb_Ir1-uEh4n!q0TTa@5EI8TmL-)*FvOZzw zP2m)C(33YHtW9H*1A02^bzujcbWN&u1}yawP8#?s-acRUZ`-e{B(3-XOD|htFp~|= z%`3W0%1X1c&qb~8N$qp;-O$?=8;^F@ACvY(+Ru?}PfRM7Fst45qy`|(+Suc0a?#1z z|F$5OWY@8Tx9knV-eQk&vBEi5nZZ2R^;M1<2rNpnPh2B0ukV@ynj#tlF>Q!Ck%BVm znr)oe#)(bbvWYWujBMtK%`~yzMoy;0(KK^3&CDsVSZ2xJpu!LZiHR{#OVi6rM8i$C!IQz2xc$ zuQmWTOGmD;(26Vikd(rXmDF7^>fEKyP}DKoPGGeX&K?ZhaNxP_)WDfjE6(h#*xy^? zmqXs5_B2lv$YyJu11I5#%iBY)97i_C9<~XWJR;E~-imX@8|bX3G|_aNDkj!q&@6uIjhihPrZ(=?T+1%_-%Oo3QOt?6MWmK4)YQ!e6dPxT?#6C7 z-Kk(~e^(YfT8b6DW|$UhTaVCX*E71gM?zXN%sL}xM`(%B{T+FdzoJiM0!xN$tRS{< zXXBJ``YE@f&V+EO}o*S}bRS?fF8Wig9vHaWFPbT`M8 zU9gXB=w;{HsX>sUaxctguYKJ$DmPNLbL#gV#H&4^1#?O#JeA!TV(CY7Ci|@h=Pq!j zPcUr>xBbtV=%1jzA|&-p;109vcj_lW$N?^T+(z*y zp7CU0|1!v>iIeGsAQS5}aYZ9rpJkVaapuZqOBgMEbma&-kY)#Sz(pl&XXcm)UPx}R zGF}@jxNNAei=!PXlglO{vDj}n=btV5NEq@7PCOaB4aO*Yz-P8lqEbf`DWT@G(h;r* z=$yEQ>=pB(=m@y%IosO7a|k)5&xw!*VcO=;Zz00Tti(~--^)znyn$n@S(uMzbg-@| zuS`QuSq{%rq{oP zqo*F__|mz&X$}L=eDr;U&4wH9d=;xx*K%=vg<&-?xa`NACna5TJ*%5u$maaBoPXrw z=)xn;F^jTUCniy*1L2OhzJo9M{(p|5{N6wM0Y3g8|25mq5$i!nXFbn6{V1P$;9j2j z@bB`czWayx>aYC{j*c(!v;X{m<7l&GsaC51EX7$tI~>h$c~+87gzc6X6MHK8usbfe z>&w55&;1|&K8W(6U;YXH>(BmU9((GO*-c>*z=uEb0Y3T8pXYPF_*;0*SN}N{%Y9Bl zzU^n93#f0n=WTrUcl=%aa-R?V!jJHtpZ{SVe(G^jCcC+aaN)r};={lGZ@BvlzKJ(} z%lGo~ul)-gUw)nkfB9b!w;P=1g!b9OHTI+dgwxl*kgxi)-^Uw1?@#h;|Mu_k(O>=v z#w(X_LzXRWKK21VeBU4Nb${(gc*SRbDPQufe}n)0qkosTe8*qqC2xKQ@BJ5ln@|4N zpXBKHkj+8}PI>g>AK;OXy`Mkz*ZyyAf9>b-)^Gg*e);eH1qcD}a$;ySiC|I~#sj|e zYrc!OefhWYkq^F;U-*~*2bVv7F9!(*2U}4-_V`15?0vt^o4?@e_~!5V`+V8Ad@q-t zevA+Q*3VL!&c)=R&Oq5@tWc;4(b-?P^{|SCi8Vz_3Gzu9D5SQ+)xN@7gOxyL@Igr- zFSWy%6LDwrASSXbc9hnK=uJITsw#5gY3u*f?r>Qvle+U^%Mow=d`YB+;Eb*TyQm$D zR}T|y%aELJ#3)(a7(4A)vg(Gh3)mZIAuwFUbb1>G4cdTS=~m1M_4enJFt{9o6kV4iV27}UC`%bwj?0`h znS>!0pQJPSpr@9hsSxKm%K~FWV}vvl<4g)$A~TvoW(w2HCQVH9%r?zz!^9Lb8@HY! zC)=6hDRF75T$+_FIgBYcUS!W(zK9|3n<9PMVXo0BwwkVk4(qc)dQCKbp&h8Ifdmvo1FPz;Uxn^(4nZ=UT!iwrwk`qUL%nSB*CT=$zPRCqc zPh36{wwp1BS&A{z8W=~e67Hvgi4wf#Wi_mt{drm zxSA!FuGHU{w+{=QDd)jdKeH}|*ZMN0HE-?Iok(}?Eo73zlj;aXyY%%8}nWyhu6x(I$|lDRA_?;eX*3Yf;)Rn=5R>oB8J*$;1d851Ty}4R!Hbyofu-+!7$)5L9xu7?uNSY!sIATc5A!aX=vsF4Kl8xKd zN$o4lOhB%e(UfDFHGuk*_h=8vXQ^m%5uFqtjiD_W?xV2^&gVrbC6Z7-3c zGH;bBT-+v#cZhA4R>t4kAkq?stiiOKDu}yH}jW1$(<_4a>|6WcmJx_?rFe~#Y zq#@TC-0+$=@r8f&A2BTVc=td40Ur8K|Blr(;qZ*n5!VApnwWq`AH0`e_~Gy4JN~~v z!`FQMU*J>s{T?59=Pz^p%A*dBgR=5M%+bh}R+yC=v*rqcjVhZ6FM7>ec-^=B70|>7 ze*ACq-e3Kf9K{VzTrQS(x%$Gd;OXrN@BXhp#UK6A@9^;XXBi~0RpESs8?L#9H+|z@ z;ozDZdC$N3Kl$K)`Z2D|8{)!|7Wq1DRakpvh#T(zt$)Ymryu9-f9e0?Rp0dg;n`1p zjEnDoC(A+E1oPFoEa8)spXJwm&O3PinaB9~fA%-|> z?pZuakw5&+pCfG7eCOZ%aX$B}zLQVg_Z|+Pd(2oo$$m3YCWN(QP#7!N$lxHD_s*9? zkR|U;Qo>fG0z&P4Pj=>JNZ>;5?wn@`78~kEn&;0Z=Udyx_H1WeAT?DmrkWv^gM_-R z3ZDUFAIH}B$7Y#slXiLs-Ud=ZV4D@!70fwh#~0|yZ09Pq18daWw;0S~vvdZWljOs5 zVR^O9kV_J54uomvE-CSysqMpJM2=U@ETVzJCN;EQ&MFkN0DeG$zcHS%8;}Rrq_sg> z0&SGWPSo}X$*Hud$ZuW#`XCv^$5Q#x*-N~_N`-w{vSOJfu5-#&KOy19+->8+kW)u> zAS5NF4RM}HF(7e9=b02{Qk=;egGjW3`fZ%qhBfQBWgRwbVqi1PoNOaUbK-ETT$mD< zL-x&1Xik4F{gXwSm_lX?N3+1x)a*Y##CJB4&S1}xV)onWCgF~^IT1I`Y=;r=N0WQP z6awohakzGDwoBp+L(013L^3i!YPEtEui1`7wB&{4dxew(9NPe+FJ5T7{Wv(zt~@vF z4V>L~oZ0uB-5WW(zsJGe3b)G25cYCq2NLo`Xft!XJ>uf}h|7n8qst><>lo9B5E&$8 zrW0#7u)#)78a2>pGSR`AzRubI)&^Kh_DLR8r;IVAO;^N18w(4F0mB?FQ&L$Ywa>fL z1t?NUhLS&@)Y0NOnvJPhkMxh7iL1)6j#5lrmUKsDT7qN5Sld|0AXfr#^4O*lYb8!U zNj(!Q?W|V|?X?8!Xk!xXGsND9RK2H`pqVTS%^@$PI->Lo=3YWq<55bmOtL_lR4Xhz zy-_lQ!JG<|T9}L&_%uI~6j@pA(rMo-j~#cpq1qGO1cCBx;IjS2s~M zR_&%xyTqBRCAM6Ba4$ZzDp{n19I{h(S|*%Yy?oSZgSu4Bw$kB?!dlguiq3FblSy?q z)wD(CYGdn)E?SxtSa)Q#1}I&l(ovS#egijZetHjQ@ha$!Y*cDBh;}_ps)BRLLVVKh z231o*Q}wB~`VZOyr)m-Rb{DJc3?f7m&Ivw^Xi(xDNZUx-Dsi46MusFT{EB^9uy+!O zS1zzVzQD2O9;hoEbLb*zvBI%nnkUwqz*;9JRi@+!IW`ow9+&g8bD#rVsdJ3x_ZDOl zG{zjRF=qK$zTp!oraTxBmkszSW!b3D2RS^XaUhudXe4x&U$BkS5W?emJ}ZC3A? zBr&5zuUxYb2A}0TGs00&lbmKy=0f&NC0m}n&!6yi&Ktro2&+BM^H(BQQ1mo}SxHG4 zCS@@QX(gO&11$1^+|N0f<-#ZLV|#ds8*aUw+g^MJpZ@rL41;5wb3H;5;g;8ZK7!-1 zhd#pj?S@f3i&2Odw><> zI62t>jxaS@hu_=hEr0fJa_wy|<3s=IAM@bP{S;0EX&ecM0YW65Bo3BBTqNd|@Tmts z#2@~rALlFor@zNLzUI65!$0^5bj$a`5zf67cdD`+DKl`IxeBx0SJ|}@5+4^)!b3l%$5Ix-c2fxWZzy0&P^-I2y7rx?6 z-1ppLx%R=%22NVVK(QfcN%JIw$6W7G5=A9fwiqBvWx$it?oiT(Vp@6)XNZ%r|2_{^ zuqv2jGR4^{mImu3EPgqkgqZSssITwL=j4@6{8RN3va?3Egw4@sfrhSVhQb`cq6s`9Fkyx zV~-_1IoKwG+u(;t7!rPP49*i7(3pEa=dfWr9h0_e*alLZNHOJ}*%b1jUlK_IlSZaA zvkq%c;+Eri%O=d6%oE2m9B<+B1cyO5Cgqx<*)d3B;e-V(Qv(f*I0gjgv&y83*|a2l zCsZ6ky`3k0^>?M@h?A0z11Uvf7#J1-=jW_oiOM!8Cv)Ot;|bFOiKQ>o>dGwvTws2Ln`xpBNhu$FQuEg(t7AyUYvmMvW$=!J#lSU7$2EHk&hB~6?2Vk=+vi}p&#>Cd zNoo6J3VP7oo4W~YH)}3!FLD0(kn@)k>m!c_tUklzG%<=Yl5(&SIRtAc6?o3Tpd?Eh zwddH>ZLSR7JDpzvHd0u>zK>A5T8h-{F)7;TaJ33dTIFDQ*y}mfm4G~LN7kBR-(^O0 zBDB=ku@vCwvL3#M5Nfm2m3oTSHeeK!4SR|wJkieP)vIWdST)IPEPd9=bxdK(-Rpfe ziG2oxD-wr-x=T@mma@@I+ZWL0s%AHXJ+I9rmk+NFuL&o~itA&|?ko(U>-Z3n+;`(N z)o9^bQ&A)FyIMez8q2|sgU@ww`Mp0;8Vgo*8>K)}wQ4)+0o-YeGImX_SZW-Sv3}CU z@TbBI8XKvu$q#*jxu%P5si3W%pe1h_=qhpm*SQn*>S~AvzPg;1O8e`M(bZ0!CS@qW zE*X5enkuXGK{6$@M~y}=kwe}#d5g#|UmKL)=d8~CBshtEwD~lH;)iU8qkd>dgfN3cc zo|4X)>Xf-L%C?ES27;qxMm|Yl?A!Me18s=z)IL-PskF_$7*9&zs_t;K&68Whc(f@< ztGu?C(FzRCG0K8*8cCNTa%m=B+AW(LL~Pw!7+o(`VUgm-Wm7#0wQ-1oOP3TfroT6bblVL9gETAJbb z;uD;E^nPx8_2+ThOJC0?@4pY6a>H`uiIXjt#c|i0znJ5rOFZ)M18m2<_AK@m=sffI zz3=6S<*#@nH(dWho_yxh zoE{xFExZD0A{b9{J_Kl$_ z&OH2~cXH384{-ZizLXc-^SM0m`@czAb*YdB7C?FO(NA#y2Y!c)T0mb^4ESIk3RGLa_uE=z`rtCaTR6e{A`jE*^Q-v<7H;N})ih}SY@Bs1 zo>5rG?57k{kc?0}9K{qsOLAq#po)t$DVwyk+QGHGtw`u3<+ULx6?muaL{WOTcjUKS zEk+xBDrqp_r%m2D8z7ub-kA&p2CMT(#`2XA8MOh|U}r{OeCg8Y*I;6)0zB21?X;dY ztUE5hcb`0-0cK@hZxI}RNX$Na%tHPX1{tzXFdVZzxkOrTk!>QT8HsA@G#kh|B@oz3 zmW`f-Eyr=qQP^@aM~>pedJ>KTT$w#52_`#BZ51wwu-L#-5(~TyG%QzFJcFdn1$2y1 z0V~CdlNhQbR}rE*LWFrEL>1;ZG0X{Z*+mvZWE+L;JTQmc@$-{(&G5Evzj_Y zT?K~KqGcY?B0bJfFcL)xq6Ccw3Ul)MV(^?oGF=8BCEv%=>9g8nZU7b#O(He&@=0$VT4*inE5`(IulfHC9#pR@?T1jCv zs{v$ZQo|$(Cz&sm>K}vF57>p;R45I7=8KkIMx&S2X{*eD9Y#V8R8+lxqXLb2?7Uo> zO}RO)HkD5!4_|GOQ`dFMi4aT4W=`g}Xy3-tIccV}=Eby$LbuseX|;6K38HnB&?0`d zqt;WE>o#4xtCYJdlAS&epMrJmOuBAbB{zF@Q zD`P8Cxy8DGNER+%B4R8+dx zWT#}6KbBsL6h=`yPT8@yIKy>|8(DEcI=M`E<_V_DC!B;U91k1PVj>IU6PGV37yLEL>#Y3A4)s z)Y0TGQ_P)ki5$4F0sLU=XAsupdWD4w`$04Ku*u^_l)Y8XwYdT;#>`A6VD^bgA^038 zJ_+c;ShT~Lhd=lSyy&%`&kH{5wYXo+J#uG9$3b!|Z@7^=@A+&lKKU@uJo6|aDF~%KeW$$rF!$oEP8uYVLZ` z%X#|APqW$=o;eCO#L53RTVm!mz}9Ck+JO`9dhwl{x%I_-^gsLyp1kxNi#^BoIM)(* z8)T;zwjrRBm=~V-%j)BwljY%eei{*Ye26Kgg#({UFEYCt0{W)t+Mp`AcKb zBH5=F1fF^BGd%wB4{+-%-pq?W_e=QbyMMDKh^;?jj@0a%KD`9J{1w7QVLsm^&swUO!A6@Yi8^B0;fAUsqQA%=Fnw4&=AnXB$UYQI8 zj;bulpxo6sf9p9-%{o?m)Po2sh5eM-!jd*R#hkWTDk%oDZj8(1h79#uCpJw<~1ykYG-!c1?Nao;vAVY*GqZtaXRH5&p9EhfUIU5 zFr8dsyFP(UM5l~lhs1Fc?M_IKI)m{ zNQ@3m&b-KKl^m{~pAxC|cwar3cJ(Z2emXk^#GH|u`?yu@dgps+5Mh6Sv!ifkF|fDt z>@NpSFBa@A_mI`X03kVfbO4)0Lf<>E`QM>;1rvEBuwN!y-WiYi>l_l+J*m_k&`ClPSE(zz^! z(hif(NykV^tCh1=Pc2!phrWIXGWh&&T&L^k9a;t!`fO^Kx_BSyB4?#}9oglJYFA^C zaH@2Y)5`v(x-hGSwbZZgqB$D~X&KwQsiw3b7-kTMY-7PX-oGk(~mA?xlMVr#r{^Uc=c2kP*F7HsTGlGseC9PHg%tF?u2n&3Tg=` zknUPb2jsY_!b7V8uj*o}53+*UE_R%*YcNm7lD(70n%BUe@-cToM5?=r<6c}_FU!sa zRn%nAD&_h1EZu2N4>xjf?F~$y`Y{8KnxR8h=eFagjoa8q%qjRBBhW4Uull$TRU@DWXkae&2ASqzp~7_!tfr1n`w+w4Y^J@42i$KZ3Uc9`?$ zzaTRUA>;$-G8t%GL$Y3?i`PH`$4wjD7!EqEK)0hJt@UU6HG#4d>GTJ7U zM7SK_;RoK&+r@FyOJ0Fn?UCY!%VEp@7`(@4@Ud(-eDKT#*bOYP- zmw5J}2e{#-pT+(SXSkTov)Ws*4oX@aaQemF(Fz zyyu}m{0$DL$TjL1qHuD&$um%onNZ@8INgp)~GCuMKQ zlUW7UA@?B80yiEEc%SP?ZhiTy@qXlq&wPY%YUX%rh3ZiVAs@U?P`1{kxAbrlGZTD8 zg`FloBP04e{{syby@E*1y@Wdkz^7`$XTVMMY zwx~!J})#!2%{rTzTxk!JwdXW@uDk+OF#wKPzm?fmidjSIzy6>hd9da&Wvk z$+MEh9&;zVnv$}A{f)f%o;NaYPk8jfd)uH~+aOX67@k-_&c4Da71EVs4$nW!-odr# zV!^!8TG5bt>|oE~V2k8rYkJh8JLwXt>nznI^kvv-pUqH!rq7-m89Hg4g`o(I)zezz zkpI1xoV>XgGr2*8vkI3Gjx97rjImfKNTem9nqjV-UCJPGAcMLU!e|v48gsAVlu9+V zodWDIm{Q&s268W;OVahH<^3#Gxn@g8g%&hZ_Vc+Lkc1*PE}qH~=+d#VS)M98zWJh_ z2=$i`>^+FIy}6u=nm=BUpw*9ARj^*`P_%eF5$Vos-8iyYJnanGe!dtYlbtnWBMdU( zH6U?Bg5oAcHxW``Iyxe30upjzd_KGQrsR=G@`;(mhMD6ubEFej(#)llIG&Z0sBG=J zZBrm%36h0fLs$pla2r_?jj1%iViB_<5jU34Db@3UGlt0H3FRt?!^wbG>+ei6Y0mdY za*1g2-;{hy3hxHJ<(yQcgUvRRtb15ZW^4>%%IT;{wGtbVoL*WPLIa!&=Q!;>r@iQB)D(1idM8cdQEKkW_lR0$jHPBQUz1d;NXl7qrx?SE^3z zU?}R0JjhIA9;G)kUA0SfVKZ86Q}*xb`A}O3&QJ>(Rd71gey&s+Hzy@8EZiB39-GUYDbig{_^qoG61_XD& zW4%$GbwXLPXq_<2RbZ_LltRBWs`Q%bR>WB!1!+Mn8ILwtSrWpeOF&iAStHsdg-R!> zwTY+2$>+mOvTIciLpBH~1@BkUfCcPnjTmMp&`5+%CftfR`ot)Ubm{JcMnT7p@au4S zH>l_V{LYO-Jw+Acc4~(!)vgqFyJg-!$H}t~vH8@4%*Tgpe8>}K@0cTOw^ouX36X$L z1JfGjc_gBQZ9-?4r=_+D#~Bg>xqCPRyJGzyz- z*29hNgr`3FVQzoR7jfq1+j#iNN0<*cjDs+qIm6kTU(6#Pcqd10%hH?5A?2>ebnOAB zZ@rC}65Hp`apvqTEJRqvmbAEBL)d}{r%#{a&VzxEZ%o1)GWg1M z0U6i@2ZtfBo?zhzPTg`lCr6if@|j1N2DowpXUzvCPKhypzZ+J<^J}f(e)Mo0l@*DX zjPTOiUQU>2o_X>y4v&vn8pAhtiI#IP#?WQy;gH}Om(NQVpZhdnT667fFTtHTARS*~ zbh$roZESJf|0Q2{QhvSUVI|p5G}Bkiwh44f5S=osbWM z^#V)L+(+h>82bvPw)2%Cj+gxW`I5MvGMnWoVJp-Ay zuw#X#dIqZkDDE6Qh)ax4>Ru}@52RYYMarFfPHO#8>LOm8hCDP-LDZATy?wz3n9lZ` zT6y4}F&aM@P@>xJCE0Ut&x`ZyjgHd`&%shytsHv`VYwI?$02Wa zE6`;^Rt_CJsxvY{+D4AHYc3scxp1hQ9FIsG@TPzm!IEVi3p`6v7A`T`uOc5UpwN>O zNW}sHv5*|83|aR;V8QRn8M~Hjkeuun%|{ru%1E_Wy4gC`&RpF+>@3~W89Us8Q%u%f zgNAH6CB$ZV>Ygc0IAXMG&`%Fi0|05oQ#z76_d$AT0$#bKTSzW)e5dV z&z`m(Bw^QJUu7Y5C7%U!G&_C;eOD);RwygGZo|IUvG)n~74Riu7m<#fxA)?7r+1}E zElpP~U35%k7rW_C2eDnJ1+Semns$?BZSc`NgN^0wxx4aSij2A3kIDWlf5xs+{^e_= zf$Ew*OUEvh16AKb0Xq+Qg^wz&_fqsKjOzNCe%BS50d#V@<9|((SKY&tbEGRzu=nh9 zh&y4Hne8+ayw6?~o!DqXS01+*aq5`2fv|N%9J4KBc$= zc*n{QAb}KT#AU`$Rag!yM#kI?D|2e zC3o|{`6p0G_)`bm{ie6GSs(Gq``?H2unCFf=!ueWOYm;yu}^=Dw`k(#yWc>(_q_}f zS-6pFZhj%BZ@8I9AHJVwHe2>JvGO1bVIGv#!6}B-9$p;p_-lWUxY^{sDPx~g^^BX> z$7g0Gm;&Xx7v4cgkrSJg-sBzUm{``pt}FwM!2Z%%)rcbAu{?DR+x0OQj*hvw4y+T5 zHV|=|15i=|Kj*>bHswjRYGy|+sB*2qZ8zLPih;u`m)OSq9E?RG*9~_Q*;g8zkRlu< z#d)}N`4S-nmV2iO`=>ZQyabwA!BXm8*49|+1+1_;7$7L#vQZ@a-{Nj(o)g8pyk1Tg z9AdMo2AYbbo-CCWlcOeu{WI6%$C0zw-^_RXuRn^$@c-8ZUar+nQlJ~S{v|Kxp$FfO zPvEVE$JxIdY)CPRuyFY~OG@o=8{4g02Wq}B?lCjzRrZuh_()FdbkPpl=Hv5LozZ%2 zyGn>uimprgXt6+f#+W@_Lll+*b4Wz%$m^U2HK8<1(efG}pmpn!hYoYMch8z7vLy{R znXfIDeWs|NT>kH%xvFC=uqi35oz${`ys|YG@E(E5BnXfiFQqjj)SoM}>XnSDshW1SP8l#}pI~Y=9VyziRWv3G*=a#L+Gi(tB}N-c zmGmZ)K8PKPU9uXyTBvO&Kam!uU&0i%8E>lnOABD^GBPM#&{DOWqOOKA`dUFF^&YJc zOe)FmCG65FAE8xt!1H|lM_Qut8!I3+I)iKpcv~k@mfMIVl#Z!dJ2=2 zYGDjphlo^3sn(F0{5mB%xq$^|oj({GR_kDlRVs{PP3W}OsX-$hxNFkM5(;CIQu7$r z3W~1Ep+UlqovN=@%EmQ6jGa_9*GcsC53Yi^K93b~Rnyy8s(NKxH{njDpV-v5Y)DWG z=(T_)D)@9X=?R62(^MgY))1F=^Q3MwEv#4dS!&b&*EG{QhU(eGc3?yLa?F<0S(8IM z>4;haQvDd{(psg~kk;#wYP2s^)~elRjI^#K49s=K7F}r#>^SwLw};!iOzdXnNb^4^ zUE5^mP41(Kt-RAFmKZ2;RZ`O2qg}OxP54V%SOcT^=V|g%Z3%@v5LCLDWY=gx*E$2y z0&JyA)6>c*U)^umruss3%6e47SvP-bztkUn`*%px=uld31d zh2CYAnu*$h4nsW+smrO!%VCKd9NsyWUah_+1BHlk5`|3^(qy3%)|D4DvP?50%332Q z5vJ*cNll_^zTT7~UgzvnOt6=fF~LGC)Pg)Y-E#v6Zo!-)8{LpXzF+p;$XPkXwR?dx z^M)%D2q-5hvf1X2HV+(cw8~CaBAgs<`S=Ik&5Q1SJukZBl|1nN-(<5<&ffWQu7A;; zJp8c_^5jFGVi;gG=8mT=Ff4?Nv+~%}pXTDZC%EGcZ)NeHevA~iM5o+&_bZ8E<}*)z zk`ot+lG7vSArBI+8y4U_F-7jb?>($9USv_@^mA~T^Es_A#t1HleM|x}25InI3i zqwnRS1a4X_I63khO56b}Mcx)d-tck4Fs_I(u#SP`^5p-D7nY0s?_$zCO`ol7-Smzj zY7H&9;)HRzBxzzZ&ux8>%;fpelr%0MA~#!*LD>^w>+`{4Kh1fs@dM*xRl`cu?RxFJ z9n_OO?t^1za8`pN=<8`M@zE>~zO%geni!oY^TUpP!s5+s3mO&+05->0_|(1cV!K&a zHb*)puM6d7lnkKuRe1dOf0buG^C?apUNPX5|Gk&O6z2VWR9K|^z6Ps77z(JZ3FMg- z^e78~rI>scTSis!F@r)Mu@Dhz1hMa=TFI0vwbZ(+zVhVzFQ$CRD|HAWR#PJ_#(k%L zN!yS&N~*y)lgqNrATT?v63W?$$u_0>@|0H6UgpBZ4;6ro6OIHnu48EnXd^RtuCE!A zHi(Q}U#>5MUa6smtro$RfGcUqpRVRnx6aw-IKrhS8I{CN%wI{~PMs$|nJLhljM-N} zX!mHcenf3`6xDNRd+C&vW8E?)M{-I^jyVe6MFtTj7l=b*;T8}e1!q!K!4b?um_dH@ ziQw~dHm8{@Deydz^P*f5II;D_m-DMq35_Iem|BMUNtJDYD^(x<;oATJfB;EEK~xWz za!`uEAVtIne#{E85|)yDK1)Y|!70(_q}*tEuZfh^FIGXN>hu0VPOwetNaBG3(ZL4F z4wt;0d$dXeb626}*Gq|zl#nt{7>T)CGG+F(oP)jhoEjJ0v|Mt_sTJ3qS#iy&1^dg9 z{c*`+9Fe8VH2kRGvoldMq`vyGCyIevRRFZWP3m=(o!vn^oCRV z!AGaCQrCqpO0xh}HCCybpi2}b?wrY*?MZ9kVP)|uv6R2o*;APc@a<{+f-Oxy?@}hY zs>fFf%UFV(Yz0ixJ>y-XYOxCmxrftLK!$bQP|cPCEbkS+0n2W^AI?KpQ*k_spD4pbI+ByL-!c)eb0>8?a6+q#f{8z1<6`(+aEUgQWt* zvU#iQN($*Drqy}2!)8)Fe)Y)J->l^Ulq^B$3w%p`fmC^3<1TCeof)oMRY>>NTqz;Z z?pq6eMSH4MADI=<76;YRMCt1Bq--&%0-#pHr=6!#JATa`<&wDC-68$QS^v&_hz$Zt zBYR!h;2b3 zt^IYcliSkif!a&Tmdzrl=%*_7#*( zz$cJ^OIuQ$hytEvW&|XmamKqqavtv@PG(}7b1#*Z)hfAGBARbPWUM9C*l;OX5QDhv zRS^S;9zh3B@(^@ON^?GB#Rwr!CWkQOlKUwVSIV?Xd5RAVZp$E%O;Tn}NEDcrq!B-4 zUu^2uDmAZ35foU(8eEae0nRc5#=IxMoT`b~tn3a+LQVu=1W|%!liJH!$Ma z*9k>f4Fk(@V#%uWWoq6pIxc&M*v-IKsvU?mRVe|K&um zL+N5@Oj<0VBC2do4jC2;7UM{=WVXo`1~IR~Y9VZ6j+YN9`$Ly5ukedOxH2o}u3X?1 z&a=1NXPYvJ*tbV^NMt~0pl&2HR-q>4!T#O>&Us?k5~f4E&+Jv%KTG4mVC>f{tru?P zggu`@(pK3?g)Tct87K_K&c(8yS}Lcv!@qBsF!$~m7;zq^^%1Ix_3f$jEUP_x{8XcB-iixJ8=gN|cD#iI|j-JT3}eB2Hm)O7OYXBg-tE4Vp@>Kw_4Z1IFw# zNGWj=C$12shE{DZ&b2p;HTBvwF}sl3#N?xpS|Nd+~j zM6IWk!wHk3QEUHTGC6R@?n+G752z+hFHEE)n}@e^P%3FzMUI<_bXTh+I618kKuKLz z-<=25btFcy@l}_o` z&fh~Vi!YNL%$QvRVp2;B6|GYrks<5uI zjzx*wRaLaFVJB4-m($qV2BNKEu&>b5(zBB4ZdRwx_A}N_$DLuUbY8$BL+#i+X*Y9f z+*kecrcHpG=t^IjM!YZ1x{7gZ6*n0ORwrmVJZKjg-n~}!I#w3cl~FxKJf4hY zR3R66Uvn*ST)=8zZ{Kt3*$ZrsCjya4wu~+>(wSY!326CrpEK_@&7{pt+T`sj`Z0r7 z38WYi39tY+C_cu_pv8_E7?MTzC+qynrQa#pAj!ZW8l`3zo( zJ|Y1Y!QrNao3o-qG*sb1NhNyS2|Daf(gQgvKT59NSdGHu zg{M+tBY97BC`+e!4f&9ta$wC;@-*Fxu)hfmQHYuto#W;KZW#wQ6Fl@VijO?UFx zqffAj12@0;Zq7gV1Sgj-GI}_3FcP1Ff%NICVpX9Vz1FyY*YUzZt0vEdZ+u*W7Yffcg+j{XZ zAh`#uP)4L4dXlt~^p(qN!JxYX!fFk1usOWMv{|!vaGKKx2OK^#SE-;Yo|u?{%U}%N z$`15thD8vr)q%k;m`H3SOVpx;sHrHg_Hp>#VJI zLv276P&W1qmZ4aFp_6VXmyZ}_Ey}=sEQ3H9VnERiKuq( z7GLZ}LBmWE*z;P?s1BGkFiYe#%Pi~kmTaHB1SFKn2cqeSH7bF`5rIn*IFhW2h#dh_ z_QL-Ah^0j)m%WMgRI9n8-2v-KIrfRA7Z%QJ0g^qmrTbExx8t8O;4Cqe+)YT#64H*L zjwE8rQpb=ii4{S-C+a{i`=xF5!bAq7A34|*XmyR#-{Lv*YU76S%4Y=U5 zvcTm;-(|Gli_1eI$!y_ZrSx8-8GcL^RU(m8k!00riCQyJ>K#hre(xPDzQL5TI;0l4 zTM=hfwWaoKXzFYYh2TlKL7_N+%5e+!m-%8sU8EN!e$H|?2i8V}s%fp);Ux0sfgbZrx%+%efF#a82DWhk}W&uR;n zEu}>=UD?_e6}KaWD&V-OigsN@MdaPyr?k&R8Z%ln>A`#4=~FNc_)|-6xPFhtxg*xc zC!{cuVjlXGfS>&S24uFAV2GqO$R-a{(vS!~-``cq;kOD5i7!{2^%R@*xyu^1w z&^{l!Tq-j6F1i2XO*SCmb>9_WGnk#Mwr;JOfQfMD?$VarOXg8F}Tx3Wv zM!^TE!xHDRhtbWFLt?A~!#k=hY%#)h3rED~O_Gv0YxnrVvz=m2I}|wdIj}@s4!(&) zMjM{Qb7|u7?aXs?V*BjVyyKBiaQe)(+`l-(#+~pTcfOkEpMQq``2OExb$G(Het}x| z)=QTwqKgEV@ZJ#~dkCGjyyc#^@Z2B1n-`wFiR*8=okt$LkLmCVbI8))FlF{{ISQNO zBc6HmQ`~;{8@c_}pTqlp^H*~3o6pRvl0A=#a;%Z)seP!cg>Z8blu)^ih3om@pos7#pp1SY% z2`9%4L!M$gCj^s}6@YiG&-E62Uf6e;1thgWtg}u$3u4UdurZdtwvuNF@gRASKdQ1w z`7j1BCS@;_dIZ5GVf*+aTzcv;&ffGwUh<+>a{P%0YM6p_BdV+jvY?2Nf#zON_M)&S zE?21}$1J&(SW8Nv{l6c&-e4Ps29zl!LP}X0NUK07ewRR&RR&S(Ow3GLS@%_7i*lmM zL`gJlmWEO7J$FUwk+wI)4ix0FcD00Jj1|h)HiK|wmGb8?BU~JmD;_pJv%G!CS+OCh z9VAN-PU`lE-g;5i`T`cQow+bTYQ2D^TRCY{iX>^?zmoduQn&VL7b@dgrG|9F+X9Lj zv(S8r9j-JbSp$wWkHR*m0x(PGpf^_6Cu7$&tI>v(8N+Jbm);g4HSb`?7+hxdgR*cr zhJQ%HkaA+CxRK?cb-&e7(Uj$plPjNN9vDspj)+|Gc{tT4+Z4-&Scsx8gAuz9p%3+! zT(jX~-oK{^>j_SV#B#{q^uY_mnDAb4J{Pd3a&9c5qLlBm8bYrzhd^0Soj4^WL8Alb zv-A&#OG8HBrK4J#ohq|nS%#WZMH5jhVbqwhkkpdh^BH`9;kjuwa`Wj0*Bz|5=G2PQ z`wLF3mMj+w+~6}Hv}&g8)lA3~VXf%pz?H+xoV#+4iAc@}?Y zmvfN=6s*dvE2=m7Wnm5lK`q5n?H6Q5uhpw{bGe%44^2ELBnvG{E!-myg<|#=rp|vW zCDgN6z$yxf6?ce>d9O95G7tJJfwm5Qq?w>Mmp9w6Taaw4=xpL~?iy%}6Shx#|w{6$GXVON&>k7x&fwtjv{b6&6xxRZF~-R9Td) zyEg{OCIFNUKiN&-#8O3z6weh#(sfeR%0`;3RCd9c?yyR(bFueER@Uapc$8rX2vqh_B;7t$gf*irHMA(nQNRTHc8ne7yI zJke4&`P~qO>f_V~y{ZyhQ=P;>PlvZ@arHIY0+2c>rf2~L(#b;EiNkSS+l=(mS}i>` zeZCV_7EO0B*cFLNC&HAS>1<-x-`G5@omohm=3VjC|C#JTR_XORTqQ~9e3jCJ^ga~K4P=pWOO&-!)*)q(wGKRf{|9-~mwr93d+V3+yZ`#{6Xs+5 z=-Kn0OUHqQcWfs`R(X#Yecp%{gRt2s!;m$D3nyFyEM_>_OgX@T+zWSx+&OoYY!E3k z7asdK+w~E5yzOv=^^dnteJr3zu1GR1KE%qd=U=j#|3D;~f1-7L4tXj0WV=Av&Oo7(F} z=S>qrmMn{~5M_lBqGbdG*t7NSK;b0`=DBs>mhhfI1s}3Maxdi1Ni=^>H&23(l6wu4 zBOadc^ap;Q8^7+q=k8a14(EU4mohzRpNnc{5lR~9KrUMMsrarElLn$XlKJzfDxX|3 zzK{W;Nis=9$%E5b5}TAbPPwCVOAFUYU2o{tn77I0C1C0RTauj4I&1#BYJ9Y3YcK`U zVCRD3?JMhHAy^79DzA%ce!K$0r&O5R%;s&Z(j?lyi&rJemo7muNv*TJ$aU*;qz7ni z{V#(*wbw7P^JRBVB`M$7)>K3vT{fQU4t`mtt5pnD|65yCTM(+WEL}Y(q=7fr`2*?H zVNP4vRdQ|bD}Zo_HpH+&Mv)GeYZ85T-m>>&0gVKdt&Q||_9olC`GA3bCWiw}BxEhq@5E%v- zW@Q)#hM1LZ-bb_=ksx{#f@)!IN~nzOx>0ICO^SA&wCR9a0Agl?VpW-`=KVW|$wX#i zW(qaiEuw0z`a)pgJ=gAy+;V2g4X2l!Jy>yOZ^h}=iq&d~jFx^i7B8V)#1wL3)^Xza z_>kw1&hh-^D_p!7*C#Jl!E)hXjMSi$}^>u(HCa1yn?n~L%QiqFQ+RPqyWXr zHdZU1$v$1VxNdiaEJn>Lp>;KNOS&|T>Lo1QA4PClO6Ut~RueMaZYrphnuX5aSXNW} zUY_j9Y9O(dN7B_iXoprxIX$Wkh}M7PYTsRQt^<3nrXuysYs=x(Mp;P%R0Xw3Cq+yh zxtVmA3DZtHnpwb_M^-Bn>VoUsRavA$tVx|M#73oiV4c*UlSDJ7HxC|l`lj8ckG8n$ zT1CKa>AY%-Pc3y7Ww%Q`}@-a??Wlw^|34+$H7=Si0`vFCSHz;NrBU zg_iGL17W1Z5p@fVR<9-1d)ukfrH6!_hf(_=rhbf-T~ak!QMw=;X_YM6PyKDkQWjOb zM^~rti#^;m6K*@PI9jv!+yyqzU1obS6Ov~;CFUtGqlA#q;Omqu#YEDOBil>YXjBXC zkox)gN?f;YQn-&Uz{gKt)2{5SQm>^FU8mSgqA1V z1C0p~OM;6rFwDXjl!dyitdKlhnx~NO5ij@z%OvatWwl7ze_~YuQH7_b0Gh2EOMx>2 zr-tlZ*gECx?6@`N=i&JPZ9tO0L3u9ZDEe{8KAe!?tb=DlmN*ZZ_|${<@~8jw|GcQN>p55DiW^0PQN;^;W$v?V1Uc-|6SJ4Kf?>}dL5ttgFp$W!8 z@G+MzFOmhl%*xp$ETS-qLxOUR!a;O-(jD^W|3dX#nirfMN6r#BiFqux`Se3P|L}vn z>do)q{ujN1#Yg_Ah7K)Uo**v<;pUiugtvf*g}^4j;B!CM_L*}$_WQretG?`;`25d) z8~!t&;L<$dtX5+`38M&yG1VrQD+cslc=M}y!JTj5RWO^UR?X%+~I_o@Zdxga)F*+E7u(SoyM_5hZ z2OBbEJtp`6^3UxPTT&Mn%hQ!tP+8{jR;pQ%d$O|qK_RwikwQ?>MeRo3KawHc^%acC{} zQ>)}FKl8pjAGmTTEUGANet)sV!T~W4W@im>?ehyXHZwRHOWfHDcJ|ex3bW0~rTn## z3{*ompb(mDbWDPa)Nny(2Yx4Q>ru%HjB;#B-StvuHBy?rsYyLSCHD@-kU_V@z))hV zi77>*OC(L!y(q+D9V%9U4$P}7U|wsEMUl>V=~>P0Lb^-|O{%PevOmEzD)Z!63|YaU zZqDWP&g!ltSxUT(KwVDpkEU8{#EV&nQaSUEI0jUQEIsV3QD_Ff$!aHNiA0H66{E$c zm}QJ*=rB0P+0}wu_V>Br^gh>|+UJ`6J-F(s~A#;)W_c;we?~qJ|x687!3g z8SU9J%X6@Ed3XG-`Xuv()u;zMl{jfd^!fc|pJ3{gm@V+I5K}1+tj+$^>I1K;j4RBi zJ!?Z_IjHi^%5%Wk@gbpESa8KFDZt^8e*wvg9~`SK9iL#YPT zbSGn!Y7ovTQ>j*I)R2{`FIV~oK`D|A>4Isx`?x#{$)+;ZI81+NC?QDMNG{qWozjgd zn-@{(T(WK2BV0vG_Mb16y-t#9wW*dq#`L@Fq5i>dWVmXW$P*{?c} zx)ls7WVy%U)QbI^ZY3PfY@R>Q@iP~=vW}c=B2$1_9Bwf%E*5zM->$RK-sc54Y2MQE znwj6HHwm?dnEOl}xicv_oF)<`+0&5$pOpz>J;c)w-pinln+BhKYF5WFr!4VH zNtt6J#Kt@kq>!hosDS zYp^vf!Nqk>lMO!i6?(F~b)#7V6;qbW-f0Jv6IGrF%8|>VCq>Os2Di@TPzPq^Zj;I% zDtt0%X8mj(o(IP#KKKXR^s7J17kuTn@WQY8Z@KqJ{{hqbFdv-qX$wz23l5cC6M`m! z$(Ms`;KB(kQO-u;g(-5a0p-h1dD_oh9uo7AnW3$~p$I1y6vOTkwzI8uZ9=<)a{HBv zcGA$7>xY;v=6T0L9aG1sRnFN3OG13d<`!S1H&C2J*%pdhaquAO%3XX?Wujv9_(>uwa;R)Ko%pq^vHtD5H1Z6j&^}3A#P_bPsd!? zoN(z-IJ&e%kA+3dQqhHGb;DAUF@-J{)w?_}%|T09*66yhqs+Laya5%xcZym1s36JJ zs+yAEnH4}{Uc#dIVYhlh%I}3%K4x;*0>oTXxV2n~TxMSf7?P?gOL4{gUr%Vg`Ke=k z>iM$~KH6#_3b9ZpHiht!UE;=B>p+q&d!nclw0VKerP7fq|QkbE#{`u9?@;q4&Zf@QSt zTIh7BqOIVk&vt|^`LXId+REF>`AzGQ>>(;}*}6z}{DFDAQM-s}p)3uMOV`U}^%uoY zpsf?HCcx4aboL;;+f+rQn_*i@liip}qzg7NhAi0_rh;pGFWsW4>}1APhANds(QbOJ z=5?FAm}3!>PSl!>;?JZ_=UPwTRfiONJ=cqCr8-z^7=(y+y-OXd)=PYfQ9q|KbU`)U z;6tT?&7{4QnyLY>3rWY_*K4wCT`gnH>f`K36pi_FHQ=Dj_-%C>G<~{uKEpqjl3JxO z$pQ!#=;?j@4cD+5mMo7i;XnNe#tVn+pWASB{+Q$A85s}o`)Apv#8EiUtef0HX{S3O zPn*H|)(oM!Ni$2}94Shc<#>k|#Tr&~sh^e(GH>_s0(C>~ViVioELuO)I zSk-EJM8Lb8h$ku50f>(I-Wz5^RnFxq3IR95!9qAQB=%9!bO2iqDm_-O~S0%Pv%uQeC`}iJ@N@&^P0DE?aeRb$xnTl z^wgugXvo0k#HMpgC%7@QOw(4`im;v&5B$;Z62Jb>@s(foE!_2rH*oIU6P!Q)q=n@O zTUE9`Ptz~iLCL4Y6F>LQ8D4S+fAVX-gU|lUe}|v=!N1NYKJr1XAA}o3xNTVS!u?Y` zw>jaNFf*mdc6Gq5uX+Q2^x^jsL$G3Sn4)r`@P=vTT2(%_+48RAHAg;6GnWD(DPFhS z_n&{7y*Is$*S+OSc;gTJF#qx&d_NCA@<~<}XfQhq>o9NJ_4}vz>Ob+VoW1@Ae)A`P zgeQ-$a6&>p^Z_ z^723NE!_Wyzr!#7(ogbm2n1>Vl9X~a#?2NSc8SCXiEK3|t40gkP?rNu%3*culvi5i z!37c@Tx8}rp*z0uBIg?gqK7xwDtuX#PYf^)$<}7gQopq2U;M=X#dR;ai?{r@{{xSm zT;V_b+aKZN@B}v&rY%=Kc=91DM8^#`-NZH5-^3#ieXI^DogMU-z!c!roLP~X#Ir8& z#8SDu$bEKFB%mmBY@rYRx+@*4wa){s$#_k>C&dL-Zg)r*a6i`X31T9mo^aHWv_|^ zPRO3D;*0DF3hlgYeNS;YswCa9Kw4Ph7Ns3PORY*Q2h>gqTEU|QWjG7lDF<5< zVbmndfny-aKq9A(mh^C?cnAZt&N;Zo1|`Wt4BHSR-_+yaxMqLk`co^eJ+;T#{e8}^ z_E{{K$a0ZAgq0nPunf68bR@Hc5w>&W^0ejRTDf%DGoK{JkiTT9%7R=&k-dW$JE-;d zqs#aCAc9wK_uicC8x|Tv6zizW!{?n2!kEvBx%SCe!jLKuq^L)e)Q}fVxhARvNEQ;n zl{1lc{nHh1c=P^hW6;cEf@FqTE5L8hbd{!d>q5a%Es@mO+F6pRtX?G5^qTf8_2gLz zo1|H|d}Uy$RTPp6ky1hw^Vg+h^=AbuXbW^4e3I5rX!=?07_(9{A$07aD3Vgs0n?^X zVhNXpU95pMP^SS-n(WkRo7|LV!nsy%pKPVdfUqER1FfZ;zRKa)k+!BDw5TG^)6yAD z8mcC$5ZBJm(#h|v^tdLBx)MlI;+)GW?7HcoC5%du-6ivUQJG5Z4$@`HKv!3w23As` zw5=$$9oXs2p=HtaRZ5`NIg-0eJXh0{N@E11FC!FJX9)r%=W!|3o3gv_y6JgSxGOo z6n5mGZQ855lV5FviUL~8&?K4Xw1h3C9llj-B}4(4)jQefa(ZquPl;q_(k-3uLbTJE zSFo=;Qrj*yr%klA0B*-l&qoeaHxTyr@du|#djp!T zu(lScI!MO;7n9M6L&T~pQmp9R6%>J-3!E%Oi18D(ao#j|g zGEm$L!ihd5XTqK^Y$-E_pB;qp!ApIV3f5F~-io6G#jKmMDH ze&EZ$`rG)f|MSQAnV zf9G%gIW9f_be7i{fLvHI zEUHW~aakhI49dkJcl!nHG6(Et1e*f{O#FY-5#zKJRB%n5sYRuS%0pjKYDShLEITx_sHXR`{aZ8POFDc3dl z5}{x{a3y)x&S3SmT}gs%3}zX0c)%yuK(QTaCrL~s){=6%v08ek0lunC(iU{+(VFT= z4Y|wTe{K?@+DF(t7ku>F6?t%jsw>&7o0s9IoMlrYPqa{kd;Fg zV)YXV#u*j~mN_g;OvZm40w;6i=tP-L6gO-BXDTe!v5-^)WpWjTG8!HjEtD&>hH5ol z0a7Bytp2ISQj_eXDR(tS3!qWWpjizJs#-^3-Uq-!*!qFDJ@KgzTB))KduB^dl*rDI z8_Oc8 ?I)OF|BdhY3h5<7B7dcsPzKCdYmldUbjvc7^1CaMfHHW|2fW%lhnS&~ns zk|9btYvhDwS3)4m(^Sua*~Vc2&3sSvKD$yFSs_BFEA0J-ttuK?$D!0ib*l2ZO2fP6 z^D9(ro+?RY6e~5VHPpYU6}x!->anvA+(|D}lv)7Wn426f(1XTW1R%TRI$A-TbP|-F zO>CfGXT<5~9>(Si%$~HXf#@@ zgiiXCXn{M0HB^)6#3H4w9?E3e?=IM;LBpMaM@x-Lol>)CzjL&2>f?WHQ}xB~VyRnQ z;~$uGrB<#O`&jSBDxvPCf+Ag}sa(|<(g3aO99Qh#?+lIg*_5_8_V;~DhjqL6gSbC_ zveI1_aFvl(g}0&_NZZS-!ID3j=nmM=-86VvepV>06XD*L{6ap)a z45LSUJ{rt(B*fgbR2O;jX+@&>4pV0FMSPx$C5H|Xbtwb5(W47z%JSlF4Rv6pL38zm z=EIvH#0Xv^EIdgD+!P>KD2)ZSSKs9bItnu8?>}r4KEN1Y93hTcl_F7vIXDjOwZSS%djnJ0Pbq5FCD=YKid%?ZzZ>SG*eWX}s{op2(# zqit(LWhv#=1EkG){?$MH%WSTk{V#d^u}|{k1AoMD{#l;Abi_Tk-p1Xp z`&?df`^y;@3*Pmv|H5+@&gBC*N>ITK5GMHKC+_3RzWf{chHw6E{5bHRe)(sawukj_ z9mzdQAN%kh@%`WT&3ymg{9!)(bH0f0`+*dhdI9 z`kBvg`t&ut;+{8h=UuPHd&h$h+{-`w2j9zs_rITm(b$||UX;|B6K~Iv^8>-wAd(e} z#}Z1SEl?_80};XbVFyGNrlO#%qSnZ@2btsc!@%yYX2U8&p7(w5_xPdz^DpyPzW)dL z!Y}ExoeS*;J5MZSwAqlZZ99O&ZV>wcfDKuULVeUZtkc zwts2ov8ivd+t;;YmFoL1L_)99DEpc;nOE_kmb0T{_YH{3P6D?W`!3QkZ@m|emY`bX zmeE@}KApr>izljMAWPY%yNaUKHU#T7#U|~waGes?`!Ll+8CsX1jmmn` zDnU}m78lv=fEpOh%v#jkxwo~@q0+yXN@!qrNNzh;yHP~h@q86vSb_!z3zlgCLG3zJ zEo?WTjlhX&P5@5I7!@C~oj`o{@s$qG+({_48?zkp`|+|AI4n6fsTUxZwD!z2rn(!p zGi|emBoi#>5+-4PaGcs3*k6t8uNJJ9Su)C=%Vze0yqFI$#~CjLM$1cxd2gKJ%z6q; z$AWA!nK)|pS}*L^pt&|@q|}<^G;dG-EOJr3B56hm)i>H|q;u7TB*_3UYQ3pSvS?Xb zN!C3WO**PllUa*AIhC9TZM9yqqjqYU{H|iTVv%v})TOy2RZ8+`%J+kI!=T-#p?H;x zCC}9XUbUfVn`U*{mUW;3F`q3=MW7v>pBo?=;%Wq5vGhs3-%18XD(X!wf0y6Fpfy>i zo!q4qI+j@2$_6wZuBO^(lakW0AJQJbF0$YHX==jgZicAnZVF^i=Zd-=3buDw$&M6K z`_Hy9h&#pXg>B3*z?IOMs|wxAqnYGtCbIl{v9kN#;6Tf-l$_A2()kXGf2|aayVjdW z&&H{%6JS&j=NbsA2}0V1t;xljs}YK`-cWm@Cjo4^H=&pBG6h0C=vE-5m>pw=N| zNf;`M4ni7iDo(`DDTjLmh*Kmj!7YT4@@dBn5F)IjT3rK-cus|ZQ`?zwl@BK}d5D<5 zGJ9WCsKw}m2r=d!s=)xp7?m*vo_pYVr}FFTecL zy#0&5hR?eD^?cJe|0Uk@p5Nl!Q&(CUj6EldL3#Y)2l=bt^Obzz+x|3P^9|q0UH816 zFa3&dt{ZSlk;fi>koW%TPx1S|@-sYg{+uPpSz2k#>-6Pw&+-rc=ReQ8f9sd{ns5H| zyzm~;pWqjN`k(VF zzwobl=z$O695uq+*{@TgT$_YbPPr_JV=`kI%L1R;He3Red+&K9vonLXKq*&3+FS!U zF&S&s59hnYy}ISQZr?M&;iRi*(ANG_Q;3x-dCc z!YfodzofLSvD$BhtHP?gFp|u`lxmH-qT3oAed}O!p>C&{DJ*pct|ZOpVNmr1YI~i2 z-q$bneV$!vGu|D)WvKx{sfW%~n2RpdqkNy(0mwQiwe@W1lOVgQh#>aMhJz(>oa$fH zooayU7v0^c>iw4_hwhX=^WD(Fb(t7f)mL}yt#XobkLSV^7=)}K!6m#?uze}ZkzGwS zEudbbpgMpqKnFC9BpuM?I^ftw{e9}XSVDKXIh{HSI8?lP{2=Tv2liH;)ylIRJ$@L` z#ej@<6O_$ih^E^G9UW{9$j3;W6WcYUlZ4;qMDB%VN&R4h0#C|m$AH%ih`kfMclNx5 znhdHbq8f9BM9LkhnfVj*6P9T~CO`^+Ov!Z;Qfj}r#!?|c9S~I4Uqyv#64XWjNnr_X zI+UMqh#dy=*TqW2lu1zW>pFWryiKZ9+F?+o^+VJ7hf|`nBH1&f z9f4ItwE9G@{CRq{L{g0wP}8btG$%Rbd;4E~-Jet;Pl$(9x@asFNR%;|M=&X)=83u( z!W2!6nyiyBRVkFy*i7$qhiPEQ8B6szTY3=7gXTJpqbD!&-~0M>_5-Y{U(kL;=j`9x zhwa+aTYK2BG^#Fmh0d2%0gA~owE{qA2il@HA4tx%$(Fbpjjxi!{>%3(U?-thC66{* zyGF-YEOuO_|PU2E;usT{UAw-4sY_d}A4i!*(m8=U#TxA$) zMDos5SSt&gXakO9hvximVvSGl{j{ptW4ubr-uei?-mpzM_CGpc7)frhTQH$9W)L?= zG$zs_u0?qyeAR}ZYC{&gMqm3iG#_a!VJd~?l@+^=p7m$ zg@haIARQtp26X8N3n9b=le2~0#txbbe$z6qmxPGSu$YxGIQAV}zlxkbqsT&053+!9 z9J#o4eEiD9CMkX^EQ9BUw9ob1iG`c9KV`~*LC+}b(}|Oy!~y0(*aCy|JU79kCjpHx z1X!F1r<~^u$|?%Oo`b!FtRu^iL6;=QX3ukBJ2UvK6dD&fne}AKMz>+e>x&y8ED~|) z*u*?M90yB^bPz2v(v5bw3b|sy@8t>ZVzuCvcfFE3Z@7a`qyx^mz=ey?^2Fm0@zm2# zl0xK~RaQ)dN$JBi)xi|u`kQX%)vx_rg3f&4{qJHrI>I|8s^DGQBvZ^o%Ww$$%aIq| z@p4}9;+Jyj%(Wa}xxo47pW)f3KEbWB0TCYD%xva-m>4kDjyx1d=3g3?!mTg5gIizl zGR~g4k@e9b=gvRDqmO-@%U4bqha5sAgK%ohpV2xf-mZrPYC@b5#HaAXX&$goba!4{GR~Z7QkcStiPw#X4OYi2! z8(+Yg(`Pw3y28bCPxIvCpXBnzD~K_{zJzdi7(MKHxJ}_@>Nu_NR8&5$$}s6~(&&T7b zbDX8KQW}_9Sc||iS`A8+?3K2|iVoy}qcJxGZLN1Pblbl-@VPK=;)s2AkuFiR9l`47 zY}aMBfk4zQQzu}<4|^~6e*q!776O;knsc?veiT;8F(z+pbC!;tIA!gX*$b0TL{CnZ z_E|MDS~bc-$D9Z)834~NvUL;l5O(~aQo?NPGxjExE&Z|OT1XcH=Q=5|q&%oQHNrJ} z!r49HU=Q||uvmaw=0TwInavEY9Rf=ZXN*f?JVOfC64M#xbe0(RiD@JyZ|9vv)EU*8 zm?A0V{ZQ?5)!+yr%P~Vrb`6x}Qn>Bf173RbDQ>;)3^$)X%l`fW>@V{Jya-t`T3Et` zqI(`460%Onxq;2|TRwCC9FIPIkqeI;lP;v3yp7K+p#`=L5?P=uoiKXOau7yuY@q~1 zwn*BN;tV=vP#EUS2nN$?$86_7O-7nZnyAZz(PZhP8Vw*qO3waG9vGCiftnrST3ko5 z_*5dwsS`CdRp*d3{8k}Bi#Dw` zubQZuxtOYVuTjbtm8{fCiYjlj0FY8j?|Rm;3oa>Y-`)$LeHezy4okQjH&W!U8LX-6 zLSuHm#_h!NivdAbD<)c?N&VU)owEac_0<*MKmmW1`E+d)sLY+zVrKeG*Sg_%64Ame zY1b_XwFJH@`wd9sv$iwZI8~i;rN^t(Kr72uB^}@it?KzPqUun|R?zE}BILNg`SJ{>PmWg_iQzW$p zChbCinhO;b;lw-E`=^n;gS?>Cm7y`iYQre4VADpsDX@R@nwxG|vG~MAj-K4W3^Mqf zKIig~$azm12ZAWGhC1LH`~p8{9mGUZJ~&(U{s5%Cfob%pM%-+NE9dj)rwKm_(R)J5 zCrgRBx6lt(U80(SYKlmJ=yNaMxL7isOa#pZ_dW=2PNX5Q^~OjhhYz{vH^e+5vPvhma3Jg9?6` zFKmgOUj)r1&cP0X7?p!^65;=4>(8S#%dWdX@VECl_kQ1dFCsE>Ql_NTkeaL^C8dVc zn6gG&k|kS`N8|}?up76rDFbb~swkj=?nTk8?gn~QHLDAXTC3@*E{1YJ(G125jNRBS z8yjQE8f}d^XGX^G-uu4q-h1}$KlVQ7?E8eg!kHNn?;Gwt_nf`=Z#pBR?hR!5WtWEp zo)_qszlh)Xo!`a3xG~}8V6Q*072SDYV5w9itb&Spv|{}1smJk4|KfiFZEc8_9RaIU zUuR~U9X<&87?}1mzV?|<<7=P!w3`G0X#k#gmGSb+C;0rWeFGPoc?9|~kn1o>6pw%P z_wki4{61)QBeiVJ{U%XosEAE~NxBPj)yw5dPqY&sGOL-opikJj^unW&Cd7&j6+jaO z4Y!4rQ*g~oUTc&}F+*p%)&8+g&~mGG zr^Kcq91?IlTT^(4083Gvsba?+EviUWrPU*vohX{)CD(Z+_1J?{r|{Y}e9??0*Z?%s zo4VyUbJE(pa7VJ#uQ&19@>BzbiwG-uK_Kk3y}Tl~+!{hdJXy7E&Gq^x>Y?SuB^pJo z!lKoihXygMql%!$I!%*jJz`C*tvQ74{k?!B_ejXxzjkyFUDW}RK}B7UDt>=R!ZmP& zyPDH1+I50eGfSjR|EZB0O#LBDSU04DTE<~Dm@5p-q^)<*=!}mbdhkJVal3y;M}bJq zHCjn*FRe{}<@ZpJ+o(X5My;beXEq>#yh$L!nOdgpu-G06Z&q`$Yo59pM899v1W?)a zfEl6*Dm9bWYZkI5NU3<>yVoA8xHGR+Nt~{#AQlXH#CF5T8^SOG!@&0NZeY`c(L4TJ zY_l2w%^A?8-N;1*=X1gS)&iUt42xnAZW_YmbW!_vGIWs5Z8SjvSzx0ua|<}f)Lf_SI{fwC~nqj|Irz0 z8YFevSp@4XqPqdF?FT!+P;#kcJp_ zl(9PnMO3V7%BuDMif*T2D-U@@6pdYC*b*V=?l=H?6ezgbmPTt#w2>-;!HP6v7pgFK z%MhXV08vC${gjD;^v&jlJK{*;dNzS{&?_j`rY@CM(cIY_n$#6~R}a6+$=9GI?9mn7 zc!r`Ga7VX-R+56=uR7C;R}e&KMnbiE=?xh*7{0r~)&turnHq2|fksSqpy6wk9g(Dp z;3cPSsjx(=&r^H;h?MV@G6$1(sX=1h$60l zK<#yOUOQ>m_D*j4p=zrw=%}Oy{+7aR=l#1#j96h4< zvOsjPOuiAAbis01pj_Mq&#&P?NRy3`3FcrYQUEDnHp@g-0+-?dySMqtE4R@mhG{kv zE)ue7a{@Tqly9FDn*tnVYFTni5u8mPWL$t@VQ^7MD(>3rPw3#YymMew2HgY5C@3x< zKNR3lEcPJpVND^MAMWIu{$&j%uX2LKe#WET)Ny(k3Ss{a6 z?{To^(@qeRT5ASR4D}(OkYcGBa9$$YbHXk+(I)aBvDaJFoBE0}`@O2)8zI{^ zqS95zRzNr}rX$Cq&_pPSuyJ%rDLCi1n#!6kvJTSYl`>coL=2j;L2iLiu?C0P&Zt_8 zx-+Gq?-iBTNDK@EVcal=Az>T_q#=8jki)XWVv8vo46MTjl1A`Bjh(Y7&dY++{etCm zLE0-uXFv?3W=cgSnHUHdn0(0RMlD4EnNf5BQ2}Z3tU`d60$m&tELAJ$?&1N-S4Rt5 zQ{(8qxCYUr(gnq@Z)XZ?AWj9NKzL)w-JFkn{jfjq)lr{BA6gY*2thMI*@ zQot%9Y@i5pFqo+zi`d#QinZN=AyBO*1;6I(SBVDN!c@5z4}#; z{Srnd?M|Ta-%*WD(CH4ffUJfvO?w#fH&UevHa($DcY3oI#<5z%Dr;LqK_3{jd5Cn1 zN)PHrE6tu?E2XYBHwcPyZgh>-u5n)^+N{u0Q>fRrtTvWatO+oPxl!S?A~Jz;TJ?$5 z?54VihBo4Ym5HnxmAVmCM6PNgn*xvY8#(bn5IA(va38mqk(Z--Z~>2!Uf ztS=eX>rF2>c2+l0pCq*Az0H%V?yqX_e4P@91HR=WVdZ=$!Hh>CU`lK2Jp|DU;=N*Y zud2{MQP=-U__H802u`KkY^o96`Vc0cgkU_>hZB{yig15h6R6Uzt5(gF21FQreQF(2 zD21l7x}BDAPy5Cz2$O6znlLFt^AT`213Y5L=a5HkL2k@YDiBpn(~Mss2GBf7>N>C7rW|%BSiJ2B7r7tw&kpzzf_FFPg{nt;#>rynvu(qSYf|g zfO&Bmy>E0Rgfy!mH!4u)EEQ4k9>~Nfdx0d=OHwAxg)r5Lu^KgWNWgYX7$Df@!49_l z0b8|3r)nG+3hc!s1cS#QWWnL2Pn`!+6f$aPQEQeGT)Rl@6gb69mVJ2JCE#o}1Bfvz zZp$0&_ln;--Q#gqQ1*l052_5pcu*XvK^B>T?LeSOagrFzDPg}Xz!BlFQS1tUE#n-P z4|zEOIvX0x#hh8wnKe420DI3Y6IgS2_sF<6kNEe`p5cZl#$?6_y9!?nuE|M?lVaiV zg8=hHSO%lo4aEwc!3};=vd9HaiYo&!nG?O~k-QPg+OzN!=Gxc_djd8Luqd<`y}UX< zmarcZ2+12ssuWA7xK-CpL)_H!&dk+2`$JQaBT>S_M&BOEzyh=V*EX=qWcK=13tZYP zNPXa-*d*XGfIDINnzJaL2H~1#7_#et2?+mqFNh} zwoNg46KCtRkPWh1Z-oE`=mkPWpUJhjg!6hW1#7P6Z1nWj*KEe?ORfHoaR?gesy(Lv#(j9fTBLfW4q~!6tJ@=%XHx^aASG=j-iz zwCq5HMif!M7ahxc0C}bTax?-8-);29aBy=#B0?d-;_eCG1k;|#OoJQY6nC8^4!q@LlAzE720skfl6nm~DR5fE%w`fG>>EKcIa2bxX{v+Y zcGKCNv(3ucw7=dI`gf>t9=(WDPYUo_l$NjnsMX*p*M=}-95%o>*n_`yp7Eg85c>2* zQ?}1g08GHLFF4=rG2c1|pBK<#hG-)MqdSZaaHBKkW-!AdP+3s4fczXKHkq2c#+c%$ znr+qh6tetWZ^-JATcC(2uCgmpak@o?7lQvtL;Rx01vNCT`MOG#2LVx%W0I>{ z{Z!+kfEbE4L#$dy64k(a%gL)Rdby#-lyK} zJ6)2ZjtmqI_C9H<$W%2o=@z!N!P6DRpysUfJ|SAEd9g>)QPs9z2})Jc-nvC|9}V|j z+YVoy?F6xfYK@*&)J+27$G!OBfNln-(G~SDV3ti=SOe0%K`Gi1Gij4c@dlc@b|f@x z>P7w)`|X$D-= zBUd=+Hr5HE?z9yK83<^iP;~08G@CANCa~)@wKZldjw{w9-KhCQLvj(EU(wfj4MvrY zVmA7&2C=pyiPWaJ8VV6=RP<_g)2+B`L+Rf^74tIUY&St~?Xf(21DIw|E+7U*C`Mw} z@l=muqxofJWVXghxj3DOK^qHfQ?dL#i=VLPii(0KAKC~z;^SGbT*cdh#K|1kU@o}j z)b(YzCo6C!LfR3MbFbJ1=t&HngjgZO;sNB$*v^D`0wk+tWGw}ABIFG)?igu8a~dm? z3Gs(ZjO7Y&fa%eOL6MWQC6+2BC|J(a&eF?-B2`RpLk?wv-V)@+nxNw?L-vF-Eueu= zvV8_7VBFXNew9Z&Ck^<`TW5GADRyeeQ%-gr1~(_zDq%2*AI5=jyk%^+44D+=bipO( zB;~C&!;2`kTVR<@kCd|0&SrGZqHCxICM-oUj8?%O4++nnPWbBif|3b38^X!vg9pmK z-*_`M76Kg1vqm44WxnM=gR_v2F+Ue)xffSPxW-)r-NWc*hj@?1F=f8Fx z8CQ)MIto!~V)pY^SCRs!0z9L@xg(ujhJuwJKq}qnMPjoS*exwLH>9Q4S|K@9Msctk ztxJQGAFB;#+0R&VWUe-YwFztvro1-5L2x8hT{o~7-9VYO+1GP5{P23nq80ji$9`T9 zp-HCZg4**9TSP<~yocAIbyG;8$+BR1?dWE$huwKdgRYZ7$bLr6p+~B7;npa6^Hr&p z?Y^#1$WB@9Zj#~pX=n%oDT!-C;mzOx>r<-lff8Y1F@&(zGW8mJOoa-AQ&~0YNfJSw$n}G3aflZ;MQ9C=c%$r7{&|maMtd~1|B4q3Z?L5XBG*5l7 z-s%_aZl>ynHLXTRcLVKDSVhydPiH)btv`iT7Mi}kS+ke+4#2{G#L74**M7^P;*bcxj&T3;^wSH~~Og{Y=H%)0bSJmh@ z#LY=4Hqv!7m!@f~A6de;j=~B>^j@{eU}~DZ_O~kv6nX!_U9{!qX=uEpF4Q$PN%4BB zwg#j&U6GexABt9pe?wayXqsWzPO`B(!F?P{=V1 z20HEDDg{I@AhRo{*mdtC>u`leJ?IXieTKBU=86lNyNY6(7@8uzCTtRdu0x8{SY5?H z&>CUul4!ptJ!__Re$mmiP9IeRQhxz;>|Y?b(Bk4XT~kvV_{;20k`fR<4nJMBn-Y&t zv&yE(!&lGLbe#Z7H!wn0 zY*VzUpiF{tP#kW~SZ*$$GC(uTo+(?T1n~%27RWRMNs*l;0LzoGFlDxb+=TAhtQM8U zkVv-Jr%MSqN#0NpW03*p^K81Vz3o9X*l>-qB4z0bOUHn4B4mOv$@P2 z&A@PGOppT#%3|6&$-rr`48+@x2-^j?I}P~qtqETeE9Pu|XlrT6gnR(fq{zfbNs$hW z4Kv1bYmPUYV;uApLs8IVlvM`s>|%PnJlLR_l9}6->XATJD9)ltTXTTR$uw|xZW&*> zG2y0DpI!C?&Q_2tVkSD28spyFS|@v+b2g(BGa^!KY+lifNY0C3WWtzCx2MUGU;;9; zIkl=HJMDKGEzfOSx~WA@=D2%ajYQmScFb0c&&7((0l=mn>Z#HJtr6Z-6O3Y6iAst+ z2#2INu)W4cfD>2}TJ|YjMS39idK%9-?pnzqSyOmSz>%8!?JWgPtGP^{A$Li1FNfR= z!S<3R==AEjQysb~?upIL+;>B+9tYa?h-UVH*dSh@bOjw*C4g{n%#209Vol7^&dTe4 z2nag6x}y>WjSr%VqM@G2cd{&Q*wn||Vfg01Q_Uy*=VBdGWt7zG<#ygy;|cPg?M67g zu~cZY1jxRPNkC6mnmXxydi+)Oz4d%x*DY7M0R;nqR`CQxxHg5k{?k1#*cn$su9K~- zqE#Rog_%G&kmIn|>o1@??bF2?BK&yMO8UL2wW~Oim^cu$R)9svkPgM3za)gASa#u% zea{L5lO~~ZV?}P(i@mXxaPe$_$)F;u+DNo?DzfJx7Jq$CY-|euCuP?Y9$8eAb0R?^ zP$|GXfu{tV5#+33x4VVity|Dr6L|8$P|JQ4e-@}wijA^tMs17&Br!%Ib+-@o&4dbj zqpXcW+N>`^Sf;{|MD>Oc+K2d+nWtDi0Bci6?KQfFeL=%uiV)54(8lnJN>Q!_+p-#_ z6G@ZgwC6&jJG`+)#6xC<`U9iE6tLBS1gI_z9;M2y7Y%z92h_3~M)vVUea87hZ_uCR z+N0PpPnA0A1_|1{2ZQlUg(GWBMI`D~Dyg(_P=zmvdb&sRKz8waS{c6ti&dcO02>@E$6OlH@VTc3%c85 zY<^@d!L?~yMJyE|uaQC)qcpU$=_s3(Z>2@89^uv0SiK1VlMBW}t4EbGKoFL;xpb9a zPwv%~NeZ>bw4-kt^dq`ziyGy!84F2YgXrIwgI z!GM4l(+kS9AU$!0{qNnv;i-dZ9yTr@8T@@0FFjnmlE`w3WG)!0&`XU)AYc?OD{Dg~ zU?D}yipwLg-4KSHakeDfIzJf2?udX1#=aO8Is%g2BxkXvS2kurI2{(`y_g=%%_4|Q z6O^1*$Ah79VAlouC_fF!o*^R415l0>ER0kN7%perI2X+Of(?1- zup>Qss^HtK=q$+$YQ{_$vH}xu|D|K>c8bsK_BcO3PC4DnSm`6 z1|jGqkXfKIaMeOr!He`|--?xOw%|Z+{Oa;~n2_Og4ybNqqS{2JGg92kBjGiB9Sr>gM zl0X=RFc!r)0f!No2RHpAYcexgL77OgBw(KmvCB>~-4ifp`}gCTgP7gmfq;!8lLf9( z5k(QxHP!t(fs8h)mIF6bN}%*%yoh4SUN||sUA_4PfDI9@I5K*!!1V&0B`cy^VJB|b z5zw`&aTFoU-q;oHvoM7@MQXF^^!<>u=?_zLJMJ`3sj?7_5q#nN4|0jtbcW-ZHJ))n zCnq7O9v7OQdjA_TX~nG}#9bR$8^YvP`)wfTpa4lgw!e_H0cDh6bn1OWJ1@-lI1IW= zFzrLrnKph`bIexKa9$Yt&Xv54EjG^YF84|`n^+neoI>4T^=nx(+Cq+{)&VnheZSOe zMTX?}^OPF$jfzIYB8R48Qh}T;o@SCd+%oAy;!Yn`VmCO{Zthca3`tCr=xhrFlN517 zNNWO(EW1G5IL+^S253-l&fuKPU39C!I6yK%X#y{c#c0f4EFKg%S1ji{oSj|A;q(-8 zD&RvhKN{5d33cNyF*$^ob2r54qDeiHqB^)Q=F+_s>#%D`Wr1hTIHKqJIU82lbJSe@ zmEBlI+JIYI{TFy?vW^F99hOoz_^Gu-5F*kAW*f1FO!3~-S1osCNO9zCh2ax??J;pT zud4DW>Rt^^Zr5h=3X8m++~?kFaqBaMXK{It+n^uoQOk&2$_s3f6zwd-GV z?TGn;$L7U}6hi*qnpz?Vj;yWu40Htd_Gq+GkDO4c8If_SK;9^FJ17J_N~Fo(U}3H1 zI*GQ~3D)jT5*q)DQ=Z-&YAehnr~&I{-Ox3S1|@alM1bIJ^F@8q_*Ns!87A>@NK@G?y{?$}rs*#a~wAgdu*Y3q$nb{ZfFcpz{Bv=pR`eUp+IyeLK~ z7%mZ}NuWzX_ROg~2?hpAA)Ja)p-(C$dax!+5-<(GVM932_Wia4FbLuPqhlNngx|P+ zj_a-y+z8B3wLUXMpph`!@dY}l)dzlEkC~yn15U0UL52a#G+{WvGANIX=E}2$#OI_C zA&l8R7Z)I9#mT@pRl%6dZSTdGM?7|G!ZR$UODlGk|KA`W0~^G^dg25|7`CmemG_)#!oE(m?lwy; zs$=2Gn$wlkL2A>t5<`UR63Zd&=xL?=Hfa$nVtjLBe>IT6HH*5Yj<#AUG>bJa)1%|M z18?yU8;o`8P`c^WIXZgU;Cm1om}Dg+?QvcU6-=lx7hMGY2U9^E4!I%Ai~~5_H!ZT9+5#!X&KoE=+xatarBpA5a8@(7#hERI z5o|-7tuIN?4Jrlah|-a|s+X%jPSoOMdIJ-I4r=vHjRmXz2(@}^5?t4Fn(2%N=2eBP zt!^OUT5g)pfObHswyO;oS+M}nwA1zlyyjBrvc6isRHrHBfM@o~xTQEm&<&BXrz>d| z1%twD$b*=>oOV(p1ubB|p4vFobu(;tjR`8!Y5%d0Yu~qD01isNb+CC*X1N-&^Ljf4 zw1FecL4;1L$cVnlN76g>(*&J{xuU4LNP*gc)f-3+IdC=aPy-s&g1$BSe`+)3sHJ~v zz$m(fMg$VUS+q7O+%$Xbic*|mXyZ2vLYzaGb`XVy5@|Y!q#DmH^oOjp=SQ8wN$75+ zE~X8KY-3{kIuUOy>*^Bp_=+~!(O?)8kfL^w)y6##ag=BkNl~?Dt)FSC!%q2Cszyrj zVfseuGa{;08?^4YWM(x!Y3Ja`xuPCW{Y;fRAKh!&Cp`5UM%|*J)U{aYbmnf_QW0!! z2c20~N3N4Li)C6@XQ9e5=Th|RgYKATh%^UeRRY?mwQTeW9l2$;A6zaZZP62=eF9f0 zAFW962C>pVyoy^>wQ59#1oI-S1|-$>Rg`cTj&R7f%ank6*MnWC+Yu2H(#ZzLFT9L_ z70UsbXogC`VQ1mGiP^Lu9^(NRZPo<&Xmk!`({F$*M+mCcL;%=q7@Wj2v@&*wjAy1j z4yp6!)V=z%s)f<(f}#twFftgD0oj{)ZN3cX#+)nFBLFa)*$Nf{4z8s;V&rU;m*d3_ zoSVnMZcI4r1xJ(Ms5(SnVeq*-rxv4iZU#W-f+9vgw7SCGEi*xn2RzOqr*Mwj!}bY!o0Z z7B|C=OtBZ!_C0;C{03Lm>Htft%;6e$)*3?cqSSLCl62>HkTstXA+2tybzq+ZV$ue< z!5F8`?W^IJC-<~QtW5`t?|&`PzMEV$^sC;MMqGbv_w_C!N}(CK{C zYd%{;xWaOK%0WPjDkTO6tZV$<7rsahN87 zZ4=pjUYy+}W>}~02C8HOAvAq)0CcF=SrtT3RYZ4~J?ZD2>bz%Tr&?eSHqfK8u$Xop3=$5eIXB$je8^ey0Xy_A-^~t^AVs5n2 z+MM=0!`g_V{nL=Q)C%cF{Zs0(0u;i-v=kLr`NU*e9pG zVQa%A(q_~GH;15L+;TCV!y+Dd>PY*6@InvpuG3rp^n?Mn-SyJN{#6E((dK#~^2kvX=`_)L z-J$_n1q7<5sSPZpH#RkYkkyT%yc0{ld)8(x71RFGqU}wb)sArhG;2TCxJx@~Lr7GE zsm(x$Lu1=wM=FF@jIOADHcB#NI;FLV40l0$9f>-ESm}CbuITLd1K#MX^kz`VSORu0 z)v2=XD2cG9$o3)f;E$Q^QYaJwUKMwMRS_XxpR=?Ft|2)WdSoVFk3U2eDJ1*4pJ$Qc?PBe zoyBqq>u|N2#rQA-6@_m1SI~1Q>ys+JUTHN9mnvxsH!!lFS|-Tq9>*Xv8%A@}o;q?Z zmjB4Y{ya(_Ge|eZVgXiV)P(|@ykTPmr~VZrCo7g(t$!fh>m@qQSEIVh(D_q@xD<_tUh5TcLr)YI;`^uo7o9* zcl^PHsum%cwte!d;p6Vigx&t&Qi(%}J8L zEt9SWd&k)nMdBr`pY>Mkrd<@6iGxZHyKm8; zEsL+yd3!(XSCjf?ufS^JsB5=^u+ewN-SvI%-@V>jp+HO4wG3Xl=P!j3$qM*iHObmh zfIc9j)zc7BG+7O7I{Mw7b5OHDCPa#FgBb$eS`k5nb=3`E6g?X5RKOE$s9Ge3AF8^^q~|Cci+OvbIu@7 z-o*6uIrirTQWQKeSX{J?!SmrpKnj*JLz7MXLF9Tq!l;5v7_rGGxV|sAHlJZX0J;D) z86}k#D{_u?u0c=p^TVRuup>;)N&!{SCQBd{xqbFxBo$Yxq|DwY+-1Z+g{g5zUc;SK)v z={0;ci@Wy`#sX|-*TZcyXfG)Hf_#~9E(*$wX%NdQ90;Wd#vubEW4B*?CMV!43_V*g zDB;q~$o}1jql9@UkR7nyB$OR+DvIM{YtR5|*lyd5_}q<~ICm%2q>41b5RJvBs|iS> zV&^E%fe6Rh%n!s(W+W;0=Yr(6glX^)_yrh`U=6bX+vEk4XNcw6gtunLsGO+)bntoZ zo`A)THrR}GmTUkphXLl0;MtAj(G%L-o(o%{o_!=G0?eLGIJn->GKv+Y5HgXG)f6on zsz5D#T%CsH%pE3cfQ|^bLX3=rQ!IECipMkIoSb$_MuTK;q=jL*mMdKeT7Y~m@FLmV zQ%l&3imnksMIQ=A@(xm?eYlGm1A-T6!bZ>7nj2 zN=_#g4Z}S3Xo|qUw2NJ57dDs}(DE!L3@#}YwN=Zm=$V> zB$!!S4x1>Dd(^KrPA244ppnbvs zV+#zNkUfO}%LFNloh?M(5W<>5sGHX;&@x+I$5epH?iD$jtm3AE!QIoYwKT~Pc~dVf zcbgmUmldJc;Vr>zDS4TX!Q7p<|2H8i>rNNeDz2aq$^vId)WuWJ_B zi~i=SM$KNQaeM1)N{g|eZpu=d5r1zYa+jyt%&}7pYtUwB*0noeA%xq@>T{ZwMOsru z!D5!yO-w7NqXL0i{6Oz}WPPncxX{yqf-_4Xw>DV1+Z%PdXw}q_qhT6!p!K_d!?n}( z!K+o5xjOhd;@2Z0dXw3kH#?5D{EhW^|@}EK@F~;^cU1jw^kjK&E=H$XbELD{kqOkT*aM<^uU_KGLhEc*qd=CVqnNQ+_;(_k)Q z+P|_`@is#-ZEP)U7`P${CyU}!&tAvltT^}te8W~G4jzTYlbA)jJ71Q?C{N>t3`LvG zl_X`c=-6C6S_I=ZV=jc4Lpr;gTQKfxN|1%f9<@E8+rk+v+uHWbQe&XHy5Xk*ip zaW{C$)yJUG?X?ZVplbt=igZ-;3cAjY3&w-1CX@oQSi;{cz&B6^TQL@Uj+)!(TUQF% zX`QaxeWFSF`I5A=Sj@D7+VI;DMw{H{#dNVEj&^vo5otaCW6oR7yl$;N~xCdPTS?PhBe^4maq$`cY#hGd0VRS`8vx zBPi4jW?XpWI$3eU9rDX?9tM?f&_XmsF^qe|}HDgoJS#2FvJ zaJcUU!PP%VM`rO}sE`|5k!8F}@RM-bC^WbClVC^$7&1?xZZhP!IKr-8he`u{G8hRA zXhtc7xfCp=K#O=b;EbdTcsGG=6)dL{rqexc-nxmy&2yaJIK!={_Bh-GXkm*Baq~md zFU&xhE!&p>W=2Yc%+@fH3RDDCCg?N+6Kry{m?2YT1J%Y{Gr`{speNx=y4(qwbsiO zeCyM)W-+2QytT(}w822Fj~iRDXCe}Uw}!t5H6~VfL&W8(pQ864qwap(7-UzBFw)h&Odik(L(_E~dU%g1H7o zw2FFxZkMTc_5RoBj^aZ0uV zQ+4e)s=;k7qF$8-fp!C<9oD{FRRrx5o0yE1eM)5TsqP}5je z2heDNRB5CUPVGaKXhpqta*}o;#mRJc^o(d$%`|LzkyIxs7be??@3qGD>=|HxW_m-? zY7DLerO+6z#xJW|)SF15hAK*RE^rzx*N0uO%AJatp$M+EjSfn>dZr?+cZFa#+RVV0-5TdUCDK5{&?5 z1#j65Gveghn2ByW#vy#U~5DYOQRvf{uXI)iAOcMnGPDn92)fUM$ ztd1V38gip#*=Iu{FpD=#gsq2)pQ|@ozKoN@!8LoFgX>3aid;H~8J3MXxo3nSi1uB! z-W4Tp0;G`Vuk`_DrO6es;*CIHHmA{JFtR3`3h)F3&pJXVL3dDHH8sw?Bs7Jde@Wb} zLQ`k}O9%YAH<(jKTS0F9aV@305qmW03j0d4Lhw7b)MuT8+i3i_7l}tc#BZ*l?L6uz z!@3*w!D==1sU=7DJ!$EK_)6F0+GJE?p6JNx>!Sw1=b+KIVS_gFq^ifONRtHGZT+86 za2WOXP1<9tR!*UQe@si~jWMcuOwZ}9G-dXNlw3C&k4j%r#eE@I8Ur-4*qXC{-7_R4FE|8!-51& zR;9m3iD+<1s`=cSS~cD59UF5_SG7?ls&r2Vb8#NIg!~z{8(*6&xo{P0hm6W=uOp30 zLFr~09pVZoBn6r!$v43590(&lQX=(6GCF)#!RHD=q=rgXF+uxpZwQGPiFz<Dq8dP-&EXP$Da8Ecb#SOwp>@fQBYe zeW6I89arIWH9C@@VQoD2IJGk7!x0v`y&jg0Y_!B-2E1x3UHY%@T}xOEUru2tj3 zzQ_!PCP8Atgb9a*aKhrdlGvav6XqG_7&3Le!XeP*MIE&%U6kGsmrr;kN3WXmpuDh5hMm1PEQ6l+c{0ec402_T7ZIw>v_ zuuXz=Bf^DG4zDM1&#*1I(vkUj)YqxK&x^ zgCcEBLkO~_TepO%C{h;74od<|HDKEc;@Kk}ssktmeU!i&VTl?XGNfsbCN0Af$U8Hw zb#M_`qtu;ki`oDp<_-@;xI&6Mz}SHClrDINfCC3Tn>HVYHfR@gZD47QLlygZ6A_WR zP;52x7W7;|z^IJkN1=m|_2s(1h(GF!^g;FD#a4BvEdH4yWwq`INjjQI+^q@fUlR8H zuYUKHOP#iTt=A>~FR5m(qIF>3NQR=;^!EnWB^F{oFYb9&8)qtL4vy7qg-BaYW~o`B zeOqlsuZFF2pmlE>XQLD}q3Y&#tFO)%D775?-K4))EAic6CWQf>60m@Ktim_2s}PWs z+OT$Lv+ms}3`)hcvR-F3J(+(QQEfxqmSpJKP$u@ZSUeaU4K=LasUg`_?-jln1(ey= zn(blYMGuQuGtadyW)Qi>FIPRiG?SjHL$2NqMFoo#EMlfw5={1(8JRLNC9oUg&C7!G z=^Ura4p$BvjAt1nHfdaLOt^k_15e+)iSug{^qB*uXZF}Vy`W6lT&W%XGd_JW1duEm zBPYVZibMs>_WN2E=rRL`89MnnQ>|>BGKy6r6hrT*HSN{5mNd06PznY{twN?sjqD@l z&N`qFL{A~dyc0=VQ%d3Ys+5Xq%|NRujrxGG{yTAX@%4IJt8Q7pf#ujdL^L>vw%V-* zV|EdcHgcD=S_w>`BIrV(Fw_dYLzGWN5Uf^`Ia3CUvFjP^7VER~$E6jCtb`=gy2|cC zs@>61Indr*E2ZluVFisgV-)IiQy0@WK#k(;FF1a!oSxiu$b;mSESICXi6&ija_W;M zX_wANnIr*#RKyy%AO&#$El@IJPGU7dDFJn&YMMj6VX72U zk=_tir^;&CUs1wtSQ5=tboJ;)%5$6q)!kCK7D$~YP#bsRwGOW7975xOz~8U*R0^{4 zKJm1cxE63kofcY8ETLFMbTmx-!g32R?Fe{_Z6E@>J(<>A!A4T4Q(9U%>Z0cNQ7~`{ zCwt5U>@-(&^PNBouCLpK-YQtTf1!z(6@BeDgixjZy;?X?bq$lXnNf`>vHd`r+pL}4 zsXKx-nuurqxDa2o8|U;4kF=WDtMW>i-KYB<^X=2KsKzvh6&)CoGxT@?KW8y(`SXJL z%L?72xqKO%VSb&4*vu$pK|(^th@2QI3wZG-#vPnV1z89=D>ef#9uvl6KsQ#IPsMa- z7&3NXoJ~6<0geIi9^gaQ22-*OJt77TcBm!-CM_rKKO!h~fh;8`&r6qE@i1K0v*MR9#G z`k4rDWnj#u;AycKiY$szf#bzoQIi+@!-j$L1k43#r$`&%oZ(rAHsodn)HCQb8;vjd zz-=I4yBK|MfMQI9%K*-1?R4vnnYtx*HcL`SR_q60VAE>Kte6szMz0MSm>EXjb;g$0 zAlSnqAV&1)hb-2B%~2i^nz5qRY^Lny4gSS6p$%XweUaVLlVL-EQGqL9TtUVxz%?zn z<%TrC#i3W2>tr-z4b_eoQtA$z6*1$$L|V~5wMSdjZFWhGHQ8b=k`F4o(;#_vAY7MR zhuZ!c+8dZc!Sz!+Le$t!O&-znQ^nnMtMQGYCKSwZf}3;`%!NUubQz2~YD&}%U)oXJ zG7tN;5jTEG{@ql9JABhZ8eP@l=fHUE!P4tu@A%BGLBil)^pMY_8<#J;Ea@mDJCTDug)WuvVIDXNg-8hJ6QsA7O3K{P{= zJwk;WXRkFfZOsrw78?|5!J-9Abpv;XS7JuuzQ2hqILwOk{eT;XJuV*(xXgrnP%P69 zx6aS-^sQ&{#FNir_n2V30qE(1<&ZIGvMgK?kWC&;BTLRiVZuOy%x1h*8$!%8WLkhp zKnpoK=xCX^UqyA!kMU#`bQ+)v004jhNkliheN*NZDzmNp$Ou_N0e9^+=xfW~zsIMufbR&2cz)J^I7M5Z#ONOgrG zw;@}Ti*;wx+T>PUV~RCweGVufnG``CU8O`Q2$_(YE~3@J!VR$I+ByaJqv`zWS5#>m zRh_zX(;>OpN0{8zw`bw@@Kzm})w?Dj?Twiine4F!HKVP5A+}3F{sIjFTV)1Pb8)n< z!WSf0eu0_WI?>R`)rN|=YLC#HLFyk~>L%Ri2tCBU1EswQ>vk}e11)_V*AO0U8ia~1 zwv2V(`ghVMWv*RhLMqkgacaVY5u~oEK=rhb z7qb?%tzQamS{k&7ebUy2-MVT5gG*~@tc_9;ypNPxgo-p9X$^m;{>9V{3w%ybZ3;o_ zU=c4U1oda6=?1mlqiQp+Mg@*e5e?_ofd0B})Yg}@=YupJNkP+47Z5WrW}wW_Q^7nf zFbvHKX=O%X#iA38{8#tEj3SGj(%FnvlDmP`b;L=L(t_bcQF6gDDsr}ht`x$|jGYj! z?GHFR2!=g@6I%=nlNAPPXx3KAqY4x<}z0lDY0etjbfJla-2z?v`98!m=Y|VGLPJ@0AsNnXn{_ix{#Qy3k^g7?Q9?NCcRm*b!mt z)G|_Q3Kw2eDr*NJtj(QMd{9@iX+^ox(TFS$Zh&Q6s-3c1GRN90NXWu?R%SdaV(4o` zxTw<~C7#KyzYPXdC&Ld|a?l|4fA$P|Pn!Mr#ZfkG?>RI>wIp zs27b)0cq-0oVbpAY2|^vZmwrdy>7|&l!y{YZBhc;Y{m2m6w&}>wnCaB{Z6Wxk*-qi zn;|8~YtUmKDn&LcuvNmSY}9J9vtv=g1bYq^>4QLuXC?IxRsbaFOsFawNK}zbF={yn zxTQWv&B2#ib6Kb$htocRDnL~gH#ShIbmD>rBZ}+RirV1ETy|Yo>Wxp$Y&ZI3f=B{* z@F6p!5Lq+qOeu+Ol46e3h7cM`xOjAvt^3rH1QJ=ijtyND%PctC?QrA#CbpR|>x6+6 z(|nGbr_bV-0*P5gT zJTY`--&h+sCI)%4OfgyyLSD6MV$-OOavT}zvBUY(fxb0l@>?b=qYy+yMr?DfOS z!5JzVKWANp-SQo5C13%S7@JTVN_H`(oDaomhdE^=FLA zLGk8{R`)2V(8Bkk&X0vnVv<&iUTT!g;N;O=LL=f-CuZncv<@OtYdWMA(hlKraQ>v= z#o=6%Zo*>-k5JH4`sb4iEeSPU6*t2aa)GL>sCI6gQ-9A#o9zLLG|yV?2Yz+Wc%hEa zpzFh^QR}4BWCQK6}>N9MX=(Aui^ zqNWecd9wYzI8M}RmK2dVX^plx{V+bb-8HIDX9IaBY&v!#G@ar~D_QSzNAfh#2Wqob zTcH|TvN8v18xpl3=GOd?He(e&LnJivL=j}DyG;V( z)9BZmHEh@v%x$z2qAM*vsR`|m7Qy_?0=|9|oF_wmR4_TEhDee8KGgyhyg*U{5`!f{ z3t6;Ielk?E~#3ubfD zn+;JI2E|D--P$fI&J(aLis6QW&IH&h=&Ch5lMS+=*_=0zve6{(8IEyW27Lb7DZaWC z?AZ$LK@GLa-WYBGBoWI#)QmLvu;9GZgmrA3_>h!vtb}P+oK1F0=K`cNbLc$C1Re-G zCfr&SsQ}vrI5}Y~b3w|$K?%EAk+-(4uH=M!h7q4S-{U}CGnG^^C}ATEnyffY1=tK5 zEUKWz_T3Q$+agF?07r^51s1ZV8QGc$RYyjXVDO^koE0}p0kR{4YQgq}t@cY3P$t31 zig6~$K`~z@&?QF%50z5q#dESOKlaIgc0FWKYYZot_A{e9If~Op6YRCvi_wLg9;g-F zaP6F%UmRdw5G5%%5mIv0mx0?7a9Pc);#w)VrPf5P9#QHBk1JB{g?gcAjWsr6F|AwPw&@@|QZ|#-THc zUIqel_XJFH=4lwcK-Fr*(y4JZrb3ek%rjw1fht_jSMCOVv6dkJj?`$PT`T~ni)sQW zX)}|_==!&W9`LTgO|*h1C78@4V4Xu zN-QK;6i$ikg%?-mkROO%ns#0X^}%1$m2BmB)*qZLy+NP zPYLu2R?}<(MIfyyv<7-n zanmKwolV^GRyh^Rv{l7Y6o=h}TQ_eav*567Fi^oV?{RkPS=@a342NeDaBGB!)d)!y zDFcb5G4T@W^J@J7Q`M*ylb6g3crKvHy87CrYpvBPx~E;H)l_d9*h&G(Ys1}u;A>#i zAq3kuMv?U4z61cFEf+-7mO$F7aTQ{9H${GQ)e{SQR&Y%&=!7+DrY?=%WNWNaH>Ap* zB$x$C=Ozm*iprf~Yx7KTC|I?GVK_$ICp=ZU#NO95Aj7XYyQfKI7iHVHlZ$H6gzFUC z7+XSvf63GW(Pf1$bgR|g<#W(~wf(=+%czs!bk);w%W#X6M-2unm1f#faH+>w5O)GY z2b0(u$a-=_PD@2OP#eEsh*LFlZ8XabnW`VSxgE8OL>;cBu;i%g$GVdzceE=M{0$v+ z`e418YZ{FPlNxrEF*Gt^kyq}u#&L_IXx(m?x(uR%hZ^te#ZhppoL9xT#!Z;QRE9c* zv(XiQq283X&0oUj4~S#q^LCWbQzY7kPZdRU0Z*f^ z5{Io(*5c5BCQwiea?pyx2Oz=IwLdG4T-zKGhADw=S#h3E2%F6@cBki{S-{zD({Ld0 z4A7|9YJwaJZa)W(l&~E#%8l8!?v0@-vLT!UxU|@rHJvVY*GIxN0d^hx9%yiX8(y(Dr(r&dQk_i6bc+aua`8q(RL!KK7Jk|dO%MtqLPh-o4c!}Dbz_oh zjFSAts;eYIq7$<<+ZF;{9bSVQX$lUcKJ1tzYX7SK(}&i{OnKPF_9Wh%%EkSt%0_Ib znUf*JlC%fASBbP2b8U=F)r6-9xVOysiezPnV{`xf6`iY1YVv>1QRCDRzEQKTN6XCaUYFwQ#3}5-1h7BH+J3gy#nm-bgOg~p`jy^X zHb1;7hx7Fj15c^ux=^Qks#7QoIqx0~l?L9p>@9Z7Yklp_?y5IfmH54nftvtziB;^( zI@pyHCygGm5otomTX$r+Ug#x!uo5*iq#9gRukfCI4$Wvvg zOS4q1n9V^dZkSy!%W@Y&EvJMachC^~+wokBa^xW7jYAlGm(HH%_z14y~XYx+9! z#*M;ja!*Q&D&#<@#LCf(0}>RGie@D_<6B4Yci~(51Wr-T@RY?jXO0oveKnfb9RvW9jmB27&LWLgwCIeGc*rs=>+fnBFdr13zIF?rp9Q;Q2oOVK&+&$QrFAf+4%94?AUy%~h5J&6TpA2YC?;M{ayl(3+G{J;KAO zYr7dZR5`x_2U46nWpoR|I4kmOu_k9*(R9IoU_u^x$vH*WRniqtcCWh7W5-%~~ zk}}Q<@U=zo1ObPJqIuYN%(nAymB<>0qE6GyjUnzP6^_&gicoV`4TJSyU~KQO<>)Vrq;FN~CG4y@O5-Vjz3oSL;*YdzIiR#metZyLNAtY8BZAuG9q zYj2z@Yo~ZKSkcZF=Tu_xwI$rmokddSaw*%0azOs`q4}nzv|3EOV_>O`jP}WGZrYfzZ?_vx_>t5XJ^s z0PGYv6gEU(67rJ47y#PhkT#f*AvE|)S`3qDfl7gRFnv+M?7!;#*c^h*OMsGg!x!|t zOf8COFSw;U9CmwTOu$@lcvdjo*n%cT5^LHs0nCC#He6v=B(?pVwN8NyBGyuyL3f)~ zXN7S^R=W(UNov}$EUP`pbeX}+AvD*`>E8$bwVu!xcSj*NTAEI^o}1wHXuRDraq}y5 zntv-#s2g5tt0haX<;e7sz4?vCF%(z@+%|`bc8VIU!xeNk;Eg7JA(K#B>b2=g>j1nx z4Z3DAuy2-BDY~uXX~b}&O_L&9BPd}CZmWtsSdkm`$tE~l3(EF?Y#D7z02L$+?vxbJ zp9>eVArULB9eN|z`ZGff4Gi?gg7_j_)levM%@=C%TeHfzQz1JF$YDe1n{92Un^RFk z54(F~YiQi)rWLzxIAfZD)RfqbimFDhY}C$xA<3#u!m7z7L~2eqdg)Y2H>%JQnnW}N zthsPOjo;idZuG);vU``%DU#x!MK55!R7)+yh|D|FA?#K zN=9cY%UWc}wXqGzUzk*pQ^V>Mt)ht)`Q_jOr1klT*CpgOMOV2vY-qYX{|wR`*x*i} z=;C&#uQYXD&D^RjcHP99@t&-ow31kxIen6l*lva6qVoPb^XW zR#iXP{a5KCnjKsex~WbWa!JoQ6#zGG-oW{jj{x}^@ci3w^1Neg@7{nn)}W~zus=P; zvtPf7n>Px0Vygrh z2s&E8IaF~QXB=t5?>un}zwgM~W=4yEg3}|l7(m624ySI*(aD= zbEg@IFdP8g44BG-O#z0PkjD`-70gS)Ne0qRAzQ}jvEo^=+{0lubS;y8-)UByY=Aq{ z29GRfm|+O!pw`3=Ob`p&0}HT}1yI3~7vRVmj$8;j3y>3rB|)z(*z5(Hfw4HGMwd;e zS(1I%(dTZ90_WZYrDWBW6sK=`BZDJvl+JumF$3csSVq_Rsnd7aGS;$ooy{#r^hWMY z#_T9oSq$n?Z-7VFK3QB{AHW=_k7aYEUj`{|rIv0IaLmAMYW(JB<^@lR;EXKxLwy2H zL2Fe9dWO{bd%NDTRGkb1l#Iqy4M|x0Sy(gvxFUdkcH3%1QXtKSZfDiwwrc=$>h*HQR>>vZ8PZ-gKdKI1W z*-)aYr}du^wH(d5l?{F$k^I?WNAat~N1Ga_X9;SvR9H3C_53J)hUWlDlEa8~Xpl;G zJ{9fGu8FLPi9xCtmt5W$IM4*+2lbV-c;9D9pOU+4JYG+FwC%7<5v}&rZC+_tEQ8iDo1Ag|s;j{oW6GpI6zLU`p z3S|@@PazoG!Rfh01hWVhvBt23vZg*eOw#m>L_MT}-3X~n2OOpYX6(Uw0L=+ zy7a829k?Hasszc1Qzab?U`H1vVo4QHs9mWqG;suyg2YJ>hC&54Z!FIdeO(E0#POQ*id*=2ud!GBd{*U z4{pU&U(gh$>r^SGH88%G>Y>?bqa=iz*>qMKI@L%m_QS zP-@o5D>T5-L2aO0)vi@xC^a;~s2#L&Ce=V`j1Gx*Cz#wOLVHZ2?NFDAUUPrZql&@%LBj$YXbi3#T$6cwxaC z0t$59+VEh*D|O@kTuA)z8$JAnmaSkr@vn{L&ob{aC4JC1+{pM#PI zU`xmYfl>Yz0HX3merc6N)HQ z7o^Js+*F89m6t^!xrTLHdA->)#-fm6!FZCenF?eA<_&>2=FT}U);J9yq+&=_f+1^n zIS=zjnc5U~EIn(G2j30YG)>qqPNOaW7@KheNrYib$jB%=MPAGtNI^KFf>abdlIid2 zbFu)-V3YMCz-Az$gaTMHFdu*+0eP^ZT40E0Vn&(-^G9Ke~_I9zRux2ZkWKB}mZv3KZ2%;o21j=FXk7U%*oK1gtg&3EVahMg4&4TNN zFpKFVDJy8Oby5iJp4LHN&7oro8mwZCFWljey-~>3gd{YHH9n)B*%hFuQ^uqK&2Y_^ zp)ur15TZQiVbrWJp1@lj^gH_}S`Z)kWDH`;Nw zB2ZmRy=m-(pmr^qAq;gR90`YpcoQ|jkxHlMX6oom@Zf7m;VO{cX|tt*GirOttQ3^k zofcV*vuh(n;)95aHr8^*nFJ{`y2(wp49T$Psc^x}Vhz2TuCN)(XmCW;8k5#hm>RuN z2fBv38sfMlHQIS2XVnkh3+iBw+V1n>O|7xYs*QxM*mG6vlr(yI1FIuS`)gMh;DZ1+ zi+~ovh6O`m%u51Oa!sW%m1?YkQ7c^%BQ?XZppdvnf_d?0($);F-5Au39DVG&6lj@& zc>>Q0ng}?{;3=7AJ}HK3d{z-fLBy6LsntNL=?g2O z-;HJ>UvyO+hUYYB(t2I11Zo}+SPg?$wQn&*P?=WD16_%%tRd@x@V)jH7l|g}p4Gkb zwbKyK$9?e404*B)PO6TO!bV{e6&u`C1d+N%vQf2YrL=^DPDJ5aYZnc1yq+5Ea(Vu>Q1DfYMIL`ja@6e`@9C< zpsVx^u!VA7Fn>X4oPi7R=3Zq>rTl6iy|srxsJVhxw2pm)>B+*?ZIt`>_4`$Ad5y1J z+k>EltBaAO6B3;3+#0x+1yq|N@%ORO-?|a&CMpDtPCi`}Tdjfv>LR?RGFr9=Zg*j>S0>E3i1wKtMDMfE~J+BCkK`BY?8Lvs}OZw-b%RntmQ zgsswroV7TIbq1j#*GdNSQj_RaZ3c+AYCDBk2jFJC+M>Z+#He4w3#84QuqDEV0Ny4*3HzmB*#TJ0b-22gWdic0WK>`O zrfE@ZXG51{0xpe=Gk3CElE+CD;8M!SW5Oe+Grm-c1=kCZX3HNO4*qDcVg>;lU{4Af z75RJtO%7SO1BD!B@W}uf2|T%jp^)k726rbtW~2$oU$`$OQY%=G zfE^SA`@Tks+jGYAk52Hr&)mW_QKV!|OLA(d6m92DNd?2!9*9Bd{;U))(6(;uBT|Fy2@3-=TQEArsGC(6lu|dxvFJ9%LDqGgXT(YHpa7fmP)k9EN|*WnO#Y2CzEHZH>W)IF7Cej4d<~VIp8+ z)5l6UOCw=R8bCqK<+e=#*$2|i$yHEDJ?B#zg*AnSt@ejC2e+0Vi#z((+OlO;YQ3Hj zA=Fi~qV2Of0t#E>;^*R`gfsDdrW9<7?dR-gxo|+CRiG*mEht)0VEKe5H)DSkxQ#Na zd`+piFM>CNHA+XtOiU&L9T+kt(0&8jkD$WMIL2N_k=$s9+014L1*D5Pk&3}v_6*uN z2?3~d(-c~w`qCiTb41X- zb92HE0voC>>$Ofa;VG1*GbE~1iMud}0x$;ZrZmoB?E8*iD=OM!)1>xD+JFzco)WH$ zu6gz7--o^dQEbi#fskk*M<%NIF49I{><}kWrH4vTk@axIiUe8{UObBftJ~dLLFxru zgR?!`(CnS-?}xBPpUi+A?W?E;sTcWmIwX!rRdA5H2%&v$n}@XkdPZ9$jgr?8#26>Q zoqiCY>dt`I<0WKsPl~y6)LTPAAmyWLrDB6Z!4I?P0ISeitvz5z1&dT6YJbgk zJ!=#K5S&nzkuYKD8+}LfL_3Pp=MMhBId`Z{>l`X#rN)D{#zJG4i)NJL;qyej zQ9;uVG>ow^s@sDZFl7zKH@2@xcN>fCp!T=d*c?(vf}(j#9f&Zx_MqiH1_CJgCfcZ! z>_$iR`Dj3-LRdN_CWvXcqPW#qpjonOA4)hszv^(i3Xt1igadh^RK&Qs-ch3-$%W=P zHih+hlxl@d!JH@J`Hj}5ZH=@?zuIo24KN9h3{^MeU<&c;sni zYSr#>ZS<(lceQcpeP+yc8Eo(pF1Ig6G1NxkR!p875me@ zxxfvALn0iqIrSe9oxZ#Ng zgrfo#_14sEMy0ATrxrC*yT9s<;J~k$%W!?~&h4-99@XhK0YNGd-P60~o4u-KphX@e zjn!gr=Bl9%1)A`vY}EH!!$2|nx?EJ73w%BFD?5g@8^rV>y4MNr)GA3VdL@bdf>9VH zRn2A9-}N&?(48GQfKf|Zhy5NTH(jX_DyjZ+OTBT1-lGFn6tCl*&|T z9eiNR2#&QB!7J%9AFm~tx&)=E0KHym08n%GmEf=91E~NsR5yJJ)XlXlr9R9W7-HQ( zulT*HW;3;piIG^UwH@&KPy6e4^BP*od#YHC5L`&>cO?PX*mT(%B}0LT#Uc@)jrT!) zOa#)@r%GB8I_gLxk~8Yjv|wEURyWCR_#Y`-6eQ`y-iUeg7vljaV)5kh4Z(`6up@*TaLd^X&RRf?^CmN-pfQAxqLxt-#5Yi_4ltvAt zwdqcE!qOl?(>@95(<5#?=o%TKZdg&bZT8nD5?{d8yhPd#X9c(fXGRGIt=y@A)VnAm zZVee#YDJX5QWqK5!;_m~OMT5?#apQ#Vh0?%D_TQ@+M3e~4w|~+YE+SJG$FOmuokze z((32iep30I+BX=Zgi34fyZ&!!E1kpohz(>z!$O<~MW<8ev{ecXRaZ?ijcU~u64ecw zR^kDpF^D%e)mTYGv#e&7UMJY7lpkqRG!0>{t-&r51}ECCkJ*h&i_TD|u1a$r?OZIf zN5T=q;7%-Sqo3G>N#zDKTe3P$)b^}Ytsk`lm)0Ir6!InOCaj&VuAS5BW=!={^f-#> zSZe623FXLLzc`u)p;{n%)2dxVT(4{`f@wL!-Wg7aK(ki|4$j`COC5oAG8 zbD5(&fWgQ!jEBX3jAg?WWh~HuVOWk9bGJJX z(#B{tM;qWW6UK#bR~~S4TJVK)!Q<{-pBKe2TTwU634BYD7OS%Ix#Ad#)6Ih2F(3nB zEGDs)z!4RzJGGVA0 zZ(>d2HW6-518&PB{_WW_cort?OU0Xt1eAd=XJAJHo|9>^2Ze56{5v(&FAISu#yrp1 z91oZlML8&t5_nO}i=qr_l+a8-w*F{#>B7li1G^_D!8rkAB5b$Tq)iH>!L(*uFWS>F zP{5#(uq%SYWZw^iqjJ^u+^6=egj5JyA#70_3c-}jp>-yOP5@>@WVZ##1>i*36XD>8 zx`b+2xyCD4rF+DLtFWT+iTQxXM6gpbooJ~tt8kW((@EKB?rb_r@*Ko^a3+{JM-nUJ zsu7CitCiODR2@w6=P8kuzl*5pE`y?iDwW+)Np?dMExj?3I8=0AYNZCYrjV-Zs8h_? z^OQO8e#9=E4RM0IXmB{u)bE#IJqu-B8=R$DP}jXuI&x^&lKlPaJ?qkplB%phS45kd zPg%$9(l+_vl3vHa6)_WP^w>u0t7kyVKXgY!FC%htvK{&FX`M&gwQDGw58wt6vL-_c zeVDN@Fr(9?+h?l)1T|ZX#`auHv;TlOBO7RL* zsh$+1jgHoUfa=y;>E6}lw0b5OD^MCE(~!c8?w0|YB=6w6OQD;yXz2^O7WfkRV;aPu ztKAyS+NEB+n)wnapUr8Ax)!m?u8e8eo0l-vqt--G;E_|$BnqfwD>kWf^xNQ~ z{cOiwB%qK8=Jpk#tk+AhHgt)UQl+4{ZWLV(4?@?rQMhi^+(sH?p@DMQh3gH?QSt)T zo#C2+3U{Fa`zWrST0v78Vfbn?R9yJlBRfLF7o1&JTyW~nsDwW0Kr@`_l)truQ^%+~ zyVEz>`VJD{efXhNNi}*w;Tgi%amO%SdW zoJFO(i)uvKv>o&+wpNPwAthVjaRTIskQP8^L0%Gu5y)FX(FOAi z&}dXm^(?cjfEGd?t;j#7gnN#TapTs6FP#@Wk;wA(CPM=T0WL{Gng(m!s*5Ds{!~sE zqykJQhRhvK2zgY{4Dd#w17Ujt7wkRyT&j8d%N%?lxALu0ux z5+$Fe1G4jbdy=rw>{E5Zya)D!9o|ziPT2y*M2bx!9A&~6&J+i#S{!QtOSWFO6kwO^ zc^yPC1K4h@cs)Niitbh{G@JeTn-j221j)9M%3_fsl^Q5y?z5<<=xnZ={8t9cP> zRA`L@Awr{Esn(EX&-g4JB0$|4IDsmvlSyliQW$QDIx<|!EPXI-IdtH==ZrvI+7vI;%A09vO#{I zmuj2OokC{r={=0So;mScLv^*L$dqvt9ql?q1y-4j6884$VPH&@PE7*=l-*XpTJ|@W zZZbzprB*5uV9^UQW2u4d9wb@wilZc>QAZsdh-O5UeNu^4Rq8_3G4x{ZQ5h%!kYixg zz)NfV(EK!-ghlIm^CG|M(6uvd*k6=eXBo}^>O65qkr^m^FdaaAuzf!GL{tfesGx}Z zNYtr8?~+%|Z9PY!;!d6bVTQ^CU1lT!NElQSSS=}XV73?>02viX5D+&P6pM}V^ECND zr)E^P>4WO3er)EAdQp}`Sdo=N^Qd9a-!*^HS0k7z#)(Yu0O*ZUZPv800<|_|0hl0; zVlQnqE=h-wyJ@CRuDCXkUKeY3(eKnJfV9#9uu5l8uQ|A8HmakL&?dVYv|2kE%v$+`_~*?|2vu4Izxhn+DExfx5KijSE(<4kXJNVWT;-Ep&O*eZmtq1kR3h4t_uT?>J+e%3>0)>acyd{FyxiNxO;z#f2j zFMiPIfEo(+>UL_JZ|#|hs=-k$1fE_n25QJ&MRREl-6J%>)seG?3q#GRtzB4eoNDX| z)kEAVvwb2(ZJKA+#_)&MUnU`Jb{Z(&?QNR-R7F#pKa$|W_oJ@Q&^Vdy1~N4ZX$_-B z6C7<$q2zRyW|mZW?joTHgj39=4JYb%)ao1&CJ06YmQ{QO)n-y1`EIt*{@t0e8Z1)a z@@V&4wY|o!A(&T^LQ;WhanZUq`geU^xLpuwg6;YlY(4hCS`uo;LzQMiBO%?J!FQb? zBjacm(-s~QXvvVBLiY-uGM0HUcg_t%Q_nRbB;*1VwQQ<$0`_2}l2AxNgP_b}Q}@NM z=|DILu3uD<8NLDPzjD-kGQ7oj`jJ8)@O#|lLjNjeuaMR5%XmKMFC16&hQv#hUXiK0Y zwxTD&TwVnjkbnb2*pZ-FF-bu_-asx1_Pf#$Z2_R0Y#EVm?gIucZxgQX1!r!6!ekU) zSv-a!QO|^P%`f{|b#U9vQOwZO+n5 zH5e2X*Ix=1VbDN)NtB(la(=l=N{ z3Y84mi~2Qbh(z)xr+9Hk-ET`B1%;c%kh^`tOofcZ*C|7~svpqlkw8bAd{0U2w(}_r ztUW7^slFe3abBCI@IGE>wmG&_SQjEB?t53|NvP9zv(#MN>X||QJ?eRfR!CPil6W2_ zyM`6Ph_C+q#_9G+6Ij{rDZ8PTViI*dYInYAvCtItmD+}`6taFv2uRidu|ESv9QBlr zek!UXaySPac`sh$wT$t8boMy5+UU53mBo>108FVxNm220JfX=yR5~hMYr~>~RCWMw zp}I$r9k7t+gVy{Oc3q(&XnEQ>73&$UO?PvB(8k(QEMSi>Vj-|5KnJiSWMX8Pu}oG1 zVF9x-rHBfM7Bf3jfGLAekewB%bx7KpX=$k1%7n9aaY3@t8Xfc@YF)oAsx0;Z&~;@= z5uy)&7MjjgFoa4UIMnG2Bn-yay=RL#S07MvkWIN~ZIz>lcqvl%w5l-_pA0s#m$aco z%VKm^CaJivult>n3bNOUl}X6XKCD{H>fFre3=0Z|7#88N&e5jU*b34Qz4mQ?o-18L z#LN_2_eH{XaA}=<`@c6sjqZxb-f^(QpA|c!U?##o>7t4ldNW0o98PDD`$5;-7yEB( z^rGRYS!>mX(5HeX5a@^@bv_7j&ldq#6pGu))U|`;(0jMWt$(Kedd*m-qLPka61w4P zr{huhd({!tn@@L3Rjv&gHP=uR1}7+`H6lsfTA2vl#HQ-X)EnhGsfv7u`0Ui8l_*3a z_~)oo8Nx-6&UUKQDIr3xB(+JPwtG?=g_z{Gf?os9Mu7&rO8#p)PYQ#JUMN(UzQs{A zeu6d{Zg;Be9CXD6Un>emGnJwhD4rAyR}?|`Om+yQJc22K*w!(pWVb92c;U-mhv{&@ z;jj-lqOFC?SMLUtu*?e(h_M=+OH~;P#%6nhVc24xXK%jx!(H94YPHd*8r2a?%Ss8_ z#jzC`6fdp3*;BOXRh#WdMfIFE;&jP047lgM`!O9R%+u6F@vY(1p6S!g99(-RQQ6-c zUkw(e63U!P!)V&kuphN-B6U$b^^q2%8UYAaSynCkunwQZLuA9azzt^FXs!-_Tv@IN z*`8wgb`Zhl=mgJw*&A?v>lrNbt`AWXgEtw+ci#gU3uwC_T~5eX2jGTazt^G^}Lq^lOWl<~#fg}b` zcFUGajPnfa-CjH;;3^SbdVGSX&u4t$FkulwUQACn3S&^y@r?`P%JvT2cI9>`?ZH`* zoq$ywIZoRVM|a(g!?H8V8xPXf7fi*RP)86( zF&gXE_e(Q8u^{V7fN`*RhO-G6XTo-Ns$H@M=+bkZi<~#mvjblA$~WWW=n4)`Uc>R_ z+wiitybq^09>;Q+zy(MPbv4Lrjbg5bZiPHPzy=rMx-?=kRME9(ccp}T(}2@M!RHS% zo)p5oBy-0rYPp!o?jl*|jfAUL@5Za%_;x(?#G@#>*swNXl~+rSPPYsMcY{$e{iMR+ zH8T`Rt1hYzjs-xGg1hf~DPHvIx8T|%UxLhiUrB13%H-FB3n9(62GZ<#or_aHC1~Jk zV+!Ej=e-0EfAhz1`yKb-#`ULg+wJ$_=INIURDq<_`I@&*9{icU;`_(&f`s8ESDr0a|3S^?A zNd*TIENW&-+QKG{8kxj{yHRzR04uu&((6m^bp5L5tPvO0MV(?Tv@#m6G7w%-30F?E zLf%L*hQ)?(!@?K~Ar(dvMsmX}R`zGe;tXmj*QlfJAY2`H-3`FZVrT$pv|26z1tMy4 z0&%oZjgD_fIALJB#{?j;nB>JZ?o7qO2zMMU3z7)34oLHev>0Ps;%4{OT zkOJF^ns%`E1H=dhpzO~Dn$DV{IbSs6p|y6oQ3V@i(4XXnRE1)`5ww&ea@$KYt%33v z3Qr(p^RYKqvG|TRIW$w$9TOWLgF=Ks%^IX=+M*ER&@feq*5WtT6bgni_dJ_AF?GnA z1Y&7QJ_;T$(u5?hSJ7Q?9D;~kb1-f1@eoByYcWx{{TMp$sfmiKmNmb_`~0a2j2ERT)KJ}-uv+%#MS5Chq4riNVE9nVT*Tt z^!suDtKNutKG>!&0uc+Q6{zK!iHXYZf7R>pO>cag>kFJpQv9GO#eP z6Cwqr2&9O=FZ_EIb4v>XcM+$T+MAe;(S;nU_8scv9PV@|Qop-Tdc`NEPF1aR)tX63 zqDC?@Xqccnu8Bus_(Cb3mnjM<1=}lk<4qs? z2^?Ly6C#T>#j2oEaQX6Gc<4hvi97Fli4_unRj!)_a#D--~aOKL~NQJ-~f^Mw99`?YvgGE=&R^;lU;GNMxQLGs`8XW075*+e^T~?fFfzFDY z7&I`-5iljeqJp^y#sRqPj_2UT-}GkOK5Re>A1j|3z?>DCPRLwvS6A8(*n#wScpBlO>uJfb8*N0FSlIAS@4QCzaQW6 z$Nv&!n=s{qnT<-UZsw8~GhWIEL$Qa2Ff8Vrn+qc?wLvs0G8WT8j@#St9UuP*y!@4K z!H`ez+Bdu(Kl(@iDmF)#`*UAu`>wBKb<6u=#v21=se&7c&q%Cf{bUPk+@ZA_wc6z33 zN2SwB3)HSL_Z+~*BPbUC9+kd27WM1nZoR>wGl9DPv-I<^9;Zu{Te_)B5ydC|;Ge?# zzWs;53t>>UW*w$!T3|z#g$Oh3c+kc62Q0<*>jmIhkrs;qNJ~OmxHXE1BVRR|uQiOd zQDgre7I{*e_DXlm0wiHa9y|TBd8SoO?8L|i!Z0z0DPx#3@?k)l?elQExQw)9@RE>A zLN09jWRFiVeY59qN_B}Yka9p-c97*1OSy$*Imfc>QRW3jW-MjKB8wZXTr?N#)+^*7 zjWwFm)~OUbx9nP2UJEUZB-w^?WczR?YX)-?M+ysSuHBkl-F*ZaE2s^|u+s`( zck>nQd~l{Fu$6V7W8g8v%qilUQ)(2#wva<}X*^`|Xa{p-vfh;-!ad@_EM%Hiv2vap zMYWpG)axM9U6e|3ZKzcFY@_fQeaO>deR|QHIGt{*t45AmJV5v)uIu7}IBKWdAVgjS zQ)#dYmg6OhTk zI9I}rXRqN)pZgTXqa%FRkNgaN<>!A6U;6y-VA}66&y#Hy%LIX995*!JqPQWfANX7a z%LFhZrHp0X+puI6@lbV?%~Gc$t11{aBbKQ&G*HB+m}R!9Sjw39yJpBFV#v|3* zmQuiJfNFs(6B04bZ#|7q|HA(Zr%yiuE(t{zC@IFx2}A`8&VixWet3Jq_WmPeI>EA^ zpl2t*Gh3u`z&3Ai{>azyOaJ|Ugn*{uDm_ zaQrJL(3`UreQ8AEEy~$7&=KL;8;{@@|LNbt)8|j(lmst(_lNQP7rh=|`K=$vc*x*` zLdF@}qa)}dn5I4G7)Xh5Sb!TlK_bGX%_S_m9mWB;d~}SmJ2NDitx?p;&Q(e3)I&p_ zQc)y7_lOyk1;6r7{tl+I9WXeuQ4~Wl?OZ+l>t0saH7EpZu3Q3c?omoHgBB=e0{GG~ z$~wb|=R-YC1D;8|0KNl}fWEMM2{U1_>D%iHJ=4;n%+X&)3e_lVa>pQ89NR z^b3?4qgMjjQ%h@cTV`qHC{pX4e?Zm&y?9?Es`@cPf~_mVfA+>CHKPK)s073Jjc`Pm!J_@1z4uT3|2HSExc z91;Z>8-e)OLrE!^nMAT@>#GBAv~r6%;Ov!3N{;Ha;P2MnttpqiYgjca)5-51wNap|_(@y#Fo9=!UYhw=OuzYN!(c?##Jr@r1Y-tny;gJ{9CPdx=y;K6si z7kA$Kd_3~yFXHa!z7X&H(8uw>L+`|;D|g_DuYDEEGU4*oJMiXre=DAR^lR9k?{NPs zUyBFc@=ko^3!lZ&@eyA0&^z$F7rhK`e$NN-?30h<*0pB<0yam-c+o3fg>kdR8z24v zUi;9yKty=#YhMOLaQofQ!NcG7-FWaF@5M`A^9G#Vyp9`BKZ&DDSMcCFKY*i4m+{Vz zd=DOY`+LBgFl>+T?vH&EuXymScj zo6kH2Cc<-H@=bX2hrSapf73hh@;AK`_doDPlxf20Gf&{v4}TC3zVG9>|MhRf?&fve zdipWfr4-zA|EuuIw|@waeeu(fdB%OOdJ|sp_HV^gU;Zp~S@7nM{TRwJVLCg-OW*P> zASJx^13!QlKlpw;^R+KvcjFrJ_7Yz9mXG4rlV8XA&1*Qh`W!s;i9d zIKFZhKJjCJ7H|LX58-tWe-zW<4A-9geJ~Vb%6QL@{uemDdbFSs8c{lkA2pZ*WOidVe)Ex7Z}d-3*f{&sxi6F-4_pZ8*X?o+=8ErR=B z_5i-)kNzy)^8-JIH+=YGxcBB#Sqr2|KXTSX0*bg(tD_8K2ANpy$<&!^&7eDlVJn`5UaL5Vvf{wwe+U-}HbcKu1H5?=S__uyN<;}7Dqzxk`c`HXv>_ac1fpZ-7KOTYE& zcG*pZK$Q{fE92FMY#1@%WcM2jwHY=9@o)uRQu0y!n0K zh4+8rC-J-&zZ%bZ!OL;_Unqd$r9 z@^kQkkNzm${jEQUN5AxGy#J#=g7<&?C-A`AKa5+~pTMoBzJ{R?j_DHK^*uiY+U;=m z^~Z5_dmBFbQ-1}A({nuewJ+gi@Awux@PSX@Gym>a@rDn562p}%cJj8F~0wg{^vNqd4{LI{&hV3ZQq3t{DD7+PyNy_LW<%wZ+|CV{m?rwouA{i z55EVe*RSDwfAUY`y&wG~P!wPJ;%Bf(!Si19QvApt`-^zrM}82meDH1f`d7Y)8`rMk zeV_azxcde7+<|w!?|bmS{>IPao_k-0cfRAJc<{k*#`pc9pT#3z{vz&s@hkDkpZbe< z^LxGnOoTEW@clpYU*eT-d>5X3-^+0I>Rou`3!j4QC*1v<7vg(=`mf?Epa1vR-MWr( z+~R%T_tTJhLP`m5{lt&sE5G$i;BkYue$P+hZJ+oFJn-3wZ7eUW$)>-+zLW+wQ=3e*e$l@kf3i*Pedd5Vw4UPkjGR<71!vX}tcS z_u`o+zK&;~d=l^e(D#6f;6<-|Exz>+{U^9`$KCk)XMP*|<$yV7yyJU*1Rwjc|2-_p(>wYrp;PA=BhCBrmxVdPrg| zS2zd}FVI1;60kVcHkjdYr^i{&XCVwr!cZ7_VdTOXiXqKhDssxL#!Be<&@C^r{=0V~ zRnkBd%y6KsDbVWZpn@U`W+{zvQ-aW+$k<@XjlQxos+5+7@FiKmx?t2|4#Z*&AuS_@ zWxybWkr*QrMmFkbCUK|H#q^mFWEDqw6LK{(Xr?zML{r5Pvm=4DZt_4E933by?^+gS z0BNd&dN5UK^*3k@z_co}6M?J#G|CNEg3{i3Mk|77AKFUbR(+DLK704a>{M;)yo$gL z4QOOD)HCx(l^%H`8uXPR)UkVT1aFDT0IWJt)P>!#JMcum`L>n-ot z`5PW2_HdVIqSF7?ML);D(^PgOD7mX5t(qSV8a;z_lXI&*e<%J-qx^B#;DJ^RVSl7G zpo3K_SUN40*zK$@ZWY`GvXnXTK+7!oLllyyDi(aC&fQO8b9@hHt>>bn5Q`*I5o68YgP+i(~wAamei<^=qY}IIJ%;(MhDjxTY%uYT8Bj1 zomXpPDcZ&N(J-iL!N*~P2jB4l{NAVkJ$~(9{V#an%@5=G_rDyfikCj{MqIt?9+aYZ z%lp3rx2|8uFa6Vhh_jnFp~~(yW_RR{d+)>D&wC-tQt*xsejJx?zZ3uZ=l*+q=`)`) zGXkem&eI;88Lxc9TLBP;af8=B^f1m&Z(*~&jQ4-%58(XPP5k=5{ug-JYu|vky!XRc zrh?7(7%zIoYmm}_Wm$0hUC+V&uYADG8V0=jp@;Fj`(K9N{N;a%XP^1Toh{Hve)AMoTOU&Xim@c$NfJ@-Cv zV!Y;U@4_43^KJO;|KGpD7yrY*!+SpQgLvIL-iuHD>MvTe_-)?}Ed`s+25&-iOz{>-~80tG|ce{P}-`m%rhyc>71b3%blWxpEuM zuV2Hj{7-)ur_Vl(_x-?6Adeetj!y8vyS^2VeepB+t$+Rxao2P2!}Z6%jwinSdA#_w zZ^83l_G1om}k8Fq4(nW%I#1oc*%qB!i!)3FpjU> ziK8pG<7IF801juTP$gWtdKa$V^CJAtFZ_=nQo!nvBfvN;{!N4zJ&LG;>WN(x`O}D|K-o%fBk2FA1P-H4BUZ)tNVhx?szU< z_n|+Cf&t6r`|y(Y{Q->M^aeaB8Lxcn2l1kpzX7{jdu;L+uYJQe<1@eZ%lP?!@VD`a zPyP&E|JL`T5OCLhFTmqp|2+Q3zxto!(Jy=!-~X5X297UZ!V{nS44!@LQGD)K|22N| zAN@VdxAw@IfC<=+x8a@N{fF?-hd+UT`?volzV=(cj!*vS|2y9N;ZNX~|Ha?Mb6@!Y z-u^v5hW*00^1|oi2*V{h@E^x3-t!6k+TZ@`_?^H1xA5@CeiUzc z@AqL-2rql}Tk+#R^VcvR&hbzFhrf>Jz37#A;fr5`fA)9&3cm0gKacIvfN6nI&E$Z) zU-UA(^uhOHJkNN+eXqsqKJdNxrnkQz7#J^m_`}GTuHt-8c4LA{#$(RAOAmb-`hR}e(CFQ>L~cxtqIS4!OQUa zx4s9N2fXE5K8lAw@dt44i(U#X8Lxl$x8U}>?g6G5cRcrbc>4!Gj$ioi{#$(N7k>dC z`{W-J%JB>^2fj@C%FH$Z^R$^FaEE{$0zuQ z|J`51)#pARuY3PTFpZ2U31$|2?JK{BuYCS@@b%As8o%~W|2|Hy-TeQv_22Q9T-SXk z`dxch)j9Xx?nVQRNMwLu07Zac5J{1gD2k+#DOtf(c#Azv(;JiyhbA{wjXtAN?!7{D}|nso(!K z-ui=onIkvd$n(!1=bb&*Y&(X39BS#;-m*dAC=d+*w1CBj; zlowrl3vYb$yYM&;9lVt9{R=!K=P$7L z!V5g`sSh(xYrgoQ-{qmtd+XC#*Szd5KJefEcRu@(Uq`wHK^<3L_Y!Wn?JiEAJjPRx-pl@lbA0-P zzrll_`%}6g3@V&I^$cJCmha}a+rNQvQZ6}k4KKg*Ev#3OSG@LH`0>C0bA0vg5AlIt z{g>Qw#~XR=xBeiJfva!5omYIrJBsV-wKw0+4Yz(BA$qnCUdDHR-(Te$-~Mj?9aC+SO=b+G&InA_{)o}(Ty(hT(tVj7eQ5GKQ$Golv|O;~7PN|>l7F0MqS50PaMdiA)_A!CQkKABRfHGL9OOboGv z)4Qle1M9@$@pwr{SqiOpMN(6v8HCN|qB?OG-Jr3%a!gyzFwAKOnJJlcr|Pss$JIXK zVp&kzD4J7e>wYLrL$xs+Xs+{Xn#-zXEKw^N;m8?+k&S;ZS&|t^$T1?BA{wjiIX7=< zO-YlRYL2$i{yB=(gbmDXvYPCSj!}|xezG%7Zq{tOjlN;igs)ZEfWnp+egb<-pf$OD~z~P^UN5qRH75CzeJ~q($Xoxr&m&YPRrc zxZogDF}Vx*a(!*mfJoi=G88XG7pNt~J2%8p(uNwF@0YWOsx?iMqe7c? zNaGyaxT|jpo2yr%Ds5lx8l($cNtdtK9#EPcRJI-2Un}bID~_qIzF3cnN^- zdk{GG)MGsU@B=Isi)ufPGd*9@Ogi7=T*vP21&)3G({$ZH-}$nxzWT+xdF#90&Gybg z4js9Yppm2Z-NQ>>^;)`q;1eJGJuaL-hx49q|G~e+-5>iPVa~jG3iYvs)+tFPzaC71D$_xuXyPM_j)ANnI+|80McyFc(dXpB5@?-#lM6CY*X-{;`r%Xs5= z{Scq|{rB+fgZJ_5{a<0Ry~ES@-^1;1dItwDxfG{DH!OMTtM~B2Gf(jJgZHsKcnN!F zp6B|Pzluk{@JWt8`T)lszK@r_{+qexC9mYn$Nz}F^Sp5UDW>&4SKjy%c2A$+z>%vt z`S^nzIC3?j!utF<&Kx_+p)0Oq_k~k@@elqB#~=O@mt1i@uXx+L@!eL@Q_geXnwP(k z!`Hrq-}p!G;=;+N@je~6SKWFS(|VUr{K`*r@`?L6aM_jIaK}4Y96rL-NA`4P*R9!& zdqhoC)2<&F7F+C{JIAN~;P+YX1g<8Cj^KKq$J#O*sS8FqN^ z?my!#Kk%2h?3NpN_Q}UMbK)5u`^sl{u$M|m)`kmbauStu6HocGk@|M|BllacG=qA;V=K)f5-cOop&Y5+XP1+zmMmRA4Lvc&3zyL z2-jYH121{&xADP$^-nqak&n=AdA6^-oL7G1xAVv+|2tdVz%!43iC_DV|BPORD=vQ* z-LS>_>7xdJ&gjcQc>( z?Vra>=0cdWtSG)uy0F!p_Q)>h5V};v4gCT?44m6L%hMlzA3jE2`j)qI`7O8cbKmzD zIdy)I^ONwMf9WSUeB~AVxgY)OeDFR0ny-B9gWPdwi!(2M1KT&;!hGN7hy+3ieEBmU z<@Q&;o-3}so_W3I=sjQL_BXtV=Z-$bHMiczpMLU}5gfZ`&hShB^WWvz<4^MRL-+Hl zZ~PVxAH0$~UiKE82>}bznxG1>HE3rrd#>+pZy-Q zOhlI)As>74QJ#D5X&$)e)0}+nx#ScXgVmmny}k4N%CGzkk3aMP*Iafbi>)0Hc<}R| zMdp#Ni#+(bKVuq49=!Ww9DD3xmV?kEtk3T9xj*_1Uh|FL%_o27Kk}kmzK+u;p5XbD zCpmoOwMn1tfxe?#E*Z!3-2LIt6Z{PQkQ`-EoZ)s)cF(i-{ImSf|M5=FzVrL| z^?QGYD8du>ewjc1FF!}zU2)ZoH}lrN_!E5i=YE!H+)GTcY}apMDs81j+2%i{+{|dq zF>e{l(L|IvcFI{~fHni+B5W@b6?+S%)?{r2S@D?2rf=2=q~^pITC23SrmD@~h7>NE zilHDAkp+>C=mx8^21I&e=xO7(kbDJdgE$-WFVL$bgfIv?`P3w6qStzP}0NVU%q6 zR)laH*_NVhMQRzG+V(FN{UBNP6pPDkiu!7NOqyCSWp29CNM>`GVsx4N5!dkFw64u^ zjT)_)Y?|jR;mQu@IqIr3)H#p6ieFnTWX?jD4B%vM#NbdLnj2bVYj#UZko#7GInZJkOf zIf0cLO5-A=Qd2u}BUl=ia)YF599wV7=JTZaTy1oZq0Bj4v;1nN5jj^+eL=Kpb6XLp z&G|)*fv8}3Y=Bw2MhoeriHFS2NNIg|N~U>gFH*yY-^ey9L$=J#&jG2;N{HI}p=vhz zw9Sd~vX|yb(gv)W8Xpmg!)c4wC7b4Y4Y~oZXYRF>wy>gkQeGtA$dRSV;wxNqjg7-A z)k3+UmR{T#wzH(P35AB9Dufnijt#)6m0le+Fs}9y^XQw_EAX!I)J&!?pZLJ<@b>Tf z5q{t&|37^8!+*%p2fl2<^*Iv3B-UQ|=NmF=Zl{7 zxnoar=7s0E;@TUy^4jZo>XC;yfBrm|UGXB$ojuLo-X7ldoIG&?ML2lr5vKLp4#!jw zJ)G;X;P>4i0>9`?ey$jIL~^$kMBC>apL%sPjL9M zBXq7uLu8uPIG^m3#{GT5Jkz<3FpkBM_|W0YxZ?U7c;^rOWnv60cMdYG_E~g8iC^)~ zqkYf0Q>XCWv%R%L>^p9M^V>Oc?e$5I2rPyryJt=l#ub-edm~PjE3Uth`~K{YSS%JC zzTz4#x#DVWzVr2%C_%VA2cz~k1VFr!nzyMcMVLd4;m-^j|m^y*tVcl>cyr=Q1ni)3dWHBAMli7?H0zd+Ry zrjf1_)bBC66(b>q&zot;M}F()`ToE5&-i;k|NGqYsSon8-}wbr&p*Z)ADMmR>3cuT z>&3Bs^DDUQ+S_>K?oV*V)z@@`-!cCO6Qen?*bB5&?|fE zU0lCl6@|;MyN%Pwo?u>IVCmubV-Mh*RCaI>9K&pGg|jk`6JP$*KjEdXx{F8e`!w4}F5~V`{}E%C44ed5ojt<`|Ly<5 zcl@1yz^lIfyZPep{x%=~onJ{hLts$B%^+qH=9bFA%P&Ji;MB86k;5H*r<^(V7>j<% zrTt-ifRoQWz@@#iMmT!^CwS#uZ|2AUmtW-Q=l+I`!2F?J7y#=m>N_%oa_~6g| zGrr?*|8M-{|M_0-{?L2)(0hK7OK!Q1txGQD2Y%{bfp>Jn7PC(596HG1BiHctZ~Y!# zea9O);CuQ@uOvMCc!`OSA@cA8U*vUf`c`hc^EI41^&C&$a}Te0^EYwNhyR2_mtMxP zhaTj}4c8H-5t$>4J~@ES>xnJtx%QeHIdbG`{=xtJAD|b8#TH>2iM^nmu)BYru%-9~ ztmB;a%FYqYEXzB=d5^=Vtil<55a#uYZmld-2&*-VOAgcR2v^>CE6c4N{_4;C0^T{U zzV22Ye&F+5xUlBW{@~Ym&D*}4uRin@obP!2@rS?+QesT{N9TNcC(N7$1B9FkXHGxI z{_ZZrLU`eYll<3z_mBAgANf1H@{MofkALak@c36gkCzT7FgVZPDJCWh;J!b3FK_tH zAL9BOU(Pi*yqG5*{2Z&W$7JBgEb#C>pX7#Dy_vuG4}Xydzw&WD{Chvg(@#E@LeX<= zU{V+7y41uq#Fvl0{}=h|KlLkIbIoo!Zn^E%{H=fT^L*)3f5IRA+Rtfw+)^b{JsIM+t0SuBUeTg4Ka z;VeodX@`r%$Y@(mD6Bh;(V8Aj2x6$_FEn6Fu62@bcTA0)1aK2VpXvaYbABV@I?T(K z?AzfQ%q`_T&h#n_vBPOkG=_o;9X|MEOl0~&Z!$1P3a1w$;tKY5Oz5{vjcZ!n02v<=6kizu=W$|0dq~7k-TQ{^x(oGfzB%_m!cob_||* z;WWSXpMI8WZ+bCreEWAY&l8{f(+?$=DuMNC&EpT=&-J&xjKh~*!QCJG6J~@9=g)H8 z@-}?8VBFtl=inu12<+|d7HzL;avk;EB3*ZEP-|^WcnZy?{&S{CU>nc4zfV65^uxe< z_dHG<2M-@+fA>Oim!r~_**o_F#~!+u$G-9@a`5kJ_X57_Qd1rSPv84F?s)t6bK?sqIrYSYoOKv<+Pw>QpU*=Wc z@OBPvAL8!+{u{jc&;JOodGmKLj{7|I)h{zF9dwRfl0~`pg7eABe@@W21`-{jI+=|xy5 z#0mTey`ch+e)iMc@rG~YP2ci8Jod;vJaO_F+z!kxpdRK0-1CVK@#q)t=Ih@2cE0Uz z{ayUw1KjiR52Sle%AE^QiCxFJ4o*+!38HKrIl|c&9%nTP-PRR^^~ij71rrRxak+05UHlX6DW{fxj$ly%aEFyPodeu7{6M?c0jcf5&r z{@DM-^XJd-{O&1s&!6GFzx*#bd-@DfVVw3*9ofHdj;FuyQBM8gud(eG+_&E6-t(sk zq^J{m$FXOhWVPDmjyJ!Rhd%Qu9{b`K_{Q)1LGJvPcXIC3NnSYi3`efNF2x`?#~|L~ zK2ki$>hueoJ#~`z{OkXfy*Q?bkGRjd3on3!*a_1D+yJplg;O>JcBJAwiW;k@YTJbr zjnM}i3Xoiq&z(8RvEz^NEC1!6q}pW;tj?XmT@v`@M}C{T-try1_D%2L)QM+#;q>!~ zzU8Q<=T`6qg^=N)DP{3FJ0CsCZTC}u_WRub%cEcY0?$1DRo?ivcXQT}xF9eKJ3EJ%*85CxBFq!6?}^?M#Nmcv!+~3hn@FOy5v{16X8zm1{-=EW_us=` z_^W@PKlg)wmG}Oi|7#*|;f(c?K4W&mxxI6Y>wPY}>O};B#iHlH;Y&ID+zGTZh{MC| zBhdw}yyYg&ojS>CwF}PC^*uq?Rf3egDvDuVszh=;NDxB}HKw{oYB8RjFP+3vqjsda zF8KV|L$OqJse(y*K25O@PLiXlb5acRi*G}4C5T*Na%XiOlf<}E;}zLa0CfRmjnf$z zQ)5anw9!zy9ARdSMIhh_mYx^zM7+8r{|X*ADH0qmczQg&nA>Rivq|^pjcu3W=tBDa z?6PZ4yBaLWs?@EnsST<@Wji;Q3ifS~xU`8@%X!mjf%(>6rqswaH(E=hQ(H*4K|2%q znxN$k&kh$2am*d2t93}1`D`2c&sxl6%9$>;F|-t8x{NGG*|*xPP!n4faz;Tn@&~g+ zX(Q%rjA*n)2kWh<-G0;DX8c$h^O?Ge+x*3xRa4DmqzM|WT0gB$LeeZg$+>G%w3W%# zXj9NCMmuyC?klb4PioSW%M%9KG^XL=5Q#DdL^7sc~%91RJ6EbvjY?yIKQG zH}t!ysVb;c?%y>wpS{81tT~#+f;ZaX*-Q@0h$>c{VbL8LC%l>3*PGtPb+^2f)2E(e8rO7vpCS-4T3lRog*)H)jlA^E z*D+5MFPuDqb6w%+2g@^h^60}Hx#~sWgkw)VN#{BqzW2+-5P0>Q-^ML3zk}DjdkNCx?5k$UElN$uDteo9{S?li3aO@c`l*}0mv?0PSS+96FBws2-a&f8i@BSPmp5YMysev0wJ zIbQ$$f0Ju(e#gtN zRd4++RFx+mz8AMxvfFviNn~GO3d-Fd{vF=@&UdrumpuE(eVlpj7;k;||G=Z4`xMi2 zXIaqE`3~n3!q@eJ?|XXZ*>(d5w=ZD~BUilS72Ne5-^*hAAnIV8R*d65H-E#Mxasw8 zq+c#m(XxiP25}wp2=h8QW72o*#fWs!^$zhJQI#)${7>kHZQk_f{t~Zx<9G6o@Bc|Y z`?2@(#PO$j@m+7=&ENV1Y^i7W#8aH>m%I>^)5ni-Xh* z{^&7Q&z!m2YBMspJ4aw3&_yX zM^C?kL%riAU-w#G^UdGOydQb~v4>f19mK0o)A>Po_S_jBdEoQB;oX0O<3}Ih^r`1L zar7Zx{OWJ!_@nnR&MRi0w7n{x{TP`-;L59RG{@bMZdh>WnroRnjFK9W*S+gUc+FeC z2i7yEo_&mAvBg)u_(`69<|uFd-XG_(YhTP&H{8b6*WN_fTk)y){UR@Y{X4n#6>p@w z^ePVC_;SSU5cfew!Og<{g$tZG{uD2L)$4iYsYiM0iAOnm`gz{|<9~&R@BS?7{r#jp z^1Y=w3BC99UB^;{`#$u?gxxjY{O5jvYc9Wu>#w!8uc@md2Ow0+g zN)CgOvoD=AN)zKz4_%FKlU^;id%ZlUwDD_{vNl#`CGZ>#a~C)FY16T1ituz_wcH>eIIlK z&pz`6qb8R?*QMO$YhQ8~cfIxdar8X<=vNr}B}?DoCB&_6<70#5C0A< z5~JzJbvJV7w|)n&dDoxk)!+HueDb}&%7wi%-1zF(@=bs7|HW|NfFY(?ZVL^RT?q^Owa zQ%p+q_}HcMM9e`|%vsb>LT9wmL@SL}Q_V;W)@Z~Ukzlb<8$JxQ{w3KZo<=9wCYn{Z zQQfF>t0ZhQ_#Sf})zWlUSyYo{-OwUwB6ljivyJq)$ZJAd7f*}0%H2ilz}rNjl}I$L z4QiGrWCm7g0Au^BK5H!iY%RRn#1U!qi_*yTq>0ZE%NHfqJjB*(L!10)HH0^768(?9 z@{Rw*_-Nc9#N6~C<;*1`U!|R*C`s^l} zCePJyrdZWl=zVe+HJYTkJEhOh|GlMprhm`Qn&NFjlbuVYaRn{3QK}BoRo7E(U5|<= zHfMmeC}nMOHHT}9vwK?gc~YE8wVLkOvMnLF&@_Jf1vs^AYb>dmhoIc5NYnx{tdziDQPjTqT<=ptogJ>d@fKcm)2-~DKgWGv_ze4dyT$!00@FBh!>zY*?CGaD`p{QF zg#F#~oH+IjS6_Q0S6+KP&pz=OcmL^!nbsrIII-H_<+__*j7H_?SMOu@!g-#4^r56z z>UvH*^%UdYUInmA5$1XB=_gt3?;*~yTyFE!qYrZCx#OHZ{wznXc@fv$`cj5|$ru0h zk9qo$uO_F_q38Hx4>9fSA>vsqmYjIvQTETBWf&HOdE%Le?q}TJ=gjeEx%@@fbM37! zWwEuz>0?hbo;%02x4x8vmtTn>9C^|8Jo)9%^WeunOpKB7!g(&g{$>tcekCWLc$D+c zpW^t#_YAQg!-S$c@yZU;j{as#o z`Y|+wV)Z?(c5%+LI)8>oKl>rVYM*}C;)Q1(=h^!|pB&#hkMo}64}XPewM)0yBCJ*% z`|9Ta#rFfxKXyMCPCm==N58}+SKPo=FTRuIflE03)WZqQaE@aS-i@qB4(m2YmRB)7 zdOv56J;0gq0vBRH+yHnUzxT6r%WZD{y4P{*onMdi!Uz8QzvslU$BJ=OCmrWbpW^W0 z%X#4AALN;@-b=VJva@rL&%N*0x$w-hEczwGa>?nZALq=mC-HsH&Y{CR^VNGe_V7LI z?Vab=J733<>#ybEM?cT$lTY#RgP-QinPco9<_l~ucDUnZZ{Vhvy_QFhJ*v`!{Q?)BJH__aHZOk3D>-}gG4@WLWM}Ac z6U6E@ zu0Y}GN58~=+~b)OPqK6PGOoYn<(z!>DEEHi0}OtLn_uw;uDJ1L9{AAgEz9FeZ)o=^QDXU`r-9c&-GglC`nDo;Q80IR56d(+E!F18|sSp1y$4@-Xz4v^Y%dfePm%Zw>Tygb_IDO(t z_Md;6{U`3_(D}1m|B5%_Z@Hb5c%H>#NfhOwyFbYs*YthIFl_P6{r7V6@uNI`&lh;ntuNtacfE$oueyfk zo_&&&C!S{O;6YBDc#J2G-U}iu`USf$oaWf0594Mn8mbFtUf{B;uHpKZyqqT<`4Y3v zjC;F0{P~X)V`QaO}im96NTDm%Qw?+3jbjC!TnOe!0cjGbefGsRucA`Z(+L zn%iFfI;3B4^r0^?M~fM8aPqlhy!o9!z|s3Z&lf-Ohlo>-KlU&$oOqg>zwY&1bL-1^ z=Hah!_Xpp@xPO)xP8?$zSKNC0*CV1lc;9Du=E;Y6_Q|7opD6J6eEv^aulCX~&j72% za>1=HyOWpQ@oK{UE}#3|Ut>OXoI{5$;rXKvbNt~4P%p5(#nDIa=eg6zdHBI}t+&7G z4Qw4e$e;Y)FY(YlpJmp-%U|^du7B~%IQ_zLu7CL}`0~d-z^C5->r6Ux`3*O5#Vt4U z=)Iq13M-^j@R_QYi(uE}XtN<7;i4ub*K1BZ;LR*23?+M@ZFB24re z*ivB;dipS=T*4`3C-x!?LUJ3`NKd4bgckOqcnNq(5f`G04-ubpE6pe+=LV}ah85&V znoTVk&srL?*mi48_gM4FbrXb<1`TX#&o;*}6=gZo+ikeqSB$1|?c^d?l+sq%`%;O0 z#xHYHBH*+n5!8CNe5Nfd-^9#G;sQ5~rPbYRvTW5dMPrnv{>>JVO@M?}S=RuMsIKdD8@ZVN%PB<=3xDfF=BQXh6B_=Cdv51PU1VhgV5f_8O+F2?Z znvB9qy~r4hlN{t;t#nf_mK#8^$h6$lrQdT|&(I)t=`&nPiE&~?eVgb&3W~Qddbucn zFzfiDG&Bfn(RDIA9&r}f8f`-42!x_JjAa=so~Zx; zfB;EEK~zc;3x8cnC|k4*Jx6}1t4^dbqtw=v=e(-SWzWH|Sqs^6-_xf$Gvle0)mTu_ z3iqoGPs&I_w87mesBzczi1&mLY;B6^VM$uPj2s&}*L6K}NG@Z=P$@d*ICJpuWqj-R z{V<>X*oS!X=p*)di6ZNr;Kf;npey$g32CAm0#S`eRoK<(?>oDfdFxHQ{hR@r?+S$~ zL(~+W?K;9_*J^LCxN6$N1_Cc;>7B*fHjr{c=ey+4W{v)<-tjIDU2z4U`K@0C4a6`v zH06lzl8$$tgAIw4D{pxzFaG*BbNBE3D)V|D4Kwfh`~RF{58cnFfAc@l4L#l`m1>+P z)AmMGLdp>(yWQHmY?_s%d5@^h&AKtPTCl-e`W)4iorOY>m=vd7kH(Q`v=4xV^IYZ* zaOA=^m&7IO@j0FzpXG5~aZ)0?s?4z`>d5RsyCq%UF;6p-?xkSrn2Zg)^bk7S2;DfR z9rS`@2p(|(^)vH`)kBa;61t){DGOhK^aAfehWWz_zU}N&w<5-jzw6~4bXQZTcY^=ln5TSXWTL% z+e+vh=cWY{JvvWJagR7C^g`%_Gb?4Op2Km;R@f&77-xZQAodfXiTdrGFOQXpU*-c@q>-lW7_&G-9%N@9v9YS&kVgVE=MM( z%sA+_ao#hBHGz>3BJ+O7pMUpX=C+r=mVf^*{ucY|{o=TZPeI;JJgXQOHRS{Mv8S6? z^s{3zb$Fdnuf!g7=yAg$Wvs6EaUrq*I`s^TEqs`faUUNo2wovNVH^hbyTH^>Ajvs& zp-Z-PA1@B)2YlZ%&4DoQGb@ZZMscikW-UsHJ$=7L7-wQw*%=mCjd06tFXbQof8WE; z{*xc)sRzEu0>#DTB;NaNT<3`E6>0`2K^2t+GHfyG#9Ai;FzHN4JaB@hOj((g&YD6| z=-6V}^$hdO&NQ;4!XTa~$*5-6&zyH1`!cikk>Eg`XXv+y1me6;r^3v#(-h)nv54aArv#2o@B(GO%4y`aq0plV>r_4U-149>?MNu#G zzQcFMqOuw;h%%`X?BCJU0A}j2kW_u16aeo?nU3B&Td&cKLUJOT$#%R;L^fxvE-z*h zl|I~gV}Q9xkeG7joKFCREKu=?_H^{7UG)iF7om4E3lR>5f$eFa3k!5~$kfqCM=!8& zfdS|=&>QWvljK6$xrmpDh7mVMx;gEsE~IlThS;E+Il#S%?b2A7L_xBlOw|BD54vUwHfG`lPnn3 zH#%HyGR?Oo0c@s=m6{8wF3@SCdD*b3w1-q>i`Aq=tXar>_6;Y<3ilM(oDvQ%jfPND zqbKE|HZ6VD*H!LhrJ;(4mRoFL_fkw`QsGe=$P#Ezn?h*|AS0mChKpE(V7Qr+3Kfeq zyynemL`A=9Af=R>ErsqGh=$r}gQZqNVpSSu)GZp%+9o2g(Jy95Tid^*8!jo)icqIM zO}NZH*r7#Rm$h-u{x`j}RS#9JHKUjIy&NeBH@h^|uycEut`XW6Mu2N(6X}lB?p&*R zkV+#N&a~24&4Z$4YKl$d8tQ;jRiQ2AGzEm(_l*=$xNZz8G)*^12T6A~bYEFWK5R3v-yw0oY|MxU4}bD5oLLAu`5wp=#$0QDWd_cfN+ZzTqug zICqxg&pcH$e)(FWY7*RtZ1VI)nCHnRTG>ba2|<(|L#YorUv;G+fGtMFKicWepUMrZ92%>KAd{ z?RRqixno@W@;lf%aEPOK|5>7oMJ2=uG}QB?Y-EzIv~gM14IN|?#-yRX(K)Zv0&3gn z6K|T5Fs_qUBvYMKIWQdH>gCNGnLOh&kFq$O%*b>i7 zB;=`K3^*007>QnSzQb*SUkjqX9GKC0qO(c42VB5)9@&p+26uLkIYi=)LuF#hF*bc< zHSaNu>5#-b{NU*52p3YQwk{nZc;fy@A7VO8X)wKEr$lyHjlyCH2M6Iu2UoG+ z`Mrq~dn>{u_yD~Vx-sIziZHL!y4dPLy0rh{)8KQS@lF{!nEIHEX1pE3T_ETl>j2_n zQown|bu%%s1Jj^N_E}FbL|8_chY8&cEcOHr2>rIhNnk74G^STO#!ToCYXjR!iP%nim7d{mO@% zyz%iQg_|X$I2gTO1#dL?pnln5mHI5juO?-q?h_QePxQB0 zMqF=*g$Be$`YG)bQIs(4nc_mxpxpf8SMc`l`U&oM&0G0}fBkpapZADEElQJ4IlViR z4f&iz(3KT_5ho))P@K*K6H}ZC&de>0`6?P1!+E+0gR3%>07S3MZk^(>VnQk=Q9Aa` zoJ~PT=5b7?j(z`5lU6tFi=fP`*XM~r%m7X~c*$ja&v*Yn`KE9Ae(wI%2YBG2FR`%w z(L3lgqIv-t?KRid&~PHICd4I8t(eDyi%Qg0MR9DOEkr8z(P_m}g@fu@AUF*Kgvn{r z#mZP3gyg9a2=Rg`h3dKQdq+161euxRjQ6e?JE!v4xsc3qyfqc+cTEddr6QH_RAU63 z0$tKnMjuP@O>l|DW;Y~awA4I|w}UN+Ky-K#8Yo0&aTX$)~G=KFQx-kQ~Pc#St{I zzkEeLGmR5pcOfyxfJZGVyr5bXlZBb7flhLHxwa%haV>FVBk(O-3blI}e43t$Y z6=sgODrAjXn~lcywxSbi!IoO6VKIl(8#>{$9!_&~h0!6kB5B3#Gd9q6Dgh8po0>Ga ziLE1(Q*AV8>f-KXL@;Dc6hbInp|M#7qf846Czox zR~zI{+kK)Sk~NQ}kP5U7Hcile_91mjnYNTHLugfpwjpRWDJqRbwPJ=`RA|YsbX3C@ z$<2eK;mgPJMpXMOi)o1w=R8Lr`YQL{{b^SF`<5$|1=zYF#iR(lE#t--Z+tqmwAqB} z25N3z#V%Uw7na6B)~Lgxl>i})i;^@Mv}mA0(9R*cjl}eX9vWwhwkI~ryeiQ zykw^qLABJ`gWd1bPd&ziAN?b4dF`7J5iXoM!3Tf#pK*oMLS1V5>b4 z@+~M7kuoI8_Ry)&Xm*lhs+F--yN|`WxxF9jiFxl7`%j-|_55*8cl(?hM#gSNNX7i% z?K?-u)M+xF2*Q9Ph$pzz+=P(U>EJq}L@C;bR1j$@G`fYP(;*Cagjv>18t@C7^sbdo z1s8?=pp5Avh(VJ@yrv~? zIBq_83C}#Y$I-o!sdEgo!%ZPI!$IgqNAEipKs-AkTOGqNFwcSBsP%Cn$igN2`cUaL z;)LMR07H71g=gj_f$oLfyS7BC-B7C91kOVQrZ(` z6=4-Y2W6`h&aF}b-*+&&Jh)P}ZR=Ty5>yDPY>TjPX%AjUVd)gtE7K&b1%_VeQMy^s zF|ta)6Jbb=Z6Li%E+pMrF2I}$hv~UWmS_-8P0Fqns&y9C?rc3>*YnG=jt)3jK0U5V$EwS=)573b&zQI|~JaOs(67x~OfzuG7i<%rq6?(BfLINF1CnVQV zv^0a>MN|XWkUE=|5K~hs1sTpwSu|JqhKi_-K&Octi_U?B%E&9nwUp#ImBtBFwb8{{ zol+V#w<$o9^xpU!DM78vvH@nH=;lh)S-st4Mij|XUMJarFNX>ms^?T1Dyy`bnsm?d zeaM6Urq7_%@mfrnO1*B^sEsMzhP9Du6nZ^PB#LAN_G>)#Gf0qKZJ<+E9lh#z zab~kh6=&*2R<0tr7z#q*s!Gqw+1RuJIWy1bXRU!t>ze7bpdjU@I-@319X+)e%~&(& zTx~G28&DHSpJ|`PQdY1=HQUtsQs7m{xHZ+$W)qQ0vvbu^RJ4Yv)4BrLTq2=aEo!D4 zQ5d3|G44_toJ<|GJjCX{CRC@=Mhow}z20W(AmqToPzj;6E66U&i883QU2!?9t~$|_ zC+#!jE$z!$ojUUYt_>23X3A!h)6%RRk#tz7QDQSSIcDUvumiO9Gd8eP(fyj7!{ z4KTZ)*3QnNDoQWsYhD4;qItTJk?I<7R`LKu8^^8UxnoynjHFG=$K+(haVby~RRbDu*s;JwF5HK`V@S6g6h(j?NgXm}goDya>x=oXe~S&?dK z-Embn0#e%zJr_r|6X!8VDRf**Ri)BxlUI`zYwY|0oG2$BeFQ=2TwmUGAyG1miIRpg zgh3UVl_x&;DIWj)r_(_-P0$Iw?{S&N-6&79ZM3sICCK?#Hq~rmVqA+3=gFP^-?^t% zjWO-`M9bTN2<%P!JimH|(XUt?oH*Ah>K!|A$+lM0t{6OF?Adk7o?9oYbnS>52;QgH zC8Txk+`ts)6cZtiut<|`2S`8T-GT)J%Q!Fw&#vEPb~Egx349-2(x0p%Q?IOsRP1%m z;k=OrdTSI{5Mw~MKnFvK##9(4AFx!kMM=TV-6X_8k)T}CId0xMz>%Tj%vt5JapJ63 zW>vaD!Fyz$6FTgG5E%!h>pU|vTiZ!TGq2Mjyi3s_2xa_g#!IrL58^D!l{0oz~2xaP~rEwbqn7H;^<-op2$*UQ`A< ztb!T}(4{7B64;{-4A!bF6}HT*B5U)dhY{th!d`&I9Mky;gmt2K#UZ@{)0_}PHQkhV zLZ`xk*s~RS&aPLSiW94h@P%MTj!80+5&X_j60z%WYEFzseam6fWrY?!yrgr+*P=&U zwMG|ns*c%DtV=Jn3sNH(Ec97I%E9zy5P`YH3Y|q*v_)hTQr4?Fj^F!5e(RnuGA^Ot za!fg+)gl_Cp~5*Up1YU|?HmN)B-!~p+Xr1t1J>ZERj_DrP!(_YzR^)dJ2i6#dj7o` zm`r-$ghq6d{&_AL$`1Cy$DzcovWyZP)|&GfTyPcwF3D-WVf(m>J0Ww#d5|7vjRed&&q-4^)Z#%k zb&{EymnniCmuj+n9(a=iIm;q;wMud}U`$Sud64Rgn|h{422IQi4PrB2Et)s6^IGF* zF=C2~F@0C{^wBYhqr>4tf-URa`Dt#>X> z3|(~_&1@vK+F^s)MTWE+An2mlitIR_wSDPK6KWoOh0sb{XJOpY424uHaF9U>)mr;z zq%iw(lrcv&{4gd`8;nOmT5EIJI&M^^Qx{84TaAmTw9)3Jv4%8eN?3Li(MAg-P1k=h zI@A`dvPoCfyd&jprP^Z_>sD1(Hk}=QX0P!6=8*<%Q`KUGM(6TfsM2wmWgiI z!!Zp_Of%SIS(NumV%wk?;?`0` zH4R(DY`sMjdV{vjT4*9kq{K<+#;C`Y;e^^0xss&o0H|b*N*-9HX0J|XUE{jz$_jHi zkIE+m!cp^8(JC&Nh6Rxk1BarnEAP7-hO$;`noN%H&2M!qYce6}`MJsF;K1&QHYhAO zoQq~ZZu@Rb-?I)w)4?Id7Fo@@T{*p_oLh7R^^6kn8W~VrtfKXKUl@;jbX3Ap2rlWw zJEu79aFa)7Ntthc$xL9@HL;tSL@oM62|gvD$1R05^s=C1Wt1ilTZ)TG4>#cPU83uS zXnB5`^5%3lly{llu^>v^3&abiBkw_%5ND7Tghgs37j}o1Q5aO&l7YQ_;gNG^IZv9> z`zaD*#4SDSxMcRAN*E&q@H;(`nU${S79Q^%oeV^`M&>EKH(lBxMitgk*%xJ82*V;4 z8eh!DSHTc$m+ZxZM%G=*kMaUKM-I#>a>1$KouY%VUJGYefl1Q$)Isn|*z)PUKR>1- zFWBI15E6ZIQr04jeS+nJxfABB*A8JT!mP@e%MAx}mzwQSl-|`MDTdVGIWGhoqdQ;_ zSc-6jj?3aeSO?CAi3<`_6JvW$Y7#Pf?Q9aCjI?~r#aY%%8JlQMO}F!c4#v>1n52rB zSRSBDdg1Ic?!@6^EKQ*I>7IsEu_dz$3=z~slXaGt=Uv*ia!SH;l{`McXSlzqqEN!t&-Rbh3AYg#!2)g@$BQQD3t zLwvJZ#7m-?9&~Uia7j$-D@Zk|9Gx=T_m71MGxMYOQ~suO&ZWmpPJDZj6cv;}SJ*ET|rhS8?9WcF?qKP&Nq7H&n9J)D;7dTEM$H(YMBRqtCbN%&m{cx}r*uWz)f9 zv>SOOt=X;kvI8&aPU|ErwoM9~^y#vh<>o#|WR&4Xra`*WxJZ6( zB4s+4zf;y9s%v6KN-?uJF_e}nY{oBHDk3f+YZoJh`JG9JuNJCBDohj8z~$kFy{~SA zT4Jlv9N=8$={J;-LgCEQTbtrZri^5oSpJJv%oeYwM%yuZ!;b#!%tB$F9b4YBb8tHaaL zIiY<;?bIv5Ppmx5ew~m#0z>Q=;*#hB(NAb++Lzw59Xza)6W`oNbP$5KCU{8bObn@! z?7ZS;r5hbnXH~Y#bh&i)^uSV;1D$7{15ch^adrloJ;P|aGX)(3@t}iF2wRF9QiC~7 zGhJuz>ty@-0YR6kaZ5JbR^SNqA)#Em9vD1f9ava{5of`z5{fu>$|@>DpOA%=1qbU{ z=|*Ln)Z|Pd<=Ax*`d!oE85*hkl^%7thtrw1T~H1s&Llf~qj%1EpdEzCr{MENRAj=6 zIbjWqeL@5$O*BF#%UIMD8Q=lm3!MdZZzEiV<3(|StdwWt$ZqEtx&=N?ghKnP!^cF2 z6l;Dl#83)zKu|*r1Pw~)ZK}UCCW^skF>B;=G1jH7!gXc_Rwzt@i>8@1rj9QtmnI{Y z&Ia2#<5)~tCY3qk4E2aXkRW(Tj3^%r`Rj}(>FNxPhP^NZp_haddezj7B8h&NO{HiZ zz0-?1O3h~z(;qt56n#xI=%fztBB}Ax)?v_wwkcXLHOYZQi47S=ZID~i5mB1C%r=Qq z_igXefOeMD0JdWj^U)9pYkfMokERrmNd8?-FCK zF(h#oH|8=e(1{rcs`+VD*)ENEaO)N>9r3?Iqwv>Fw@$HK)-S zi-xc?g)v7Z#ETtH%GoBxh)?YkTWG1WX0o3{E(VgeRw@%p8tIO`%e8BCb=aPx2#r~w zjjL#4V6|+)Xqk(f>n)%6u$gcsc|vVEXjpo5)dp2!lMa@P zepNi16g-iObW^1e%`Ty);me4mk?^a`tu|RwjAb+>dp5#cEpCjBF0l=e6wFyNH#W}x zd!4+*(&R~F0~|}yY*tSjFmsFLiJ>=Tx}mM5a3dMai^Wy!+?kO>|=gru~B}yq$4Y+ti9kdhtg*nX^SA|d4y3SqkY|U z0Lq5JMms*rZjwc3pw*dEwQ5x>T~f<*CqEfuq^G7aYN2e1R{Q7{UCi#N^++-I$acse zjcb)QYf>v^A#D(@99+fFq;-suT)n)|5at zw1~BFYpkP%OfSka?Td7`+90DbHX5JC{GgI!3)8@9WB66}sJvCUW+Li}-ZgLT(t$ss z42Qr^1FFKZ>*%+NEiZPk#ZrOH|ums;m2Xikf8`$s~vW@gq7|y z0;&OJLSu(tdvrB2ZzY$uxeKt6q(>Sp${?mjDsDw&ZAH%v^A@ZxH5=_YH7%}#u7^vP z3s$poCIsfSBKv|H1wW?(O^3+53b1tOpv+5B(>JB&Lsf}gr0X4{UorWK-oqj~{656d z!*(D@U`rL(38NK;TLBh0q6g+^R8T>JvhS2`5L~Z}b85B%O6(J=7dn!jON4GtuB=#O zZ>u@mR|_nkeZQz zFwZ6twjq@lVY^cEBZWW!OmBAm;5 zH{;-lBAli8IyHek#&NqZe^yzgEjU*!L z(Y=a!KiGPVsX6pf>C{#Is54j5ranuK_*M6Yvygi;&==z*i#Wtb1fTS_Y(D#H=ND{f zoG7Bsd=3WDL<=>9&qc+@WGd9zE$%FwzL!`i#12hnZE;ShWJrx|fpu+4pxR7#%i~J* zANhaTC|cRbL1+g2+B!2*siGxQuUQ|&2I*=jr3q=v07o^7)KVujbxBj3iq-B?dWw2Y z87#{0vx=GgwBM!qIc;f|>&8rl&ELgY4JKxURJek>bO`x@8L26@~-28|+F%qXQ&^xEP))8TSMTC)XPx+fJnY&e6GsdtURg*HFInF$M} zaCHqOp&He+fu8kyZ!V&$A&eD=R97F1p+>EXlC)@9ZfqNkQ+|Omav$;45}%4zW&U#W z<~7t*N^#9aCM@-vwC+i=;Xs;W35rfCqoCqUHgE1#vS~|PHJB#k)!fYLh6`1;J=SK- zBVrDq&4g()N+sRI4Uo9@r_Hm^;`BTz zvWC7o&Nco-_D+<>MzuInwVP2!%&UW|4QR?FMGB?041pTp(9zH^O=o~LP?;hn<>iaj zy-TWgS46X`OF_Mgj*v9Ab~ee&=)8(-@Z(*64n7tC-qul>oKm^VMh>#b3@wo}X1H4p z^)9c`D1{3p4OKgR(p=t~P^g`*2+@oCU(6#MDU^F{=o_}_)xlYgEzxYWY;^FZKy}S~ z70Vza4_4Bi;;VOe66_bcX+?yG!J~sw%OxSZikE5F%i#Q}yKBNK-=@OMs7x>sQyNJ4}m~r4ORwib{1lz}UfMqm&S4!NP9W0ix zHNm1w&DkZ(1fqZiI`UP7V+&JMq)cpOXDGw;snXRVdE4RV=>!;Y{!C&$Clthon| zGFh>c4!~inr<;1lc_w+P{Q=$AefOcTU8{rxmGPqa#ASQFXVP8!N}RKg(a13D|c zz!U=8!xo)S1}qUpMp&qab0MKU4i0)@)hl5QlL*t4nyqBQDh!5V2A^*E-Xw&eToMcg zv;wUsncGZbYEFkft*?3Q@G~sDvh9;u&0*)bo}O+N9^a1~kIMO|j4={*#g>aKI$`M@ z`=ZQQplCMfd1$ZEhJiNdP43pNNKHCBgS{%jh9l9XuF8u~Mj;tp?69o4gwTrGy*ERP zu1dX3UzM0Y;**1C9I}IHdc7z6Z^@)1p~1sUaU_q81fiMvq|f&D9!JyK1)-0r(C)~E zwV^#O(-Ko7DyA!rC?n>^Y7Mj#=r!rN@@&s14-iI4E~nXGBWk6RWxbxu2tqCZwHE0X zp;t<|t~fWAeDO+=lNx#B@^`lKV$!sxx|o{%&d%@PD`Fkn%r&Phyria3Qe(KILWg6e zksz?I%3k??+6+RoaafIjDE9iLaZ8$8AI$PUJ05rl&Xu{iH^j)}5~61@0A*jbGb$Fn zzT}y!8UI*Bh_O5*H$hU-qTC1+zxzz>%s(eOx?Drr;I){q#l|8;jHB!o382;lrh(^- zh{O993F?fR8Bnj}Y;Bc*bDmDRM5)$f?6aVwi-H*MJn02vLJ7t6u@a0r8u2kE@FdP? zh{&AwYYFLmktS%pNR6UtXjPN8m{5ie(Wp$dZkBTYYVCMYEu4q&xml7;##e^FRjaXK zB49L*kmZwN@c?ONJe!g?t&O&@VZYY^1#!c8RH)vO>HmcSZEIt4nI$uuW{PV5BMGRg z=AMmyu)rB&lC4zVM>8ziyvF)n%b{(xUowrW!~Xo8g3!dXX)y=NUKCwL5ol1a+6ZaX zhVRX$PO9kHxCsA9UqTDz&!#x8MoSdxU?~V)G0v!z!dxKMn`VQ1#I;Yk8bZiL9vTTL zZ0LNY8EmHO#rQ@G`jPd84LVy12iDx=$(|EwCSUbvX&nzY?D}zy{494P*}*C|PR>vy zqc%#l94;tq{@jZ*4{X{XZR;kwNrN`Mg_=Q*NX-o_&t3CjE~QCJ*=sIw$6ZDywT=s^ z`Y8$xwjNsf9gO){GcJB`Mpe*iMeHgQ!HN(q4QNJ*rI-@bl^8V`fTA1L;xRuSbJv*DB)_;k=%}B$IUHz3zm3pZQ?sm=tCTkViaO`RG&Um! zH9pElh=-x)g*lbAe>qY{tF?1Jbj4yJvPLsGuet1Rny5TlwLs3+Uop)osBxvkWQ#mk zhBlPOUCKM+3q30xmKFz~`TezG%cnKvta*1fm5oN?O+mxX8ZQ&vtFw1Im8qrqcbU(> zi7bmXUpY?47y4$-LZY%F$jG@?>W53$6S58$cTA?k<{ESjYj%T+B|PoBJH$xh4? z8|$koux~+lX>_UuBgk&KnF6LBogGa3IQDT8kQkFL%&08APp*4|b}Xj_{jk7o55!KH z$NgkHVE1X5QlsYLg2);dt*MSMhe*iQ@WE(loiLewyIN)5dz)}O*xH5x*y)9B=Xri_ z#d(Vg@_Wi~&f!B^SKgV?i6@!I>_@`$6I|NEfu3nzr6T@9M7x07NyUzLLX3emFf4og zWWz>tZQPDR>@_t4Q=%I(3(}|OxSVI)K5TnXuMAr$mv9x+xu9J_8A7l0eIyRbv^&#z zM^B>8suTKA+1`fPr*(C17IvpZWAp*KF`)=cmx{Qx3X_9=sl6FC+x-L;@7twLKb6npqxg^5gI`Z%;azY$?1m+mfITb+{7@3!zt-fa<5M46k$yl8s3{W-voF^Trv)KkK_qBbL!R zF+@(XUdr~sUK6Sv?e7OwW*h#@`FzSU0blnm*N~7hjn2iag`?2qG96VK+XXQ;RW5|1 zR-XgW>Yf?Yw3UXsTHGviMh(sOT3pIX2gV6I%Z=5x#^73*gKU$ zMq6vSi|AtMMU1wGwS)K^lqS*u6x!YwzoBE)qQf+uqFn4m(w6-V$dY!r$9@GYn)<{Is$7rtg+n`O}LzIShgr`%ztZafunJd!WOj_dT4IL zvq6QrZ0p;CE3I*jHqM+{O=zf_Txybh^WU`60VJFMS3{e&yDwJ#`Df?`5?x&?oBTwP z<~fU2#76AF_TeJohecCa3MDl)$J)#X`RK!IMZYr!F#=u za1o-Y8)$Atk|}7QxR{Wvi|mj!7X~&>lc;4PoA<#oRkjIhrh?_EbXIMoONqsxMT)?? z4v<_~O;xAYB3~tY%4IukSIk`UGZ2>!J;~-NuD-J_PghlO&YAnI(&dO1NllwC?}cd< zZQsgMf06utP$&Q~H?A=neY;NUG9$v-CLJ3C9b!y+DoGJ8QKL0~RfkgFm+DwrcA>H^ z-G)Oe+3c$P_e@yQ_7R)&n=g9T>?|8>Y!G#G(2)zL&PC>V4+#@~jx2T^j2`VGp|{=6 zI~I7B>glv&l)%2bkP29OyrCV^xk7d9CWoqL4k^Y#%#BiwX6v%exam`jlZSVa4#y%W z%ieLQcMQ^TY;Vo65SY52?a8xs0hXahB_;~y6!4iY*d>ej{(?ih0G9y1!!4D?ykKx0 zQ%v6avQVV+ggG*?qTfmy4`&f9vn2hdi%PGaE;lRN;DljI*;5z;EEE=zq+v4`Q19SE5JSL} zy&l$MdcZyi-Ww~%3O_;UoU-U=4h;*A#08g!j$s{nay|2GjGVzUhgeYnlI|#ukw9c( zrt2Jok4(M2lT%Du!7}W~wTIZy*0O_r3gcEEaNdJN#;mY#7tchw5FEZ8u~QRpK_Dd85_W|loKMC*4~`y4(2MWb2ae63jU-|PVY}FTJZEd zhKxvM{h&3I(xuGgq6-aXS-5|9v&ytKxGcBi+2-0PvL5llkDc!x&d12|511^~# z_15{O&l6^&$j+IBlU*cZWvb-;J`X0n<@k9l{zmg4P%0K+COuB7;h8kmXFkuccdbs( zC|Y_G7L-wbr=A!iGijg~V>KwsHmyQ}c_sQX0Ep7~Il2mXR7px2q`6p!4I*tr<-kWn zJu0kqhGFF4}8C3LQxw*c(-x7>xZBAx=2DBnJ^2qAGYoGOEd&a!AOf zgkX_9)fXV^o@>*aQNmbhk9jcCG+3D`tgaT&ML|)=msL)cB|W*$(8jG-HubvYs%YPe@&zKWK}Bls?fFO<}&5^#fdSF)G_Z{_}ZZIad%4 z>rAV`id6byA@sL-DH-_^Euj!q*(SxYRGR@s^{B1-g&buO^MY%{v)RS80D)QHN)@&i zGnq|W%ZeTv#kVoLt?F|7uB~5YMxI*qN*ZlxDk>Was#Y$1)(>u&&1&uB#I-WQ+Oj6z zx2v|!t-(!fZT)E`O0g8cVlP>WH!nJ(GYxPcQ0pFa5JG zbgiZlFY6^25Qe%%h%V80oMtAgJP3isUXCMUP9PphmZKp%c&q60XRi}z{$wVeondhj)s212= zsh=T7QO0JNF9`vOx!yHuXN=a=`ntCkjkg(Kb`Cm=Jt)AeQCBr<;fyNoefnH4sj&|> zoKuofOH9i$QQu;E_CaCHgDP#bjZFdUO^=v=*K3WaMUCE>nHcu7dxa&!5?C1ZHX=-> z`I`+C3Mz~!vvroC0Skgra8n*&(_e|ucd+AOSsG6zL|7y2Nn|a`=nZ&M2r-}4l@sQy za8I!&2`O*spq=?nyX;yoX;AE&$)ghk4a_i0Tv~S$OxodEI+~iPOC4BZ?1f;cWTy!- z)sV?ghHw{`(WI@-$YT)8=roNb8Id+nAxbh}O4Qbh91=9eRs@%oKsKPXM$8qsYh%3U zNe%cw$Dkb@l9&;yNDTBr>Ee`h&1wcR-UfP6@REY-)8Y>)Vmv6!={vjF2#Hh*I8bu0 zW0p+Cs?U$opj8>trrOW8^|9t=tdWB`-HZ&7&EBt|VQ2&T*zm&SMlG95$|=|a3XLg; zHtwOi$rcoC&*M5Aa=Bhttuba_Q~c+8R?2{<3@^&pYZ!cu=~M;}(wd6p_jLn@HAz+8 zV>9*Ikm$I8Th&rTaF)5!7$W2@pft$Z^lOdA z2wU(C^-~LRylL*TQH-laJgtF^T(n>s>Sq-ZH;`=6CrYDxq-hd!W9mvFnkzLeq2;pC z$qKE0akGKlFq&zCcFW7GZM$9H6)6)6HqfGicxFekT=Xg%i!r-gYV+qM=kw);u07U8jEN`8;m^{@_AwsFM{ML8o`Pq7DJ_Cnqm!EcFNM0H(wjB ziUilS9J9+p)0$H>qE$QDZlL+#b8I4tV!ZNnX|5r}(ll%|O~0C+r6SzEn6^mM7}oXT z+I3eZwC3O&TU+SnXWRGpjbT#Tu;q>1mBOaIYAx<|c^k-?j@2o+QdcFpXO+oexj!}? z)P`mu)>Wx$Jv55Rk7-H^^~cPVV%93#s3W^cP>nS_)p|Z}`qF43@&IUqGFJ|&hKAng z4Ps#>xF&|h^2-_*;MTGmt?p~u?A5B!J4Fu)o}Q?k=^~p#MQ20gbY4IM>$r;>JTl}nB|Wds zdE%sn=IA<-rUp>&ks(^4meR1rdA624VG4{91{YbPtR|Qwa$o_wDx8}mAqagBs|l7N zxh`sFS&p-?+Ko&BdL{^swmR zfH;oGf=hH@Zw-&GCQeL&{RknL@y{IbW<(*GLz|5}LULf7EpKZWJbrM@5>YSctmvF* z!V*(1ptm)uF~xc?yJS!^MVxnZxr>RKw0^xWvsh1V2A$C~eJQe0=)|ENFvJq+kQ&RF z=Zd)6&u$J{V?CpzOJ_}#TI^>7_UtoPYFH}^vV6v81CNa4I|vSDUtJ74uO%~25^!lb ziWIbRM(7)3v)(1P%xJVgSBk{??z+t4&;|{&v(g*7wvt>7sug*uS=&b0Mp%$Ff)-t( zNkcf1G6-EvsAedrU=Eqrf~3;0z?_4=gKdGOQNYdgmi?$)@QM);%!q`7N?&BHV6p(q zge*;>8K~gWz)}S<+P1p1hFa}m)@?dboQrjEX3f1?Afq;=r_sjj{)Tif&9o*uGeZhi zvAHTlO-`le5Gju6V$yPnqRtr|Ioe=3$r(ib2DLOj$57=`nrN{SD~3^>gk(c5;7N>% zMeGx`0`8by1^FeO-2tRc*GnrqMX@;+&i&P3X@ zKHbpP=LiTI|Fqh(wR*uijJg;_l;-?y%X)Rq*;-5islZ7EWjEv%?SIQfOM}^#g1!Pr zY*c_XOS%q^T37zsWLE!%JUT8-VH4+7TGfIoO7YK7No#P!+_Lo=$a>c-ku#ll&VF}M zia}zD|I64xjxlTA=`IyM7pGg4@iT2CLYu*%S<7LIxyY5Z{%IO|1=e(>jWm`IoNLaHQht^Y;#d*vJc!7a z%>{{zR^TR^e2p`>-Vmm&_>07x1C*UCwV4{)Gn1xGl@`I?m{DY!W31o3_R<^MX7Od! zi^Agbk2WoDp&B4XYvGy@^tgfS=kK89ohy{hW`Lj#3g|S^uB1hav*C_5cH>R>vuoOB zS6srfE+v-#Ui6+e1)ES0v{L#>&*! zi}Vad7Z^8a)v*;MH{ZE+C?iU0<{Kgh)*y45DMM^2 zruolGjle(}v!+I49mx?K(!5KtQfM{16I!H*czWsal7w2K%8ow-F)+;|t1uBl%Ice= zGR1%_FG1YEEEfoVO5yBL=`}S##MEq0K3#|FQo#7Ocn)?;))Agxui2l$jWeIUGfS|d0xql z)6)m#6DU;xFOJLjU7Goi`0+%S@3;AZLaSZ z9GpGtJ>{u5aw>Sv2FGd+=sY9AJ};&M*hPxVvRGc)921=>&M<2r2Blwi^b5z_L5L9@ zA&wE5j2>s-SM9aZpeX_(12vte>mAOeI0)?mahbG*&ROPPcDMBA@EMIZ>K(c;8m}=+ zf=yYyU`@MgWCXOSxkW>~@hZAXPxEFpB8Hx+QQ)fo}EV37&BR~SPa0dznPmN*J+|6Zvi_3gK7btf+`D@ z)D%Y28jY|bWnU@@JuKAp4EosMzY`d|u;bwXu&s$Ms|pj!d8eFnaNfg8QnjctYcB1b z)p|xcib1b+r-n7fsz`QtjR_IVLGW5gZPNHWrno1u^(~PUYms9p zN(11m`OU+agl_gR@4FP#(Cch*83~RS->f-v8P%YOLF*DL*icaM7}IDzHq%9|lAlb! zP5H^OU~@%Xq{-+^rKwk&b}|Q$CB1zS@#uc6TCi_TbUKN@NG zf@qp&sXicf9W8~t@VR0vriNv3(=>z^_nw9Imh+3VcYwA-+dKr0rS{cq6eU%gnR5$i zWhfFi8G^J~*;<=*p+O9r6bAdQU0a-F6fK(es7}aD7@Vi?S{oKq=haR(r<)qz+ciAk zT+1ZILIuGy?WN^`V;AeC3Xv;@`&#O8!`3d`{VW@FjngZHiVSMCb#W!D zFq_h-ZMyY^ie%z{EEJ1^u4PJLlth_{0i@fQj?`SaSe8q+_RX70r30j#I9JSNWCPL5 z>Mt?wdW+<>7Th#+&^!oi9u_TTsW!j#MW0aH%T^Prxq!$`uLf(k-A04d;*v@Gqh+8& zV_YOgBh_fljnR4v^4N&ADVjuQMOCydz#8SoP|3ws?`zj*4qvtK5YrAwv z)x(-iX>vF75WyAHHa0rZ*fiXg;^Q0idIN>kI?1C@h|HC=yd&m3C{j>sw}F0}K~za%#3@vDMCKxW#N#l0+>kwaJE5qn^}pMJ{UdkSZ3lj5_d9G&&{%=Viri zOjhb0o`D{su(SbL3`$VP7=_3sMDd7U6T20&TO+FUy@#p8kCATHR1EjZ!R>AOIkKKd zj?H^a&aw6mHzsFMC&}WS{d9xY%*3t0ba*6Q7KwvrP=x`)YDT9SzerR$4Qr4EJIez^ zMj}&scDs?Nfv|+`Qb%+%VWyy45}@}BdMAVk(RHzi~-&Y;_{?1X7h)>A@rI-}gB zCR+^!ReBFw9c)EdAY9uoxLUV)a(|!4W@R@xrg>(LF1ZPYgb<`W$S&#I0>xa)q0BKt zNZD#Q$2>)%Mn;XuHgugM1Yzz1J|udiGtWFH-ZJqNuZ|v{3QrrRn@gn4MXD+Qz-12fdlM1X2T8q9k0>fkk5xWV-2GjJt}TMj8$@ z$3%6D&I!sXG6PqPn~P~qFTz5V-sSx}AyQG5A*Aoy8Lcx|@f#c0?|4zI>m;rD0}d{8 zaES;9Eg~g`goKVx*>kY()3s-|hianSwyZ+6W;L6FI88(Q{Lh}2_FrpGmyJK7&>8i( zi^eQ6RIt!7eB&8Wit%E{ScY*DJzYp2ucNn0;2Gq{}9croQ=IPeMoE6=~fVml)E80pparVz}e zCuvb7*Lh;}u^Ee^(4qv(!(m5jx|9v|nx?NYjmfBTdgo$RG&R71nN6vbe7r(rb2g@} zQGFF)sbS=$#>ufyIf6~7nn7)iKQtR+W@HXFs#a;5QmI}ax%!F?a1r~g zG=c`UNb3U<>(E&;{j)ZEIYLW~J|08~u9|(8Gn|I8mg|UOUK3N+s(ph{%rxuX6`QyX z#T8n#h|%&ALJR6w~ubp+p}n?q@+>RVT6rX z^;!YEE42Su4S@=)pe|RHPz}Hu?SadCeN(IvX66_f1;q6X{WjjG%rGPsoVWoW4>01` zkLOV@EczW70~(Zt%gsY1m^0}r%&aDJw^bN=hmPqxbc=*0dIX6*tOH?&(a*#~fq0-J z>M&WLeHWqgM$5J+fCb74^yv+PHWA^Qd0B- zvDP4SNQmwfjW(G~WowYSOaGoXVVC@9Qb>JFhG;HOnIt}&57iinmWHOqyFVGGc(QA! z9l^dO+Sg;ryENP=dcI5#Ck+Qky>rPS42^eMK{j17=IKepgPhUWQ)3cTg)k>HHyfa+ z%~#Q+)eO`;+nBX-k`UcN;DA#u5#bU;A{AwA2sQstyqqk z(NtMqInTJtYSO>^+zf`SMYU1C71h#F%IIXxdBL1E7jzl+DFGgpD5R6 zx|Z0gMkUVl+pImGjWR0sT+iwPT0wmzF1X%kXKIE^)XL!L7^h?&ymCQ%DxNjEh@)|^HIb=uxS8@-`w z>yFV>wuVf{QugI~DsBjXs+=tQE+p5_Tocf^fhKl!0=zORnB*bV^CHtmH|F!1DU@qo zvGrs6Z#A>6>O)}+KQps&NOB)#6ZomFnX#f)>1X>|F6*ZJE^B2FZ-sT!#d=yiEEPKb z;!c;EE!JqOvhGiCh5D3kgs(crT)bTz)Y!NS79nT8R@*&mPrF&*s^wnPFz#HuhmD3| zQ!uNW=!w?&i8|14T|uSf1Zh*A)@H&MPp=GG**-?=O$@80I=(*)I7(g`wr$jW}NhV$23Qbg->5Lj>$C|?u zNf0+8HB6OB9zzk=Ur}FUtJeK=!24O&gS{x{qbdtGZIQ_oE`p zb?xLFz~a=TRY6iVydrdNGJrM=k2Yz|Qf4=mE?oHUvHpSLEGu>UEA`C=MIn}nVs_{h zbH6Q`K-C7xuZ?M%hBm__wfjw@N4eO6Ki1I`9{7mX$I z`qpZIB`qU1n?z-ru%Q=~CflIjvPo&lWod{Z8O(@-&J1iE4D@uotn6>|MSTO1cy9s%lcO1TVELUkz zr9SPIF+6!$b%ZL+t2+L%W1Z%IxVv z8X(Of6=<$Yk6=rM-MxgI%pEMe>9+PGmvwMH3Smm`8hi`iSp63nJSg zFz%;GvGdA~7tTjzHuvrj(-}H+a9OYH0EgA_BG+?%cjSptIPE$vIL8m{n7xhf5mF&IMxc2oZXerBB8th^7Y5N2Wf}XuVHoNvDb0*u~T! zEbyQyGcd%!Jf*z6(ZSlm+LroEmAW;rO>+B;Dd*6ctEkwsx3m%_+a~&pSrk$;jWfbl zoiS?xoJ~nObDI^TvaVxB7^PCmV$~M9=6Z8DeLigmlE$wywI*JoFVwuh{+RR(XLe=ad>q2_p(yweVlYVZr zv%+@}W0Ij{CPuWuC`KENHX!g;BWuPfl4D*9uouBQ@ZL1GE>WSy;M3^LMO=gq&r%(O zOUxW+G;o(ACaftg{~HqO?=!SaS_A3qi_Lw_nocQHTt%uTvKdcG6LFB&UfVLMHVmZ3 zccN4j8R$`~v0U@#v^K)6e|E#eGe*>A-Bt#{jl(Go;+}`Bq8I(O#u%|0RO&`m+kWp2 z)=utU^69BbU)r+0BG432MI4nq3{>0(B9KjHR2sgLVHvT#^oHYGt}eeT&Ci3@%{Z1p zHU&9M_hgc^S2UN<)WPq^rHmC3CNE22&TEzJP1YVW`uW zTJmLA3fo_uVSv7&pvFxoSZW?(HkfGv+}3+BBY@iSf2C<}WK$2MEi#!6MjD&j%$2UL zx9ta8aHTXRDy1N+nydO8wW8ViBVyAu#I~s`1hr;j&{VxNXy8UKyHN&i=mq6#j82T| z7F-dx=NCsd=(kN#UYgGo%vvO9<;{|}Ch9|dCBfZFChHBrufu7c;wILnaeRO6Z z!v+Fb=%&RYSn4xuk+r5GLYsAoMVaqB7%q%P{LbQIi45JO<`&BrbY%8tBHX_e@QU>jf5q zcHm_}2s2@sV4vWWd9sV2m1%XOWti zXnJ$6%9a-{^^O}|k4%nJW8`slJTHzZ#-deKZ3Nro}v zQh}~w!l^)9D`Own-s)K_98)(ZN@wSgNf;-HhTa672{y|T55Y&G2=fqAPGQkiN9tT7 zJ-=jQ6d6$#;(!^K{t|N+S$BcZE3QvDik-q@7M3CTGj<~M;!W2Tleyv?8GpQH2%T-kQi_evu3M(sZQ~X~0}O%_&r@ zp)HL^);by8m1OZy-r*cSu@GfTU}=qEb}JO4`e{giztCvSRh(!#PEGeyG0mjY@*O*b zEtG@S7!D0VZa>1F7)ltEBWi55fH{W4RkD*a+oorVwN{ z&O`1qT%yuv6GY9~&?JDYMkv&?-$}}r^x64WN$;e&>1GP9S~DMGBt&1O0mKs1RFFIo zi$rpjcI*;*SM;>b;Vmat&0r)oh~Ql^*y`~ta108)ro78uqv;A2A7gcL4H$}=OmxzI zp3Vo!`oTs|Tx*%8R*o$SWy6J1PBa`nWrI!{&HOAj1C32<(hA%Z-F$;f=-24-Vy0U) zb*VJ})-cs1UOXW$L-CDTzC|{rp|na~7ZIB3t@>%i2JvjKu#pGRDsrk8u2cCCbUC5HZel1p#p=>p46LN}_DEl;%MUSIqNl>pXi|lU z@9H!UBfaI0DLbW;D2-Cw^`cq!x{c z-K;2;%2UvWLltw;)let1D~`0NmNtt)wMH$Jz{glLIvcH))%p`4< zY&t{bGPd-l^(D>pzUtiA(rdGRu)4`bTiRmuma5US(9`@f%SAbcnQNZ&MKk&+>6&Xq zE^K6{NOA-tbFn3qjc^k`X;8xko#SF~5(+}oBCyp#cGIf3P(-VnNI^|&PERFsOAGM2 z+!jzKn?*k%?d+^hW{X}m-!!|DtS4}m8I{cG%w}P7VVo9dm$-W zlZGNh%?B#4zG^`^q|w}!Br&Byv`8jcS)&-6d)a7vrJ&DJY+;Jur&R0e(li#4PeMSP zniY4}THE)DT3yQW5GP%?YlaE280jdR2a9YRTZxvuIVIJimyKo?=JNGxJs?`k?lO_h z1Cjg_n!xDBfSh{V$C5+0;nyQ+xL36i6LkCd^(7qC!_3`fyf8e&dWK1pJ82h$!4Ej^ zaf~dt29|S=zu@V0fyThNo|p#5ytQN+MnodL>zG2KJ*o)H(W4p(TNAR?A$^ao19Xng zb@*k9J_uoAI56O+0S%F9Tr-FCUdOfRWW6v&&q|d(%nbW!@TD#ioTQNS6+|~7&f!z_ z#yCg97*d85iY&p8c6(MZub|%n*@DSOdK}9x#Z~M9-2`KpSq>hiq$?X&Yi5_4-}M|b zkicwAn4O{0l`fTmn_S1C8Foi_I>1SF>?28&I3?O>^eGxjdRJL88d0CzJmZuMYx=x( zS<&x$Dd%6=uSojKaZV`Sv>VxvBg2+st6#9{17jbED+@fgD5Zi*X4Z;oGNzdmWi%Iq zVtT9)(lz)Y{p>l~NK7JY1ve){6Y&W}QG?7nCk*1)Qb!*g>LBZ8i`}X z#gIb2LpEqh*R9r!k^17)NO~B|*~QtwQnI|O1=gua1exOKv^Gq$ZpfX|+Hom2FlRFN zb}zh{Vg;jgjt!EzCN(NPH#)JJG={%Jh`HpKe%(LA?%#sCG9WHnYoNLv|^~EShL@gGGvG7((u5vgUNX` zHH4kI#)(vm4}#N}{!B>caT>l?SA5YXYO1jQYSmE2nnFcJHJ=p8NGMaCvmIOHYbm9g z%?+(K%O*s$Q7{cvHA`Jos>`~>W@=OV&9=UfhT5u15{V1 zMA?j{-7m8FM;R-`%=5Q4Lvt8$MRPOaDu#{ZW=xuwu@>lBC;?74Tl)=jqISb+3`}z7 z*2Q>hb)D7H)QjcKkPS!5wU~Qq%%3S$Zzxq4S~h?ZFG3MfXDX%`+UKbp_&o4Qw&7Ay z*vx!#mSLJ1t}Sv%Ow&-Ut*>KqBP_0`)_6IpVU0A;(HEh7HPxXsWOYqvnrKD@+n=R0 zzgHa8+UO8h=`nHh{oOR9$tD1C@v%=D9eP7x1FD``1EHJH z1<2Cl@C*!eD$H>t#C_H>5`19x34L>;5b?NK(A^n^h;B#J$24`1j$!K2NfTf2fDlKM z?)NEdJ@k$dm|_GkDdIpB-`lfTr=a@YsBO~%_U6dY3$7PNU|d?EI;K)#Hsc-%5x=Nm za4sf?ks&IJn2P)xx+ORDhgh#h9+}o0i=O@H2=h#s6+a1XOwE%QC3a@e$zY>^)g(jnr5Ua+p9qI)S^CHoA`#I@AT{NW497HX{JQ-zpGk9@HLxwf- z#XLrHLufzCnbaZE<3)`Nl{A6T(939AyJ(JxF`Kj4`6fm)^_mQ87MgwyltiXF?6y$$ zIRWBKC{wx}Oh)p@oH8%VZ&+btvlQqe) zP=2NAmK#PzMLL_NxM}**pe^?&u4*WuL1n8;Y*)%_%@g5B3HA}8FxhicB@T3^eL6WP zHR}iyhuhalelA*FhC16$+`RE}ljvMCCoeE$MG8$cncv1d(J3Yr7Is#UGu#+cv=>_LXKA`j3zl6!(+d(eF>+~Ou4wlt<~+gbR=DAw zrI{yR8^D&n)|y#pI~Iu*fhkEUTKV=qru!Z2zq@>xWU6M7(`i{lr5MkdErkXfi;HDJ z9&z&v1AU$5?N83$*iZyPN6PS5N%_R*{Mof#I4a3ZbYw;XG?_|l1`Om zPE(>0GRIMC!SC|qt7bkFDPrr;wW)8`V*XV$v`vHH*i`(M+T89{!F8f5A@f)%;iR#M z(JF{8Q3p~<)wz)YYfc*Mq+G+GbEI)G;O*uP^wc2Eq_+=O`~SlDYX$S)a;guYM&8H z6iqC2Sk)SJQ4f_(zJEP{%SmH^Z#(+R5i3%oMYQ62S(jSeY@1<|Zu~4Q(>T>lDvz{O z9_q8qYYOV&R04wSnI$Xl6>+)Gp=)no=g1DcaENhlp9=wk_N+9bamB%Ii=Li7c5L}A z`hyDwwo>CTEZE;)G3!7#b>IT7&nU|_)9y%M1)VT46JsE_k+|GJq(j!Qy&fQVcHPXr zTNNGFu;`Fkn8!%)4)G2d6`d1%AkLDe)$4>7;*>BYH&$=1BU21SiA){LTf!8y7=9FY z-p<_PE(qN$^jpe84DsqT8S`vAR$U}4z^(IQ2MhE}!0L zYoj;pJ*Rd!W}WGxunNMs4y<)XLttyMge9!~Y-=MD=B!6^HI_J~g5ZNoy0BoyqDzfI z?2P8?w5-V-!x1xlB@rjE0DN?GW1@*7(7T?&duG-}D;1o*qu$sI6Nu4V7d|ybE7^1t z&D6uwGYBm1Du%lCh2~mDNfhPD!E6EaLB#HNa^v(pEIT+X$|VR(+b72e z=c95GcwXSVCes*=b-0zIIW!6(STE-s_%yT-N#;99`fgcQKZ(Vl%`r7u*666M8w&(% z=6qU=^P(t0)0$C3^Mq7uCf7!9dD@%iaCvy|qT+)PoWsqjsnk%T096xva^CcKKRdtZYIW;7l9MVe1v56pC$C&R9LHHRo`qGC|5SRmn8-^4LoD zSE)^`A#&D;rG~aBgs4`pu4b(i2S6!KdAWHjMW)2klu1L`gLdWRyX2~?sWxSaWD1m7 z`Mw}8lBw2|Ro1v>UVAM%b8vOm zaK*NtjM^B=R55i9v@DcPTLifvY@H@ICmGQUE-ERp)xTYgnb-bEH&7~QsE@JQLQA0w zWPM>U`e$vB#fru{<;e|QqnD(9&)g_#gFF`Ta29fDZDd;jwR-tG-V*oG*R8yK0+OPcJ; z5*%-ve$*Osk=Y8Eeq{p@%no3U-ZYyeWigBmCrT4%_rB1V*+ko0#c-yP=D|&VS1ukZ z6eP0DiNy4+&PE??Oi#qwJJMp1S? zb!OoXa&UQBqF5~trWgW7bg|16XL`#I!zXt%^}>2O#`49U7F~kjyvMUh#{_V%sqWVdWLKm*OJwj8I}Kz!{Xm!_|w9 z+qQOCt{q>!u+ItS*DIi{xLG&!R=ebzO>@fsJCOx3xheY5QiM{#i{&r;8L+e~E`n z1ulsRiByGEgtIEVfbxO}YeOxab;~(Vu}Dg+>5Cp>=LlV7&QUL(5;z~s;Wb(HJL0Sa zBstS6xRBmcZT9*iwXk~`Nbh>qbR|dV1RzLepixa}a$)aG#^j9xo#GbEdCAqmylO(C z(l90=i#|XX6t5Al9*;AMsIjLsx#cF~4_~OYG%gq-TH+R*lf+~oWf7MA&KOhNgz0y^ zI2;|l8P{|uE+(miGuDU{*uGLATNF7Djf?}~iB zlp{+dy`P08qeVVePQs1aN=m)j)>5rEM(sj35k$Snj4z{Ug*#t9PcG6U`bxLls28Nv zm|3c^VKCSlzT~E~y*{Z;UF{um3{1laYZ6!0Y9pL0HGj0jJ|nhHm7rqI{F#H7n{WyZ zyL?aQh^lnbvdiqpIcW&Pnr`Ee_&rV=R9A zO=zfY7-qZE+2c#jEl z(&mQ0s2y(%)HMdy&HD{+I3<};GG(ePQ;Ug=|EiDsz%Lq@M4lqps-ZRa)hIzWGsi-e*j8fgI+Q*e?s@m*AW!NJZ7x}V5(Q8544V0$bGPNeW*$kTo z4XVp28(VE|{0+miX;nH1awXDo0kz~`w$T*ipoFN&;6v+-Mze{NT8^Nqy&qIpL!?rR zr4CVI^G-@3xi@P*3%jL36gSox_1RF}Kef>Y#{A5*`l5+8lRv4H-7*@|jHc?w{4X}f zO!fU}UCHY45zS#&RX0_E8p`pZjj2@3dr28rxoZA{GzTyndqjR=La71s_lV_?j)qJ| zEeVRvQ76s7MH-s9Y%n1*ofzdJ&zntCn!KaTR_JvIN0wV$(f6$9eRP^&6l5ml-nkSV zF-?($D9$g+zU+Zvc_;-&tFW)<2|EL02r#d4eny8t*Z0I}AnwmN*TZ0|ehw^#0d>lX z6;5ViZ`vf|;zld3+>l%Y#~!3}2|bCx0Q;j7w_(dG{hYLilLorMayR?`KU?n|Z`W1c zd4Hd^_CDoSb;*(}OSWvuRqogZY)myay(SJV2`QvblF3ZU%$p3!OeV=Bfk48fKqvu1 zODLuoFxV9L-XvMJ)qA^Fx1DqLUTeL7tg_b;^Wk%`ban43`>egz^E|&+&>K{^o<}KK zqmEuHI8cf&!dfOE?OHtIIH>6;MQ`8_-Btm86NajVLfSslkV^SzjX-ZJtT5gZ7MH^L z-9-%gHIMfz4obm-wYbXQ3b1X5vj#oTsLDGM5_1C4v~(M5yhc(FYM2MxHx$N;(CSf# zDLwL86h8jK)s9xr{~cu!<7l~(qBbm4E};%ZI89XOdW@;*S)tu2kg}js6}I--i>mf? z*fKJR0y<$Kqd`VH_C{agg51M~`*L6$${DnBC~Z@?xl^8|F3wW9z8_RdP2K7@x@ZY> zSy8w`LCYj&NhOw+@(t1;6>K!9ifhm}l`%r1K}_61Yv)aCBBE$4iJDnw$VtpA91vn% z!r&?9GfQ}qBIpvM?lGFQxARtI0?)}t)y#U(IV+A!)_Av!D4;G6$h>f1Aw7g##4ZU z(MueLg$&&~dOW0e9$kDaRvApB-zq!osF|99rUr14F{32Yu*b79?5DBLveEjiVbJ(S zH8fhr`TIZ6owf3jDPpo%jiA495y`YJ#BO;vZ>=1<@U&5n`ij>FItfjoqrg#WMXOYS zIxHcU!fO|)1*v>1r=u~CBbn)GPOl5H+AsI?aE)re2|ss3UKO!kGx0hN!72?SD`}N8 z$%bJu*fDl&5AHvf4MqPP;JBi zOIN2Uc)h*5%6joe+Y~3#F;u-V$MEI@{$Ob+a|ywSH$0I-p#7s;g9@}&7aS>F-05?y z#$_|MNEwLJj{gTdELp)SsmPS9a7;U+|G@2OGmjzEEYLwS`e>r0T6Y?{7GAG)slaZE zy}TR^D4cB&-`F(SA!CvTwjOdrb)Lg+(qp(pqqIL!NN4)HT*rp6`N?cD$+pW zR9a#XXMFUgAx~L&5+@_Wlck)N8^csna;|GMbB?IDa%rMD{6HCW&oHWvkY1-#Ic?B| zP+K=dH;wLbL;a(5O(7y=Q6dbPeKcCGpm~fO^n~2oM$0L=^w2ft2jsM2l{FqF6c(z< z0?Xca%ri3~cvst?hcHo8jSt5TQ*M`u)|-65_}V3*b2iXmB}YRemp&r%6pN4RK=Lqe$w)Vh&RV1cuiV8{CMJHuq30A{-WHZBs>} z((JCeLJhkhX$mux(`A}z3Fb8o2O-cyqJtZab1hM@PG$&@>aH*?j6O8s1a5{P&BSx) z*p&F$ghEst%g2|netaqVxos>=?_h9pj%wZ)NoAxV8$laIn-Q#72Cj!_ftEq5icTSn zELnuIngu(+40=?q#@fE8Au6FP3)G-Rtqgr<5Njx$Z+@hPN>#WLDqV$1zMn|xmPXYU zH|lMP%WYC3bt)=CUXD$nkke&-;ly*f~sJ|W55g?+G*beYDXnCu4Se= z^XCeKt1Q?WBaW6RR6hjwSPhkLI8hE`Ek-IT<$PnPOXk(U+v#i2G~NSBsU|-`DOAuA zT5%XH*n*_*ce>dZO#wY;(c1ag1>>{Z{9f*%HKQslgFuh9n4oD^A;L%7!t2UgLM@iU z7}|a=z(Vd2A04X0Ixl14ABHemlEs~O7Y#bS1rJD4gu~8+1})7?1K1RsL>tZ?9U3+j z>Z&5iFM%Ewh7juzy1U`aozBLvbd>-QT(dgj3iTChy z4aXx99BUPved8%xOBnr2Lj0_D*aB)D{v1IDml+twT#l%#OSN3ks^K#SPowt?8}?;< ztYp3xHIxaYP@DK z7~OcfsQ9xOe_yH02rddjB1DYqCCu}E zLgAvRRJ__DM!qzQD$&7R0z;$$xKaUSLjj%fGt(5(CcAx;nxCc+&d|BjCiXUW19Yc3 zqC&7&iz7rebdyNNeOESE$L6ZnU@0CG2U5`)zR{Rdp5~sFBYM_04PlCa2qO7_^2NpD z9Y0;BM{=3VB_S^{v-Az!m3HxM~Lm8OYL2^2QVT1t~8PoqdpoANFLjmzxm+;Ww)pp7R=HX@7rooP7W zexT!@FaD~{hM5UXby2V5lF?3c?HhTiOAcGvkj7>AP25x@Qqe+tV9D^s41tquO=B~s zQkyD?=I-|cA0=VBDc zSw|#9&u03}Y#7okfFYDUWeerTF%enL?yE>&b*gciwhaL4r=G!7CVf`68L-6z*2QV) z&@CEChyHq4F+q>mxWf)Pk|t`QBnL5@%`JpxD~NlQ!wntKQInujGu-TV>3z$P);~N} z%7 zEF3#XcT||1Sd8cz)t{r?(a=%!=jw3X+7u%rXd{U0Q9FyF@Dub3N?V|cHdfV8D~vJ$ zNpxrpRvXY7qb;?oz2OK@8;2_twh$`oP=#Q+7Onj@UWe}&Rpk#^3$0E8#-MxFHzE!O z8gIr?L)9}B$|AZ&ukSx76$(FN9aP?+$v970ExJAsp0*#dtZR?5tZ1`)uE%a`n0Fde z2~vUTLs2X2yu;2rbXU-YH{1C^ps6lDPnC>?aHLR%0qxPc!&>b6A} zEmWa>0iuCjftZ&g0v-bIR8%w~(B zd=d;cOvwMUH1S=&;jBZMpz-;QIy6X1K|9>eLeKeYrlXTIzG+bLbPL;$4M<^?G7-aVW*lW|Dgphgn1Jq6=()m=D;1B1reW?zjOZ|htb zoQGB-HWJo9cPeMK^>kM4>8(06`3mn6Tm-~er-%;UT&iGDr<~xewv=DM0H5 z%h@a^Goa_GZqC>;x~Zdcww`5Jn&7PfeM@e{VuD+CI*^n!j5Rndx+1UzqDC$(oXARy zO@cT}?zSG)M50_mFp1GiQNJUNsxSv^vQKEp;L$lXj3PM5Ed$+YvJP?CVVFl?NNxfr zLp2zZQAl%UQ7rUR7w+}sc{E_UZlXf1-slSb(AXwjtwsER&Uty9AJl|<%{44ON0Z-< zKoJYJ*vJXd`Zk)S1S=!e*qFy`zQ#}@K>j)TS0usj(H?b3znb9%nRg;hgnJWP;VA_& zY{^c8V!0Uhk^-B5va3gI<_Z|+dQm&580PnK8fD9-AkNej*(P5vURV*8eb6pl^acfV zLvS&H65;~Y%Qs~qOC)Hb5^5LnrE*%Q1j?ojnT0t4pfPiaT0NKEqKZXtEL3g4+-yTh zl?-Ngt|_i#(HLVj8tt67WskbF++fA;ftlS((i8^FB3xe=O?kvL&lwJ|$YM{ovSd_2 z8h2ThG-1lqk5tqAi1m~%Cppv_HuPwA5*(kL$y_}}Wt!B6civbD#~FdjZqU)7^nFe z((VmtLSSy-PpEKz*+z}%AAg8n#s6c>n%mBpOq)g`s5GQpH*{e6wQth3C)1IrY?A1Q z1tAkPAlj)s3)kI-n_4;B(8A-S&}ABFV-pfcn376^IR;9J4Ow5V!Q*q9advM=n%rep zRVh%`WfYWVZ7WMUI1>#g+Yg4#l6;Vh&59kDHGXk=m_+IkTeQ-ktIAJ=Rkm;0?4XMv zYM6v@Z2xX{nj^^3qnzl?Guv%bjI>$QDsjq}qhfW^rXzw<8r3P#Etr|_F>~@Hy>g0? zu>vbSC`xRxKvnjj=wRm;d;`%Hs7p`VvW}u%pq-)^2qj%C6@@a?p=i*~QxJPaj~av3 zmfAV`Dy&@#g=nvDGKRU1MRlOG7F9b;Aq)_dw%8Ft4?;+_0$T~iDTi)B)e85S4xQt` zQIt@Z;hu5I4~PN^qsqcZ-h@uGP?odDCz*6@>e{la9&o@Y7AjDE;~hJVMO%kd0Riqi z>Yjm)!M024mTzdC6OZW4;Wd)@AZyjJlwFM-)Ktd1J}U9hmROJGy0*oPD%^raYTtR; z!qSRoXUp$1s^_(a)_QkEYr|PmK|N<#aDBSn7M((~V0-kf4O-zaz^LOSJk%7yc~O_) z7LU0c3Ty#`fPNLBVK5;Fuhy0_qG3u<%AvG3ON&t)CeXfga6?t05cGlHiqb;MSzmmg zHWG9qRLU{X!NE~AwM~Q0dv{5zoOkuKLham;F;gi%LO`-cG5Q8LCCSB9#M4v@X(}Hp zzA3B4`Q|R7P4SvZW4>mTW8h%mhHdbpGimhCQ;kV6b$q?T5W1ihw3ILsG=zl%Q^P_H z3l*GnFs)%;`$&pP#YR5BsBE4T(NuR&xlz9^y>tei$uOp*7zr%*G zdhL-_6<9Li%Yq;L1d3@BdmGk)_TSWr+2+Rt-Z%!7@j681+1{x+)Pc6DGp)P7Ra_H^ zlAlsGHoU=+GPtw2%%BV4@;ruA{O2${lo~RzN}{mrbozrX9@m!bhLk&=FH=8C8uAve%>FH!Bfy*poWvKCK z?Co7b&b+0vw+MI61|uq$oC+gU(Zn>kA)qiV=xD0pvaTdGx7qJBc@_=Co}rV?O=!Ze z`JFmrmj^?Z%>BzX&74O7ZKCR>Nk{q+T}A`QXa|vkD>lQ4B{^v(`dj3UhmJ`?!;5M* z6Tt@@CsuhtrG{?apV;&4kS@@LO;xhtfu(UIwb^S)eEfu5XFF=5^b9wI&4xzSn3JIX zw2`^f8?6vS5qU)c{ZF4u>Sr1nv5Nt}!7WoxNqZ-B|-NVH_+24(-Kg?blb=f zf|?Y{;pbu#>S!pzDYGvNgcXMg9SVI0XeXqY=Y&yJ~54xe1Hn*%Dz7Nu~ z+Uzrvv?kq<6?uHV_!?}3>Ng;H$Tua^Qc5t~iL~D^n23#jW(<>h{Ny6Wkk%tM;lrdI zNi^<;^x$a1hI6Z(d|fg;Db2<3>F?n^DF2#{&QCMTDfFacu(-pZ^brMx#%pOLOm>ye zjuQ6Nx3j<5-G^*~R%Ywe@vw#87=(3=#`oMs?GSo(>t-+Y^o(sQL2hJfSfg0(H zY^$MY;UNt?wT?m4NZ3-CD-5a?kP+v#e+r++Ryp5@`D`{%gKH^RjIg@ZVGS*g^exYu z0VgYq?J3m2Q%jYN8neJih=J*7tToi8!j382V#T~O)C-m|5sF@kHr}bQK&Xv(?lfb9 z)jkAIs-VlVQ1uNaG-t|4XsUhYq^II(&wvmpl)||Ji=pitDljD~u?z;jiXE3Og=sOU zDrDfZ0mXUa8*M!ULp$fQ2etJ)?cfR4STO^%(;~xiq)YBYdfDMDB`uv?G&fv zP2p4=x+sS$Ew09!spB(~jaUljO?u`fGrtP=gmvO0D|8gB#My=<#)cLsgW1a@p5Ch{}6GEKwWh12_m=PK6HHi+-7VuPFL6_dQpr}>2PbD#B zqJ~r{N%@T0`l2~f^2kA@WbnW}iiSUKkr z*3cL#MH6L##aR=un+&D0O&u8HntW~V8aHyHr$yNNlF?Dnu|-HG8k|Xf*4Uwh0LeAz zLu{w$-O-GMU6NGMcnYZ8>!9fmR9@U>=!fKVPKJq~lBEi`WW<-348a^m+-a3mq{*sm zbi-+GHu4kn*jV#Pjw+_eiSWKsf;5e%L3aK|mEe%isSMlnGH|)HR`S;+VImDj(E+IO(O>5)lC7BtL1f&7y zu%Y>l)JlhtjPkM!!x+JlXbGWVZ2+J~V-~MNL_mjz5cv%s(7r^Y4X$54QbPI9GGtGY zw1ciu5C*gn%c$&d#HWM9DI@Bjh1-jfdyctxxd2R;L>!? zHbJ@xl?zIi=tLKW1r1fy4|JS0Nn6t-u*7Me2{dONbQr;KCLoNNA0F9e?007IR1k4) z_`ssM$8B_owi@S5%8ByYLgnw%aH!ji2IpMJo{jsfN>Yc$nc4Xw3vqsm9)=LR#{z?*kHJ76 z##&2Rz4T1F-Fd_w1Lc^Vf&QRoW}#2N%nzq-004jhNklzPXHWe_;L zF^nyIL*o;tX=}$arPxr8vch#ZFyCjpah$3I1{&!bq+j_6g>cUn0Xh?7uqvL*nsNYj z&(LdG?3kh|HK$60>s2f|)uJ2}h_Vz`umit`n~tS!dk1gn`vP8Rp-;$HE4?l=u|EW? z_4`Dj6}I;O#Tj438-;NOgGCR7N@`{e6jGuqh4g$3NMZ4gsm7yMT0q6lrnVHdptZ&n zLanUFzKuunL$aDN2+!`X27Cs%r*AsuClS|S1JA|xuT{+ONJY=+(?p4|1OQj!zqPWm2BEXT+@n4 zbm|ULu1z`v^P@GYz@=!?t}A9R(l5& zM>UOAYDxp8np`s|k_-dlAX z(a0AQ9W3c?W%wX*4N1gFzTG$XbTbfX+*lJLoiqz|Gq_BQ1j#0Zq;X+--bkU3I%*on zv)mcB@q@A%H75?^qD_HI7Ts>hAZNwc&G;+l^@ClO1bURp48~F&HT|8 zz1ab70M3-iKrof2Wn1XNAccQzsw!ACx`gFRma%lj2rTU5)3 zP=!SmC3DpPH*GzgruGQgxGCruhp`4z!90$tu+&{bK)rXRi~}YsLZv`!Z=>(Zkl$H( z=guC&pbb(Ab?wl~XNWl!s!H(j4Q<7;R>_7|2e$xER((#jH3J2%GDzPg7Z4Sxnv|0k=s~j#G#lDC|TD!#sx<4 zNa_N9Ff{Lkc|5Jx8XMAvRALFnEWF%gzE-5+wnIGiGi{_ngkX~uows^1&I1;~+sFh7 zQ5=#c^|&Sm4oU9jp>PP1J;yWHJ&`V6@ob zn%T)|8oNx89>>QW{lo|)*yk+ZWQrXqSsxQ71j zvsH$Od70gRZYm%_pzN9~9hDW(B9b+0Dw{mT%aR*(xMb{-YS-L|G<*`yxyIaPsJhH1 z>G5hioot3(R$Rp((41fFGIS*KRtO8aK?HJvsR}KOWF{Og6NWV=5^l(4=`>1mD7tLw z&LwJ)oEmmg9BM3W_;(w$chWR$X<`;8qpp#7i#6F~!DYa;Yo=yuJS<{Fg7Hur_lxJUXMyO~7A zgWF*m?uGRYZ=QlFIi=BrYi&*DhNXxKIu$;<=>FmYy3jay#qYVsKq@r3DQG2k$#p?v z5Dwd<^$3`H92i(~$66JpqZSd}=u4Zj$FEZrm7sy18nhJ>22e@!2dP0N6xUI^r^4>; zZw=efax*ii*xaZ12A8>WI_syoN;P|J+^0-~``SP^7VCNW9&EK~jpyO?&c&Z`>F*Y> z(IY++#K$0C6$d}zdW&nOwRI?Xh6yb)G*t4jE|S)@O&SE7!fPYy;SqtbZ^!qmn)e#% z^pPhganvuKewQeG5~3!up`HufvC_>f&gY_q0ysA}a^Z7#VDZ@n(j73iwo7-=WiV%` zW(7A_V`lsG7kt=x;o7uE3dUBAvF7XvCP(KPQ6)0Ah*L8Mv1ULu82A@iLs7$MQ80(Y zjA~46Sm@WFj4vbyLQ#3oe^)s=_^D~%!l3JQYfi_)fTVG=%HJ=>LTP=`t^id9cf?Xr z7Y?g^hG3FK1gFTAtrqKAU8ehv1C?XS7?`(6p=ov6)TZa}Y^}WJuq?pUzVR@AuNrN4 zaHi+?cjM98Hiq^bRD&8bs_D0c=?OzEmXR4lQ5PuRWzaGO)j~zTsIa5H=%feC)u^7v z*8VeBg=csurzwjfMEICMUBfp8sz`f63q@5qD&vP_wKB9-fmMPoG_D_pHBOi07v0yKvuLZ6zFI@lKZ$Dwc$fyMlF+=X zW)A6}TL)Q?acEWeVV|<$qzuC<0jn+6TBIz(*{M)gC8u(~K3!l{`6f_>v$p{+8rzL% zMpTDl#pg|0Of&=vCMDib$VaOb;$^yp7Fx=Gl}ac@68fz1>qLnP&1$IeMEloaRamD! zf7>~ej9i4~wJK2o6|{}&Trwxo%oD+72?3Un^Bg4(q1m)UQWi;i)fB-NqpNJ*tetM+ zH_R%M!0buFlU!=$GP;^3vT`!Bn_=@*8?2x* zif3kA<8NY@<*zo^NriRM41rJcp@?u(=)KbQj9w4JT(@QbE{(gquS<#~f02wa5S_z4 z5wY1Q^m{J3?vE9X8%`3a#(?U0qah^s=p3FW()v__=~YDiR5TwAnN9KMRo=~Kd52L8 zmhqAkT{M2c!8{~3Z%s~NG|_O)xGif$^C=aH_Q$Z+Q1ULHq44W8eUS#ej8k{X@WQmP zQh2>IJ7v82tjnNY+qi<-XeeVsQ5C}H6P47ZX=dzfoHap>?~)Ns%Cd_z%t+_7v7wAq zwuYiAS#K@bnieZTW@U%M!LhYRcC2e+Hf=$g+q-7>VG5lS; z9zZpHn!lOTv}o8|CTh0)-LHa!XQm$m;7>(sa{dgBK;B4&6DiUqju5S)HsqG;kZW~=N=h!9PnLFKZDYOKE>TL#n zE_>0-c=79hiU;oa8n!k84G!@hE;ib(`AnQetPKSQs4#elPGn726Hww{))SrM$kw0B zDa6(vLPe{?$_p>1cl;=}swmqXE`HlPSvYZmnf-ecqJ}k;oi3YhegoE2%p5-8udTHS zsZK1((Cq1Uo5g3JOMiL_Q&$0@j>8e#3_vok?1t9q5Up8q(PdP#vs4QU2_-kRVbR9( zx%Ah6pS|Dz7X8_oKt&Ha(U?(WC9MIU^AkAvF5L?L`?k5Kqn^=N|D}}XhX4N8RJ}P4 zJ$fG-ZoGvh=Uv3H?N3s4M_75uRm>mSi>(HXuQ`j0-}YXPJ-dy;sp;^%U|m3=!=`2< zO6$B6BQ`Xs)+M!wbuhMKHDjyRGJEU@#yYx_OS$ns{SS^j^Aytu_hrjovVA>sQJ|qk zfo0JdXK~@pKh3dSTRHc|w=l8n3`{j(<8`-ia{u$xRiF061lRu5?=tAka_aCN+GC5j z>P`QNQ%85vn>&^ciKrWw;O=|Fdp^wk+%b;sc?hK}6g5%|P@MsKvZ7erM^7#wBlC## zSUGwY%iEifJ~+2PPtVhZ56f@tPK1BqgEJaeWn?TYu@lq z&cF61maJIAH8;PVC+_?frZSL5~b zsBbw|L2VVfR>;5xXF>0RtXrBww>_2A(B!Zhf5Pb+u72~|x$4btXX`z8P`d%HgjS)^ zMS+xFlhmyh9pe!NqYYT>o^vm|l1-Og&5ASE zGjsAV^ZgmG5e&zJqz1?%KZSxaYMBd%ZCPA!IdM3&QZl zMno8OmM%~_uQ{xp*R?4T3Kbqt!VKAX`k0q@2XBH5nUp|NES31MdJRiOF@bN?YgKaT z`#;X{nGJ~41 z?{Cs>jd1XZM?-bzvnN&1DhFv<$N}{COj&E+07fIFS}2XC2-M`#DYWwu4y6U{RHDV& zLB;iN{S~f!#oKuB_D?tFE+GSCD63Cgwg<)!$c4O3H5^anK#ZqHYa^5fN-MOiqU{tN ztLQqvp4u*a&na5YH-IhWwWXz~fFkg?-Ql~840-&=I>UJ#Wr zmE!w~gSprYs=zAAjr^h;sWggrCz)|f))dC3ap+WW!wj#+(4p!W8)1)s6kC{&( znm<`_nUj!9RI%JmD~gw~fkqWE)Lxh6n8;BfQrv=bzA5m9 zqY21V%&Td>u+E2uhXONwFCcxs@HO7RXDHyl`M$Fa(ikeq(7<`5C}|1fdpG`j&ei_Z zuoi2>pF=n_rVd}mZ{)`M?^}aPU;cYyqlgk}Qw3^=zxHO( zrz}c}R*Tv;pP`FQh6P*KJ`SQNv2`8LLWi>kV=P6h;~NlDW1Yd+8fylWtrD#jwjTJ; zJ`53@sR2c+-NhM`P-hz)6c?ElRhLRvS~*9@R8pD}yx--D>-5Xlg$oFtG1| zyV?DNJE#}>Osw9(RloQ)GI#VS##wJzQHN0bas*R5OdVc-?cMFl z?g*$NZ1TQHGge`0%c_g6;=Gr?fuvHlf%<9;MW=&mx3R{i!q!*|Qc$!cPP0 zq181=iPCM1sr|Z-V*Ids8?l&rfGS6kR+rlJux@~{eVh|?Yl1;#sic6`sAr|rmCr{U zAEh%njxL~7ithLlI+K&=me49nMx@P{YtyAo+3qI2s4EQz_H3hH&vR(sv()__+CaGg zt$Aq8JBpqhU3FBG@84DtQ4kR6R{1JjA{`SDQ0eZDp>)T9NlAlrx0H0lC~0X%ca5$A zqsG|w?)UD`otfdq?|i!YO;bEfr>8(C z?AdJ5YPMBXeK;Q8*m2&EoID^wDe@uggrpE6SF5IZ{de@nB~+Fw#!Q}2OWoToGNp$t z%)yQceSPAGkYzSI#jW@Y%asDbVOvq@@)EY)4=0OMFgJ&HDwOUv8`@4t2O(46!u6L+ zgbij|G2f-V{K&L*`RAK1#bf_imo*g8FiH=T_)Gjz)BR~OYiUM2zjDV^tioh@zIdcx z=gC;lS^|ai6Pesl6~{5d0+*eD%d$6aYbi(G=XPMiSu!fE7Nv~BLO2Hpur#|{ zPj-;{lY_j20nW8h)*wAW;F?6BB(`U88q zq7V%t#vK}HB(%Wn(=+3}v>E&n1D0rgn)+CEmT2ur{zBTaP*38WkCOvY)|F(@=SfR* z|3v<9L6@M~v2ssgbI=5;DuHephti`+eTEX8ze=LR#}E3(;N-oY)>E3eTU-NuLDHiq zB*vh~nj?L8KTTYl8B3uX}Qc{Ve5KZeSnt6V}sp!Gq6Jk7Vbd=QE8CVkJa`dp8m zS3>-ph(@3g$Ey&0>k}HN@qht&Lv%p}<*I8|3WrPb`jH%ds>Y7MR#N0S@oQb^t&*yP zk*%x0fL#nRFu@G(qT+k#pU11z!<_|!YVHJ)@d4eoru=L3(Ij8x%Y)(ri^V71IpvzE z#N?q(0sGK8nGqkW8j5`P0Gj;ZT!lcj5ITqpmq(1IcNSN;vSR^{(^=AEYEunMGs_Pl zkw4-Tu}oa5{?jz?UT;MSU~eM_-s%+?y%PJ^M&Xq_suOgONEn=a%R~`iTUkJ4|EWIP zDmI%oZbWb~l!rh1y=6NPX}-Lhw6&{Q4S?yzX!$NGe&L^ttd@*&X|_(S-zph zx^h3AX3TefS*!`=K52%m{GAOwmid|elwRP4MrZW)Q0Yr!d;u|jD4>{34p`}n3vkG` zO?~=LgMr^XXoF7KP-f*nDD-})I0Ilweh4HtfO2^<&p8NuHzwh4%MF=-^T)R1x+dS| z=fDT7@m^&HOY$&_(z!>5%@#RBrM=O%P$A9d!g`JTU(wP)Tx%M1bq4>mBS?bFJlsRY zIgxy}^!VkfaQc&-#H5dgB)*dL`)|bIU8(ieATpqR=Z}83`icc-66_tQE0CWOXzC)U z+l6sxP*CvM#V{i#9ZUm2VR_A{NSI#5i@;o+KE$5~V zn_5p(nq9|J%K5bWHE%FK6yT8Tu~g&1BH{MP_@OVpZuNfHs9dX?xxq!}bIPp7gEz%0 z46tE((-`twsBq_BP11WlkvzE%|6JEn%6&G=*FS-*l1fg|57$vsT|tQb6=J8BWZVTu z@{K24QLNb5wH1a$#T3^QyS3pvM6;Q4zoh9MMH^Eqsd`3~DTZz-n=GYLJTsYo+;NIx5KPgFnLCLeXGz)7&{69|ng7-L%K`lCF#eq5>Ys4P6lN zT3ejxAK#5TwESVVE&6G_=VT5$T2m1f?G6M5{Eg*B-I&C3?`}1BMOp8ej$Y}ni^QCT@J(pBF+VmUKG`O^jEcYO^};nZ~?rOTz@I*_UjX+ ztlHQi-0!_J#NtNl!=;m)ucJ%`wBfgJBUMsC0L<%aNmtUZ)LhHn4^z9YB%`_Yhw>fb z&NucjyxM}Q`4Y3Pn={XZI=88kIGpEdwpOARu6wJ^41P&A!_jye+ z63FOPht2_8xXvPtZVOB;+$|{k^W@cFv8VST$aL>i6)TV|FzLGQ88zQ=bhF?+z$9ErkdOs zRQZifSQzzp?=i!|*6*I$37Pbx*HMq%g7JrktXEJc-~y6&z&V4IO3~DE6XeLT&xIoo z7%85XBi7^9c`41)iXqPOKOoK$arp&Crvi320{3tLXT${IXyQCJW=k+38NliVzG6-@ zstdwhfah8gC8FEDr6WI(dVU+{1Zy+Bd%Akwzj8-}4W0?lHXJ=@y zi~IUG>CK{dmGLfBZRg4>=#vSJW(A)yLvRd``JQQh_1+Q3bqxfYV%a=q3*A#Z z?Lz3+5rfB|vrGo?g$g0JeE`}?b0W)Z*#XC!^X>^Jl*Cf=iL@L*L#4N-5Xnv!ItZkW_2oVp7z7Hepf8m;9f&!i%%3V z6}{R`nQ_pdlRA%nKQwz;jm2`*U@&XS9&*vYa+cv$?|ndvW0CxjmdqPvZEy?M#jhqe zZe2r5ZbHG0D~O_rv)krQ9P%$8U;0-Gz89_#yD=gGpq`szM{YEExi+G$PvlZ-Fp=f@ zb-PL`Obfk?%ot7;hJ|1raU)by?#?~EX@qPoDxcuCdk_nDai8S@LiNAlm6P$iKU|i}Y z_tTFpW2(+&J9%GkEvYy^(}SYTN^o_!XB(Xi6f`)^TED`w1a z7*A)5xc@)MWXObs>ks?y6_zFOEG5uy+Jdfv$+J-D1}^=2OJnz1)y)}o78;NxfZbWT zg7aY&MLY#f?)y(#Yo)DeidnBFKFcM1BGMj;N&36$@rBoxURk%!cx>}vMeV;d%g-UL z#xjV1LmBM6Tz+!8{kL!nf&ZZI0Dtwkgv=N8ZS>?h8zTtW(!YF_eMl)#!NM^0pSAhL zv;61pC}ZUY8*O@a#Udxa{bA--TzYIn!gnuKg;A}42^+x2O$Ouc;um}w57>+E zmWR=-R8_>$ch6x&F9zL+4cKrJK zR6D|5BlCqsM3VRs&8SNK5e6h;H?m`dylcML_Uh`dHEz>yvXK<-fHyB(Ed<~1Be28T z!d(&6?VBfBXerAms`}F)MK!qy{uIh1;W|tYH`7%FZGw*XfhzW;Zu_y|{aIA*);RAy z5ki2KtWvMem00!umIQ-_W3tEzZV-{V0laeM{R@3>9Q_dD3(lB+KiD+(?|2E*PJguz z{p$IbxWA%`#`HQ>;$gz~D^6#lmZWFd6Idcdy=H)i!AM=Q9h*lK^Zj5+>&72y7bsCx zNfni?SDV_r-wg~rlEccplMFy*x+@IST>Y5cGx@tC+?C#;D$xgP28U9w+?nWPd%Yf~ z83!LIC!LT0?iRuh#IU2al|sn^097#);^8p4vcgr&!O- z^7R{WhIPybQZyn=1akE(tK4Nqg!NK2YkLy!h97+VRJ;rAQJf1(p`o}yxa@C&ytiQB2~iw(FUZ>-4*_gs&9{f{>^W`L#$oYTb3i}Gx3@lycq&yHPi)ms z;P6ZbL%`+3J2wFw%IT`zBk)pdXsdu+a=5nzH^wHX8V&6Lu$c_YwaLIPln0M53Phvd z83|e6OK3(*z{=-b*A*}c-yKsHS;7|F;Mr>%gM=j{jGGJf;v(0_I!u^*R*{w~mrs=L ztW@>3W4=uHD}!kOpCEcLtcyiX+RiVb+zD+RE7=^wd_SFAe?3L*yl5D}WT+cps-6La zV}wkxrd>Uw5wa`S0C0Q>{PvBuQy}K}!~cLzbhPupfTGWCPW5X@|9;&pmw`Wtf)_xp zOL!tdU}6u_jD9^Kc`KL$L1^0h?4Z*0TzHCO@tFT6+xsj!xy5QG|0N}ZEP=aGID=zu%R2iboK@z=>|j<4tGOlw`l*U56@$#iN7G?{-* z&hmU0<#z(dM2kz^khX8l2gDKUnkrZm%xEjG!s|~6)~(HLGFETU;e!B#%kf&TyLKjL zb!R9H&>03t_vbnt@$pPRE_{ zTr|M%L=&4hrrRDwROKTH5gewhzNM{d+X1%TG{v36s<8sREeDJhA|Rqa;=|VSYkmK2 ze|ueXiW@m^&T<(yB=o#+4am3mYTcMRI*8@XpQYW*&|MoI0UtK|Y+Qq3gQiFk!z!>q z)Wm|4Hi+XpI6qF_Ws}&cu#zG>qQ3%+tQ=Kl{9W(k=5Yt{foCoF4K1D zdYuWX=zcH^l#6D)3w}883}Rn<5Gq`Q9t3RIfssI?i%7$k3qhyeYhnZHinhzIP3z|l zjwr-Uz3r8lHhuvXrfjMEbV&>a_rJ|>t3Vxd%EY*v2+EJUL z5&^q`VAKcR`$f}@XvDZ|YDSb}fFv&}d3^`EEH%>G?4J@dzxGd#*Pr_);565Jn?4tK zFzgZNku=}^9I5$P-aUH9v1;e5N|DNoa*6sp4fpTLCD)%fK5I`^hQu52YY=7AiOJK{ zW;C78K%2;&_Q^4ZR=(PD&r7`?=96%>sZ|Tp_56HKC!#F9WU1L<*H64jkV9AYuNYNk zl5EDao8<6e=b3}m=isz4sAH^OeY#kBuBy`Nuq5IS(DdmKaobjZ^V!-sBcy(e5K#uN=&_e=8A#gfqSNJRzrCV1C;lJ!~s~B7c|C@B>xFV zYgmyk|9hc_TWMmxA=Lqw!K0&D1;WCEi_}KL|Nha`YqGXyX4M+`^eQt*wxlxq!=ki; zmkL|vSPm4fPj=gKQEb5&3ElR~*({f9+?;F}C}%H|8TG)jkUTn$cQa$YJv)MuGacZ; zVE0`76!luw?=CI&F5yzoN0;? zqbgRZL*y{4jg8gr4SLmK?ouy~Njrl%zdk{@Wi22Xir4oxU~%ug?)gq4`f;SYxFePj z#oUs~vYfL~AdG#USUzs$xgPkj@Y+tPp+HcodnLj$YX!|9SDsv)ADphQB2k|#VB*ZE zkmH@Ub`CQ-?_A&f8walTvn z5(wm<{ZVL`yRogQTDW||cW`yi7`#ZEbGt_>;N=X^Z1bwSpDL#@Y>QoO1}9Ua7sJx^ zKvYDmaZux?AT;2XXU?0WN`R8H$w+P$UW)>){}y&jSjA0Ah0r@$tgiyhR*6h|5_3`i zp-#K#ulDh>u*HU&^;8Fk9hM3rotB(7=7DI^HCZR$jGaBxV=_NjnK6m^UUoC0j~bJF zE(mnN*sYKMtJ7A3ulD}o*1foN$lcpWjH`j?gG69;<>^v2)Y?sdMR$u;_&m%=bv9Z- zr#)=u&|v|+wDhe_-hiMzIEKj}b>(6ZEDN;YSDepPTx8rVg9oIy7KZs;0;Gm!n=$W6 z{ZHW?c)21<#{6DeG+%p&C|jo5I&CZd-+!@hqb zIk_hT=3rg38tpswnDx`d`|hE}6{34jmT;_?Iova=o}m*(p0(t|TR(W?cB%~+tleWa zv$+XQA}8nS+<2#!Q3N#pVLO(%j(x6)B0(&8N%i(u`$+=sp@V5&L^D)0m+kC@WWOIz zUo1K_RwC!Ruy{A=e@U8e?n6 z|Er&7_1VI}`NcgFK&SWbb&amRMqWQH7q;Ju0$&U=fUZSxC_0wYDS(mM*ppGA*`dTa zvUj-&F3@ATw^M_U7+3)uY##`J3Fy^fvP+zzGVSm!eO!BoMvuI>(cDtGUIANJKJhe5l>a(#T98+cshv@q0>@Gw1MVf-azF{O9Bgv@ z9QetH0+k$WA@~G{&FF)N9ig6p`1rl#v*om^~VKMy;_u}=>6Qf6AVbN&Yd!~{gw*H^uWHyF(q60oL2F= z_JXh>=Ml49CSB=}uD_T;xCL4wV&T?z9$dbjbEBuM;IMVyZ1FcVbDg%xhqFVL+HQO4-UEqv||Zn~nFeE-3( z(u{7pr!A%_OE{VRKOy{-HzMa8)GS0Y(=UlI9}6_Mrrd!6Kv9QpWLN4%177yN_xi|QA{ro_I7$QK`(+o@bz30 zN7SExU_BKScJ$!~b~Ig+Wi+q5kDb8pZhArkdq2*fifdd_Z!BLyrtOIeV}3?neIFG~ zIi_sAyyviDQVb8Tt7Uzb+x1pHwBK&mQu%paa*qL=hCXv~-`l}brqg!9 z)c#jm-6XdJ*Qc3gjROp?7BAY;HVf+XBDmP3+MaFA*0_+h{2G(RfL;ra?Yv%Egb!{U z{Wkm{txC;nIU}0!lk(f{{&*R1=v!r<7eo;HbY9cK|n)I`Uv!ATz0a4csIYJ7eX zT`10n4uJjrQ%F=>u-|aNWBSDl$x($w1LO(i>?{&wN!R11{>OPZ2z4MCxw`gUnXr3Z zMEbFq#&1RF++MV;?5_r_J${j*kwYoVnR`)}@r( zwvXhG$pitn_cPu&H{^dgtX{`%dIPU7W6 zxHJ`VWt*46ujfm|AxUd1{7S0|?orZ`gAsVDwKly(>F@^W5EuP{x;fEH>zBIPGia%l zm-T9|RW#Fria5uu4>HD9ZtJo1;-v>lTszyxna%G7Gvp5v#U`-Bvq_&xA9Yc72> zTm@T*kY%gXmv}$)M~<^~QxI;2(*?Mm`?48N&N0TGt}B)Z3=b%$)`RACc>KDr7#8Y- zZ$c9N0v+#T zBz~Apd@}T`3N)M9vMtAJZH}R^E(vC0&SyfzX43tteZ=m^WCr^Ed)5*8ttC*!?(v>Y zSvkJE{GeVLtG+~Qv@m)UUNf0XU}gbzW$HjJ?@O~KEz?2Ofk(<_TCXQb@XQz}1(%t+ z;=rf{ti}9k3Hxx6oyipykN>8!2$@c$WG2f5VB%wU6T#_bztbK2Tvl_sz_=*09al%X zPfD%_2}`1)cQ5$vmB!ObsEZ22`o!fXyVQB0>E>=OMpDSsLmp$7?4^n&RM4h% zV$kqGTPXHkj-QM&ivLTf=e0y4b!)M;I6Ne7=6+&hLvr#v2OyWfF>?xhV18cb!IdSk zX-B!7*8TZo0RgN!$!QL%|^a@kv@{>!EbJ)?G%p%}#6PL3T!g z0Dr7wb32~1wY8T2K(B<$|z(A$l7{h$zYNF9&t z`(RJrxBxNb!M*oCjkwwqH%ET~_EZP{YpJO5(x3TKb4((5pe9Zg@UG@o21v~k_hzh~ z|KGQjd&B^T2BRFEyGq@i>*wzjU>;ETF6H8D*}URYCo6LvH>#MADs^bZBrSY>GrjLZ znt$|cFZ+tbwCdXXZ>I`*po{yrW0R=4z#Ka~v)Pb!!5PiOs$8NNkB_4=#f>psZ67PN zyBl}}^UQBIE7aJE5`?(+R)&9R@ILZ#EY(m|;}gXSorP($JV+i5{3plbywNVU^S)Un z`4N12o%}FW^sD>_{@l+YYC|?YrMtn;^Edf_8%3Yn2v$jd%pUO>CZmeo%wD{GWfN|V zv|w*mwF*BCw|n%7ew%liVrlxnALkjL^hDHz-h!gHmFTj0>(6|L*eYI9K4?51JDE;RgGK}n(VKNBLY9E-alcK`m1c=t}4Sly3)1Y3-B zYT4m{diuktsT-qc6FZ&~LtlgrHpl;^{u|4Fl z-wzoKFDW9LGjaa%{fyq!O8f&`?SQlGpbih{WVv2|6+tScA6dN>sU z{1g0dRvAz8f20t+iKNxKR8^i9_e^62oX3gm$QmnyA8OK%2h1vuGE0Rw{!GSsBgUQ9 zciA(CQ4wtrlGnb()}MkRQYwidtHt}Vd}&h8JjUEiF>f*hc5#J8xt~p?tQO62f1FFw zLH5K&9{?Qg8$d;*g^<)L-%)lQc=sxVm$S(Kp_4roH!S;|oYom9u5p5+s+GX_YqG0s zIJ%SIbm!vc{=K22Kd-Q0F zt|#I%s!Db8K$E`ClKWeWoZ#zzR#J(HVtSJa{Zx|)3@dyfBO?*zRdc#U{rW5JfcnBL zJzGpkFb&5$-jV+|8KNvm{qrqmx0FC?z{(xUVN>E2`pdRI51;^LQlK`zLu>BW$%)n` zbiF#wp1dAtPJYxZa44Rny7kJ-XX~I1d8>eB-TC)46MJ~n zu=IACmBjgeGQi|6vY8(MiiEX!o?lI%O{us|$4AR7{ch@+H#aoJ+j*WTNVa_}BZ|}7 zPjCR-N>$^;^3B6?)1iO=MA~i~RWnSoWNAn6d42h*O}y~1=kwT17F6yg0DNJWCrIQU zdu{#R!m1%NIAzT_8yonDb$af*mGH2(sGn5_17NzU*n&2_(UG6UgEqE ze%1#ASdGj!pGE3+Wg^L0y|26B=EfhYUbyF#QNGrBqr z_kN(0+q!WxREO`)lhsV?#bE(iei{aD%}o`tYVk^vrH=~94Us8vk1t&6)0GCqvvoED zD$l^D;>@2;DCtOw^0Z$4e*l7-leZ(MR-4{?YXq$P_GdZ_rB78_-XuJT6Jzu=r^S63 zfPOB;MW6KZCExE74EBwFlGA5{4D-K>ea0HSVHUs?N#bUmX*tJlXzOIF-CJ-j;JrM7 z)@ABMfmV>saNzkxk$vYje)!+fQ5VcPZ$MZh(BvQe`ju1w66==)z_tooo}H7(gHlJ* z9_lN&%iDd2b&#ZFwK4&pyD7w}UxAb=j6yvE_yjxse9nIHwI6ofKSXGmGkd;ceJdYn{(xdYRnaNU z0b>-ynUhJwP%26_XCW@u~nn-7grD{evAKm?npon;py%^eTde?B} z;Gds-8i^VCcOao~Ao54=IX;hZ?k}}WNb-Q!hZaYO$T8`x|7fv}dEOx%v9YVkM8?zj zS6FqP*}af<`JoM=_|e9$vKIm$^If16^J!}GaS?i0612pJyWwfOU!&bKKkeo}kNZvk z7O4Mn^xJ&C-;U-DDk#QuP7(Ks?NG88GO5q4EO=Z>2{h&)UDslN8Qwj3C4Vn<*e7~<{-iuZ1r|H$*wJY#As-u`FBc)(lshP^VcPRh zPYC(FvPE_?xk^l^o8Ij28c3g8@+X0}J?%mxEu)#;?dWI9DIrynRS%zCYtd4Y_1Wrku!%`@k;m=f=%aV3I}%goy3c3T*yM^HTXPIh zbDw+emCrfv?ncqlW`3qHC`#VTS^jZ&@KQY>;eTR@O)R51mOO4US5(fItiZNO z;RL>V-6yiwdFX*-d?jXk7&v2g*9yfNpb9aAVA~%eO{%3N91A>ZSOrsuZKOHM~rs)Gt3{c>I$9^#;$;w z%d5O!msht2k}v0)S?$m=_*|0NkT7ojD{k$BA2Qbfvxvrhk-SVX%_`o-ZscD=HL`m2vUe zEc`f4(l^b`$y;>K2!zK>E(*_%>myZF|1v^z|myo_F(5{ThFs2b{Lj# z_(Vp0bUUJYL8q2Gkn;U#Zp(RN>~Njj9?Kgoo0RW-1gl@Pp!u_h8j5m7_}UG&UaX?X zQJC}MkqGvWZao}|VtbczF?t=AmMIk&ZlU(~V{Z~ok|+D(LT-8nw{B;2YZ-1bso2V8 zis^Q1i6hX}KCnNEb)Rj)bxqq|1ZyF$Fi2*n-|j9-jyqJHU03tr*!RT)cB)2dx9{@- zo`9>zx?R@}5_w&*hI(eMi>^6HXtpi&uLmWivANr|;+^AT%^0z`RjjcJPCHt?Xeeg; z+9wUPXDAYkn#&r}Pc`nDnmzKi8N{PGS+$Ll;ZHkpu~=ssZ@qqd47%grRb}Wlz#^OF z<;zxo6xgeKip>yBANyQNRY7*RMfSpES)x*F(Vfiv#y4sP=G5)4WenM~JZH?q)v09E zlcGzh$e-dyqtXhd6p@ekzt*L)_vuy?g(s9RxJ<;+Jk9c1w0?evum^1@EMR^tA~pZr z(!}{;>5ZHb+(wvz+|7eFr;=F*H~R^aLtl34_B&`szSJUZKNJ8rLn@$+>uWK!8eWb!66JfS^fV`tm`&2F=T)i&3C6s&P4K;+a;mN$mK z8h`3-=*y*Hf>dg`FZyg$Hma`2|D;R;MnE)2T)^JNO#M3dq7uhQr}ysvTzDd1hN-~> zz2w<_y=$~1AJIp0pPcE(di2+_!uO6-+tV@k?6Ie7vD{{Z=yj`;2QH1Cmqdj+`zOnx zWgK%|=Zs2{_Yd|QSN`@TSZ{>X9ZxyNZ9LCvKEO9}zDjObW?_RG`R!bB=|eIkCr+)_ z$ALH#kab$q03{t^X>xzW6)1CVEn4Naa(3XEQ8y1_J|}sZ%?y zE46~9X7dIqoo?B$r7#Z!GzW2VTS%EKO5gSRiB5KNgdDKqd?)s$yS{~-Wo5x3@dE0$ z*WPz?Bu(5Us6e~!w1AVp_)(!AsM|Wre=(|M&yCrdPZ)MH(R24x%`nR|oaFTPl5B;6 zpNiSThNMZ)$dsU1swJu=i*MrVXN?pMNkuc08XT3OK^rg2WOwsE$f`MQJ|iQb8=f2K5P2W|F3($*TWR|7`}=z0TWO1SIY*=4Z=S$E1MVB8$CGn31xfNE zwAmuImYk9H1+ntrWN<$Xdru@y%NVE0QD&U0L+G1u<|&KlF>>Nx)wg zhUvxiEjCoKQCsAE0s;U%w80FKR%S_&~6pyFH_loy|Qs=8|dO?zFc_Jx5C zZy#4lTu?VzyDbOPAjv0vs7Maj0_nO;abm$b0#_bu6M5mX7IyhQgJkYv5~hv5PJgzdG)b2v z80xytW*W(5SRV^KMUs)OW3=tHr!#YlPD%CJkdJm%l@TklH~b!#F9@0dlv(zY#NXge ztkN5!%G9;Ci(g|;mPgi3RH1P08cdHOZMI(DsY9IG|%KD zYLERr>4Vq&3hI>@C40_$2}JB*xUX%^D8zY5y>Hwotfif7A|(x(<+6%q51rj7RAP?< zQpySm(v6yeaI+=cZd)rE)|(SMR3&@NJb&txjLhVtvm|N;S#no-2%4qFN1?r3fITA} zhZQBDebx>zcLZO!BNqBr(feA#i_h)yDd)Ikt~LF*T=dSu_{l2S>65A7fU%EtS{}xP zo%WJ&Bq3V9bnxNgZdAE#>1z=%2H$OIm6PSMEjOXs{Vc?bjhQt`t|e!o!5r^sS<;ok zjlO60f`9b~N7p(=8P_HfVlrtATO-SWx%oM`tn@|Q?~HVF%*MkMhgOE}T12L)x#PM? zpXgzzRR2DkBJWbqwJMhAswYc9x`*RrV$}INoQcY5rEd!{PH-er>rX#>%%ItpQ_^N7 zIwEBHx6B_T(saVEVh_$pN28#XB#6OS*YE30RI#~cd;(*22wr(=Zk6K&72{ckwQCB` z$-@0uXTL#Doa!u-Bv1J^EH@xwErPtFWy2yRr#Zb~)x3WUA%gZ8Wp$tp1i#8Mvd znjb77%I@4405z0`H?>U`Ru*p+Zlp%zjY-v#9CRw$f@2`XwgCYejU;1xT?#3x`MMNf=dGX z92aNl`{Twdmzsf|0CcY$KYxGrS${_&bRxum?GeP@?I4-AUq>>9*L3_YCR4<9U%Cl! zLHk4#rI(gr0rTNCJD~;g)uYL9ckoZ+Wu^j8!PJfoYcA7kr%@77rEx~ z?SKQ9J}w4Q<@2z7V(lZ?F{4mCM?P6lL(kOxd;d&4UIXiZ_pQSE_Qo2}g>cEzQc0EB za&VfI&+S44XZhc%AmZIR!x$g0-0`8V?O}i88S`XgSO2=Y&hz{)+Vb{je5k7jhj z<#2;3mU#(h6JDe>-~IP6_IPRdJbOZ|H0UbTWQ>+xNE-Y%ADB}-pQ-Tmne4l`XbO2` zg^1x~LEh}?*>SL!0O*n}bShsun1$eGqrv&~t?sl&B%`Y2->OwZQFkk9PT{PvV$SM9 z9xl#_<-U|mlaaoRSqWFT@FMckpG(w|`$)+2Yl-AQKI3v)rr5w1PEF}T66$362pQ(y z^T$bDX1{p5Wy#DYO^NaQMlfupm@2|$$c%j$jCoX9H+DSK%dm=|FyLaTr0Pf~$GQE@ zN#JYpf`H!EJ=38(H=aI&-oRB=OORWVfymiqM;b=rEBkM*#pWaSScbK+Zhvt-uj|kX zllnke@f@=WOHvo-JL@~;FI!pJKmuIkdKUR7A>GFkVK=A65^xzR-2S{e z;Q&LHFqzL^vx=S_3;EUy*mqujr{XmnZwiCMCOh}McgwYpJx2Y+cCD8tm`J3N>?2X)q3B1uiE-v~p`x*-!AN(~2)Sl0b{x#6r z%Gk%Zjn<>OP`by^m3^FrG@F6m@g&R zi+^734PT0--i&#?kdgR8o}b^-#j3R!+DIwzQFb(s>Q~!3N?axMxddeaUc0Q-be=6x zeY~K?`Hp~wCnd7Ow&1alOE^Dz+Z{&rg=kjjtWtxvfss8+tWvoAy}Y~QI~LIlnr@3^ z2E|ZwHahiA7!~bYOT>i9mtv8E@P`}Yf=xAKjII$rscl(5pK$C@`<|G&a(O@-1#GDk zA1ad*su1QkJ)6~({_O|@TE2xgyGrKK%h1rz%nEwDPZ4gp_9Y}`+Tty-sXS7i4$Tsx zm%gP4+9pfY^stWKZPr=8yO~@ z%RY=DbxP65XZtnmouqM9J_453eJ-@0P_r+L>CJ^#r^iS$t7LvG;z8$KTW1 zn1CgiZ;V)H=~JEKJ+vR$^=pYiJi#=HX;pVq=O}$t%C$taZM_!^|c?>vq6|a&W>yZ9p?1|VqfBOyd(PANmj<>WwRIzx=j^+L{XW&+oS98V z!%a?pA*byY&i1iK0hlfUH@}Q9scY#-GB$ZZ#9+rzjLuu_vi%8eHD0YtqBQu;LE%2< z$Vb%kZs~lsugYa#N0nlphxB~o&^2%DjS<<``wF8m{1J}~inYsEj9akHn)u@`BUwtL zW^R0P6J3|bM){m;E@@_5A!k$#ExY%FXgy&LNI=s*1;-Fk}LRMRgx z__ZouN-h>p{|qn|sKNWXx`k%GrNd&XnK!!II#unP{G`5fFp zv|LNi7il7dmEw7n2<^}WDVDD^iByb#+`XIAhbp??&=QG9oNsDCD!r#&)t z^c4N*?nmL@GBJ^{h8Is-Hl8fxTSW*~I15H4-M&CB)!ClN^I)%T5F4q0e>rGXOHKL;;_xG`-qno2pkh%I>Sv$L>G6VKGLvhBEbtQs zHZ+DZnbI-9Lktr@{k<6hnB;8|Ih|1tIOG*;GU-+z(8Yo6W`$)1zFQDx~8^l zxRAEd{JGfhsf_DJ)`G^~!TOfXg>@FQh9k35`RqtfW6ly95~nOt^-!o3W9L%Dwu{_W zzZVm07lpM#9q8=E5ZpqRW#L@*fnbT4L#{#b zW=V!KsS%8Ej7?NR${5UWvD8@7WHcl$ccO`ghT1iB*dhI+%Q6&gbAvf+$)hrwg&vVj zNyxs~MzFf~esN*Qy&bBBEhuq0BrYL-llO+B06okL@BX#o#@e$ zGfcwbb|zRnTkiF_N_@6%?*YLW&4O;q)TkjmUuG0`C ziPq!cVHz5}9SkxJb#{DY##>19dQH^>2N%BfEo}ep*I9PXCYGLaE_eO)pCT%J9+_*f z8T3L!=DfBl&M2jEnsy;98gW=t`}I!tc?GJmG};5Nha|Eu2uNby{M!%;9W2zN)wQcV zrCI4AHi@%+U!)NSMg7LrAyBLQnytL1MG1x;hkMUZ)B_4L%V32=ccGq{VXoBBvDgZ1 zN%k&!aNnT)-huZ15;tOP)?LoRi8o6AT>zg zpbP^&0aJn+El_nCLXZVj`Wvig7W^JvfWdgPuA*k3LAMmG${Ul5kYq(aO=kiP_) zn1aGtw3`QGX$#b$V6N$hfgnM%IG_wJlTIww%;9QDR`b>gVhE;Re(+OC)lk`_pUPfe zY*s_@OQwc%U-1?;-SSRO9)6zVyS8JDqY@Z6sBt*kqi-Fm@Gh4{pwJ=?Q_oXJHnbZg z!;6vuBfzACaTFRq=4{)4!l~4Z=vpw;*uv8)(Ikh>w8sWS+DaIpNgN&<-(ZED zN?Q;7_NBx57|=N@7FC9VUPTI|j|5OQ)~%j`=R{CqeW-kJ6>W z+N@&oW{Wng)~0!h&76zcsYs8cF_cV(fo{0YP+@Q{8F1t>dS~*^2|z$9L~YY=NRn|W zU-L*);ED_f)w|5ausKCz8lVZaXX6`^n~bKqC7JJ#`C~LDFHLh35l0Uq*{sh|5lwVa z_ZZ)DCV>+PAd2%U(in{qvLap5N(n#d%sCt>=t8Hjf}<(1CXRJcsEs6;>`7FD;Zbk> z3zuE<$7FD`iWdKz4twTBoJ(#-Dp{j8B2JMe6(ki2X-P^WM2%tfB2DmxWX(@pjH)S+ zhRkH7u@V`wn8_-=)EG)`hU2mchcqz>k&Y@V6mBj}1LQOd-)L;oG$l6U2)h)Q;Nmzk zLriVBmM(9+litw&fcU1HE(mTz zT#2V8%TUBcT05cGP3ugW+goz7xUvmhHce?%;<<}txsxx$n=*CM45mT#Q`AgEfn40I!ayWW6bA#2?cBi`=Wk)dRoBrSALr38 zeTrv)bO(hly&*xQI%Jc`v|nVymm%6m+_GW=5m0yKI4vMphT=)Yd89D2nMw_cO8Vxo zDJq6ml8$tdXmpeeWk@r-^eMP_9rJtD|8ZjddaSK^>YqN$?7rP7rPJ^yI;Yv3A}wU= zf^;B67qTIeiZmMT(<$~YBP$4*302&GLl<24`y6=qK2}|P8E0MdB8pC%dp`Oh_C0d1 zN7sT7->GI#@mptj)qzH@6a8O&GpS?VY{*a&Z>k_F1l$JXQB*U@R)JO}!I9e2OnqbG ziyIdVm~7G|rh+Flb`hnF=%pt9PJG@_MCH?S9fl*yQcI5>Cz&6eV}4P^=-4tQ-3WEH zpXtGFrp$5X>v=RC%A!l<<~do3r_HI6|LaTJAOv@^okNXht!Vq#2Kx=2%) z8D|r? zDtd*XYWX+?7A&d`h(uV!so@E%1cULYP1tX&6Ko;4!tc95C zm8@B_k*B`%4IcflqKaf~`)M1oVO6PBE{iMbO8cOBs1`a#RDSS?1iWUe?sww*|FRoQ6eIg?(Yjl!XrKsR~ z+0+e9hMWx1^wMA~oQoP27$G_!g&6@boD2T52rMA+IeRWTAqL8Op&YsZtprtARG@Aa zL zAcggYGa8Q+MrvR<^K@Jr!jPGs4mD9SqEQSvqh>acnMq7E2#a)5#V|9}W#wG+AaWWx zuW^Vc5n7|ygUUvmF>OFGocY+)14G2U?76ci4rjND(E-YlpZY!}WNc|8OtB}_sjoyDnaP%#f(WoNb|$sMtQM}_y651`dhHoPC|`}d<s6qP!+>T4&i7|pIiE$Yhp|MyA@(0eU!jy5#*kq|1GBiC)r;#gLa{d4gugQ7?P;u z@JRY_qS=gZqHUZpWc=6+(a1A68Y!gD>gVdf-K-9A}KjK=+MI}C~M$sC}15w z>0*?0X`+%|F*P%yhBR$Wd`5%Lr6b2>d4nkuBEq(TJ{khs3GoyzX!AS;lm>0UrpNbdkvp7SrK%gI4)J*RE-lJf@;(;_gY2A})&_F<9zAXRdmw@%&ie@%9vDGlvuQD+-k)&gPQok=rBm|piUq%IPuh|kd2h| zVZpoz2Za=XLA0YNT4)=>Uqv@`&(KsTmmLT+41MRkk$_koT%08ooWU(Io83txs}IvZ zAIYJkeRVv@h(nBcT~yZ8H}Nzo*i8e8{UFxgn<^{d{54Gj%jBe*)^}BTR)E%^wV$k6 zyxVK|bYmfABikUZ@1Q|5G2=37ns^y4Sn)KT=~AVI zlrCw-T|6ALuOO8YjDXUnabi>Pcbu=*Rh*D|L`am+uoTs3FAx*{9;mZ4h#JnLDOml zyLfFWtfjC*$8|8(JoTWatCyi?!1Vj{T#rF*(UnJNi=stoe9%iM;A}Fmf)_CX166!*zl|?#^ zk+RLatuQ@{%vq|+(P=@;KxZIyrOimIgI3mm&V|L4H4EK}g|=lr1i{B9!}>l9WuX-4 z0$rRBYZgHne37p3*G4k6BdG|CURTEK)6mKeu~g%RiJqe?)!z7g&T z4DkJ@!C@>^R;X2|MJhp8c=UMSkvdIv#3_6+EP?PQ7g1jv}zq1Kc9B3 zV?%%-8VVh1y)bA<1K{X`pum(4QyL@~#Y9w5TaP{#0r@GlZwe*sU)qIpF%H?SP}HD} zmooV6vJTy_#VLa-grXD*UD85@bJyoVwv44^9fgyCC~DtuYUi6#<(ooP;3XnD7&itN zQiY(DOTqNYhI-tF`zk}myi~w8*6X7DFgha7PWf6#+0-z`ygw^$h<(*~CrW1c5^B7Z zIMzhKNz(VYVJ1{8|5GfR3^5TK!wm`23YwU>RCPwWW;pMq8IZax0Ny{UX&5E329{>1 zK#Id?UXM$FfomMOV~rN>sVrDK)wwwz(b34^=+T^a2Wt7$t|`Cp0~r( zmCzatt}# zXfe0OMprtT_ZwVUhayZe0kn$GA39bSkZwOfkt{YOpWOM^qGJ=BW#=@+53eOv2pZF% z^Wm}MHBt?nnNWL`9IzUKNJP#&BBv9gt5p*eqLdDMt4l7i5j{;=NUmwZntd;$bYwJ5 zm1R6iin)nsrb;wa37wou6EjJ|@f1xYH2TQs)fIzcT?l&(_p7o^Tud@WiVdO7;z|;1 zAN8&lDZHg%(tu`;ZN4G3SqzVOx?FmlHjP!I!*TSMjlZAnT^vf;#3V=p^yn~_vXWG~ zf71IdR8UDcZxtW(0?`%Jg@!C1%pwh9ub{Cz57Sjqwh`|uZ#nKK%Pwg^J-yUVvz;Gd z`_~phQ%yq=6_=b!wF>QjOkfV9=16VxuQ}eY0VPNjC`r*F5Fg(L^hZ*jt%S!Ym8MHc zr*gDv9|JN!Ynbah^kA9}13H~9ixy4N9;-n^(K4t}m|HOP28QwRl1^zbb3N3&pclG~ z)E%s7=Jh;tW(IT0(V8x3DMe8zPhZne3<^)nD+AIh%4c+zj_KKX_8)JvYDt@-WpO=& zDU83?En#rVP#BH26=k)+h=X>kg`&iEEZst*dy1-4Q>}8$%`DI{j_!EP(nSTG5(?8n zSxdXqrl%@sYbX@D-9gzd{knxQ3ROE?OL0mKIMMB4TOHa}K{2nW7y6iai>g}G&QO=a zd{xn^HLZc8>S%hSpi7}NVHd2yYK0xK)P>;s6}qo*)?ux8D76KswoY#39o+8|lsA=%u_D?Eg_SUbcZgAF z<9zd*Vw`j)ky4E-Y^WDhfGi5~(M z7i^oika}oI6X^e+uK#M5Elbh^vCn<&9T7)dm7+vz3_$`gl7qo3jWpvAH6Z@{2#!z((%(B3v0u@uOzDn@o7{|{c z<7qe>^gWb-bvK{UsUdW#*jQy!evg(7?%jKY#QRjDd=Nn9eMEGEHyXu}DSvnJa8;#z zG#Z85D743i>*CWG((f+Iwb8O{WjE&`pJ?wzx5M z8rdwAg9J(R&vTqmKQddZ|iIMN1RUM+;oFf%mGWsl+Xqx?%wL(&*|-D zw!+cHNG!(5EVX9NElwtc`xd0~TTkQ|q6FcFQLRU@PEi>ZateVlG>hZq^U zJsLu%jCwmo)@z@$pmyW|vR~)wvV#fJd@w5TFc5H`dw7Z74Z{Oh!UD0vH*3a0k z7n}sp9gyb^eM7ik4>+9;fE>`YLAPP#`PB(^gkAifbmA*=Eyd7>2@b>IwB+1Huev* zA!Vw#2w~IAFjM6b5WmCBcL>X3sMIpdOjb@E^h!em={^8tF%j(MdPLX=c;;cccHas2 zcK&+3;lm@6fpnSs6)x6ScQvyov?StMRsgPaqX^x_Kva- z_R^?vn&sq;qIA*mGyE)3*0`&+8EeHVT2a8ngh11QQZEAOqpoV&hH01h6qpUMV>{PS zd=K0kz$orwvZOZCeHQ@^G|;=nn$J}mS|2}q>Em;C-EH1CZluLFMCS;XZ%RYEX`ktW z5k9^UVKH6pLO{bnyIVP9M{_<*YnpP(JTMHq{7zyF$}S2mQz;w3K+SBRok8^ov&78) zrbN-aMHDxQOloza3dtx^)wpwg;O{0dq@1dF&3ia$b)0gof|7ZIO;p~XX7pV!0kt@O z2F=HZ>_z?~nrI+pD1FrC0SG0BF(=Lfb!fXFWr@a7@jK9)by7I~MM zic$a-??-q7z1ZrCkx!_B0#f2kwl9(;6`zk#X+?`UrJZqX{p^ApVr4W|UZ|SW5`k)3 zM4D4Lk4}dR-OQcUe6emGqgi-LppWTVIG$;e=pu>&-jL;oLuKAE;4#OuTaXdS#g^X0 zY8oO8)TJ2dXg+KcMc4rvoCnkAWHXiv%yfiVeHLUe3qL9jr3rLu`FWa9eQcD}5^=uR z>_0(e<4PL6l)tMJ8ciNS6xjJ6O=A>ts5u)*8#x$aqu)%LDjHeXJ29&`P&+KL zp@#TnCQ&qRaUmk2b>M-&!9*xy?J|udb!~GYsSr>mRY8pcNrujnPci}39+wOkrij|Q zXjUxx8WwF~Gp&{MU+=sqrX^sJW{t1)D^P2IA?1M(!bgA^U!{iia#NV>Ea`GulsF#yqr# z!^~kB1u_xTD1>Md6f(FT+y*I2Yj}qfP9MKu`TUGVJ5K8z9u;`$XY5U}lj1BdIPM*H zCjfm%?;ErOCoDLv4d>S##78`S_a1NG+~N9k#q;?J5yC+l-tKoe{IH-u>{u@+yg$9e zvI^Q=!|VA8?bY;V7oe>SX2yC?I2{CgSI9wtHw(1y*w!odU4h=gj|;ZTE0#{!l+oV4 z$8lM3xE^r5D0bRFN8k=e(0PHLcHr=e(LgzGEgyuIMq2=6Wj$kzo=>kB@<7u^52gFX}Xy`#4ssw)on2ejU>wgte3U+apO zeS_R7-v97`mtS6R-UPfHfXfw~2$$0ix)+@K5%+w=vM74L+MZTi<%*pID=BuPB)7Ao z?W1^ZYctf`264ipF~p8_2kt2E(`!S7zcVSgjr*$WFkwYbI#4JWW!N`Hy8#p_dA0-Vei0; zbiA-YSS>5hX=wJpc1tw)kj>5=`~7TghHl8>XPdNPW~7GtDh;-QSk9veL)v&YT@>ps zScQR3X4D4|mduJ~Oq?1MX6CSwdC-pAa0zwl=wdp+MHs6$g~DjY=pY}&8cQa$a8$Cf zm51}U4#dSZZ;dQQ#v4xyr(YCk7U9Bd4x>bgQU)@}!9Za_Xs}tV4w1a`EG?qcf;895 zBr!CT&~rK~j>{l3wRzREKL(k|dRR4IgQHi&Scp>|uQ{Nu_?R<9d~J@*@|1^UHg&zT ztFt{KuiJI`4loVSq5Muw^BM|-EOb}VKq+g`V0}@k^(mhH7h`L8XDJM}(X??TepxPI zf&rsGOkHOt7bN-_Ko5CVqmOzepttz@pzUhzy|A#bPf@*|(o(Hc42-?Ob@%(ldAmuO z$}Tc9=CUkTLeUJeHC~y%;nd4?FY@NGXr+onXKgBo#s{ELO?lflVi*P@dGh?kWNX%njbhpoKUqA7kmiOjwvwdQP_;B`m>mXbhPkyg zT{;`M&Ukm(I>Th90PLzWUpwY7$z#UU4%Uf-W(a)&x>Z~Y6&%nsKPM6>Q7N4Md3F1f;Y_N5pfnX!N7`N{V@_vq>)|k1a@@!0 zGon_QDyHUlGzvzA6GsM%u?ZzTWLhs}jf@6F107DYBrBNGWhcy%B2&}E%S&m~n{&)3 zPD2iPlxbXU#rVq)9^x9ns=vlzG1VZ)XseQaoCoHn z18Y(wLS0D3a3_qLkS?n>rDT5=Vf30boiKjVym&l-R&8j(L80{`v$SPeGzKQ>M-0V= zeYTdtg}+qxj3!2g01+h`%RV^s0gHsTGn!H;da_u?s3fRaYK=N4P16ty)OEQGWRKki z&!?JB-{cWEH*DW2&S7#&9;LyDW8r%kvq1zvA7S5!_8z0!hPhJz`xJ zth#~vBM$r?%N;|pf%O7fPB<*@u)JLG2u6R|z?TE~{s=x?v2AB8XgDkf?AKQiF_sI1 zsH5)+It-iryALZ=&Y*3>VPo8F_vq&hE3c4;9f$h`4~Oq?T;D@a9s1>n1q8W1gYFJk z-@d^;13#R8gYEc=ef@%${VTp6FL?Rw1zT6#aYMT_oca+>1$(>TaJt9#`U-42aP5OW zcU+;o&`gu4S{{jgwv0w5jRdWPVD>+=QYtKfX;xUL=T;fUvL!**&| z?+?I!#k;j(IX>e4c*I*epuH*{^bXtk8PAtzynflR?2IQB;CRJH0Q=goa>wJ{3hXi> z3UzcqsyN!~ zeu3hvQ9;G((V;;csGiedS03o3STl=0nzNP1H|c_bpoYeLG^7Ux-YD<}^J7aRCUf(MHZw^!+D^u~tHiYRs+Qd4b&-eAq4HFB+kmO(e> zPS7U6*6ms}YOAwPTvFnAm7f_4po^lLIo4uS&4tEmJDA>Y)sgwQYQsTBCU}`p{r~`g z07*naRPGYmsd2_HIy8rQi#b!w8#;5AwZ@PHXuP12>HdvM>ZUbJgw|-#%-JG$tReI> znJs&n#7$B-hP)_jl3-p?4v4Gz%b$z8Gcagsma>DRKnQE4;j9ygM?6XB^YZTYVYp%I z5@JP6d_u~75^Ndu*N4JZEObn&wH1}D>I!MOijFg@yY>-!Q-I!7zEQO^r97%i=0YAv zG5mIzRHM2=Bm*Q%iU(Ncpqc?UlPM!gEJmr?wGz-wYZWxZDCQib)m%>%DuXI(oi@uqZW#)G1x#H%yn0xWL`#-c9X^9 zAW1cV^3Q;&&^ZakEp+^Oi{`~$NKu@$G`y{t^jqi7h>|I~TrCZ5d;lYllj6Bh(#DZf zDxI_`+1Np=306^J8l_e#84hW5M@btk6b}mH8A6TWK+(sJuV;uOv*zMPmJ5}WXi6=q zxcxz&lmano3finfhTl23jT6La_&yON)9bi9Xh4o^j-5u`b@qmEC4?mXUCrsU=B;Yz zK{eI^43Tz&nX2t0GeC%q14F5u`ey=oB_6(Qoa@Uepz1Dv&GrbDNi2$N!RW2vB?g4% zWCM?yTHq8kqXwJpDYMvMNJD@5;rJeZbNY99`^y`&{&#r73(gnDc74I#FXLkCgx(cb zCde6RyMo>w0l8v*J>UV~V9t+!GGZ3)bs`rFY=k!6(Au*l^zz_c(!;6$gC_={weK0j>{d%Mr{6 zTrZ!%V6?{*?%uygJ3r$5a>m2kx43_JM1$bv59XqI9&wWHc;%>4R|^2 zpyL6LZx_6~BhYKZac^iZii50RZ8)wCyX<%s8HQLYXqy6k#fBYQlcF0QRLaHH+-4T- zo9TiWz}80wp4U~K6^CZVXX+>;;bKF`jr~d|+{HjbgEh3tFzKO$uP^o;xQ6F6dmt>FbjIn@JCG`VNND~F4~}xn(g^CXfD^uR5tb;nrfzgfn zrn&K#F-S7zp$tUHS#eZKDVI`i0CrMbUpZwQrVAu<6sGXOaHoES%9wr+ zUkVPiYpTp^1QgBafV=!+GH1V`zq+QDEzem?jDnje7z)NWz(VMvLO+<)(9i->kH#YLN0|kjQAHpZTA`g%xbbQE z2xW@3(~2rh)rJ;#qkPypErg==GZPswL&QdGYL0zwa1)Zho`ocgvu?VvP7)mSKz&MZ zd?18cU~NYv=udQN?!c*8Y%^s%h&SpQ(~;R&X1G6g+Z0sdFv|O>qZgHFyW~qM6wBYCX(!>KgEPI+*e zWz7AwXvehd8cJl4%VDKP*$VP0WgFs#46va?tjR#w$E1wHH_nhJo!6Fseynxn^cWB& zAVfAXMR5)G*al2l1bU(rCJ9XTC)$OcSy*yk~8)Jhg(TpNzbW-8@wWx~l^ zaB7Ra_Cm4-H!Y29HkzJiB(_eSLdnKM^NFF9&o)03(_Y&w!u=Oqiv%ECL7lG5cDBW5 z@6drejMm5rqp^A+qxQATeyVcl7KN$yg`v?@wr0*;?*<}hx?Q`1I*BK3<>jX}REK>DZc~8ykTZU~jDaalu&n5(j%RwtdiQ{b#f&o3EuaD^Gj`gzREEniL(AbT> z4rJ%Lpwo`_?pNUB8?5()>*wF&y1(N5`2`1F(T@#J+Y25}3;y%@1)qDvpa1xP)-QOy zJmbt8`U*U}Tk*r=_xP)S@o(_->31OB@z@CZ%V(U=ueh8qz`o-J9iN4;z9{xjg7x(d zhciLX9h>f;`-V3-Vc(wd>AK;S8K>idKl`xaa0a+BXcOSdpv@3-YS>hVgLpMPw-zT%kA0i`8LD}UKXb30WHf?` zgm!c^$f`2AijvWxR9e>Iq!ajo(!5Y@iE8GyWLfA&)E;|MvrY!0=d8pm8uM#!0it4B zsB`67!IUC5#Dpq%K5zjW;+af^T|rE>Y9os!PXX0Xn0%y}&8Sq&*=n9hfMI^G7ILkF zIDr@%<4UQ}@+h)ng(`ZO?)nVH(jivxd4VB@MA?GU?2gko0U_q}BGEs%beN)?-d24Z zDtwwPqhKO6huMc9yO-KSOy(wz6Bwm$bke;P;fX#{`T?SXzf+a!?}dQM?i=mWZVsaw z>&+bxRR=Xd)j~}}pQkrQoA&)?0yCNURP+$VK*WTrTE(N3W;Kws5vdsD#Gx(*8PLo` zjJ8{frZilB=BE`6c}#d{GRg1;Z*FZ1#jAWG6*JdAK^u-)Moi1hG{+AZ&FL%~wXRof zTFuEL4Kyqw9&#pQ9BU0!2Y!gdtbjH5Ks-mv_bug6)tIx*6ltXimJNp}EoMF4h83v# z)PkIOt{)4gbpRT|a;7|N!?=aq2gP4mD^yG_8bwC{(^aAx;Nl_*aNkm+E|AYsi^>;6=re zbgY$;ieXHEW=^V5E1(d$k<4l*z!CfN1aI4p*T4gvCN|eeDi?g%Nw-U2fXNKoG)K+y}x3=cHpX5SHkhQpf$!$g6)2XHbC2s z>!#2PaCbi<#HlMtj@Wlamseb#p1^v-{oSwe?(|#SGtl{n7j5Xf;@DO!r#HCBGoJcK z5H}nSN09E2zN1se;qHj1{SSDSFE}3Ff*-6M{73wYUaSPxjP3;NIh3m%`(*p>~?PaXVO!RKLoaP1v*4?J(LSk4Q$ zD`e@ov>n_S`|FPFELe|>hiw5G@bOu&t-yW~ym?%3JTiLQvD1d_ONU??`D}Z`(tyh< zko!Fj8n$A4lhGutI*eAj?ZZyxQ1i)t8#+YtSRNS^M|WHVxl(DM%xAK=5=R&n*i>=d z741T3`#`#IV9+wy4s9o^A9Up5F@YCCTY$qtc*Bf0L^$X`VKx~9%PRwCYXmPaLmSP3 zxL7rH1#oGKqmH4NkuJyGDF{YaV_A-~of;dIjN&c6@>2*$^Q=P@Cx0%-8>k^MR;W=+Gsn%NFi3SoBYDkP z{03?sYva*uQZXy@^Rv+~-XUwoJ!7t^WfVq@GVbJ7@_@PA6Y9(n?}CbFM$HoUJZG)J z?>Z0GecH|#G-%X&MyW7)hT+^O**F+0Zj4qhCk=Q1Z-D{O{63P+ccYB*0>y{6lJ}Ho zy0WV#S1}9e0yM>I(wPlc8o-D%VKG;G&Y#Iva|XgHW%~Xn{0Y1vF040llOUA>B^8dW z12aTv;$#h;kXsldBrIAU(f}%ClHfQkosmXUp)1A^srmrcS#UKxV_}r&2*c*dr_ye_ zpfD{~x&$euusCZ|omxLFlV1)lt^GV7GX%P$VW8kYL8$8UN|WK1>N5w^5VagNXweQz z`59t!tf^56B+nM2dY z46i{|q?m#QDne<}Lo^d9Jb!Pebbt%jC(?9*1SNgh8++1lh7w0pIM;^w!()nOO;MRk?u_Qh4s!As&gya5m^RWsKg|El+@Ea3UU%sL5{4JpYlQ6gP4_D?1kbh88c=-N1jWS*%YhctO^~q9N42Cl(l^}Y1cFoF9D`;be6JJBA zU38Z_r+hkN!!(G_eP-7cR(i9az4pBnhB-rz17Fi@d$+jPDqZl?%im)Ac|mksC_2!Qi)#rgV-&!4V%^X4z{_Wf_M z(g8TXfawkocW<%pXSB6pf7!5}?s0c|hwJ4tu;@TNm9R>KXvgR4AF<*Na$0f589%>% z!s|srrz0K?CwzFk!{M}JX**7D&v^gl5wD+qkAAsef4YNwIpF^Fi2iXyrwizHhg=xE zov>_!hJCqSpd`2+f%TElFJC~Nz_NflVOas%6?d{??Er5ZUY~|fn zZ##M?w966bqvbg8g1%g^6Jg~xQ1fQUu>egKCp$kk9a(!`WaDhe4qoG*HX@wg#hNxS_JsTG<&d2%2l?_>~H?M`CcN zF7e_7wN#NNkwFuskmw8x46Ca`i)d%6xb9CQ{wWYe13Xld2^T0GihJhd$$^Q`8iRrG zpQwP(kjBJaUl?j5U%9*nn2k=a4Gb?77WKyS9%$07cM~+B_Y$#IK=54yD#3!T2~XH z(F|8kr^-Yry{d3}Ca84zC`fRDt8bk!r4Vqd&3hQHQ0D)I>4nxOhX}3Do=%farh|8_ z6+uLH^O~arR2b1+6~|=5X?8lJchRuAcvMj>SlsMJq2JIzr`{T+Irc$noh%W`;?5bC z(98#~7Wy&NoJf>T(@ZKO90f#~Zc+7`m8lua7n4+FM}Im}aoP*w?VgMN+QYivvS>z# zE5&+n@FI|L6bK&)^=D*KIZ%uapnB`1YDl^ny9kx!nj#3UbO)|fPy2qm8?qrHq&^TZ z9bQoZ6HWHYX;o!I9;$?3u|w1;FEk;-M3u%XH`o~GAjF+CV-Q0VIA7l@-H^puvdNy> zvqB~D1C2`)6d6uHu?(0EuHv7I4n19peXwAcm8Er3a;{Mx6tov)zUWc=qqzFD!nyTje`7QzQ~+VQ%5#c{dEopc=Uk2t+~kMBOb$NF%=dH(~> z{TaJ9pm*$|INU!%7RI)Be7SzXzAs?eAbZExk6-Z_&-i?O20xwg4h?$V(RRjxPq>~MmTkd$-=GTgONTJyM5mFg zegrNDM!(yj_hSOluE4|n9nQLePr&6FSTA-)?1HCf#Xo-re)A)6|Gwez-5q{jzCu5C zEHA^oRu{sdEhDQ?Hyju^v>kg>bkRVqSO{GQ(sl;$;&iJHT#HO=v%g;z*p;w({iwh} zhat>CVYE%(=VPB7kRkHh0?2XD4cX|`O9NIOTEw;p4hP2lk#Sl^gZ9XbBNz)2WFOHU zi|(O!>dV+}&%5FxqxqAf>`bwCY804s;pAV5pV-^lo-xQqZe6)Zf2sXb*nXMcspqRq^!}A z#x>5QEAeQPw8Wc8PRRyh!0e36**H%lOPR9%i~Z${r1Cp_7Hjg9lyuB>h&$a!#_80Q zep9MvTc^c56Xo-A0EqHyvSzN5s6-#tau}DS`&q-{<`6pJxK_p{{g8OrhV?BmCA-MHB0Ei`Gib3f~s}HkYu% z(vE5dueoRno#IJh=%WQ**L3nM#ur}IX%Y4*X4g_T5%CcURp%K)K&XxysETkCh5TRZ z4#VIF{`x?=3wc-t(>d$>(%{tsICXk-V^reWIzi2QtIm@s zj-o}Y=jb>i4})l;E!!~MW+mT`rse^q*+^D_SMTn7S~s&48fu#BkgDk}<^coprNscH z$iO`%VEX7L!Up|`Kc{jeS7dNvm!rIPpK9e~baE~8S4$N8#A4K^BVAO$leF16?`5K9 zF)=*dLK+TPj%e!iJkkwL3$-*@9d^h|q4G{_ljO&jVTAb<}#GDm9p=gEboEH8nhN~s7x&1W)up;OIY3aYqOGl#@ z5HHyEjN@{_9UZV-6?i5*{`Ozv!{Gub=SC(;sl6BjlCvxxb{Edz$cuJhe6vrK0x&q8(kr2XvYQjcOUTf_#^I*Z}I(`A94Ql zM_lNS_=-=!WyjNN$59x&Z20u`7tn8h!2R)v_Rz7=5$n?e)fKPXDCm}^I1(V&hMg1- zhkGndab?9Bf~zX<{s5%~clvkD}6c>WChGZ=sQ+Xam;xHf^v z6(?0J%K}~xSla;$cF1x78e?e+EUm~iY8xpn9OWk8z014SHKJ;F;L z)KHH-@>;toaFmg47(;QR2d+Ah$<MGmgwSKye_((e#7i081k`a70jWXrbAPd5;BR8>)@3 zPc{>*@LoWr-L(eXBAEuOl>;FJ$uOruVfENu90OQEXstnr1}B*I9DKr5VBj1^dq2bVJW=6Qb&h(NO)Mk@Y(@JwTufM{2^hHfMb}UPk~^WFFm?0=41tnvrO3!q{v5uszCQu2F(QC_+?yAjgyA zQkjtZ5sU+pxfRFvz8h5sso5hhWG6zMT+HoztiX#0i zC=im7i)Pd!p{dv`))1pWF4=wLCL&cur)jr)V_SrztZBILOg)U=xCv>rFGXmIS+f^* z^4X;)f1U#|h~|%n7I5m#jasYK1JeIO!66NX(z)SC8soVvpg#<=LRP0=~2(y!6u30kqMVnk`6rW@n~?Z$s{edxNZSl ztzV`|je2Hnk$kj}G zCZWC?*%%E~IAb^*X^%|NGJs+vGB}=lRlGc%(YGC{9a|s9M`wKm zZG?_1R0;QT#9#cyZ}Il~1rKk2h4txx?c+0Ey5K^eaK1d_aDR{edco`0Pr&`3;r{Ip zSo?x5z;VE8czpaG%i)OD4$y4}wBvf{IQ;ky{nKZ(y+M~948`5y5xBfSsbl-}3cUXT z?+yEZDY=CJWj<;qLJs=lz0h5!^2;Ubi!NCoIyT+OR(`gca|%JJ2S$ zd$Zu9oN?xTG<~W#Zyle%D%QIVzxkk8AAswdjvYGmq01=KMHCIqQ0L3=6C<*`!WM>B z#02dfM;$Jo%c4X3*JPmUxWF;GIZJg9tsU&(^x zS)s>abcDrpx7y(uVhwFLX3Efui!$yYcre=7Nfc)gR!!H`tCbE-(yW6QNxFm~UTpjlYSGA0F+9|`cN=6hNR;$+ZW_IZ z7%Dg790;wOL5&EuHt4^*5`+^)@my7ENKWcDTtc}M7Hv3UpsuF|92r>Kpo%in$Reac z3r%oMik*UH=})c;7ehU*Dp7A5$$vhfo_{>su3GfqCjT!mBzrt9Q2&#m_zJh z3aM#WLMbkd;jFvyFp6ObP%*dse@XKKzNHjOL{TWxZHLOAA#_RUy2J%vnY-wSdvvsi z=q4{OKO|L79gJ#N4y#i^-Hy_WH|eH(8~8!j8*rM8Mp}$=)Tn40N-_xpii+AvASpAl z7n-vYV4nb^&W&9(99ht+77Kf8)F(=vP1gr?FHJd=r!9iya+gIw^)i?#o+V`_Q6?f zXCg|I5F%A%EQ?c9i=I~}8c2aYq#PAQWj_`Tfv=gMhAS}b)0m+`pl&rYC|;(AP)WPu zz=h)skkROnQzW?FL#Q@Mp`8SW$xKMz(2JfxZHg+Ef2q^31@XkR;Kh|5F<%l|44<;G zuC%2wj0sw>A=FaVX1-h3RSYVzPAmg^LiTLCvkY?n6bP$^ah76gLp2@X932$YunU=Q zZ{H85i1s`$EzM}oN~BOvxLnc*Lj>I9`^_;pIgJkkn(E|3StJo@LE;dU&*3QA47r=N zhe`rsdtIFLRG)G%h6zY305VfD6v9C_I9MApDQ>mZy%zvlzF|{&hSV)W$^#A^6txc> z%Uj0x`-%@6L9Z)_8_*Scr7@8m?h?aUwGq}k;CTNP`{VDyr@w)|e8Tqif50!V{}F%q z`UkX!6X=y7?FE-@Lu-uV!Z`9BXj`y7UvRkyF8dYI2?sr4fnb*nSJ|*&8MMxaH~8@{ zzQYfH-Efd!pt?bS{pVQjSG@hhE0!-;?AsOlwLwMj_VGuY+Ix^3aQE(4AOVic9gg>J zasT)M+xaVAUw?w=E9Cl&pDzCd;sfqaZ?N{ac+)o=-oJtygRg@1tk||4r{x{qy!jQj zuU~L^e8F;e2Yr3PddE0kSKzo~gMilqj_rU&373x-$UYFPMufdzuoG}T9r2sL`~d#t z6F$G}0Pj#z92Ulf6uT;Z_j$v%18){!zbCwk;BZm2>jlRypvHzk0lXfdwBv4NP~X7o z$W4R{Qw`$L=-t^s>Gd#Z+j~a@vv(O8g3QBk=Aa0Q;p*5LnBoKi<-KVe>%TE@zW{F< z;k!n7(?^5xq`)UAzFOldg`rNPUxn@it>ZA)(a3{zc?$LM;6xYmco=0fvl~aHj!s+F zb7a86!6g(jP_l)9>o#hs&Qwk7$9=;_ffogJ1$LnABaD8bHq2t03{x8cT60>fM@-x_ zDwJ#vDlrON>fmvAd0sGrHrh&ESQi55ZBh#DZ1!v`hYa%n}?#DxrX66F|T#SY?kJxX6f4LL-8sWAxt^lrG_9VNI0rs zn(B+Z*ke@fHM!DMe~(%*Q9B_Ql}JRG-MXOo?O)Ns)ZfuuqtGzliC1H34bGTLwvvXV zu46XRDQ+Iz{VlypuX4AU3=X8MwJQJ)BiW!YJg?xLK9iE28UDk6pPf3pFkdLR6nK+mM2s!SlxM++>AxJEYvz(NvGNf z8#UNmZ5pS+ap%ycp-!x*_$d`lDn(99`K6B17mcPC-6Qc$km*!t%lsbv&+L5%`Wwg% zrDLf-wxEj)9ivj!i~4B7^@UPUbVYRxrg`8uP1EK@mIpQ}vWz-8D`Dcwwgx#4KGD3W z{PPkPTeF^<#}UamK~|oL>p(#&4{C4HC>M`aTJBC7PN%|3G?q;+QnDe#C2G zHFTha^J)wooyXs_M&xAQ6frS5gM(twDcprrKqZjg-thz|7J|3Yq$Dyawa{$Jh>o)% z`^7zZQ!rEkAaDP;pZQN9pV&&J4bc$zQxY%;av zC5^1E$oQl|ccVZhr8o;o8RAH3Fvs(607!euvz;??$M2FdfOE&!Zqwmn%0%wCm}eOi zCyE{apX{vg`=SAhpdADY35a%p3=eP`E%L1NRlb4n`Sow{VgEBQpRsTMKfG@LfUmn? zdwMZu36H=P>9}veJt>xLhwM9)4rsLENcXs-BihQ4!xfDQ52qs@zdPan#{=5q4#5ky z^GEE_*J0v1;^ux%j;*H?|+Ts=?&g8aCx}` zB)G^Ga_rEfV(lxgB6!_5G+EHs1LS(f<$MJ#4Z?yeF1WnzSk@iKhZV==2nFMe9WTp1 zihU>+S@6e?JGLXRtibi4Blx{-AZygIw-FTIS1>m;Wk_SwmXG31Q~*)5J`N2M!W)d} zh@A&=W@5b<<#h4kv7Np;as>MVY&4oicT8?RT(&(&GPHIJ0rv#lH^pIv>Hfx$0c7ae zVv+^sa<>lES_5zt1?g@^E@Rz2!YGrfILkN(Md!wlZP0Sp2=5lfj}3Sa#Sy@(0?!J3 z0`LmhfEz)zj{(#^x-@Fz;A|GlQ{_0YXQX0HHHn=-94HI(Fj*N5X4Xt?AHQcIPRWFr zc3B9Qu8^+iEj=sp9_KjITTjhiV}PZB`(%j-92>n=% zXbh{lc$^@Uc}(1iq%lx)pakTMy%GD7#%YE;RyK-P05L50=70;OayEFOS{JzS3DPhR zwl`3L7?pt*R*8Vu3#wssSA8m`uqCb9_sK3I&R}2U-Z;g=lTu&S#%*E>TD>2}k}l6; zLzKO4k9I5XI0&XU=A&@sFbphsM-C#YNgk(6%m@Cdqx2eY)cgWWC^`&msbHK?8Zag$ zHbF45n#t>nw6qvhfLGXXvSx z-)YoAf3`sft8J>(VlmOU@B&qusF|t~^aH6sN6WOQz^MV*JHlvgSYsneHq$ycwTU=Z zs%a4y78EBegi8biCO)_ql5I9#(YXO}(W-A)aRD*oPl%(dbJS>r$@L0F_{+F82tf=b zZdH--vMCFECPjx7p|DPkU?60aLH9l;8gv;76C1VWu1=9gQ<52)R1fb8%DBl|b)f}0qnXgz~qeHTeVLn#fRtoc+* zYR1?XZlWZqgN=g2w915`C9#Xq7X-znI3K1|bajF7`Jd4oHxif1)bt_I=dzz&yIeJd zlX;o%$3h*|X}WA@so!g{W+j@H_+h3ejXk2C;g!ZsG7ZDVu*_ykQCLU}70iat=%7?N zwq_DTHr$xx;)M=8D3_z5V?Q{DieD4xJ!Z8^*MeiPw0+0Siv+2@h}H;BYu#ITH8;9F7at zgJL}~_#`9JpkbtxUkEJcT@=r+FZkWh{|nx~`vHeX#=dm$!yWWlpq+8m3tlg;kgMYPdd2fTum*-N_exZc)B~|c|YSqif8S(wt;}H0Eii{o1*K8NZ1;%ojP6*XRO+A z&waRgG8<(SIB>%iGK`Wuj;RAAMqBKPdt1jF0cRe_nyaHdG;Nzu=wU4Z8OUe$~Nh?K66Qs)>?mddEzhnFfjAdCTc zHiTg)YIQ2AJZiFw8qV=7KepJdU*TA}^DwSk{ZFfTb&BQj2yCh&Z)UGQum%Z;qEL z=IB@TS)j=b#2>hS2wJR#Qw~W+Gl4@1NPAl?O`aEq*(~Q}Au%Y)A~elsxX^a#^EUOexpcM+%)Gp{XRbg2lbF6l7gsgIm+_eDOYJbljaaiJSM3~ zwBskcBmB((IfQZnDt(5x$lpC$o$Ngxuk&I!0+w5RwLfn4}h{GbW2#`0S+hcc4t+$~eax z4fW!J0ufKyp(e`jjiS$9i#sqhpJz;!3b#4wHk#%xhC*=+M`lVY*`%{JVaph8korT)%Te8+q?)nh6w-}Wd=QoErWl`zqz$ zm(a(kO)uTSSB&DCvf@(wL}RZLZPXh+GHdn`t750SHGAC)Ipk&G#RXM|1+M5na?H)J z#*2!JsK>aBCXhIdYN}ReP_-!ZiQ{Lbi{FGw*C>%PY0kI~Ls2dG-nAoCD6P0fISJ{S z8fOE=_b7GK+cs-j^PKSL4sS-s--p#xmX#emS6vG z@Zpy~$J_o-__AN|&!2vWcHTg;f#eswe0;^<{QAGfLEqqV`3cYcjOXhYVEcs2*9E%o zU~YJQdBWGHpK*Qt9oi5726t~xAOcQre+A%2T(%d;@e62a;Nyz(>l35{x)A8NVm~W% zX}I!+9l*X2Ua{jv$rZHk&{c6>I?jDKd2Y58x^`SiA+_k&(CTJSdOcK&{zl-lNEk z(Gtm6Ct~MCGt_A>=8aj;qhmy7uo8|69QufkIB$ecUGb9w&xSC%NnJ7j9lwVM`saQd zjM1#_i|H`Sq}9!XAqr|4HK4}8YC6K(!AS$;X8TJJO%%+vRhY5!XbwRmrx5Hp*bHqn zP*%V`6U&1ZO?d(VI)sT~wj!nrbgH{qA7{;5&LBJ1hWluZg>q>H`Mu_pQqvroSkDJa zY_FMPAgea?(lR_ooK@;WDT}>u)JUqdYMS(Mf-wpkoEbP#b%-^efuz)@DKDusOO5)> zYhx*2`363yj2{g@ ziP=yuQ3{=)zZ{w`C}t>?5=owKM-&$SX*g4+zSZ)+YS;p}lR_ zL9kU8Q`T0Re|oQOdC#yKNNx1i$6rxkE7raRk*d z_;7-@1$x+^=%ZL`0&3TwHVx&;5<2+Iy{xZ+6X7Ptd40j}p8i{$e*Ycrm*0SP1=EJ> zb;rlo3wTi+O$#UOGxjh40dLwH=zhjVioU+b*Oym(y8cg40UGXby*%M%dquwjzy0or z@810@Y=8gX;nT|(=-mluM-YzK_X{?8hCX%3rnv4eXsu!IulREPg3gR~e-F6|cx#{? zxM0V2Qd}>BR|d}4;bfvpkadUdgI>5>kxn|ag$pw_+HqJE)EU@~;@@PPTMWD|!*x_? z1G9ovuxm$WL2rU>H{D$y;r5G;!Jm+ZE_=-}5Ux7nD#V)8ZTwnv3^xr2MS)jR zT>Nb5V`(-Su?=Jm6w^ROTOT;sWe2`&z#sQP9lh#2w2PLZC^Z~?^c-B@*ZWc`TqTf< z_$?5yd-kj_lm=&1RncT<0^R9TO~lNW6Vph6)*uWt7ObXEh76=ql!970Y*B~4cc+e> z7=5#bSxf<_MXKaT8xI!6@OPkz6_gB#!jdTW&2V4VXu(KRSLkMNTv`!@4I3uXx;;m) z*GlfHx_MYdcBoMPQT2Z*Yydfio z%wr>t&@eV1G%6=O{@#K z!URQ=M_F(sXhP-|W%wiIWXN@=jt12xj|h=3sD)09>Afd3Ramt->bz+ss=#=xAw$xc zrr}4d9QNsrMDvH~vqKnU)aIX1+0J!>Rg2CVH$hqaqEO>v_e*K+k%yTMBnL({bING^ zR??|y92Vh$U4}(A*$wJcPoIi=o5wl~Xi%q{D)FktFBM>#Y6?n>f>zC%7J>KNll#HdYf=}o_JmM-Fp8HRD;b+jY;J6;q z`vv<&LHhw0dB&&h3wCN~a)!u;eq}6ILSw=g+3g0W+PMHVcClMwceaDM>M2Gw(CK+z$)Cf(WU8sU-0Cw(+$yc47Y{V-gE zf#Ix4ARM4L(a0=xXU~fcD(E@@t3he>=FmQt)&Faj$b2C1Zg+JjP}h;AM}vCVnQ-;N zi#wJ(WG5|jdmdEf6 z5@(R^{0LXe$sFN^GKt~_kTqO!2PLm_OMB$QP~;Fe?nt{^B0)oK9h9~ZIXIP3dD8z=QV>4MT~A#j>+hFuLvTR{!8yEKZMp^FOM_(KS|%{*K(<4H=< z?cdKnHjKKcw8aTVfhM}`7}x*{neNW{sZJI0Op-b`P@ndox@O)YbdoPX)A%Jn6q)An zsj(|aKY#I|P zFVmCKjD>R(SCp{CL`3ndVLXGPJ5#NYoJ>>>r>A&PN;h%=s?#TXe-f-WE$@MCLg+NI z)cge%8zs2BB8EZj&8c6R!^G$0Q7>#w57|J7NvEcNAQVy>+eAqG^X@|R&6SlzVSW%Z z3Z<#|P%2b!ExXcR^Tbl1Y{bhc>Vt)Pefr=BWti=u^m#A~>g;U9lX!4FP1&Trzr=Ny z-sm|3Px*Q3M59M(P!JPyiAkMA7SuG=tNKn#W0h&l;QKA&Azbr@oaB~0jzI2e^J(kf zHGW*Qw<+1S*DDciQ8mU?D4VWtR5zUAbZn+F&5p28LOkb$!d>%ItP%=>9Ec^+H0|XH z>)=8st-sRIN{-K#d00e*3OowHO4F&uS2mt$cp=!94cmH!(lG32o!#`Do((Lfqoq-< zYlml_jmv)-zXOGJ5(8Ta4X~)<34g@v@BSz7&!2IpE8fx-cPGZ<-88Zc;6lJxx#DYk#f8pT z)^)6j>xY~Rxx4gF(R$Udl|4TD~~vtnby zMHP$g5CIx7xHs^wP=n`&XMoYPn-5Y(Gb*YccNqi4W;J@Fk&k#}!b1a2)&PE1;P)W> zOu$Q5h!g|~H|PfDYpxq}iCdc3bbAJg7z$c%(eRN9cF9_hfT5M8m=TS0q9KO-O%i=s6XAHSK2`8pegjsl9`+W5{rKAPjD{Re_d!J(>#1>{In79e`VyWi6~R z$aI#14@RfV)Z(BS!`xf&DFBZmsd0Up-z8zDf+#jaYD5@Wmhih@CeIC$QS+*0bmm>+ zH?w4oRlFSHUUcM5OOCEnN8u<`FaMlyvldSP_<)OQBddXCVXDa}(aSQ__q)M|!eV!2 z$S^|dXzjxdh%iCkwn^f(Im?7*RMUrXQIiF-SlsoMifk#JR)=|I@tr95KWLm&YHX=` z<;6WiZu*y3p~QMC1H);fR?btE6H(IJ%h!qfh}a#v?5t+fuQ|P_>>;0ss!TSh`B1!Q z=s7L$0?eoGbW7u-(zxsV&w#lga%osnrxfB#8I8?cu@Jf%>AU0&dViS}n>9F05HS(+ zR4~g;*Pe~5P)_=*sjhJ*!?-LprUNT!h4RT;)Q&W8S4RU0}o7%<<0Pe0G)hwv!E8zspcFs(h+v+ zdK65AM=C~0WBOeWhuZK?^(d0^HZ|eXI&obbeS?m7G5-WCS4e6H;W6X8Y z8&vIKijuiZiMcqM2t&rZj-05lWpN#DJveEk&-4F52P=q)dOcWEA$W4lig3ZZPLiUPYvZ zqUaMPo4=A{B9Qz$Vt|%O+n2*4o^*t9SHuK9XhHV9&}MG5d7Kq z-(&gy4c0d&=!u8<4^D^=vS^w_cKf{xNIOW*<})zf$Lo(jqyJ0B)6W}TE?@D|8P6=Z zE-Q3loUfO0)*U*44Wb0;Yz!0u^#f#6=r#r}+zF?hao8I^tnbnGBfhj(T<=!gt%QXa z5M6M8ui&NQvjXR*4X679KD=LXzczgN=^661;nWUjo8XKqmQ&_xt_{##AS0*{jFHc` zEyIZAbsrz&osK5S(Y`BbG<^pGj->S<{ zke$Xagv|kD7~DK}h3JkIiUo`V3l<2dn|2X`4jB|u8qHC+rRalAr_*@>*sN(=8F*}p zcML2bTom}DDt=GE7bfiHmrtgtoIDs3jEKFk+xul6`Fkvi-tv1)&NsAF`?%dkYf^v5Q>d6P65rDL{`W;^oJV*ZP&;nBqlR$VssYl zJgA~9EgaRI)HLn{F*>QlZ9SbOn0mK3Ur_3ssBOw1>~^#iQk?3DsZ?AqDejUW+DCm@ zPe%7)=JdeyDOj);GMHd1Vaa})el0a=kF$*N{KEDs^OsI-4DT{F1p5C=!}ls zVNS^^zfgg@IZTmj{!r;~QrnAoSjpS=LP@8(T|+xFJddb6@YERcyphU+pQ>Xj{qnr~ zLM$5-5X%=4%4|R_sMydn>J5zzWtyN9H7tp80#6|z_2()Ub%8?vL;_P$`%wzU%_X*u zx!w7!GQm?+jfsR8?yP*nCk`#0IkjpjqT?WwbTd@Suz4i%Ib1zUJ6pAFp-;s$f^^!I z{D}g+8q~zoC9^Cku2Q{n;>*U2NXh!=4z3d={!KK~;#4EtKAVsFbH?`W)*Nvu=(%WU zg;8kAi3|lO;hM;Jp4kxl=aJo-OxH)CcSNPly8@4bQw#RXot7_;Np^9eNU@9o0Z_o1-^wSymH;nts2dq2c@KtbpIbf4fj_lhu zw8UIQ6CG&M1|ri<<8@VR((!>e=t_9FzsIG&!~gjA{~7z8;C?xR_sc+5NuUSCaRKgD z;6;F!>xM7ej{Cy_@7^?ge(l)%4qaqWBx!-DqBR?4u$1BFpwd1N;Yve?_ridzW4*OL z98JXrE3AqWhHK~*z>8_FuR5rgK4mwIH?~(J;7))?8AdW7i_f4jSlva@cUuYvLkvan ziV+m03HLfC1XAzn|nv1M^s2zLa$W5olFO82P) ze^B5j0OwLCk$qpi3$*CAVz{c&hmHTXv7S59zeJ2$%jRmi+x_dvVVe?~?0#!5sj=Kp zXGkdri^d1xV)Rt*qZ1cVP*Zdoq4&!|Xic&8VeIERNM;6m#v}%9(y4va3v$&m3SdH% z+(b{)d@te%a#9(CKvlJYQ<;&wd5qp zGFckXv_2TwM)mVAm-3`klBAQRxV1D(T2P#7DpNL6fkcjnLp-W#?~oP zQ5J_oYe_#R6Yc(~2D)kib!z5$IKGy{rEX%HjAqJVSr)F&gvy&qM*{Z4mxRi}q8V;K z;dO;d5Qmi{h)Gq`C)U^*!b*kg!CHx=6CE{B#3}|i%~Jes%KCeX_^`u_k!ucaBI1;7 zMR6ai(qjtLJQ}--Xi!p8;u6t9p)`s|z7>t`Vxv@$ z74}1v%`qStlQ@kj6%`71ZT6g+L6pyh{@1jjI=>g+mBV$`o&_WQpX_{c9jw+S56O$j zXP7a=QZ%da^~%K<1!-zx10s)~pfV)zH7$+?QPF$Enk^z9XH@e%{6f$&Mb2_aOFh$+=X;*M6C&=f(pdHrzsT`;~uKcqO~51=`t5ozfgfGSs@-55`_rbHyA(` zNrhvg8YTFwFYkHonN=d|4V7P7NEDn>wYMjH`t=5U$Jh@i$YKq>a3F(f+^UhO=3&mw z5Xz!`@!>;+MVtA@0cc0ya7TC}3q0FP?x7b$<<3S(>b@ThQCuzPeqmr$ z!n!GF0}e9GXZkX}-qA)@fUg?&M_(1^mC#wS+Hk(9;HWzogbNg}hK_Y1=sxa|wEW zjLh+O3FDSAbianas+?Vtg*KS&ek8EK8lB-X8x%x?aJXo(dmqiAkU|=;^DrOUc{sf; zeMlQb30-v<3=xm@tqk=!sxYb@LDWq?3@61+GW00kYqnx>^A4?Ww|rE0u+h?RW`02- zTu~`wHSf7w>RA?Q(LQK3f%AsdjNOzfh!N1mR6B;te+;(D=Wchd6ln?k?kfRnq4zGd zFe-OC+;Gy*7tMw#Wgm$O`fCvKwIw$EFU=Gc6Pv&S(;0gFRnOso529_nQTRn==thA- z*1Sg{$tE_yGM)5&{xw>R((3d@kvX(K={kSk~7|5nxvGj_q61 zWU`=_wm+B1FHsa{KXsX~MUHYh+laaN`IgtTnRm+7_&pMDq?P6+WTi@_Xp(@OwNeaY z>fQ3uRGu{`-=X`HP^D}pK`0P_$jlre2Q4A1)+?|WjkxgN2; zmbi*q*$ep&A@gtAW3$;AZyk>Np z_^Kl$Dy9cDNx5*gCpvSi9*ey&mWo7#-RFqmu1BDi3w(s-3pI`PY4RvYpA2tiHJbVK zUJ&yd2^OrgF=~@No#;MixwX3BG=5mfL+RBS2i<~YO+$bRHakZgjoY_M^f(u;$FH* zlhVB4Pol~L7EQj*&FJ;%H z*PKj3)SrEEghPhS!gOpZT2TFF&9G|@lVVDfHW(300<>Y5?5qMBE^DG}Jp*O2>q{Ax zs)sPur~?t=dO`YeYeqf9Q*mF1BzZwn(Q}beKWo@71r4ie)5)mc;)k;}>*9kAM;f)v zuJTGPd%xtY8VXt|D_$t5qip3~Au8HOA3TJEXpe!-*uomLO%%$!f42mBN2S^`w?L8+ zE=@(t;S^S{pt&^BjC4FDjMsv4Sr?RCNn^?%I-RNq9Bp?tQoe>sK+Kb=j@oBVC>dOZ z?y2fdrF9J93xtv6p1i>cnGfcTl0d+^lwqTp&y$!@6PHGf%D$i|3Q=-A$KSUsI6?z2 z(DHlg{!d-bg35ppGn{cp$AR9NMv8hN60|WX4^5Dp)i?#Yl}m7FF~tM31+xnYl8Ty^ zl@y5NC=^=^M}tkIh4Q9jt)1E(KD4(u=>?C=5u^|3*9(L<2zFekqw@~A>v(-uERAqF zHZ0mLdlP6^!T}9*=uqCV+ge$89nGS&u|IX3ZL1-G2Ybq!TEj<#RRHXYZpTieVTQ9f z>%rc_Rsat$aAyWEoq?BOk&4yUZrgyi4ix>m0M`zjHo^j+iDD&SC&Ft}T&$T|g@#+{ zrf6M91jPbe+tBK5j(F>MKf4XKR0iv1SqMu59vbilgw_c!qWHZ4KM~;!#cl{%^Pv-G zL)naNGz#Z3%=Vt$uZF^iXs#nPMuV6`tCE0842^7&0V^1dFNx29?W}G#^livkFf;IS zGp^yRtza4P6=HX^$BT3bHYipMN-=r^?F?2P4ETjWjf1`A8c4F*uc7GGJ!Y$s4Fz*H z?!)8_<2m}EGuk=jh_r~KoD&t)(3MfCjU08S(il+5zN_P2E{rhP-k;fSC{)&%)M-*e zMQ^He8qM_hXGwj&Y?v5m0kj@nKi9i2cQASiib9?DP?%Hq7&gof7Qg7LHgoHYOpP*N8u_V5Us%CX#L{S(8g?D)V(0BRh489L;!h zm`388j+ZLago<$7>xMjNl--nG%;$cSxRacQ4CKI#Q2F0 zs#2ixbo_C%6^Crcv|lIsm{V&5rMa=5XK{Ex5zRn-v|jp2QOhFvW`IQ7LoVI@;+qM(pDnyfAOv7wCPMBfqgb-M-p3 zoK#v$JQpq7OQYyWD{eDC@g@@HUN`IkQ+uJ+?aYOw5`95ZIjsl_I86)n!}SHTHX`-2 zlvd|X+jL89ruY)Y%>>ubyO@e{j{m75m8_*9%!rCaEjjLq2%jg+)EJhaRXSQqRNH=3 z2n!KXLU~rv&3P5_3-%%dsR`lYIm%8a)e7ZUks=^!F@~tO#+c~qgkI5C%xP@p zY8lq#xWe2>bxszWaC?_9RGnjT$jp6@(V=Kq>}U13`UN`}YYbv28auZv*I-tRkn9mB z6=y~%HYo0qEcjXs4i}@L%1t4oQ8+u#(2>G)7sMnXq0(3~6el!%xIW;(jMH)gFM@ry zOg?`!t?2jpP$c=PB@>(nM+JqiH(wE+|Nefh0#TD*VAWwh)4X6dO}m?H`Jc1>%e4)}%jXj$0QF(`)M+$+m+tWw zRw!3TO=_;6`pP-XR+?Bv6`TO7ZW+^n ze;}T>_}lEs5w(-w<}&fOFpI&;#w{};O%sVUIs@YyH}tA~tc|MG5?oz7aoYeU66$O+ zZymKTx~Kp@@zv$77y~;F4Y)f-SNbRs4;G&d~ve{sDHgC@!V zY4q!M(4$!4=2X1J#33g+-WUno5wzPTBus&l?u?^S3`u&LW)!I3#k$F5C>(2=J7E{@ zhly;Z;YjJ5Z}df>F*JH?HJ^Z6*iT4H1qzeO7{!Fvoiw59WwLYQM#W@<_LliLW?DlP zv{#hLtV7JcmF>N_IfT=9Dd}q=l%JvjX3-?wct%a^2C)U4?YS<{&I*hU~Wm)eqJSn_#@k`u0_rwn&QU;FG$vlKMi zY`BXX7$J2}K@BFIXroS{;}}%vOrx~Tua!UqjMbjpZj(5T)>65QzK zn~OkVjq*gYw&K#lgGr0X&-IN`SpkXAF^#<-^sUf6Vi>gW|FzBSt)__G5qx&>ctNDo z1e%Ms1(Vj;DMmHkJlb>n*)i9n)HO)N-?&yriX(C{4PZ{u_I%c(SC14WZW%z&vmP2(9mJXph&#*4QYq=ehEq(hR=kchz4AploEsJ~Q@ z6Sj+toRaFQ4{JY2r{h`+BOr!`?sytQ91Wc$Q?n*hpxiQ^#Pj|JtT`y7td>pZbn$F* z!r;hIKCO!}#ESDJ%Y~(t!-jEIbwj)IyF6m1VbTIcm(FD(Q?xMAShX^zF(fmNfa_?+ zwPg^q8F1uoEd``Eg<3R_g~@`6GB&nvi{fc6Y148lVy$ey zHwaF;;Cej(>lx@f4yOaS9ngCR;f%-Ag8Mgb@YEPzPFFm=0$mo+-Hz?0gL=n8qd{(1 z1`UcEfE}tkKnJYcuraW8!P*Er$tdKz;y|MzJj-Yf4;&zP2mqN0E03mU2PU>KXyofH zZRqNDD1?FY3cOXqvD>)8&PHj37ar)~(Q>G@jbRhJvA8!UeKe{g27=JH@p`ruxURrP zY611bb=+&pM#E|KEdlSrI6`q&;1d*|?fr@lYO5awOsUd9Gpe8H_+JbcNZkg4pgJ^^ z9pet<*3p328X`8aXl>(c+(=S+rVN$K}k;Cb8CM&eURS z1Ub$!O-mOl2?U<88AOlZ41wTzna1D}O2>8k%v5KS4oCUChSJ!x94xK`rFd%9QQSB> zyLpliuWb)#h32Z;i48T_jTAGss;b?WgsL=c+x;r7Ym6!?g$W*Vx5luqwv8Q>9m#w{ ztsRsV0b*#7;>NJVM*cBXF}eYL6FNT4GA40uEZ#}TtGT%~-Q7~>A=AE->7N~OF_>3t zW{Jk4amuZ#j)Tx%QrGZeyz#;*Mkq>!zNAI-)Qk$0D6YF#O1Yhc>ZNa+l8Pn;H0T>; ziN&aeO0ia`PtL)QLk2g_MebHumj-6)CxdGLnz0tztwBZn{&6dkQRgTo_*4fJ{-jxo zAx}lelD|!!CB{k1MJetEa%kubNm7#w*PD^9s@3_^4;Z)LM=`Mw)uJb)oGeA#JAR*d z0T>`n)wTIPqv`eBQnCx!JjtYBPL&Xv1kbZ^bm|NQ)isPJ7honCvwccx3|n=?emN3_ zLnzz+6&e}`u~x0QZmd{tlhFk;jK*j}#Uv>D`cn2nXXoEM;yTh94%6CHr>X-b7qiEt zBcmk{gDpq1)o8WVaKV31=3x$+UTu8qxm6Mh%287qOk^{ploy@YfP#Y-N+qX{tr?;M zu6i?A9^7QOWS0XY;wPBKq@L^7g#nHgz(}o)SQ8dT5MkUh+(1)k#+IQqn;f{lunqu( zH1-q`lBQ%@LoNfD3^&tR-v=&wXPu`If#XwX`h4m-%^3@7I}OH+#-3+^BVruG(mLsL zBvb7Sj|K@N&LUhcw1y>1HsnqRGh`BlmE+Gwbcy0drIrsA4H#)93IP$>6a?&UJGvzb zpcLn~h{iKAi{;2Ib6swjue*-iy$H&42zz~_2_KIga$3-Zv223J4=23&)jisJ!R63^ zWrOyP%jYLNtfRSLx#F%htfvL%O^1n9A6haZf^6GZ_d-zVwoVvVLz}1p3lkmyJnKO2 zb{!6*M>CEI7EO>j2+Xy49)9L5A;V~b;0NAq{#% zGip<72tj5>lg`Gy4|LD-2zNHLurva$sXerzgS;og(boL4D1KJL6BL^kB(#s$uwc+# z7s{E20ecV~=Xxu{(#@WMh+@~$#Q30A1f2-FQw)!CU<-(8VIdvd7!?-_nTkzi#B|%c zoe!M}yVG~QkrbdCeOJtkt0{05U^PmqShHxNFlZk`tj@_}8m3tq!;Osw^4TC`2O0yx zT~%2}qvvw&!LGM~iq$<@^h zk_CWo=6RSLSCZOGDcxv(eieoT8(lJ8oy!`Ip?mS^NIqnmwE!U_QPBWp5_L+`NH>*Z zTL)bmqEumwu~V?q>@JN4N5e=`OFWhj=#%q0*uQ9f>6z2(lDh8s;Z(|C+D4SS+tV+ z4le=96eSxvDW%D5Qx8pz-arv43egC!4xV<|fK=(5GSfz5e^JR+wvsrsR5_&@8>!hd z?vam}SrZ61CKPck6cax?t7MwQzH&n-^aU2aQl;UX5U1NxkBW{f<}<#5Jy#2{Se42e z@&kv-D8+rE=1vJgTuf$cqY&MK$QcE|2ALvBUkdZwjm<@g$Y3IBU)DFR*H=|N} zG3|@U_9-hdmRRTwsVKy}NXhp(E;K73{1Q}uzHV=AYu_{hlgpN7K@kUD{DwrqYEXQ2 zxs7~Le@0G8(n%7IX=LEJeEyn!uM?I0ph9u>H6L5+#>^xHD2ehi)j?PmbSC^YO<`(e z*(TD125G|!|9jTZqeP?4k|sigxE!l~j}6sRLKM8Q<}LogC(W4ji!wy;gw}s^lOw3WTC%%9ga$Tr)y@KPH&kx`C7NOwjg_mW9jRfYdHPlw_|mW18A5jE zx_(iMMtRf`k_aXS1(l|qtVL&o0g+6!U#Eq6d7^WtZe`Jw=w*>e<8@g`HFl`B(90l( zO=GiUM(xPIBAQe%1zFTUDcv-#lw_cZmX4GYXuS-Qz(kN>(IBkb3j?I&;`$lZbjRc4 z1wVhf2VL**s}G9*>aV}Y55IW_S)cL8myWMbpYir)9mwjA%+<+@v@H`Z|*Yeg=9L%M3 zX~1zAXkvHQ3X8h9Kp`t|0F7pA1-Ol2@$){KF_rOpywTb)nms6Rlo4;iW+t;6ve+dX z&z&&x4i&&MbZzTGxLXx>JRpl_9T5~i19(<5sj-HWEn%j?D6b(I9;Psj2_(5`x+Ie2 zE45qK(VEyx zVVTXsqv`9A5oT|96swu3Sl$~Om2mg>6a#IOS&>-ou%WRwEMWz>Q|x~Bv)$Pq#{%NrDKjcfDraQ~g0m?qY5FNK$eLd=8m%E_=lz% zZ~QqYGN|*9491F^(N!9$4`z!NPwn>!X^DX1ayH&zrPD8E>o1HkL>!Gdncfr8<|6YP zrwd7^0cg~-C?-Qz!)P({i;A|i3KLFOyi>xb#qI;95sOm$n((}+Jq@J?f*Q!-{ggMh zA(f*Mc~NWml+`7OF-&p>`-`AhaaH1a%q$6AdWY zq&9~zk`F4~Z-b#`xtn#;9s7r4NTG%Z#lRr6yp(^28ZPgH0kKAIIHpN~Xsa`#lncQT z!BNkPU8hE^E=4382cOswD^#GrP%$UMTXBIzy3CFj(#t+9rGq1}ZUkh9qhu}njh;iz zEK1yYPG=Jke|DMtV${EIJeCrkYYt{%6l2AQQKHyBdooIBH0RD`YZR7=CL|w?mO!w8hbykYDZ@Q&CQ-&|R=P<)*ZJ)U4^#$#~1N zUc)>oDA8$dL*USfxKf1beWBH;hLNR#SS%DrmRC3gi;wl(tU*A!gmZZ6_yA{J6yDfC zN6L8}*GCy)jojUApyMvIGnrhQRQ`OX9F-d)n$eDj(^q_Vzv8>^{&)Dd|LzBz+Rq@` zu;UKzj=#bA=?dTp$JTHJVF6)j2M{08SV7wr3kaS!F-$^+(N5P3Hf8L+GqY=H>*Pq+?x&>i=nGNA(AdLNBOM3;-6bk|OP4QtRyti%swFAEs z;G^j$#m^MZ62chZXf}&lgwd4IFgxE4x?E;Df^ulgc7~W;fR!p^9W+I$fi&pLV!5x~ z{(O-J+6dGDT7bRTXWMM><7ZDBL{2G7yW2g%WjF>M#x=bS+FgfY58Q6-#V#6DbR~gu zM>Fktv-i~P=4v*0=`=<=O$G?!_dMx9p}klaqYDmMK)1M*JR7Mvj*AqBZqEz%8aWLg z#$I$LP%$TA%|Lf&iDevGnd)b3K%RINzo?=TH%styQwIV&VIEWAI5(;8I7&hF&BjoP zA(pWSGr%fwe52E_0eKj7MXggf9Dc5{yIga8En9t96V77|k`*1yVO21h+7xbKFo~S5 zE2Rc5^0TP_M2lLyO7lE|EZL08>D^M<9YR`~%~EHZ{*{=*7bZV7qb_r;`87eRS|%Gp zPCOdJWzbH>CKH6oCscccj7s6?@}y@gyyAeGby!0Klha;p4uy&}h9;6Dm3mtn3uNK1 zHwqAcKoT3P+ti|F#9%Ui5Jl#ZiB7CZs}R%IP;?Eo6iWE z;iiIYK-F!`v?Ie*<_UE;XHE3ToNhTix#kPTv>6ocpG?`ciffd-QM1W$M{4=Nh0bI{ z4kZq%T$K7WkglXg7xNNEAX8$^7+Z5GNUEHW+X?3-H9k*@z2wC-H7y!YgdT`>H0Lm# zk7_msszpoKV7AT$ozkQc`koU?WL6zr6yG114aLf&(Ot@zFi|Xn`UkJgXevCt{&$p; z5^gL}G)~K-par?7R?yU|sJsFy(F#(`?Hnab{Z<~}LZ$e%#xN&pNe9n{&$SLl{dKNO zS+{PmlR7F6rKa!E?irPY)H@VvN-~VfKeLe-tubOA)ds`#gLcphNlc{!0V9F7f~0bO zXv#TZHQP8lvZOePwxUxkl|WF^wV-i~Im1g0U1L=9PxaS{+Q8sykqY)#ElP0yxrpIp3 zpyA9#K`HgTPofRQrO2q@13hG25*3eXY9I}f{e{I)hf-`7bk-d#)n043hWgJm#G(*+ zW8lH2H}ebJvrt`vSf6_~plX?g<2&y7jNg3!gzxW9_~HG(Kzs9Byng)u;PuOY0hWfx z#~-lu4r$N0dphCRFF2l7?EQ*euITNG>s4`J0xcS-6G$p z_+?kT+8H106^>FOr80(maVNBWe8wmZo$Jnqwh!T08uY*F%!!mGuzfD9!`ZZjii>lk zCvG6cBglRe=+b}{(A5!04<84#*?nE^tHqin#&{l07|pr9twAuTr)*B*ggnbO?W5r> zXif)VAu)(xgtd`r1>JQ+1Q6jtuQkmg3qzQ&tD-rzNPD1^e*cXv&BNQnny47)8^SdY z$x`5M3<=4cz%}-ojb?(aADjO-xO5)N0*CgX^h+~ zNMZnq>8`D;ptPeyAciiViuXl5o>{Tt!3->#++}{8c2*iN#8i5c5;||MNmxq^iD@Q@ z%L#{RxL6)*p?d0!a)xo`{5e(zQ~aCv2tHtv8kvzL-vqqyxQD9{BJN2-cz!Hh`!pd{ zK~7dnQ*;w)Tj*UyccqRTrhRrULNgx-H#Ar2a6r?Z^M^`%a~fsP$SCs^-S~#9O3Ey> zkuWO?KSfoq

    >b`oiQ`#5=o&zKz)en_V`6cIW!Sk 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 Wr?Jw~E=l|asivf@SSJ7C)BghdYl9a6 literal 23077 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 DE_v1F diff --git a/assets/images/stripe.png b/assets/images/stripe.png index 2f7ca444c7ad5de1070735c4236dca8ddae57f04..3632e05de3b249cb1ba08da828888ec5de3858cc 100644 GIT binary patch literal 3580 zcmYk81yqx58^?#Fgus~6HCjNBRCMGB=?$=GWd%~(K#)`c9lR0>N(-Y0hynTmFC`|S zOiDp|1EgMq5Cr_5XZXcA_u0Ab`?=!x|3CN6c__|~)&jf|ybuUP;FJv#4S}%1fjE+f z9r&eredd5b_H8)ZyINX@*n0<0;6i8cp$u#&6GvqF2F~J%3?RUTGH{_xEGzaP&EZ0) zaUo0~2VAVD7s3`Xq}jbHAQMMqU_&N>DlD*wOuz6MZ0Ib|$1QFEsAV0p9$g;81buEGLI+C00FBl0|&&wTwn{102u-UM?ex_OJrcch5!{DnsG4Cx?j_HFT8PZJxZeQ*K;d2!CY}UnXA+1E@3;v(;0b^M2n5Ra z2>&z;u9fh`u)@@KKAfLQb1g%iL(VTX)%bb$zIoh^8O@aVbNzkmGZ zlXMEYKl)uj|8n8WZSlHERVj~TE`zWaJA!iEU%tW3<66dCsRIr5IozwQQ6}?U`B45N zKRfbBI<~Gzm{W@jR-Zx~5;kx83|>d%PNgeG_a|vTuvy}?PiwO zl#_{~-uOpG?eAo_!i`hYnzR1t965g{+vQnt4R7S#HzoHz)4fs#A&~vgP9e=)BiNQc zTyL~s6GBeKSQ$JG{PD`__raG>kH>M7T8pFB)_1>ct~op$fB(-!+s$7uIMfx9oE3Gs$0h-3Q=j+J-$kCT9Dd_RKNGtyM>q1S9-5mg zhIrL$i1AueCAsBM8bKq*JQQe;O}*!L3Cc$cL5;9PB%PdOUy9EI6c5Af+DtGD zQLV_Uyah#FJq=e%K0WTI;%pTo<~cgTD~4MU?S{9FeWc=sn#U@d>MI%oN7oNktS>cB zH(|qCft|q>#OV3aAz6nk?D%D!JEdQgc6v5uj

    ff9EOp#*;DvOXvuvJ{a@ShKf^` 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 a1;8!ID(_L*=h&tH7iDQ?gSukk7V|%K#8mA7 diff --git a/assets/images/wcs-canada-post-logo.jpg b/assets/images/wcs-canada-post-logo.jpg index 45f66bffa657807aed5bfa3e999e9de356577371..004bbd448d499d4cbb489e36f0de15fb5422e2ea 100644 GIT binary patch literal 19749 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 Z`pgs7W6b=V4cv`DRu*>Vk50LU{|my)k`w>{ literal 9129 zcmcI~Wmwc-&^Eg)u%t^#!_v~RbS|}&G)M>t(k&&@EP{k9-QC?FB?t-v5=tW|C8Crd z-SGVQU+??z`S^U;i@EmfnRCv}oVo9rLyWGrDlq{q0Tvb(vAUYFJ{A^;75IRmxWG4W z#~a@Re;^JDS_)WLjq!w6);L&LtXAsE3WhI0e{=C)P^c^oR0r6DA>m-J%8G^umTX8v zb5GK7i%&Kd0zp4?)S>)!os7$Ey8&zseCibOGZyhGrfA6i6warYMstMN6&28q=c&<5 zaBfAzUit_&gvD|Xwj?~$HZJt*L%*JD8Gqp^i{nQ#^_|O=byam~U^+Uqr|D_w^x3vH z%xn!>`U^@{ChtoTtevP>0_6(8FV#Z{kmn=IFB|7_l|;_^4W-10xriud{c$l_ep zu0pz!eR{2+?~DLE0TWc+yjdFAen+0W_*dv7W0`3?+y;PfC}TAO$v88mganEMWA@$LM*8 zY$RW8S@?e8w6re$!4o;m%`+M*wl7Tej=tlhF(T2xL92{>#YnhF$tH@93yq9|bhVsL zDim|WxJ(q{2p(#v{B%un%4e0I}U?$p#v#(N`GO-C~+E%q7V zB4*)$a>_(B6Djer#n$miZ)ai)RYR{_$1C=ub{|+=zcRvStE#K!ADYI{2c$jZD;w^O zHZ96a97Y!hNjfcE??a{+Oll*l1}oXwdv&ba z<8VR5ZtO&h(A4p2NKYsq@p5sq)F?UR!-;BX8LD5~BtyNg{>Glai0YZ> zfuMd}CC@vtmptloyHsX z!hI1k%}bl+Oz)LZ^^T*IUbgal@woR|beWmKILG9CF`t~2;M)-?0xtS8i^V$2eseNc z^1h8~R8IYAVIA#DyJP6amZXJHy^(bdTG%GtYkEih5gxwLT$SWVidK%YBJK-YoNe3;F9_%FaB)#(DYNFOBkgE=~oh9mR*d zEBnryp9sA)YaepvEqoCz9?jv5D6DHH;FtCPTdwN-$B)V~*bV)DvC5|)`wYVIqu_MG zbnRC5ZHjww%r7tuCereee9&qRQ zX%r|Yl2He`-Sl=2bOvpCXE9cyjQ2&fvMtRL-W60odoHs(G$EoSBIlk;s$MDkVqSOI zUywyQZ+G_hd2xA@Ukc@K3my?kB@Hvq>F_uAuips-59BEECd9ofS>uo`(;DeWK*1|I zM!P1UG&B=F&K&Y4hK9d}?1d3RbHheyHD>Zw(`TtZJfWltYWBE^t`J%m$LA-`_KWQ! zl67{Bc-B^E+wW9xxr(vrowq z+IDrO%>D8?MY~LvaZ@@TB{chNOL62J;`pJ3uPEx2-kCZ0v#FVPM0??q$NUPBgJs`@ zR|*XmX}fIB$0%5u`(R6@Nu&ToA3Dj5ZsI)Bh&Q%;$f{B!;LFzieN zwJ7_%#P0)tWlLyM?%wJIc7($J{hFF$e*>r zy$j}1M<@w6mu%d3vA}_9Z$m_v8gDbNesGDq=X}6M)iq9#)%xt~dKIy7kw??DrPA8)QSN13 zXL6D^b~x#en`~H<`<|WH@q)J7%aI;0s55{0#gB7VLdli_5cmT$h2mG8XnHpObD5lL zkw1>eEuZUO&wjEwn|#lnILX@67T?P?#o{qqIl`$ikx*cB2GiD_!QKvqfN1_n7x~%- zB7{>CzZg~y&n>oPs1pjq$GOmQs)4sEhu^rRi79?6*g@-D;QbV}_`k6bWULb7<1uLrmR3S|B|(_zpWJ1j;Xo8WDHiFR$DaVk3yVYUMSvYP(_A( z(PQHx{$79M=z?&j2+2D&=Gsq{G|FEq3B!d(D24qVa>M5gYG~lL`e#n~fh_t%$m8rp z=5Ag}WPF(6r!dhZEcA28hNv;`AI981-Z{m0L<7&FYR86H!N5-hV0IlI@z&kUT;(v` zqF1F4^i9rU+0y8rb3JuIu#l^7HANIc5~`R}tf1K7ACL{wk^mAdGuK+WC~X;0S2xr? zB&tOL3-SWL7xThjkr;x6D}n`!p&yuOp08>lGfi>g9~Lf_~)C;fMb zmT@Q!I0)kScWaq?xShpJMJv`{KOisu5oZC-aPf3r*kn~VW3lsDhtre)K&96G!9Jf* zF~0al_w&8|c=42+iU=u{2X^lXgPuL0QKSY;(a(&mM>-oSUNNn2AcVV4Oa9e9uskc* zzW|jlcF|?iTp#r?ZRx#pnfs(jV-T4n&q;o8U{85>uoxtgz?7>b;LF;+tVI{{HiAb- zFPpS`@1|iO;I>w=VwsEG^)}XmzhN8%5{JQUxXZkjyf+2+njDvh=^JSh@!6B{*L6|u zg_ldV;$f;ZfH%Wo2~S_DzHsN^%DHwUdq3jS7APBo<)uQ&_@5 z>26l1|KE>S^&k0sOzf4%1l{KCZ?C7xE`r?D z%clkvv~$yBl`99*A4p&-QfcIX2#Qca<{tVQts7XV>_Z5xNEXG<-n4Dby1r--{B{ov zXksQ)V~}tTvas9SI(-?r*I=hyY}eHI-jme#Q9QwY(o4WbNVp96V5!APk_z|rl=aBQ zCjo3Jnu+5NEY|Wsk*pT-o;%~0rHqnvrUx9XiZ3{ic z6)g_&eg+T1yR(Wt*nvoTeaHU^71fOBc54fUW1}-210}?WCVvP8#z&wTJVDbUS=GTU z?tE=FtOy5tfunREE=r$ym~L^zU%BvQ>s0u^XSc+^~=77YgX2P z58KC!jUn%EaIzmn09W*>Hr&_w%X-Sj_4K(+3c~XsI(~%Ua4;)ND;PD&B)Ayk#u`QF znAMd@)UByE*P+K&pb z!SDnL$Y?3j_ExE`j3iIE&Ro5aBg;&f&*nEpfX9@)M1+&)ZhVELpH$R+5n%gd>Af2@ znNBxhW;*rEE}4uJ{_b`&c70vJj?_A(D1I-ihwL*<_kO(e06eVCrrQN?OJNiVd{ypR zb*lNeU$3k>Q@{ihfOul6Z<*13|^pty7`IBJZMcdNKRS^@> zjJk7K5tddhXXi0?)pNOmwj1h1jtcd+A9Yy}lV@Z5Da;oEn-drcvoWEqH%oojM$;^J zF>A%zP@gb0C#J<_-APD2q z7n$7rq<68Z6twKMfy4%Gjud!$asp-ldvsoWft}w`xCowPtBzgq)<R||fZ;T+vU&?i+OV@kjTjh9VYD?Kv>r~g_LzvB^Q zTk$X#A|(>of3_S2Ni z^mrg?AR7z%iES#FJRkdV07YzJNaE087EoQzdw!3I&8YJqHzQ;-^c;Mi5kXuP!@3;l z{2s|_*v#$l#tRmI*;t{5ev82BK8bQ$S7{y+VO?NS)4mZ&`xHgToi$gJWfA=W(}@+)2e-ll|6Wl1?GoC4z%9DZmj0+hO0Za0otYlWCIN~s^W?j{ zQvV#@#ooxzKl)&{Kamk?qFnI8dRJp>+aFHrf0#No$x~l;E5x9VI3z;Emi>lNLC7$@ zrF~s~35haPrmeQbrXSbuY6_OuOcuNudOlY$ItW>8SVx4blfrJj)B22jChJpc+g-xK z&xm0HhaPei{cM3C>!TbPHu{WQ(4$d<@X&#zIhssEFur1VGkf?4u!9f z0n{TM=qBKUW3;jCQ#M2+uFzqc&|ZwW{=@?gD4P^OXo}`w2Y6t9W~*&~R3**4@x)XR zxw*bEFbrW|nF;t!A<(t`t^nlvtasL)Ekz=k`fCHo!Il)l%MO2wd*~GWIGfacidR+z zP6A{uZa`s035*1S?9~U>*4$U52X2)iK)n9*Pgqzfz>Cs;MoIt_sR9rSlN2R@yQ>M% zE#6Orp1|eN1w=*m$Y((QNdt(HX)M)GKr95rNDYF!yTS{wv?dCHegF~_0g)h;;v)c@ zCK_1wwp^CcF98e%L<(-MJ7{i50j#3m1q1L1nhJ0)LwzV77;eP{3KXati1__uO8dS| zoOG5tu`nDah32#jG2W?KA`gJzMMco)t(OrqvGAYIJK`B5V$&)hc_C}q851|dAKc7} z@=AxOpzRnyyB%fRPr&BD{@9(z;7{Ny!gn?|l87Y)#{e5isSte`gbo|Iv-zXd2mDaB zI};Vn5*^@x`B||LUZ#=7?eK&eJ3ITFqx+JDo*eX}Ob8u81bE8_*x|&!k}KdX4&a0w z2?-z|c;f)0N`*ud1B6x?Nv=;zZ?=iZJM#Q5nfA&-N>X^|y2-c;)C;R5W9vlS8Tt#c zi2)6lFu@e+(WJ+vGZ}48qV!KgDj7ci|B-@$QBwMj)T}BFM3S^*KNuv6R>GqNV&H_i zAR?nT>9NwzWCR(VX@5$4h6)}FFwhE5kg||BeQ-=3H|m`AO^xAOQMeLDs$if@Yer{n z{0@YWKgo4Lw|nhgn|eix2KqPIn&YsW%Z`@+0JI&V-|U4Nm$>rDqaV()rYdpYcSg0P zzN%Q8pxCNusYHYtcRn~3;!sc>rk~_7C88OhOSJP=EG!`>u(qb*SUyr~^Qd}Gp&Lp% z(p;+_dzz-5N%k*|fB2lk*I659(f-ZKko=~Mj4+Rb(s_7So8(bWh3BUTgNXAeV#p2( z$;Cb;Y=4uB+3;!Y(ro-Vy&#VLxN5E=;xnd;rQjwrEi;%nox=x+{GU4T<5s+YBvM(O zIf=cufA_`CzseydgLInj8^yT4V!mH$ZwoNohYZQgrmKoXkf%CuQJdNMBCpdZTjg}G zGVL};cDuvlvXJev!1qm&7Z=l*oLgP;9kwqKDP(iA)dSV~2=6?gUKTJ9!2Aiem@{RR zUmfLa0hV4Mr}n?@4sKbHrJ`1}dq62s9vr=K`hb~Aw7SIyIf3AaPox=hlj}Xs-{lJ= zP+DY(=(L-+f17Ql`FNw%n@)?XB1VjOcrU|I6vhO}K^6$D+-?tHaw_V%wtzZ4OZFkR zZ+k^80}3_$lk_UbR!gA1t--X7y|B;VLg1>b%8SEdB}$y>*Nx6XRMPJU!ex3Q^JH`Y zcc20(<$h(J2{PTiT)ujv)X|Mgv;0H!@HmYVd2&pn*FMM8-I15K5?T;Uu>-{GT`}gv z*;=luA1~i#AI$!a z4iP>3fm0b;pyokOPrdvfJLd*xr5OR`PzmcBlChy6?fyC0b&Y^bh7s~>26jv^pk|i^ znLB%Khtu&DhsQU{-WJzVd@qj4=}qEmH7mb{q5oG2kODQ%WcZKF+(=?)ls(&)d{N|F z%gAP0Z7YJ5{;n=TTR}ERwu?h#yXSQK%BEs8`H~r5;-^x6332e59rX<935ew2VWi}x zKZ(*V`1QK>>Ghw-O7UR{)}+)@XM#eWNBh>F6s!OgK7aURv%7V}<6@~!e`6B!5d9OU zqqMSTMu*b(#!lpQfVpvz#F8XhN6eM z@~WrhZBA|~!+GO8szk@yMZts%yMqpZTVN7lVH7j^&OO|GL-*#RN6(nE6KP&l)`_PG z4CnKUxX~`+g?Q}t0fjRbxEAtjm~B(Kw#Mq@U^cigm|z5x#XdslMHq0=#p=kH#5t65 zHFmkr1Yl4uWQg$nM8tEg^P(>NZGt1>MBV5i%xJ`Dxf?**>rc<7pKY<{YkqB+QB4B% z0|C+?1mY6Iue1<C7|OK7FFj>Ta;fEb;!> zQ(BXL5D1&6+PyhjN*rkGEtPR&wK?$A{USo7j$)4Uy< z>hzyqo;-Cpxt-ADOqE&hd>3_g8mpi|%SC%VQCHIH$#PzklBm*L@#PI0|Ie_nWT<1- zAN$U65|bp>qyw5sUB>l!av0h<{>aEbsnbI&e;`_!=Z8dE#>9urZ}Nv;Jb%S+zqL+R z&O0>5C_o{u4|~@pET70fx&1hx0`+iQ{(_^j1cWbHHnP9iDaL~L*B!>Y1EBD{TId%Q zgkA&A5sV_Sqw;J-(Tkc~dC_;X;bgNzv}FdGsD79vJ&E20&@Q$w^I!9{P2^qXLl&fB zxlfsyu8;%inI1s>pHL=s0KQuQD1F=1%Xvqn0r3;5ToNt_<_JK&vmIIou$1Rr!-X}7 z4FH{S0AZ(x!TEQ|@ve`fdZtGEpW@MqRGhndx<4_jdrU1Bm*n}I8>}cI5hUCdd=p0c zJSUDt?cUe780pT#yq-S#GpFw`sLn$G#BQ)6*o7OVhk*$jgPbThH|H0ERM9r((=>a(zPn%kR>X>&B5E;8KY_h z8G7yi`0&3TRX23*cxyJ{>A^Olk(*RcVirXMrKBiM$U=)}H6{hXhwXMHc-OI-mE5>8f8?E&)$ zJ#ZRdTcuA>bm!+9Z;K%3)azSV!bJSLkIzNJ;R0`DIY?SMIamRB( zRfEp^;c#pdqGErCnT?G*droXM=M?w-f$h$ z)vmFa8JaUMSq@Hp7)s^b_?8{kVW@U9RZmdIuJn+WvGD$U_At7`FM=jhB}qdj*lMEa zQtX{oN5z?QpbrZ`lrHgQ{{86bzxbNTAt~lGOsgZl{8}5lLyb6ik#uXUruWrIGO!YH z+1kTLDP8T{!B)7Y57u11R_8-u$Ee=&Ub<5w_V*Oj;FnP zYf%Q0lM*8b$A0gW_0%IJ)_$!P`F&-~nH=|efOc3uH~G>1&(69I`k~ujWO>G?PP$HM zN{^4VdD1RPJU{Q3$1ge1D9$(G-Anfd%CkyMtdN^p$G37sKSZ zo(`xu#1MW}D}K+d`m}{0cg?453OSfuUqewJY@%IGAL>$plR<$PAv`=ZdoR87(x$$s zWi&^VSgG5}H<*|qD5HHpN&RWig6AVnoNEZHuF+#of}3OX*J!dAmag5B1(I(mzY_BgA7A+0p@(YkTpl_p1{JiYTSKP{JVTL;4Rl;BVOTQre;m-?L z!sBkny&|5-&$zHa$R2L*?uiNp>b(CJj$caBfVOP(9c z?wDy3ab?-rO4IXZ$d%#?99jwsiW~SLc(hD}bIZp*KCQ<$lUs`8A1a1t%&RrZ@w09l zu~lI?%RhQswJf-2>Jz?k)P*}$Ehnvke~ApcK$Y;8pSt9lKFYX-V=9g@$dQUvm8tS0 zOiupzuxtE;<9B~NhL6TTsRj_NEQ)}9o1l1#&CX+;Z>aR|8H2BAa1`A66%;k6Mwtzy z#MEFrxab7vxXS$kDtVM#i_PE76aOObzOQe z@PsqE9>0nA*D3$2-`>Uf1=U}$)gTC926!tQXM{9~4@YwRNi!#b_bvJ@H=pANwu31R zZINLV(h-w+>RY?#Jiv40aj`9*dFL4xVhcR}A!^Fu*S(Xux$6a(Gk0xrO29wQAU{q} zXTny6%LSzt`D+r{flH2yh>!C3tWc{6mlz>oO(u?Ow7LkpRZ-GYvbQ<7Z|VE-RLKhn z2Y2wybf#Vzk1N&g1q3fRmv^s<&Qd}VPubk#`p-o@!v*`HTRhYXoLkT=UCA(b_DK3T zou(}T&HXY1LE*NCv6iX)sWlwe&YgVqNs4ZX`qc$ewFRaMlzHy5x846ed#Al8jI>4x z)g9qy2Ap2Vb$^f@_|d0c_nq13P5T%@6t&K`Tf9aKMzPWT+z#M>Z?M!=w3X`=t-}8Y DpooG_ diff --git a/assets/images/wcs-notice.png b/assets/images/wcs-notice.png index 2fb926bfecc78a75998975c25bb51028a349165b..99b604d8e9286fe3a8d173d97c3328b75e2215aa 100644 GIT binary patch literal 4797 zcmZ8lXH=8V(|ts`fCz{pmPikv0v5!AbRl4f550(jGzA3_6i}32m1d|?1QLog>AeXd z5TqMwB!rgGjD#8j_>aF2?}vBKo;|a(cXsaFIs0WJ5b(Ra+^4t!0N~Zr)dB(FkPy>O z<~+cme2hyVIDn~ zD1T_!QR4dgI%Rd8>F*jL^^DK{{rh*3x`7#)?IA2+@gy>JoxHmKZInz|rD+7^F{7{} z(>&&30Ky+TLc&lsn0V$mIQZK+HiN}acaD(o(~CeRk?91Sk^#f_1`$QOjC~-FFhE!U zatUNAl}KKtP-&gS6(**8be4$$@+OCgWagHTIP8o z5KzHn{x75V*MH!=N#K4Uc4VgeKV>?9&UB3snRT@giI_1WVD*6+{txpX!)Xe2Zut-J zETeDX4`XkCo6cyQq+}5{sT;q zPLfw>Tho-^OhKsY+t~R(T~mvl|9U#xN!jRG+Wh%@yL0CE?8ffS{=wwh&g#zI2IBxb zK940X&u{H9b*Lw}f(( z_wvp@k7c-7RH6N+GLhG)1l+Xb`>zq-CnAd4*XVmw>kJj2%$DJ4+U|jSS)Y9iQK{k= zU=l{8{8lX-63HF}tUdxsJ;;gme9|VwG0q{mnsM;AYGM1`(AvK))zPV{J5gruC@0W}7W!yhFd!e&}}itLKG@#kFNhktMEU z&)`;hqJ4L(mVSB_!d;T$9|gz@x?T$!-fiW;kGP;!XgcGX<10^FLBe2!&%duRm2#d!ZlLeS8r42$`aMmh!=( zjZ$G(P15S~c!0speNjzj^XzE+0w1`a|KaFT$fC|xSBjgih!!~I9aX;}+i;7xW*JMW zie7i)v4tifK3AQOSRs3v{o!0JG7!!CW_;l4^$f11CUKfov$LVjGF9g z{y$FpA^0?7!sLQ26_Hea6sm{{N3WFXBajkPDo)PchQ+4H?QIM%;<9Pg+QKEl{xg6Ij%tsyYjGP zq-g%A#FAFaTh~oXTlDZ^XWYiSFEu=DhXu> zp$HJs^V!uI9Xz5MV1@v%@Sj|3(Q*NZVuYqPuEbCF@`Rz+xu7e&61j-K;M1)Zqv5+y z>^5vHPqnr$bNnfYU%)PpGSYM;-P-sr$@Sb;f8H-dVve{Do1Qw zxIW$Gwf;UP$Q*WloFMUhYg2xnm8QrKvN$*RY(X*x-|f;{n%w8-relXDR24uQ*U&E9 zn>6H#So|%o8)Ik}=vag?F6FY5P5sZWO}Tp&5!D_6aq&&lhzqyg%6iWWbsx*Kf-)u( zPy;r6&IzKEkJ*po(;I?~ECL|Jquvw3FKE1A3pCrnU}_?+Wu z&tG1+tmGVgehGnkbQb+)KfKpuCc@JtSKOuoSrG}2aH6e8n3uP=$5v}pt63WTHS&^q^V^OrT?&hZ{WP$>yxB+a~IK~~CqCEJ-GsnDLKhub}M%qanN zt3;i9#_n-`P!P|@QEjj!?#eM4Ibm~4oib#Sn$=saFar;0(p6oO23isjnW)zS;dd#` z3Q~tv+Pot#8yuE%NN0xO+TWx7|TmS*QWmhf!mrkxj^axg(UL zq3*`yTT3yt;2n-U6_9^f*|aFzJB>@x64giuLP}S{+PFMi`u!=fcGmltcaiqYviGCBS zqgPyF#R{stb#5wv3KinWI}S)7CTcQ8pNkiaP4I%j*{yN%12@5;%U@!H&7&yEE9hWj zV|Tx2f%#cw*Ez9f-}T!nnnR%&AR>8p@-?)FognRNtsOI5VmE-{TuZhu9kYjJuZ zK_nMB5KP+kJ9DP;p@vQ6lw_g)qFX`Lt}Ik#UbRrcSj)u0kFDXH&tnzoW=}C8IF@nQ zu%NBD8-TU_plFM1B4FNMw5z@rZMoUK`}lF+GeItBaV>gzkr7YkIJW=PWGEe}1XmZ; z*uiyFjr0m1ml}cf;La12oKZiPmwC8mak1O7*Nu~(sYqZ*nt0Sn-_46`g3S*%5jby1 zYlmh{{?~8P?K23Pt9Idqf!p4wAAC18v%l-dNe}3p_++=?l=dTQJm)4=j*~V4Ur`o-MWj9l)aJRzv=s0oZig{YX)lBv2X|$qK z65vAc=S1TdUACcS5-^3A8(QCShHJ24a>4AW!JT%hBP*kBf2L0|4(l!W3l-rg;}He@S8-b)jdceq)Ek|kxF3DU>q6HbqI;zi@rksp-I^j_di&FU@PG4BXIj9+^G zadsEgZ@ClSFS1aC*(!tFFrGn36GLUq?SWp3DqWAY^Go1?(2QF+LZ%EeUo3QkC zJS8sq@`9QDq7jMmw8PQ&V%=j7-%W_2I~EeFB#Wh5ocqeHrzYkg2YxSZ5+1nxN+)uB zdEwk1>|1ay{Tr?VQ{!_}OJ(jt4ym~q@(sHwZpB8gJKIp+Ai`l>z;}E3&gn(DtX*+5M1-?$*))~Z9u^ZiK-M5_ z(~pVk5ZHWs9*Aq9cuu@5?Rat>I*on5Bi^5xK{kE=JB^!lt`1t=;qjJQQ4YtA8yT>PDZl=GhglkU9$9&fwRYJU+8XHy)V=%FzJvk6x# z$6QlCoK|<}{uYv(#$Oi^l2RWB-o2)tvHR9GWz(!SA>Z=`8sx+mrLfpb&|l>94$eYkyPZq5twhLqJ z3Z$U1@#}x^X-Lf&V;DEWG5(HzL7#4Wm|BQrdn!xz4+R^Tm7Og?v1_oE9P>-NU^>tN zc`|=!AhpHROIh6<(;<*ks3Yh&IL&tAsh{qXlZQ>OjpEj^zjKXcplFF!@8i(dAH+56 zX&M?I7||hd0&ZD~ml}s%b==N{R|~0LXAuNsxTniSRl&%bF1PQ-$smC2>V147T3a|3 zb7awMMxFmbXSKR;Iluo3+g`(_;Eo5Pz!W4jCB!df{#?h-CdspLHb%=vJbU|uExcf_ z`R$dszaDmSwy?-ic7K>wa1?~2L?;@fb_ui$J(Q~W%hf{Vn!!MRt^Eb=Z0;M9LWTJ5 zM(ZyIN;S|sU14``9Xp);Bbi;#p($iv?ZIh2+UW)swrX>YAGL!|KNs9FDW;P(WI~Cd z22%Xbq*!;(hy-^LohV@5?T4z1Ab$K~Z35@{ zki?5-T*9<*j1Ngh-n?h5x3X z;*_`K^iI@i@;Us%ixB-GYtm0%(!>H*f7LoFR0MjPzSexVEc60Up?gXCdv%$b+I=;M z1Ihz1A6`2(X(aUomRMeN>*Do9F2P~cVW>4*oBiK8>ZQF|4#B$a&$MWRuH`4fi1TK3 z?Bp^$&LG)K5}nUW?MkNaK#y15V@sX8*KlS-(%5}@%fC-dvW(ZQl_hZ&J2;#Rt$_;T z%L}d>!r~1xa=&;Q4W3#)}MM8%kC-mD5qTc0`rLe2?OC5ONwii)os_m zz%4BWbd#~~$&1K194OQfJ!PdQ5dCbHP0Zl_xikLX9UY*vW)SEwe)4`8Z&w%Y@a@>o zNwRxYGc1+i;ZDlgLP*%4V`uk``g?S!>{l9V>hbt^Rw2lc30!FjwIFFYllbI`9bW&$ zv0U$p@y0QAtvdab+b^bQkDUA<{Q1izbTdGo?TV|nuu zJ=tyr4qWOL&LZJb+ohaCw|qY?3@)m%`|dx5oEAkcvEILtBkB3>3;9I51Z;ux1y=ry0U!auz`$V0$x5lhz`)|Y;|vs}_mR$n!0~+|c9+(6S97v- z_cC#{fDt!$GPR(Rb1<>8P_-~I_i-7w5Q2fBev^|DSNC2!%MG;GTlN^ml2$DY$Wpcc zEKe4#Og`#1ukAUW^azh$NN^GU9kA?oWPn*Ixv zg0kXi>*XrPZB}?0RzdD#?rmdTz*3gZE$q0mz=$rEPy>&wL4&g^3w6esnbAZ2LCK`8 z-CbjAb}*fkfwA^ql=9kYRQ683;ObEte!XGo9)J9Q?tyFX8231=S@qiaSpwxTTH zreR5LQ%sDbP}m(+j>#53_$w}~^nyU5rMoPU`-iZE*pCwWPCsC7Eml;J1Wh7DiLL8p zP^rbj`ReuSl}0D@a)Rs3+XF@7nt0WW_p9)gvp>Ff4(8)!qRrzSSo^x$dxOCV6lu*g z9WO`>nctMAL9?i+dYRG1{GdKL;c9K5Rs%o{Lj{<8xlBC#C=wU=dFT332sbLo6y9f( zj=xV3KR(sC@K4u|U0ER91nxpGTJmxLCY>epa3Jh=!>Z#XmGp+n%)@O_D`Op)38at@zL& zuNg(A{)a+=CUH`dCQ%jv4>w9mjQW3o;*geRD<52!poWI$d{UC^z6X;0!)3jR%4*XZ z&fD8Z?@x~p=N|%5ArSzvOA)4Cb3N$eLyLsvzBTRJ)|1&smJcOtwfd#Zauf5_PyOk4 zZcUE?ib3H)reU|Hb*2mkdd3J8d6V>6-2Z84dHxpX!?7v(Mg*V35}I?&Vp zWW~e*Kkl9-!v<@y)6%$sQN^^`+Pm$f9|wBHFme4{WA&x)&1EwZNN?V7~vqqOL9M0=We|oSC$Fdd$}1eq*jr8 z&YQ^@VZ)mfnCLU~iL>=bj9t~gOJQ;epV=Y9D1k*4769@BNneVqU)T~51I43e(|Y~y>PJTDUmMd;@r_JDv1Aj z8YXq-;Y0c5bAUrch9>#;B>8;pkiG0$|9o@q=G^|4v$b$;QWMQCP5>A$6>vF#$Ha=s z-B<#` zv))kIjm}fog_!qtTy=Hk6^NL;&_u`?@Tx`{qXT-43*GyN4VIM#8hK<^9IpS}wxmcH zUd`PYYRyFlSyvDxP=b=vf+UzQYd~J&2AK;#-5gB`CW`bfg3^ryxhMB`2+-YpoC#1q z{6g1ddOEUwKg7}M?fg&YhFH}#j7@vbMyq!y8?FmCbA)|&pZEe!=E=(ao{m3z*Fs=h z7HA}5?c@#EMIp1r)cnbRFI)t?nKc*N6}**Is4JaQGaOULj{jP{TEF=RzRva^8v2#w ziVwA2l%Cek%slZ-H5j_1gf{yg$I(Nlx(X|}6zLb(hh;gFTlV@|n~U3nRZsRDsQ*lf zzF=>4coTbyc=HO~tq}ODoH$&X82Jvo#x1=*M0V1lA?|`QvT5l0j#Ki3B-m!V^=LyE z7`FzZR@tfd>w13~g>BD)o_CY=b{^Nub`;)jXbo?N#u$Ma#^{KlEqDJkX{@64Dc~la zZ9-u81}pH|lw}XlsDm^S;b50fh3pWRdd~Y#Zsz9}RD{q+6}qp^{sP_k9pRkQRY!5b z1o;tWpV$XT#!3EavW0%4jFo6jg_T1Jr##jsitz!y#$Ajbx3^V29bOHfiH5%he?dua zhjlbk$yE^3@naW%C+%K4qzDt| zxZd50zkJ_)J*{bN*8#u1XqMSm*F_F(RJ~k>7A_&++2JdfDh12cVgnf@Q85YZDV5cR zUuW%mV-M40CCdHo+#Uue`(7w}*}>wuSoYeRVRDYDYr^zx+$jPuB4lIjLJz#B9{yjC z;uxUX^dqg_Qq!dOzckU(a)wC@wH=ZYby zJl1u}Qr?)6nKi}52tp+%b)x6a*RQYri2;vOBi!JV3H@0Qbf%X}EY7)@?>%1C9iGp9 zF9%+|f=;!`O2*L)YFF!CA7QIIxNn2Xgl?OXdm?3ts1g^o9v^ePVD&qXO#1vOmYjM} z%AVlDup7aOEy~r-9?e{tW7^D~u{Fl8;|{$@kCT_LwoAL#;bZ~l4^8^{M!nZ;b@4Q1 zm9E5u$eVeBBA8c1pCn!%RbVLsQZl7g;5M2Nw+}Ryci`uySyDAg5E1Ye!cgtd=-hn? zLZ6zz1I_>Xug6%Hk#}iTM1LX}h+gd0&R!=UK5{k9ONbegBC_JpQR~m)Pb`&oHJPz) z?!97z71e+p^`XS9skG^4t>8$os^@GwX^}WDj=-6XC)ag@ z&K_c+`_2`0=3@*411ivQf4 zmK_MO?Pn9M>`i89Ze={7EGmq*fQhJde=xAPbr~;0Eb2{HH~9ZHjN1_9=G6(#UgBiAn>kHKu~<0yY`kBMa0Vms=Z z{y8w>%znH}Ui)JS;n#HsyZ&_Z{$fNE)p51~gP0RncJW2c^ubZbPFS9r9@Kbow31}u zhcM^FvjvwJR8@lyMbj4I`*8XR)>=DUHxF@B6obh>_{^6@5*M(MgqH~GCnIL8acK^|uI;Smqd%$B!>%+@8{->dO#Mvy}rbbU!~ z$*7>#x*@3P zq^i${abj;fpmLF4Ud!P%!OGn;mbbH}T{gPmy~~ASZ04HdXK0G7TA%!q93*p|5&nQn zSHQZ4y=9fVRCPD&&9A=^7kR~?twwiTi#^=|kF0U-IrRi%WGEvyTV6)dg@rU)b};pC5Aey}$5oeF6$zKXmT=!w2^W8D7 z^}zM)M2pXF-;`%xh1}UWpr){rlK9AVr2s%=n8-iX)5OEe@MIXuOa$_NdfcpQu_C88 z4IyWu>**aY$uB1b^bBA8JM-~l{^&&2c8NJ#ZD1uqzPiTml0{)INY}~{_z`!((`G`! zV7un#`<{9XFYEPcJ`#nB4Stkc>yIp^!|o1YZF|&BmU#~o`B(UC$6fGF6Ti-q+#7Py zs)rKb=utzpx>zB|oY$_kmY>=vNH=r~~(51uJ-ioA!rAIE<(Xk=t)fm$I zJRFI|(Pm}0ywmnI@2$?Q;3^FnfHg9s$$WRC4|Se|C440gpKuo{IDXwuY0kJ?HEY8R zXzn-5JPob?dNjh>8Qt=8eQR_xF)b2~KoS445OW50A`K(<2pK72ba3RE4hdiJTQ-D_ z3%-T9+Ycu#Ux!gd(1Tt1aI0_NSv)?W5mytqX&aJ0^JTa-hX`Q%cC_ctJ9AH@GaDMb zWJ#<@ngT!)^KY>;LO7vY5HY3y*Wmd{-NWsbVnVeejLa=`f_A!oZyP&<0x$wl>33dK~J9d3j%=RJLUy3ru1429AZmMhe*a_1aV6$ zAl%`ka$-j)2y2sK$MX0X&pnZCPvk;&h}u9(EO8@0w~G1EF=!Lb6-mjgCUs5iA5TZ>g<{~p{eQTM54%{GNZ-aY#pL@~qIa4a*}B#@Ik)Xckz zOx^Wz<|RhPVQ?2`7*4_V8ZRdeO=YxS?c{*CwL?NnUXj}D(5u27sjhB-gpF;_i3Cl+ zqK=m&ZfHlJ?@Nl;FPXY*UKaM303e+_-^>^sik0)yaywzFZ)moQjl-CQT3eYFPEUR) z%7hDNGY+p?EN#wP9$3Pc~S{`Y=$guyXrQD<(Fd3JdLcFF?CQusfF*-jOa7}GS)xn zAMw%;?B9N7IOV39ei)HPp-(%>*l$P~E;#3#x$$yqX2s`-J1h>Kf`wc~ z-($rpSJqyB!JYZXryx(o$(m2Cn|Ym_TDn?~UP8EVCv9~l!JSIMi-D-hQSOu2jr9g_ zDk=F$HS?4{4`(~+ZSOYRa~Xb4-&9{2EAD}gvAok)?DHpVPfCP1Xn z^7jssH~Uw^n5MlDZvpfgMJ{&3*t#t>~XyN9i2ec~YUtlZ> ziUm~BT>P1Y9A(QEggEH6)O1R4!#o<1c?l*{n~~=vexx<;;c1`1lNgB#aww%$?vz&^ z2GbeUh0!#cJ*;sM(-zHQgTp-8ml?vub!i8>@z7^Re!E%u5*3H61~4F*rb4Or2dQ${ zdqgv{3QWXxr*x0L+ZRn%Qs;<`<*lCI0B7_4bLenjpqGfJnK47-kZcTF-Um z+);2UULnyNl=HurB+>=%Z1(ev6S?f=2a12D8s0g0goSfjkr--$h?2E3>>8h@zB{)i zP6=+5A#2glVgs>bl$7^-6A4OSJTt0-c;ays2h)IO@$caj3i66m1Nr?5lZ>kpKjg7Uy2 zD4XS`X;hf&2i2a)vgGbWJQi_FI5wMYQ-V{4!?b@E_MC!(n$p33rl3{uvFVZwVJJZH zctaE31V_c(Q8i|eJ(||n7uJYAdw zDwhe92}2p1Q0_kzHYHa7O053xJ*9U=O5%tfB#uoly@yCWRrFgL{#MVO$6{raG?87R zv8pu;fxH6jBsRx?I29o35SX3CWirgqACxuQGx6iD zClaG%Rdl#abiqXZ93*)MX1L-Zb|>tk(!eYvB}7ON0L~OSOIJJU{P%uC8l+K`(#=I8 zO1;wRb}d_QgN@;!9<(ToJ|e}#dXQ;6fT7E^h`%OYQY@ngH28vwi3D<=o(qv!xz=Ub zsrDm@iAeXMGB8y3VzOxnEym}p^39$rVf>h_F&}!V`S`kBp1!$TV<{F!j4Gt8s;7bJ zF)%;ds+yskg_*)q|0nogo?ueuYWi*Wwjd!=qPxhucE=oSL$?Xt$00+7SJxa*kg29* za*^mPMN0YsLWmrNy|o4sq6?yyHM^iCpdKLcTdF3c2@={co@jG)2%!TV&h!LHKNvP+ zn?uqIP8&jBgtf<}iyqrl>mFk23h(+^8s(R*$4s;=JdQ!+zzY?qxM_PyJoYB_ z%+kdsm}Vh+Y>>ib&DuPce^r^~xg=6_4tMo8z)*ooY6E`^<3MFU-rlU{e}W(EHujWs z;Jy?(n{y@+d{@|XxisY%bQiR%bf^Wpql3+zsOv)IimZ@oZ!U=l#td?*fGsJBe_6um z1@W6pd*iZgH1I8ir@mgP4C5{@-EEV8PC&Q3(ZU9jtEz6CO73(VkP~=9=)G~uvLNU- z91%%URm0~4F6Jm+Cs;dE2N!zcTwmv@rn~Xp!ahKLWxM(fnekN>-_a0# zi{*$$pbjY|4ME+dv#xN~`o?|6$LLGnV^16$)_i1Km=ri1T8B>Gc!4wm6eU`^4{$EI z_C=?E49+IEUu52B)wWp%EW>$Gg$zcfMIK?F#Xe8-#bl~$NSZT+NV{8QLRNf4kciPa z3!)+$GQRBkFp9HV34g;P2*~U*z}GEi@3(cTu}%ej-_yO)I2Qu6M8g&4l4WK942Ve1 zX9($ab&uk$-1WX@ToO#(jvOTiPc(4Bqs`m{&8}s>N&Dnjun0|u_O2vaml)?*{0ZF= zLA9LczpSbQu-xPHZwT8AHu>#^4-nLI6QB&HA)a?LEFo>5Mn3RJjR^GJFg%=om4B}f zjn@xaob@DgPh3n63Pm4&Gs9R|{1vPE;3kK6Pd`uY7dw)C1Tes(^b6Lvi|~Q{eEs@h z0r`Gtk~;(xVY4G4}MA&nlOzv773_@SyW~Mdrmpnq67~Zg29eyEbP{f*# zRdTMhR+3;o z^T%HYf?;{YkqRktKL&#RZg!-FzLQ)Wx^Yd0*v$Ai2~YK`VHBIfS9EI#U{%g{gm@j6 z@lb(vF*+~0+qsp|tO#)w$`%TwY)hkJL$+K(C0Fx~*QwYv$H#AK)7jyY`b8gb1Z3h6l`f4v<=i5R-G{HJ90cSl@7h(a`0ubF84#LwuYPnGd7F_oHv(Rg09b+;>bJ{K zH}LRw($ra#au|4X;yKsH&FHnuPGz_MI-@O9JooaIy-Q!o(!$k&ci|&pG>Y%A4|n)* zGY16?OLpkM=4$f3Xp!{%be54e+xY-D&8k*#fIds*ti-VefjlLW)m^#I;K@{Eb)V!X zXSV7m`YMxIG~aU5e^jVd=G_@;H>@> zT9gUdRvj&wLuvm`d^Bd612m zT#OCi zViKw`7~#s%X-nd`_FeZKe2vTdkJ@^-t|D6auY20=?fTpS#URnp?A3EWk23X-M>Mzey_jxA{SnTCz7PTr2%5==b zYIEm4e_Pb11ukxTGMM_I^AJbv0*=)A9Q@Jw)}l)ceb$wE*jQuF03Ej*!W9}YU6KKr+Mdw9tk)i2(H@54SabU`NBhX-*vLq%iE(B)&vDjHDQkeBD?a+ z&_=$bwtY4BzK|#vMdpD5Y(}^X$1gWdFPrqBQ)=em-|)9((Qe^tp1xdh{Hz;!U%^Hg zF@(GzP3~lS3Q1JEGuBjYi|XRdQ56GQ{*Azy=xF5q-=JrB^xH3U8uP6=SR8g1`KxcB zC#vCVH?b7kY2NN&%9GKRCpB&=NP(0NOtV&-yh|dr@F8wAsvJ-wYKV6~LmUZLuruJA zKxJABQgqa;%AN=3LT6B+$Ubwf z9c2?3&b8t%P27CpE_q83cXr2#n2OCy z6lHctki6-&5Y=wQnOCaz(zJ_X>0#-pwhxcW4=zdkuki+32{#CTe z4FbmW6>ES$UNu@sVp`C9SCKcW_HduR7@p_rMV2R=A2v9-^0Nf`2_mnD{Vu5@Z zp%?N&m9}I*bJ3Y>w~v~zLE_0XCB&aO%+ey4NjTQ!aky>8i)yP8aIs=BR4F>k&0vU^ zKiEAmqMMd*%%c<7UnZtHSrCA^VD;F+VW}bD;~9u1A>c!Py|Sm>kYt1_3qEZCoep;~ zRP~>Kpa@6GYEqZiA`^CA^Y)t^CoxETZcLhk4l7(7ae38PXy3X3j59mR87C|dsxE0v zCC^qG-D5nBM_w@&R471Ol*?9US@NfUV?2!D;NBY_sn_Dcj3RversZf#!QL!1u#M{L z*1Lhhul2C{!4YS@_#J*MBvnWgMd09%2-{W*G0L9eVAK>5l??N=!y#A-O6NeB8W< z`E@%Ll>i%rFL&CEel_um-N3p>DGE+fb!t{k9(XG3j>merP2ACZm++!$KSh{B{>!hoiE4S z!}#LMhb3-AxYk_<_fx%Z*W3~`1UBKyS$wSxA~;jb;9^3{UrQ)eMFt2u@H!$yhSjkl zp0KdF-N^j9r077DRA1>^<{{kxYbxpdW_PiW2T9(seenCk!HkS~(mGQW%+!R&SJU$? zmW;pV)hNuHm*4&JW=$3Ysi}S^UmrJ?HQp5T9lW+SNG0_-+R__bvbdo0E67W*Sw)fC zLap%;j9BJ3cor02{6K5ZhQLMBKR!n7s|y~+eXpu;AlYxIaw_Q$uZ}LdIz`_2X+GA{K?cdT}*CH6U($wLt<%{Qv*|K(>8WJxFf~TyG6f5NH(0 zw1gUckW{^HT#arbm`tdyuLm-KifioS!Hk4jpnAikYW?_ntE5hl%6K5V7N`bf2uKR5 zUKipRAejVq70?-pAjRg%t@?2wLqJ**ppMjwuQ5*R09h1YEp@fi8|Y=ksmu-#5|iUN-{+i;<^`V@L(#m4jCs4?Bo3JKXFx zGFJV2y^{CN``Z!5Km0?j<&#d;Oq`SSVcoh9&c3(5)~wx^E&b=1f!e+pDfTJhzQ(LN z!L5g`^(t)>Rej6eDr4PcsqeMZPo&6RzAAF{S_~zO=}k~%O6NVwUx*Ygu4{M zn6=&%*$-?;ewtSPYr{$fh9rfo)H@6_Pg@rL4R1G+EED`3&w9<{U-P0hubw?ywsQ3* zgZ`ULOEho!<(KFNu-`be{AGKfe2;TJ!%kKYy6x3d_wuzGBk z|8?zi9>XReYyPi;oLd~XF=SqIwzq2VXN+zzxx6esXL99F-I`gE`)8d!oqzE1m+rc) zU(P+=ej$^Ml?O;4$m|MaOiqle|@!L$}@ zD45P-y$YtKSWUrno=C~#|K&S%f8D(5y}hh&j)#Ct;tVdO1``Vh>xkq;pZDEW_sw7a zdp=VqU&-yLN9@ZNwdy~3nYzwwIrZ^{@b<|k`LhzkfAW76UDz7?WdAQc4&673|C@h0 zWF+qUV|>~@BeC(%V;dkZefIv6{V$BuTg1dp@iRHKh&?;i-yhQ=raMW_%1uI7XPR8- zaUeA@u0RDyolUu(6xnrg(cY7K!S@5ABJ_4Qoezwf5iVnK=SS`;O`9oVYp2+J*DQ>R z2t6&^c~#V}``U@QVrCw?YiesJyqfdx(H=XG+=)?J{9g6!Je-yIcdpBw>NR4y3WCg0 z+`-D65~5Mv&wNsHi#|kcnYrd{hwd$>X<}!@mW6HFq;*E@?aqm}Z0H#r-jn|99QzL8aiZd%rk%hT_&v))L$ zR{q5`mj71LH8az{;di$j&`k@Cyx{E`*|>d1F4V>ZCaZyx&T11B)dFPgg&ebxsLQ0KRydy8r+H literal 5086 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 diff --git a/assets/images/woocommerce_logo.png b/assets/images/woocommerce_logo.png index 3a016645f387eb96b324c7879a7617d7d020bb39..d5f53691d43eef85a873629309240a81d816ac6d 100644 GIT binary patch literal 3242 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 Ds}Na9 diff --git a/assets/images/woocommerce_logo.svg b/assets/images/woocommerce_logo.svg index a2f90d6dcae..7eb949c7773 100644 --- a/assets/images/woocommerce_logo.svg +++ b/assets/images/woocommerce_logo.svg @@ -1,47 +1 @@ - - - - - - - - - - - - - - - - + \ No newline at end of file diff --git a/assets/images/wpspin-2x.gif b/assets/images/wpspin-2x.gif index 392e82ff71b8c22a401d7c6b85943c0adfe4a98a..82778416693904e726046e2d7b663215cd3b33b5 100644 GIT binary patch literal 9088 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 WFVBgu>xGn1+ROpCF@szHn)_eo5Q<{} literal 9133 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 literal 2209 zcmbW2eM}qo8OP7Q^X1@t3FnIsAE|TP#b@6eQA!i3)2fR2j4{Rp1BSQ>&_ICjmf(OP zKyYI75(tom_lAsiT^L!QP$e`d`J<6o168O{29=VvnuNAho4RSzy0z09X;OA}##Hj> zKBxQr`P1+FeZJ50WMn#D|50fIkO2G>0G_M-E5_em@TVx7FL?TN^J$dFF;*TwUQvl1 z4`M7nc(52_esOXB1=G{>(QkfQC3Z|tPESS|js7tPVsyngAEPk}@PENPM~|fY@|DBh z^wj+aK#h6{^9+jH0f2xUy)Y^>4ZgP&34DXR>z~X2`qfwF*q=P=+bF-A6#lev(VuL( z;d2KQ5Jb3nHua7_b>i0na?s*d zD2by3tTlzowo~Fn2r~&Y3d14yLhwaM%QQ1|F)o^W%>q(sWTf6>K1DA9fL0QWW7dAf zEOG?L=hdCINxx|frr=WpkEEIOC}%}A0*T{ME$q>#6tY&L zim4P50Ei|#C36k+HdV^|5{-v;QQ|FC3WnYbU4$XFiJ8L)(Ohg6&CN*M`XwRJ zYg1(~lY_@cYX#|Zc5hh3HRlBSbbWx6I%iZBL;qEwRz&wh73Y>Z0xmf|#WfX3OV-CNvYPp25t22r)|2irLt4_=Si-r}i5lGO zw&hmU)FH5gJ!_Plg{F+mAT+8oxAIOl+^mzSJw*-}&_aSkEa|?Cust8!w;bJ;j{Dov z@#ciSf1`X(|3yK0#Y9WCSTGYwlYMJm_wrs)+tI>Ximv62yOuYqhKEoT;ew2%Cs8to%wjo0F(2hh zKBdr)NJ8?6(5IN$NtDOs(K_)74QnA-z`^Eu3jutqh1re|RAUEUiiZZ+1?*I#-n10< zx<2!;0>UReX@lc@e_O-A!Oe$PC%dua1hn#y!L73+ z5RBwdWF3wt7_wyQDyfm|XHaZ}ZMfh^5nPk)ZaUXx%jTMLDZ8kFv}NTGbVCu1$jR2M zEn8zH-g-&vQpfEjv0WZn3;6pEjw=Q&E?jf4e`q*V{YDSlnU==yA-!MOM(%j6!>(n^ z?y-eGe^U1MA`AfF6DXW7DpKuf7h&YH=pl-iBrDNS(9}|0V$fN1w$`@uIvxUc2wp5- zp*1J9U?tq)okJ^hrk)o?et85mszp`CMN>AyZYo}O>X!wVtpl(^vc_M7x2n8#sdPtj$b{K~3ABHaSAPO|Y>Hqhn4cX~kt z&`hKs83F~cWye^S9tk;-;#}2I)EGGLMGf(2jR{gS6 z>2e&nkN0+eoEsmPc(WjL`FVRPEk@fH0RUP}n~fk6d4_}_RG=`75)If+y4gNC5x{AQ z%AQKGSuU`gJgYDQ-5$DFIjmubUOdHo-8^%OWu)9Zbr8u{k6p@T)%NB5MjjX7F%2t< z+|KK}j%r#gXng?1t)0=Jy*!7u%G;(2xh?7(H$JcCixQBv-&d!uLbCQ(%u0DEmHO(o z+BM{rPc2CX02nd+yA2*Tj5WAeNfDqk5hb{Xk~QdCOdFp_ zzM_G1uI9=_XbRTnN=BSu6}Y0Z3hTDEnekJ#o-JQvO}zD-2DQF}3&}wL&lgG$42~-O zf81wDc;CL!GutjFVHuXPNFS^{46O5)Hy_?C?KYRE`ktucWmln<=%`R~v_LPBV&DqSutyZ$Z$vv6Fa*KS-P)ul+A(+sfOz6pqF$5$VeP zzB;}D0X2C1FWwwp%kb5;>>FBLwmT^tiX;L4+r3z4DV6YL_q!`>*)<{Mc#2CP_T?Q(9Kng^di5XM-KlofjKwKmHFcrGY#E From 65cda44fe68895a0bf8baccd689b04d95a199a6e Mon Sep 17 00:00:00 2001 From: Steve Grunwell Date: Thu, 4 Oct 2018 13:53:55 +0000 Subject: [PATCH 015/361] Add tests for wc_sanitize_order_id() This commit adds four test cases (via a PHPUnit data provider) for the `wc_sanitize_order_id()` function. While writing the tests, it was also discovered that the function was returning a *string*, not an integer as indicated by the DocBlock, so explicit type-casting was added. --- includes/wc-order-functions.php | 2 +- .../order/class-wc-tests-order-functions.php | 12 ++++++++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/includes/wc-order-functions.php b/includes/wc-order-functions.php index ee68ae42d6b..efcc5056dc4 100644 --- a/includes/wc-order-functions.php +++ b/includes/wc-order-functions.php @@ -886,7 +886,7 @@ add_action( 'woocommerce_cancel_unpaid_orders', 'wc_cancel_unpaid_orders' ); * @param int $order_id Order ID. */ function wc_sanitize_order_id( $order_id ) { - return filter_var( $order_id, FILTER_SANITIZE_NUMBER_INT ); + return (int) filter_var( $order_id, FILTER_SANITIZE_NUMBER_INT ); } add_filter( 'woocommerce_shortcode_order_tracking_order_id', 'wc_sanitize_order_id' ); diff --git a/tests/unit-tests/order/class-wc-tests-order-functions.php b/tests/unit-tests/order/class-wc-tests-order-functions.php index 170972c37b3..cf167631fe0 100644 --- a/tests/unit-tests/order/class-wc-tests-order-functions.php +++ b/tests/unit-tests/order/class-wc-tests-order-functions.php @@ -1271,6 +1271,18 @@ class WC_Tests_Order_Functions extends WC_Unit_Test_Case { $this->assertEquals( $expected, $orders ); } + /** + * Test wc_sanitize_order_id(). + * + * @testWith ["123", 123] + * ["#123", 123] + * ["# 123", 123] + * ["Order #123", 123] + */ + public function test_wc_sanitize_order_id( $id, $expected ) { + $this->assertSame( $expected, wc_sanitize_order_id( $id ) ); + } + /** * Test wc_get_order_note(). * From 7c3ef6cc271741a9e5fc6f9d12e9a7b0d18bbcd6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Demarle?= Date: Thu, 4 Oct 2018 20:22:18 +0200 Subject: [PATCH 016/361] Fix missing punctuation mark a the end of the comments --- includes/class-wc-ajax.php | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/includes/class-wc-ajax.php b/includes/class-wc-ajax.php index 1ee0169ea04..200b138e6b0 100644 --- a/includes/class-wc-ajax.php +++ b/includes/class-wc-ajax.php @@ -651,7 +651,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -902,7 +902,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -957,7 +957,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -990,7 +990,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -1023,7 +1023,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -1053,7 +1053,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -1080,7 +1080,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -1134,7 +1134,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -1164,7 +1164,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response ); } @@ -1677,7 +1677,7 @@ class WC_AJAX { wp_send_json_error( array( 'error' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $response_data ); } @@ -1802,7 +1802,7 @@ class WC_AJAX { wp_send_json_error( array( 'message' => $e->getMessage() ) ); } - // wp_send_json_success must be outside the try block not to break phpunit tests + // wp_send_json_success must be outside the try block not to break phpunit tests. wp_send_json_success( $data ); } From dfad1306def55acef09550cbcb74787610ee4e68 Mon Sep 17 00:00:00 2001 From: claudiulodro Date: Fri, 5 Oct 2018 15:46:49 -0400 Subject: [PATCH 017/361] Revert sanitization function used for order item data --- includes/admin/wc-admin-functions.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/admin/wc-admin-functions.php b/includes/admin/wc-admin-functions.php index 6bba04d9e20..be7dfa39a42 100644 --- a/includes/admin/wc-admin-functions.php +++ b/includes/admin/wc-admin-functions.php @@ -208,7 +208,7 @@ function wc_save_order_items( $order_id, $items ) { $item_data = array(); foreach ( $data_keys as $key => $default ) { - $item_data[ $key ] = isset( $items[ $key ][ $item_id ] ) ? wp_check_invalid_utf8( wp_unslash( $items[ $key ][ $item_id ] ) ) : $default; + $item_data[ $key ] = isset( $items[ $key ][ $item_id ] ) ? wc_clean( wp_unslash( $items[ $key ][ $item_id ] ) ) : $default; } if ( '0' === $item_data['order_item_qty'] ) { From 91d2411aa9dfffb6bdde42f8def18abe14479127 Mon Sep 17 00:00:00 2001 From: claudiulodro Date: Fri, 5 Oct 2018 15:58:50 -0400 Subject: [PATCH 018/361] Use wc_check_utf8 function --- includes/admin/wc-admin-functions.php | 2 +- includes/wc-formatting-functions.php | 14 ++++++++++++++ 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/includes/admin/wc-admin-functions.php b/includes/admin/wc-admin-functions.php index be7dfa39a42..d56a72829c8 100644 --- a/includes/admin/wc-admin-functions.php +++ b/includes/admin/wc-admin-functions.php @@ -208,7 +208,7 @@ function wc_save_order_items( $order_id, $items ) { $item_data = array(); foreach ( $data_keys as $key => $default ) { - $item_data[ $key ] = isset( $items[ $key ][ $item_id ] ) ? wc_clean( wp_unslash( $items[ $key ][ $item_id ] ) ) : $default; + $item_data[ $key ] = isset( $items[ $key ][ $item_id ] ) ? wc_check_invalid_utf8( wp_unslash( $items[ $key ][ $item_id ] ) ) : $default; } if ( '0' === $item_data['order_item_qty'] ) { diff --git a/includes/wc-formatting-functions.php b/includes/wc-formatting-functions.php index 0d94c0e2a22..0c8d439b70a 100644 --- a/includes/wc-formatting-functions.php +++ b/includes/wc-formatting-functions.php @@ -377,6 +377,20 @@ function wc_clean( $var ) { } } +/** + * wp_check_invalid_utf8 with recursive array support. + * + * @param string|array $var Data to sanitize. + * @return string|array + */ +function wc_check_invalid_utf8( $var ) { + if ( is_array( $var ) ) { + return array_map( 'wc_check_invalid_utf8', $var ); + } else { + return wp_check_invalid_utf8( $var ); + } +} + /** * Run wc_clean over posted textarea but maintain line breaks. * From 8e714aeffd30f14a7876f0cd9b76bb5702ae0629 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Wed, 10 Oct 2018 08:44:59 -0700 Subject: [PATCH 019/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index 890315200ee..8042bf38962 100644 --- a/readme.txt +++ b/readme.txt @@ -201,6 +201,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Avoid treating HTTP 301 and 302 codes as failures for webhooks. #21491 * Fix - Add address_1 to shipping packages info in WC_Cart:: get_shipping_packages to make it work correctly in address formatting functions. #21493 * Fix - Don't fire two of the same action when saving shipping settings. #21494 +* Fix - Remove double condition for address line 2 in `WC_Countries::get_default_address_fields`. #20629 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 1e8692aeb17fbc88ae283b3da4f715b9bab4fce3 Mon Sep 17 00:00:00 2001 From: Jesper V Nielsen <31649178+jespervnielsen@users.noreply.github.com> Date: Fri, 12 Oct 2018 08:53:46 +0200 Subject: [PATCH 020/361] allow-filtering-on-wiget-get_current_page_url Allow for filtering on get_current_page_url() in widgets, to make it possible to extend the parameteres, and keep them. If building some functionality, where wee work with the parameters in the url, they will be removed, when using the links produced by wc_widget - for example the layered nav, or the price range. With the filter, we kan add out custom parameter, to the url generated by these widgets. --- includes/abstracts/abstract-wc-widget.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/abstracts/abstract-wc-widget.php b/includes/abstracts/abstract-wc-widget.php index 22dd2be276b..075f7e10434 100644 --- a/includes/abstracts/abstract-wc-widget.php +++ b/includes/abstracts/abstract-wc-widget.php @@ -347,7 +347,7 @@ abstract class WC_Widget extends WP_Widget { } } - return $link; + return apply_filters( 'woocommerce_widget_get_current_page_url', $link, $this ) } /** From 8799de84776ddfec6e3b42c00dd98612e8c732ed Mon Sep 17 00:00:00 2001 From: Jesper V Nielsen <31649178+jespervnielsen@users.noreply.github.com> Date: Fri, 12 Oct 2018 09:43:43 +0200 Subject: [PATCH 021/361] fix-missing-colon --- includes/abstracts/abstract-wc-widget.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/abstracts/abstract-wc-widget.php b/includes/abstracts/abstract-wc-widget.php index 075f7e10434..0ffaf4fc76a 100644 --- a/includes/abstracts/abstract-wc-widget.php +++ b/includes/abstracts/abstract-wc-widget.php @@ -347,7 +347,7 @@ abstract class WC_Widget extends WP_Widget { } } - return apply_filters( 'woocommerce_widget_get_current_page_url', $link, $this ) + return apply_filters( 'woocommerce_widget_get_current_page_url', $link, $this ); } /** From ec44a3691374ecd1902561fbed97b4c0dafe8cf4 Mon Sep 17 00:00:00 2001 From: Ron Rennick Date: Fri, 12 Oct 2018 21:49:05 -0300 Subject: [PATCH 022/361] only include erasure tools link in erasure desc_tip when user has manage_privacy_options, escape the desc_tip --- includes/admin/settings/class-wc-settings-accounts.php | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/includes/admin/settings/class-wc-settings-accounts.php b/includes/admin/settings/class-wc-settings-accounts.php index cd52a60cbd2..2cc0861ba15 100644 --- a/includes/admin/settings/class-wc-settings-accounts.php +++ b/includes/admin/settings/class-wc-settings-accounts.php @@ -31,6 +31,11 @@ class WC_Settings_Accounts extends WC_Settings_Page { * @return array */ public function get_settings() { + $erasure_text = esc_html( 'account erasure request', 'woocommerce' ); + if ( current_user_can( 'manage_privacy_options' ) ) { + $erasure_text = sprintf( '%s', esc_url( admin_url( 'tools.php?page=remove_personal_data' ) ), $erasure_text ); + } + $settings = apply_filters( 'woocommerce_' . $this->id . '_settings', array( array( @@ -93,7 +98,7 @@ class WC_Settings_Accounts extends WC_Settings_Page { 'title' => __( 'Account erasure requests', 'woocommerce' ), 'desc' => __( 'Remove personal data from orders', 'woocommerce' ), /* Translators: %s URL to erasure request screen. */ - 'desc_tip' => sprintf( __( 'When handling an account erasure request, should personal data within orders be retained or removed?', 'woocommerce' ), esc_url( admin_url( 'tools.php?page=remove_personal_data' ) ) ), + 'desc_tip' => sprintf( esc_html__( 'When handling an %s, should personal data within orders be retained or removed?', 'woocommerce' ), $erasure_text ), 'id' => 'woocommerce_erasure_request_removes_order_data', 'type' => 'checkbox', 'default' => 'no', @@ -103,7 +108,7 @@ class WC_Settings_Accounts extends WC_Settings_Page { array( 'desc' => __( 'Remove access to downloads', 'woocommerce' ), /* Translators: %s URL to erasure request screen. */ - 'desc_tip' => sprintf( __( 'When handling an account erasure request, should access to downloadable files be revoked and download logs cleared?', 'woocommerce' ), esc_url( admin_url( 'tools.php?page=remove_personal_data' ) ) ), + 'desc_tip' => sprintf( esc_html__( 'When handling an %s, should access to downloadable files be revoked and download logs cleared?', 'woocommerce' ), $erasure_text ), 'id' => 'woocommerce_erasure_request_removes_download_data', 'type' => 'checkbox', 'default' => 'no', From 0590522180066f2b449506f73ff4a3865735babb Mon Sep 17 00:00:00 2001 From: Mohammad Jangda Date: Sat, 13 Oct 2018 01:27:45 -0400 Subject: [PATCH 023/361] Use wp_get_upload_dir for geolite DB path By default, `wp_upload_dir` will "will create a subfolder in your Uploads folder corresponding to the queried month (or current month, if no $time argument is provided" (https://developer.wordpress.org/reference/functions/wp_upload_dir/). This is not necessary in our case since all we want is the `basedir` value. We're switching to `wp_get_upload_dir`, which is a wrapper for `wp_upload_dir` that turns of the folder create behaviour. --- includes/class-wc-geolocation.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/class-wc-geolocation.php b/includes/class-wc-geolocation.php index 8eea8edaa53..8c85b7e8eab 100644 --- a/includes/class-wc-geolocation.php +++ b/includes/class-wc-geolocation.php @@ -237,7 +237,7 @@ class WC_Geolocation { * @return string */ public static function get_local_database_path( $deprecated = '2' ) { - $upload_dir = wp_upload_dir(); + $upload_dir = wp_get_upload_dir(); return apply_filters( 'woocommerce_geolocation_local_database_path', $upload_dir['basedir'] . '/GeoLite2-Country.mmdb', $deprecated ); } From 4557108805ca2140ebdf86f91eddc4858c4ff2f5 Mon Sep 17 00:00:00 2001 From: Jared Burke Date: Mon, 15 Oct 2018 01:26:45 -0500 Subject: [PATCH 024/361] Fix some memory limit values not correctly converting to bytes --- includes/abstracts/class-wc-background-process.php | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/includes/abstracts/class-wc-background-process.php b/includes/abstracts/class-wc-background-process.php index 0de4abe6ba7..6d9662208fc 100644 --- a/includes/abstracts/class-wc-background-process.php +++ b/includes/abstracts/class-wc-background-process.php @@ -146,10 +146,10 @@ abstract class WC_Background_Process extends WP_Background_Process { if ( ! $memory_limit || -1 === intval( $memory_limit ) ) { // Unlimited, set to 32GB. - $memory_limit = '32000M'; + $memory_limit = '32G'; } - return intval( $memory_limit ) * 1024 * 1024; + return wp_convert_hr_to_bytes( $memory_limit ); } /** From 48de1f6b97b887a1636da2c28a0e01dc1504b38f Mon Sep 17 00:00:00 2001 From: Gerhard Date: Mon, 15 Oct 2018 12:49:56 +0200 Subject: [PATCH 025/361] Accommodate numeric slugs in the product shortcode attribute and category fields. --- .../class-wc-shortcode-products.php | 31 +++++++++++++++++-- 1 file changed, 28 insertions(+), 3 deletions(-) diff --git a/includes/shortcodes/class-wc-shortcode-products.php b/includes/shortcodes/class-wc-shortcode-products.php index 72de10afaaa..ac75ff82a7b 100644 --- a/includes/shortcodes/class-wc-shortcode-products.php +++ b/includes/shortcodes/class-wc-shortcode-products.php @@ -288,7 +288,13 @@ class WC_Shortcode_Products { if ( $terms && is_numeric( $terms[0] ) ) { $terms = array_map( 'absint', $terms ); - $field = 'term_id'; + $query_args['tax_query']['relation'] = 'OR'; + $query_args['tax_query'][] = array( + 'taxonomy' => $taxonomy, + 'terms' => $terms, + 'field' => 'term_id', + 'operator' => $this->attributes['terms_operator'], + ); } // If no terms were specified get all products that are in the attribute taxonomy. @@ -299,9 +305,15 @@ class WC_Shortcode_Products { 'fields' => 'ids', ) ); - $field = 'term_id'; + $query_args['tax_query'][] = array( + 'taxonomy' => $taxonomy, + 'terms' => $terms, + 'field' => 'term_id', + 'operator' => $this->attributes['terms_operator'], + ); } + // We always need to search based on the slug as well, this is to accommodate numeric slugs. $query_args['tax_query'][] = array( 'taxonomy' => $taxonomy, 'terms' => $terms, @@ -324,9 +336,22 @@ class WC_Shortcode_Products { if ( is_numeric( $categories[0] ) ) { $categories = array_map( 'absint', $categories ); - $field = 'term_id'; + $query_args['tax_query']['relation'] = 'OR'; + $query_args['tax_query'][] = array( + 'taxonomy' => 'product_cat', + 'terms' => $categories, + 'field' => 'term_id', + 'operator' => $this->attributes['cat_operator'], + + /* + * When cat_operator is AND, the children categories should be excluded, + * as only products belonging to all the children categories would be selected. + */ + 'include_children' => 'AND' === $this->attributes['cat_operator'] ? false : true, + ); } + // We always need to search based on the slug as well, this is to accommodate numeric slugs. $query_args['tax_query'][] = array( 'taxonomy' => 'product_cat', 'terms' => $categories, From aa6a6f2b105203ea07158004c067cf3607903b26 Mon Sep 17 00:00:00 2001 From: Gerhard Date: Mon, 15 Oct 2018 13:22:12 +0200 Subject: [PATCH 026/361] Refine numeric slug checking when using the products shortcode for attributes and categories. --- .../class-wc-shortcode-products.php | 44 +++++++------------ 1 file changed, 17 insertions(+), 27 deletions(-) diff --git a/includes/shortcodes/class-wc-shortcode-products.php b/includes/shortcodes/class-wc-shortcode-products.php index ac75ff82a7b..b4545504a45 100644 --- a/includes/shortcodes/class-wc-shortcode-products.php +++ b/includes/shortcodes/class-wc-shortcode-products.php @@ -287,14 +287,15 @@ class WC_Shortcode_Products { $field = 'slug'; if ( $terms && is_numeric( $terms[0] ) ) { + $field = 'term_id'; $terms = array_map( 'absint', $terms ); - $query_args['tax_query']['relation'] = 'OR'; - $query_args['tax_query'][] = array( - 'taxonomy' => $taxonomy, - 'terms' => $terms, - 'field' => 'term_id', - 'operator' => $this->attributes['terms_operator'], - ); + // Check numeric slugs. + foreach ( $terms as $term ) { + $the_term = get_term_by( 'slug', $term, $taxonomy ); + if ( false !== $the_term ) { + $terms[] = $the_term->term_id; + } + } } // If no terms were specified get all products that are in the attribute taxonomy. @@ -305,12 +306,7 @@ class WC_Shortcode_Products { 'fields' => 'ids', ) ); - $query_args['tax_query'][] = array( - 'taxonomy' => $taxonomy, - 'terms' => $terms, - 'field' => 'term_id', - 'operator' => $this->attributes['terms_operator'], - ); + $field = 'term_id'; } // We always need to search based on the slug as well, this is to accommodate numeric slugs. @@ -335,23 +331,17 @@ class WC_Shortcode_Products { $field = 'slug'; if ( is_numeric( $categories[0] ) ) { + $field = 'term_id'; $categories = array_map( 'absint', $categories ); - $query_args['tax_query']['relation'] = 'OR'; - $query_args['tax_query'][] = array( - 'taxonomy' => 'product_cat', - 'terms' => $categories, - 'field' => 'term_id', - 'operator' => $this->attributes['cat_operator'], - - /* - * When cat_operator is AND, the children categories should be excluded, - * as only products belonging to all the children categories would be selected. - */ - 'include_children' => 'AND' === $this->attributes['cat_operator'] ? false : true, - ); + // Check numeric slugs. + foreach ( $categories as $cat ) { + $the_cat = get_term_by( 'slug', $cat, 'product_cat' ); + if ( false !== $the_cat ) { + $categories[] = $the_cat->term_id; + } + } } - // We always need to search based on the slug as well, this is to accommodate numeric slugs. $query_args['tax_query'][] = array( 'taxonomy' => 'product_cat', 'terms' => $categories, From d3e59b770b87d13c412effa32aa10cf49e219da5 Mon Sep 17 00:00:00 2001 From: Gerhard Date: Mon, 15 Oct 2018 14:07:48 +0200 Subject: [PATCH 027/361] Do not try and create primary key using upgrade routine, dbdelta does that automatically. Just drop the key if it exists and add a new unique key. --- includes/wc-update-functions.php | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/includes/wc-update-functions.php b/includes/wc-update-functions.php index ff086d5eafc..c5482176130 100644 --- a/includes/wc-update-functions.php +++ b/includes/wc-update-functions.php @@ -1999,9 +1999,20 @@ function wc_update_350_reviews_comment_type() { function wc_update_350_change_woocommerce_sessions_schema() { global $wpdb; - $wpdb->query( - "ALTER TABLE `{$wpdb->prefix}woocommerce_sessions` DROP PRIMARY KEY, DROP KEY `session_id`, ADD PRIMARY KEY(`session_id`), ADD UNIQUE KEY(`session_key`)" - ); + $results = $wpdb->get_results( " + SELECT CONSTRAINT_NAME + FROM information_schema.TABLE_CONSTRAINTS + WHERE CONSTRAINT_SCHEMA = '{$wpdb->dbname}' + AND CONSTRAINT_TYPE = 'UNIQUE' + AND CONSTRAINT_NAME = 'session_id' + AND TABLE_NAME = '{$wpdb->prefix}woocommerce_sessions' + " ); + + if ( $results ) { + $wpdb->query( + "ALTER TABLE `{$wpdb->prefix}woocommerce_sessions` DROP KEY `session_id`, ADD UNIQUE KEY(`session_key`)" + ); + } } /** From a41df43cb02428dcdb0aafae6a07fa36b3a23a60 Mon Sep 17 00:00:00 2001 From: Gerhard Date: Mon, 15 Oct 2018 14:13:21 +0200 Subject: [PATCH 028/361] Do check on new key field instead and only run alter when not found. --- includes/wc-update-functions.php | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/includes/wc-update-functions.php b/includes/wc-update-functions.php index c5482176130..12805542581 100644 --- a/includes/wc-update-functions.php +++ b/includes/wc-update-functions.php @@ -2004,11 +2004,11 @@ function wc_update_350_change_woocommerce_sessions_schema() { FROM information_schema.TABLE_CONSTRAINTS WHERE CONSTRAINT_SCHEMA = '{$wpdb->dbname}' AND CONSTRAINT_TYPE = 'UNIQUE' - AND CONSTRAINT_NAME = 'session_id' + AND CONSTRAINT_NAME = 'session_key' AND TABLE_NAME = '{$wpdb->prefix}woocommerce_sessions' " ); - if ( $results ) { + if ( ! $results ) { $wpdb->query( "ALTER TABLE `{$wpdb->prefix}woocommerce_sessions` DROP KEY `session_id`, ADD UNIQUE KEY(`session_key`)" ); From 212975c9419bfeb7626bca6b5caf72fd29c0981f Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Mon, 15 Oct 2018 09:41:54 -0300 Subject: [PATCH 029/361] 3.4.6 changelog --- CHANGELOG.txt | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/CHANGELOG.txt b/CHANGELOG.txt index b319f72b4d7..888f3534859 100644 --- a/CHANGELOG.txt +++ b/CHANGELOG.txt @@ -1,5 +1,10 @@ == Changelog == += 3.4.6 - 2018-10-11 = +* Fix - Security issues +* Fix - Allow percent coupons with sale restrictions to apply to carts with sale items in them. #21241 +* Fix - Prevent multiple slashing of variation's SKU. #21019 + = 3.4.5 - 2018-08-29 = * Fix - Tweak sanitization when resetting password cookie. #20901 * Fix - Use `+` instead of `array_merge` when appending parent to tax class to fix issues with numeric tax class names. #20916 From 3e7cf4be218cf4e366dbe3b3c3c0e7fd79d0b367 Mon Sep 17 00:00:00 2001 From: Alex Kirk Date: Mon, 15 Oct 2018 15:54:19 +0200 Subject: [PATCH 030/361] Fix typo revivew --- includes/api/class-wc-rest-product-reviews-controller.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/api/class-wc-rest-product-reviews-controller.php b/includes/api/class-wc-rest-product-reviews-controller.php index 0a66603e693..fd7ae85d3c8 100644 --- a/includes/api/class-wc-rest-product-reviews-controller.php +++ b/includes/api/class-wc-rest-product-reviews-controller.php @@ -554,7 +554,7 @@ class WC_REST_Product_Reviews_Controller extends WC_REST_Controller { } if ( isset( $prepared_args['comment_content'] ) && empty( $prepared_args['comment_content'] ) ) { - return new WP_Error( 'woocommerce_rest_review_content_invalid', __( 'Invalid revivew content.', 'woocommerce' ), array( 'status' => 400 ) ); + return new WP_Error( 'woocommerce_rest_review_content_invalid', __( 'Invalid review content.', 'woocommerce' ), array( 'status' => 400 ) ); } $prepared_args['comment_ID'] = $id; From dfbe5174eff64d1ce49a7e3601f2bd1d2a9dbc13 Mon Sep 17 00:00:00 2001 From: Jory Hogeveen Date: Mon, 15 Oct 2018 16:48:16 +0200 Subject: [PATCH 031/361] Stop using `current_user_can` for validation roles. Fixes #21568 --- includes/wc-user-functions.php | 35 ++++++++++++++++++++++++++++++---- 1 file changed, 31 insertions(+), 4 deletions(-) diff --git a/includes/wc-user-functions.php b/includes/wc-user-functions.php index b7b7a59926d..3d14a4649fc 100644 --- a/includes/wc-user-functions.php +++ b/includes/wc-user-functions.php @@ -276,6 +276,33 @@ function wc_customer_bought_product( $customer_email, $user_id, $product_id ) { return in_array( absint( $product_id ), $result, true ); } +/** + * Checks if the current user has a role. + * + * @param string $role The role. + * @return bool + */ +function wc_current_user_has_role( $role ) { + return wc_user_has_role( wp_get_current_user(), $role ); +} + +/** + * Checks if a user has a role. + * + * @param int|\WP_User $user The user. + * @param string $role The role. + * @return bool + */ +function wc_user_has_role( $user, $role ) { + if ( ! is_object( $user ) ) + $user = get_userdata( $user ); + + if ( ! $user || ! $user->exists() ) + return false; + + return in_array( $role, $user->roles, true ); +} + /** * Checks if a user has a certain capability. * @@ -349,11 +376,11 @@ add_filter( 'user_has_cap', 'wc_customer_has_capability', 10, 3 ); * @return array */ function wc_modify_editable_roles( $roles ) { - if ( ! current_user_can( 'administrator' ) ) { + if ( ! wc_current_user_has_role( 'administrator' ) ) { unset( $roles['administrator'] ); } - if ( current_user_can( 'shop_manager' ) ) { + if ( wc_current_user_has_role( 'shop_manager' ) ) { $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); return array_intersect_key( $roles, array_flip( $shop_manager_editable_roles ) ); } @@ -382,12 +409,12 @@ function wc_modify_map_meta_cap( $caps, $cap, $user_id, $args ) { if ( ! isset( $args[0] ) || $args[0] === $user_id ) { break; } else { - if ( user_can( $args[0], 'administrator' ) && ! current_user_can( 'administrator' ) ) { + if ( wc_user_has_role( $args[0], 'administrator' ) && ! wc_current_user_has_role( 'administrator' ) ) { $caps[] = 'do_not_allow'; } // Shop managers can only edit customer info. - if ( current_user_can( 'shop_manager' ) ) { + if ( wc_current_user_has_role( 'shop_manager' ) ) { $userdata = get_userdata( $args[0] ); $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); if ( property_exists( $userdata, 'roles' ) && ! empty( $userdata->roles ) && ! array_intersect( $userdata->roles, $shop_manager_editable_roles ) ) { From b85c142d97f5f743ab539a4a9868223e513d2562 Mon Sep 17 00:00:00 2001 From: Jory Hogeveen Date: Mon, 15 Oct 2018 17:15:53 +0200 Subject: [PATCH 032/361] Stop checking shop_manager role if the user also is an administrator --- includes/wc-user-functions.php | 28 +++++++++++++++------------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/includes/wc-user-functions.php b/includes/wc-user-functions.php index 3d14a4649fc..acb52b1a484 100644 --- a/includes/wc-user-functions.php +++ b/includes/wc-user-functions.php @@ -378,11 +378,11 @@ add_filter( 'user_has_cap', 'wc_customer_has_capability', 10, 3 ); function wc_modify_editable_roles( $roles ) { if ( ! wc_current_user_has_role( 'administrator' ) ) { unset( $roles['administrator'] ); - } - if ( wc_current_user_has_role( 'shop_manager' ) ) { - $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); - return array_intersect_key( $roles, array_flip( $shop_manager_editable_roles ) ); + if ( wc_current_user_has_role( 'shop_manager' ) ) { + $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); + return array_intersect_key( $roles, array_flip( $shop_manager_editable_roles ) ); + } } return $roles; @@ -409,17 +409,19 @@ function wc_modify_map_meta_cap( $caps, $cap, $user_id, $args ) { if ( ! isset( $args[0] ) || $args[0] === $user_id ) { break; } else { - if ( wc_user_has_role( $args[0], 'administrator' ) && ! wc_current_user_has_role( 'administrator' ) ) { - $caps[] = 'do_not_allow'; - } - - // Shop managers can only edit customer info. - if ( wc_current_user_has_role( 'shop_manager' ) ) { - $userdata = get_userdata( $args[0] ); - $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); - if ( property_exists( $userdata, 'roles' ) && ! empty( $userdata->roles ) && ! array_intersect( $userdata->roles, $shop_manager_editable_roles ) ) { + if ( ! wc_current_user_has_role( 'administrator' ) ) { + if ( wc_user_has_role( $args[0], 'administrator' ) ) { $caps[] = 'do_not_allow'; } + + // Shop managers can only edit customer info. + if ( wc_current_user_has_role( 'shop_manager' ) ) { + $userdata = get_userdata( $args[0] ); + $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); + if ( property_exists( $userdata, 'roles' ) && ! empty( $userdata->roles ) && ! array_intersect( $userdata->roles, $shop_manager_editable_roles ) ) { + $caps[] = 'do_not_allow'; + } + } } } break; From 2854f8654b3bf050b001f3e872e3c497829c0c95 Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Mon, 15 Oct 2018 12:20:31 -0300 Subject: [PATCH 033/361] Add two unit tests for wc_dropdown_variation_attribute_options() Those two tests covers only the basic functionality of this function. --- tests/unit-tests/templates/functions.php | 35 ++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/tests/unit-tests/templates/functions.php b/tests/unit-tests/templates/functions.php index 359d4213384..465f571e7b4 100644 --- a/tests/unit-tests/templates/functions.php +++ b/tests/unit-tests/templates/functions.php @@ -65,4 +65,39 @@ class WC_Tests_Template_Functions extends WC_Unit_Test_Case { $product->delete( true ); wp_delete_term( $category['term_id'], 'product_cat' ); } + + public function test_wc_dropdown_variation_attribute_options_no_attributes() { + $this->expectOutputString( '' ); + + wc_dropdown_variation_attribute_options(); + } + + public function test_wc_dropdown_variation_attribute_options_should_return_attributes_list() { + $product = WC_Helper_Product::create_variation_product(); + + $this->expectOutputString( '' ); + + wc_dropdown_variation_attribute_options( + array( + 'product' => $product, + 'attribute' => 'pa_size', + ) + ); + } + + public function test_wc_dropdown_variation_attribute_options_should_return_attributes_list_and_selected_element() { + $product = WC_Helper_Product::create_variation_product(); + $_REQUEST['attribute_pa_size'] = 'large'; + + $this->expectOutputString( '' ); + + wc_dropdown_variation_attribute_options( + array( + 'product' => $product, + 'attribute' => 'pa_size', + ) + ); + + unset( $_REQUEST['attribute_pa_size'] ); + } } From e5f934d0a9b79bbbac0ad142fcfcad89324e9d01 Mon Sep 17 00:00:00 2001 From: Jory Hogeveen Date: Mon, 15 Oct 2018 17:21:04 +0200 Subject: [PATCH 034/361] Codestyle --- includes/wc-user-functions.php | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/includes/wc-user-functions.php b/includes/wc-user-functions.php index acb52b1a484..7da8899e5ca 100644 --- a/includes/wc-user-functions.php +++ b/includes/wc-user-functions.php @@ -279,7 +279,7 @@ function wc_customer_bought_product( $customer_email, $user_id, $product_id ) { /** * Checks if the current user has a role. * - * @param string $role The role. + * @param string $role The role. * @return bool */ function wc_current_user_has_role( $role ) { @@ -294,13 +294,15 @@ function wc_current_user_has_role( $role ) { * @return bool */ function wc_user_has_role( $user, $role ) { - if ( ! is_object( $user ) ) - $user = get_userdata( $user ); + if ( ! is_object( $user ) ) { + $user = get_userdata( $user ); + } - if ( ! $user || ! $user->exists() ) - return false; + if ( ! $user || ! $user->exists() ) { + return false; + } - return in_array( $role, $user->roles, true ); + return in_array( $role, $user->roles, true ); } /** From f53b696ddfd2182f1551a25fc5a9bf79826b8bf7 Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Mon, 15 Oct 2018 12:23:07 -0300 Subject: [PATCH 035/361] Remove unnecessary call to urldecode() This commit removes an unnecessary call to urldecode() as the superglobal $_REQUEST is already decoded by PHP (see http://php.net/urldecode). Calling urldecode() on a previously decoded value was causing the issue described in #21542. --- includes/wc-template-functions.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/wc-template-functions.php b/includes/wc-template-functions.php index f74a8f7c129..52271c6f287 100644 --- a/includes/wc-template-functions.php +++ b/includes/wc-template-functions.php @@ -2776,7 +2776,7 @@ if ( ! function_exists( 'wc_dropdown_variation_attribute_options' ) ) { // Get selected value. if ( false === $args['selected'] && $args['attribute'] && $args['product'] instanceof WC_Product ) { $selected_key = 'attribute_' . sanitize_title( $args['attribute'] ); - $args['selected'] = isset( $_REQUEST[ $selected_key ] ) ? wc_clean( urldecode( wp_unslash( $_REQUEST[ $selected_key ] ) ) ) : $args['product']->get_variation_default_attribute( $args['attribute'] ); // WPCS: input var ok, CSRF ok, sanitization ok. + $args['selected'] = isset( $_REQUEST[ $selected_key ] ) ? wc_clean( wp_unslash( $_REQUEST[ $selected_key ] ) ) : $args['product']->get_variation_default_attribute( $args['attribute'] ); // WPCS: input var ok, CSRF ok, sanitization ok. } $options = $args['options']; From 54036f8f382d249191d3a1f8b2b50c1e08b7930b Mon Sep 17 00:00:00 2001 From: Jory Hogeveen Date: Mon, 15 Oct 2018 17:38:13 +0200 Subject: [PATCH 036/361] Codestyle --- includes/wc-user-functions.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/wc-user-functions.php b/includes/wc-user-functions.php index 7da8899e5ca..cac7fd3a005 100644 --- a/includes/wc-user-functions.php +++ b/includes/wc-user-functions.php @@ -297,7 +297,7 @@ function wc_user_has_role( $user, $role ) { if ( ! is_object( $user ) ) { $user = get_userdata( $user ); } - + if ( ! $user || ! $user->exists() ) { return false; } From 1472af6aa74b6957db4ea11c67cc307998a39ba3 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Mon, 15 Oct 2018 09:15:42 -0700 Subject: [PATCH 037/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index 8042bf38962..726f6269451 100644 --- a/readme.txt +++ b/readme.txt @@ -233,6 +233,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Tweak - Remove 'order_again' query string to avoid multiple re-orders. #21444 * Tweak - Remove Netherlands Antilles from the North America continent definitions. #21449 * Tweak - Display label and meta on the same line in order emails to match frontend Order Details styling. #21456 +* Tweak - Use wp_get_upload_dir for geolite DB path. #21550 * Performance/Tweak - Use post_author for the order customer instead of '_customer_user' meta data. #17895 * Performance - Exclude frontend include from REST API calls. #20000 * Performance - Improve performance of the query to delete version transients by removing unneeded "ORDER BY". #21274 From 3e9b798ea8d3dc1959a6012f4689ebd126c3f0f7 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Mon, 15 Oct 2018 09:17:07 -0700 Subject: [PATCH 038/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index 726f6269451..4a75a402864 100644 --- a/readme.txt +++ b/readme.txt @@ -202,6 +202,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Add address_1 to shipping packages info in WC_Cart:: get_shipping_packages to make it work correctly in address formatting functions. #21493 * Fix - Don't fire two of the same action when saving shipping settings. #21494 * Fix - Remove double condition for address line 2 in `WC_Countries::get_default_address_fields`. #20629 +* Fix - Correctly handle shorthand values for memory_limit in php.ini. #21557 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 09f8012138e63aecaf73665b417735d665c413ca Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Mon, 15 Oct 2018 09:42:57 -0700 Subject: [PATCH 039/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index 4a75a402864..bdb86c2b7be 100644 --- a/readme.txt +++ b/readme.txt @@ -203,6 +203,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Don't fire two of the same action when saving shipping settings. #21494 * Fix - Remove double condition for address line 2 in `WC_Countries::get_default_address_fields`. #20629 * Fix - Correctly handle shorthand values for memory_limit in php.ini. #21557 +* Fix - Product shortcode numeric term slug matching. #21560 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From e2fb9cb9af902ea301b2db4a70670d9d2f551330 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Mon, 15 Oct 2018 09:51:50 -0700 Subject: [PATCH 040/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index bdb86c2b7be..e3f080f1f81 100644 --- a/readme.txt +++ b/readme.txt @@ -204,6 +204,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Remove double condition for address line 2 in `WC_Countries::get_default_address_fields`. #20629 * Fix - Correctly handle shorthand values for memory_limit in php.ini. #21557 * Fix - Product shortcode numeric term slug matching. #21560 +* Fix - Remove the erasure tools links from the descriptions of the erasure settings for users without the manage_privacy_options capability. #21565 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 1d216bf4f29a0dcc3c3704a97074514662a52cb5 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Mon, 15 Oct 2018 10:02:39 -0700 Subject: [PATCH 041/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index e3f080f1f81..d85e764990e 100644 --- a/readme.txt +++ b/readme.txt @@ -205,6 +205,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Correctly handle shorthand values for memory_limit in php.ini. #21557 * Fix - Product shortcode numeric term slug matching. #21560 * Fix - Remove the erasure tools links from the descriptions of the erasure settings for users without the manage_privacy_options capability. #21565 +* Fix - Don't double urldecode posted variation attributes. #21570 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From e5c0122c7f1c166c33e956044736022ca4c71dd0 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Mon, 15 Oct 2018 10:22:02 -0700 Subject: [PATCH 042/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index d85e764990e..3e7301dd1b5 100644 --- a/readme.txt +++ b/readme.txt @@ -206,6 +206,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Product shortcode numeric term slug matching. #21560 * Fix - Remove the erasure tools links from the descriptions of the erasure settings for users without the manage_privacy_options capability. #21565 * Fix - Don't double urldecode posted variation attributes. #21570 +* Fix - New helper functions wc_user_has_role and wc_current_user_has_role to correctly check user roles. #21569 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From ccdf6d02530f5f18b968542d21de36d8a2a2b899 Mon Sep 17 00:00:00 2001 From: claudiulodro Date: Mon, 15 Oct 2018 13:50:34 -0700 Subject: [PATCH 043/361] Simplified path check for CSV importer to cause less issues --- ...ass-wc-product-csv-importer-controller.php | 2 +- tests/unit-tests/importer/product.php | 20 +++++++++---------- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/includes/admin/importers/class-wc-product-csv-importer-controller.php b/includes/admin/importers/class-wc-product-csv-importer-controller.php index affa25fcaa0..30535224c7b 100644 --- a/includes/admin/importers/class-wc-product-csv-importer-controller.php +++ b/includes/admin/importers/class-wc-product-csv-importer-controller.php @@ -91,7 +91,7 @@ class WC_Product_CSV_Importer_Controller { * @return bool */ public static function is_file_valid_csv( $file, $check_path = true ) { - if ( $check_path && apply_filters( 'woocommerce_product_csv_importer_check_import_file_path', true ) && 0 !== stripos( $file, ABSPATH ) ) { + if ( $check_path && apply_filters( 'woocommerce_product_csv_importer_check_import_file_path', true ) && false !== stripos( $file, '://' ) ) { return false; } diff --git a/tests/unit-tests/importer/product.php b/tests/unit-tests/importer/product.php index f039988646a..fef5b832533 100644 --- a/tests/unit-tests/importer/product.php +++ b/tests/unit-tests/importer/product.php @@ -27,16 +27,6 @@ class WC_Tests_Product_CSV_Importer extends WC_Unit_Test_Case { $bootstrap = WC_Unit_Tests_Bootstrap::instance(); require_once $bootstrap->plugin_dir . '/includes/import/class-wc-product-csv-importer.php'; require_once $bootstrap->plugin_dir . '/includes/admin/importers/class-wc-product-csv-importer-controller.php'; - - add_filter( 'woocommerce_product_csv_importer_check_import_file_path', '__return_false' ); - } - - /** - * Remove filters. - */ - public function tearDown() { - parent::tearDown(); - remove_filter( 'woocommerce_product_csv_importer_check_import_file_path', '__return_false' ); } /** @@ -624,4 +614,14 @@ class WC_Tests_Product_CSV_Importer extends WC_Unit_Test_Case { return $mocked_response; } + + /** + * Test WC_Product_CSV_Importer_Controller::is_file_valid_csv. + */ + public function test_is_file_valid_csv() { + $this->assertTrue( WC_Product_CSV_Importer_Controller::is_file_valid_csv( 'C:/wamp64/www/test.local/wp-content/uploads/2018/10/products_all_gg-1.csv' ) ); + $this->assertTrue( WC_Product_CSV_Importer_Controller::is_file_valid_csv( '/srv/www/woodev/wp-content/uploads/2018/10/1098488_single.csv' ) ); + $this->assertFalse( WC_Product_CSV_Importer_Controller::is_file_valid_csv( '/srv/www/woodev/wp-content/uploads/2018/10/img.jpg' ) ); + $this->assertFalse( WC_Product_CSV_Importer_Controller::is_file_valid_csv( 'file:///srv/www/woodev/wp-content/uploads/2018/10/1098488_single.csv' ) ); + } } From 59e6aad01528c28b3d2b583fa514dba27e12527a Mon Sep 17 00:00:00 2001 From: claudiulodro Date: Mon, 15 Oct 2018 14:11:34 -0700 Subject: [PATCH 044/361] Dont kses cart images --- templates/cart/cart.php | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/templates/cart/cart.php b/templates/cart/cart.php index 9840fbf9d41..8a9c11f6139 100644 --- a/templates/cart/cart.php +++ b/templates/cart/cart.php @@ -64,9 +64,9 @@ do_action( 'woocommerce_before_cart' ); ?> $thumbnail = apply_filters( 'woocommerce_cart_item_thumbnail', $_product->get_image(), $cart_item, $cart_item_key ); if ( ! $product_permalink ) { - echo wp_kses_post( $thumbnail ); + echo $thumbnail; // PHPCS: XSS ok. } else { - printf( '%s', esc_url( $product_permalink ), wp_kses_post( $thumbnail ) ); + printf( '%s', esc_url( $product_permalink ), $thumbnail ); // PHPCS: XSS ok. } ?> From 00e942d0b7893f7d95e1c8feb6a7e6cc60f2767d Mon Sep 17 00:00:00 2001 From: Jory Hogeveen Date: Mon, 15 Oct 2018 23:52:47 +0200 Subject: [PATCH 045/361] Check super admin status before mapping caps --- includes/wc-user-functions.php | 3 +++ 1 file changed, 3 insertions(+) diff --git a/includes/wc-user-functions.php b/includes/wc-user-functions.php index cac7fd3a005..0f8c009ab1d 100644 --- a/includes/wc-user-functions.php +++ b/includes/wc-user-functions.php @@ -403,6 +403,9 @@ add_filter( 'editable_roles', 'wc_modify_editable_roles' ); * @return array */ function wc_modify_map_meta_cap( $caps, $cap, $user_id, $args ) { + if ( is_multisite() && is_super_admin() ) { + return $caps; + } switch ( $cap ) { case 'edit_user': case 'remove_user': From 991ae6e7f284dd0b3dfa427d5e06bd00f74f243b Mon Sep 17 00:00:00 2001 From: Jory Hogeveen Date: Mon, 15 Oct 2018 23:53:29 +0200 Subject: [PATCH 046/361] Check super admin status before modifying editable roles --- includes/wc-user-functions.php | 3 +++ 1 file changed, 3 insertions(+) diff --git a/includes/wc-user-functions.php b/includes/wc-user-functions.php index 0f8c009ab1d..f75d3f9138e 100644 --- a/includes/wc-user-functions.php +++ b/includes/wc-user-functions.php @@ -378,6 +378,9 @@ add_filter( 'user_has_cap', 'wc_customer_has_capability', 10, 3 ); * @return array */ function wc_modify_editable_roles( $roles ) { + if ( is_multisite() && is_super_admin() ) { + return $roles; + } if ( ! wc_current_user_has_role( 'administrator' ) ) { unset( $roles['administrator'] ); From 7940694ce45696748e188386664b23ab5d8cc11f Mon Sep 17 00:00:00 2001 From: Khan M Rashedun-Naby Date: Tue, 16 Oct 2018 13:25:56 +0600 Subject: [PATCH 047/361] Removed Unnecessary Variable. --- includes/class-wc-ajax.php | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/includes/class-wc-ajax.php b/includes/class-wc-ajax.php index 51500c6c916..a5f6db217e3 100644 --- a/includes/class-wc-ajax.php +++ b/includes/class-wc-ajax.php @@ -1429,9 +1429,8 @@ class WC_AJAX { wp_die( -1 ); } - $term = wc_clean( wp_unslash( $_GET['term'] ) ); - $exclude = array(); - $limit = ''; + $term = wc_clean( wp_unslash( $_GET['term'] ) ); + $limit = ''; if ( empty( $term ) ) { wp_die(); From 439bd54ce56fe56715195a4d0ec14a2ee4eae4e2 Mon Sep 17 00:00:00 2001 From: Khan M Rashedun-Naby Date: Tue, 16 Oct 2018 14:23:43 +0600 Subject: [PATCH 048/361] The variable should be 0 rather than empty string --- includes/class-wc-ajax.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/class-wc-ajax.php b/includes/class-wc-ajax.php index a5f6db217e3..31c50a3e45b 100644 --- a/includes/class-wc-ajax.php +++ b/includes/class-wc-ajax.php @@ -1430,7 +1430,7 @@ class WC_AJAX { } $term = wc_clean( wp_unslash( $_GET['term'] ) ); - $limit = ''; + $limit = 0; if ( empty( $term ) ) { wp_die(); From 481903d91535937f87eb59e86bbb447314626134 Mon Sep 17 00:00:00 2001 From: Jory Hogeveen Date: Tue, 16 Oct 2018 14:11:36 +0200 Subject: [PATCH 049/361] No need to continue parsing for shop manager if target user is an administrator --- includes/wc-user-functions.php | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/includes/wc-user-functions.php b/includes/wc-user-functions.php index f75d3f9138e..4dfc999153c 100644 --- a/includes/wc-user-functions.php +++ b/includes/wc-user-functions.php @@ -420,10 +420,8 @@ function wc_modify_map_meta_cap( $caps, $cap, $user_id, $args ) { if ( ! wc_current_user_has_role( 'administrator' ) ) { if ( wc_user_has_role( $args[0], 'administrator' ) ) { $caps[] = 'do_not_allow'; - } - - // Shop managers can only edit customer info. - if ( wc_current_user_has_role( 'shop_manager' ) ) { + } elseif ( wc_current_user_has_role( 'shop_manager' ) ) { + // Shop managers can only edit customer info. $userdata = get_userdata( $args[0] ); $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); if ( property_exists( $userdata, 'roles' ) && ! empty( $userdata->roles ) && ! array_intersect( $userdata->roles, $shop_manager_editable_roles ) ) { From fcf4e56d0d7e399709ae558f25555bdb30de9bbe Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Tue, 16 Oct 2018 10:22:29 -0300 Subject: [PATCH 050/361] Add upcoming PHP 7.3 to the list of versions tested in Travis --- .travis.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.travis.yml b/.travis.yml index 38f5033cad8..7e0111b91dd 100644 --- a/.travis.yml +++ b/.travis.yml @@ -13,6 +13,7 @@ php: - 5.6 - 7.0 - 7.1 + - 7.3 env: - WP_VERSION=latest WP_MULTISITE=0 @@ -32,6 +33,7 @@ matrix: env: WP_VERSION=latest WP_MULTISITE=0 RUN_CODE_COVERAGE=1 allow_failures: - env: WP_VERSION=latest WP_MULTISITE=0 RUN_CODE_COVERAGE=1 + - php: 7.3 before_script: - phpenv config-rm xdebug.ini From 9fac8cc8ad7e05332d888bac118884128d9f46be Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Tue, 16 Oct 2018 10:36:25 -0300 Subject: [PATCH 051/361] Remove xdebug.ini only if it exists This commit adds an if to check if xdebug.ini exists before trying to remove it. Doing this to avoid a build error in PHP versions where the file doesn't exist like PHP 7.3. --- .travis.yml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/.travis.yml b/.travis.yml index 7e0111b91dd..4811f23967f 100644 --- a/.travis.yml +++ b/.travis.yml @@ -36,7 +36,13 @@ matrix: - php: 7.3 before_script: - - phpenv config-rm xdebug.ini + - | + # Remove Xdebug for a huge performance increase: + if [ -f ~/.phpenv/versions/$(phpenv version-name)/etc/conf.d/xdebug.ini ]; then + phpenv config-rm xdebug.ini + else + echo "xdebug.ini does not exist" + fi - export PATH="$HOME/.composer/vendor/bin:$PATH" - bash tests/bin/install.sh woocommerce_test root '' localhost $WP_VERSION - bash tests/bin/travis.sh before From 00c1a9016a01015880c9c6ddfb2ea9ceddb16c84 Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Tue, 16 Oct 2018 13:01:51 -0300 Subject: [PATCH 052/361] Check if file ID is not empty and exists Closes #21587 --- includes/api/legacy/v2/class-wc-api-products.php | 2 +- includes/api/legacy/v3/class-wc-api-products.php | 2 +- includes/api/v1/class-wc-rest-products-controller.php | 2 +- includes/api/v2/class-wc-rest-products-v2-controller.php | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/includes/api/legacy/v2/class-wc-api-products.php b/includes/api/legacy/v2/class-wc-api-products.php index 0da071ccb15..bfc75184b63 100644 --- a/includes/api/legacy/v2/class-wc-api-products.php +++ b/includes/api/legacy/v2/class-wc-api-products.php @@ -1532,7 +1532,7 @@ class WC_API_Products extends WC_API_Resource { } $download = new WC_Product_Download(); - $download->set_id( $file['id'] ? $file['id'] : wp_generate_uuid4() ); + $download->set_id( ! empty( $file['id'] ) ? $file['id'] : wp_generate_uuid4() ); $download->set_name( $file['name'] ? $file['name'] : wc_get_filename_from_url( $file['file'] ) ); $download->set_file( apply_filters( 'woocommerce_file_download_path', $file['file'], $product, $key ) ); $files[] = $download; diff --git a/includes/api/legacy/v3/class-wc-api-products.php b/includes/api/legacy/v3/class-wc-api-products.php index 71062b2820d..d8d02d0df1d 100644 --- a/includes/api/legacy/v3/class-wc-api-products.php +++ b/includes/api/legacy/v3/class-wc-api-products.php @@ -2036,7 +2036,7 @@ class WC_API_Products extends WC_API_Resource { } $download = new WC_Product_Download(); - $download->set_id( $file['id'] ? $file['id'] : wp_generate_uuid4() ); + $download->set_id( ! empty( $file['id'] ) ? $file['id'] : wp_generate_uuid4() ); $download->set_name( $file['name'] ? $file['name'] : wc_get_filename_from_url( $file['file'] ) ); $download->set_file( apply_filters( 'woocommerce_file_download_path', $file['file'], $product, $key ) ); $files[] = $download; diff --git a/includes/api/v1/class-wc-rest-products-controller.php b/includes/api/v1/class-wc-rest-products-controller.php index 9d893f039c8..89bec84e489 100644 --- a/includes/api/v1/class-wc-rest-products-controller.php +++ b/includes/api/v1/class-wc-rest-products-controller.php @@ -960,7 +960,7 @@ class WC_REST_Products_V1_Controller extends WC_REST_Posts_Controller { } $download = new WC_Product_Download(); - $download->set_id( $file['id'] ? $file['id'] : wp_generate_uuid4() ); + $download->set_id( ! empty( $file['id'] ) ? $file['id'] : wp_generate_uuid4() ); $download->set_name( $file['name'] ? $file['name'] : wc_get_filename_from_url( $file['file'] ) ); $download->set_file( apply_filters( 'woocommerce_file_download_path', $file['file'], $product, $key ) ); $files[] = $download; diff --git a/includes/api/v2/class-wc-rest-products-v2-controller.php b/includes/api/v2/class-wc-rest-products-v2-controller.php index 1ed1c1e0acc..60b86a36b9a 100644 --- a/includes/api/v2/class-wc-rest-products-v2-controller.php +++ b/includes/api/v2/class-wc-rest-products-v2-controller.php @@ -1196,7 +1196,7 @@ class WC_REST_Products_V2_Controller extends WC_REST_Legacy_Products_Controller } $download = new WC_Product_Download(); - $download->set_id( $file['id'] ? $file['id'] : wp_generate_uuid4() ); + $download->set_id( ! empty( $file['id'] ) ? $file['id'] : wp_generate_uuid4() ); $download->set_name( $file['name'] ? $file['name'] : wc_get_filename_from_url( $file['file'] ) ); $download->set_file( apply_filters( 'woocommerce_file_download_path', $file['file'], $product, $key ) ); $files[] = $download; From 63390c181de4046f36898b5e6c9e4dc4f157f3c2 Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Tue, 16 Oct 2018 13:19:41 -0300 Subject: [PATCH 053/361] [REST API] Fixed schema for product's downloads Download ID are generated with wp_generate_uuid4() for while now. Also we allow users to manipulate it. --- .../api/class-wc-rest-product-variations-controller.php | 3 +-- includes/api/class-wc-rest-products-controller.php | 3 +-- includes/api/v1/class-wc-rest-products-controller.php | 6 ++---- .../v2/class-wc-rest-product-variations-v2-controller.php | 3 +-- includes/api/v2/class-wc-rest-products-v2-controller.php | 3 +-- 5 files changed, 6 insertions(+), 12 deletions(-) diff --git a/includes/api/class-wc-rest-product-variations-controller.php b/includes/api/class-wc-rest-product-variations-controller.php index b393a567b47..8cb3b101239 100644 --- a/includes/api/class-wc-rest-product-variations-controller.php +++ b/includes/api/class-wc-rest-product-variations-controller.php @@ -514,10 +514,9 @@ class WC_REST_Product_Variations_Controller extends WC_REST_Product_Variations_V 'type' => 'object', 'properties' => array( 'id' => array( - 'description' => __( 'File MD5 hash.', 'woocommerce' ), + 'description' => __( 'File ID.', 'woocommerce' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), - 'readonly' => true, ), 'name' => array( 'description' => __( 'File name.', 'woocommerce' ), diff --git a/includes/api/class-wc-rest-products-controller.php b/includes/api/class-wc-rest-products-controller.php index 1497fcae3f9..6c081c6cf18 100644 --- a/includes/api/class-wc-rest-products-controller.php +++ b/includes/api/class-wc-rest-products-controller.php @@ -862,10 +862,9 @@ class WC_REST_Products_Controller extends WC_REST_Products_V2_Controller { 'type' => 'object', 'properties' => array( 'id' => array( - 'description' => __( 'File MD5 hash.', 'woocommerce' ), + 'description' => __( 'File ID.', 'woocommerce' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), - 'readonly' => true, ), 'name' => array( 'description' => __( 'File name.', 'woocommerce' ), diff --git a/includes/api/v1/class-wc-rest-products-controller.php b/includes/api/v1/class-wc-rest-products-controller.php index 9d893f039c8..7695345d386 100644 --- a/includes/api/v1/class-wc-rest-products-controller.php +++ b/includes/api/v1/class-wc-rest-products-controller.php @@ -1882,10 +1882,9 @@ class WC_REST_Products_V1_Controller extends WC_REST_Posts_Controller { 'type' => 'object', 'properties' => array( 'id' => array( - 'description' => __( 'File MD5 hash.', 'woocommerce' ), + 'description' => __( 'File ID.', 'woocommerce' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), - 'readonly' => true, ), 'name' => array( 'description' => __( 'File name.', 'woocommerce' ), @@ -2360,10 +2359,9 @@ class WC_REST_Products_V1_Controller extends WC_REST_Posts_Controller { 'type' => 'object', 'properties' => array( 'id' => array( - 'description' => __( 'File MD5 hash.', 'woocommerce' ), + 'description' => __( 'File ID.', 'woocommerce' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), - 'readonly' => true, ), 'name' => array( 'description' => __( 'File name.', 'woocommerce' ), diff --git a/includes/api/v2/class-wc-rest-product-variations-v2-controller.php b/includes/api/v2/class-wc-rest-product-variations-v2-controller.php index 6cb3350ab1d..26883d35a66 100644 --- a/includes/api/v2/class-wc-rest-product-variations-v2-controller.php +++ b/includes/api/v2/class-wc-rest-product-variations-v2-controller.php @@ -762,10 +762,9 @@ class WC_REST_Product_Variations_V2_Controller extends WC_REST_Products_V2_Contr 'type' => 'object', 'properties' => array( 'id' => array( - 'description' => __( 'File MD5 hash.', 'woocommerce' ), + 'description' => __( 'File ID.', 'woocommerce' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), - 'readonly' => true, ), 'name' => array( 'description' => __( 'File name.', 'woocommerce' ), diff --git a/includes/api/v2/class-wc-rest-products-v2-controller.php b/includes/api/v2/class-wc-rest-products-v2-controller.php index 1ed1c1e0acc..592dacfd8c2 100644 --- a/includes/api/v2/class-wc-rest-products-v2-controller.php +++ b/includes/api/v2/class-wc-rest-products-v2-controller.php @@ -1606,10 +1606,9 @@ class WC_REST_Products_V2_Controller extends WC_REST_Legacy_Products_Controller 'type' => 'object', 'properties' => array( 'id' => array( - 'description' => __( 'File MD5 hash.', 'woocommerce' ), + 'description' => __( 'File ID.', 'woocommerce' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), - 'readonly' => true, ), 'name' => array( 'description' => __( 'File name.', 'woocommerce' ), From d4e528634a9b030bed9dfbfa5b0505cf1de00f44 Mon Sep 17 00:00:00 2001 From: claudiulodro Date: Tue, 16 Oct 2018 09:52:17 -0700 Subject: [PATCH 054/361] Update readme.txt --- readme.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/readme.txt b/readme.txt index 7f43a494f59..c0997b517cd 100644 --- a/readme.txt +++ b/readme.txt @@ -158,7 +158,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w == Changelog == -= 3.5.0 - 2018-10-XX = += 3.5.0 - 2018-10-17 = * Feature - REST API v3. #20111 * Feature - Option has been added on the inventory tab of the edit product page to set a low stock threshold for individual products. #20260 * Feature - Add ability to export products by category to the CSV exporter. #20870 @@ -207,6 +207,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Remove the erasure tools links from the descriptions of the erasure settings for users without the manage_privacy_options capability. #21565 * Fix - Don't double urldecode posted variation attributes. #21570 * Fix - New helper functions wc_user_has_role and wc_current_user_has_role to correctly check user roles. #21569 +* Fix - Don't double-sanitize cart images. #21574 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 7b4075f11ad08b48a205392e7d2b35ba4c6d8fe8 Mon Sep 17 00:00:00 2001 From: JeroenSormani Date: Tue, 16 Oct 2018 18:53:31 +0200 Subject: [PATCH 055/361] Ensure wp_list_pluck() gets a array and not possibly null --- includes/data-stores/class-wc-product-data-store-cpt.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/data-stores/class-wc-product-data-store-cpt.php b/includes/data-stores/class-wc-product-data-store-cpt.php index 28292337548..1b51964abe8 100644 --- a/includes/data-stores/class-wc-product-data-store-cpt.php +++ b/includes/data-stores/class-wc-product-data-store-cpt.php @@ -744,7 +744,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da continue; } elseif ( $attribute->is_taxonomy() ) { - wp_set_object_terms( $product->get_id(), wp_list_pluck( $attribute->get_terms(), 'term_id' ), $attribute->get_name() ); + wp_set_object_terms( $product->get_id(), wp_list_pluck( (array) $attribute->get_terms(), 'term_id' ), $attribute->get_name() ); } else { $value = wc_implode_text_attributes( $attribute->get_options() ); } From 2cee87b7cfe39cb2beca73351d70a442f5f3e614 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Tue, 16 Oct 2018 10:09:29 -0700 Subject: [PATCH 056/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index c0997b517cd..4dc95e77e5f 100644 --- a/readme.txt +++ b/readme.txt @@ -208,6 +208,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Don't double urldecode posted variation attributes. #21570 * Fix - New helper functions wc_user_has_role and wc_current_user_has_role to correctly check user roles. #21569 * Fix - Don't double-sanitize cart images. #21574 +* Fix - Check if ID exists and is not empty before set Product's download ID in API. #21588 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 13da70810d88c488458400bc7489100db3373b00 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Tue, 16 Oct 2018 11:23:37 -0700 Subject: [PATCH 057/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index 4dc95e77e5f..046c9fd8b4a 100644 --- a/readme.txt +++ b/readme.txt @@ -209,6 +209,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - New helper functions wc_user_has_role and wc_current_user_has_role to correctly check user roles. #21569 * Fix - Don't double-sanitize cart images. #21574 * Fix - Check if ID exists and is not empty before set Product's download ID in API. #21588 +* Fix - Check for multisite and user roles instead of using current_user_can. #21569 #21575 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 0f1f91f90a650a9703a933b3c3651bcc2fdb1090 Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Tue, 16 Oct 2018 19:07:58 -0300 Subject: [PATCH 058/361] [REST API] Fixed duplicated entry in orders notes schema --- includes/api/class-wc-rest-order-notes-controller.php | 6 ------ 1 file changed, 6 deletions(-) diff --git a/includes/api/class-wc-rest-order-notes-controller.php b/includes/api/class-wc-rest-order-notes-controller.php index 32f77b6692c..3a50006586e 100644 --- a/includes/api/class-wc-rest-order-notes-controller.php +++ b/includes/api/class-wc-rest-order-notes-controller.php @@ -136,12 +136,6 @@ class WC_REST_Order_Notes_Controller extends WC_REST_Order_Notes_V2_Controller { 'context' => array( 'view', 'edit' ), 'readonly' => true, ), - 'date_created' => array( - 'description' => __( "The date the order note was created, in the site's timezone.", 'woocommerce' ), - 'type' => 'date-time', - 'context' => array( 'view', 'edit' ), - 'readonly' => true, - ), 'date_created_gmt' => array( 'description' => __( 'The date the order note was created, as GMT.', 'woocommerce' ), 'type' => 'date-time', From 98c8bb3edaf1da16bd1a156c42b1959e191ec2b2 Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Tue, 16 Oct 2018 19:20:53 -0300 Subject: [PATCH 059/361] [REST API] Fixed schema for refunded_payment in order refunds endpoint --- includes/api/v2/class-wc-rest-order-refunds-v2-controller.php | 1 + 1 file changed, 1 insertion(+) diff --git a/includes/api/v2/class-wc-rest-order-refunds-v2-controller.php b/includes/api/v2/class-wc-rest-order-refunds-v2-controller.php index 202ed5e718d..3ce6e7fbf82 100644 --- a/includes/api/v2/class-wc-rest-order-refunds-v2-controller.php +++ b/includes/api/v2/class-wc-rest-order-refunds-v2-controller.php @@ -388,6 +388,7 @@ class WC_REST_Order_Refunds_V2_Controller extends WC_REST_Orders_V2_Controller { 'description' => __( 'If the payment was refunded via the API.', 'woocommerce' ), 'type' => 'boolean', 'context' => array( 'view' ), + 'readonly' => true, ), 'meta_data' => array( 'description' => __( 'Meta data.', 'woocommerce' ), From c6daf8287d88a0cff7083c5cd4f6f1b31b3b66ca Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Tue, 16 Oct 2018 20:15:21 -0300 Subject: [PATCH 060/361] [REST API] Ability to query orders from trash bin --- includes/api/class-wc-rest-orders-controller.php | 9 ++++++--- includes/api/v2/class-wc-rest-orders-v2-controller.php | 8 +++++--- 2 files changed, 11 insertions(+), 6 deletions(-) diff --git a/includes/api/class-wc-rest-orders-controller.php b/includes/api/class-wc-rest-orders-controller.php index 7332784e535..72b7d0b7418 100644 --- a/includes/api/class-wc-rest-orders-controller.php +++ b/includes/api/class-wc-rest-orders-controller.php @@ -217,12 +217,15 @@ class WC_REST_Orders_Controller extends WC_REST_Orders_V2_Controller { $args['post_status'] = array(); foreach ( $statuses as $status ) { - if ( 'any' === $status ) { + if ( in_array( $status, $this->get_order_statuses(), true ) ) { + $args['post_status'][] = 'wc-' . $status; + } elseif ( 'any' === $status ) { // Set status to "any" and short-circuit out. $args['post_status'] = 'any'; break; + } else { + $args['post_status'][] = $status; } - $args['post_status'][] = 'wc-' . $status; } return $args; @@ -255,7 +258,7 @@ class WC_REST_Orders_Controller extends WC_REST_Orders_V2_Controller { 'type' => 'array', 'items' => array( 'type' => 'string', - 'enum' => array_merge( array( 'any' ), $this->get_order_statuses() ), + 'enum' => array_merge( array( 'any', 'trash' ), $this->get_order_statuses() ), ), 'validate_callback' => 'rest_validate_request_arg', ); diff --git a/includes/api/v2/class-wc-rest-orders-v2-controller.php b/includes/api/v2/class-wc-rest-orders-v2-controller.php index 8c9cb561eaa..85ebdac6af3 100644 --- a/includes/api/v2/class-wc-rest-orders-v2-controller.php +++ b/includes/api/v2/class-wc-rest-orders-v2-controller.php @@ -358,10 +358,12 @@ class WC_REST_Orders_V2_Controller extends WC_REST_Legacy_Orders_Controller { $args = parent::prepare_objects_query( $request ); // Set post_status. - if ( 'any' !== $request['status'] ) { + if ( in_array( $request['status'], $this->get_order_statuses(), true ) ) { $args['post_status'] = 'wc-' . $request['status']; - } else { + } elseif ( 'any' === $request['status'] ) { $args['post_status'] = 'any'; + } else { + $args['post_status'] = $request['status']; } if ( isset( $request['customer'] ) ) { @@ -1674,7 +1676,7 @@ class WC_REST_Orders_V2_Controller extends WC_REST_Legacy_Orders_Controller { 'default' => 'any', 'description' => __( 'Limit result set to orders assigned a specific status.', 'woocommerce' ), 'type' => 'string', - 'enum' => array_merge( array( 'any' ), $this->get_order_statuses() ), + 'enum' => array_merge( array( 'any', 'trash' ), $this->get_order_statuses() ), 'sanitize_callback' => 'sanitize_key', 'validate_callback' => 'rest_validate_request_arg', ); From a9b36a4e233f459b2558fecf9dc78296c65b115e Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Tue, 16 Oct 2018 21:12:49 -0300 Subject: [PATCH 061/361] [REST API] Fixed schema stock_status on products endpoints --- includes/api/class-wc-rest-product-variations-controller.php | 3 ++- includes/api/class-wc-rest-products-controller.php | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/includes/api/class-wc-rest-product-variations-controller.php b/includes/api/class-wc-rest-product-variations-controller.php index 8cb3b101239..157e1ca52c6 100644 --- a/includes/api/class-wc-rest-product-variations-controller.php +++ b/includes/api/class-wc-rest-product-variations-controller.php @@ -567,8 +567,9 @@ class WC_REST_Product_Variations_Controller extends WC_REST_Product_Variations_V 'context' => array( 'view', 'edit' ), ), 'stock_status' => array( - 'description' => __( 'Controls the stock status of the product: "instock", "outofstock" or "onbackorder".', 'woocommerce' ), + 'description' => __( 'Controls the stock status of the product.', 'woocommerce' ), 'type' => 'string', + 'default' => 'instock', 'enum' => array_keys( wc_get_product_stock_status_options() ), 'context' => array( 'view', 'edit' ), ), diff --git a/includes/api/class-wc-rest-products-controller.php b/includes/api/class-wc-rest-products-controller.php index 6c081c6cf18..fffd4f50315 100644 --- a/includes/api/class-wc-rest-products-controller.php +++ b/includes/api/class-wc-rest-products-controller.php @@ -926,8 +926,9 @@ class WC_REST_Products_Controller extends WC_REST_Products_V2_Controller { 'context' => array( 'view', 'edit' ), ), 'stock_status' => array( - 'description' => __( 'Controls the stock status of the product: "instock", "outofstock" or "onbackorder".', 'woocommerce' ), + 'description' => __( 'Controls the stock status of the product.', 'woocommerce' ), 'type' => 'string', + 'default' => 'instock', 'enum' => array_keys( wc_get_product_stock_status_options() ), 'context' => array( 'view', 'edit' ), ), From 2bcd4598f8fb6a7b18d52f30d8012eed5f2598b9 Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Tue, 16 Oct 2018 21:15:03 -0300 Subject: [PATCH 062/361] Fixed coding standards --- includes/api/class-wc-rest-products-controller.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/api/class-wc-rest-products-controller.php b/includes/api/class-wc-rest-products-controller.php index fffd4f50315..ea5d04775be 100644 --- a/includes/api/class-wc-rest-products-controller.php +++ b/includes/api/class-wc-rest-products-controller.php @@ -1330,7 +1330,7 @@ class WC_REST_Products_Controller extends WC_REST_Products_V2_Controller { $data = parent::get_product_data( $product, $context ); // Replace in_stock with stock_status. - $pos = array_search( 'in_stock', array_keys( $data ) ); + $pos = array_search( 'in_stock', array_keys( $data ), true ); $array_section_1 = array_slice( $data, 0, $pos, true ); $array_section_2 = array_slice( $data, $pos + 1, null, true ); From 6f77040eb4d348774242edcf5558555757321b21 Mon Sep 17 00:00:00 2001 From: Steve Grunwell Date: Wed, 17 Oct 2018 02:05:10 +0000 Subject: [PATCH 063/361] Since PHP 5.2 runs a *really* old version of PHPUnit (that doesn't support the @testWith annotation), run the scenarios in a single test case --- .../order/class-wc-tests-order-functions.php | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/tests/unit-tests/order/class-wc-tests-order-functions.php b/tests/unit-tests/order/class-wc-tests-order-functions.php index cf167631fe0..51318ac4a9d 100644 --- a/tests/unit-tests/order/class-wc-tests-order-functions.php +++ b/tests/unit-tests/order/class-wc-tests-order-functions.php @@ -1273,14 +1273,12 @@ class WC_Tests_Order_Functions extends WC_Unit_Test_Case { /** * Test wc_sanitize_order_id(). - * - * @testWith ["123", 123] - * ["#123", 123] - * ["# 123", 123] - * ["Order #123", 123] */ - public function test_wc_sanitize_order_id( $id, $expected ) { - $this->assertSame( $expected, wc_sanitize_order_id( $id ) ); + public function test_wc_sanitize_order_id() { + $this->assertSame( 123, wc_sanitize_order_id( '123' ) ); + $this->assertSame( 123, wc_sanitize_order_id( '#123' ) ); + $this->assertSame( 123, wc_sanitize_order_id( '# 123' ) ); + $this->assertSame( 123, wc_sanitize_order_id( 'Order #123' ) ); } /** From 35bd8ba05dc4a7d9a574b0af660015e7f5dce7b9 Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Wed, 17 Oct 2018 11:20:27 -0300 Subject: [PATCH 064/361] Revert "Do check on new key field instead and only run alter when not found." This reverts commit a41df43cb02428dcdb0aafae6a07fa36b3a23a60. --- includes/wc-update-functions.php | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/includes/wc-update-functions.php b/includes/wc-update-functions.php index 12805542581..c5482176130 100644 --- a/includes/wc-update-functions.php +++ b/includes/wc-update-functions.php @@ -2004,11 +2004,11 @@ function wc_update_350_change_woocommerce_sessions_schema() { FROM information_schema.TABLE_CONSTRAINTS WHERE CONSTRAINT_SCHEMA = '{$wpdb->dbname}' AND CONSTRAINT_TYPE = 'UNIQUE' - AND CONSTRAINT_NAME = 'session_key' + AND CONSTRAINT_NAME = 'session_id' AND TABLE_NAME = '{$wpdb->prefix}woocommerce_sessions' " ); - if ( ! $results ) { + if ( $results ) { $wpdb->query( "ALTER TABLE `{$wpdb->prefix}woocommerce_sessions` DROP KEY `session_id`, ADD UNIQUE KEY(`session_key`)" ); From 0c77ea584bf3dd263793b4cc5dcb5d1fa3c88625 Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Wed, 17 Oct 2018 11:20:39 -0300 Subject: [PATCH 065/361] Revert "Do not try and create primary key using upgrade routine, dbdelta does that automatically. Just drop the key if it exists and add a new unique key." This reverts commit d3e59b770b87d13c412effa32aa10cf49e219da5. --- includes/wc-update-functions.php | 17 +++-------------- 1 file changed, 3 insertions(+), 14 deletions(-) diff --git a/includes/wc-update-functions.php b/includes/wc-update-functions.php index c5482176130..ff086d5eafc 100644 --- a/includes/wc-update-functions.php +++ b/includes/wc-update-functions.php @@ -1999,20 +1999,9 @@ function wc_update_350_reviews_comment_type() { function wc_update_350_change_woocommerce_sessions_schema() { global $wpdb; - $results = $wpdb->get_results( " - SELECT CONSTRAINT_NAME - FROM information_schema.TABLE_CONSTRAINTS - WHERE CONSTRAINT_SCHEMA = '{$wpdb->dbname}' - AND CONSTRAINT_TYPE = 'UNIQUE' - AND CONSTRAINT_NAME = 'session_id' - AND TABLE_NAME = '{$wpdb->prefix}woocommerce_sessions' - " ); - - if ( $results ) { - $wpdb->query( - "ALTER TABLE `{$wpdb->prefix}woocommerce_sessions` DROP KEY `session_id`, ADD UNIQUE KEY(`session_key`)" - ); - } + $wpdb->query( + "ALTER TABLE `{$wpdb->prefix}woocommerce_sessions` DROP PRIMARY KEY, DROP KEY `session_id`, ADD PRIMARY KEY(`session_id`), ADD UNIQUE KEY(`session_key`)" + ); } /** From 41d2e1cafd700c346ffd8abdb02e3752e95be5e8 Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Wed, 17 Oct 2018 12:11:01 -0300 Subject: [PATCH 066/361] Change wp_woocommerce_sessions before dbDelta() is called On PR #21245, I added a db update routine to change wp_woocommerce_sessions primary key from session_key char(32) to session_id bigint auto_increment as dbDelta() is unable to handle primary key changes (see https://core.trac.wordpress.org/ticket/40357). But I didn't realize that dbDelta() was actually trying to add a new primary key to the table without droping the old key first and this was generating the following error: ``` WordPress database error Multiple primary key defined for query ALTER TABLE wp_woocommerce_sessions ADD PRIMARY KEY (`session_id`) ``` To prevent this error from happening, this commit moves the query that changes the primary key from db update routine to WC_Install::create_tables() so that it runs before dbDelta() is called. --- includes/class-wc-install.php | 17 ++++++++++++++++- includes/wc-update-functions.php | 18 ------------------ 2 files changed, 16 insertions(+), 19 deletions(-) diff --git a/includes/class-wc-install.php b/includes/class-wc-install.php index 6bd8bc47944..6f372b3c583 100644 --- a/includes/class-wc-install.php +++ b/includes/class-wc-install.php @@ -116,7 +116,6 @@ class WC_Install { '3.5.0' => array( 'wc_update_350_order_customer_id', 'wc_update_350_reviews_comment_type', - 'wc_update_350_change_woocommerce_sessions_schema', 'wc_update_350_db_version', ), ); @@ -554,6 +553,22 @@ class WC_Install { } } + /** + * Change wp_woocommerce_sessions schema to use a bigint auto increment field instead of char(32) field as + * the primary key as it is not a good practice to use a char(32) field as the primary key of a table and as + * there were reports of issues with this table (see https://github.com/woocommerce/woocommerce/issues/20912). + * + * This query needs to run before dbDelta() as this WP function is not able to handle primary key changes + * (see https://github.com/woocommerce/woocommerce/issues/21534 and https://core.trac.wordpress.org/ticket/40357). + */ + if ( $wpdb->get_var( "SHOW TABLES LIKE '{$wpdb->prefix}woocommerce_sessions'" ) ) { + if ( ! $wpdb->get_var( "SHOW KEYS FROM {$wpdb->prefix}woocommerce_sessions WHERE Key_name = 'PRIMARY' AND Column_name = 'session_id'" ) ) { + $wpdb->query( + "ALTER TABLE `{$wpdb->prefix}woocommerce_sessions` DROP PRIMARY KEY, DROP KEY `session_id`, ADD PRIMARY KEY(`session_id`), ADD UNIQUE KEY(`session_key`)" + ); + } + } + dbDelta( self::get_schema() ); $index_exists = $wpdb->get_row( "SHOW INDEX FROM {$wpdb->comments} WHERE column_name = 'comment_type' and key_name = 'woo_idx_comment_type'" ); diff --git a/includes/wc-update-functions.php b/includes/wc-update-functions.php index ff086d5eafc..f6e6fa2bfe7 100644 --- a/includes/wc-update-functions.php +++ b/includes/wc-update-functions.php @@ -1986,24 +1986,6 @@ function wc_update_350_reviews_comment_type() { ); } -/** - * Change wp_woocommerce_sessions schema to use a bigint auto increment field - * instead of char(32) field as the primary key. Doing this change primarily as - * it should reduce the occurrence of deadlocks (see - * https://github.com/woocommerce/woocommerce/issues/20912), but also because - * it is not a good practice to use a char(32) field as the primary key of a - * table. - * - * @return void - */ -function wc_update_350_change_woocommerce_sessions_schema() { - global $wpdb; - - $wpdb->query( - "ALTER TABLE `{$wpdb->prefix}woocommerce_sessions` DROP PRIMARY KEY, DROP KEY `session_id`, ADD PRIMARY KEY(`session_id`), ADD UNIQUE KEY(`session_key`)" - ); -} - /** * Update DB Version. */ From 0f2ee63fdcf56d1a588e8e34847bfa978e299289 Mon Sep 17 00:00:00 2001 From: Claudiu Lodromanean Date: Wed, 17 Oct 2018 08:26:39 -0700 Subject: [PATCH 067/361] Update readme.txt --- readme.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/readme.txt b/readme.txt index 046c9fd8b4a..ec0062e93aa 100644 --- a/readme.txt +++ b/readme.txt @@ -210,6 +210,7 @@ Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/w * Fix - Don't double-sanitize cart images. #21574 * Fix - Check if ID exists and is not empty before set Product's download ID in API. #21588 * Fix - Check for multisite and user roles instead of using current_user_can. #21569 #21575 +* Fix - Ensure wp_list_pluck() gets a array and not possibly null in WC_Product_Data_Store_CPT::update_attributes. #21591 * Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 * Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 * Tweak - Show empty terms in admin product category filter dropdown. #20324 From 65356ae147ea7bc2d1cdf238626601ea3ab8c110 Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Wed, 17 Oct 2018 16:27:27 -0300 Subject: [PATCH 068/361] Revert "Delete old ISSUE_TEMPLATE.md" --- .github/ISSUE_TEMPLATE.md | 48 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE.md diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md new file mode 100644 index 00000000000..3019353697d --- /dev/null +++ b/.github/ISSUE_TEMPLATE.md @@ -0,0 +1,48 @@ + + + + + + + + + + +## Prerequisites + + + +- [ ] I have searched for similar issues in both open and closed tickets and cannot find a duplicate +- [ ] The issue still exists against the latest `master` branch of WooCommerce on Github (this is **not** the same version as on WordPress.org!) +- [ ] I have attempted to find the simplest possible steps to reproduce the issue +- [ ] I have included a failing test as a pull request (Optional) + +## Steps to reproduce the issue + + + +1. +2. +3. + +## Expected/actual behavior + +When I follow those steps, I see... + +I was expecting to see... + +## Isolating the problem + + + +- [ ] This bug happens with only WooCommerce plugin active +- [ ] This bug happens with a default WordPress theme active, or [Storefront](https://woocommerce.com/storefront/) +- [ ] I can reproduce this bug consistently using the steps above + +## WordPress Environment + +
      +``` +Copy and paste the system status report from **WooCommerce > System Status** in WordPress admin here. +``` +
      From bbf6282d07ef8a303da7d0c037e122e4b95b8b7f Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Wed, 17 Oct 2018 16:53:33 -0300 Subject: [PATCH 069/361] Simplify WC_Product_Simple tests Use setUp() method to define a product object that is used in all the tests instead of duplicating code and creating a product object in every test. --- tests/unit-tests/product/product-simple.php | 148 ++++++++------------ 1 file changed, 60 insertions(+), 88 deletions(-) diff --git a/tests/unit-tests/product/product-simple.php b/tests/unit-tests/product/product-simple.php index a377244cc3b..c6a13677d02 100644 --- a/tests/unit-tests/product/product-simple.php +++ b/tests/unit-tests/product/product-simple.php @@ -7,21 +7,29 @@ */ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { + /** + * @var WC_Product + */ + protected $product; + + public function setUp() { + parent::setUp(); + + $this->product = WC_Helper_Product::create_simple_product(); + } + /** * Test add_to_cart_text(). * * @since 2.3 */ public function test_add_to_cart_text() { - // Create product - $product = WC_Helper_Product::create_simple_product(); + $this->assertEquals( 'Add to cart', $this->product->add_to_cart_text() ); - $this->assertEquals( 'Add to cart', $product->add_to_cart_text() ); + $this->product->set_stock_status( 'outofstock' ); + $this->product->save(); - $product->set_stock_status( 'outofstock' ); - $product->save(); - - $this->assertEquals( 'Read more', $product->add_to_cart_text() ); + $this->assertEquals( 'Read more', $this->product->add_to_cart_text() ); } /** @@ -30,10 +38,7 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_single_add_to_cart_text() { - // Create product - $product = WC_Helper_Product::create_simple_product(); - - $this->assertEquals( 'Add to cart', $product->single_add_to_cart_text() ); + $this->assertEquals( 'Add to cart', $this->product->single_add_to_cart_text() ); } /** @@ -42,10 +47,7 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_get_title() { - // Create product - $product = WC_Helper_Product::create_simple_product(); - - $this->assertEquals( 'Dummy Product', $product->get_name() ); + $this->assertEquals( 'Dummy Product', $this->product->get_name() ); } /** @@ -54,10 +56,7 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_get_permalink() { - // Create product - $product = WC_Helper_Product::create_simple_product(); - - $this->assertEquals( get_permalink( $product->get_id() ), $product->get_permalink() ); + $this->assertEquals( get_permalink( $this->product->get_id() ), $this->product->get_permalink() ); } /** @@ -66,10 +65,7 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_get_sku() { - // Create product - $product = WC_Helper_Product::create_simple_product(); - - $this->assertEquals( 'DUMMY SKU', $product->get_sku() ); + $this->assertEquals( 'DUMMY SKU', $this->product->get_sku() ); } /** @@ -78,14 +74,11 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_get_stock_quantity() { - // Create product - $product = WC_Helper_Product::create_simple_product(); + $this->assertEmpty( $this->product->get_stock_quantity() ); - $this->assertEmpty( $product->get_stock_quantity() ); + $this->product->manage_stock = 'yes'; - $product->manage_stock = 'yes'; - - $this->assertEquals( 0, $product->get_stock_quantity() ); + $this->assertEquals( 0, $this->product->get_stock_quantity() ); } /** @@ -94,13 +87,10 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_is_type() { - // Create product - $product = WC_Helper_Product::create_simple_product(); - - $this->assertTrue( $product->is_type( 'simple' ) ); - $this->assertFalse( $product->is_type( 'grouped' ) ); - $this->assertFalse( $product->is_type( 'variable' ) ); - $this->assertFalse( $product->is_type( 'external' ) ); + $this->assertTrue( $this->product->is_type( 'simple' ) ); + $this->assertFalse( $this->product->is_type( 'grouped' ) ); + $this->assertFalse( $this->product->is_type( 'variable' ) ); + $this->assertFalse( $this->product->is_type( 'external' ) ); } /** @@ -109,16 +99,13 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_is_downloadable() { - // Create product - $product = WC_Helper_Product::create_simple_product(); + $this->assertEmpty( $this->product->is_downloadable() ); - $this->assertEmpty( $product->is_downloadable() ); + $this->product->set_downloadable( 'yes' ); + $this->assertTrue( $this->product->is_downloadable() ); - $product->set_downloadable( 'yes' ); - $this->assertTrue( $product->is_downloadable() ); - - $product->set_downloadable( 'no' ); - $this->assertFalse( $product->is_downloadable() ); + $this->product->set_downloadable( 'no' ); + $this->assertFalse( $this->product->is_downloadable() ); } /** @@ -127,16 +114,13 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_is_virtual() { - // Create product - $product = WC_Helper_Product::create_simple_product(); + $this->assertEmpty( $this->product->is_virtual() ); - $this->assertEmpty( $product->is_virtual() ); + $this->product->set_virtual( 'yes' ); + $this->assertTrue( $this->product->is_virtual() ); - $product->set_virtual( 'yes' ); - $this->assertTrue( $product->is_virtual() ); - - $product->set_virtual( 'no' ); - $this->assertFalse( $product->is_virtual() ); + $this->product->set_virtual( 'no' ); + $this->assertFalse( $this->product->is_virtual() ); } /** @@ -145,14 +129,11 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_needs_shipping() { - // Create product - $product = WC_Helper_Product::create_simple_product(); + $this->product->set_virtual( 'yes' ); + $this->assertFalse( $this->product->needs_shipping() ); - $product->set_virtual( 'yes' ); - $this->assertFalse( $product->needs_shipping() ); - - $product->set_virtual( 'no' ); - $this->assertTrue( $product->needs_shipping() ); + $this->product->set_virtual( 'no' ); + $this->assertTrue( $this->product->needs_shipping() ); } /** @@ -161,14 +142,11 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_is_sold_individually() { - // Create product - $product = WC_Helper_Product::create_simple_product(); + $this->product->set_sold_individually( 'yes' ); + $this->assertTrue( $this->product->is_sold_individually() ); - $product->set_sold_individually( 'yes' ); - $this->assertTrue( $product->is_sold_individually() ); - - $product->set_sold_individually( 'no' ); - $this->assertFalse( $product->is_sold_individually() ); + $this->product->set_sold_individually( 'no' ); + $this->assertFalse( $this->product->is_sold_individually() ); } /** @@ -177,17 +155,14 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_backorders_allowed() { - // Create product - $product = WC_Helper_Product::create_simple_product(); + $this->product->set_backorders( 'yes' ); + $this->assertTrue( $this->product->backorders_allowed() ); - $product->set_backorders( 'yes' ); - $this->assertTrue( $product->backorders_allowed() ); + $this->product->set_backorders( 'notify' ); + $this->assertTrue( $this->product->backorders_allowed() ); - $product->set_backorders( 'notify' ); - $this->assertTrue( $product->backorders_allowed() ); - - $product->set_backorders( 'no' ); - $this->assertFalse( $product->backorders_allowed() ); + $this->product->set_backorders( 'no' ); + $this->assertFalse( $this->product->backorders_allowed() ); } /** @@ -196,21 +171,18 @@ class WC_Tests_Product_Simple extends WC_Unit_Test_Case { * @since 2.3 */ public function test_backorders_require_notification() { - // Create product - $product = WC_Helper_Product::create_simple_product(); + $this->product->set_backorders( 'notify' ); + $this->product->set_manage_stock( 'yes' ); + $this->assertTrue( $this->product->backorders_require_notification() ); - $product->set_backorders( 'notify' ); - $product->set_manage_stock( 'yes' ); - $this->assertTrue( $product->backorders_require_notification() ); + $this->product->set_backorders( 'yes' ); + $this->assertFalse( $this->product->backorders_require_notification() ); - $product->set_backorders( 'yes' ); - $this->assertFalse( $product->backorders_require_notification() ); + $this->product->set_backorders( 'no' ); + $this->assertFalse( $this->product->backorders_require_notification() ); - $product->set_backorders( 'no' ); - $this->assertFalse( $product->backorders_require_notification() ); - - $product->set_backorders( 'yes' ); - $product->set_manage_stock( 'no' ); - $this->assertFalse( $product->backorders_require_notification() ); + $this->product->set_backorders( 'yes' ); + $this->product->set_manage_stock( 'no' ); + $this->assertFalse( $this->product->backorders_require_notification() ); } } From 6ed2ebb3ba97b84b7d39fa3ebd3e6c545fff18cc Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Wed, 17 Oct 2018 19:34:27 -0300 Subject: [PATCH 070/361] Fix: WC_Product::get_image() should use $attr parameter This commit fixes a issue that was introduced when WC_Product::get_image() was refactored in 64b589f0325a729a1914942801f4b2cae929e013 that was making this method ignore what was passed in the $attr parameter. --- includes/abstracts/abstract-wc-product.php | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/includes/abstracts/abstract-wc-product.php b/includes/abstracts/abstract-wc-product.php index a6f2cd5bb16..7339cf6cbef 100644 --- a/includes/abstracts/abstract-wc-product.php +++ b/includes/abstracts/abstract-wc-product.php @@ -1822,10 +1822,10 @@ class WC_Product extends WC_Abstract_Legacy_Product { */ public function get_image( $size = 'woocommerce_thumbnail', $attr = array(), $placeholder = true ) { if ( $this->get_image_id() ) { - $image = wp_get_attachment_image( $this->get_image_id(), $size ); + $image = wp_get_attachment_image( $this->get_image_id(), $size, false, $attr ); } elseif ( $this->get_parent_id() ) { $parent_product = wc_get_product( $this->get_parent_id() ); - $image = $parent_product->get_image(); + $image = $parent_product->get_image( $size, $attr, $placeholder ); } elseif ( $placeholder ) { $image = wc_placeholder_img( $size ); } else { From 05aa357b981b71446313a5699d6e57421cbadc81 Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Wed, 17 Oct 2018 19:36:34 -0300 Subject: [PATCH 071/361] Add unit tests for WC_Product::get_image() --- tests/unit-tests/product/data.php | 77 +++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) diff --git a/tests/unit-tests/product/data.php b/tests/unit-tests/product/data.php index 5b96b20502c..2bcb7f24c97 100644 --- a/tests/unit-tests/product/data.php +++ b/tests/unit-tests/product/data.php @@ -267,4 +267,81 @@ class WC_Tests_Product_Data extends WC_Unit_Test_Case { $this->assertEquals( $product3_id, $product->get_id() ); $this->assertEquals( '£50.00', $product->get_price_html() ); } + + public function test_get_image_should_return_product_image() { + $product = new WC_Product(); + $image_url = $this->set_product_image( $product ); + + $this->assertEquals( + '', + $product->get_image() + ); + + $this->assertEquals( + '', + $product->get_image( 'single' ) + ); + + $this->assertEquals( + '', + $product->get_image( 'single', array( 'class' => 'custom-class' ) ) + ); + } + + public function test_get_image_should_return_parent_product_image() { + $variable_product = WC_Helper_Product::create_variation_product(); + $variations = $variable_product->get_children(); + $variation_1 = wc_get_product( $variations[0] ); + $image_url = $this->set_product_image( $variable_product ); + + $this->assertEquals( + '', + $variation_1->get_image() + ); + + $this->assertEquals( + '', + $variation_1->get_image( 'single' ) + ); + + $this->assertEquals( + '', + $variation_1->get_image( 'single', array( 'class' => 'custom-class' ) ) + ); + } + + public function test_get_image_should_return_place_holder_image() { + $product = new WC_Product(); + $image_url = wc_placeholder_img_src(); + $expected_result = 'Placeholder'; + + $this->assertEquals( $expected_result, $product->get_image() ); + $this->assertEquals( $expected_result, $product->get_image( 'woocommerce_thumbnail', array(), true ) ); + } + + public function test_get_image_should_return_empty_string() { + $product = new WC_Product(); + $this->assertEquals( '', $product->get_image( 'woocommerce_thumbnail', array(), false ) ); + } + + /** + * Helper method to define a image for a product and return its URL. + * + * @param WC_Product $product Product object. + * @return string image URL. + */ + protected function set_product_image( $product ) { + global $wpdb; + + // TODO: find a way to set the product image without performing a HTTP request to make the tests faster. + $image_url = media_sideload_image( 'http://cldup.com/Dr1Bczxq4q.png', $product->get_id(), '', 'src' ); + + $this->assertNotWPError( $image_url ); + + $image_id = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM {$wpdb->posts} WHERE guid = %s", $image_url ) ); + $product->set_image_id( $image_id ); + $product->save(); + + return $image_url; + } } From 3c76b4992bab530437943bb77e8d63f210d6409d Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Thu, 18 Oct 2018 09:11:26 -0300 Subject: [PATCH 072/361] phpcs fixes --- templates/single-product/product-image.php | 5 ++--- templates/single-product/product-thumbnails.php | 7 +++---- 2 files changed, 5 insertions(+), 7 deletions(-) diff --git a/templates/single-product/product-image.php b/templates/single-product/product-image.php index 2923d69a5a8..10a977b470f 100644 --- a/templates/single-product/product-image.php +++ b/templates/single-product/product-image.php @@ -11,7 +11,6 @@ * the readme will list any important changes. * * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes * @package WooCommerce/Templates * @version 3.5.0 */ @@ -38,14 +37,14 @@ $wrapper_classes = apply_filters( 'woocommerce_single_product_image_gallery_cl
      '; $html .= sprintf( '%s', esc_url( wc_placeholder_img_src( 'woocommerce_single' ) ), esc_html__( 'Awaiting product image', 'woocommerce' ) ); $html .= ''; } - echo apply_filters( 'woocommerce_single_product_image_thumbnail_html', $html, $post_thumbnail_id ); + echo apply_filters( 'woocommerce_single_product_image_thumbnail_html', $html, $post_thumbnail_id ); // phpcs:disable WordPress.XSS.EscapeOutput.OutputNotEscaped do_action( 'woocommerce_product_thumbnails' ); ?> diff --git a/templates/single-product/product-thumbnails.php b/templates/single-product/product-thumbnails.php index b3e06a4ceb3..158de7fa8d0 100644 --- a/templates/single-product/product-thumbnails.php +++ b/templates/single-product/product-thumbnails.php @@ -10,9 +10,8 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates * @version 3.3.2 */ @@ -29,6 +28,6 @@ $attachment_ids = $product->get_gallery_image_ids(); if ( $attachment_ids && has_post_thumbnail() ) { foreach ( $attachment_ids as $attachment_id ) { - echo apply_filters( 'woocommerce_single_product_image_thumbnail_html', wc_get_gallery_image_html( $attachment_id ), $attachment_id ); + echo apply_filters( 'woocommerce_single_product_image_thumbnail_html', wc_get_gallery_image_html( $attachment_id ), $attachment_id ); // phpcs:disable WordPress.XSS.EscapeOutput.OutputNotEscaped } } From 9b094fc74db8a9d8f79c43bf9c268687f1f18af8 Mon Sep 17 00:00:00 2001 From: Rodrigo Primo Date: Thu, 18 Oct 2018 09:20:05 -0300 Subject: [PATCH 073/361] Use $product->get_image_id() instead of has_post_thumbnail() This commit replaces all instances where has_post_thumbnail() was used with $product->get_image_id(). This is a continuation of 64b589f0325a729a1914942801f4b2cae929e013 and is needed to support the custom product tables plugin as has_post_thumbnail() relies on a post meta. --- .../api/class-wc-rest-product-variations-controller.php | 2 +- includes/api/class-wc-rest-products-controller.php | 2 +- includes/api/v1/class-wc-rest-products-controller.php | 2 +- includes/api/v2/class-wc-rest-products-v2-controller.php | 2 +- includes/wc-template-functions.php | 2 +- templates/single-product/product-image.php | 6 +++--- templates/single-product/product-thumbnails.php | 4 ++-- 7 files changed, 10 insertions(+), 10 deletions(-) diff --git a/includes/api/class-wc-rest-product-variations-controller.php b/includes/api/class-wc-rest-product-variations-controller.php index 157e1ca52c6..f478269b48b 100644 --- a/includes/api/class-wc-rest-product-variations-controller.php +++ b/includes/api/class-wc-rest-product-variations-controller.php @@ -314,7 +314,7 @@ class WC_REST_Product_Variations_Controller extends WC_REST_Product_Variations_V * @return array */ protected function get_image( $variation ) { - if ( ! has_post_thumbnail( $variation->get_id() ) ) { + if ( ! $variation->get_image_id() ) { return; } diff --git a/includes/api/class-wc-rest-products-controller.php b/includes/api/class-wc-rest-products-controller.php index ea5d04775be..d064fd74e92 100644 --- a/includes/api/class-wc-rest-products-controller.php +++ b/includes/api/class-wc-rest-products-controller.php @@ -36,7 +36,7 @@ class WC_REST_Products_Controller extends WC_REST_Products_V2_Controller { $attachment_ids = array(); // Add featured image. - if ( has_post_thumbnail( $product->get_id() ) ) { + if ( $product->get_image_id() ) { $attachment_ids[] = $product->get_image_id(); } diff --git a/includes/api/v1/class-wc-rest-products-controller.php b/includes/api/v1/class-wc-rest-products-controller.php index 13abb162724..92d755da896 100644 --- a/includes/api/v1/class-wc-rest-products-controller.php +++ b/includes/api/v1/class-wc-rest-products-controller.php @@ -273,7 +273,7 @@ class WC_REST_Products_V1_Controller extends WC_REST_Posts_Controller { $attachment_ids = array(); // Add featured image. - if ( has_post_thumbnail( $product->get_id() ) ) { + if ( $product->get_image_id() ) { $attachment_ids[] = $product->get_image_id(); } diff --git a/includes/api/v2/class-wc-rest-products-v2-controller.php b/includes/api/v2/class-wc-rest-products-v2-controller.php index 43912ce8265..0a9e5ecc868 100644 --- a/includes/api/v2/class-wc-rest-products-v2-controller.php +++ b/includes/api/v2/class-wc-rest-products-v2-controller.php @@ -367,7 +367,7 @@ class WC_REST_Products_V2_Controller extends WC_REST_Legacy_Products_Controller $attachment_ids = array(); // Add featured image. - if ( has_post_thumbnail( $product->get_id() ) ) { + if ( $product->get_image_id() ) { $attachment_ids[] = $product->get_image_id(); } diff --git a/includes/wc-template-functions.php b/includes/wc-template-functions.php index 52271c6f287..ad0066fde0d 100644 --- a/includes/wc-template-functions.php +++ b/includes/wc-template-functions.php @@ -603,7 +603,7 @@ function wc_get_product_class( $class = '', $product_id = null ) { } // Post thumbnails. - if ( current_theme_supports( 'post-thumbnails' ) && has_post_thumbnail( $post->ID ) && ! is_attachment( $post ) && ! $post_password_required ) { + if ( current_theme_supports( 'post-thumbnails' ) && $product->get_image_id() && ! is_attachment( $post ) && ! $post_password_required ) { $classes[] = 'has-post-thumbnail'; } diff --git a/templates/single-product/product-image.php b/templates/single-product/product-image.php index 10a977b470f..63a4addd153 100644 --- a/templates/single-product/product-image.php +++ b/templates/single-product/product-image.php @@ -12,7 +12,7 @@ * * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 3.5.0 + * @version 3.5.1 */ defined( 'ABSPATH' ) || exit; @@ -28,7 +28,7 @@ $columns = apply_filters( 'woocommerce_product_thumbnails_columns', 4 $post_thumbnail_id = $product->get_image_id(); $wrapper_classes = apply_filters( 'woocommerce_single_product_image_gallery_classes', array( 'woocommerce-product-gallery', - 'woocommerce-product-gallery--' . ( has_post_thumbnail() ? 'with-images' : 'without-images' ), + 'woocommerce-product-gallery--' . ( $product->get_image_id() ? 'with-images' : 'without-images' ), 'woocommerce-product-gallery--columns-' . absint( $columns ), 'images', ) ); @@ -36,7 +36,7 @@ $wrapper_classes = apply_filters( 'woocommerce_single_product_image_gallery_cl
      get_image_id() ) { $html = wc_get_gallery_image_html( $post_thumbnail_id, true ); } else { $html = '
      '; diff --git a/templates/single-product/product-thumbnails.php b/templates/single-product/product-thumbnails.php index 158de7fa8d0..6702e1a02b9 100644 --- a/templates/single-product/product-thumbnails.php +++ b/templates/single-product/product-thumbnails.php @@ -12,7 +12,7 @@ * * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 3.3.2 + * @version 3.5.1 */ defined( 'ABSPATH' ) || exit; @@ -26,7 +26,7 @@ global $product; $attachment_ids = $product->get_gallery_image_ids(); -if ( $attachment_ids && has_post_thumbnail() ) { +if ( $attachment_ids && $product->get_image_id() ) { foreach ( $attachment_ids as $attachment_id ) { echo apply_filters( 'woocommerce_single_product_image_thumbnail_html', wc_get_gallery_image_html( $attachment_id ), $attachment_id ); // phpcs:disable WordPress.XSS.EscapeOutput.OutputNotEscaped } From d987fb95b917401a7daf30b4cd7e1b55c1d72c95 Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Thu, 18 Oct 2018 16:04:54 -0300 Subject: [PATCH 074/361] [REST API] Register data endpoints --- includes/api/class-wc-rest-data-controller.php | 4 ---- includes/class-wc-api.php | 4 ++++ 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/includes/api/class-wc-rest-data-controller.php b/includes/api/class-wc-rest-data-controller.php index dd366af5774..216586510e6 100644 --- a/includes/api/class-wc-rest-data-controller.php +++ b/includes/api/class-wc-rest-data-controller.php @@ -96,10 +96,6 @@ class WC_REST_Data_Controller extends WC_REST_Controller { 'slug' => 'countries', 'description' => __( 'List of supported states in a given country.', 'woocommerce' ), ), - array( - 'slug' => 'counts', - 'description' => __( 'Information about the amount of various objects on this site.', 'woocommerce' ), - ), array( 'slug' => 'currencies', 'description' => __( 'List of supported currencies.', 'woocommerce' ), diff --git a/includes/class-wc-api.php b/includes/class-wc-api.php index 0711f420b29..a63e6aed598 100644 --- a/includes/class-wc-api.php +++ b/includes/class-wc-api.php @@ -342,6 +342,10 @@ class WC_API extends WC_Legacy_API { 'WC_REST_System_Status_Tools_Controller', 'WC_REST_Shipping_Methods_Controller', 'WC_REST_Payment_Gateways_Controller', + 'WC_REST_Data_Controller', + 'WC_REST_Data_Continents_Controller', + 'WC_REST_Data_Countries_Controller', + 'WC_REST_Data_Currencies_Controller', ); foreach ( $controllers as $controller ) { From 17a80c863e2ff89acf5aa1433c25e26cd37ba352 Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Thu, 18 Oct 2018 18:13:21 -0300 Subject: [PATCH 075/361] [REST API] Fixed product reviews schema and content --- includes/api/class-wc-rest-product-reviews-controller.php | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/includes/api/class-wc-rest-product-reviews-controller.php b/includes/api/class-wc-rest-product-reviews-controller.php index fd7ae85d3c8..2af5d648738 100644 --- a/includes/api/class-wc-rest-product-reviews-controller.php +++ b/includes/api/class-wc-rest-product-reviews-controller.php @@ -743,7 +743,7 @@ class WC_REST_Product_Reviews_Controller extends WC_REST_Controller { } if ( isset( $request['review'] ) ) { - $prepared_review['comment_content'] = $request['review']; + $prepared_review['comment_content'] = wp_filter_post_kses( $request['review'] ); } if ( isset( $request['product_id'] ) ) { @@ -847,11 +847,11 @@ class WC_REST_Product_Reviews_Controller extends WC_REST_Controller { ), 'product_id' => array( 'description' => __( 'Unique identifier for the product that the review belongs to.', 'woocommerce' ), - 'type' => 'string', + 'type' => 'integer', 'context' => array( 'view', 'edit' ), ), 'status' => array( - 'description' => __( 'Status of the review', 'woocommerce' ), + 'description' => __( 'Status of the review.', 'woocommerce' ), 'type' => 'string', 'default' => 'approved', 'enum' => array( 'approved', 'hold', 'spam', 'unspam', 'trash', 'untrash' ), From f3fdcd2ec0f8fc9eddd0efc5944f1344ea3822f5 Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Thu, 18 Oct 2018 18:17:15 -0300 Subject: [PATCH 076/361] Fixed order or collection params --- ...ass-wc-rest-product-reviews-controller.php | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/includes/api/class-wc-rest-product-reviews-controller.php b/includes/api/class-wc-rest-product-reviews-controller.php index 2af5d648738..100b20bdf28 100644 --- a/includes/api/class-wc-rest-product-reviews-controller.php +++ b/includes/api/class-wc-rest-product-reviews-controller.php @@ -926,26 +926,6 @@ class WC_REST_Product_Reviews_Controller extends WC_REST_Controller { 'type' => 'string', 'format' => 'date-time', ); - $params['reviewer'] = array( - 'description' => __( 'Limit result set to reviews assigned to specific user IDs.', 'woocommerce' ), - 'type' => 'array', - 'items' => array( - 'type' => 'integer', - ), - ); - $params['reviewer_exclude'] = array( - 'description' => __( 'Ensure result set excludes reviews assigned to specific user IDs.', 'woocommerce' ), - 'type' => 'array', - 'items' => array( - 'type' => 'integer', - ), - ); - $params['reviewer_email'] = array( - 'default' => null, - 'description' => __( 'Limit result set to that from a specific author email.', 'woocommerce' ), - 'format' => 'email', - 'type' => 'string', - ); $params['before'] = array( 'description' => __( 'Limit response to reviews published before a given ISO8601 compliant date.', 'woocommerce' ), 'type' => 'string', @@ -992,6 +972,26 @@ class WC_REST_Product_Reviews_Controller extends WC_REST_Controller { 'product', ), ); + $params['reviewer'] = array( + 'description' => __( 'Limit result set to reviews assigned to specific user IDs.', 'woocommerce' ), + 'type' => 'array', + 'items' => array( + 'type' => 'integer', + ), + ); + $params['reviewer_exclude'] = array( + 'description' => __( 'Ensure result set excludes reviews assigned to specific user IDs.', 'woocommerce' ), + 'type' => 'array', + 'items' => array( + 'type' => 'integer', + ), + ); + $params['reviewer_email'] = array( + 'default' => null, + 'description' => __( 'Limit result set to that from a specific author email.', 'woocommerce' ), + 'format' => 'email', + 'type' => 'string', + ); $params['product'] = array( 'default' => array(), 'description' => __( 'Limit result set to reviews assigned to specific product IDs.', 'woocommerce' ), From bd37853923faf44c1f62d3dccee0d3a6d2f9e45b Mon Sep 17 00:00:00 2001 From: Claudio Sanches Date: Thu, 18 Oct 2018 18:53:16 -0300 Subject: [PATCH 077/361] Improved review and reviewer_email --- includes/api/class-wc-rest-product-reviews-controller.php | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/includes/api/class-wc-rest-product-reviews-controller.php b/includes/api/class-wc-rest-product-reviews-controller.php index 100b20bdf28..98e66734fb9 100644 --- a/includes/api/class-wc-rest-product-reviews-controller.php +++ b/includes/api/class-wc-rest-product-reviews-controller.php @@ -743,7 +743,7 @@ class WC_REST_Product_Reviews_Controller extends WC_REST_Controller { } if ( isset( $request['review'] ) ) { - $prepared_review['comment_content'] = wp_filter_post_kses( $request['review'] ); + $prepared_review['comment_content'] = $request['review']; } if ( isset( $request['product_id'] ) ) { @@ -865,12 +865,16 @@ class WC_REST_Product_Reviews_Controller extends WC_REST_Controller { 'reviewer_email' => array( 'description' => __( 'Reviewer email.', 'woocommerce' ), 'type' => 'string', + 'format' => 'email', 'context' => array( 'view', 'edit' ), ), 'review' => array( 'description' => __( 'The content of the review.', 'woocommerce' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), + 'arg_options' => array( + 'sanitize_callback' => 'wp_filter_post_kses', + ), ), 'rating' => array( 'description' => __( 'Review rating (0 to 5).', 'woocommerce' ), From 566c57cc45af891b50d0c580df418e13a0c38fff Mon Sep 17 00:00:00 2001 From: Menaka S Date: Fri, 19 Oct 2018 16:43:52 +0530 Subject: [PATCH 078/361] Trim the import file headers while reading --- includes/import/class-wc-product-csv-importer.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/import/class-wc-product-csv-importer.php b/includes/import/class-wc-product-csv-importer.php index e7ff49a7645..eb546efafdc 100644 --- a/includes/import/class-wc-product-csv-importer.php +++ b/includes/import/class-wc-product-csv-importer.php @@ -70,7 +70,7 @@ class WC_Product_CSV_Importer extends WC_Product_Importer { $handle = fopen( $this->file, 'r' ); // @codingStandardsIgnoreLine. if ( false !== $handle ) { - $this->raw_keys = version_compare( PHP_VERSION, '5.3', '>=' ) ? fgetcsv( $handle, 0, $this->params['delimiter'], $this->params['enclosure'], $this->params['escape'] ) : fgetcsv( $handle, 0, $this->params['delimiter'], $this->params['enclosure'] ); // @codingStandardsIgnoreLine + $this->raw_keys = version_compare( PHP_VERSION, '5.3', '>=' ) ? array_map( 'trim', fgetcsv( $handle, 0, $this->params['delimiter'], $this->params['enclosure'], $this->params['escape'] ) ) : array_map( 'trim', fgetcsv( $handle, 0, $this->params['delimiter'], $this->params['enclosure'] ) ); // @codingStandardsIgnoreLine // Remove BOM signature from the first item. if ( isset( $this->raw_keys[0] ) ) { From b68cef206294d7f27d1418ca456d574d989221bf Mon Sep 17 00:00:00 2001 From: Towhidul Islam Date: Fri, 19 Oct 2018 20:41:20 +0600 Subject: [PATCH 079/361] [REST API] pass missing $filter as parameter in get_order_refund --- includes/api/legacy/v2/class-wc-api-orders.php | 5 +++-- includes/api/legacy/v3/class-wc-api-orders.php | 3 ++- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/includes/api/legacy/v2/class-wc-api-orders.php b/includes/api/legacy/v2/class-wc-api-orders.php index f5d25339cb0..de7b3850bc2 100644 --- a/includes/api/legacy/v2/class-wc-api-orders.php +++ b/includes/api/legacy/v2/class-wc-api-orders.php @@ -1492,11 +1492,12 @@ class WC_API_Orders extends WC_API_Resource { * * @param string $order_id order ID * @param int $id - * @param string $fields fields to limit response to + * @param string|null $fields fields to limit response to + * @param array $filter * * @return array|WP_Error */ - public function get_order_refund( $order_id, $id, $fields = null ) { + public function get_order_refund( $order_id, $id, $fields = null, $filter = array() ) { try { // Validate order ID $order_id = $this->validate_request( $order_id, $this->post_type, 'read' ); diff --git a/includes/api/legacy/v3/class-wc-api-orders.php b/includes/api/legacy/v3/class-wc-api-orders.php index 046e4dd2b25..6cfdfba8627 100644 --- a/includes/api/legacy/v3/class-wc-api-orders.php +++ b/includes/api/legacy/v3/class-wc-api-orders.php @@ -1538,10 +1538,11 @@ class WC_API_Orders extends WC_API_Resource { * @param string $order_id order ID * @param int $id * @param string|null $fields fields to limit response to + * @param array $filter * * @return array|WP_Error */ - public function get_order_refund( $order_id, $id, $fields = null ) { + public function get_order_refund( $order_id, $id, $fields = null, $filter = array() ) { try { // Validate order ID $order_id = $this->validate_request( $order_id, $this->post_type, 'read' ); From b49a9a58091613e006d281beee230c05bd93431a Mon Sep 17 00:00:00 2001 From: claudiulodro Date: Fri, 19 Oct 2018 10:49:58 -0700 Subject: [PATCH 080/361] Tweaks to unsupported theme handling and hidden preview button handling --- .../admin/meta-boxes/views/html-product-data-panel.php | 9 ++++++--- includes/class-wc-shortcodes.php | 2 +- includes/class-wc-template-loader.php | 2 +- 3 files changed, 8 insertions(+), 5 deletions(-) diff --git a/includes/admin/meta-boxes/views/html-product-data-panel.php b/includes/admin/meta-boxes/views/html-product-data-panel.php index 6decb5c6046..f5b4987a6bb 100644 --- a/includes/admin/meta-boxes/views/html-product-data-panel.php +++ b/includes/admin/meta-boxes/views/html-product-data-panel.php @@ -9,9 +9,12 @@ if ( ! defined( 'ABSPATH' ) ) { exit; } ?> - + + + +
      +
      + + + data-plugins="" + /> + +
      + + is_featured_service( $service ); + } + + /** + * Payment Step. + */ + public function wc_setup_payment() { + $featured_gateways = array_filter( $this->get_wizard_in_cart_payment_gateways(), array( $this, 'is_featured_service' ) ); + $in_cart_gateways = array_filter( $this->get_wizard_in_cart_payment_gateways(), array( $this, 'is_not_featured_service' ) ); + $manual_gateways = $this->get_wizard_manual_payment_gateways(); + ?> +

      + +

      + Additional payment methods can be installed later.', 'woocommerce' ), + array( + 'a' => array( + 'href' => array(), + 'target' => array(), + ), + ) + ), + esc_url( admin_url( 'admin.php?page=wc-addons§ion=payment-gateways' ) ) + ); + ?> +

      + +
        + $gateway ) { + $this->display_service_item( $gateway_id, $gateway ); + } + ?> +
      + + +
        + $gateway ) { + $this->display_service_item( $gateway_id, $gateway ); + } + ?> +
      + +
        +
      • +
        + +
        +
        + +
        +
        + + +
        +
        • + $gateway ) { + $this->display_service_item( $gateway_id, $gateway ); + } + ?>

      - - + plugin_install_info(); ?> +

      @@ -823,129 +1767,558 @@ class WC_Admin_Setup_Wizard { } /** - * Payments Step save. + * Payment Step save. */ - public function wc_setup_payments_save() { + public function wc_setup_payment_save() { check_admin_referer( 'wc-setup' ); - $gateways = $this->get_wizard_payment_gateways(); + if ( + ( + // Install WooCommerce Services with Stripe to enable deferred account creation. + ! empty( $_POST['wc-wizard-service-stripe-enabled'] ) && // WPCS: CSRF ok, input var ok. + ! empty( $_POST['stripe_create_account'] ) // WPCS: CSRF ok, input var ok. + ) || ( + // Install WooCommerce Services with PayPal EC to enable proxied payments. + ! empty( $_POST['wc-wizard-service-ppec_paypal-enabled'] ) && // WPCS: CSRF ok, input var ok. + ! empty( $_POST['ppec_paypal_reroute_requests'] ) // WPCS: CSRF ok, input var ok. + ) + ) { + $this->install_woocommerce_services(); + } + + $gateways = array_merge( $this->get_wizard_in_cart_payment_gateways(), $this->get_wizard_manual_payment_gateways() ); foreach ( $gateways as $gateway_id => $gateway ) { // If repo-slug is defined, download and install plugin from .org. - if ( ! empty( $gateway['repo-slug'] ) && ! empty( $_POST[ 'wc-wizard-gateway-' . $gateway_id . '-enabled' ] ) ) { - wp_schedule_single_event( time() + 10, 'woocommerce_plugin_background_installer', array( $gateway_id, $gateway ) ); + if ( ! empty( $gateway['repo-slug'] ) && ! empty( $_POST[ 'wc-wizard-service-' . $gateway_id . '-enabled' ] ) ) { // WPCS: CSRF ok, input var ok. + $this->install_plugin( $gateway_id, $gateway ); } - $settings_key = 'woocommerce_' . $gateway_id . '_settings'; - $settings = array_filter( (array) get_option( $settings_key, array() ) ); - $settings['enabled'] = ! empty( $_POST[ 'wc-wizard-gateway-' . $gateway_id . '-enabled' ] ) ? 'yes' : 'no'; + $settings = array( 'enabled' => ! empty( $_POST[ 'wc-wizard-service-' . $gateway_id . '-enabled' ] ) ? 'yes' : 'no' ); // WPCS: CSRF ok, input var ok. + // @codingStandardsIgnoreStart if ( ! empty( $gateway['settings'] ) ) { foreach ( $gateway['settings'] as $setting_id => $setting ) { - $settings[ $setting_id ] = wc_clean( $_POST[ $gateway_id . '_' . $setting_id ] ); + $settings[ $setting_id ] = 'yes' === $settings['enabled'] && isset( $_POST[ $gateway_id . '_' . $setting_id ] ) + ? wc_clean( wp_unslash( $_POST[ $gateway_id . '_' . $setting_id ] ) ) + : false; } } + // @codingStandardsIgnoreSEnd - update_option( $settings_key, $settings ); + if ( 'ppec_paypal' === $gateway_id && empty( $settings['reroute_requests'] ) ) { + unset( $settings['enabled'] ); + } + + $settings_key = 'woocommerce_' . $gateway_id . '_settings'; + $previously_saved_settings = array_filter( (array) get_option( $settings_key, array() ) ); + update_option( $settings_key, array_merge( $previously_saved_settings, $settings ) ); } wp_redirect( esc_url_raw( $this->get_next_step_link() ) ); exit; } - /** - * Theme step. - */ - private function wc_setup_theme() { + protected function display_recommended_item( $item_info ) { + $type = $item_info['type']; + $title = $item_info['title']; + $description = $item_info['description']; + $img_url = $item_info['img_url']; + $img_alt = $item_info['img_alt']; ?> -
      -

      - Storefront is the free WordPress theme built and maintained by the makers of WooCommerce.', 'woocommerce' ) ); ?> - Storefront -

      +
    1. + + +
      2. + -
    2. Bulletproof WooCommerce integration: Rest assured the integration between WooCommerce, WooCommerce extensions and Storefront is water-tight.', 'woocommerce' ) ); ?>
      3. -
    3. Built with accessibility in mind: Storefront adheres to the strict wordpress.org accessibility guidelines making your store accessible to the widest audience possible.', 'woocommerce' ) ); ?>
      4. -
    4. Child themes and extensions available: Like WooCommerce, you can extend Storefront with an extension or child theme to make your store truly your own.', 'woocommerce' ) ); ?>
      5. -
    5. No Shortcodes, sliders or page builders: Bring your favorite sliders or page builders, Storefront is built to work with the most popular options.', 'woocommerce' ) ); ?>
      6. -
    6. Clean, simple mobile-first design: The perfect place to start when customizing your store, looks beautiful on any device.', 'woocommerce' ) ); ?>
      7. -
    7. Optimized for search: Valid schema markup for improved SEO performance.', 'woocommerce' ) ); ?>
      8. - + /** + * Recommended step + */ + public function wc_setup_recommended() { + ?> +

      +

      should_show_theme() + && $this->should_show_automated_tax() + && $this->should_show_mailchimp() + ) : + esc_html_e( 'Select from the list below to enable automated taxes and MailChimp’s best-in-class email services — and design your store with our official, free WooCommerce theme.', 'woocommerce' ); + else : + esc_html_e( 'Enhance your store with these recommended features.', 'woocommerce' ); + endif; + ?>

      + +
        + should_show_theme() ) : + $theme = wp_get_theme(); + $theme_name = $theme['Name']; + $this->display_recommended_item( array( + 'type' => 'storefront_theme', + 'title' => __( 'Storefront Theme', 'woocommerce' ), + 'description' => sprintf( __( + 'Design your store with deep WooCommerce integration. If toggled on, we’ll install Storefront, and your current theme %s will be deactivated.', 'woocommerce' ), + $theme_name + ), + 'img_url' => WC()->plugin_url() . '/assets/images/obw-storefront-icon.svg', + 'img_alt' => __( 'Storefront icon', 'woocommerce' ), + ) ); + endif; + + if ( $this->should_show_automated_tax() ) : + $this->display_recommended_item( array( + 'type' => 'automated_taxes', + 'title' => __( 'Automated Taxes', 'woocommerce' ), + 'description' => __( 'Save time and errors with automated tax calculation and collection at checkout. Powered by WooCommerce Services and Jetpack.', 'woocommerce' ), + 'img_url' => WC()->plugin_url() . '/assets/images/obw-taxes-icon.svg', + 'img_alt' => __( 'automated taxes icon', 'woocommerce' ), + 'plugins' => $this->get_wcs_requisite_plugins(), + ) ); + endif; + + if ( $this->should_show_mailchimp() ) : + $this->display_recommended_item( array( + 'type' => 'mailchimp', + 'title' => __( 'MailChimp', 'woocommerce' ), + 'description' => __( 'Join the 16 million customers who use MailChimp. Sync list and store data to send automated emails, and targeted campaigns.', 'woocommerce' ), + 'img_url' => WC()->plugin_url() . '/assets/images/obw-mailchimp-icon.svg', + 'img_alt' => __( 'MailChimp icon', 'woocommerce' ), + 'plugins' => array( array( 'name' => __( 'MailChimp for WooCommerce', 'woocommerce' ), 'slug' => 'mailchimp-for-woocommerce' ) ), + ) ); + endif; + ?> +

      - - + plugin_install_info(); ?> +

      install_theme( 'storefront' ); + } + + if ( $setup_automated_tax ) { + $this->install_woocommerce_services(); + } + + if ( $setup_mailchimp ) { + // Prevent MailChimp from redirecting to its settings page during the OBW flow. + add_option( 'mailchimp_woocommerce_plugin_do_activation_redirect', false ); + + $this->install_plugin( + 'mailchimp-for-woocommerce', + array( + 'name' => __( 'MailChimp for WooCommerce', 'woocommerce' ), + 'repo-slug' => 'mailchimp-for-woocommerce', + 'file' => 'mailchimp-woocommerce.php', + ) + ); + } + wp_redirect( esc_url_raw( $this->get_next_step_link() ) ); exit; } /** - * Actions on the final step. + * Go to the next step if Jetpack was connected. */ - private function wc_setup_ready_actions() { - WC_Admin_Notices::remove_notice( 'install' ); - - if ( isset( $_GET['wc_tracker_optin'] ) && isset( $_GET['wc_tracker_nonce'] ) && wp_verify_nonce( $_GET['wc_tracker_nonce'], 'wc_tracker_optin' ) ) { - update_option( 'woocommerce_allow_tracking', 'yes' ); - WC_Tracker::send_tracking_data( true ); - - } elseif ( isset( $_GET['wc_tracker_optout'] ) && isset( $_GET['wc_tracker_nonce'] ) && wp_verify_nonce( $_GET['wc_tracker_nonce'], 'wc_tracker_optout' ) ) { - update_option( 'woocommerce_allow_tracking', 'no' ); + protected function wc_setup_activate_actions() { + if ( + isset( $_GET['from'] ) && + 'wpcom' === $_GET['from'] && + class_exists( 'Jetpack' ) && + Jetpack::is_active() + ) { + wp_redirect( esc_url_raw( remove_query_arg( 'from', $this->get_next_step_link() ) ) ); + exit; } } + protected function wc_setup_activate_get_feature_list() { + $features = array(); + + $stripe_settings = get_option( 'woocommerce_stripe_settings', false ); + $stripe_enabled = is_array( $stripe_settings ) + && isset( $stripe_settings['create_account'] ) && 'yes' === $stripe_settings['create_account'] + && isset( $stripe_settings['enabled'] ) && 'yes' === $stripe_settings['enabled']; + $ppec_settings = get_option( 'woocommerce_ppec_paypal_settings', false ); + $ppec_enabled = is_array( $ppec_settings ) + && isset( $ppec_settings['reroute_requests'] ) && 'yes' === $ppec_settings['reroute_requests'] + && isset( $ppec_settings['enabled'] ) && 'yes' === $ppec_settings['enabled']; + + $features['payment'] = $stripe_enabled || $ppec_enabled; + $features['taxes'] = (bool) get_option( 'woocommerce_setup_automated_taxes', false ); + $features['labels'] = (bool) get_option( 'woocommerce_setup_shipping_labels', false ); + + return $features; + } + + protected function wc_setup_activate_get_feature_list_str() { + $features = $this->wc_setup_activate_get_feature_list(); + if ( $features['payment'] && $features['taxes'] && $features['labels'] ) { + return __( 'payment setup, automated taxes and discounted shipping labels', 'woocommerce' ); + } else if ( $features['payment'] && $features['taxes'] ) { + return __( 'payment setup and automated taxes', 'woocommerce' ); + } else if ( $features['payment'] && $features['labels'] ) { + return __( 'payment setup and discounted shipping labels', 'woocommerce' ); + } else if ( $features['payment'] ) { + return __( 'payment setup', 'woocommerce' ); + } else if ( $features['taxes'] && $features['labels'] ) { + return __( 'automated taxes and discounted shipping labels', 'woocommerce' ); + } else if ( $features['taxes'] ) { + return __( 'automated taxes', 'woocommerce' ); + } else if ( $features['labels'] ) { + return __( 'discounted shipping labels', 'woocommerce' ); + } + return false; + } + + /** + * Activate step. + */ + public function wc_setup_activate() { + $this->wc_setup_activate_actions(); + + $jetpack_connected = class_exists( 'Jetpack' ) && Jetpack::is_active(); + + $has_jetpack_error = false; + if ( isset( $_GET['activate_error'] ) ) { + $has_jetpack_error = true; + + $title = __( "Sorry, we couldn't connect your store to Jetpack", 'woocommerce' ); + + $error_message = $this->get_activate_error_message( sanitize_text_field( wp_unslash( $_GET['activate_error'] ) ) ); + $description = $error_message; + } else { + $feature_list = $this->wc_setup_activate_get_feature_list_str(); + + $description = false; + + if ( $feature_list ) { + if ( ! $jetpack_connected ) { + /* translators: %s: list of features, potentially comma separated */ + $description_base = __( 'Your store is almost ready! To activate services like %s, just connect with Jetpack.', 'woocommerce' ); + } else { + $description_base = __( 'Thanks for using Jetpack! Your store is almost ready: to activate services like %s, just connect your store.', 'woocommerce' ); + } + $description = sprintf( $description_base, $feature_list ); + } + + if ( ! $jetpack_connected ) { + $title = $feature_list ? + __( 'Connect your store to Jetpack', 'woocommerce' ) : + __( 'Connect your store to Jetpack to enable extra features', 'woocommerce' ); + $button_text = __( 'Continue with Jetpack', 'woocommerce' ); + } elseif ( $feature_list ) { + $title = __( 'Connect your store to activate WooCommerce Services', 'woocommerce' ); + $button_text = __( 'Continue with WooCommerce Services', 'woocommerce' ); + } else { + wp_redirect( esc_url_raw( $this->get_next_step_link() ) ); + exit; + } + } + ?> +

      +

      + + +
      + + +
      + + + + + +

      + + + +

      + +

      + Terms of Service and to share details with WordPress.com', 'woocommerce' ) ), + 'https://wordpress.com/tos', + 'https://jetpack.com/support/what-data-does-jetpack-sync' + ); + ?> +

      +
      +

      + +

      + + +
      + +

      + +

      +
        +
      • +

        + +

        +

        + +

        +
        • +
      • +

        + +

        +

        + +

        +
        • +
      • +

        + +

        +

        + +

        +
        • +
      • +

        + +

        +

        + +

        +
        • +
      + + + __( "Sorry! We tried, but we couldn't connect Jetpack just now 😭. Please go to the Plugins tab to connect Jetpack, so that you can finish setting up your store.", 'woocommerce' ), + 'jetpack_cant_be_installed' => __( "Sorry! We tried, but we couldn't install Jetpack for you 😭. Please go to the Plugins tab to install it, and finish setting up your store.", 'woocommerce' ), + 'register_http_request_failed' => __( "Sorry! We couldn't contact Jetpack just now 😭. Please make sure that your site is visible over the internet, and that it accepts incoming and outgoing requests via curl. You can also try to connect to Jetpack again, and if you run into any more issues, please contact support.", 'woocommerce' ), + 'siteurl_private_ip_dev' => __( "Your site might be on a private network. Jetpack can only connect to public sites. Please make sure your site is visible over the internet, and then try connecting again 🙏." , 'woocommerce' ), + ); + } + + protected function get_activate_error_message( $code = '' ) { + $errors = $this->get_all_activate_errors(); + return array_key_exists( $code, $errors ) ? $errors[ $code ] : $errors['default']; + } + + /** + * Activate step save. + * + * Install, activate, and launch connection flow for Jetpack. + */ + public function wc_setup_activate_save() { + check_admin_referer( 'wc-setup' ); + + set_transient( 'wc_setup_activated', 'yes', MINUTE_IN_SECONDS * 10 ); + + // Leave a note for WooCommerce Services that Jetpack has been opted into. + update_option( 'woocommerce_setup_jetpack_opted_in', true ); + + if ( class_exists( 'Jetpack' ) && Jetpack::is_active() ) { + wp_safe_redirect( esc_url_raw( $this->get_next_step_link() ) ); + exit; + } + + WC_Install::background_installer( 'jetpack', array( + 'name' => __( 'Jetpack', 'woocommerce' ), + 'repo-slug' => 'jetpack', + ) ); + + // Did Jetpack get successfully installed? + if ( ! class_exists( 'Jetpack' ) ) { + wp_redirect( esc_url_raw( add_query_arg( 'activate_error', 'jetpack_cant_be_installed' ) ) ); + exit; + } + + Jetpack::maybe_set_version_option(); + $register_result = Jetpack::try_registration(); + + if ( is_wp_error( $register_result ) ) { + $result_error_code = $register_result->get_error_code(); + $jetpack_error_code = array_key_exists( $result_error_code, $this->get_all_activate_errors() ) ? $result_error_code : 'register'; + wp_redirect( esc_url_raw( add_query_arg( 'activate_error', $jetpack_error_code ) ) ); + exit; + } + + $redirect_url = esc_url_raw( add_query_arg( array( + 'page' => 'wc-setup', + 'step' => 'activate', + 'from' => 'wpcom', + 'activate_error' => false, + ), admin_url() ) ); + $connection_url = Jetpack::init()->build_connect_url( true, $redirect_url, 'woocommerce-setup-wizard' ); + + wp_redirect( esc_url_raw( $connection_url ) ); + exit; + } + /** * Final step. */ public function wc_setup_ready() { - $this->wc_setup_ready_actions(); - shuffle( $this->tweets ); + // We've made it! Don't prompt the user to run the wizard again. + WC_Admin_Notices::remove_notice( 'install' ); + + $user_email = $this->get_current_user_email(); + $videos_url = 'https://docs.woocommerce.com/document/woocommerce-guided-tour-videos/?utm_source=setupwizard&utm_medium=product&utm_content=videos&utm_campaign=woocommerceplugin'; + $docs_url = 'https://docs.woocommerce.com/documentation/plugins/woocommerce/getting-started/?utm_source=setupwizard&utm_medium=product&utm_content=docs&utm_campaign=woocommerceplugin'; + $help_text = sprintf( + /* translators: %1$s: link to videos, %2$s: link to docs */ + __( 'Watch our guided tour videos to learn more about WooCommerce, and visit WooCommerce.com to learn more about getting started.', 'woocommerce' ), + $videos_url, + $docs_url + ); ?> - - +

      -

      - - -
      -

      ', '' ); ?>

      -

      - - -

      -
      - - -
      -
      -

      -
        -
        • -
        • -
      -
      -
      -

      -
        -
        • - -
        • -
      -
      +
      +

      +
      + +
      + + +

      execute_tool( $action ); + + $tool = $tools[ $action ]; + $tool = array( + 'id' => $action, + 'name' => $tool['name'], + 'action' => $tool['button'], + 'description' => $tool['desc'], + ); + $tool = array_merge( $tool, $response ); + + /** + * Fires after a WooCommerce system status tool has been executed. + * + * @param array $tool Details about the tool that has been executed. + */ + do_action( 'woocommerce_system_status_tool_executed', $tool ); } else { - $response = array( 'success' => false, 'message' => __( 'Tool does not exist.', 'woocommerce' ) ); + $response = array( + 'success' => false, + 'message' => __( 'Tool does not exist.', 'woocommerce' ), + ); } if ( $response['success'] ) { @@ -54,20 +69,21 @@ class WC_Admin_Status { } } - // Display message if settings settings have been saved - if ( isset( $_REQUEST['settings-updated'] ) ) { - echo '

      ' . __( 'Your changes have been saved.', 'woocommerce' ) . '

      '; + // Display message if settings settings have been saved. + if ( isset( $_REQUEST['settings-updated'] ) ) { // WPCS: input var ok. + echo '

      ' . esc_html__( 'Your changes have been saved.', 'woocommerce' ) . '

      '; } - include_once( dirname( __FILE__ ) . '/views/html-admin-page-status-tools.php' ); + include_once dirname( __FILE__ ) . '/views/html-admin-page-status-tools.php'; } /** * Get tools. + * * @return array of tools */ public static function get_tools() { - $tools_controller = new WC_REST_System_Status_Tools_Controller; + $tools_controller = new WC_REST_System_Status_Tools_Controller(); return $tools_controller->get_tools(); } @@ -86,66 +102,63 @@ class WC_Admin_Status { * Show the log page contents for file log handler. */ public static function status_logs_file() { - $logs = self::scan_log_files(); - if ( ! empty( $_REQUEST['log_file'] ) && isset( $logs[ sanitize_title( $_REQUEST['log_file'] ) ] ) ) { - $viewed_log = $logs[ sanitize_title( $_REQUEST['log_file'] ) ]; + if ( ! empty( $_REQUEST['log_file'] ) && isset( $logs[ sanitize_title( wp_unslash( $_REQUEST['log_file'] ) ) ] ) ) { // WPCS: input var ok, CSRF ok. + $viewed_log = $logs[ sanitize_title( wp_unslash( $_REQUEST['log_file'] ) ) ]; // WPCS: input var ok, CSRF ok. } elseif ( ! empty( $logs ) ) { $viewed_log = current( $logs ); } $handle = ! empty( $viewed_log ) ? self::get_log_file_handle( $viewed_log ) : ''; - if ( ! empty( $_REQUEST['handle'] ) ) { + if ( ! empty( $_REQUEST['handle'] ) ) { // WPCS: input var ok, CSRF ok. self::remove_log(); } - include_once( 'views/html-admin-page-status-logs.php' ); + include_once 'views/html-admin-page-status-logs.php'; } /** * Show the log page contents for db log handler. */ public static function status_logs_db() { - - // Flush - if ( ! empty( $_REQUEST['flush-logs'] ) ) { + if ( ! empty( $_REQUEST['flush-logs'] ) ) { // WPCS: input var ok, CSRF ok. self::flush_db_logs(); } - // Bulk actions - if ( isset( $_GET['action'] ) && isset( $_GET['log'] ) ) { + if ( isset( $_REQUEST['action'] ) && isset( $_REQUEST['log'] ) ) { // WPCS: input var ok, CSRF ok. self::log_table_bulk_actions(); } $log_table_list = new WC_Admin_Log_Table_List(); $log_table_list->prepare_items(); - include_once( 'views/html-admin-page-status-logs-db.php' ); + include_once 'views/html-admin-page-status-logs-db.php'; } /** * Retrieve metadata from a file. Based on WP Core's get_file_data function. + * * @since 2.1.1 - * @param string $file Path to the file + * @param string $file Path to the file. * @return string */ public static function get_file_version( $file ) { - // Avoid notices if file does not exist + // Avoid notices if file does not exist. if ( ! file_exists( $file ) ) { return ''; } // We don't need to write to the file, so just open for reading. - $fp = fopen( $file, 'r' ); + $fp = fopen( $file, 'r' ); // @codingStandardsIgnoreLine. // Pull only the first 8kiB of the file in. - $file_data = fread( $fp, 8192 ); + $file_data = fread( $fp, 8192 ); // @codingStandardsIgnoreLine. // PHP will close file handle, but we are good citizens. - fclose( $fp ); + fclose( $fp ); // @codingStandardsIgnoreLine. // Make sure we catch CR-only line endings. $file_data = str_replace( "\r", "\n", $file_data ); @@ -155,34 +168,34 @@ class WC_Admin_Status { $version = _cleanup_header_comment( $match[1] ); } - return $version ; + return $version; } /** * Return the log file handle. * - * @param string $filename + * @param string $filename Filename to get the handle for. * @return string */ public static function get_log_file_handle( $filename ) { - return substr( $filename, 0, strlen( $filename ) > 37 ? strlen( $filename ) - 37 : strlen( $filename ) - 4 ); + return substr( $filename, 0, strlen( $filename ) > 48 ? strlen( $filename ) - 48 : strlen( $filename ) - 4 ); } /** * Scan the template files. - * @param string $template_path + * + * @param string $template_path Path to the template directory. * @return array */ public static function scan_template_files( $template_path ) { - - $files = @scandir( $template_path ); + $files = @scandir( $template_path ); // @codingStandardsIgnoreLine. $result = array(); if ( ! empty( $files ) ) { foreach ( $files as $key => $value ) { - if ( ! in_array( $value, array( ".", ".." ) ) ) { + if ( ! in_array( $value, array( '.', '..' ), true ) ) { if ( is_dir( $template_path . DIRECTORY_SEPARATOR . $value ) ) { $sub_files = self::scan_template_files( $template_path . DIRECTORY_SEPARATOR . $value ); @@ -200,64 +213,58 @@ class WC_Admin_Status { /** * Scan the log files. + * * @return array */ public static function scan_log_files() { - $files = @scandir( WC_LOG_DIR ); - $result = array(); - - if ( ! empty( $files ) ) { - - foreach ( $files as $key => $value ) { - - if ( ! in_array( $value, array( '.', '..' ) ) ) { - if ( ! is_dir( $value ) && strstr( $value, '.log' ) ) { - $result[ sanitize_title( $value ) ] = $value; - } - } - } - } - - return $result; + return WC_Log_Handler_File::get_log_files(); } /** * Get latest version of a theme by slug. + * * @param object $theme WP_Theme object. * @return string Version number if found. */ public static function get_latest_theme_version( $theme ) { - include_once( ABSPATH . 'wp-admin/includes/theme.php' ); + include_once ABSPATH . 'wp-admin/includes/theme.php'; - $api = themes_api( 'theme_information', array( - 'slug' => $theme->get_stylesheet(), - 'fields' => array( - 'sections' => false, - 'tags' => false, - ), - ) ); + $api = themes_api( + 'theme_information', + array( + 'slug' => $theme->get_stylesheet(), + 'fields' => array( + 'sections' => false, + 'tags' => false, + ), + ) + ); $update_theme_version = 0; // Check .org for updates. if ( is_object( $api ) && ! is_wp_error( $api ) ) { $update_theme_version = $api->version; + } elseif ( strstr( $theme->{'Author URI'}, 'woothemes' ) ) { // Check WooThemes Theme Version. + $theme_dir = substr( strtolower( str_replace( ' ', '', $theme->Name ) ), 0, 45 ); // @codingStandardsIgnoreLine. + $theme_version_data = get_transient( $theme_dir . '_version_data' ); - // Check WooThemes Theme Version. - } elseif ( strstr( $theme->{'Author URI'}, 'woothemes' ) ) { - $theme_dir = substr( strtolower( str_replace( ' ','', $theme->Name ) ), 0, 45 ); - - if ( false === ( $theme_version_data = get_transient( $theme_dir . '_version_data' ) ) ) { + if ( false === $theme_version_data ) { $theme_changelog = wp_safe_remote_get( 'http://dzv365zjfbd8v.cloudfront.net/changelogs/' . $theme_dir . '/changelog.txt' ); - $cl_lines = explode( "\n", wp_remote_retrieve_body( $theme_changelog ) ); + $cl_lines = explode( "\n", wp_remote_retrieve_body( $theme_changelog ) ); if ( ! empty( $cl_lines ) ) { foreach ( $cl_lines as $line_num => $cl_line ) { if ( preg_match( '/^[0-9]/', $cl_line ) ) { - $theme_date = str_replace( '.' , '-' , trim( substr( $cl_line , 0 , strpos( $cl_line , '-' ) ) ) ); - $theme_version = preg_replace( '~[^0-9,.]~' , '' ,stristr( $cl_line , "version" ) ); - $theme_update = trim( str_replace( "*" , "" , $cl_lines[ $line_num + 1 ] ) ); - $theme_version_data = array( 'date' => $theme_date , 'version' => $theme_version , 'update' => $theme_update , 'changelog' => $theme_changelog ); - set_transient( $theme_dir . '_version_data', $theme_version_data , DAY_IN_SECONDS ); + $theme_date = str_replace( '.', '-', trim( substr( $cl_line, 0, strpos( $cl_line, '-' ) ) ) ); + $theme_version = preg_replace( '~[^0-9,.]~', '', stristr( $cl_line, 'version' ) ); + $theme_update = trim( str_replace( '*', '', $cl_lines[ $line_num + 1 ] ) ); + $theme_version_data = array( + 'date' => $theme_date, + 'version' => $theme_version, + 'update' => $theme_update, + 'changelog' => $theme_changelog, + ); + set_transient( $theme_dir . '_version_data', $theme_version_data, DAY_IN_SECONDS ); break; } } @@ -276,13 +283,13 @@ class WC_Admin_Status { * Remove/delete the chosen file. */ public static function remove_log() { - if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'remove_log' ) ) { - wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); + if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( wp_unslash( $_REQUEST['_wpnonce'] ), 'remove_log' ) ) { // WPCS: input var ok, sanitization ok. + wp_die( esc_html__( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); } - if ( ! empty( $_REQUEST['handle'] ) ) { + if ( ! empty( $_REQUEST['handle'] ) ) { // WPCS: input var ok. $log_handler = new WC_Log_Handler_File(); - $log_handler->remove( $_REQUEST['handle'] ); + $log_handler->remove( wp_unslash( $_REQUEST['handle'] ) ); // WPCS: input var ok, sanitization ok. } wp_safe_redirect( esc_url_raw( admin_url( 'admin.php?page=wc-status&tab=logs' ) ) ); @@ -295,8 +302,8 @@ class WC_Admin_Status { * @since 3.0.0 */ private static function flush_db_logs() { - if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'woocommerce-status-logs' ) ) { - wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); + if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'woocommerce-status-logs' ) ) { // WPCS: input var ok, sanitization ok. + wp_die( esc_html__( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); } WC_Log_Handler_DB::flush(); @@ -311,13 +318,13 @@ class WC_Admin_Status { * @since 3.0.0 */ private static function log_table_bulk_actions() { - if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'woocommerce-status-logs' ) ) { - wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); + if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'woocommerce-status-logs' ) ) { // WPCS: input var ok, sanitization ok. + wp_die( esc_html__( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); } - $log_ids = array_map( 'absint', (array) $_GET['log'] ); + $log_ids = array_map( 'absint', (array) isset( $_REQUEST['log'] ) ? wp_unslash( $_REQUEST['log'] ) : array() ); // WPCS: input var ok, sanitization ok. - if ( 'delete' === $_GET['action'] || 'delete' === $_GET['action2'] ) { + if ( ( isset( $_REQUEST['action'] ) && 'delete' === $_REQUEST['action'] ) || ( isset( $_REQUEST['action2'] ) && 'delete' === $_REQUEST['action2'] ) ) { // WPCS: input var ok, sanitization ok. WC_Log_Handler_DB::delete( $log_ids ); wp_safe_redirect( esc_url_raw( admin_url( 'admin.php?page=wc-status&tab=logs' ) ) ); exit(); diff --git a/includes/admin/class-wc-admin-taxonomies.php b/includes/admin/class-wc-admin-taxonomies.php index 6844bc7c6a3..8b4e3e8bf41 100644 --- a/includes/admin/class-wc-admin-taxonomies.php +++ b/includes/admin/class-wc-admin-taxonomies.php @@ -18,10 +18,20 @@ if ( ! defined( 'ABSPATH' ) ) { */ class WC_Admin_Taxonomies { + /** + * Default category ID. + * + * @var int + */ + private $default_cat_id = 0; + /** * Constructor. */ public function __construct() { + // Default category ID. + $this->default_cat_id = get_option( 'default_product_cat', 0 ); + // Category/term ordering add_action( 'create_term', array( $this, 'create_term' ), 5, 3 ); add_action( 'delete_term', array( $this, 'delete_term' ), 5 ); @@ -36,8 +46,13 @@ class WC_Admin_Taxonomies { add_filter( 'manage_edit-product_cat_columns', array( $this, 'product_cat_columns' ) ); add_filter( 'manage_product_cat_custom_column', array( $this, 'product_cat_column' ), 10, 3 ); + // Add row actions. + add_filter( 'product_cat_row_actions', array( $this, 'product_cat_row_actions' ), 10, 2 ); + add_filter( 'admin_init', array( $this, 'handle_product_cat_row_actions' ) ); + // Taxonomy page descriptions add_action( 'product_cat_pre_add_form', array( $this, 'product_cat_description' ) ); + add_action( 'after-product_cat-table', array( $this, 'product_cat_notes' ) ); $attribute_taxonomies = wc_get_attribute_taxonomies(); @@ -49,13 +64,16 @@ class WC_Admin_Taxonomies { // Maintain hierarchy of terms add_filter( 'wp_terms_checklist_args', array( $this, 'disable_checked_ontop' ) ); + + // Admin footer scripts for this product categories admin screen + add_action( 'admin_footer', array( $this, 'scripts_at_product_cat_screen_footer' ) ); } /** * Order term when created (put in position 0). * - * @param mixed $term_id - * @param mixed $tt_id + * @param mixed $term_id + * @param mixed $tt_id * @param string $taxonomy */ public function create_term( $term_id, $tt_id = '', $taxonomy = '' ) { @@ -127,9 +145,9 @@ class WC_Admin_Taxonomies { // Create the media frame. file_frame = wp.media.frames.downloadable_file = wp.media({ - title: '', + title: '', button: { - text: '' + text: '' }, multiple: false }); @@ -195,7 +213,7 @@ class WC_Admin_Taxonomies { $image = wc_placeholder_img_src(); } ?> - + - +
      @@ -237,9 +255,9 @@ class WC_Admin_Taxonomies { // Create the media frame. file_frame = wp.media.frames.downloadable_file = wp.media({ - title: '', + title: '', button: { - text: '' + text: '' }, multiple: false }); @@ -275,8 +293,8 @@ class WC_Admin_Taxonomies { /** * save_category_fields function. * - * @param mixed $term_id Term ID being saved - * @param mixed $tt_id + * @param mixed $term_id Term ID being saved + * @param mixed $tt_id * @param string $taxonomy */ public function save_category_fields( $term_id, $tt_id = '', $taxonomy = '' ) { @@ -295,6 +313,29 @@ class WC_Admin_Taxonomies { echo wpautop( __( 'Product categories for your store can be managed here. To change the order of categories on the front-end you can drag and drop to sort them. To see more categories listed click the "screen options" link at the top-right of this page.', 'woocommerce' ) ); } + /** + * Add some notes to describe the behavior of the default category. + */ + public function product_cat_notes() { + $category_id = get_option( 'default_product_cat', 0 ); + $category = get_term( $category_id, 'product_cat' ); + $category_name = ( ! $category || is_wp_error( $category ) ) ? _x( 'Uncategorized', 'Default category slug', 'woocommerce' ) : $category->name; + ?> +
      +

      +
      + ' . esc_html( $category_name ) . '' + ); + ?> +

      +
      + term_id && current_user_can( 'edit_term', $term->term_id ) ) { + $actions['make_default'] = sprintf( + '%s', + wp_nonce_url( 'edit-tags.php?action=make_default&taxonomy=product_cat&tag_ID=' . absint( $term->term_id ), 'make_default_' . absint( $term->term_id ) ), + /* translators: %s: taxonomy term name */ + esc_attr( sprintf( __( 'Make “%s” the default category', 'woocommerce' ), $term->name ) ), + __( 'Make default', 'woocommerce' ) + ); + } + + return $actions; + } + + /** + * Handle custom row actions. + */ + public function handle_product_cat_row_actions() { + if ( isset( $_GET['action'], $_GET['tag_ID'], $_GET['_wpnonce'] ) && 'make_default' === $_GET['action'] ) { + $make_default_id = absint( $_GET['tag_ID'] ); + + if ( wp_verify_nonce( $_GET['_wpnonce'], 'make_default_' . $make_default_id ) && current_user_can( 'edit_term', $make_default_id ) ) { + update_option( 'default_product_cat', $make_default_id ); + } + } } /** @@ -326,13 +406,18 @@ class WC_Admin_Taxonomies { * * @param string $columns * @param string $column - * @param int $id + * @param int $id * * @return string */ public function product_cat_column( $columns, $column, $id ) { + if ( 'thumb' === $column ) { + // Prepend tooltip for default category. + $default_category_id = absint( get_option( 'default_product_cat', 0 ) ); - if ( 'thumb' == $column ) { + if ( $default_category_id === $id ) { + $columns .= wc_help_tip( __( 'This is the default category and it cannot be deleted. It will be automatically assigned to products with no category.', 'woocommerce' ) ); + } $thumbnail_id = get_woocommerce_term_meta( $id, 'thumbnail_id', true ); @@ -342,14 +427,13 @@ class WC_Admin_Taxonomies { $image = wc_placeholder_img_src(); } - // Prevent esc_url from breaking spaces in urls for image embeds - // Ref: https://core.trac.wordpress.org/ticket/23605 - $image = str_replace( ' ', '%20', $image ); - + // Prevent esc_url from breaking spaces in urls for image embeds. Ref: https://core.trac.wordpress.org/ticket/23605 + $image = str_replace( ' ', '%20', $image ); $columns .= '' . esc_attr__( 'Thumbnail', 'woocommerce' ) . ''; - } - + if ( 'handle' === $column ) { + $columns .= ''; + } return $columns; } @@ -365,6 +449,26 @@ class WC_Admin_Taxonomies { } return $args; } + + /** + * Admin footer scripts for the product categories admin screen + * + * @return void + */ + public function scripts_at_product_cat_screen_footer() { + if ( ! isset( $_GET['taxonomy'] ) || 'product_cat' !== $_GET['taxonomy'] ) { + return; + } + // Ensure the tooltip is displayed when the image column is disabled on product categories + wc_enqueue_js(" + (function( $ ) { + 'use strict'; + var product_cat = $( 'tr#tag-" . absint( $this->default_cat_id ) . "' ); + product_cat.find( 'th' ).empty(); + product_cat.find( 'td.thumb span' ).detach( 'span' ).appendTo( product_cat.find( 'th' ) ); + })( jQuery ); + "); + } } new WC_Admin_Taxonomies(); diff --git a/includes/admin/class-wc-admin-webhooks-table-list.php b/includes/admin/class-wc-admin-webhooks-table-list.php index 8a6b54e6b70..5650228026c 100644 --- a/includes/admin/class-wc-admin-webhooks-table-list.php +++ b/includes/admin/class-wc-admin-webhooks-table-list.php @@ -2,31 +2,39 @@ /** * WooCommerce Webhooks Table List * - * @author WooThemes - * @category Admin - * @package WooCommerce/Admin - * @version 2.4.0 + * @package WooCommerce\Admin + * @version 3.3.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; if ( ! class_exists( 'WP_List_Table' ) ) { - require_once( ABSPATH . 'wp-admin/includes/class-wp-list-table.php' ); + require_once ABSPATH . 'wp-admin/includes/class-wp-list-table.php'; } +/** + * Webooks table list class. + */ class WC_Admin_Webhooks_Table_List extends WP_List_Table { /** * Initialize the webhook table list. */ public function __construct() { - parent::__construct( array( - 'singular' => 'webhook', - 'plural' => 'webhooks', - 'ajax' => false, - ) ); + parent::__construct( + array( + 'singular' => 'webhook', + 'plural' => 'webhooks', + 'ajax' => false, + ) + ); + } + + /** + * No items found text. + */ + public function no_items() { + esc_html_e( 'No webhooks found.', 'woocommerce' ); } /** @@ -47,70 +55,44 @@ class WC_Admin_Webhooks_Table_List extends WP_List_Table { /** * Column cb. * - * @param WC_Post $webhook + * @param WC_Webhook $webhook Webhook instance. * @return string */ public function column_cb( $webhook ) { - return sprintf( '', $this->_args['singular'], $webhook->ID ); - } - - /** - * Get Webhook object. - * @param object $webhook - * @return WC_Webhook - */ - private function get_webbook_object( $webhook ) { - global $the_webhook; - - if ( empty( $the_webhook ) || $the_webhook->id != $webhook->ID ) { - $the_webhook = new WC_Webhook( $webhook->ID ); - } - - return $the_webhook; + return sprintf( '', $this->_args['singular'], $webhook->get_id() ); } /** * Return title column. - * @param object $webhook + * + * @param WC_Webhook $webhook Webhook instance. * @return string */ public function column_title( $webhook ) { - $the_webhook = $this->get_webbook_object( $webhook ); - $edit_link = admin_url( 'admin.php?page=wc-settings&tab=api&section=webhooks&edit-webhook=' . $the_webhook->id ); - $title = _draft_or_post_title( $the_webhook->get_post_data() ); - $post_type_object = get_post_type_object( $the_webhook->get_post_data()->post_type ); - $post_status = $the_webhook->get_post_data()->post_status; + $edit_link = admin_url( 'admin.php?page=wc-settings&tab=advanced&section=webhooks&edit-webhook=' . $webhook->get_id() ); + $output = ''; - // Title - $output = ''; - if ( 'trash' == $post_status ) { - $output .= esc_html( $title ); - } else { - $output .= '' . esc_html( $title ) . ''; - } - $output .= ''; + // Title. + $output .= '' . esc_html( $webhook->get_name() ) . ''; - // Get actions + // Get actions. $actions = array( - 'id' => sprintf( __( 'ID: %d', 'woocommerce' ), $the_webhook->id ), + /* translators: %s: webhook ID. */ + 'id' => sprintf( __( 'ID: %d', 'woocommerce' ), $webhook->get_id() ), + 'edit' => '' . esc_html__( 'Edit', 'woocommerce' ) . '', + /* translators: %s: webhook name */ + 'delete' => 'get_name() ) ) . '" href="' . esc_url( + wp_nonce_url( + add_query_arg( + array( + 'delete' => $webhook->get_id(), + ), admin_url( 'admin.php?page=wc-settings&tab=advanced§ion=webhooks' ) + ), 'delete-webhook' + ) + ) . '">' . esc_html__( 'Delete permanently', 'woocommerce' ) . '', ); - if ( current_user_can( $post_type_object->cap->edit_post, $the_webhook->id ) && 'trash' !== $post_status ) { - $actions['edit'] = '' . __( 'Edit', 'woocommerce' ) . ''; - } - - if ( current_user_can( $post_type_object->cap->delete_post, $the_webhook->id ) ) { - if ( 'trash' == $post_status ) { - $actions['untrash'] = '' . esc_html__( 'Restore', 'woocommerce' ) . ''; - } elseif ( EMPTY_TRASH_DAYS ) { - $actions['trash'] = '' . esc_html__( 'Trash', 'woocommerce' ) . ''; - } - if ( 'trash' == $post_status || ! EMPTY_TRASH_DAYS ) { - $actions['delete'] = '' . esc_html__( 'Delete permanently', 'woocommerce' ) . ''; - } - } - - $actions = apply_filters( 'post_row_actions', $actions, $the_webhook->get_post_data() ); + $actions = apply_filters( 'webhook_row_actions', $actions, $webhook ); $row_actions = array(); foreach ( $actions as $action => $link ) { @@ -124,75 +106,59 @@ class WC_Admin_Webhooks_Table_List extends WP_List_Table { /** * Return status column. - * @param object $webhook + * + * @param WC_Webhook $webhook Webhook instance. * @return string */ public function column_status( $webhook ) { - return $this->get_webbook_object( $webhook )->get_i18n_status(); + return $webhook->get_i18n_status(); } /** * Return topic column. - * @param object $webhook + * + * @param WC_Webhook $webhook Webhook instance. * @return string */ public function column_topic( $webhook ) { - return $this->get_webbook_object( $webhook )->get_topic(); + return $webhook->get_topic(); } /** * Return delivery URL column. - * @param object $webhook + * + * @param WC_Webhook $webhook Webhook instance. * @return string */ public function column_delivery_url( $webhook ) { - return $this->get_webbook_object( $webhook )->get_delivery_url(); + return $webhook->get_delivery_url(); } /** * Get the status label for webhooks. * - * @param string $status_name - * @param stdClass $status - * + * @param string $status_name Status name. + * @param int $amount Amount of webhooks. * @return array */ - private function get_status_label( $status_name, $status ) { - switch ( $status_name ) { - case 'publish' : - /* translators: %s: count */ - $label = array( - 'singular' => __( 'Activated (%s)', 'woocommerce' ), - 'plural' => __( 'Activated (%s)', 'woocommerce' ), - 'context' => '', - 'domain' => 'woocommerce', - ); - break; - case 'draft' : - /* translators: %s: count */ - $label = array( - 'singular' => __( 'Paused (%s)', 'woocommerce' ), - 'plural' => __( 'Paused (%s)', 'woocommerce' ), - 'context' => '', - 'domain' => 'woocommerce', - ); - break; - case 'pending' : - /* translators: %s: count */ - $label = array( - 'singular' => __( 'Disabled (%s)', 'woocommerce' ), - 'plural' => __( 'Disabled (%s)', 'woocommerce' ), - 'context' => '', - 'domain' => 'woocommerce', - ); - break; + private function get_status_label( $status_name, $amount ) { + $statuses = wc_get_webhook_statuses(); - default: - $label = $status->label_count; - break; + if ( isset( $statuses[ $status_name ] ) ) { + return array( + 'singular' => sprintf( '%s (%s)', esc_html( $statuses[ $status_name ] ), $amount ), + 'plural' => sprintf( '%s (%s)', esc_html( $statuses[ $status_name ] ), $amount ), + 'context' => '', + 'domain' => 'woocommerce', + ); } - return $label; + return array( + 'singular' => sprintf( '%s (%s)', esc_html( $status_name ), $amount ), + 'plural' => sprintf( '%s (%s)', esc_html( $status_name ), $amount ), + 'context' => '', + 'domain' => 'woocommerce', + ); } /** @@ -201,39 +167,30 @@ class WC_Admin_Webhooks_Table_List extends WP_List_Table { * @return array */ protected function get_views() { - $status_links = array(); - $num_posts = wp_count_posts( 'shop_webhook', 'readable' ); - $class = ''; - $total_posts = array_sum( (array) $num_posts ); + $status_links = array(); + $data_store = WC_Data_Store::load( 'webhook' ); + $num_webhooks = $data_store->get_count_webhooks_by_status(); + $total_webhooks = array_sum( (array) $num_webhooks ); + $statuses = array_keys( wc_get_webhook_statuses() ); + $class = empty( $_REQUEST['status'] ) ? ' class="current"' : ''; // WPCS: input var okay. CSRF ok. - // Subtract post types that are not included in the admin all list. - foreach ( get_post_stati( array( 'show_in_admin_all_list' => false ) ) as $state ) { - $total_posts -= $num_posts->$state; - } - - $class = empty( $class ) && empty( $_REQUEST['status'] ) ? ' class="current"' : ''; /* translators: %s: count */ - $status_links['all'] = "" . sprintf( _nx( 'All (%s)', 'All (%s)', $total_posts, 'posts', 'woocommerce' ), number_format_i18n( $total_posts ) ) . ''; + $status_links['all'] = "" . sprintf( _nx( 'All (%s)', 'All (%s)', $total_webhooks, 'posts', 'woocommerce' ), number_format_i18n( $total_webhooks ) ) . ''; - foreach ( get_post_stati( array( 'show_in_admin_status_list' => true ), 'objects' ) as $status ) { + foreach ( $statuses as $status_name ) { $class = ''; - $status_name = $status->name; - if ( ! in_array( $status_name, array( 'publish', 'draft', 'pending', 'trash', 'future', 'private', 'auto-draft' ) ) ) { + if ( empty( $num_webhooks[ $status_name ] ) ) { continue; } - if ( empty( $num_posts->$status_name ) ) { - continue; - } - - if ( isset( $_REQUEST['status'] ) && $status_name == $_REQUEST['status'] ) { + if ( isset( $_REQUEST['status'] ) && sanitize_key( wp_unslash( $_REQUEST['status'] ) ) === $status_name ) { // WPCS: input var okay, CSRF ok. $class = ' class="current"'; } - $label = $this->get_status_label( $status_name, $status ); + $label = $this->get_status_label( $status_name, $num_webhooks[ $status_name ] ); - $status_links[ $status_name ] = "" . sprintf( translate_nooped_plural( $label, $num_posts->$status_name ), number_format_i18n( $num_posts->$status_name ) ) . ''; + $status_links[ $status_name ] = "" . sprintf( translate_nooped_plural( $label, $num_webhooks[ $status_name ] ), number_format_i18n( $num_webhooks[ $status_name ] ) ) . ''; } return $status_links; @@ -245,69 +202,113 @@ class WC_Admin_Webhooks_Table_List extends WP_List_Table { * @return array */ protected function get_bulk_actions() { - if ( isset( $_GET['status'] ) && 'trash' == $_GET['status'] ) { - return array( - 'untrash' => __( 'Restore', 'woocommerce' ), - 'delete' => __( 'Delete permanently', 'woocommerce' ), - ); - } - return array( - 'trash' => __( 'Move to trash', 'woocommerce' ), + 'delete' => __( 'Delete permanently', 'woocommerce' ), ); } /** - * Extra controls to be displayed between bulk actions and pagination. - * - * @param string $which + * Process bulk actions. */ - protected function extra_tablenav( $which ) { - if ( 'top' == $which && isset( $_GET['status'] ) && 'trash' == $_GET['status'] && current_user_can( 'delete_shop_webhooks' ) ) { - echo '
      ' . __( 'Empty trash', 'woocommerce' ) . '
      '; + public function process_bulk_action() { + $action = $this->current_action(); + $webhooks = isset( $_REQUEST['webhook'] ) ? array_map( 'absint', (array) $_REQUEST['webhook'] ) : array(); // WPCS: input var okay, CSRF ok. + + if ( ! current_user_can( 'manage_woocommerce' ) ) { + wp_die( esc_html__( 'You do not have permission to edit Webhooks', 'woocommerce' ) ); } + + if ( 'delete' === $action ) { + WC_Admin_Webhooks::bulk_delete( $webhooks ); + } + } + + /** + * Generate the table navigation above or below the table. + * Included to remove extra nonce input. + * + * @param string $which The location of the extra table nav markup: 'top' or 'bottom'. + */ + protected function display_tablenav( $which ) { + echo '
      '; + + if ( $this->has_items() ) { + echo '
      '; + $this->bulk_actions( $which ); + echo '
      '; + } + + $this->extra_tablenav( $which ); + $this->pagination( $which ); + echo '
      '; + echo '
      '; + } + + /** + * Search box. + * + * @param string $text Button text. + * @param string $input_id Input ID. + */ + public function search_box( $text, $input_id ) { + if ( empty( $_REQUEST['s'] ) && ! $this->has_items() ) { // WPCS: input var okay, CSRF ok. + return; + } + + $input_id = $input_id . '-search-input'; + $search_query = isset( $_REQUEST['s'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['s'] ) ) : ''; // WPCS: input var okay, CSRF ok. + + echo '

      '; + echo ''; + echo ''; + submit_button( + $text, '', '', false, + array( + 'id' => 'search-submit', + ) + ); + echo '

      '; } /** * Prepare table list items. */ public function prepare_items() { - $per_page = apply_filters( 'woocommerce_webhooks_settings_posts_per_page', 10 ); - $columns = $this->get_columns(); - $hidden = array(); - $sortable = $this->get_sortable_columns(); - - // Column headers - $this->_column_headers = array( $columns, $hidden, $sortable ); - + $per_page = $this->get_items_per_page( 'woocommerce_webhooks_per_page' ); $current_page = $this->get_pagenum(); - // Query args + // Query args. $args = array( - 'post_type' => 'shop_webhook', - 'posts_per_page' => $per_page, - 'ignore_sticky_posts' => true, - 'paged' => $current_page, + 'limit' => $per_page, + 'offset' => $per_page * ( $current_page - 1 ), ); - // Handle the status query - if ( ! empty( $_REQUEST['status'] ) ) { - $args['post_status'] = sanitize_text_field( $_REQUEST['status'] ); + // Handle the status query. + if ( ! empty( $_REQUEST['status'] ) ) { // WPCS: input var okay, CSRF ok. + $args['status'] = sanitize_key( wp_unslash( $_REQUEST['status'] ) ); // WPCS: input var okay, CSRF ok. } - if ( ! empty( $_REQUEST['s'] ) ) { - $args['s'] = sanitize_text_field( $_REQUEST['s'] ); + if ( ! empty( $_REQUEST['s'] ) ) { // WPCS: input var okay, CSRF ok. + $args['search'] = sanitize_text_field( wp_unslash( $_REQUEST['s'] ) ); // WPCS: input var okay, CSRF ok. } - // Get the webhooks - $webhooks = new WP_Query( $args ); - $this->items = $webhooks->posts; + // Get the webhooks. + $data_store = WC_Data_Store::load( 'webhook' ); + $webhooks = $data_store->search_webhooks( $args ); + $this->items = array_map( 'wc_get_webhook', $webhooks ); - // Set the pagination - $this->set_pagination_args( array( - 'total_items' => $webhooks->found_posts, - 'per_page' => $per_page, - 'total_pages' => $webhooks->max_num_pages, - ) ); + // Get total items. + $args['limit'] = -1; + $args['offset'] = 0; + $total_items = count( $data_store->search_webhooks( $args ) ); + + // Set the pagination. + $this->set_pagination_args( + array( + 'total_items' => $total_items, + 'per_page' => $per_page, + 'total_pages' => ceil( $total_items / $per_page ), + ) + ); } } diff --git a/includes/admin/class-wc-admin-webhooks.php b/includes/admin/class-wc-admin-webhooks.php index 9b84bc7ad67..abe82d2df79 100644 --- a/includes/admin/class-wc-admin-webhooks.php +++ b/includes/admin/class-wc-admin-webhooks.php @@ -2,15 +2,11 @@ /** * WooCommerce Admin Webhooks Class * - * @author WooThemes - * @category Admin - * @package WooCommerce/Admin - * @version 2.4.0 + * @package WooCommerce\Admin + * @version 3.3.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; /** * WC_Admin_Webhooks. @@ -22,6 +18,23 @@ class WC_Admin_Webhooks { */ public function __construct() { add_action( 'admin_init', array( $this, 'actions' ) ); + add_action( 'woocommerce_settings_page_init', array( $this, 'screen_option' ) ); + add_filter( 'woocommerce_save_settings_advanced_webhooks', array( $this, 'allow_save_settings' ) ); + } + + /** + * Check if should allow save settings. + * This prevents "Your settings have been saved." notices on the table list. + * + * @param bool $allow If allow save settings. + * @return bool + */ + public function allow_save_settings( $allow ) { + if ( ! isset( $_GET['edit-webhook'] ) ) { // WPCS: input var okay, CSRF ok. + return false; + } + + return $allow; } /** @@ -30,86 +43,69 @@ class WC_Admin_Webhooks { * @return bool */ private function is_webhook_settings_page() { - return isset( $_GET['page'], $_GET['tab'], $_GET['section'] ) - && 'wc-settings' === $_GET['page'] - && 'api' === $_GET['tab'] - && 'webhooks' === $_GET['section']; + return isset( $_GET['page'], $_GET['tab'], $_GET['section'] ) && 'wc-settings' === $_GET['page'] && 'advanced' === $_GET['tab'] && 'webhooks' === $_GET['section']; // WPCS: input var okay, CSRF ok. } /** - * Updated the Webhook name. - * - * @param int $webhook_id + * Save method. */ - private function update_name( $webhook_id ) { - global $wpdb; + private function save() { + check_admin_referer( 'woocommerce-settings' ); - // @codingStandardsIgnoreStart - /* translators: %s: date` */ - $name = ! empty( $_POST['webhook_name'] ) ? $_POST['webhook_name'] : sprintf( __( 'Webhook created on %s', 'woocommerce' ), strftime( _x( '%b %d, %Y @ %I:%M %p', 'Webhook created on date parsed by strftime', 'woocommerce' ) ) ); - // @codingStandardsIgnoreEnd - $wpdb->update( $wpdb->posts, array( 'post_title' => $name ), array( 'ID' => $webhook_id ) ); - } + if ( ! current_user_can( 'manage_woocommerce' ) ) { + wp_die( esc_html__( 'You do not have permission to update Webhooks', 'woocommerce' ) ); + } - /** - * Updated the Webhook status. - * - * @param WC_Webhook $webhook - */ - private function update_status( $webhook ) { - $status = ! empty( $_POST['webhook_status'] ) ? wc_clean( $_POST['webhook_status'] ) : ''; + $errors = array(); + $webhook_id = isset( $_POST['webhook_id'] ) ? absint( $_POST['webhook_id'] ) : 0; // WPCS: input var okay, CSRF ok. + $webhook = new WC_Webhook( $webhook_id ); - $webhook->update_status( $status ); - } + // Name. + if ( ! empty( $_POST['webhook_name'] ) ) { // WPCS: input var okay, CSRF ok. + $name = sanitize_text_field( wp_unslash( $_POST['webhook_name'] ) ); // WPCS: input var okay, CSRF ok. + } else { + $name = sprintf( + /* translators: %s: date */ + __( 'Webhook created on %s', 'woocommerce' ), + // @codingStandardsIgnoreStart + strftime( _x( '%b %d, %Y @ %I:%M %p', 'Webhook created on date parsed by strftime', 'woocommerce' ) ) + // @codingStandardsIgnoreEnd + ); + } - /** - * Updated the Webhook delivery URL. - * - * @param WC_Webhook $webhook - */ - private function update_delivery_url( $webhook ) { - $delivery_url = ! empty( $_POST['webhook_delivery_url'] ) ? $_POST['webhook_delivery_url'] : ''; + $webhook->set_name( $name ); + + if ( ! $webhook->get_user_id() ) { + $webhook->set_user_id( get_current_user_id() ); + } + + // Status. + $webhook->set_status( ! empty( $_POST['webhook_status'] ) ? sanitize_text_field( wp_unslash( $_POST['webhook_status'] ) ) : 'disabled' ); // WPCS: input var okay, CSRF ok. + + // Delivery URL. + $delivery_url = ! empty( $_POST['webhook_delivery_url'] ) ? esc_url_raw( wp_unslash( $_POST['webhook_delivery_url'] ) ) : ''; // WPCS: input var okay, CSRF ok. if ( wc_is_valid_url( $delivery_url ) ) { $webhook->set_delivery_url( $delivery_url ); } - } - - /** - * Updated the Webhook secret. - * - * @param WC_Webhook $webhook - */ - private function update_secret( $webhook ) { - $secret = ! empty( $_POST['webhook_secret'] ) ? $_POST['webhook_secret'] : wp_generate_password( 50, true, true ); + // Secret. + $secret = ! empty( $_POST['webhook_secret'] ) ? sanitize_text_field( wp_unslash( $_POST['webhook_secret'] ) ) : wp_generate_password( 50, true, true ); // WPCS: input var okay, CSRF ok. $webhook->set_secret( $secret ); - } - - /** - * Updated the Webhook topic. - * - * @param WC_Webhook $webhook - */ - private function update_topic( $webhook ) { - if ( ! empty( $_POST['webhook_topic'] ) ) { + // Topic. + if ( ! empty( $_POST['webhook_topic'] ) ) { // WPCS: input var okay, CSRF ok. $resource = ''; $event = ''; - switch ( $_POST['webhook_topic'] ) { - case 'custom' : - if ( ! empty( $_POST['webhook_custom_topic'] ) ) { - list( $resource, $event ) = explode( '.', wc_clean( $_POST['webhook_custom_topic'] ) ); - } - break; - case 'action' : + switch ( $_POST['webhook_topic'] ) { // WPCS: input var okay, CSRF ok. + case 'action': $resource = 'action'; - $event = ! empty( $_POST['webhook_action_event'] ) ? wc_clean( $_POST['webhook_action_event'] ) : ''; + $event = ! empty( $_POST['webhook_action_event'] ) ? sanitize_text_field( wp_unslash( $_POST['webhook_action_event'] ) ) : ''; // WPCS: input var okay, CSRF ok. break; - default : - list( $resource, $event ) = explode( '.', wc_clean( $_POST['webhook_topic'] ) ); + default: + list( $resource, $event ) = explode( '.', sanitize_text_field( wp_unslash( $_POST['webhook_topic'] ) ) ); // WPCS: input var okay, CSRF ok. break; } @@ -117,224 +113,70 @@ class WC_Admin_Webhooks { if ( wc_is_webhook_valid_topic( $topic ) ) { $webhook->set_topic( $topic ); + } else { + $errors[] = __( 'Webhook topic unknown. Please select a valid topic.', 'woocommerce' ); } } - } - - /** - * Update webhook api version. - * - * @param WC_Webhook $webhook Webhook instance. - */ - private function update_api_version( $webhook ) { - $version = ! empty( $_POST['webhook_api_version'] ) ? wc_clean( $_POST['webhook_api_version'] ) : 'wp_api_v2'; - - $webhook->set_api_version( $version ); - } - - /** - * Save method. - */ - private function save() { - if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'woocommerce-settings' ) ) { - wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); - } - - $webhook_id = absint( $_POST['webhook_id'] ); - - if ( ! current_user_can( 'edit_shop_webhook', $webhook_id ) ) { - return; - } - - $webhook = new WC_Webhook( $webhook_id ); - - // Name - $this->update_name( $webhook->id ); - - // Status - $this->update_status( $webhook ); - - // Delivery URL - $this->update_delivery_url( $webhook ); - - // Secret - $this->update_secret( $webhook ); - - // Topic - $this->update_topic( $webhook ); // API version. - $this->update_api_version( $webhook ); + $webhook->set_api_version( ! empty( $_POST['webhook_api_version'] ) ? sanitize_text_field( wp_unslash( $_POST['webhook_api_version'] ) ) : 'wp_api_v2' ); // WPCS: input var okay, CSRF ok. - // Update date. - wp_update_post( array( 'ID' => $webhook->id, 'post_modified' => current_time( 'mysql' ) ) ); + $webhook->save(); - // Run actions - do_action( 'woocommerce_webhook_options_save', $webhook->id ); - - delete_transient( 'woocommerce_webhook_ids' ); - - // Ping the webhook at the first time that is activated - $pending_delivery = get_post_meta( $webhook->id, '_webhook_pending_delivery', true ); - - if ( isset( $_POST['webhook_status'] ) && 'active' === $_POST['webhook_status'] && $pending_delivery ) { + // Run actions. + do_action( 'woocommerce_webhook_options_save', $webhook->get_id() ); + if ( $errors ) { + // Redirect to webhook edit page to avoid settings save actions. + wp_safe_redirect( admin_url( 'admin.php?page=wc-settings&tab=advanced§ion=webhooks&edit-webhook=' . $webhook->get_id() . '&error=' . rawurlencode( implode( '|', $errors ) ) ) ); + exit(); + } elseif ( isset( $_POST['webhook_status'] ) && 'active' === $_POST['webhook_status'] && $webhook->get_pending_delivery() ) { // WPCS: input var okay, CSRF ok. + // Ping the webhook at the first time that is activated. $result = $webhook->deliver_ping(); if ( is_wp_error( $result ) ) { - // Redirect to webhook edit page to avoid settings save actions - wp_safe_redirect( admin_url( 'admin.php?page=wc-settings&tab=api§ion=webhooks&edit-webhook=' . $webhook->id . '&error=' . urlencode( $result->get_error_message() ) ) ); + // Redirect to webhook edit page to avoid settings save actions. + wp_safe_redirect( admin_url( 'admin.php?page=wc-settings&tab=advanced§ion=webhooks&edit-webhook=' . $webhook->get_id() . '&error=' . rawurlencode( $result->get_error_message() ) ) ); exit(); } } - // Redirect to webhook edit page to avoid settings save actions - wp_safe_redirect( admin_url( 'admin.php?page=wc-settings&tab=api§ion=webhooks&edit-webhook=' . $webhook->id . '&updated=1' ) ); + // Redirect to webhook edit page to avoid settings save actions. + wp_safe_redirect( admin_url( 'admin.php?page=wc-settings&tab=advanced§ion=webhooks&edit-webhook=' . $webhook->get_id() . '&updated=1' ) ); exit(); } /** - * Create Webhook. - */ - private function create() { - if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'create-webhook' ) ) { - wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); - } - - if ( ! current_user_can( 'publish_shop_webhooks' ) ) { - wp_die( __( 'You do not have permissions to create Webhooks!', 'woocommerce' ) ); - } - - $webhook_id = wp_insert_post( array( - 'post_type' => 'shop_webhook', - 'post_status' => 'pending', - 'ping_status' => 'closed', - 'post_author' => get_current_user_id(), - 'post_password' => strlen( ( $password = uniqid( 'webhook_' ) ) ) > 20 ? substr( $password, 0, 20 ) : $password, - // @codingStandardsIgnoreStart - /* translators: %s: date */ - 'post_title' => sprintf( __( 'Webhook created on %s', 'woocommerce' ), strftime( _x( '%b %d, %Y @ %I:%M %p', 'Webhook created on date parsed by strftime', 'woocommerce' ) ) ), - // @codingStandardsIgnoreEnd - 'comment_status' => 'open', - ) ); - - if ( is_wp_error( $webhook_id ) ) { - wp_die( $webhook_id->get_error_messages() ); - } - - update_post_meta( $webhook_id, '_webhook_pending_delivery', true ); - $webhook = new WC_Webhook( $webhook_id ); - $webhook->set_api_version( 'wp_api_v2' ); - - delete_transient( 'woocommerce_webhook_ids' ); - - // Redirect to edit page - wp_redirect( admin_url( 'admin.php?page=wc-settings&tab=api§ion=webhooks&edit-webhook=' . $webhook_id . '&created=1' ) ); - exit(); - } - - /** - * Bulk trash/delete. + * Bulk delete. * - * @param array $webhooks - * @param bool $delete + * @param array $webhooks List of webhooks IDs. */ - private function bulk_trash( $webhooks, $delete = false ) { + public static function bulk_delete( $webhooks ) { foreach ( $webhooks as $webhook_id ) { - if ( $delete ) { - wp_delete_post( $webhook_id, true ); - } else { - wp_trash_post( $webhook_id ); + $webhook = new WC_Webhook( (int) $webhook_id ); + $webhook->delete( true ); + } + + $qty = count( $webhooks ); + $status = isset( $_GET['status'] ) ? '&status=' . sanitize_text_field( wp_unslash( $_GET['status'] ) ) : ''; // WPCS: input var okay, CSRF ok. + + // Redirect to webhooks page. + wp_safe_redirect( admin_url( 'admin.php?page=wc-settings&tab=advanced§ion=webhooks' . $status . '&deleted=' . $qty ) ); + exit(); + } + + /** + * Delete webhook. + */ + private function delete() { + check_admin_referer( 'delete-webhook' ); + + if ( isset( $_GET['delete'] ) ) { // WPCS: input var okay, CSRF ok. + $webhook_id = absint( $_GET['delete'] ); // WPCS: input var okay, CSRF ok. + + if ( $webhook_id ) { + $this->bulk_delete( array( $webhook_id ) ); } } - - $type = ! EMPTY_TRASH_DAYS || $delete ? 'deleted' : 'trashed'; - $qty = count( $webhooks ); - $status = isset( $_GET['status'] ) ? '&status=' . sanitize_text_field( $_GET['status'] ) : ''; - - delete_transient( 'woocommerce_webhook_ids' ); - - // Redirect to webhooks page - wp_redirect( admin_url( 'admin.php?page=wc-settings&tab=api§ion=webhooks' . $status . '&' . $type . '=' . $qty ) ); - exit(); - } - - /** - * Bulk untrash. - * - * @param array $webhooks - */ - private function bulk_untrash( $webhooks ) { - foreach ( $webhooks as $webhook_id ) { - wp_untrash_post( $webhook_id ); - } - - $qty = count( $webhooks ); - - delete_transient( 'woocommerce_webhook_ids' ); - - // Redirect to webhooks page - wp_redirect( admin_url( 'admin.php?page=wc-settings&tab=api§ion=webhooks&status=trash&untrashed=' . $qty ) ); - exit(); - } - - /** - * Bulk actions. - */ - private function bulk_actions() { - if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'woocommerce-settings' ) ) { - wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); - } - - if ( ! current_user_can( 'edit_shop_webhooks' ) ) { - wp_die( __( 'You do not have permissions to edit Webhooks!', 'woocommerce' ) ); - } - - $webhooks = array_map( 'absint', (array) $_GET['webhook'] ); - - switch ( $_GET['action'] ) { - case 'trash' : - $this->bulk_trash( $webhooks ); - break; - case 'untrash' : - $this->bulk_untrash( $webhooks ); - break; - case 'delete' : - $this->bulk_trash( $webhooks, true ); - break; - default : - break; - } - } - - /** - * Empty Trash. - */ - private function empty_trash() { - if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'empty_trash' ) ) { - wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); - } - - if ( ! current_user_can( 'delete_shop_webhooks' ) ) { - wp_die( __( 'You do not have permissions to delete Webhooks!', 'woocommerce' ) ); - } - - $webhooks = get_posts( array( - 'post_type' => 'shop_webhook', - 'ignore_sticky_posts' => true, - 'nopaging' => true, - 'post_status' => 'trash', - 'fields' => 'ids', - ) ); - - foreach ( $webhooks as $webhook_id ) { - wp_delete_post( $webhook_id, true ); - } - - $qty = count( $webhooks ); - - // Redirect to webhooks page - wp_redirect( admin_url( 'admin.php?page=wc-settings&tab=api§ion=webhooks&deleted=' . $qty ) ); - exit(); } /** @@ -342,24 +184,14 @@ class WC_Admin_Webhooks { */ public function actions() { if ( $this->is_webhook_settings_page() ) { - // Save - if ( isset( $_POST['save'] ) && isset( $_POST['webhook_id'] ) ) { + // Save. + if ( isset( $_POST['save'] ) && isset( $_POST['webhook_id'] ) ) { // WPCS: input var okay, CSRF ok. $this->save(); } - // Create - if ( isset( $_GET['create-webhook'] ) ) { - $this->create(); - } - - // Bulk actions - if ( isset( $_GET['action'] ) && isset( $_GET['webhook'] ) ) { - $this->bulk_actions(); - } - - // Empty trash - if ( isset( $_GET['empty_trash'] ) ) { - $this->empty_trash(); + // Delete webhook. + if ( isset( $_GET['delete'] ) ) { // WPCS: input var okay, CSRF ok. + $this->delete(); } } } @@ -368,17 +200,15 @@ class WC_Admin_Webhooks { * Page output. */ public static function page_output() { - // Hide the save button + // Hide the save button. $GLOBALS['hide_save_button'] = true; - if ( isset( $_GET['edit-webhook'] ) ) { - $webhook_id = absint( $_GET['edit-webhook'] ); + if ( isset( $_GET['edit-webhook'] ) ) { // WPCS: input var okay, CSRF ok. + $webhook_id = absint( $_GET['edit-webhook'] ); // WPCS: input var okay, CSRF ok. $webhook = new WC_Webhook( $webhook_id ); - if ( 'trash' != $webhook->post_data->post_status ) { - include( 'settings/views/html-webhooks-edit.php' ); - return; - } + include 'settings/views/html-webhooks-edit.php'; + return; } self::table_list_output(); @@ -388,37 +218,45 @@ class WC_Admin_Webhooks { * Notices. */ public static function notices() { - if ( isset( $_GET['trashed'] ) ) { - $trashed = absint( $_GET['trashed'] ); - - /* translators: %d: count */ - WC_Admin_Settings::add_message( sprintf( _n( '%d webhook moved to the Trash.', '%d webhooks moved to the Trash.', $trashed, 'woocommerce' ), $trashed ) ); - } - - if ( isset( $_GET['untrashed'] ) ) { - $untrashed = absint( $_GET['untrashed'] ); - - /* translators: %d: count */ - WC_Admin_Settings::add_message( sprintf( _n( '%d webhook restored from the Trash.', '%d webhooks restored from the Trash.', $untrashed, 'woocommerce' ), $untrashed ) ); - } - - if ( isset( $_GET['deleted'] ) ) { - $deleted = absint( $_GET['deleted'] ); + if ( isset( $_GET['deleted'] ) ) { // WPCS: input var okay, CSRF ok. + $deleted = absint( $_GET['deleted'] ); // WPCS: input var okay, CSRF ok. /* translators: %d: count */ WC_Admin_Settings::add_message( sprintf( _n( '%d webhook permanently deleted.', '%d webhooks permanently deleted.', $deleted, 'woocommerce' ), $deleted ) ); } - if ( isset( $_GET['updated'] ) ) { + if ( isset( $_GET['updated'] ) ) { // WPCS: input var okay, CSRF ok. WC_Admin_Settings::add_message( __( 'Webhook updated successfully.', 'woocommerce' ) ); } - if ( isset( $_GET['created'] ) ) { + if ( isset( $_GET['created'] ) ) { // WPCS: input var okay, CSRF ok. WC_Admin_Settings::add_message( __( 'Webhook created successfully.', 'woocommerce' ) ); } - if ( isset( $_GET['error'] ) ) { - WC_Admin_Settings::add_error( wc_clean( $_GET['error'] ) ); + if ( isset( $_GET['error'] ) ) { // WPCS: input var okay, CSRF ok. + foreach ( explode( '|', sanitize_text_field( wp_unslash( $_GET['error'] ) ) ) as $message ) { // WPCS: input var okay, CSRF ok. + WC_Admin_Settings::add_error( trim( $message ) ); + } + } + } + + /** + * Add screen option. + */ + public function screen_option() { + global $webhooks_table_list; + + if ( ! isset( $_GET['edit-webhook'] ) && $this->is_webhook_settings_page() ) { // WPCS: input var okay, CSRF ok. + $webhooks_table_list = new WC_Admin_Webhooks_Table_List(); + + // Add screen option. + add_screen_option( + 'per_page', + array( + 'default' => 10, + 'option' => 'woocommerce_webhooks_per_page', + ) + ); } } @@ -426,17 +264,20 @@ class WC_Admin_Webhooks { * Table list output. */ private static function table_list_output() { - echo '

      ' . __( 'Webhooks', 'woocommerce' ) . ' ' . __( 'Add webhook', 'woocommerce' ) . '

      '; + global $webhooks_table_list; - // Get the webhooks count - $count = array_sum( (array) wp_count_posts( 'shop_webhook', 'readable' ) ); + echo '

      ' . esc_html__( 'Webhooks', 'woocommerce' ) . ' ' . esc_html__( 'Add webhook', 'woocommerce' ) . '

      '; - if ( absint( $count ) && $count > 0 ) { - $webhooks_table_list = new WC_Admin_Webhooks_Table_List(); + // Get the webhooks count. + $data_store = WC_Data_Store::load( 'webhook' ); + $count = count( $data_store->get_webhooks_ids() ); + + if ( 0 < $count ) { + $webhooks_table_list->process_bulk_action(); $webhooks_table_list->prepare_items(); echo ''; - echo ''; + echo ''; echo ''; $webhooks_table_list->views(); @@ -445,48 +286,27 @@ class WC_Admin_Webhooks { } else { echo '
      '; ?> -

      - - - #posts-filter .wp-list-table, #posts-filter .tablenav.top, .tablenav.bottom .actions { display: none; }
      '; +

      + + + $webhook->id, - 'status' => 'approve', - 'type' => 'webhook_delivery', - 'number' => 10, - ); - - if ( 1 < $current ) { - $args['offset'] = ( $current - 1 ) * 10; - } - - remove_filter( 'comments_clauses', array( 'WC_Comments', 'exclude_webhook_comments' ), 10, 1 ); - - $logs = get_comments( $args ); - - add_filter( 'comments_clauses', array( 'WC_Comments', 'exclude_webhook_comments' ), 10, 1 ); - - if ( $logs ) { - include_once( dirname( __FILE__ ) . '/settings/views/html-webhook-logs.php' ); - } else { - echo '

      ' . __( 'This Webhook has no log yet.', 'woocommerce' ) . '

      '; - } + public static function logs_output( $webhook = 'deprecated' ) { + wc_deprecated_function( 'WC_Admin_Webhooks::logs_output', '3.3' ); } /** * Get the webhook topic data. * - * @param WC_Webhook $webhook + * @param WC_Webhook $webhook Webhook instance. * * @return array */ @@ -500,7 +320,7 @@ class WC_Admin_Webhooks { if ( 'action' === $resource ) { $topic = 'action'; - } elseif ( ! in_array( $resource, array( 'coupon', 'customer', 'order', 'product' ) ) ) { + } elseif ( ! in_array( $resource, array( 'coupon', 'customer', 'order', 'product' ), true ) ) { $topic = 'custom'; } } @@ -515,46 +335,12 @@ class WC_Admin_Webhooks { /** * Get the logs navigation. * - * @param int $total - * @param WC_Webhook $webhook - * - * @return string + * @deprecated 3.3.0 + * @param int $total Deprecated. + * @param WC_Webhook $webhook Deprecated. */ public static function get_logs_navigation( $total, $webhook ) { - $pages = ceil( $total / 10 ); - $current = isset( $_GET['log_page'] ) ? absint( $_GET['log_page'] ) : 1; - - $html = '
      '; - - $html .= '

      '; - /* translators: 1: items count (i.e. 8 items) 2: current page 3: total pages */ - $html .= sprintf( - __( '%1$s – Page %2$d of %3$d', 'woocommerce' ), - sprintf( _n( '%d item', '%d items', $total, 'woocommerce' ), $total ), - $current, - $pages - ); - $html .= '

      '; - - if ( 1 < $pages ) { - $html .= '

      '; - if ( 1 == $current ) { - $html .= ' '; - } else { - $html .= '' . __( '‹ Previous', 'woocommerce' ) . ' '; - } - - if ( $pages == $current ) { - $html .= ''; - } else { - $html .= '' . __( 'Next ›', 'woocommerce' ) . ''; - } - $html .= '

      '; - } - - $html .= '
      '; - - return $html; + wc_deprecated_function( 'WC_Admin_Webhooks::get_logs_navigation', '3.3' ); } } diff --git a/includes/admin/class-wc-admin.php b/includes/admin/class-wc-admin.php index 1ca5210d75a..0d95cb3b097 100644 --- a/includes/admin/class-wc-admin.php +++ b/includes/admin/class-wc-admin.php @@ -30,6 +30,7 @@ class WC_Admin { add_action( 'admin_init', array( $this, 'admin_redirects' ) ); add_action( 'admin_footer', 'wc_print_js', 25 ); add_filter( 'admin_footer_text', array( $this, 'admin_footer_text' ), 1 ); + add_action( 'wp_ajax_setup_wizard_check_jetpack', array( $this, 'setup_wizard_check_jetpack' ) ); } /** @@ -43,46 +44,46 @@ class WC_Admin { * Include any classes we need within admin. */ public function includes() { - include_once( dirname( __FILE__ ) . '/wc-admin-functions.php' ); - include_once( dirname( __FILE__ ) . '/wc-meta-box-functions.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-post-types.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-taxonomies.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-menus.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-customize.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-notices.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-assets.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-api-keys.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-webhooks.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-pointers.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-importers.php' ); - include_once( dirname( __FILE__ ) . '/class-wc-admin-exporters.php' ); + include_once dirname( __FILE__ ) . '/wc-admin-functions.php'; + include_once dirname( __FILE__ ) . '/wc-meta-box-functions.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-post-types.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-taxonomies.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-menus.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-customize.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-notices.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-assets.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-api-keys.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-webhooks.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-pointers.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-importers.php'; + include_once dirname( __FILE__ ) . '/class-wc-admin-exporters.php'; // Help Tabs if ( apply_filters( 'woocommerce_enable_admin_help_tab', true ) ) { - include_once( dirname( __FILE__ ) . '/class-wc-admin-help.php' ); + include_once dirname( __FILE__ ) . '/class-wc-admin-help.php'; } // Setup/welcome if ( ! empty( $_GET['page'] ) ) { switch ( $_GET['page'] ) { - case 'wc-setup' : - include_once( dirname( __FILE__ ) . '/class-wc-admin-setup-wizard.php' ); - break; + case 'wc-setup': + include_once dirname( __FILE__ ) . '/class-wc-admin-setup-wizard.php'; + break; } } // Importers if ( defined( 'WP_LOAD_IMPORTERS' ) ) { - include_once( dirname( __FILE__ ) . '/class-wc-admin-importers.php' ); + include_once dirname( __FILE__ ) . '/class-wc-admin-importers.php'; } // Helper - include_once( dirname( __FILE__ ) . '/helper/class-wc-helper-options.php' ); - include_once( dirname( __FILE__ ) . '/helper/class-wc-helper-api.php' ); - include_once( dirname( __FILE__ ) . '/helper/class-wc-helper-updater.php' ); - include_once( dirname( __FILE__ ) . '/helper/class-wc-helper-plugin-info.php' ); - include_once( dirname( __FILE__ ) . '/helper/class-wc-helper-compat.php' ); - include_once( dirname( __FILE__ ) . '/helper/class-wc-helper.php' ); + include_once dirname( __FILE__ ) . '/helper/class-wc-helper-options.php'; + include_once dirname( __FILE__ ) . '/helper/class-wc-helper-api.php'; + include_once dirname( __FILE__ ) . '/helper/class-wc-helper-updater.php'; + include_once dirname( __FILE__ ) . '/helper/class-wc-helper-plugin-info.php'; + include_once dirname( __FILE__ ) . '/helper/class-wc-helper-compat.php'; + include_once dirname( __FILE__ ) . '/helper/class-wc-helper.php'; } /** @@ -94,18 +95,25 @@ class WC_Admin { } switch ( $screen->id ) { - case 'dashboard' : - include( 'class-wc-admin-dashboard.php' ); - break; - case 'options-permalink' : - include( 'class-wc-admin-permalink-settings.php' ); - break; - case 'users' : - case 'user' : - case 'profile' : - case 'user-edit' : - include( 'class-wc-admin-profile.php' ); - break; + case 'dashboard': + case 'dashboard-network': + include 'class-wc-admin-dashboard.php'; + break; + case 'options-permalink': + include 'class-wc-admin-permalink-settings.php'; + break; + case 'plugins': + include 'plugin-updates/class-wc-plugins-screen-updates.php'; + break; + case 'update-core': + include 'plugin-updates/class-wc-updates-screen-updates.php'; + break; + case 'users': + case 'user': + case 'profile': + case 'user-edit': + include 'class-wc-admin-profile.php'; + break; } } @@ -152,7 +160,7 @@ class WC_Admin { public function prevent_admin_access() { $prevent_access = false; - if ( 'yes' === get_option( 'woocommerce_lock_down_admin', 'yes' ) && ! is_ajax() && basename( $_SERVER["SCRIPT_FILENAME"] ) !== 'admin-post.php' ) { + if ( 'yes' === get_option( 'woocommerce_lock_down_admin', 'yes' ) && ! is_ajax() && basename( $_SERVER['SCRIPT_FILENAME'] ) !== 'admin-post.php' ) { $has_cap = false; $access_caps = array( 'edit_posts', 'manage_woocommerce', 'view_admin_dashboard' ); @@ -176,8 +184,6 @@ class WC_Admin { /** * Preview email template. - * - * @return string */ public function preview_emails() { @@ -187,21 +193,21 @@ class WC_Admin { } // load the mailer class - $mailer = WC()->mailer(); + $mailer = WC()->mailer(); // get the preview email subject $email_heading = __( 'HTML email template', 'woocommerce' ); // get the preview email content ob_start(); - include( 'views/html-email-template-preview.php' ); - $message = ob_get_clean(); + include 'views/html-email-template-preview.php'; + $message = ob_get_clean(); // create a new email - $email = new WC_Email(); + $email = new WC_Email(); // wrap the content with the email template and then add styles - $message = apply_filters( 'woocommerce_mail_content', $email->style_inline( $mailer->wrap_message( $email_heading, $message ) ) ); + $message = apply_filters( 'woocommerce_mail_content', $email->style_inline( $mailer->wrap_message( $email_heading, $message ) ) ); // print the preview email echo $message; @@ -230,14 +236,18 @@ class WC_Admin { if ( isset( $current_screen->id ) && apply_filters( 'woocommerce_display_admin_footer_text', in_array( $current_screen->id, $wc_pages ) ) ) { // Change the footer text if ( ! get_option( 'woocommerce_admin_footer_text_rated' ) ) { - /* translators: %s: five stars */ - $footer_text = sprintf( __( 'If you like WooCommerce please leave us a %s rating. A huge thanks in advance!', 'woocommerce' ), '★★★★★' ); - wc_enqueue_js( " - jQuery( 'a.wc-rating-link' ).click( function() { + $footer_text = sprintf( + /* translators: 1: WooCommerce 2:: five stars */ + __( 'If you like %1$s please leave us a %2$s rating. A huge thanks in advance!', 'woocommerce' ), + sprintf( '%s', esc_html__( 'WooCommerce', 'woocommerce' ) ), + '★★★★★' + ); + wc_enqueue_js( + "jQuery( 'a.wc-rating-link' ).click( function() { jQuery.post( '" . WC()->ajax_url() . "', { action: 'woocommerce_rated' } ); jQuery( this ).parent().text( jQuery( this ).data( 'rated' ) ); - }); - " ); + });" + ); } else { $footer_text = __( 'Thank you for selling with WooCommerce.', 'woocommerce' ); } @@ -245,6 +255,21 @@ class WC_Admin { return $footer_text; } + + /** + * Check on a Jetpack install queued by the Setup Wizard. + * + * See: WC_Admin_Setup_Wizard::install_jetpack() + */ + public function setup_wizard_check_jetpack() { + $jetpack_active = class_exists( 'Jetpack' ); + + wp_send_json_success( + array( + 'is_active' => $jetpack_active ? 'yes' : 'no', + ) + ); + } } return new WC_Admin(); diff --git a/includes/admin/helper/class-wc-helper-api.php b/includes/admin/helper/class-wc-helper-api.php index f24775c2cc3..a5f159f95b9 100644 --- a/includes/admin/helper/class-wc-helper-api.php +++ b/includes/admin/helper/class-wc-helper-api.php @@ -26,15 +26,17 @@ class WC_Helper_API { * Perform an HTTP request to the Helper API. * * @param string $endpoint The endpoint to request. - * @param array $args Additional data for the request. Set authenticated to a truthy value to enable auth. + * @param array $args Additional data for the request. Set authenticated to a truthy value to enable auth. * - * @return array The response from wp_safe_remote_request() + * @return array|WP_Error The response from wp_safe_remote_request() */ public static function request( $endpoint, $args = array() ) { $url = self::url( $endpoint ); if ( ! empty( $args['authenticated'] ) ) { - self::_authenticate( $url, $args ); + if ( ! self::_authenticate( $url, $args ) ) { + return new WP_Error( 'authentication', 'Authentication failed.' ); + } } /** @@ -51,24 +53,27 @@ class WC_Helper_API { * Adds authentication headers to an HTTP request. * * @param string $url The request URI. - * @param array $args By-ref, the args that will be passed to wp_remote_request(). + * @param array $args By-ref, the args that will be passed to wp_remote_request(). + * @return bool Were the headers added? */ private static function _authenticate( $url, &$args ) { $auth = WC_Helper_Options::get( 'auth' ); + if ( empty( $auth['access_token'] ) || empty( $auth['access_token_secret'] ) ) { - return; + return false; } - $request_uri = parse_url( $url, PHP_URL_PATH ); + $request_uri = parse_url( $url, PHP_URL_PATH ); $query_string = parse_url( $url, PHP_URL_QUERY ); - if ( $query_string ) { + + if ( is_string( $query_string ) ) { $request_uri .= '?' . $query_string; } $data = array( - 'host' => parse_url( $url, PHP_URL_HOST ), + 'host' => parse_url( $url, PHP_URL_HOST ), 'request_uri' => $request_uri, - 'method' => ! empty( $args['method'] ) ? $args['method'] : 'GET', + 'method' => ! empty( $args['method'] ) ? $args['method'] : 'GET', ); if ( ! empty( $args['body'] ) ) { @@ -81,16 +86,18 @@ class WC_Helper_API { } $args['headers'] = array( - 'Authorization' => 'Bearer ' . $auth['access_token'], + 'Authorization' => 'Bearer ' . $auth['access_token'], 'X-Woo-Signature' => $signature, ); + + return true; } /** * Wrapper for self::request(). * * @param string $endpoint The helper API endpoint to request. - * @param array $args Arguments passed to wp_remote_request(). + * @param array $args Arguments passed to wp_remote_request(). * * @return array The response object from wp_safe_remote_request(). */ @@ -103,7 +110,7 @@ class WC_Helper_API { * Wrapper for self::request(). * * @param string $endpoint The helper API endpoint to request. - * @param array $args Arguments passed to wp_remote_request(). + * @param array $args Arguments passed to wp_remote_request(). * * @return array The response object from wp_safe_remote_request(). */ diff --git a/includes/admin/helper/class-wc-helper-compat.php b/includes/admin/helper/class-wc-helper-compat.php index 1a1eecc7b7c..e967da65e95 100644 --- a/includes/admin/helper/class-wc-helper-compat.php +++ b/includes/admin/helper/class-wc-helper-compat.php @@ -70,12 +70,15 @@ class WC_Helper_Compat { return; } - $request = WC_Helper_API::post( 'oauth/migrate', array( - 'body' => array( - 'home_url' => home_url(), - 'master_key' => $master_key, - ), - ) ); + $request = WC_Helper_API::post( + 'oauth/migrate', + array( + 'body' => array( + 'home_url' => home_url(), + 'master_key' => $master_key, + ), + ) + ); if ( is_wp_error( $request ) || wp_remote_retrieve_response_code( $request ) !== 200 ) { WC_Helper::log( 'Call to oauth/migrate returned a non-200 response code' ); @@ -89,13 +92,16 @@ class WC_Helper_Compat { } // Obtain an access token. - $request = WC_Helper_API::post( 'oauth/access_token', array( - 'body' => array( - 'request_token' => $request_token, - 'home_url' => home_url(), - 'migrate' => true, - ), - ) ); + $request = WC_Helper_API::post( + 'oauth/access_token', + array( + 'body' => array( + 'request_token' => $request_token, + 'home_url' => home_url(), + 'migrate' => true, + ), + ) + ); if ( is_wp_error( $request ) || wp_remote_retrieve_response_code( $request ) !== 200 ) { WC_Helper::log( 'Call to oauth/access_token returned a non-200 response code' ); @@ -108,13 +114,16 @@ class WC_Helper_Compat { return; } - WC_Helper_Options::update( 'auth', array( - 'access_token' => $access_token['access_token'], - 'access_token_secret' => $access_token['access_token_secret'], - 'site_id' => $access_token['site_id'], - 'user_id' => null, // Set this later - 'updated' => time(), - ) ); + WC_Helper_Options::update( + 'auth', + array( + 'access_token' => $access_token['access_token'], + 'access_token_secret' => $access_token['access_token_secret'], + 'site_id' => $access_token['site_id'], + 'user_id' => null, // Set this later + 'updated' => time(), + ) + ); // Obtain the connected user info. if ( ! WC_Helper::_flush_authentication_cache() ) { @@ -128,16 +137,30 @@ class WC_Helper_Compat { * Attempt to deactivate the legacy helper plugin. */ public static function deactivate_plugin() { - include_once( ABSPATH . 'wp-admin/includes/plugin.php' ); + include_once ABSPATH . 'wp-admin/includes/plugin.php'; if ( ! function_exists( 'deactivate_plugins' ) ) { return; } if ( is_plugin_active( 'woothemes-updater/woothemes-updater.php' ) ) { deactivate_plugins( 'woothemes-updater/woothemes-updater.php' ); + + // Notify the user when the plugin is deactivated. + add_action( 'pre_current_active_plugins', array( __CLASS__, 'plugin_deactivation_notice' ) ); } } + /** + * Display admin notice directing the user where to go. + */ + public static function plugin_deactivation_notice() { + ?> +
      +

      Manage subscriptions from the extensions tab instead.', 'woocommerce' ), esc_url( admin_url( 'admin.php?page=wc-addons§ion=helper' ) ) ); ?>

      +
      + 'wc-addons', - 'section' => 'helper', - ), admin_url( 'admin.php' ) ); - include( WC_Helper::get_view_filename( 'html-helper-compat.php' ) ); + $helper_url = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + ), admin_url( 'admin.php' ) + ); + include WC_Helper::get_view_filename( 'html-helper-compat.php' ); } } diff --git a/includes/admin/helper/class-wc-helper-options.php b/includes/admin/helper/class-wc-helper-options.php index b11612f4fd5..f0e811d8aeb 100644 --- a/includes/admin/helper/class-wc-helper-options.php +++ b/includes/admin/helper/class-wc-helper-options.php @@ -23,12 +23,12 @@ class WC_Helper_Options { * is not thread-safe, use with caution. * * @param string $key The key to update. - * @param mixed $value The new option value. + * @param mixed $value The new option value. * * @return bool True if the option has been updated. */ public static function update( $key, $value ) { - $options = get_option( self::$option_name, array() ); + $options = get_option( self::$option_name, array() ); $options[ $key ] = $value; return update_option( self::$option_name, $options, true ); } @@ -39,7 +39,7 @@ class WC_Helper_Options { * @see self::update * * @param string $key The key to fetch. - * @param mixed $default The default option to return if the key does not exist. + * @param mixed $default The default option to return if the key does not exist. * * @return mixed An option or the default. */ diff --git a/includes/admin/helper/class-wc-helper-plugin-info.php b/includes/admin/helper/class-wc-helper-plugin-info.php index 033ec8c0b3e..ef7b9204bcf 100644 --- a/includes/admin/helper/class-wc-helper-plugin-info.php +++ b/includes/admin/helper/class-wc-helper-plugin-info.php @@ -36,27 +36,32 @@ class WC_Helper_Plugin_Info { return $response; } - $found_plugin = null; - - // Look through local Woo plugins by slugs. - foreach ( WC_Helper::get_local_woo_plugins() as $plugin ) { - $slug = dirname( $plugin['_filename'] ); - if ( dirname( $plugin['_filename'] ) === $args->slug ) { - $plugin['_slug'] = $args->slug; - $found_plugin = $plugin; - break; - } - } - - if ( ! $found_plugin ) { + // Only for slugs that start with woo- + if ( 0 !== strpos( $args->slug, 'woocommerce-com-' ) ) { return $response; } + $clean_slug = str_replace( 'woocommerce-com-', '', $args->slug ); + + // Look through update data by slug. + $update_data = WC_Helper_Updater::get_update_data(); + $products = wp_list_filter( $update_data, array( 'slug' => $clean_slug ) ); + + if ( empty( $products ) ) { + return $response; + } + + $product_id = array_keys( $products ); + $product_id = array_shift( $product_id ); + // Fetch the product information from the Helper API. - $request = WC_Helper_API::get( add_query_arg( array( - 'product_id' => absint( $plugin['_product_id'] ), - 'product_slug' => rawurlencode( $plugin['_slug'] ), - ), 'info' ), array( 'authenticated' => true ) ); + $request = WC_Helper_API::get( + add_query_arg( + array( + 'product_id' => absint( $product_id ), + ), 'info' + ), array( 'authenticated' => true ) + ); $results = json_decode( wp_remote_retrieve_body( $request ), true ); if ( ! empty( $results ) ) { diff --git a/includes/admin/helper/class-wc-helper-updater.php b/includes/admin/helper/class-wc-helper-updater.php index 9a3024dd679..c4e6cd27f2a 100644 --- a/includes/admin/helper/class-wc-helper-updater.php +++ b/includes/admin/helper/class-wc-helper-updater.php @@ -17,6 +17,7 @@ class WC_Helper_Updater { public static function load() { add_action( 'pre_set_site_transient_update_plugins', array( __CLASS__, 'transient_update_plugins' ), 21, 1 ); add_action( 'pre_set_site_transient_update_themes', array( __CLASS__, 'transient_update_themes' ), 21, 1 ); + add_action( 'upgrader_process_complete', array( __CLASS__, 'upgrader_process_complete' ) ); } /** @@ -35,16 +36,16 @@ class WC_Helper_Updater { continue; } - $data = $update_data[ $plugin['_product_id'] ]; + $data = $update_data[ $plugin['_product_id'] ]; $filename = $plugin['_filename']; $item = array( - 'id' => 'woo-' . $plugin['_product_id'], - 'slug' => $data['slug'], - 'plugin' => $filename, - 'new_version' => $data['version'], - 'url' => $data['url'], - 'package' => '', + 'id' => 'woocommerce-com-' . $plugin['_product_id'], + 'slug' => 'woocommerce-com-' . $data['slug'], + 'plugin' => $filename, + 'new_version' => $data['version'], + 'url' => $data['url'], + 'package' => '', 'upgrade_notice' => $data['upgrade_notice'], ); @@ -84,10 +85,10 @@ class WC_Helper_Updater { $slug = $theme['_stylesheet']; $item = array( - 'theme' => $slug, + 'theme' => $slug, 'new_version' => $data['version'], - 'url' => $data['url'], - 'package' => '', + 'url' => $data['url'], + 'package' => '', ); if ( self::_has_active_subscription( $theme['_product_id'] ) ) { @@ -121,7 +122,7 @@ class WC_Helper_Updater { foreach ( WC_Helper::get_subscriptions() as $subscription ) { $payload[ $subscription['product_id'] ] = array( 'product_id' => $subscription['product_id'], - 'file_id' => '', + 'file_id' => '', ); } @@ -170,16 +171,18 @@ class WC_Helper_Updater { } $data = array( - 'hash' => $hash, - 'updated' => time(), + 'hash' => $hash, + 'updated' => time(), 'products' => array(), - 'errors' => array(), + 'errors' => array(), ); - $request = WC_Helper_API::post( 'update-check', array( - 'body' => json_encode( array( 'products' => $payload ) ), - 'authenticated' => true, - ) ); + $request = WC_Helper_API::post( + 'update-check', array( + 'body' => json_encode( array( 'products' => $payload ) ), + 'authenticated' => true, + ) + ); if ( wp_remote_retrieve_response_code( $request ) !== 200 ) { $data['errors'][] = 'http-error'; @@ -229,11 +232,90 @@ class WC_Helper_Updater { return false; } + /** + * Get the number of products that have updates. + * + * @return int The number of products with updates. + */ + public static function get_updates_count() { + $cache_key = '_woocommerce_helper_updates_count'; + if ( false !== ( $count = get_transient( $cache_key ) ) ) { + return $count; + } + + // Don't fetch any new data since this function in high-frequency. + if ( ! get_transient( '_woocommerce_helper_subscriptions' ) ) { + return 0; + } + + if ( ! get_transient( '_woocommerce_helper_updates' ) ) { + return 0; + } + + $count = 0; + $update_data = self::get_update_data(); + + if ( empty( $update_data ) ) { + set_transient( $cache_key, $count, 12 * HOUR_IN_SECONDS ); + return $count; + } + + // Scan local plugins. + foreach ( WC_Helper::get_local_woo_plugins() as $plugin ) { + if ( empty( $update_data[ $plugin['_product_id'] ] ) ) { + continue; + } + + if ( version_compare( $plugin['Version'], $update_data[ $plugin['_product_id'] ]['version'], '<' ) ) { + $count++; + } + } + + // Scan local themes. + foreach ( WC_Helper::get_local_woo_themes() as $theme ) { + if ( empty( $update_data[ $theme['_product_id'] ] ) ) { + continue; + } + + if ( version_compare( $theme['Version'], $update_data[ $theme['_product_id'] ]['version'], '<' ) ) { + $count++; + } + } + + set_transient( $cache_key, $count, 12 * HOUR_IN_SECONDS ); + return $count; + } + + /** + * Return the updates count markup. + * + * @return string Updates count markup, empty string if no updates avairable. + */ + public static function get_updates_count_html() { + $count = self::get_updates_count(); + if ( ! $count ) { + return ''; + } + + $count_html = sprintf( '%d', $count, number_format_i18n( $count ) ); + return $count_html; + } + /** * Flushes cached update data. */ public static function flush_updates_cache() { delete_transient( '_woocommerce_helper_updates' ); + delete_transient( '_woocommerce_helper_updates_count' ); + delete_site_transient( 'update_plugins' ); + delete_site_transient( 'update_themes' ); + } + + /** + * Fires when a user successfully updated a theme or a plugin. + */ + public static function upgrader_process_complete() { + delete_transient( '_woocommerce_helper_updates_count' ); } } diff --git a/includes/admin/helper/class-wc-helper.php b/includes/admin/helper/class-wc-helper.php index 44f1f267f61..7f05b4c5be4 100644 --- a/includes/admin/helper/class-wc-helper.php +++ b/includes/admin/helper/class-wc-helper.php @@ -41,7 +41,6 @@ class WC_Helper { // Add some nags about extension updates add_action( 'admin_notices', array( __CLASS__, 'admin_notices' ) ); - add_filter( 'woocommerce_in_plugin_update_message', array( __CLASS__, 'in_plugin_update_message' ) ); do_action( 'woocommerce_helper_loaded' ); } @@ -50,7 +49,7 @@ class WC_Helper { * Render the helper section content based on context. */ public static function render_helper_output() { - $auth = WC_Helper_Options::get( 'auth' ); + $auth = WC_Helper_Options::get( 'auth' ); $auth_user_data = WC_Helper_Options::get( 'auth_user_data' ); // Return success/error notices. @@ -58,64 +57,78 @@ class WC_Helper { // No active connection. if ( empty( $auth['access_token'] ) ) { - $connect_url = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-connect' => 1, - 'wc-helper-nonce' => wp_create_nonce( 'connect' ), - ), admin_url( 'admin.php' ) ); + $connect_url = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'wc-helper-connect' => 1, + 'wc-helper-nonce' => wp_create_nonce( 'connect' ), + ), admin_url( 'admin.php' ) + ); - include( self::get_view_filename( 'html-oauth-start.php' ) ); + include self::get_view_filename( 'html-oauth-start.php' ); return; } - $disconnect_url = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-disconnect' => 1, - 'wc-helper-nonce' => wp_create_nonce( 'disconnect' ), - ), admin_url( 'admin.php' ) ); + $disconnect_url = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'wc-helper-disconnect' => 1, + 'wc-helper-nonce' => wp_create_nonce( 'disconnect' ), + ), admin_url( 'admin.php' ) + ); - $refresh_url = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-refresh' => 1, - 'wc-helper-nonce' => wp_create_nonce( 'refresh' ), - ), admin_url( 'admin.php' ) ); + $current_filter = self::get_current_filter(); + $refresh_url = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'filter' => $current_filter, + 'wc-helper-refresh' => 1, + 'wc-helper-nonce' => wp_create_nonce( 'refresh' ), + ), admin_url( 'admin.php' ) + ); // Installed plugins and themes, with or without an active subscription. $woo_plugins = self::get_local_woo_plugins(); - $woo_themes = self::get_local_woo_themes(); + $woo_themes = self::get_local_woo_themes(); - $site_id = absint( $auth['site_id'] ); - $subscriptions = self::get_subscriptions(); - $updates = WC_Helper_Updater::get_update_data(); + $site_id = absint( $auth['site_id'] ); + $subscriptions = self::get_subscriptions(); + $updates = WC_Helper_Updater::get_update_data(); $subscriptions_product_ids = wp_list_pluck( $subscriptions, 'product_id' ); foreach ( $subscriptions as &$subscription ) { $subscription['active'] = in_array( $site_id, $subscription['connections'] ); - $subscription['activate_url'] = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-activate' => 1, - 'wc-helper-product-key' => $subscription['product_key'], - 'wc-helper-product-id' => $subscription['product_id'], - 'wc-helper-nonce' => wp_create_nonce( 'activate:' . $subscription['product_key'] ), - ), admin_url( 'admin.php' ) ); + $subscription['activate_url'] = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'filter' => $current_filter, + 'wc-helper-activate' => 1, + 'wc-helper-product-key' => $subscription['product_key'], + 'wc-helper-product-id' => $subscription['product_id'], + 'wc-helper-nonce' => wp_create_nonce( 'activate:' . $subscription['product_key'] ), + ), admin_url( 'admin.php' ) + ); - $subscription['deactivate_url'] = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-deactivate' => 1, - 'wc-helper-product-key' => $subscription['product_key'], - 'wc-helper-product-id' => $subscription['product_id'], - 'wc-helper-nonce' => wp_create_nonce( 'deactivate:' . $subscription['product_key'] ), - ), admin_url( 'admin.php' ) ); + $subscription['deactivate_url'] = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'filter' => $current_filter, + 'wc-helper-deactivate' => 1, + 'wc-helper-product-key' => $subscription['product_key'], + 'wc-helper-product-id' => $subscription['product_id'], + 'wc-helper-nonce' => wp_create_nonce( 'deactivate:' . $subscription['product_key'] ), + ), admin_url( 'admin.php' ) + ); $subscription['local'] = array( 'installed' => false, - 'active' => false, - 'version' => null, + 'active' => false, + 'version' => null, ); $subscription['update_url'] = admin_url( 'update-core.php' ); @@ -123,9 +136,9 @@ class WC_Helper { $local = wp_list_filter( array_merge( $woo_plugins, $woo_themes ), array( '_product_id' => $subscription['product_id'] ) ); if ( ! empty( $local ) ) { - $local = array_shift( $local ); + $local = array_shift( $local ); $subscription['local']['installed'] = true; - $subscription['local']['version'] = $local['Version']; + $subscription['local']['version'] = $local['Version']; if ( 'plugin' == $local['_type'] ) { if ( is_plugin_active( $local['_filename'] ) ) { @@ -153,7 +166,7 @@ class WC_Helper { } $subscription['download_primary'] = true; - $subscription['download_url'] = $subscription['product_url']; + $subscription['download_url'] = $subscription['product_url']; if ( ! $subscription['local']['installed'] && ! empty( $updates[ $subscription['product_id'] ] ) ) { $subscription['download_url'] = $updates[ $subscription['product_id'] ]['package']; } @@ -163,18 +176,18 @@ class WC_Helper { if ( $subscription['has_update'] && ! $subscription['expired'] ) { $action = array( /* translators: %s: version number */ - 'message' => sprintf( __( 'Version %s is available.', 'woocommerce' ), esc_html( $updates[ $subscription['product_id'] ]['version'] ) ), + 'message' => sprintf( __( 'Version %s is available.', 'woocommerce' ), esc_html( $updates[ $subscription['product_id'] ]['version'] ) ), 'button_label' => __( 'Update', 'woocommerce' ), - 'button_url' => $subscription['update_url'], - 'status' => 'update-available', - 'icon' => 'dashicons-update', + 'button_url' => $subscription['update_url'], + 'status' => 'update-available', + 'icon' => 'dashicons-update', ); // Subscription is not active on this site. if ( ! $subscription['active'] ) { - $action['message'] .= ' ' . __( 'To enable this update you need to activate this subscription.', 'woocommerce' ); + $action['message'] .= ' ' . __( 'To enable this update you need to activate this subscription.', 'woocommerce' ); $action['button_label'] = null; - $action['button_url'] = null; + $action['button_url'] = null; } $subscription['actions'][] = $action; @@ -184,30 +197,30 @@ class WC_Helper { $action = array( /* translators: %s: version number */ 'message' => sprintf( __( 'Version %s is available.', 'woocommerce' ), esc_html( $updates[ $subscription['product_id'] ]['version'] ) ), - 'status' => 'expired', - 'icon' => 'dashicons-info', + 'status' => 'expired', + 'icon' => 'dashicons-info', ); - $action['message'] .= ' ' . __( 'To enable this update you need to purchase a new subscription.', 'woocommerce' ); + $action['message'] .= ' ' . __( 'To enable this update you need to purchase a new subscription.', 'woocommerce' ); $action['button_label'] = __( 'Purchase', 'woocommerce' ); - $action['button_url'] = $subscription['product_url']; + $action['button_url'] = $subscription['product_url']; $subscription['actions'][] = $action; } elseif ( $subscription['expired'] && ! empty( $subscription['master_user_email'] ) ) { $action = array( 'message' => sprintf( __( 'This subscription has expired. Contact the owner to renew the subscription to receive updates and support.', 'woocommerce' ) ), - 'status' => 'expired', - 'icon' => 'dashicons-info', + 'status' => 'expired', + 'icon' => 'dashicons-info', ); $subscription['actions'][] = $action; } elseif ( $subscription['expired'] ) { $action = array( - 'message' => sprintf( __( 'This subscription has expired. Please renew to receive updates and support.', 'woocommerce' ) ), + 'message' => sprintf( __( 'This subscription has expired. Please renew to receive updates and support.', 'woocommerce' ) ), 'button_label' => __( 'Renew', 'woocommerce' ), - 'button_url' => 'https://woocommerce.com/my-account/my-subscriptions/', - 'status' => 'expired', - 'icon' => 'dashicons-info', + 'button_url' => 'https://woocommerce.com/my-account/my-subscriptions/', + 'status' => 'expired', + 'icon' => 'dashicons-info', ); $subscription['actions'][] = $action; @@ -215,26 +228,26 @@ class WC_Helper { if ( $subscription['expiring'] && ! $subscription['autorenew'] ) { $action = array( - 'message' => __( 'Subscription is expiring soon.', 'woocommerce' ), + 'message' => __( 'Subscription is expiring soon.', 'woocommerce' ), 'button_label' => __( 'Enable auto-renew', 'woocommerce' ), - 'button_url' => 'https://woocommerce.com/my-account/my-subscriptions/', - 'status' => 'expired', - 'icon' => 'dashicons-info', + 'button_url' => 'https://woocommerce.com/my-account/my-subscriptions/', + 'status' => 'expired', + 'icon' => 'dashicons-info', ); $subscription['download_primary'] = false; - $subscription['actions'][] = $action; + $subscription['actions'][] = $action; } elseif ( $subscription['expiring'] ) { $action = array( - 'message' => sprintf( __( 'This subscription is expiring soon. Please renew to continue receiving updates and support.', 'woocommerce' ) ), + 'message' => sprintf( __( 'This subscription is expiring soon. Please renew to continue receiving updates and support.', 'woocommerce' ) ), 'button_label' => __( 'Renew', 'woocommerce' ), - 'button_url' => 'https://woocommerce.com/my-account/my-subscriptions/', - 'status' => 'expired', - 'icon' => 'dashicons-info', + 'button_url' => 'https://woocommerce.com/my-account/my-subscriptions/', + 'status' => 'expired', + 'icon' => 'dashicons-info', ); $subscription['download_primary'] = false; - $subscription['actions'][] = $action; + $subscription['actions'][] = $action; } // Mark the first action primary. @@ -257,7 +270,7 @@ class WC_Helper { } $data['_product_url'] = '#'; - $data['_has_update'] = false; + $data['_has_update'] = false; if ( ! empty( $updates[ $data['_product_id'] ] ) ) { $data['_has_update'] = version_compare( $updates[ $data['_product_id'] ]['version'], $data['Version'], '>' ); @@ -273,21 +286,22 @@ class WC_Helper { if ( $data['_has_update'] ) { $action = array( - 'message' => sprintf( __( 'Version %s is available. To enable this update you need to purchase a new subscription.', 'woocommerce' ), esc_html( $updates[ $data['_product_id'] ]['version'] ) ), + 'message' => sprintf( __( 'Version %s is available. To enable this update you need to purchase a new subscription.', 'woocommerce' ), esc_html( $updates[ $data['_product_id'] ]['version'] ) ), 'button_label' => __( 'Purchase', 'woocommerce' ), - 'button_url' => $data['_product_url'], - 'status' => 'expired', - 'icon' => 'dashicons-info', + 'button_url' => $data['_product_url'], + 'status' => 'expired', + 'icon' => 'dashicons-info', ); $data['_actions'][] = $action; } else { $action = array( - 'message' => sprintf( __( 'To receive updates and support for this extension, you need to purchase a new subscription or be added as a collaborator.', 'woocommerce' ), 'https://docs.woocommerce.com/document/adding-collaborators/' ), + /* translators: 1: subscriptions docs 2: subscriptions docs */ + 'message' => sprintf( __( 'To receive updates and support for this extension, you need to purchase a new subscription or consolidate your extensions to one connected account by sharing or transferring this extension to this connected account.', 'woocommerce' ), 'https://docs.woocommerce.com/document/managing-woocommerce-com-subscriptions/#section-10', 'https://docs.woocommerce.com/document/managing-woocommerce-com-subscriptions/#section-5' ), 'button_label' => __( 'Purchase', 'woocommerce' ), - 'button_url' => $data['_product_url'], - 'status' => 'expired', - 'icon' => 'dashicons-info', + 'button_url' => $data['_product_url'], + 'status' => 'expired', + 'icon' => 'dashicons-info', ); $data['_actions'][] = $action; @@ -306,11 +320,125 @@ class WC_Helper { uasort( $subscriptions, array( __CLASS__, '_sort_by_product_name' ) ); uasort( $no_subscriptions, array( __CLASS__, '_sort_by_name' ) ); + // Filters + self::get_filters_counts( $subscriptions ); // Warm it up. + self::_filter( $subscriptions, self::get_current_filter() ); + // We have an active connection. - include( self::get_view_filename( 'html-main.php' ) ); + include self::get_view_filename( 'html-main.php' ); return; } + /** + * Get available subscriptions filters. + * + * @return array An array of filter keys and labels. + */ + public static function get_filters() { + $filters = array( + 'all' => __( 'All', 'woocommerce' ), + 'active' => __( 'Active', 'woocommerce' ), + 'inactive' => __( 'Inactive', 'woocommerce' ), + 'installed' => __( 'Installed', 'woocommerce' ), + 'update-available' => __( 'Update Available', 'woocommerce' ), + 'expiring' => __( 'Expiring Soon', 'woocommerce' ), + 'expired' => __( 'Expired', 'woocommerce' ), + 'download' => __( 'Download', 'woocommerce' ), + ); + + return $filters; + } + + /** + * Get counts data for the filters array. + * + * @param array $subscriptions The array of all available subscriptions. + * + * @return array Filter counts (filter => count) + */ + public static function get_filters_counts( $subscriptions = null ) { + static $filters; + + if ( isset( $filters ) ) { + return $filters; + } + + $filters = array_fill_keys( array_keys( self::get_filters() ), 0 ); + if ( empty( $subscriptions ) ) { + return array(); + } + + foreach ( $filters as $key => $count ) { + $_subs = $subscriptions; + self::_filter( $_subs, $key ); + $filters[ $key ] = count( $_subs ); + } + + return $filters; + } + + /** + * Get current filter. + * + * @return string The current filter. + */ + public static function get_current_filter() { + $current_filter = 'all'; + $valid_filters = array_keys( self::get_filters() ); + + if ( ! empty( $_GET['filter'] ) && in_array( $_GET['filter'], $valid_filters ) ) { + $current_filter = $_GET['filter']; + } + + return $current_filter; + } + + /** + * Filter an array of subscriptions by $filter. + * + * @param array $subscriptions The subscriptions array, passed by ref. + * @param string $filter The filter. + */ + private static function _filter( &$subscriptions, $filter ) { + switch ( $filter ) { + case 'active': + $subscriptions = wp_list_filter( $subscriptions, array( 'active' => true ) ); + break; + + case 'inactive': + $subscriptions = wp_list_filter( $subscriptions, array( 'active' => false ) ); + break; + + case 'installed': + foreach ( $subscriptions as $key => $subscription ) { + if ( empty( $subscription['local']['installed'] ) ) { + unset( $subscriptions[ $key ] ); + } + } + break; + + case 'update-available': + $subscriptions = wp_list_filter( $subscriptions, array( 'has_update' => true ) ); + break; + + case 'expiring': + $subscriptions = wp_list_filter( $subscriptions, array( 'expiring' => true ) ); + break; + + case 'expired': + $subscriptions = wp_list_filter( $subscriptions, array( 'expired' => true ) ); + break; + + case 'download': + foreach ( $subscriptions as $key => $subscription ) { + if ( $subscription['local']['installed'] || $subscription['expired'] ) { + unset( $subscriptions[ $key ] ); + } + } + break; + } + } + /** * Enqueue admin scripts and styles. */ @@ -333,105 +461,122 @@ class WC_Helper { */ private static function _get_return_notices() { $return_status = isset( $_GET['wc-helper-status'] ) ? $_GET['wc-helper-status'] : null; - $notices = array(); + $notices = array(); switch ( $return_status ) { case 'activate-success': $subscription = self::_get_subscriptions_from_product_id( absint( $_GET['wc-helper-product-id'] ) ); - $notices[] = array( - 'type' => 'updated', + $notices[] = array( + 'type' => 'updated', /* translators: %s: product name */ - 'message' => sprintf( __( '%s activated successfully. You will now receive updates for this product.', 'woocommerce' ), - '' . esc_html( $subscription['product_name'] ) . '' ), + 'message' => sprintf( + __( '%s activated successfully. You will now receive updates for this product.', 'woocommerce' ), + '' . esc_html( $subscription['product_name'] ) . '' + ), ); break; case 'activate-error': $subscription = self::_get_subscriptions_from_product_id( absint( $_GET['wc-helper-product-id'] ) ); - $notices[] = array( - 'type' => 'error', + $notices[] = array( + 'type' => 'error', /* translators: %s: product name */ - 'message' => sprintf( __( 'An error has occurred when activating %s. Please try again later.', 'woocommerce' ), - '' . esc_html( $subscription['product_name'] ) . '' ), + 'message' => sprintf( + __( 'An error has occurred when activating %s. Please try again later.', 'woocommerce' ), + '' . esc_html( $subscription['product_name'] ) . '' + ), ); break; case 'deactivate-success': $subscription = self::_get_subscriptions_from_product_id( absint( $_GET['wc-helper-product-id'] ) ); - $local = self::_get_local_from_product_id( absint( $_GET['wc-helper-product-id'] ) ); + $local = self::_get_local_from_product_id( absint( $_GET['wc-helper-product-id'] ) ); /* translators: %s: product name */ - $message = sprintf( __( 'Subscription for %s deactivated successfully. You will no longer receive updates for this product.', 'woocommerce' ), - '' . esc_html( $subscription['product_name'] ) . '' ); + $message = sprintf( + __( 'Subscription for %s deactivated successfully. You will no longer receive updates for this product.', 'woocommerce' ), + '' . esc_html( $subscription['product_name'] ) . '' + ); if ( $local && is_plugin_active( $local['_filename'] ) && current_user_can( 'activate_plugins' ) ) { - $deactivate_plugin_url = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-deactivate-plugin' => 1, - 'wc-helper-product-id' => $subscription['product_id'], - 'wc-helper-nonce' => wp_create_nonce( 'deactivate-plugin:' . $subscription['product_id'] ), - ), admin_url( 'admin.php' ) ); + $deactivate_plugin_url = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'filter' => self::get_current_filter(), + 'wc-helper-deactivate-plugin' => 1, + 'wc-helper-product-id' => $subscription['product_id'], + 'wc-helper-nonce' => wp_create_nonce( 'deactivate-plugin:' . $subscription['product_id'] ), + ), admin_url( 'admin.php' ) + ); /* translators: %1$s: product name, %2$s: deactivate url */ - $message = sprintf( __( 'Subscription for %1$s deactivated successfully. You will no longer receive updates for this product. Click here if you wish to deactive the plugin as well.', 'woocommerce' ), - '' . esc_html( $subscription['product_name'] ) . '', esc_url( $deactivate_plugin_url ) ); + $message = sprintf( + __( 'Subscription for %1$s deactivated successfully. You will no longer receive updates for this product. Click here if you wish to deactivate the plugin as well.', 'woocommerce' ), + '' . esc_html( $subscription['product_name'] ) . '', esc_url( $deactivate_plugin_url ) + ); } $notices[] = array( 'message' => $message, - 'type' => 'updated', + 'type' => 'updated', ); break; case 'deactivate-error': $subscription = self::_get_subscriptions_from_product_id( absint( $_GET['wc-helper-product-id'] ) ); - $notices[] = array( - 'type' => 'error', + $notices[] = array( + 'type' => 'error', /* translators: %s: product name */ - 'message' => sprintf( __( 'An error has occurred when deactivating the subscription for %s. Please try again later.', 'woocommerce' ), - '' . esc_html( $subscription['product_name'] ) . '' ), + 'message' => sprintf( + __( 'An error has occurred when deactivating the subscription for %s. Please try again later.', 'woocommerce' ), + '' . esc_html( $subscription['product_name'] ) . '' + ), ); break; case 'deactivate-plugin-success': $subscription = self::_get_subscriptions_from_product_id( absint( $_GET['wc-helper-product-id'] ) ); - $notices[] = array( - 'type' => 'updated', + $notices[] = array( + 'type' => 'updated', /* translators: %s: product name */ - 'message' => sprintf( __( 'The extension %s has been deactivated successfully.', 'woocommerce' ), - '' . esc_html( $subscription['product_name'] ) . '' ), + 'message' => sprintf( + __( 'The extension %s has been deactivated successfully.', 'woocommerce' ), + '' . esc_html( $subscription['product_name'] ) . '' + ), ); break; case 'deactivate-plugin-error': $subscription = self::_get_subscriptions_from_product_id( absint( $_GET['wc-helper-product-id'] ) ); - $notices[] = array( - 'type' => 'error', + $notices[] = array( + 'type' => 'error', /* translators: %1$s: product name, %2$s: plugins screen url */ - 'message' => sprintf( __( 'An error has occurred when deactivating the extension %1$s. Please proceed to the Plugins screen to deactivate it manually.', 'woocommerce' ), - '' . esc_html( $subscription['product_name'] ) . '', admin_url( 'plugins.php' ) ), + 'message' => sprintf( + __( 'An error has occurred when deactivating the extension %1$s. Please proceed to the Plugins screen to deactivate it manually.', 'woocommerce' ), + '' . esc_html( $subscription['product_name'] ) . '', admin_url( 'plugins.php' ) + ), ); break; case 'helper-connected': $notices[] = array( 'message' => __( 'You have successfully connected your store to WooCommerce.com', 'woocommerce' ), - 'type' => 'updated', + 'type' => 'updated', ); break; case 'helper-disconnected': $notices[] = array( 'message' => __( 'You have successfully disconnected your store from WooCommerce.com', 'woocommerce' ), - 'type' => 'updated', + 'type' => 'updated', ); break; case 'helper-refreshed': $notices[] = array( 'message' => __( 'Authentication and subscription caches refreshed successfully.', 'woocommerce' ), - 'type' => 'updated', + 'type' => 'updated', ); break; } @@ -491,19 +636,23 @@ class WC_Helper { wp_die( 'Could not verify nonce' ); } - $redirect_uri = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-return' => 1, - 'wc-helper-nonce' => wp_create_nonce( 'connect' ), - ), admin_url( 'admin.php' ) ); + $redirect_uri = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'wc-helper-return' => 1, + 'wc-helper-nonce' => wp_create_nonce( 'connect' ), + ), admin_url( 'admin.php' ) + ); - $request = WC_Helper_API::post( 'oauth/request_token', array( - 'body' => array( - 'home_url' => home_url(), - 'redirect_uri' => $redirect_uri, - ), - ) ); + $request = WC_Helper_API::post( + 'oauth/request_token', array( + 'body' => array( + 'home_url' => home_url(), + 'redirect_uri' => $redirect_uri, + ), + ) + ); $code = wp_remote_retrieve_response_code( $request ); @@ -518,11 +667,13 @@ class WC_Helper { wp_die( 'Something went wrong' ); } - $connect_url = add_query_arg( array( - 'home_url' => rawurlencode( home_url() ), - 'redirect_uri' => rawurlencode( $redirect_uri ), - 'secret' => rawurlencode( $secret ), - ), WC_Helper_API::url( 'oauth/authorize' ) ); + $connect_url = add_query_arg( + array( + 'home_url' => rawurlencode( home_url() ), + 'redirect_uri' => rawurlencode( $redirect_uri ), + 'secret' => rawurlencode( $secret ), + ), WC_Helper_API::url( 'oauth/authorize' ) + ); wp_redirect( esc_url_raw( $connect_url ) ); die(); @@ -550,12 +701,14 @@ class WC_Helper { } // Obtain an access token. - $request = WC_Helper_API::post( 'oauth/access_token', array( - 'body' => array( - 'request_token' => $_GET['request_token'], - 'home_url' => home_url(), - ), - ) ); + $request = WC_Helper_API::post( + 'oauth/access_token', array( + 'body' => array( + 'request_token' => $_GET['request_token'], + 'home_url' => home_url(), + ), + ) + ); $code = wp_remote_retrieve_response_code( $request ); @@ -570,13 +723,15 @@ class WC_Helper { wp_die( 'Something went wrong' ); } - WC_Helper_Options::update( 'auth', array( - 'access_token' => $access_token['access_token'], - 'access_token_secret' => $access_token['access_token_secret'], - 'site_id' => $access_token['site_id'], - 'user_id' => get_current_user_id(), - 'updated' => time(), - ) ); + WC_Helper_Options::update( + 'auth', array( + 'access_token' => $access_token['access_token'], + 'access_token_secret' => $access_token['access_token_secret'], + 'site_id' => $access_token['site_id'], + 'user_id' => get_current_user_id(), + 'updated' => time(), + ) + ); // Obtain the connected user info. if ( ! self::_flush_authentication_cache() ) { @@ -586,6 +741,7 @@ class WC_Helper { } self::_flush_subscriptions_cache(); + self::_flush_updates_cache(); // Enable tracking when connected. if ( class_exists( 'WC_Tracker' ) ) { @@ -593,11 +749,15 @@ class WC_Helper { WC_Tracker::send_tracking_data( true ); } - wp_safe_redirect( add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-status' => 'helper-connected', - ), admin_url( 'admin.php' ) ) ); + wp_safe_redirect( + add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'wc-helper-status' => 'helper-connected', + ), admin_url( 'admin.php' ) + ) + ); die(); } @@ -610,15 +770,19 @@ class WC_Helper { wp_die( 'Could not verify nonce' ); } - $redirect_uri = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-status' => 'helper-disconnected', - ), admin_url( 'admin.php' ) ); + $redirect_uri = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'wc-helper-status' => 'helper-disconnected', + ), admin_url( 'admin.php' ) + ); - $result = WC_Helper_API::post( 'oauth/invalidate_token', array( - 'authenticated' => true, - ) ); + WC_Helper_API::post( + 'oauth/invalidate_token', array( + 'authenticated' => true, + ) + ); WC_Helper_Options::update( 'auth', array() ); WC_Helper_Options::update( 'auth_user_data', array() ); @@ -642,11 +806,14 @@ class WC_Helper { wp_die( 'Could not verify nonce' ); } - $redirect_uri = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-status' => 'helper-refreshed', - ), admin_url( 'admin.php' ) ); + $redirect_uri = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'filter' => self::get_current_filter(), + 'wc-helper-status' => 'helper-refreshed', + ), admin_url( 'admin.php' ) + ); self::_flush_authentication_cache(); self::_flush_subscriptions_cache(); @@ -661,22 +828,26 @@ class WC_Helper { */ private static function _helper_subscription_activate() { $product_key = $_GET['wc-helper-product-key']; - $product_id = absint( $_GET['wc-helper-product-id'] ); + $product_id = absint( $_GET['wc-helper-product-id'] ); if ( empty( $_GET['wc-helper-nonce'] ) || ! wp_verify_nonce( $_GET['wc-helper-nonce'], 'activate:' . $product_key ) ) { self::log( 'Could not verify nonce in _helper_subscription_activate' ); wp_die( 'Could not verify nonce' ); } - $request = WC_Helper_API::post( 'activate', array( - 'authenticated' => true, - 'body' => json_encode( array( - 'product_key' => $product_key, - ) ), - ) ); + $request = WC_Helper_API::post( + 'activate', array( + 'authenticated' => true, + 'body' => json_encode( + array( + 'product_key' => $product_key, + ) + ), + ) + ); $activated = wp_remote_retrieve_response_code( $request ) === 200; - $body = json_decode( wp_remote_retrieve_body( $request ), true ); + $body = json_decode( wp_remote_retrieve_body( $request ), true ); if ( ! $activated && ! empty( $body['code'] ) && 'already_connected' == $body['code'] ) { $activated = true; } @@ -688,12 +859,17 @@ class WC_Helper { } self::_flush_subscriptions_cache(); - $redirect_uri = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-status' => $activated ? 'activate-success' : 'activate-error', - 'wc-helper-product-id' => $product_id, - ), admin_url( 'admin.php' ) ); + self::_flush_updates_cache(); + + $redirect_uri = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'filter' => self::get_current_filter(), + 'wc-helper-status' => $activated ? 'activate-success' : 'activate-error', + 'wc-helper-product-id' => $product_id, + ), admin_url( 'admin.php' ) + ); wp_safe_redirect( $redirect_uri ); die(); @@ -704,33 +880,40 @@ class WC_Helper { */ private static function _helper_subscription_deactivate() { $product_key = $_GET['wc-helper-product-key']; - $product_id = absint( $_GET['wc-helper-product-id'] ); + $product_id = absint( $_GET['wc-helper-product-id'] ); if ( empty( $_GET['wc-helper-nonce'] ) || ! wp_verify_nonce( $_GET['wc-helper-nonce'], 'deactivate:' . $product_key ) ) { self::log( 'Could not verify nonce in _helper_subscription_deactivate' ); wp_die( 'Could not verify nonce' ); } - $request = WC_Helper_API::post( 'deactivate', array( - 'authenticated' => true, - 'body' => json_encode( array( - 'product_key' => $product_key, - ) ), - ) ); + $request = WC_Helper_API::post( + 'deactivate', array( + 'authenticated' => true, + 'body' => json_encode( + array( + 'product_key' => $product_key, + ) + ), + ) + ); - $code = wp_remote_retrieve_response_code( $request ); + $code = wp_remote_retrieve_response_code( $request ); $deactivated = 200 === $code; if ( ! $deactivated ) { self::log( sprintf( 'Deactivate API call returned a non-200 response code (%d)', $code ) ); } self::_flush_subscriptions_cache(); - $redirect_uri = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-status' => $deactivated ? 'deactivate-success' : 'deactivate-error', - 'wc-helper-product-id' => $product_id, - ), admin_url( 'admin.php' ) ); + $redirect_uri = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'filter' => self::get_current_filter(), + 'wc-helper-status' => $deactivated ? 'deactivate-success' : 'deactivate-error', + 'wc-helper-product-id' => $product_id, + ), admin_url( 'admin.php' ) + ); wp_safe_redirect( $redirect_uri ); die(); @@ -740,7 +923,7 @@ class WC_Helper { * Deactivate a plugin. */ private static function _helper_plugin_deactivate() { - $product_id = absint( $_GET['wc-helper-product-id'] ); + $product_id = absint( $_GET['wc-helper-product-id'] ); $deactivated = false; if ( empty( $_GET['wc-helper-nonce'] ) || ! wp_verify_nonce( $_GET['wc-helper-nonce'], 'deactivate-plugin:' . $product_id ) ) { @@ -752,8 +935,12 @@ class WC_Helper { wp_die( 'You are not allowed to manage plugins on this site.' ); } - $local = wp_list_filter( array_merge( self::get_local_woo_plugins(), - self::get_local_woo_themes() ), array( '_product_id' => $product_id ) ); + $local = wp_list_filter( + array_merge( + self::get_local_woo_plugins(), + self::get_local_woo_themes() + ), array( '_product_id' => $product_id ) + ); // Attempt to deactivate this plugin or theme. if ( ! empty( $local ) ) { @@ -765,12 +952,15 @@ class WC_Helper { $deactivated = ! is_plugin_active( $local['_filename'] ); } - $redirect_uri = add_query_arg( array( - 'page' => 'wc-addons', - 'section' => 'helper', - 'wc-helper-status' => $deactivated ? 'deactivate-plugin-success' : 'deactivate-plugin-error', - 'wc-helper-product-id' => $product_id, - ), admin_url( 'admin.php' ) ); + $redirect_uri = add_query_arg( + array( + 'page' => 'wc-addons', + 'section' => 'helper', + 'filter' => self::get_current_filter(), + 'wc-helper-status' => $deactivated ? 'deactivate-plugin-success' : 'deactivate-plugin-error', + 'wc-helper-product-id' => $product_id, + ), admin_url( 'admin.php' ) + ); wp_safe_redirect( $redirect_uri ); die(); @@ -784,8 +974,12 @@ class WC_Helper { * @return array|bool The array containing the local plugin/theme data or false. */ private static function _get_local_from_product_id( $product_id ) { - $local = wp_list_filter( array_merge( self::get_local_woo_plugins(), - self::get_local_woo_themes() ), array( '_product_id' => $product_id ) ); + $local = wp_list_filter( + array_merge( + self::get_local_woo_plugins(), + self::get_local_woo_themes() + ), array( '_product_id' => $product_id ) + ); if ( ! empty( $local ) ) { return array_shift( $local ); @@ -800,7 +994,7 @@ class WC_Helper { * first one in the list, so you can use this method to get things like extension * name, version, etc. * - * @param int $product_id The product id. + * @param int $product_id The product id. * @param bool $single Whether to return a single subscription or all matching a product id. * * @return array|bool The array containing sub data or false. @@ -829,19 +1023,19 @@ class WC_Helper { */ public static function get_local_woo_plugins() { if ( ! function_exists( 'get_plugins' ) ) { - require_once( ABSPATH . 'wp-admin/includes/plugin.php' ); + require_once ABSPATH . 'wp-admin/includes/plugin.php'; } - $plugins = get_plugins(); + $plugins = get_plugins(); $woo_plugins = array(); - // Back-compat for woothemes_queue_update(). + // Backwards compatibility for woothemes_queue_update(). $_compat = array(); if ( ! empty( $GLOBALS['woothemes_queued_updates'] ) ) { foreach ( $GLOBALS['woothemes_queued_updates'] as $_compat_plugin ) { $_compat[ $_compat_plugin->file ] = array( 'product_id' => $_compat_plugin->product_id, - 'file_id' => $_compat_plugin->file_id, + 'file_id' => $_compat_plugin->file_id, ); } } @@ -860,10 +1054,10 @@ class WC_Helper { continue; } - $data['_filename'] = $filename; - $data['_product_id'] = absint( $product_id ); - $data['_file_id'] = $file_id; - $data['_type'] = 'plugin'; + $data['_filename'] = $filename; + $data['_product_id'] = absint( $product_id ); + $data['_file_id'] = $file_id; + $data['_type'] = 'plugin'; $woo_plugins[ $filename ] = $data; } @@ -874,18 +1068,18 @@ class WC_Helper { * Get locally installed Woo themes. */ public static function get_local_woo_themes() { - $themes = wp_get_themes(); + $themes = wp_get_themes(); $woo_themes = array(); foreach ( $themes as $theme ) { $header = $theme->get( 'Woo' ); - // Back-compat for theme_info.txt + // Backwards compatibility for theme_info.txt if ( ! $header ) { $txt = $theme->get_stylesheet_directory() . '/theme_info.txt'; if ( is_readable( $txt ) ) { $txt = file_get_contents( $txt ); - $txt = preg_split( "#\s#", $txt ); + $txt = preg_split( '#\s#', $txt ); if ( count( $txt ) >= 2 ) { $header = sprintf( '%d:%s', $txt[0], $txt[1] ); } @@ -902,15 +1096,15 @@ class WC_Helper { } $data = array( - 'Name' => $theme->get( 'Name' ), - 'Version' => $theme->get( 'Version' ), - 'Woo' => $header, + 'Name' => $theme->get( 'Name' ), + 'Version' => $theme->get( 'Version' ), + 'Woo' => $header, - '_filename' => $theme->get_stylesheet() . '/style.css', + '_filename' => $theme->get_stylesheet() . '/style.css', '_stylesheet' => $theme->get_stylesheet(), '_product_id' => absint( $product_id ), - '_file_id' => $file_id, - '_type' => 'theme', + '_file_id' => $file_id, + '_type' => 'theme', ); $woo_themes[ $data['_filename'] ] = $data; @@ -931,9 +1125,11 @@ class WC_Helper { } // Obtain the connected user info. - $request = WC_Helper_API::get( 'subscriptions', array( - 'authenticated' => true, - ) ); + $request = WC_Helper_API::get( + 'subscriptions', array( + 'authenticated' => true, + ) + ); if ( wp_remote_retrieve_response_code( $request ) !== 200 ) { set_transient( $cache_key, array(), 15 * MINUTE_IN_SECONDS ); @@ -972,7 +1168,7 @@ class WC_Helper { return; } - $plugin = $plugins[ $filename ]; + $plugin = $plugins[ $filename ]; $subscriptions = self::_get_subscriptions_from_product_id( $plugin['_product_id'], false ); // No valid subscriptions for this product @@ -989,7 +1185,7 @@ class WC_Helper { } // No more sites available in this subscription. - if ( $_sub['sites_active'] >= $_sub['sites_max'] ) { + if ( $_sub['sites_max'] && $_sub['sites_active'] >= $_sub['sites_max'] ) { continue; } @@ -1003,26 +1199,31 @@ class WC_Helper { return; } - $request = WC_Helper_API::post( 'activate', array( - 'authenticated' => true, - 'body' => json_encode( array( - 'product_key' => $subscription['product_key'], - ) ), - ) ); + $request = WC_Helper_API::post( + 'activate', array( + 'authenticated' => true, + 'body' => json_encode( + array( + 'product_key' => $subscription['product_key'], + ) + ), + ) + ); $activated = wp_remote_retrieve_response_code( $request ) === 200; - $body = json_decode( wp_remote_retrieve_body( $request ), true ); + $body = json_decode( wp_remote_retrieve_body( $request ), true ); if ( ! $activated && ! empty( $body['code'] ) && 'already_connected' == $body['code'] ) { $activated = true; } if ( ! $activated ) { - self::log( 'Could not activate a subscription upon plugin activation: ' . $$filename ); + self::log( 'Could not activate a subscription upon plugin activation: ' . $filename ); return; } self::log( 'Auto-activated a subscription for ' . $filename ); self::_flush_subscriptions_cache(); + self::_flush_updates_cache(); } /** @@ -1047,9 +1248,9 @@ class WC_Helper { return; } - $plugin = $plugins[ $filename ]; + $plugin = $plugins[ $filename ]; $subscriptions = self::_get_subscriptions_from_product_id( $plugin['_product_id'], false ); - $site_id = absint( $auth['site_id'] ); + $site_id = absint( $auth['site_id'] ); // No valid subscriptions for this product if ( empty( $subscriptions ) ) { @@ -1064,12 +1265,16 @@ class WC_Helper { continue; } - $request = WC_Helper_API::post( 'deactivate', array( - 'authenticated' => true, - 'body' => json_encode( array( - 'product_key' => $subscription['product_key'], - ) ), - ) ); + $request = WC_Helper_API::post( + 'deactivate', array( + 'authenticated' => true, + 'body' => json_encode( + array( + 'product_key' => $subscription['product_key'], + ) + ), + ) + ); if ( wp_remote_retrieve_response_code( $request ) === 200 ) { $deactivated++; @@ -1079,16 +1284,23 @@ class WC_Helper { if ( $deactivated ) { self::log( sprintf( 'Auto-deactivated %d subscription(s) for %s', $deactivated, $filename ) ); self::_flush_subscriptions_cache(); + self::_flush_updates_cache(); } } /** - * Add a note about available extension updates if Woo core has an update available. + * Various Helper-related admin notices. */ public static function admin_notices() { + if ( apply_filters( 'woocommerce_helper_suppress_admin_notices', false ) ) { + return; + } + $screen = get_current_screen(); $screen_id = $screen ? $screen->id : ''; + self::_prompt_helper_connect( $screen_id ); + if ( 'update-core' !== $screen_id ) { return; } @@ -1098,6 +1310,7 @@ class WC_Helper { return; } + // Add a note about available extension updates if Woo core has an update available. $notice = self::_get_extensions_update_notice(); if ( ! empty( $notice ) ) { echo '

      ' . $notice . '

      '; @@ -1105,19 +1318,53 @@ class WC_Helper { } /** - * Add an upgrade notice if there are extensions with updates. + * Prompt a Helper connection if the user has WooCommerce.com extensions. * - * @param string $message An existing update notice or an empty string. - * - * @return string The resulting message. + * @param string $screen_id Current screen ID. */ - public static function in_plugin_update_message( $message ) { - $notice = self::_get_extensions_update_notice(); - if ( ! empty( $notice ) ) { - $message .= '

      ' . $notice; + private static function _prompt_helper_connect( $screen_id ) { + if ( apply_filters( 'woocommerce_helper_suppress_connect_notice', false ) ) { + return; } - return $message; + $screens = wc_get_screen_ids(); + $screens[] = 'plugins'; + + if ( ! in_array( $screen_id, $screens, true ) ) { + return; + } + + // Don't show the notice on the Helper screens. + $screen_addons = sanitize_title( __( 'WooCommerce', 'woocommerce' ) ) . '_page_wc-addons'; + + if ( $screen_addons === $screen_id && ! empty( $_REQUEST['section'] ) && 'helper' === $_REQUEST['section'] ) { + return; + } + + // We believe we have an active connection. + $auth = WC_Helper_Options::get( 'auth' ); + if ( ! empty( $auth['access_token'] ) ) { + return; + } + + $active_plugins = apply_filters( 'active_plugins', get_option( 'active_plugins' ) ); + if ( empty( $active_plugins ) ) { + return; + } + + $woo_plugins = self::get_local_woo_plugins(); + if ( empty( $woo_plugins ) ) { + return; + } + + $active_woo_plugins = array_intersect_key( $woo_plugins, array_flip( $active_plugins ) ); + + if ( count( $active_woo_plugins ) > 0 ) { + /* translators: %s: helper screen url */ + $notice = __( 'Connect your store to WooCommerce.com to receive extensions updates and support.', 'woocommerce' ); + $notice = sprintf( $notice, admin_url( 'admin.php?page=wc-addons§ion=helper' ) ); + echo '

      ' . $notice . '

      '; + } } /** @@ -1126,8 +1373,8 @@ class WC_Helper { * @return string|null The update notice or null if everything is up to date. */ private static function _get_extensions_update_notice() { - $plugins = self::get_local_woo_plugins(); - $updates = WC_Helper_Updater::get_update_data(); + $plugins = self::get_local_woo_plugins(); + $updates = WC_Helper_Updater::get_update_data(); $available = 0; foreach ( $plugins as $data ) { @@ -1146,8 +1393,10 @@ class WC_Helper { } /* translators: %1$s: helper url, %2$d: number of extensions */ - return sprintf( _n( 'Note: You currently have %2$d extension which should be updated first before updating WooCommerce.', 'Note: You currently have %2$d extensions which should be updated first before updating WooCommerce.', $available, 'woocommerce' ), - admin_url( 'admin.php?page=wc-addons§ion=helper' ), $available ); + return sprintf( + _n( 'Note: You currently have %2$d paid extension which should be updated first before updating WooCommerce.', 'Note: You currently have %2$d paid extensions which should be updated first before updating WooCommerce.', $available, 'woocommerce' ), + admin_url( 'admin.php?page=wc-addons§ion=helper' ), $available + ); } /** @@ -1186,9 +1435,11 @@ class WC_Helper { * @access private */ public static function _flush_authentication_cache() { - $request = WC_Helper_API::get( 'oauth/me', array( - 'authenticated' => true, - ) ); + $request = WC_Helper_API::get( + 'oauth/me', array( + 'authenticated' => true, + ) + ); if ( wp_remote_retrieve_response_code( $request ) !== 200 ) { return false; @@ -1199,10 +1450,12 @@ class WC_Helper { return false; } - WC_Helper_Options::update( 'auth_user_data', array( - 'name' => $user_data['name'], - 'email' => $user_data['email'], - ) ); + WC_Helper_Options::update( + 'auth_user_data', array( + 'name' => $user_data['name'], + 'email' => $user_data['email'], + ) + ); return true; } diff --git a/includes/admin/helper/views/html-main.php b/includes/admin/helper/views/html-main.php index 473275455b0..3023a192b14 100644 --- a/includes/admin/helper/views/html-main.php +++ b/includes/admin/helper/views/html-main.php @@ -1,17 +1,45 @@
      - +

      - +

      - -

      + +

      Plugins screen.', 'woocommerce' ), admin_url( 'plugins.php' ) ); ?>

      +
        + + + + $label ) : + // Don't show empty filters. + if ( empty( $counts[ $key ] ) ) { + continue; + } + + $url = admin_url( 'admin.php?page=wc-addons§ion=helper&filter=' . $key ); + $class_html = $current_filter === $key ? 'class="current"' : ''; + ?> +
      • + href=""> + + () + +
        • + +
      + @@ -19,12 +47,17 @@ diff --git a/includes/admin/helper/views/html-oauth-start.php b/includes/admin/helper/views/html-oauth-start.php index 5c5657dbd2c..7326ff08fc8 100644 --- a/includes/admin/helper/views/html-oauth-start.php +++ b/includes/admin/helper/views/html-oauth-start.php @@ -1,21 +1,30 @@ - + WooCommerce -> Extensions -> WooCommerce.com Subscriptions main page. + * + * @package WooCommerce\Views + */ + +defined( 'ABSPATH' ) || exit(); + +?>
      - -

      - + +

      +
      - WooCommerce + WooCommerce -

      Sorry to see you go. Feel free to reconnect again using the button below.', 'woocommerce' ); ?>

      +

      Sorry to see you go. Feel free to reconnect again using the button below.', 'woocommerce' ); ?>

      -

      -

      -

      +

      +

      +

      diff --git a/includes/admin/helper/views/html-section-nav.php b/includes/admin/helper/views/html-section-nav.php index 0e8cb9d2605..6f45b07a51d 100644 --- a/includes/admin/helper/views/html-section-nav.php +++ b/includes/admin/helper/views/html-section-nav.php @@ -2,5 +2,10 @@ diff --git a/includes/admin/importers/class-wc-product-csv-importer-controller.php b/includes/admin/importers/class-wc-product-csv-importer-controller.php index 23a4ac1e3bc..30535224c7b 100644 --- a/includes/admin/importers/class-wc-product-csv-importer-controller.php +++ b/includes/admin/importers/class-wc-product-csv-importer-controller.php @@ -1,4 +1,10 @@ 'text/csv', + 'txt' => 'text/plain', + ) + ); + } + /** * Constructor. */ public function __construct() { - $this->steps = array( - 'upload' => array( + $default_steps = array( + 'upload' => array( 'name' => __( 'Upload CSV file', 'woocommerce' ), 'view' => array( $this, 'upload_form' ), 'handler' => array( $this, 'upload_form_handler' ), @@ -87,26 +133,37 @@ class WC_Product_CSV_Importer_Controller { 'view' => array( $this, 'mapping_form' ), 'handler' => '', ), - 'import' => array( + 'import' => array( 'name' => __( 'Import', 'woocommerce' ), 'view' => array( $this, 'import' ), 'handler' => '', ), - 'done' => array( + 'done' => array( 'name' => __( 'Done!', 'woocommerce' ), 'view' => array( $this, 'done' ), 'handler' => '', ), ); + + $this->steps = apply_filters( 'woocommerce_product_csv_importer_steps', $default_steps ); + + // phpcs:disable WordPress.CSRF.NonceVerification.NoNonceVerification $this->step = isset( $_REQUEST['step'] ) ? sanitize_key( $_REQUEST['step'] ) : current( array_keys( $this->steps ) ); - $this->file = isset( $_REQUEST['file'] ) ? wc_clean( $_REQUEST['file'] ) : ''; + $this->file = isset( $_REQUEST['file'] ) ? wc_clean( wp_unslash( $_REQUEST['file'] ) ) : ''; $this->update_existing = isset( $_REQUEST['update_existing'] ) ? (bool) $_REQUEST['update_existing'] : false; - $this->delimiter = ! empty( $_REQUEST['delimiter'] ) ? wc_clean( $_REQUEST['delimiter'] ) : ','; + $this->delimiter = ! empty( $_REQUEST['delimiter'] ) ? wc_clean( wp_unslash( $_REQUEST['delimiter'] ) ) : ','; + $this->map_preferences = isset( $_REQUEST['map_preferences'] ) ? (bool) $_REQUEST['map_preferences'] : false; + // phpcs:enable + + if ( $this->map_preferences ) { + add_filter( 'woocommerce_csv_product_import_mapped_columns', array( $this, 'auto_map_user_preferences' ), 9999 ); + } } /** * Get the URL for the next step's screen. - * @param string step slug (default: current step) + * + * @param string $step slug (default: current step). * @return string URL for next step if a next step exists. * Admin URL if it's the last step. * Empty string on failure. @@ -122,7 +179,7 @@ class WC_Product_CSV_Importer_Controller { return admin_url(); } - $step_index = array_search( $step, $keys ); + $step_index = array_search( $step, $keys, true ); if ( false === $step_index ) { return ''; @@ -133,6 +190,7 @@ class WC_Product_CSV_Importer_Controller { 'file' => str_replace( DIRECTORY_SEPARATOR, '/', $this->file ), 'delimiter' => $this->delimiter, 'update_existing' => $this->update_existing, + 'map_preferences' => $this->map_preferences, '_wpnonce' => wp_create_nonce( 'woocommerce-csv-importer' ), // wp_nonce_url() escapes & to & breaking redirects. ); @@ -143,38 +201,56 @@ class WC_Product_CSV_Importer_Controller { * Output header view. */ protected function output_header() { - include( dirname( __FILE__ ) . '/views/html-csv-import-header.php' ); + include dirname( __FILE__ ) . '/views/html-csv-import-header.php'; } /** * Output steps view. */ protected function output_steps() { - include( dirname( __FILE__ ) . '/views/html-csv-import-steps.php' ); + include dirname( __FILE__ ) . '/views/html-csv-import-steps.php'; } /** * Output footer view. */ protected function output_footer() { - include( dirname( __FILE__ ) . '/views/html-csv-import-footer.php' ); + include dirname( __FILE__ ) . '/views/html-csv-import-footer.php'; } /** * Add error message. + * + * @param string $message Error message. + * @param array $actions List of actions with 'url' and 'label'. */ - protected function add_error( $error ) { - $this->errors[] = $error; + protected function add_error( $message, $actions = array() ) { + $this->errors[] = array( + 'message' => $message, + 'actions' => $actions, + ); } /** * Add error message. */ protected function output_errors() { - if ( $this->errors ) { - foreach ( $this->errors as $error ) { - echo '

      ' . esc_html( $error ) . '

      '; + if ( ! $this->errors ) { + return; + } + + foreach ( $this->errors as $error ) { + echo '
      '; + echo '

      ' . esc_html( $error['message'] ) . '

      '; + + if ( ! empty( $error['actions'] ) ) { + echo '

      '; + foreach ( $error['actions'] as $action ) { + echo '' . esc_html( $action['label'] ) . ' '; + } + echo '

      '; } + echo '
      '; } } @@ -182,6 +258,7 @@ class WC_Product_CSV_Importer_Controller { * Dispatch current step and show correct view. */ public function dispatch() { + // phpcs:ignore WordPress.CSRF.NonceVerification.NoNonceVerification if ( ! empty( $_POST['save_step'] ) && ! empty( $this->steps[ $this->step ]['handler'] ) ) { call_user_func( $this->steps[ $this->step ]['handler'], $this ); } @@ -200,7 +277,7 @@ class WC_Product_CSV_Importer_Controller { $size = size_format( $bytes ); $upload_dir = wp_upload_dir(); - include( dirname( __FILE__ ) . '/views/html-product-csv-import-form.php' ); + include dirname( __FILE__ ) . '/views/html-product-csv-import-form.php'; } /** @@ -229,20 +306,24 @@ class WC_Product_CSV_Importer_Controller { * @return string|WP_Error */ public function handle_upload() { - $valid_filetypes = apply_filters( 'woocommerce_csv_product_import_valid_filetypes', array( 'csv' => 'text/csv', 'txt' => 'text/plain' ) ); + // phpcs:disable WordPress.CSRF.NonceVerification.NoNonceVerification -- Nonce already verified in WC_Product_CSV_Importer_Controller::upload_form_handler() + $file_url = isset( $_POST['file_url'] ) ? wc_clean( wp_unslash( $_POST['file_url'] ) ) : ''; - if ( empty( $_POST['file_url'] ) ) { + if ( empty( $file_url ) ) { if ( ! isset( $_FILES['import'] ) ) { return new WP_Error( 'woocommerce_product_csv_importer_upload_file_empty', __( 'File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your php.ini or by post_max_size being defined as smaller than upload_max_filesize in php.ini.', 'woocommerce' ) ); } - $filetype = wp_check_filetype( $_FILES['import']['name'], $valid_filetypes ); - if ( ! in_array( $filetype['type'], $valid_filetypes ) ) { + if ( ! self::is_file_valid_csv( wc_clean( wp_unslash( $_FILES['import']['name'] ) ), false ) ) { return new WP_Error( 'woocommerce_product_csv_importer_upload_file_invalid', __( 'Invalid file type. The importer supports CSV and TXT file formats.', 'woocommerce' ) ); } - $overrides = array( 'test_form' => false, 'mimes' => $valid_filetypes ); - $upload = wp_handle_upload( $_FILES['import'], $overrides ); + $overrides = array( + 'test_form' => false, + 'mimes' => self::get_valid_csv_filetypes(), + ); + $import = $_FILES['import']; // WPCS: sanitization ok, input var ok. + $upload = wp_handle_upload( $import, $overrides ); if ( isset( $upload['error'] ) ) { return new WP_Error( 'woocommerce_product_csv_importer_upload_error', $upload['error'] ); @@ -268,14 +349,14 @@ class WC_Product_CSV_Importer_Controller { wp_schedule_single_event( time() + DAY_IN_SECONDS, 'importer_scheduled_cleanup', array( $id ) ); return $upload['file']; - } elseif ( file_exists( ABSPATH . $_POST['file_url'] ) ) { - $filetype = wp_check_filetype( ABSPATH . $_POST['file_url'], $valid_filetypes ); - if ( ! in_array( $filetype['type'], $valid_filetypes ) ) { + } elseif ( file_exists( ABSPATH . $file_url ) ) { + if ( ! self::is_file_valid_csv( ABSPATH . $file_url ) ) { return new WP_Error( 'woocommerce_product_csv_importer_upload_file_invalid', __( 'Invalid file type. The importer supports CSV and TXT file formats.', 'woocommerce' ) ); } - return ABSPATH . $_POST['file_url']; + return ABSPATH . $file_url; } + // phpcs:enable return new WP_Error( 'woocommerce_product_csv_importer_upload_invalid_file', __( 'Please upload or provide the link to a valid CSV file.', 'woocommerce' ) ); } @@ -284,7 +365,7 @@ class WC_Product_CSV_Importer_Controller { * Mapping step. */ protected function mapping_form() { - $args = array( + $args = array( 'lines' => 1, 'delimiter' => $this->delimiter, ); @@ -295,56 +376,99 @@ class WC_Product_CSV_Importer_Controller { $sample = current( $importer->get_raw_data() ); if ( empty( $sample ) ) { - $this->add_error( __( 'The file is empty, please try again with a new file.', 'woocommerce' ) ); + $this->add_error( + __( 'The file is empty or using a different encoding than UTF-8, please try again with a new file.', 'woocommerce' ), + array( + array( + 'url' => admin_url( 'edit.php?post_type=product&page=product_importer' ), + 'label' => __( 'Upload a new file', 'woocommerce' ), + ), + ) + ); + + // Force output the errors in the same page. + $this->output_errors(); return; } - include_once( dirname( __FILE__ ) . '/views/html-csv-import-mapping.php' ); + include_once dirname( __FILE__ ) . '/views/html-csv-import-mapping.php'; } /** * Import the file if it exists and is valid. */ public function import() { - if ( ! is_file( $this->file ) ) { - $this->add_error( __( 'The file does not exist, please try again.', 'woocommerce' ) ); + if ( ! self::is_file_valid_csv( $this->file ) ) { + $this->add_error( __( 'Invalid file type. The importer supports CSV and TXT file formats.', 'woocommerce' ) ); + $this->output_errors(); return; } - if ( ! empty( $_POST['map_to'] ) ) { - $mapping_from = wp_unslash( $_POST['map_from'] ); - $mapping_to = wp_unslash( $_POST['map_to'] ); + if ( ! is_file( $this->file ) ) { + $this->add_error( __( 'The file does not exist, please try again.', 'woocommerce' ) ); + $this->output_errors(); + return; + } + + // phpcs:disable WordPress.CSRF.NonceVerification.NoNonceVerification -- Nonce already verified in WC_Admin_Importers::do_ajax_product_import() + if ( ! empty( $_POST['map_from'] ) && ! empty( $_POST['map_to'] ) ) { + $mapping_from = wc_clean( wp_unslash( $_POST['map_from'] ) ); + $mapping_to = wc_clean( wp_unslash( $_POST['map_to'] ) ); + + // Save mapping preferences for future imports. + update_user_option( get_current_user_id(), 'woocommerce_product_import_mapping', $mapping_to ); } else { wp_redirect( esc_url_raw( $this->get_next_step_link( 'upload' ) ) ); exit; } + // phpcs:enable - wp_localize_script( 'wc-product-import', 'wc_product_import_params', array( - 'import_nonce' => wp_create_nonce( 'wc-product-import' ), - 'mapping' => array( - 'from' => $mapping_from, - 'to' => $mapping_to, - ), - 'file' => $this->file, - 'update_existing' => $this->update_existing, - 'delimiter' => $this->delimiter, - ) ); + wp_localize_script( + 'wc-product-import', 'wc_product_import_params', array( + 'import_nonce' => wp_create_nonce( 'wc-product-import' ), + 'mapping' => array( + 'from' => $mapping_from, + 'to' => $mapping_to, + ), + 'file' => $this->file, + 'update_existing' => $this->update_existing, + 'delimiter' => $this->delimiter, + ) + ); wp_enqueue_script( 'wc-product-import' ); - include_once( dirname( __FILE__ ) . '/views/html-csv-import-progress.php' ); + include_once dirname( __FILE__ ) . '/views/html-csv-import-progress.php'; } /** * Done step. */ protected function done() { + // phpcs:disable WordPress.CSRF.NonceVerification.NoNonceVerification $imported = isset( $_GET['products-imported'] ) ? absint( $_GET['products-imported'] ) : 0; $updated = isset( $_GET['products-updated'] ) ? absint( $_GET['products-updated'] ) : 0; $failed = isset( $_GET['products-failed'] ) ? absint( $_GET['products-failed'] ) : 0; $skipped = isset( $_GET['products-skipped'] ) ? absint( $_GET['products-skipped'] ) : 0; $errors = array_filter( (array) get_user_option( 'product_import_error_log' ) ); + // phpcs:enable - include_once( dirname( __FILE__ ) . '/views/html-csv-import-done.php' ); + include_once dirname( __FILE__ ) . '/views/html-csv-import-done.php'; + } + + /** + * Columns to normalize. + * + * @param array $columns List of columns names and keys. + * @return array + */ + protected function normalize_columns_names( $columns ) { + $normalized = array(); + + foreach ( $columns as $key => $value ) { + $normalized[ strtolower( $key ) ] = $value; + } + + return $normalized; } /** @@ -355,70 +479,95 @@ class WC_Product_CSV_Importer_Controller { * @return array */ protected function auto_map_columns( $raw_headers, $num_indexes = true ) { - $weight_unit = get_option( 'woocommerce_weight_unit' ); - $dimension_unit = get_option( 'woocommerce_dimension_unit' ); + $weight_unit = get_option( 'woocommerce_weight_unit' ); + $dimension_unit = get_option( 'woocommerce_dimension_unit' ); - include( dirname( __FILE__ ) . '/mappings/mappings.php' ); + include dirname( __FILE__ ) . '/mappings/mappings.php'; - /** + /* * @hooked wc_importer_generic_mappings - 10 * @hooked wc_importer_wordpress_mappings - 10 + * @hooked wc_importer_default_english_mappings - 100 */ - $default_columns = apply_filters( 'woocommerce_csv_product_import_mapping_default_columns', array( - __( 'ID', 'woocommerce' ) => 'id', - __( 'Type', 'woocommerce' ) => 'type', - __( 'SKU', 'woocommerce' ) => 'sku', - __( 'Name', 'woocommerce' ) => 'name', - __( 'Published', 'woocommerce' ) => 'published', - __( 'Is featured?', 'woocommerce' ) => 'featured', - __( 'Visibility in catalog', 'woocommerce' ) => 'catalog_visibility', - __( 'Short description', 'woocommerce' ) => 'short_description', - __( 'Description', 'woocommerce' ) => 'description', - __( 'Date sale price starts', 'woocommerce' ) => 'date_on_sale_from', - __( 'Date sale price ends', 'woocommerce' ) => 'date_on_sale_to', - __( 'Tax status', 'woocommerce' ) => 'tax_status', - __( 'Tax class', 'woocommerce' ) => 'tax_class', - __( 'In stock?', 'woocommerce' ) => 'stock_status', - __( 'Stock', 'woocommerce' ) => 'stock_quantity', - __( 'Backorders allowed?', 'woocommerce' ) => 'backorders', - __( 'Sold individually?', 'woocommerce' ) => 'sold_individually', - sprintf( __( 'Weight (%s)', 'woocommerce' ), $weight_unit ) => 'weight', - sprintf( __( 'Length (%s)', 'woocommerce' ), $dimension_unit ) => 'length', - sprintf( __( 'Width (%s)', 'woocommerce' ), $dimension_unit ) => 'width', - sprintf( __( 'Height (%s)', 'woocommerce' ), $dimension_unit ) => 'height', - __( 'Allow customer reviews?', 'woocommerce' ) => 'reviews_allowed', - __( 'Purchase note', 'woocommerce' ) => 'purchase_note', - __( 'Sale price', 'woocommerce' ) => 'sale_price', - __( 'Regular price', 'woocommerce' ) => 'regular_price', - __( 'Categories', 'woocommerce' ) => 'category_ids', - __( 'Tags', 'woocommerce' ) => 'tag_ids', - __( 'Shipping class', 'woocommerce' ) => 'shipping_class_id', - __( 'Images', 'woocommerce' ) => 'images', - __( 'Download limit', 'woocommerce' ) => 'download_limit', - __( 'Download expiry days', 'woocommerce' ) => 'download_expiry', - __( 'Parent', 'woocommerce' ) => 'parent_id', - __( 'Upsells', 'woocommerce' ) => 'upsell_ids', - __( 'Cross-sells', 'woocommerce' ) => 'cross_sell_ids', - __( 'Grouped products', 'woocommerce' ) => 'grouped_products', - __( 'External URL', 'woocommerce' ) => 'product_url', - __( 'Button text', 'woocommerce' ) => 'button_text', - ) ); - - $special_columns = $this->get_special_columns( apply_filters( 'woocommerce_csv_product_import_mapping_special_columns', - array( - __( 'Attribute %d name', 'woocommerce' ) => 'attributes:name', - __( 'Attribute %d value(s)', 'woocommerce' ) => 'attributes:value', - __( 'Attribute %d visible', 'woocommerce' ) => 'attributes:visible', - __( 'Attribute %d global', 'woocommerce' ) => 'attributes:taxonomy', - __( 'Attribute %d default', 'woocommerce' ) => 'attributes:default', - __( 'Download %d name', 'woocommerce' ) => 'downloads:name', - __( 'Download %d URL', 'woocommerce' ) => 'downloads:url', - __( 'Meta: %s', 'woocommerce' ) => 'meta:', + $default_columns = $this->normalize_columns_names( + apply_filters( + 'woocommerce_csv_product_import_mapping_default_columns', array( + __( 'ID', 'woocommerce' ) => 'id', + __( 'Type', 'woocommerce' ) => 'type', + __( 'SKU', 'woocommerce' ) => 'sku', + __( 'Name', 'woocommerce' ) => 'name', + __( 'Published', 'woocommerce' ) => 'published', + __( 'Is featured?', 'woocommerce' ) => 'featured', + __( 'Visibility in catalog', 'woocommerce' ) => 'catalog_visibility', + __( 'Short description', 'woocommerce' ) => 'short_description', + __( 'Description', 'woocommerce' ) => 'description', + __( 'Date sale price starts', 'woocommerce' ) => 'date_on_sale_from', + __( 'Date sale price ends', 'woocommerce' ) => 'date_on_sale_to', + __( 'Tax status', 'woocommerce' ) => 'tax_status', + __( 'Tax class', 'woocommerce' ) => 'tax_class', + __( 'In stock?', 'woocommerce' ) => 'stock_status', + __( 'Stock', 'woocommerce' ) => 'stock_quantity', + __( 'Backorders allowed?', 'woocommerce' ) => 'backorders', + __( 'Low stock amount', 'woocommerce' ) => 'low_stock_amount', + __( 'Sold individually?', 'woocommerce' ) => 'sold_individually', + /* translators: %s: Weight unit */ + sprintf( __( 'Weight (%s)', 'woocommerce' ), $weight_unit ) => 'weight', + /* translators: %s: Length unit */ + sprintf( __( 'Length (%s)', 'woocommerce' ), $dimension_unit ) => 'length', + /* translators: %s: Width unit */ + sprintf( __( 'Width (%s)', 'woocommerce' ), $dimension_unit ) => 'width', + /* translators: %s: Height unit */ + sprintf( __( 'Height (%s)', 'woocommerce' ), $dimension_unit ) => 'height', + __( 'Allow customer reviews?', 'woocommerce' ) => 'reviews_allowed', + __( 'Purchase note', 'woocommerce' ) => 'purchase_note', + __( 'Sale price', 'woocommerce' ) => 'sale_price', + __( 'Regular price', 'woocommerce' ) => 'regular_price', + __( 'Categories', 'woocommerce' ) => 'category_ids', + __( 'Tags', 'woocommerce' ) => 'tag_ids', + __( 'Shipping class', 'woocommerce' ) => 'shipping_class_id', + __( 'Images', 'woocommerce' ) => 'images', + __( 'Download limit', 'woocommerce' ) => 'download_limit', + __( 'Download expiry days', 'woocommerce' ) => 'download_expiry', + __( 'Parent', 'woocommerce' ) => 'parent_id', + __( 'Upsells', 'woocommerce' ) => 'upsell_ids', + __( 'Cross-sells', 'woocommerce' ) => 'cross_sell_ids', + __( 'Grouped products', 'woocommerce' ) => 'grouped_products', + __( 'External URL', 'woocommerce' ) => 'product_url', + __( 'Button text', 'woocommerce' ) => 'button_text', + __( 'Position', 'woocommerce' ) => 'menu_order', + ) ) - ) ); + ); + + $special_columns = $this->get_special_columns( + $this->normalize_columns_names( + apply_filters( + 'woocommerce_csv_product_import_mapping_special_columns', + array( + /* translators: %d: Attribute number */ + __( 'Attribute %d name', 'woocommerce' ) => 'attributes:name', + /* translators: %d: Attribute number */ + __( 'Attribute %d value(s)', 'woocommerce' ) => 'attributes:value', + /* translators: %d: Attribute number */ + __( 'Attribute %d visible', 'woocommerce' ) => 'attributes:visible', + /* translators: %d: Attribute number */ + __( 'Attribute %d global', 'woocommerce' ) => 'attributes:taxonomy', + /* translators: %d: Attribute number */ + __( 'Attribute %d default', 'woocommerce' ) => 'attributes:default', + /* translators: %d: Download number */ + __( 'Download %d name', 'woocommerce' ) => 'downloads:name', + /* translators: %d: Download number */ + __( 'Download %d URL', 'woocommerce' ) => 'downloads:url', + /* translators: %d: Meta number */ + __( 'Meta: %s', 'woocommerce' ) => 'meta:', + ) + ) + ) + ); $headers = array(); foreach ( $raw_headers as $key => $field ) { + $field = strtolower( $field ); $index = $num_indexes ? $key : $field; $headers[ $index ] = $field; @@ -437,6 +586,22 @@ class WC_Product_CSV_Importer_Controller { return apply_filters( 'woocommerce_csv_product_import_mapped_columns', $headers, $raw_headers ); } + /** + * Map columns using the user's lastest import mappings. + * + * @param array $headers Header columns. + * @return array + */ + public function auto_map_user_preferences( $headers ) { + $mapping_preferences = get_user_option( 'woocommerce_product_import_mapping' ); + + if ( ! empty( $mapping_preferences ) && is_array( $mapping_preferences ) ) { + return $mapping_preferences; + } + + return $headers; + } + /** * Sanitize special column name regex. * @@ -444,7 +609,7 @@ class WC_Product_CSV_Importer_Controller { * @return string */ protected function sanitize_special_column_name_regex( $value ) { - return '/' . str_replace( array( '%d', '%s' ), '(.*)', quotemeta( $value ) ) . '/'; + return '/' . str_replace( array( '%d', '%s' ), '(.*)', trim( quotemeta( $value ) ) ) . '/'; } /** @@ -468,7 +633,7 @@ class WC_Product_CSV_Importer_Controller { /** * Get mapping options. * - * @param string $item Item name + * @param string $item Item name. * @return array */ protected function get_mapping_options( $item = '' ) { @@ -509,6 +674,7 @@ class WC_Product_CSV_Importer_Controller { 'stock_status' => __( 'In stock?', 'woocommerce' ), 'stock_quantity' => _x( 'Stock', 'Quantity in stock', 'woocommerce' ), 'backorders' => __( 'Backorders allowed?', 'woocommerce' ), + 'low_stock_amount' => __( 'Low stock amount', 'woocommerce' ), 'sold_individually' => __( 'Sold individually?', 'woocommerce' ), /* translators: %s: weight unit */ 'weight' => sprintf( __( 'Weight (%s)', 'woocommerce' ), $weight_unit ), @@ -516,11 +682,11 @@ class WC_Product_CSV_Importer_Controller { 'name' => __( 'Dimensions', 'woocommerce' ), 'options' => array( /* translators: %s: dimension unit */ - 'length' => sprintf( __( 'Length (%s)', 'woocommerce' ), $dimension_unit ), + 'length' => sprintf( __( 'Length (%s)', 'woocommerce' ), $dimension_unit ), /* translators: %s: dimension unit */ - 'width' => sprintf( __( 'Width (%s)', 'woocommerce' ), $dimension_unit ), + 'width' => sprintf( __( 'Width (%s)', 'woocommerce' ), $dimension_unit ), /* translators: %s: dimension unit */ - 'height' => sprintf( __( 'Height (%s)', 'woocommerce' ), $dimension_unit ), + 'height' => sprintf( __( 'Height (%s)', 'woocommerce' ), $dimension_unit ), ), ), 'category_ids' => __( 'Categories', 'woocommerce' ), @@ -534,8 +700,8 @@ class WC_Product_CSV_Importer_Controller { 'external' => array( 'name' => __( 'External product', 'woocommerce' ), 'options' => array( - 'product_url' => __( 'External URL', 'woocommerce' ), - 'button_text' => __( 'Button text', 'woocommerce' ), + 'product_url' => __( 'External URL', 'woocommerce' ), + 'button_text' => __( 'Button text', 'woocommerce' ), ), ), 'downloads' => array( @@ -560,6 +726,7 @@ class WC_Product_CSV_Importer_Controller { 'reviews_allowed' => __( 'Allow customer reviews?', 'woocommerce' ), 'purchase_note' => __( 'Purchase note', 'woocommerce' ), 'meta:' . $meta => __( 'Import as meta', 'woocommerce' ), + 'menu_order' => __( 'Position', 'woocommerce' ), ); return apply_filters( 'woocommerce_csv_product_import_mapping_options', $options, $item ); diff --git a/includes/admin/importers/class-wc-tax-rate-importer.php b/includes/admin/importers/class-wc-tax-rate-importer.php index 61fdacbc704..839a10e8f12 100644 --- a/includes/admin/importers/class-wc-tax-rate-importer.php +++ b/includes/admin/importers/class-wc-tax-rate-importer.php @@ -1,4 +1,11 @@ import_page = 'woocommerce_tax_rate_csv'; - $this->delimiter = empty( $_POST['delimiter'] ) ? ',' : (string) wc_clean( $_POST['delimiter'] ); + $this->delimiter = empty( $_POST['delimiter'] ) ? ',' : (string) wc_clean( wp_unslash( $_POST['delimiter'] ) ); // WPCS: CSRF ok. } /** @@ -96,7 +101,7 @@ class WC_Tax_Rate_Importer extends WP_Importer { */ private function import_start() { if ( function_exists( 'gc_enable' ) ) { - gc_enable(); + gc_enable(); // phpcs:ignore PHPCompatibility.PHP.NewFunctions.gc_enableFound } wc_set_time_limit( 0 ); @ob_flush(); @@ -107,8 +112,8 @@ class WC_Tax_Rate_Importer extends WP_Importer { /** * UTF-8 encode the data if `$enc` value isn't UTF-8. * - * @param mixed $data - * @param string $enc + * @param mixed $data Data. + * @param string $enc Encoding. * @return string */ public function format_data_from_csv( $data, $enc ) { @@ -118,7 +123,7 @@ class WC_Tax_Rate_Importer extends WP_Importer { /** * Import the file if it exists and is valid. * - * @param mixed $file + * @param mixed $file File. */ public function import( $file ) { if ( ! is_file( $file ) ) { @@ -127,15 +132,18 @@ class WC_Tax_Rate_Importer extends WP_Importer { $this->import_start(); - $loop = 0; + $loop = 0; + $handle = fopen( $file, 'r' ); - if ( ( $handle = fopen( $file, "r" ) ) !== false ) { + if ( false !== $handle ) { $header = fgetcsv( $handle, 0, $this->delimiter ); - if ( 10 === sizeof( $header ) ) { + if ( 10 === count( $header ) ) { - while ( ( $row = fgetcsv( $handle, 0, $this->delimiter ) ) !== false ) { + $row = fgetcsv( $handle, 0, $this->delimiter ); + + while ( false !== $row ) { list( $country, $state, $postcode, $city, $rate, $name, $priority, $compound, $shipping, $class ) = $row; @@ -154,6 +162,8 @@ class WC_Tax_Rate_Importer extends WP_Importer { $tax_rate_id = WC_Tax::_insert_tax_rate( $tax_rate ); WC_Tax::_update_tax_rate_postcodes( $tax_rate_id, wc_clean( $postcode ) ); WC_Tax::_update_tax_rate_cities( $tax_rate_id, wc_clean( $city ) ); + + $row = fgetcsv( $handle, 0, $this->delimiter ); } } else { $this->import_error( __( 'The CSV is invalid.', 'woocommerce' ) ); @@ -162,12 +172,12 @@ class WC_Tax_Rate_Importer extends WP_Importer { fclose( $handle ); } - // Show Result + // Show Result. echo '

      '; - /* translators: %s: tax rates count */ printf( - __( 'Import complete - imported %s tax rates.', 'woocommerce' ), - '' . $loop . '' + /* translators: %s: tax rates count */ + esc_html__( 'Import complete - imported %s tax rates.', 'woocommerce' ), + '' . absint( $loop ) . '' ); echo '

      '; @@ -178,7 +188,7 @@ class WC_Tax_Rate_Importer extends WP_Importer { * Performs post-import cleanup of files and the cache. */ public function import_end() { - echo '

      ' . __( 'All done!', 'woocommerce' ) . ' ' . __( 'View tax rates', 'woocommerce' ) . '' . '

      '; + echo '

      ' . esc_html__( 'All done!', 'woocommerce' ) . ' ' . esc_html__( 'View tax rates', 'woocommerce' ) . '

      '; do_action( 'import_end' ); } @@ -190,8 +200,10 @@ class WC_Tax_Rate_Importer extends WP_Importer { * @return bool False if error uploading or invalid file, true otherwise */ public function handle_upload() { - if ( empty( $_POST['file_url'] ) ) { + // phpcs:disable WordPress.CSRF.NonceVerification.NoNonceVerification -- Nonce already verified in WC_Tax_Rate_Importer::dispatch() + $file_url = isset( $_POST['file_url'] ) ? esc_url_raw( wp_unslash( $_POST['file_url'] ) ) : ''; + if ( empty( $file_url ) ) { $file = wp_import_handle_upload(); if ( isset( $file['error'] ) ) { @@ -199,12 +211,12 @@ class WC_Tax_Rate_Importer extends WP_Importer { } $this->id = absint( $file['id'] ); - - } elseif ( file_exists( ABSPATH . $_POST['file_url'] ) ) { - $this->file_url = esc_attr( $_POST['file_url'] ); + } elseif ( file_exists( ABSPATH . $file_url ) ) { + $this->file_url = esc_attr( $file_url ); } else { $this->import_error(); } + // phpcs:enable return true; } @@ -214,7 +226,7 @@ class WC_Tax_Rate_Importer extends WP_Importer { */ public function header() { echo '
      '; - echo '

      ' . __( 'Import tax rates', 'woocommerce' ) . '

      '; + echo '

      ' . esc_html__( 'Import tax rates', 'woocommerce' ) . '

      '; } /** @@ -230,56 +242,61 @@ class WC_Tax_Rate_Importer extends WP_Importer { public function greet() { echo '
      '; - echo '

      ' . __( 'Hi there! Upload a CSV file containing tax rates to import the contents into your shop. Choose a .csv file to upload, then click "Upload file and import".', 'woocommerce' ) . '

      '; + echo '

      ' . esc_html__( 'Hi there! Upload a CSV file containing tax rates to import the contents into your shop. Choose a .csv file to upload, then click "Upload file and import".', 'woocommerce' ) . '

      '; - echo '

      ' . sprintf( __( 'Tax rates need to be defined with columns in a specific order (10 columns). Click here to download a sample.', 'woocommerce' ), WC()->plugin_url() . '/dummy-data/sample_tax_rates.csv' ) . '

      '; + /* translators: 1: Link to tax rates sample file 2: Closing link. */ + echo '

      ' . sprintf( esc_html__( 'Your CSV needs to include columns in a specific order. %1$sClick here to download a sample%2$s.', 'woocommerce' ), '', '' ) . '

      '; $action = 'admin.php?import=woocommerce_tax_rate_csv&step=1'; - $bytes = apply_filters( 'import_upload_size_limit', wp_max_upload_size() ); - $size = size_format( $bytes ); + $bytes = apply_filters( 'import_upload_size_limit', wp_max_upload_size() ); + $size = size_format( $bytes ); $upload_dir = wp_upload_dir(); if ( ! empty( $upload_dir['error'] ) ) : - ?>

      -

      +
      +

      +

      +
      +
      - + + +
      - + + + + + @@ -48,7 +81,7 @@
      - ' . __( 'Shared by %s', 'woocommerce' ), esc_html( $subscription['owner_email'] ) ); + } elseif ( isset( $subscription['master_user_email'] ) ) { printf( '
      ' . __( 'Shared by %s', 'woocommerce' ), esc_html( $subscription['master_user_email'] ) ); } - ?> + ?>
      - +
      - + - - " /> + + + ?> +
      - + - +


      - +

      ' . __( 'Sorry, there has been an error.', 'woocommerce' ) . '
      '; + echo '

      ' . esc_html__( 'Sorry, there has been an error.', 'woocommerce' ) . '
      '; if ( $message ) { echo esc_html( $message ); } @@ -305,7 +323,7 @@ class WC_Tax_Rate_Importer extends WP_Importer { /** * Added to http_request_timeout filter to force timeout at 60 seconds during import. * - * @param int $val + * @param int $val Value. * @return int 60 */ public function bump_request_timeout( $val ) { diff --git a/includes/admin/importers/mappings/default.php b/includes/admin/importers/mappings/default.php index d525623b8f6..4de9337d89c 100644 --- a/includes/admin/importers/mappings/default.php +++ b/includes/admin/importers/mappings/default.php @@ -1,4 +1,9 @@ 'id', 'Type' => 'type', 'SKU' => 'sku', @@ -50,6 +55,7 @@ function wc_importer_default_english_mappings( $mappings ) { 'In stock?' => 'stock_status', 'Stock' => 'stock_quantity', 'Backorders allowed?' => 'backorders', + 'Low stock amount' => 'low_stock_amount', 'Sold individually?' => 'sold_individually', sprintf( 'Weight (%s)', $weight_unit ) => 'weight', sprintf( 'Length (%s)', $dimension_unit ) => 'length', @@ -71,6 +77,7 @@ function wc_importer_default_english_mappings( $mappings ) { 'Grouped products' => 'grouped_products', 'External URL' => 'product_url', 'Button text' => 'button_text', + 'Position' => 'menu_order', ); return array_merge( $mappings, $new_mappings ); @@ -81,7 +88,7 @@ add_filter( 'woocommerce_csv_product_import_mapping_default_columns', 'wc_import * Add English special mapping placeholders when not using English as current language. * * @since 3.1.0 - * @param array $mappings + * @param array $mappings Importer columns mappings. * @return array */ function wc_importer_default_special_english_mappings( $mappings ) { diff --git a/includes/admin/importers/mappings/generic.php b/includes/admin/importers/mappings/generic.php index bf8114758fa..d5b14ab26f3 100644 --- a/includes/admin/importers/mappings/generic.php +++ b/includes/admin/importers/mappings/generic.php @@ -1,4 +1,9 @@ 'regular_price', __( 'Parent SKU', 'woocommerce' ) => 'parent_id', __( 'Quantity', 'woocommerce' ) => 'stock_quantity', + __( 'Menu order', 'woocommerce' ) => 'menu_order', ); return array_merge( $mappings, $generic_mappings ); diff --git a/includes/admin/importers/mappings/mappings.php b/includes/admin/importers/mappings/mappings.php index 1b965b5dc51..11422da921b 100644 --- a/includes/admin/importers/mappings/mappings.php +++ b/includes/admin/importers/mappings/mappings.php @@ -1,12 +1,14 @@

      ' . number_format_i18n( $imported ) . '' - ); - } + if ( 0 < $imported ) { + $results[] = sprintf( + /* translators: %d: products count */ + _n( '%s product imported', '%s products imported', $imported, 'woocommerce' ), + '' . number_format_i18n( $imported ) . '' + ); + } - if ( 0 < $updated ) { - $results[] = sprintf( - /* translators: %d: products count */ - _n( '%s product updated', '%s products updated', $updated, 'woocommerce' ), - '' . number_format_i18n( $updated ) . '' - ); - } + if ( 0 < $updated ) { + $results[] = sprintf( + /* translators: %d: products count */ + _n( '%s product updated', '%s products updated', $updated, 'woocommerce' ), + '' . number_format_i18n( $updated ) . '' + ); + } - if ( 0 < $skipped ) { - $results[] = sprintf( - /* translators: %d: products count */ - _n( '%s product was skipped', '%s products were skipped', $skipped, 'woocommerce' ), - '' . number_format_i18n( $skipped ) . '' - ); - } + if ( 0 < $skipped ) { + $results[] = sprintf( + /* translators: %d: products count */ + _n( '%s product was skipped', '%s products were skipped', $skipped, 'woocommerce' ), + '' . number_format_i18n( $skipped ) . '' + ); + } - if ( 0 < $failed ) { - $results [] = sprintf( - /* translators: %d: products count */ - _n( 'Failed to import %s product', 'Failed to import %s products', $failed, 'woocommerce' ), - '' . number_format_i18n( $failed ) . '' - ); - } + if ( 0 < $failed ) { + $results [] = sprintf( + /* translators: %d: products count */ + _n( 'Failed to import %s product', 'Failed to import %s products', $failed, 'woocommerce' ), + '' . number_format_i18n( $failed ) . '' + ); + } - if ( 0 < $failed || 0 < $skipped ) { - $results[] = '' . __( 'View import log', 'woocommerce' ) . ''; - } + if ( 0 < $failed || 0 < $skipped ) { + $results[] = '' . __( 'View import log', 'woocommerce' ) . ''; + } - /* translators: %d: import results */ - echo wp_kses_post( __( 'Import complete!', 'woocommerce' ) . ' ' . implode( '. ', $results ) ); + /* translators: %d: import results */ + echo wp_kses_post( __( 'Import complete!', 'woocommerce' ) . ' ' . implode( '. ', $results ) ); ?>
      - + diff --git a/includes/admin/importers/views/html-csv-import-progress.php b/includes/admin/importers/views/html-csv-import-progress.php index 490d22a2e19..ea1ed336b0a 100644 --- a/includes/admin/importers/views/html-csv-import-progress.php +++ b/includes/admin/importers/views/html-csv-import-progress.php @@ -1,7 +1,10 @@
        steps as $step_key => $step ) : ?> -
        2. + step ) { + $step_class = 'active'; + } elseif ( array_search( $this->step, array_keys( $this->steps ), true ) > array_search( $step_key, array_keys( $this->steps ), true ) ) { + $step_class = 'done'; + } + ?> +
      2. + +
      diff --git a/includes/admin/importers/views/html-product-csv-import-form.php b/includes/admin/importers/views/html-product-csv-import-form.php index 16525304fc4..98ecb92726f 100644 --- a/includes/admin/importers/views/html-product-csv-import-form.php +++ b/includes/admin/importers/views/html-product-csv-import-form.php @@ -1,7 +1,10 @@
      + ?> +

      -
      + -
      + + + ?> + -
      +
      - + - +
      '; + } + + /** + * Define primary column. + * + * @return string + */ + protected function get_primary_column() { + return 'coupon_code'; + } + + /** + * Get row actions to show in the list table. + * + * @param array $actions Array of actions. + * @param WP_Post $post Current post object. + * @return array + */ + protected function get_row_actions( $actions, $post ) { + unset( $actions['inline hide-if-no-js'] ); + return $actions; + } + + /** + * Define which columns to show on this screen. + * + * @param array $columns Existing columns. + * @return array + */ + public function define_columns( $columns ) { + $show_columns = array(); + $show_columns['cb'] = $columns['cb']; + $show_columns['coupon_code'] = __( 'Code', 'woocommerce' ); + $show_columns['type'] = __( 'Coupon type', 'woocommerce' ); + $show_columns['amount'] = __( 'Coupon amount', 'woocommerce' ); + $show_columns['description'] = __( 'Description', 'woocommerce' ); + $show_columns['products'] = __( 'Product IDs', 'woocommerce' ); + $show_columns['usage'] = __( 'Usage / Limit', 'woocommerce' ); + $show_columns['expiry_date'] = __( 'Expiry date', 'woocommerce' ); + + return $show_columns; + } + + /** + * Pre-fetch any data for the row each column has access to it. the_coupon global is there for bw compat. + * + * @param int $post_id Post ID being shown. + */ + protected function prepare_row_data( $post_id ) { + global $the_coupon; + + if ( empty( $this->object ) || $this->object->get_id() !== $post_id ) { + $this->object = new WC_Coupon( $post_id ); + $the_coupon = $this->object; + } + } + + /** + * Render columm: coupon_code. + */ + protected function render_coupon_code_column() { + global $post; + + $edit_link = get_edit_post_link( $this->object->get_id() ); + $title = $this->object->get_code(); + + echo '' . esc_html( $title ) . ''; + _post_states( $post ); + echo ''; + } + + /** + * Render columm: type. + */ + protected function render_type_column() { + echo esc_html( wc_get_coupon_type( $this->object->get_discount_type() ) ); + } + + /** + * Render columm: amount. + */ + protected function render_amount_column() { + echo esc_html( wc_format_localized_price( $this->object->get_amount() ) ); + } + /** + * Render columm: products. + */ + protected function render_products_column() { + $product_ids = $this->object->get_product_ids(); + + if ( count( $product_ids ) > 0 ) { + echo esc_html( implode( ', ', $product_ids ) ); + } else { + echo '–'; + } + } + + /** + * Render columm: usage_limit. + */ + protected function render_usage_limit_column() { + $usage_limit = $this->object->get_usage_limit(); + + if ( $usage_limit ) { + echo esc_html( $usage_limit ); + } else { + echo '–'; + } + } + + /** + * Render columm: usage. + */ + protected function render_usage_column() { + $usage_count = $this->object->get_usage_count(); + $usage_limit = $this->object->get_usage_limit(); + + printf( + /* translators: 1: count 2: limit */ + __( '%1$s / %2$s', 'woocommerce' ), + esc_html( $usage_count ), + $usage_limit ? esc_html( $usage_limit ) : '∞' + ); + } + + /** + * Render columm: expiry_date. + */ + protected function render_expiry_date_column() { + $expiry_date = $this->object->get_date_expires(); + + if ( $expiry_date ) { + echo esc_html( $expiry_date->date_i18n( 'F j, Y' ) ); + } else { + echo '–'; + } + } + + /** + * Render columm: description. + */ + protected function render_description_column() { + echo wp_kses_post( $this->object->get_description() ? $this->object->get_description() : '–' ); + } + + /** + * Render any custom filters and search inputs for the list table. + */ + protected function render_filters() { + ?> + + '; + echo '

      ' . esc_html__( 'When you receive a new order, it will appear here.', 'woocommerce' ) . '

      '; + echo '' . esc_html__( 'Learn more about orders', 'woocommerce' ) . ''; + echo '
      '; + } + + /** + * Define primary column. + * + * @return string + */ + protected function get_primary_column() { + return 'order_number'; + } + + /** + * Get row actions to show in the list table. + * + * @param array $actions Array of actions. + * @param WP_Post $post Current post object. + * @return array + */ + protected function get_row_actions( $actions, $post ) { + return array(); + } + + /** + * Define hidden columns. + * + * @return array + */ + protected function define_hidden_columns() { + return array( + 'shipping_address', + 'billing_address', + 'wc_actions', + ); + } + + /** + * Define which columns are sortable. + * + * @param array $columns Existing columns. + * @return array + */ + public function define_sortable_columns( $columns ) { + $custom = array( + 'order_number' => 'ID', + 'order_total' => 'order_total', + 'order_date' => 'date', + ); + unset( $columns['comments'] ); + + return wp_parse_args( $custom, $columns ); + } + + /** + * Define which columns to show on this screen. + * + * @param array $columns Existing columns. + * @return array + */ + public function define_columns( $columns ) { + $show_columns = array(); + $show_columns['cb'] = $columns['cb']; + $show_columns['order_number'] = __( 'Order', 'woocommerce' ); + $show_columns['order_date'] = __( 'Date', 'woocommerce' ); + $show_columns['order_status'] = __( 'Status', 'woocommerce' ); + $show_columns['billing_address'] = __( 'Billing', 'woocommerce' ); + $show_columns['shipping_address'] = __( 'Ship to', 'woocommerce' ); + $show_columns['order_total'] = __( 'Total', 'woocommerce' ); + $show_columns['wc_actions'] = __( 'Actions', 'woocommerce' ); + + wp_enqueue_script( 'wc-orders' ); + + return $show_columns; + } + + /** + * Define bulk actions. + * + * @param array $actions Existing actions. + * @return array + */ + public function define_bulk_actions( $actions ) { + if ( isset( $actions['edit'] ) ) { + unset( $actions['edit'] ); + } + + $actions['mark_processing'] = __( 'Change status to processing', 'woocommerce' ); + $actions['mark_on-hold'] = __( 'Change status to on-hold', 'woocommerce' ); + $actions['mark_completed'] = __( 'Change status to completed', 'woocommerce' ); + $actions['remove_personal_data'] = __( 'Remove personal data', 'woocommerce' ); + + return $actions; + } + + /** + * Pre-fetch any data for the row each column has access to it. the_order global is there for bw compat. + * + * @param int $post_id Post ID being shown. + */ + protected function prepare_row_data( $post_id ) { + global $the_order; + + if ( empty( $this->object ) || $this->object->get_id() !== $post_id ) { + $this->object = wc_get_order( $post_id ); + $the_order = $this->object; + } + } + + /** + * Render columm: order_number. + */ + protected function render_order_number_column() { + $buyer = ''; + + if ( $this->object->get_billing_first_name() || $this->object->get_billing_last_name() ) { + /* translators: 1: first name 2: last name */ + $buyer = trim( sprintf( _x( '%1$s %2$s', 'full name', 'woocommerce' ), $this->object->get_billing_first_name(), $this->object->get_billing_last_name() ) ); + } elseif ( $this->object->get_billing_company() ) { + $buyer = trim( $this->object->get_billing_company() ); + } elseif ( $this->object->get_customer_id() ) { + $user = get_user_by( 'id', $this->object->get_customer_id() ); + $buyer = ucwords( $user->display_name ); + } + + if ( $this->object->get_status() === 'trash' ) { + echo '#' . esc_attr( $this->object->get_order_number() ) . ' ' . esc_html( $buyer ) . ''; + } else { + echo '' . esc_html( __( 'Preview', 'woocommerce' ) ) . ''; + echo '#' . esc_attr( $this->object->get_order_number() ) . ' ' . esc_html( $buyer ) . ''; + } + } + + /** + * Render columm: order_status. + */ + protected function render_order_status_column() { + $tooltip = ''; + $comment_count = get_comment_count( $this->object->get_id() ); + $approved_comments_count = absint( $comment_count['approved'] ); + + if ( $approved_comments_count ) { + $latest_notes = wc_get_order_notes( + array( + 'order_id' => $this->object->get_id(), + 'limit' => 1, + 'orderby' => 'date_created_gmt', + ) + ); + + $latest_note = current( $latest_notes ); + + if ( isset( $latest_note->content ) && 1 === $approved_comments_count ) { + $tooltip = wc_sanitize_tooltip( $latest_note->content ); + } elseif ( isset( $latest_note->content ) ) { + /* translators: %d: notes count */ + $tooltip = wc_sanitize_tooltip( $latest_note->content . '
      ' . sprintf( _n( 'Plus %d other note', 'Plus %d other notes', ( $approved_comments_count - 1 ), 'woocommerce' ), $approved_comments_count - 1 ) . '' ); + } else { + /* translators: %d: notes count */ + $tooltip = wc_sanitize_tooltip( sprintf( _n( '%d note', '%d notes', $approved_comments_count, 'woocommerce' ), $approved_comments_count ) ); + } + } + + if ( $tooltip ) { + printf( '%s', esc_attr( sanitize_html_class( 'status-' . $this->object->get_status() ) ), wp_kses_post( $tooltip ), esc_html( wc_get_order_status_name( $this->object->get_status() ) ) ); + } else { + printf( '%s', esc_attr( sanitize_html_class( 'status-' . $this->object->get_status() ) ), esc_html( wc_get_order_status_name( $this->object->get_status() ) ) ); + } + } + + /** + * Render columm: order_date. + */ + protected function render_order_date_column() { + $order_timestamp = $this->object->get_date_created() ? $this->object->get_date_created()->getTimestamp() : ''; + + if ( ! $order_timestamp ) { + echo '–'; + return; + } + + // Check if the order was created within the last 24 hours, and not in the future. + if ( $order_timestamp > strtotime( '-1 day', current_time( 'timestamp', true ) ) && $order_timestamp <= current_time( 'timestamp', true ) ) { + $show_date = sprintf( + /* translators: %s: human-readable time difference */ + _x( '%s ago', '%s = human-readable time difference', 'woocommerce' ), + human_time_diff( $this->object->get_date_created()->getTimestamp(), current_time( 'timestamp', true ) ) + ); + } else { + $show_date = $this->object->get_date_created()->date_i18n( apply_filters( 'woocommerce_admin_order_date_format', __( 'M j, Y', 'woocommerce' ) ) ); + } + printf( + '', + esc_attr( $this->object->get_date_created()->date( 'c' ) ), + esc_html( $this->object->get_date_created()->date_i18n( get_option( 'date_format' ) . ' ' . get_option( 'time_format' ) ) ), + esc_html( $show_date ) + ); + } + + /** + * Render columm: order_total. + */ + protected function render_order_total_column() { + if ( $this->object->get_payment_method_title() ) { + /* translators: %s: method */ + echo '' . wp_kses_post( $this->object->get_formatted_order_total() ) . ''; + } else { + echo wp_kses_post( $this->object->get_formatted_order_total() ); + } + } + + /** + * Render columm: wc_actions. + */ + protected function render_wc_actions_column() { + echo '

      '; + + do_action( 'woocommerce_admin_order_actions_start', $this->object ); + + $actions = array(); + + if ( $this->object->has_status( array( 'pending', 'on-hold' ) ) ) { + $actions['processing'] = array( + 'url' => wp_nonce_url( admin_url( 'admin-ajax.php?action=woocommerce_mark_order_status&status=processing&order_id=' . $this->object->get_id() ), 'woocommerce-mark-order-status' ), + 'name' => __( 'Processing', 'woocommerce' ), + 'action' => 'processing', + ); + } + + if ( $this->object->has_status( array( 'pending', 'on-hold', 'processing' ) ) ) { + $actions['complete'] = array( + 'url' => wp_nonce_url( admin_url( 'admin-ajax.php?action=woocommerce_mark_order_status&status=completed&order_id=' . $this->object->get_id() ), 'woocommerce-mark-order-status' ), + 'name' => __( 'Complete', 'woocommerce' ), + 'action' => 'complete', + ); + } + + $actions = apply_filters( 'woocommerce_admin_order_actions', $actions, $this->object ); + + echo wc_render_action_buttons( $actions ); // WPCS: XSS ok. + + do_action( 'woocommerce_admin_order_actions_end', $this->object ); + + echo '

      '; + } + + /** + * Render columm: billing_address. + */ + protected function render_billing_address_column() { + $address = $this->object->get_formatted_billing_address(); + + if ( $address ) { + echo esc_html( preg_replace( '##i', ', ', $address ) ); + + if ( $this->object->get_payment_method() ) { + /* translators: %s: payment method */ + echo '' . sprintf( __( 'via %s', 'woocommerce' ), esc_html( $this->object->get_payment_method_title() ) ) . ''; // WPCS: XSS ok. + } + } else { + echo '–'; + } + } + + /** + * Render columm: shipping_address. + */ + protected function render_shipping_address_column() { + $address = $this->object->get_formatted_shipping_address(); + + if ( $address ) { + echo '' . esc_html( preg_replace( '##i', ', ', $address ) ) . ''; + if ( $this->object->get_shipping_method() ) { + /* translators: %s: shipping method */ + echo '' . sprintf( __( 'via %s', 'woocommerce' ), esc_html( $this->object->get_shipping_method() ) ) . ''; // WPCS: XSS ok. + } + } else { + echo '–'; + } + } + + /** + * Template for order preview. + * + * @since 3.3.0 + */ + public function order_preview_template() { + ?> + + get_items(), $order ); + $columns = apply_filters( + 'woocommerce_admin_order_preview_line_item_columns', array( + 'product' => __( 'Product', 'woocommerce' ), + 'quantity' => __( 'Quantity', 'woocommerce' ), + 'tax' => __( 'Tax', 'woocommerce' ), + 'total' => __( 'Total', 'woocommerce' ), + ), $order + ); + + if ( ! wc_tax_enabled() ) { + unset( $columns['tax'] ); + } + + $html = ' +
      + + + '; + + foreach ( $columns as $column => $label ) { + $html .= ''; + } + + $html .= ' + + + '; + + foreach ( $line_items as $item_id => $item ) { + + $product_object = is_callable( array( $item, 'get_product' ) ) ? $item->get_product() : null; + $row_class = apply_filters( 'woocommerce_admin_html_order_preview_item_class', '', $item, $order ); + + $html .= ''; + + foreach ( $columns as $column => $label ) { + $html .= ''; + } + + $html .= ''; + } + + $html .= ' + +
      ' . esc_html( $label ) . '
      '; + switch ( $column ) { + case 'product': + $html .= wp_kses_post( $item->get_name() ); + + if ( $product_object ) { + $html .= '
      ' . esc_html( $product_object->get_sku() ) . '
      '; + } + + $meta_data = $item->get_formatted_meta_data( '' ); + + if ( $meta_data ) { + $html .= ''; + + foreach ( $meta_data as $meta_id => $meta ) { + if ( in_array( $meta->key, $hidden_order_itemmeta, true ) ) { + continue; + } + $html .= ''; + } + $html .= '
      ' . wp_kses_post( $meta->display_key ) . ':' . wp_kses_post( force_balance_tags( $meta->display_value ) ) . '
      '; + } + break; + case 'quantity': + $html .= esc_html( $item->get_quantity() ); + break; + case 'tax': + $html .= wc_price( $item->get_total_tax(), array( 'currency' => $order->get_currency() ) ); + break; + case 'total': + $html .= wc_price( $item->get_total(), array( 'currency' => $order->get_currency() ) ); + break; + default: + $html .= apply_filters( 'woocommerce_admin_order_preview_line_item_column_' . sanitize_key( $column ), '', $item, $item_id, $order ); + break; + } + $html .= '
      +
      '; + + return $html; + } + + /** + * Get actions to display in the preview as HTML. + * + * @param WC_Order $order Order object. + * @return string + */ + public static function get_order_preview_actions_html( $order ) { + $actions = array(); + $status_actions = array(); + + if ( $order->has_status( array( 'pending' ) ) ) { + $status_actions['on-hold'] = array( + 'url' => wp_nonce_url( admin_url( 'admin-ajax.php?action=woocommerce_mark_order_status&status=on-hold&order_id=' . $order->get_id() ), 'woocommerce-mark-order-status' ), + 'name' => __( 'On-hold', 'woocommerce' ), + 'title' => __( 'Change order status to on-hold', 'woocommerce' ), + 'action' => 'on-hold', + ); + } + + if ( $order->has_status( array( 'pending', 'on-hold' ) ) ) { + $status_actions['processing'] = array( + 'url' => wp_nonce_url( admin_url( 'admin-ajax.php?action=woocommerce_mark_order_status&status=processing&order_id=' . $order->get_id() ), 'woocommerce-mark-order-status' ), + 'name' => __( 'Processing', 'woocommerce' ), + 'title' => __( 'Change order status to processing', 'woocommerce' ), + 'action' => 'processing', + ); + } + + if ( $order->has_status( array( 'pending', 'on-hold', 'processing' ) ) ) { + $status_actions['complete'] = array( + 'url' => wp_nonce_url( admin_url( 'admin-ajax.php?action=woocommerce_mark_order_status&status=completed&order_id=' . $order->get_id() ), 'woocommerce-mark-order-status' ), + 'name' => __( 'Completed', 'woocommerce' ), + 'title' => __( 'Change order status to completed', 'woocommerce' ), + 'action' => 'complete', + ); + } + + if ( $status_actions ) { + $actions['status'] = array( + 'group' => __( 'Change status: ', 'woocommerce' ), + 'actions' => $status_actions, + ); + } + + return wc_render_action_buttons( apply_filters( 'woocommerce_admin_order_preview_actions', $actions, $order ) ); + } + + /** + * Get order details to send to the ajax endpoint for previews. + * + * @param WC_Order $order Order object. + * @return array + */ + public static function order_preview_get_order_details( $order ) { + if ( ! $order ) { + return array(); + } + + $payment_via = $order->get_payment_method_title(); + $payment_method = $order->get_payment_method(); + $payment_gateways = WC()->payment_gateways() ? WC()->payment_gateways->payment_gateways() : array(); + $transaction_id = $order->get_transaction_id(); + + if ( $transaction_id ) { + + $url = isset( $payment_gateways[ $payment_method ] ) ? $payment_gateways[ $payment_method ]->get_transaction_url( $order ) : false; + + if ( $url ) { + $payment_via .= ' (' . esc_html( $transaction_id ) . ')'; + } else { + $payment_via .= ' (' . esc_html( $transaction_id ) . ')'; + } + } + + $billing_address = $order->get_formatted_billing_address(); + $shipping_address = $order->get_formatted_shipping_address(); + + return apply_filters( + 'woocommerce_admin_order_preview_get_order_details', array( + 'data' => $order->get_data(), + 'order_number' => $order->get_order_number(), + 'item_html' => WC_Admin_List_Table_Orders::get_order_preview_item_html( $order ), + 'actions_html' => WC_Admin_List_Table_Orders::get_order_preview_actions_html( $order ), + 'ship_to_billing' => wc_ship_to_billing_address_only(), + 'needs_shipping' => $order->needs_shipping_address(), + 'formatted_billing_address' => $billing_address ? $billing_address : __( 'N/A', 'woocommerce' ), + 'formatted_shipping_address' => $shipping_address ? $shipping_address : __( 'N/A', 'woocommerce' ), + 'shipping_address_map_url' => $order->get_shipping_address_map_url(), + 'payment_via' => $payment_via, + 'shipping_via' => $order->get_shipping_method(), + 'status' => $order->get_status(), + 'status_name' => wc_get_order_status_name( $order->get_status() ), + ), $order + ); + } + + /** + * Handle bulk actions. + * + * @param string $redirect_to URL to redirect to. + * @param string $action Action name. + * @param array $ids List of ids. + * @return string + */ + public function handle_bulk_actions( $redirect_to, $action, $ids ) { + $ids = apply_filters( 'woocommerce_bulk_action_ids', array_reverse( array_map( 'absint', $ids ) ), $action, 'order' ); + $changed = 0; + + if ( 'remove_personal_data' === $action ) { + $report_action = 'removed_personal_data'; + + foreach ( $ids as $id ) { + $order = wc_get_order( $id ); + + if ( $order ) { + do_action( 'woocommerce_remove_order_personal_data', $order ); + $changed++; + } + } + } elseif ( false !== strpos( $action, 'mark_' ) ) { + $order_statuses = wc_get_order_statuses(); + $new_status = substr( $action, 5 ); // Get the status name from action. + $report_action = 'marked_' . $new_status; + + // Sanity check: bail out if this is actually not a status, or is not a registered status. + if ( isset( $order_statuses[ 'wc-' . $new_status ] ) ) { + // Initialize payment gateways in case order has hooked status transition actions. + wc()->payment_gateways(); + + foreach ( $ids as $id ) { + $order = wc_get_order( $id ); + $order->update_status( $new_status, __( 'Order status changed by bulk edit:', 'woocommerce' ), true ); + do_action( 'woocommerce_order_edit_status', $id, $new_status ); + $changed++; + } + } + } + + if ( $changed ) { + $redirect_to = add_query_arg( + array( + 'post_type' => $this->list_table_type, + 'bulk_action' => $report_action, + 'changed' => $changed, + 'ids' => join( ',', $ids ), + ), $redirect_to + ); + } + + return esc_url_raw( $redirect_to ); + } + + /** + * Show confirmation message that order status changed for number of orders. + */ + public function bulk_admin_notices() { + global $post_type, $pagenow; + + // Bail out if not on shop order list page. + if ( 'edit.php' !== $pagenow || 'shop_order' !== $post_type || ! isset( $_REQUEST['bulk_action'] ) ) { // WPCS: input var ok, CSRF ok. + return; + } + + $order_statuses = wc_get_order_statuses(); + $number = isset( $_REQUEST['changed'] ) ? absint( $_REQUEST['changed'] ) : 0; // WPCS: input var ok, CSRF ok. + $bulk_action = wc_clean( wp_unslash( $_REQUEST['bulk_action'] ) ); // WPCS: input var ok, CSRF ok. + + // Check if any status changes happened. + foreach ( $order_statuses as $slug => $name ) { + if ( 'marked_' . str_replace( 'wc-', '', $slug ) === $bulk_action ) { // WPCS: input var ok, CSRF ok. + /* translators: %d: orders count */ + $message = sprintf( _n( '%d order status changed.', '%d order statuses changed.', $number, 'woocommerce' ), number_format_i18n( $number ) ); + echo '

      ' . esc_html( $message ) . '

      '; + break; + } + } + + if ( 'removed_personal_data' === $bulk_action ) { // WPCS: input var ok, CSRF ok. + /* translators: %d: orders count */ + $message = sprintf( _n( 'Removed personal data from %d order.', 'Removed personal data from %d orders.', $number, 'woocommerce' ), number_format_i18n( $number ) ); + echo '

      ' . esc_html( $message ) . '

      '; + } + } + + /** + * See if we should render search filters or not. + */ + public function restrict_manage_posts() { + global $typenow; + + if ( in_array( $typenow, wc_get_order_types( 'order-meta-boxes' ), true ) ) { + $this->render_filters(); + } + } + + /** + * Render any custom filters and search inputs for the list table. + */ + protected function render_filters() { + $user_string = ''; + $user_id = ''; + + if ( ! empty( $_GET['_customer_user'] ) ) { // WPCS: input var ok. + $user_id = absint( $_GET['_customer_user'] ); // WPCS: input var ok, sanitization ok. + $user = get_user_by( 'id', $user_id ); + + $user_string = sprintf( + /* translators: 1: user display name 2: user ID 3: user email */ + esc_html__( '%1$s (#%2$s – %3$s)', 'woocommerce' ), + $user->display_name, + absint( $user->ID ), + $user->user_email + ); + } + ?> + + query_filters( $query_vars ); + } + + return $query_vars; + } + + /** + * Handle any custom filters. + * + * @param array $query_vars Query vars. + * @return array + */ + protected function query_filters( $query_vars ) { + global $wp_post_statuses; + + // Filter the orders by the posted customer. + if ( ! empty( $_GET['_customer_user'] ) ) { // WPCS: input var ok. + $customer_id = (int) $_GET['_customer_user']; // WPCS: input var ok, sanitization ok. + + // On WC 3.5.0 the ID of the user that placed the order was moved from the post meta _customer_user to the post_author field in the wp_posts table. + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '>=' ) ) { + $query_vars['author'] = $customer_id; + } else { + // @codingStandardsIgnoreStart + $query_vars['meta_query'] = array( + array( + 'key' => '_customer_user', + 'value' => $customer_id, + 'compare' => '=', + ), + ); + // @codingStandardsIgnoreEnd + } + } + + // Sorting. + if ( isset( $query_vars['orderby'] ) ) { + if ( 'order_total' === $query_vars['orderby'] ) { + // @codingStandardsIgnoreStart + $query_vars = array_merge( $query_vars, array( + 'meta_key' => '_order_total', + 'orderby' => 'meta_value_num', + ) ); + // @codingStandardsIgnoreEnd + } + } + + // Status. + if ( ! isset( $query_vars['post_status'] ) ) { + $post_statuses = wc_get_order_statuses(); + + foreach ( $post_statuses as $status => $value ) { + if ( isset( $wp_post_statuses[ $status ] ) && false === $wp_post_statuses[ $status ]->show_in_admin_all_list ) { + unset( $post_statuses[ $status ] ); + } + } + + $query_vars['post_status'] = array_keys( $post_statuses ); + } + return $query_vars; + } + + /** + * Change the label when searching orders. + * + * @param mixed $query Current search query. + * @return string + */ + public function search_label( $query ) { + global $pagenow, $typenow; + + if ( 'edit.php' !== $pagenow || 'shop_order' !== $typenow || ! get_query_var( 'shop_order_search' ) || ! isset( $_GET['s'] ) ) { // WPCS: input var ok. + return $query; + } + + return wc_clean( wp_unslash( $_GET['s'] ) ); // WPCS: input var ok, sanitization ok. + } + + /** + * Query vars for custom searches. + * + * @param mixed $public_query_vars Array of query vars. + * @return array + */ + public function add_custom_query_var( $public_query_vars ) { + $public_query_vars[] = 'shop_order_search'; + return $public_query_vars; + } + + /** + * Search custom fields as well as content. + * + * @param WP_Query $wp Query object. + */ + public function search_custom_fields( $wp ) { + global $pagenow; + + if ( 'edit.php' !== $pagenow || empty( $wp->query_vars['s'] ) || 'shop_order' !== $wp->query_vars['post_type'] || ! isset( $_GET['s'] ) ) { // WPCS: input var ok. + return; + } + + $post_ids = wc_order_search( wc_clean( wp_unslash( $_GET['s'] ) ) ); // WPCS: input var ok, sanitization ok. + + if ( ! empty( $post_ids ) ) { + // Remove "s" - we don't want to search order name. + unset( $wp->query_vars['s'] ); + + // so we know we're doing this. + $wp->query_vars['shop_order_search'] = true; + + // Search by found posts. + $wp->query_vars['post__in'] = array_merge( $post_ids, array( 0 ) ); + } + } +} diff --git a/includes/admin/list-tables/class-wc-admin-list-table-products.php b/includes/admin/list-tables/class-wc-admin-list-table-products.php new file mode 100644 index 00000000000..a0091c32f77 --- /dev/null +++ b/includes/admin/list-tables/class-wc-admin-list-table-products.php @@ -0,0 +1,523 @@ +'; + echo '

      ' . esc_html__( 'Ready to start selling something awesome?', 'woocommerce' ) . '

      '; + echo '' . esc_html__( 'Create your first product!', 'woocommerce' ) . ''; + echo '' . esc_html__( 'Import products from a CSV file', 'woocommerce' ) . ''; + echo '
      '; + } + + /** + * Define primary column. + * + * @return string + */ + protected function get_primary_column() { + return 'name'; + } + + /** + * Get row actions to show in the list table. + * + * @param array $actions Array of actions. + * @param WP_Post $post Current post object. + * @return array + */ + protected function get_row_actions( $actions, $post ) { + /* translators: %d: product ID. */ + return array_merge( array( 'id' => sprintf( __( 'ID: %d', 'woocommerce' ), $post->ID ) ), $actions ); + } + + /** + * Define which columns are sortable. + * + * @param array $columns Existing columns. + * @return array + */ + public function define_sortable_columns( $columns ) { + $custom = array( + 'price' => 'price', + 'sku' => 'sku', + 'name' => 'title', + ); + return wp_parse_args( $custom, $columns ); + } + + /** + * Define which columns to show on this screen. + * + * @param array $columns Existing columns. + * @return array + */ + public function define_columns( $columns ) { + if ( empty( $columns ) && ! is_array( $columns ) ) { + $columns = array(); + } + + unset( $columns['title'], $columns['comments'], $columns['date'] ); + + $show_columns = array(); + $show_columns['cb'] = ''; + $show_columns['thumb'] = '' . __( 'Image', 'woocommerce' ) . ''; + $show_columns['name'] = __( 'Name', 'woocommerce' ); + + if ( wc_product_sku_enabled() ) { + $show_columns['sku'] = __( 'SKU', 'woocommerce' ); + } + + if ( 'yes' === get_option( 'woocommerce_manage_stock' ) ) { + $show_columns['is_in_stock'] = __( 'Stock', 'woocommerce' ); + } + + $show_columns['price'] = __( 'Price', 'woocommerce' ); + $show_columns['product_cat'] = __( 'Categories', 'woocommerce' ); + $show_columns['product_tag'] = __( 'Tags', 'woocommerce' ); + $show_columns['featured'] = '' . __( 'Featured', 'woocommerce' ) . ''; + $show_columns['date'] = __( 'Date', 'woocommerce' ); + + return array_merge( $show_columns, $columns ); + } + + /** + * Pre-fetch any data for the row each column has access to it. the_product global is there for bw compat. + * + * @param int $post_id Post ID being shown. + */ + protected function prepare_row_data( $post_id ) { + global $the_product; + + if ( empty( $this->object ) || $this->object->get_id() !== $post_id ) { + $the_product = wc_get_product( $post_id ); + $this->object = $the_product; + } + } + + /** + * Render columm: thumb. + */ + protected function render_thumb_column() { + echo '' . $this->object->get_image( 'thumbnail' ) . ''; // WPCS: XSS ok. + } + + /** + * Render column: name. + */ + protected function render_name_column() { + global $post; + + $edit_link = get_edit_post_link( $this->object->get_id() ); + $title = _draft_or_post_title(); + + echo '' . esc_html( $title ) . ''; + + _post_states( $post ); + + echo ''; + + if ( $this->object->get_parent_id() > 0 ) { + echo '  ← ' . get_the_title( $this->object->get_parent_id() ) . ''; + } + + get_inline_data( $post ); + + /* Custom inline data for woocommerce. */ + echo ' + + '; + } + + /** + * Render columm: sku. + */ + protected function render_sku_column() { + echo $this->object->get_sku() ? esc_html( $this->object->get_sku() ) : '–'; + } + + /** + * Render columm: price. + */ + protected function render_price_column() { + echo $this->object->get_price_html() ? wp_kses_post( $this->object->get_price_html() ) : '–'; + } + + /** + * Render columm: product_cat. + */ + protected function render_product_cat_column() { + $terms = get_the_terms( $this->object->get_id(), 'product_cat' ); + if ( ! $terms ) { + echo '–'; + } else { + $termlist = array(); + foreach ( $terms as $term ) { + $termlist[] = '' . esc_html( $term->name ) . ''; + } + + echo apply_filters( 'woocommerce_admin_product_term_list', implode( ', ', $termlist ), 'product_cat', $this->object->get_id(), $termlist, $terms ); // WPCS: XSS ok. + } + } + + /** + * Render columm: product_tag. + */ + protected function render_product_tag_column() { + $terms = get_the_terms( $this->object->get_id(), 'product_tag' ); + if ( ! $terms ) { + echo '–'; + } else { + $termlist = array(); + foreach ( $terms as $term ) { + $termlist[] = '' . esc_html( $term->name ) . ''; + } + + echo apply_filters( 'woocommerce_admin_product_term_list', implode( ', ', $termlist ), 'product_tag', $this->object->get_id(), $termlist, $terms ); // WPCS: XSS ok. + } + } + + /** + * Render columm: featured. + */ + protected function render_featured_column() { + $url = wp_nonce_url( admin_url( 'admin-ajax.php?action=woocommerce_feature_product&product_id=' . $this->object->get_id() ), 'woocommerce-feature-product' ); + echo ''; + if ( $this->object->is_featured() ) { + echo '' . esc_html__( 'Yes', 'woocommerce' ) . ''; + } else { + echo '' . esc_html__( 'No', 'woocommerce' ) . ''; + } + echo ''; + } + + /** + * Render columm: is_in_stock. + */ + protected function render_is_in_stock_column() { + if ( $this->object->is_on_backorder() ) { + $stock_html = '' . __( 'On backorder', 'woocommerce' ) . ''; + } elseif ( $this->object->is_in_stock() ) { + $stock_html = '' . __( 'In stock', 'woocommerce' ) . ''; + } else { + $stock_html = '' . __( 'Out of stock', 'woocommerce' ) . ''; + } + + if ( $this->object->managing_stock() ) { + $stock_html .= ' (' . wc_stock_amount( $this->object->get_stock_quantity() ) . ')'; + } + + echo wp_kses_post( apply_filters( 'woocommerce_admin_stock_html', $stock_html, $this->object ) ); + } + + /** + * Query vars for custom searches. + * + * @param mixed $public_query_vars Array of query vars. + * @return array + */ + public function add_custom_query_var( $public_query_vars ) { + $public_query_vars[] = 'sku'; + return $public_query_vars; + } + + /** + * Render any custom filters and search inputs for the list table. + */ + protected function render_filters() { + $filters = apply_filters( 'woocommerce_products_admin_list_table_filters', array( + 'product_category' => array( $this, 'render_products_category_filter' ), + 'product_type' => array( $this, 'render_products_type_filter' ), + 'stock_status' => array( $this, 'render_products_stock_status_filter' ), + ) ); + + ob_start(); + foreach ( $filters as $filter_callback ) { + call_user_func( $filter_callback ); + } + $output = ob_get_clean(); + + echo apply_filters( 'woocommerce_product_filters', $output ); // WPCS: XSS ok. + } + + /** + * Render the product category filter for the list table. + * + * @since 3.5.0 + */ + protected function render_products_category_filter() { + $categories_count = (int) wp_count_terms( 'product_cat' ); + + if ( $categories_count <= apply_filters( 'woocommerce_product_category_filter_threshold', 100 ) ) { + wc_product_dropdown_categories( + array( + 'option_select_text' => __( 'Filter by category', 'woocommerce' ), + 'hide_empty' => 0, + ) + ); + } else { + $current_category_slug = isset( $_GET['product_cat'] ) ? wc_clean( wp_unslash( $_GET['product_cat'] ) ) : false; // WPCS: input var ok, CSRF ok. + $current_category = $current_category_slug ? get_term_by( 'slug', $current_category_slug, 'product_cat' ) : false; + ?> + + '; + + foreach ( wc_get_product_types() as $value => $label ) { + $output .= '
      + // Usage limit per users. + woocommerce_wp_text_input( + array( + 'id' => 'usage_limit_per_user', + 'label' => __( 'Usage limit per user', 'woocommerce' ), + 'placeholder' => esc_attr__( 'Unlimited usage', 'woocommerce' ), + 'description' => __( 'How many times this coupon can be used by an individual user. Uses billing email for guests, and user ID for logged in users.', 'woocommerce' ), + 'desc_tip' => true, + 'class' => 'short', + 'type' => 'number', + 'custom_attributes' => array( + 'step' => 1, + 'min' => 0, + ), + 'value' => $coupon->get_usage_limit_per_user( 'edit' ) ? $coupon->get_usage_limit_per_user( 'edit' ) : '', + ) + ); + ?> +
      + get_id(), $coupon ); ?> +
      get_id(), $coupon ); ?>
      @@ -306,11 +348,11 @@ class WC_Meta_Box_Coupon_Data { /** * Save meta box data. * - * @param int $post_id + * @param int $post_id * @param WP_Post $post */ public static function save( $post_id, $post ) { - // Check for dupe coupons + // Check for dupe coupons. $coupon_code = wc_format_coupon_code( $post->post_title ); $id_from_code = wc_get_coupon_id_by_code( $coupon_code, $post_id ); @@ -322,25 +364,27 @@ class WC_Meta_Box_Coupon_Data { $exclude_product_categories = isset( $_POST['exclude_product_categories'] ) ? (array) $_POST['exclude_product_categories'] : array(); $coupon = new WC_Coupon( $post_id ); - $coupon->set_props( array( - 'code' => $post->post_title, - 'discount_type' => wc_clean( $_POST['discount_type'] ), - 'amount' => wc_format_decimal( $_POST['coupon_amount'] ), - 'date_expires' => wc_clean( $_POST['expiry_date'] ), - 'individual_use' => isset( $_POST['individual_use'] ), - 'product_ids' => isset( $_POST['product_ids'] ) ? array_filter( array_map( 'intval', (array) $_POST['product_ids'] ) ) : array(), - 'excluded_product_ids' => isset( $_POST['exclude_product_ids'] ) ? array_filter( array_map( 'intval', (array) $_POST['exclude_product_ids'] ) ) : array(), - 'usage_limit' => absint( $_POST['usage_limit'] ), - 'usage_limit_per_user' => absint( $_POST['usage_limit_per_user'] ), - 'limit_usage_to_x_items' => absint( $_POST['limit_usage_to_x_items'] ), - 'free_shipping' => isset( $_POST['free_shipping'] ), - 'product_categories' => array_filter( array_map( 'intval', $product_categories ) ), - 'excluded_product_categories' => array_filter( array_map( 'intval', $exclude_product_categories ) ), - 'exclude_sale_items' => isset( $_POST['exclude_sale_items'] ), - 'minimum_amount' => wc_format_decimal( $_POST['minimum_amount'] ), - 'maximum_amount' => wc_format_decimal( $_POST['maximum_amount'] ), - 'email_restrictions' => array_filter( array_map( 'trim', explode( ',', wc_clean( $_POST['customer_email'] ) ) ) ), - ) ); + $coupon->set_props( + array( + 'code' => $post->post_title, + 'discount_type' => wc_clean( $_POST['discount_type'] ), + 'amount' => wc_format_decimal( $_POST['coupon_amount'] ), + 'date_expires' => wc_clean( $_POST['expiry_date'] ), + 'individual_use' => isset( $_POST['individual_use'] ), + 'product_ids' => isset( $_POST['product_ids'] ) ? array_filter( array_map( 'intval', (array) $_POST['product_ids'] ) ) : array(), + 'excluded_product_ids' => isset( $_POST['exclude_product_ids'] ) ? array_filter( array_map( 'intval', (array) $_POST['exclude_product_ids'] ) ) : array(), + 'usage_limit' => absint( $_POST['usage_limit'] ), + 'usage_limit_per_user' => absint( $_POST['usage_limit_per_user'] ), + 'limit_usage_to_x_items' => absint( $_POST['limit_usage_to_x_items'] ), + 'free_shipping' => isset( $_POST['free_shipping'] ), + 'product_categories' => array_filter( array_map( 'intval', $product_categories ) ), + 'excluded_product_categories' => array_filter( array_map( 'intval', $exclude_product_categories ) ), + 'exclude_sale_items' => isset( $_POST['exclude_sale_items'] ), + 'minimum_amount' => wc_format_decimal( $_POST['minimum_amount'] ), + 'maximum_amount' => wc_format_decimal( $_POST['maximum_amount'] ), + 'email_restrictions' => array_filter( array_map( 'trim', explode( ',', wc_clean( $_POST['customer_email'] ) ) ) ), + ) + ); $coupon->save(); do_action( 'woocommerce_coupon_options_save', $post_id, $coupon ); } diff --git a/includes/admin/meta-boxes/class-wc-meta-box-order-actions.php b/includes/admin/meta-boxes/class-wc-meta-box-order-actions.php index 88d99edd61a..c47eaa7af13 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-order-actions.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-order-actions.php @@ -11,7 +11,7 @@ */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + exit; // Exit if accessed directly. } /** @@ -22,7 +22,7 @@ class WC_Meta_Box_Order_Actions { /** * Output the metabox. * - * @param WP_Post $post + * @param WP_Post $post Post object. */ public static function output( $post ) { global $theorder; @@ -32,10 +32,13 @@ class WC_Meta_Box_Order_Actions { $theorder = wc_get_order( $post->ID ); } - $order_actions = apply_filters( 'woocommerce_order_actions', array( - 'send_order_details' => __( 'Email order details to customer', 'woocommerce' ), - 'regenerate_download_permissions' => __( 'Regenerate download permissions', 'woocommerce' ), - ) ); + $order_actions = apply_filters( + 'woocommerce_order_actions', array( + 'send_order_details' => __( 'Email invoice / order details to customer', 'woocommerce' ), + 'send_order_details_admin' => __( 'Resend new order notification', 'woocommerce' ), + 'regenerate_download_permissions' => __( 'Regenerate download permissions', 'woocommerce' ), + ) + ); ?>
        @@ -43,17 +46,17 @@ class WC_Meta_Box_Order_Actions {
      • - +
      • -
        + ID ) ) { if ( ! EMPTY_TRASH_DAYS ) { @@ -61,11 +64,14 @@ class WC_Meta_Box_Order_Actions { } else { $delete_text = __( 'Move to trash', 'woocommerce' ); } - ?> + +
        + ?> + - +
        • ID ); ?> @@ -77,17 +83,17 @@ class WC_Meta_Box_Order_Actions { /** * Save meta box data. * - * @param int $post_id - * @param WP_Post $post + * @param int $post_id Post ID. + * @param WP_Post $post Post Object. */ public static function save( $post_id, $post ) { - // Order data saved, now get it so we can manipulate status + // Order data saved, now get it so we can manipulate status. $order = wc_get_order( $post_id ); - // Handle button actions - if ( ! empty( $_POST['wc_order_action'] ) ) { + // Handle button actions. + if ( ! empty( $_POST['wc_order_action'] ) ) { // @codingStandardsIgnoreLine - $action = wc_clean( $_POST['wc_order_action'] ); + $action = wc_clean( wp_unslash( $_POST['wc_order_action'] ) ); // @codingStandardsIgnoreLine if ( 'send_order_details' === $action ) { do_action( 'woocommerce_before_resend_order_emails', $order, 'customer_invoice' ); @@ -105,6 +111,19 @@ class WC_Meta_Box_Order_Actions { // Change the post saved message. add_filter( 'redirect_post_location', array( __CLASS__, 'set_email_sent_message' ) ); + } elseif ( 'send_order_details_admin' === $action ) { + + do_action( 'woocommerce_before_resend_order_emails', $order, 'new_order' ); + + WC()->payment_gateways(); + WC()->shipping(); + WC()->mailer()->emails['WC_Email_New_Order']->trigger( $order->get_id(), $order ); + + do_action( 'woocommerce_after_resend_order_email', $order, 'new_order' ); + + // Change the post saved message. + add_filter( 'redirect_post_location', array( __CLASS__, 'set_email_sent_message' ) ); + } elseif ( 'regenerate_download_permissions' === $action ) { $data_store = WC_Data_Store::load( 'customer-download' ); @@ -123,12 +142,9 @@ class WC_Meta_Box_Order_Actions { /** * Set the correct message ID. * - * @param string $location - * + * @param string $location Location. * @since 2.3.0 - * * @static - * * @return string */ public static function set_email_sent_message( $location ) { diff --git a/includes/admin/meta-boxes/class-wc-meta-box-order-data.php b/includes/admin/meta-boxes/class-wc-meta-box-order-data.php index 96f4d7a96e2..bbccf7c6d24 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-order-data.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-order-data.php @@ -4,9 +4,9 @@ * * Functions for displaying the order data meta box. * - * @author WooThemes - * @category Admin - * @package WooCommerce/Admin/Meta Boxes + * @author WooThemes + * @category Admin + * @package WooCommerce/Admin/Meta Boxes * @version 2.2.0 */ @@ -38,97 +38,101 @@ class WC_Meta_Box_Order_Data { */ public static function init_address_fields() { - self::$billing_fields = apply_filters( 'woocommerce_admin_billing_fields', array( - 'first_name' => array( - 'label' => __( 'First name', 'woocommerce' ), - 'show' => false, - ), - 'last_name' => array( - 'label' => __( 'Last name', 'woocommerce' ), - 'show' => false, - ), - 'company' => array( - 'label' => __( 'Company', 'woocommerce' ), - 'show' => false, - ), - 'address_1' => array( - 'label' => __( 'Address line 1', 'woocommerce' ), - 'show' => false, - ), - 'address_2' => array( - 'label' => __( 'Address line 2', 'woocommerce' ), - 'show' => false, - ), - 'city' => array( - 'label' => __( 'City', 'woocommerce' ), - 'show' => false, - ), - 'postcode' => array( - 'label' => __( 'Postcode / ZIP', 'woocommerce' ), - 'show' => false, - ), - 'country' => array( - 'label' => __( 'Country', 'woocommerce' ), - 'show' => false, - 'class' => 'js_field-country select short', - 'type' => 'select', - 'options' => array( '' => __( 'Select a country…', 'woocommerce' ) ) + WC()->countries->get_allowed_countries(), - ), - 'state' => array( - 'label' => __( 'State / County', 'woocommerce' ), - 'class' => 'js_field-state select short', - 'show' => false, - ), - 'email' => array( - 'label' => __( 'Email address', 'woocommerce' ), - ), - 'phone' => array( - 'label' => __( 'Phone', 'woocommerce' ), - ), - ) ); + self::$billing_fields = apply_filters( + 'woocommerce_admin_billing_fields', array( + 'first_name' => array( + 'label' => __( 'First name', 'woocommerce' ), + 'show' => false, + ), + 'last_name' => array( + 'label' => __( 'Last name', 'woocommerce' ), + 'show' => false, + ), + 'company' => array( + 'label' => __( 'Company', 'woocommerce' ), + 'show' => false, + ), + 'address_1' => array( + 'label' => __( 'Address line 1', 'woocommerce' ), + 'show' => false, + ), + 'address_2' => array( + 'label' => __( 'Address line 2', 'woocommerce' ), + 'show' => false, + ), + 'city' => array( + 'label' => __( 'City', 'woocommerce' ), + 'show' => false, + ), + 'postcode' => array( + 'label' => __( 'Postcode / ZIP', 'woocommerce' ), + 'show' => false, + ), + 'country' => array( + 'label' => __( 'Country', 'woocommerce' ), + 'show' => false, + 'class' => 'js_field-country select short', + 'type' => 'select', + 'options' => array( '' => __( 'Select a country…', 'woocommerce' ) ) + WC()->countries->get_allowed_countries(), + ), + 'state' => array( + 'label' => __( 'State / County', 'woocommerce' ), + 'class' => 'js_field-state select short', + 'show' => false, + ), + 'email' => array( + 'label' => __( 'Email address', 'woocommerce' ), + ), + 'phone' => array( + 'label' => __( 'Phone', 'woocommerce' ), + ), + ) + ); - self::$shipping_fields = apply_filters( 'woocommerce_admin_shipping_fields', array( - 'first_name' => array( - 'label' => __( 'First name', 'woocommerce' ), - 'show' => false, - ), - 'last_name' => array( - 'label' => __( 'Last name', 'woocommerce' ), - 'show' => false, - ), - 'company' => array( - 'label' => __( 'Company', 'woocommerce' ), - 'show' => false, - ), - 'address_1' => array( - 'label' => __( 'Address line 1', 'woocommerce' ), - 'show' => false, - ), - 'address_2' => array( - 'label' => __( 'Address line 2', 'woocommerce' ), - 'show' => false, - ), - 'city' => array( - 'label' => __( 'City', 'woocommerce' ), - 'show' => false, - ), - 'postcode' => array( - 'label' => __( 'Postcode / ZIP', 'woocommerce' ), - 'show' => false, - ), - 'country' => array( - 'label' => __( 'Country', 'woocommerce' ), - 'show' => false, - 'type' => 'select', - 'class' => 'js_field-country select short', - 'options' => array( '' => __( 'Select a country…', 'woocommerce' ) ) + WC()->countries->get_shipping_countries(), - ), - 'state' => array( - 'label' => __( 'State / County', 'woocommerce' ), - 'class' => 'js_field-state select short', - 'show' => false, - ), - ) ); + self::$shipping_fields = apply_filters( + 'woocommerce_admin_shipping_fields', array( + 'first_name' => array( + 'label' => __( 'First name', 'woocommerce' ), + 'show' => false, + ), + 'last_name' => array( + 'label' => __( 'Last name', 'woocommerce' ), + 'show' => false, + ), + 'company' => array( + 'label' => __( 'Company', 'woocommerce' ), + 'show' => false, + ), + 'address_1' => array( + 'label' => __( 'Address line 1', 'woocommerce' ), + 'show' => false, + ), + 'address_2' => array( + 'label' => __( 'Address line 2', 'woocommerce' ), + 'show' => false, + ), + 'city' => array( + 'label' => __( 'City', 'woocommerce' ), + 'show' => false, + ), + 'postcode' => array( + 'label' => __( 'Postcode / ZIP', 'woocommerce' ), + 'show' => false, + ), + 'country' => array( + 'label' => __( 'Country', 'woocommerce' ), + 'show' => false, + 'type' => 'select', + 'class' => 'js_field-country select short', + 'options' => array( '' => __( 'Select a country…', 'woocommerce' ) ) + WC()->countries->get_shipping_countries(), + ), + 'state' => array( + 'label' => __( 'State / County', 'woocommerce' ), + 'class' => 'js_field-state select short', + 'show' => false, + ), + ) + ); } /** @@ -164,96 +168,129 @@ class WC_Meta_Box_Order_Data {
        -
        +
        +

        + labels->singular_name, - $order->get_order_number() + esc_html( $order_type_object->labels->singular_name ), + esc_html( $order->get_order_number() ) ); - ?>

        -

        + +

        + get_title() ) : esc_html( $payment_method ) ) + esc_html( isset( $payment_gateways[ $payment_method ] ) ? $payment_gateways[ $payment_method ]->get_title() : $payment_method ) ); if ( $transaction_id = $order->get_transaction_id() ) { - if ( isset( $payment_gateways[ $payment_method ] ) && ( $url = $payment_gateways[ $payment_method ]->get_transaction_url( $order ) ) ) { - echo ' (' . esc_html( $transaction_id ) . ')'; + if ( isset( $payment_gateways[ $payment_method ] ) && ( $url = $payment_gateways[ $payment_method ]->get_transaction_url( $order ) ) ) { + $payment_method_string .= ' (' . esc_html( $transaction_id ) . ')'; } else { - echo ' (' . esc_html( $transaction_id ) . ')'; + $payment_method_string .= ' (' . esc_html( $transaction_id ) . ')'; } } - if ( $order->get_date_paid() ) { - /* translators: 1: date 2: time */ - printf( ' ' . __( 'on %1$s @ %2$s', 'woocommerce' ), wc_format_datetime( $order->get_date_paid() ), wc_format_datetime( $order->get_date_paid(), get_option( 'time_format' ) ) ); - } + $meta_list[] = $payment_method_string; + } - echo '. '; + if ( $order->get_date_paid() ) { + /* translators: 1: date 2: time */ + $meta_list[] = sprintf( + __( 'Paid on %1$s @ %2$s', 'woocommerce' ), + wc_format_datetime( $order->get_date_paid() ), + wc_format_datetime( $order->get_date_paid(), get_option( 'time_format' ) ) + ); } if ( $ip_address = $order->get_customer_ip_address() ) { /* translators: %s: IP address */ - printf( + $meta_list[] = sprintf( __( 'Customer IP: %s', 'woocommerce' ), '' . esc_html( $ip_address ) . '' ); } - ?>

        + echo wp_kses_post( implode( '. ', $meta_list ) ); + + ?> +

        -

        +

        -

        - @‎:‎ +

        + + @ + ‎ + : + +

        -

        - + $status_name ) { echo ''; } - ?> -

        + ?> + +

        - + ?> + get_user_id() ) { - $user_id = absint( $order->get_user_id() ); - $user = get_user_by( 'id', $user_id ); + $user_id = absint( $order->get_user_id() ); + $user = get_user_by( 'id', $user_id ); /* translators: 1: user display name 2: user ID 3: user email */ $user_string = sprintf( esc_html__( '%1$s (#%2$s – %3$s)', 'woocommerce' ), @@ -272,49 +309,54 @@ class WC_Meta_Box_Order_Data {

        - - + + - +

        - '; +
        + get_formatted_billing_address() ) { - echo '

        ' . __( 'Address:', 'woocommerce' ) . '' . wp_kses( $order->get_formatted_billing_address(), array( 'br' => array() ) ) . '

        '; - } else { - echo '

        ' . __( 'Address:', 'woocommerce' ) . ' ' . __( 'No billing address set.', 'woocommerce' ) . '

        '; + // Display values. + if ( $order->get_formatted_billing_address() ) { + echo '

        ' . wp_kses( $order->get_formatted_billing_address(), array( 'br' => array() ) ) . '

        '; + } else { + echo '

        ' . __( 'Address:', 'woocommerce' ) . ' ' . __( 'No billing address set.', 'woocommerce' ) . '

        '; + } + + foreach ( self::$billing_fields as $key => $field ) { + if ( isset( $field['show'] ) && false === $field['show'] ) { + continue; } - foreach ( self::$billing_fields as $key => $field ) { - if ( isset( $field['show'] ) && false === $field['show'] ) { - continue; - } + $field_name = 'billing_' . $key; - $field_name = 'billing_' . $key; + if ( isset( $field['value'] ) ) { + $field_value = $field['value']; + } elseif ( is_callable( array( $order, 'get_' . $field_name ) ) ) { + $field_value = $order->{"get_$field_name"}( 'edit' ); + } else { + $field_value = $order->get_meta( '_' . $field_name ); + } - if ( is_callable( array( $order, 'get_' . $field_name ) ) ) { - $field_value = $order->{"get_$field_name"}( 'edit' ); - } else { - $field_value = $order->get_meta( '_' . $field_name ); - } - - if ( 'billing_phone' === $field_name ) { - $field_value = wc_make_phone_clickable( $field_value ); - } else { - $field_value = make_clickable( esc_html( $field_value ) ); - } + if ( 'billing_phone' === $field_name ) { + $field_value = wc_make_phone_clickable( $field_value ); + } else { + $field_value = make_clickable( esc_html( $field_value ) ); + } + if ( $field_value ) { echo '

        ' . esc_html( $field['label'] ) . ': ' . wp_kses_post( $field_value ) . '

        '; } + } + ?> +
        - echo '
        '; - - // Display form - echo '
        '; +
        + $field ) { if ( ! isset( $field['type'] ) ) { $field['type'] = 'text'; @@ -322,96 +364,113 @@ class WC_Meta_Box_Order_Data { if ( ! isset( $field['id'] ) ) { $field['id'] = '_billing_' . $key; } + + $field_name = 'billing_' . $key; + + if ( ! isset( $field['value'] ) ) { + if ( is_callable( array( $order, 'get_' . $field_name ) ) ) { + $field['value'] = $order->{"get_$field_name"}( 'edit' ); + } else { + $field['value'] = $order->get_meta( '_' . $field_name ); + } + } + switch ( $field['type'] ) { - case 'select' : + case 'select': woocommerce_wp_select( $field ); - break; - default : + break; + default: woocommerce_wp_text_input( $field ); - break; + break; } } ?>

        - +

        '_transaction_id', 'label' => __( 'Transaction ID', 'woocommerce' ) ) ); + woocommerce_wp_text_input( + array( + 'id' => '_transaction_id', + 'label' => __( 'Transaction ID', 'woocommerce' ), + 'value' => $order->get_transaction_id( 'edit' ), + ) + ); + ?> - echo '
        '; - - do_action( 'woocommerce_admin_order_data_after_billing_address', $order ); - ?> +
        +
        -

        - - + + - - + +

        - '; +
        + get_formatted_shipping_address() ) { - echo '

        ' . __( 'Address:', 'woocommerce' ) . '' . wp_kses( $order->get_formatted_shipping_address(), array( 'br' => array() ) ) . '

        '; - } else { - echo '

        ' . __( 'Address:', 'woocommerce' ) . ' ' . __( 'No shipping address set.', 'woocommerce' ) . '

        '; - } + // Display values. + if ( $order->get_formatted_shipping_address() ) { + echo '

        ' . wp_kses( $order->get_formatted_shipping_address(), array( 'br' => array() ) ) . '

        '; + } else { + echo '

        ' . __( 'Address:', 'woocommerce' ) . ' ' . __( 'No shipping address set.', 'woocommerce' ) . '

        '; + } - if ( ! empty( self::$shipping_fields ) ) { - foreach ( self::$shipping_fields as $key => $field ) { - if ( isset( $field['show'] ) && false === $field['show'] ) { - continue; - } + if ( ! empty( self::$shipping_fields ) ) { + foreach ( self::$shipping_fields as $key => $field ) { + if ( isset( $field['show'] ) && false === $field['show'] ) { + continue; + } - $field_name = 'shipping_' . $key; + $field_name = 'shipping_' . $key; - if ( is_callable( array( $order, 'get_' . $field_name ) ) ) { - $field_value = $order->{"get_$field_name"}( 'edit' ); - } else { - $field_value = $order->get_meta( '_' . $field_name ); - } + if ( is_callable( array( $order, 'get_' . $field_name ) ) ) { + $field_value = $order->{"get_$field_name"}( 'edit' ); + } else { + $field_value = $order->get_meta( '_' . $field_name ); + } - echo '

        ' . esc_html( $field['label'] ) . ': ' . make_clickable( esc_html( $field_value ) ) . '

        '; + if ( $field_value ) { + echo '

        ' . esc_html( $field['label'] ) . ': ' . wp_kses_post( $field_value ) . '

        '; } } + } - if ( apply_filters( 'woocommerce_enable_order_notes_field', 'yes' == get_option( 'woocommerce_enable_order_comments', 'yes' ) ) && $post->post_excerpt ) { - echo '

        ' . __( 'Customer provided note:', 'woocommerce' ) . ' ' . nl2br( esc_html( $post->post_excerpt ) ) . '

        '; - } - - echo '
        '; - - // Display form - echo '
        '; + if ( apply_filters( 'woocommerce_enable_order_notes_field', 'yes' == get_option( 'woocommerce_enable_order_comments', 'yes' ) ) && $post->post_excerpt ) { + echo '

        ' . __( 'Customer provided note:', 'woocommerce' ) . ' ' . nl2br( esc_html( $post->post_excerpt ) ) . '

        '; + } + ?> +
        +
        + $field ) { if ( ! isset( $field['type'] ) ) { @@ -421,28 +480,35 @@ class WC_Meta_Box_Order_Data { $field['id'] = '_shipping_' . $key; } + $field_name = 'shipping_' . $key; + + if ( is_callable( array( $order, 'get_' . $field_name ) ) ) { + $field['value'] = $order->{"get_$field_name"}( 'edit' ); + } else { + $field['value'] = $order->get_meta( '_' . $field_name ); + } + switch ( $field['type'] ) { - case 'select' : + case 'select': woocommerce_wp_select( $field ); - break; - default : + break; + default: woocommerce_wp_text_input( $field ); - break; + break; } } } - if ( apply_filters( 'woocommerce_enable_order_notes_field', 'yes' == get_option( 'woocommerce_enable_order_comments', 'yes' ) ) ) { + if ( apply_filters( 'woocommerce_enable_order_notes_field', 'yes' == get_option( 'woocommerce_enable_order_comments', 'yes' ) ) ) : ?> -

        -

        - + + +

        + +
        - echo '
        '; - - do_action( 'woocommerce_admin_order_data_after_shipping_address', $order ); - ?> +
        @@ -530,7 +596,7 @@ class WC_Meta_Box_Order_Data { $payment_method_title = $methods[ $payment_method ]->get_title(); } - $props['payment_method'] = $payment_method; + $props['payment_method'] = $payment_method; $props['payment_method_title'] = $payment_method_title; } @@ -538,11 +604,16 @@ class WC_Meta_Box_Order_Data { if ( empty( $_POST['order_date'] ) ) { $date = current_time( 'timestamp', true ); } else { - $date = gmdate( 'Y-m-d H:i:s', strtotime( $_POST['order_date'] . ' ' . (int) $_POST['order_date_hour'] . ':' . (int) $_POST['order_date_minute'] . ':00' ) ); + $date = gmdate( 'Y-m-d H:i:s', strtotime( $_POST['order_date'] . ' ' . (int) $_POST['order_date_hour'] . ':' . (int) $_POST['order_date_minute'] . ':' . (int) $_POST['order_date_second'] ) ); } $props['date_created'] = $date; + // Set created via prop if new post. + if ( isset( $_POST['original_post_status'] ) && $_POST['original_post_status'] === 'auto-draft' ) { + $props['created_via'] = 'admin'; + } + // Save order data. $order->set_props( $props ); $order->set_status( wc_clean( $_POST['order_status'] ), '', true ); diff --git a/includes/admin/meta-boxes/class-wc-meta-box-order-downloads.php b/includes/admin/meta-boxes/class-wc-meta-box-order-downloads.php index 062fe512cad..897842500c0 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-order-downloads.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-order-downloads.php @@ -26,12 +26,15 @@ class WC_Meta_Box_Order_Downloads { ?>
        -
        get_downloads( array( - 'order_id' => $post->ID, - 'orderby' => 'product_id', - ) ); +
        + get_downloads( + array( + 'order_id' => $post->ID, + 'orderby' => 'product_id', + ) + ); $product = null; $loop = 0; @@ -44,27 +47,30 @@ class WC_Meta_Box_Order_Downloads { $file_counter = 1; } - // don't show permissions to files that have since been removed + // don't show permissions to files that have since been removed. if ( ! $product || ! $product->exists() || ! $product->has_file( $download->get_download_id() ) ) { continue; } - // Show file title instead of count if set + // Show file title instead of count if set. $file = $product->get_file( $download->get_download_id() ); $file_count = isset( $file['name'] ) ? $file['name'] : sprintf( __( 'File %d', 'woocommerce' ), $file_counter ); - include( 'views/html-order-download-permission.php' ); + include 'views/html-order-download-permission.php'; $loop++; $file_counter++; } } - ?>
        + ?> +

        - +

        @@ -76,7 +82,7 @@ class WC_Meta_Box_Order_Downloads { /** * Save meta box data. * - * @param int $post_id + * @param int $post_id * @param WP_Post $post */ public static function save( $post_id, $post ) { diff --git a/includes/admin/meta-boxes/class-wc-meta-box-order-items.php b/includes/admin/meta-boxes/class-wc-meta-box-order-items.php index 5303d209d96..a70bea86889 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-order-items.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-order-items.php @@ -38,16 +38,19 @@ class WC_Meta_Box_Order_Items { $order = $theorder; $data = get_post_meta( $post->ID ); - include( 'views/html-order-items.php' ); + include 'views/html-order-items.php'; } /** * Save meta box data. * * @param int $post_id - * @param WP_Post $post */ - public static function save( $post_id, $post ) { + public static function save( $post_id ) { + /** + * This $_POST variable's data has been validated and escaped + * inside `wc_save_order_items()` function. + */ wc_save_order_items( $post_id, $_POST ); } } diff --git a/includes/admin/meta-boxes/class-wc-meta-box-order-notes.php b/includes/admin/meta-boxes/class-wc-meta-box-order-notes.php index 4e269154c55..d3c62f85a56 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-order-notes.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-order-notes.php @@ -26,18 +26,10 @@ class WC_Meta_Box_Order_Notes { global $post; $args = array( - 'post_id' => $post->ID, - 'orderby' => 'comment_ID', - 'order' => 'DESC', - 'approve' => 'approve', - 'type' => 'order_note', + 'order_id' => $post->ID, ); - remove_filter( 'comments_clauses', array( 'WC_Comments', 'exclude_order_comments' ), 10, 1 ); - - $notes = get_comments( $args ); - - add_filter( 'comments_clauses', array( 'WC_Comments', 'exclude_order_comments' ), 10, 1 ); + $notes = wc_get_order_notes( $args ); echo '
          '; @@ -46,20 +38,20 @@ class WC_Meta_Box_Order_Notes { foreach ( $notes as $note ) { $note_classes = array( 'note' ); - $note_classes[] = get_comment_meta( $note->comment_ID, 'is_customer_note', true ) ? 'customer-note' : ''; - $note_classes[] = ( __( 'WooCommerce', 'woocommerce' ) === $note->comment_author ) ? 'system-note' : ''; + $note_classes[] = $note->customer_note ? 'customer-note' : ''; + $note_classes[] = 'system' === $note->added_by ? 'system-note' : ''; $note_classes = apply_filters( 'woocommerce_order_note_class', array_filter( $note_classes ), $note ); ?> -
        • +
        • - comment_content ) ) ); ?> + content ) ) ); ?>

          - comment_date ) ), date_i18n( wc_time_format(), strtotime( $note->comment_date ) ) ); ?> + date_created->date_i18n( wc_date_format() ), $note->date_created->date_i18n( wc_time_format() ) ); ?> comment_author ) : + if ( 'system' !== $note->added_by ) : /* translators: %s: note author */ - printf( ' ' . __( 'by %s', 'woocommerce' ), $note->comment_author ); + printf( ' ' . __( 'by %s', 'woocommerce' ), $note->added_by ); endif; ?> diff --git a/includes/admin/meta-boxes/class-wc-meta-box-product-data.php b/includes/admin/meta-boxes/class-wc-meta-box-product-data.php index d49517932d4..1219d40fcd6 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-product-data.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-product-data.php @@ -28,9 +28,11 @@ class WC_Meta_Box_Product_Data { global $thepostid, $product_object; $thepostid = $post->ID; - $product_object = $thepostid ? wc_get_product( $thepostid ) : new WC_Product; + $product_object = $thepostid ? wc_get_product( $thepostid ) : new WC_Product(); - include( 'views/html-product-data-panel.php' ); + wp_nonce_field( 'woocommerce_save_data', 'woocommerce_meta_nonce' ); + + include 'views/html-product-data-panel.php'; } /** @@ -39,86 +41,92 @@ class WC_Meta_Box_Product_Data { private static function output_tabs() { global $post, $thepostid, $product_object; - include( 'views/html-product-data-general.php' ); - include( 'views/html-product-data-inventory.php' ); - include( 'views/html-product-data-shipping.php' ); - include( 'views/html-product-data-linked-products.php' ); - include( 'views/html-product-data-attributes.php' ); - include( 'views/html-product-data-advanced.php' ); + include 'views/html-product-data-general.php'; + include 'views/html-product-data-inventory.php'; + include 'views/html-product-data-shipping.php'; + include 'views/html-product-data-linked-products.php'; + include 'views/html-product-data-attributes.php'; + include 'views/html-product-data-advanced.php'; } /** * Return array of product type options. + * * @return array */ private static function get_product_type_options() { - return apply_filters( 'product_type_options', array( - 'virtual' => array( - 'id' => '_virtual', - 'wrapper_class' => 'show_if_simple', - 'label' => __( 'Virtual', 'woocommerce' ), - 'description' => __( 'Virtual products are intangible and are not shipped.', 'woocommerce' ), - 'default' => 'no', - ), - 'downloadable' => array( - 'id' => '_downloadable', - 'wrapper_class' => 'show_if_simple', - 'label' => __( 'Downloadable', 'woocommerce' ), - 'description' => __( 'Downloadable products give access to a file upon purchase.', 'woocommerce' ), - 'default' => 'no', - ), - ) ); + return apply_filters( + 'product_type_options', array( + 'virtual' => array( + 'id' => '_virtual', + 'wrapper_class' => 'show_if_simple', + 'label' => __( 'Virtual', 'woocommerce' ), + 'description' => __( 'Virtual products are intangible and are not shipped.', 'woocommerce' ), + 'default' => 'no', + ), + 'downloadable' => array( + 'id' => '_downloadable', + 'wrapper_class' => 'show_if_simple', + 'label' => __( 'Downloadable', 'woocommerce' ), + 'description' => __( 'Downloadable products give access to a file upon purchase.', 'woocommerce' ), + 'default' => 'no', + ), + ) + ); } /** * Return array of tabs to show. + * * @return array */ private static function get_product_data_tabs() { - $tabs = apply_filters( 'woocommerce_product_data_tabs', array( - 'general' => array( - 'label' => __( 'General', 'woocommerce' ), - 'target' => 'general_product_data', - 'class' => array( 'hide_if_grouped' ), - 'priority' => 10, - ), - 'inventory' => array( - 'label' => __( 'Inventory', 'woocommerce' ), - 'target' => 'inventory_product_data', - 'class' => array( 'show_if_simple', 'show_if_variable', 'show_if_grouped', 'show_if_external' ), - 'priority' => 20, - ), - 'shipping' => array( - 'label' => __( 'Shipping', 'woocommerce' ), - 'target' => 'shipping_product_data', - 'class' => array( 'hide_if_virtual', 'hide_if_grouped', 'hide_if_external' ), - 'priority' => 30, - ), - 'linked_product' => array( - 'label' => __( 'Linked Products', 'woocommerce' ), - 'target' => 'linked_product_data', - 'class' => array(), - 'priority' => 40, - ), - 'attribute' => array( - 'label' => __( 'Attributes', 'woocommerce' ), - 'target' => 'product_attributes', - 'class' => array(), - 'priority' => 50, - ), - 'variations' => array( - 'label' => __( 'Variations', 'woocommerce' ), - 'target' => 'variable_product_options', - 'class' => array( 'variations_tab', 'show_if_variable' ), - 'priority' => 60, - ), - 'advanced' => array( - 'label' => __( 'Advanced', 'woocommerce' ), - 'target' => 'advanced_product_data', - 'class' => array(), - 'priority' => 70, - ), - ) ); + $tabs = apply_filters( + 'woocommerce_product_data_tabs', array( + 'general' => array( + 'label' => __( 'General', 'woocommerce' ), + 'target' => 'general_product_data', + 'class' => array( 'hide_if_grouped' ), + 'priority' => 10, + ), + 'inventory' => array( + 'label' => __( 'Inventory', 'woocommerce' ), + 'target' => 'inventory_product_data', + 'class' => array( 'show_if_simple', 'show_if_variable', 'show_if_grouped', 'show_if_external' ), + 'priority' => 20, + ), + 'shipping' => array( + 'label' => __( 'Shipping', 'woocommerce' ), + 'target' => 'shipping_product_data', + 'class' => array( 'hide_if_virtual', 'hide_if_grouped', 'hide_if_external' ), + 'priority' => 30, + ), + 'linked_product' => array( + 'label' => __( 'Linked Products', 'woocommerce' ), + 'target' => 'linked_product_data', + 'class' => array(), + 'priority' => 40, + ), + 'attribute' => array( + 'label' => __( 'Attributes', 'woocommerce' ), + 'target' => 'product_attributes', + 'class' => array(), + 'priority' => 50, + ), + 'variations' => array( + 'label' => __( 'Variations', 'woocommerce' ), + 'target' => 'variable_product_options', + 'class' => array( 'variations_tab', 'show_if_variable' ), + 'priority' => 60, + ), + 'advanced' => array( + 'label' => __( 'Advanced', 'woocommerce' ), + 'target' => 'advanced_product_data', + 'class' => array(), + 'priority' => 70, + ), + ) + ); // Sort tabs based on priority. uasort( $tabs, array( __CLASS__, 'product_data_tabs_sort' ) ); @@ -149,6 +157,7 @@ class WC_Meta_Box_Product_Data { /** * Filter callback for finding variation attributes. + * * @param WC_Product_Attribute $attribute * @return bool */ @@ -164,11 +173,11 @@ class WC_Meta_Box_Product_Data { $variation_attributes = array_filter( $product_object->get_attributes(), array( __CLASS__, 'filter_variation_attributes' ) ); $default_attributes = $product_object->get_default_attributes(); - $variations_count = absint( $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(ID) FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'product_variation' AND post_status IN ('publish', 'private')", $post->ID ) ) ); + $variations_count = absint( apply_filters( 'woocommerce_admin_meta_boxes_variations_count', $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(ID) FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'product_variation' AND post_status IN ('publish', 'private')", $post->ID ) ), $post->ID ) ); $variations_per_page = absint( apply_filters( 'woocommerce_admin_meta_boxes_variations_per_page', 15 ) ); $variations_total_pages = ceil( $variations_count / $variations_per_page ); - include( 'views/html-product-data-variations.php' ); + include 'views/html-product-data-variations.php'; } /** @@ -189,9 +198,9 @@ class WC_Meta_Box_Product_Data { for ( $i = 0; $i < $file_url_size; $i ++ ) { if ( ! empty( $file_urls[ $i ] ) ) { $downloads[] = array( - 'name' => wc_clean( $file_names[ $i ] ), - 'file' => wp_unslash( trim( $file_urls[ $i ] ) ), - 'previous_hash' => wc_clean( $file_hashes[ $i ] ), + 'name' => wc_clean( $file_names[ $i ] ), + 'file' => wp_unslash( trim( $file_urls[ $i ] ) ), + 'download_id' => wc_clean( $file_hashes[ $i ] ), ); } } @@ -201,6 +210,7 @@ class WC_Meta_Box_Product_Data { /** * Prepare children for save. + * * @return array */ private static function prepare_children() { @@ -262,7 +272,7 @@ class WC_Meta_Box_Product_Data { $attribute->set_position( $attribute_position[ $i ] ); $attribute->set_visible( isset( $attribute_visibility[ $i ] ) ); $attribute->set_variation( isset( $attribute_variation[ $i ] ) ); - $attributes[] = $attribute; + $attributes[] = apply_filters( 'woocommerce_admin_meta_boxes_prepare_attribute', $attribute, $data, $i ); } } return $attributes; @@ -270,9 +280,10 @@ class WC_Meta_Box_Product_Data { /** * Prepare attributes for a specific variation or defaults. - * @param array $all_attributes + * + * @param array $all_attributes * @param string $key_prefix - * @param int $index + * @param int $index * @return array */ private static function prepare_set_attributes( $all_attributes, $key_prefix = 'attribute_', $index = null ) { @@ -284,12 +295,18 @@ class WC_Meta_Box_Product_Data { $attribute_key = sanitize_title( $attribute->get_name() ); if ( ! is_null( $index ) ) { - $value = isset( $_POST[ $key_prefix . $attribute_key ][ $index ] ) ? stripslashes( $_POST[ $key_prefix . $attribute_key ][ $index ] ) : ''; + $value = isset( $_POST[ $key_prefix . $attribute_key ][ $index ] ) ? wp_unslash( $_POST[ $key_prefix . $attribute_key ][ $index ] ) : ''; } else { - $value = isset( $_POST[ $key_prefix . $attribute_key ] ) ? stripslashes( $_POST[ $key_prefix . $attribute_key ] ) : ''; + $value = isset( $_POST[ $key_prefix . $attribute_key ] ) ? wp_unslash( $_POST[ $key_prefix . $attribute_key ] ) : ''; + } + + if ( $attribute->is_taxonomy() ) { + // Don't use wc_clean as it destroys sanitized characters. + $value = sanitize_title( $value ); + } else { + $value = html_entity_decode( wc_clean( $value ), ENT_QUOTES, get_bloginfo( 'charset' ) ); // WPCS: sanitization ok. } - $value = $attribute->is_taxonomy() ? sanitize_title( $value ) : wc_clean( $value ); // Don't use wc_clean as it destroys sanitized characters in terms. $attributes[ $attribute_key ] = $value; } } @@ -301,7 +318,7 @@ class WC_Meta_Box_Product_Data { /** * Save meta box data. * - * @param int $post_id + * @param int $post_id * @param $post */ public static function save( $post_id, $post ) { @@ -318,49 +335,52 @@ class WC_Meta_Box_Product_Data { /* translators: 1: product ID 2: quantity in stock */ WC_Admin_Meta_Boxes::add_error( sprintf( __( 'The stock has not been updated because the value has changed since editing. Product %1$d has %2$d units in stock.', 'woocommerce' ), $product->get_id(), $product->get_stock_quantity( 'edit' ) ) ); } else { - $stock = wc_stock_amount( $_POST['_stock'] ); + $stock = wc_stock_amount( wp_unslash( $_POST['_stock'] ) ); } } - $errors = $product->set_props( array( - 'sku' => isset( $_POST['_sku'] ) ? wc_clean( $_POST['_sku'] ) : null, - 'purchase_note' => wp_kses_post( stripslashes( $_POST['_purchase_note'] ) ), - 'downloadable' => isset( $_POST['_downloadable'] ), - 'virtual' => isset( $_POST['_virtual'] ), - 'featured' => isset( $_POST['_featured'] ), - 'catalog_visibility' => wc_clean( $_POST['_visibility'] ), - 'tax_status' => isset( $_POST['_tax_status'] ) ? wc_clean( $_POST['_tax_status'] ) : null, - 'tax_class' => isset( $_POST['_tax_class'] ) ? wc_clean( $_POST['_tax_class'] ) : null, - 'weight' => wc_clean( $_POST['_weight'] ), - 'length' => wc_clean( $_POST['_length'] ), - 'width' => wc_clean( $_POST['_width'] ), - 'height' => wc_clean( $_POST['_height'] ), - 'shipping_class_id' => absint( $_POST['product_shipping_class'] ), - 'sold_individually' => ! empty( $_POST['_sold_individually'] ), - 'upsell_ids' => isset( $_POST['upsell_ids'] ) ? array_map( 'intval', (array) $_POST['upsell_ids'] ) : array(), - 'cross_sell_ids' => isset( $_POST['crosssell_ids'] ) ? array_map( 'intval', (array) $_POST['crosssell_ids'] ) : array(), - 'regular_price' => wc_clean( $_POST['_regular_price'] ), - 'sale_price' => wc_clean( $_POST['_sale_price'] ), - 'date_on_sale_from' => wc_clean( $_POST['_sale_price_dates_from'] ), - 'date_on_sale_to' => wc_clean( $_POST['_sale_price_dates_to'] ), - 'manage_stock' => ! empty( $_POST['_manage_stock'] ), - 'backorders' => isset( $_POST['_backorders'] ) ? wc_clean( $_POST['_backorders'] ) : null, - 'stock_status' => wc_clean( $_POST['_stock_status'] ), - 'stock_quantity' => $stock, - 'download_limit' => '' === $_POST['_download_limit'] ? '' : absint( $_POST['_download_limit'] ), - 'download_expiry' => '' === $_POST['_download_expiry'] ? '' : absint( $_POST['_download_expiry'] ), - 'downloads' => self::prepare_downloads( - isset( $_POST['_wc_file_names'] ) ? $_POST['_wc_file_names'] : array(), - isset( $_POST['_wc_file_urls'] ) ? $_POST['_wc_file_urls'] : array(), - isset( $_POST['_wc_file_hashes'] ) ? $_POST['_wc_file_hashes'] : array() - ), - 'product_url' => esc_url_raw( $_POST['_product_url'] ), - 'button_text' => wc_clean( $_POST['_button_text'] ), - 'children' => 'grouped' === $product_type ? self::prepare_children() : null, - 'reviews_allowed' => ! empty( $_POST['_reviews_allowed'] ), - 'attributes' => $attributes, - 'default_attributes' => self::prepare_set_attributes( $attributes, 'default_attribute_' ), - ) ); + $errors = $product->set_props( + array( + 'sku' => isset( $_POST['_sku'] ) ? wc_clean( wp_unslash( $_POST['_sku'] ) ) : null, + 'purchase_note' => wp_kses_post( wp_unslash( $_POST['_purchase_note'] ) ), + 'downloadable' => isset( $_POST['_downloadable'] ), + 'virtual' => isset( $_POST['_virtual'] ), + 'featured' => isset( $_POST['_featured'] ), + 'catalog_visibility' => wc_clean( wp_unslash( $_POST['_visibility'] ) ), + 'tax_status' => isset( $_POST['_tax_status'] ) ? wc_clean( wp_unslash( $_POST['_tax_status'] ) ) : null, + 'tax_class' => isset( $_POST['_tax_class'] ) ? wc_clean( wp_unslash( $_POST['_tax_class'] ) ) : null, + 'weight' => wc_clean( wp_unslash( $_POST['_weight'] ) ), + 'length' => wc_clean( wp_unslash( $_POST['_length'] ) ), + 'width' => wc_clean( wp_unslash( $_POST['_width'] ) ), + 'height' => wc_clean( wp_unslash( $_POST['_height'] ) ), + 'shipping_class_id' => absint( wp_unslash( $_POST['product_shipping_class'] ) ), + 'sold_individually' => ! empty( $_POST['_sold_individually'] ), + 'upsell_ids' => isset( $_POST['upsell_ids'] ) ? array_map( 'intval', (array) wp_unslash( $_POST['upsell_ids'] ) ) : array(), + 'cross_sell_ids' => isset( $_POST['crosssell_ids'] ) ? array_map( 'intval', (array) wp_unslash( $_POST['crosssell_ids'] ) ) : array(), + 'regular_price' => wc_clean( wp_unslash( $_POST['_regular_price'] ) ), + 'sale_price' => wc_clean( wp_unslash( $_POST['_sale_price'] ) ), + 'date_on_sale_from' => wc_clean( wp_unslash( $_POST['_sale_price_dates_from'] ) ), + 'date_on_sale_to' => wc_clean( wp_unslash( $_POST['_sale_price_dates_to'] ) ), + 'manage_stock' => ! empty( $_POST['_manage_stock'] ), + 'backorders' => isset( $_POST['_backorders'] ) ? wc_clean( wp_unslash( $_POST['_backorders'] ) ) : null, + 'stock_status' => wc_clean( wp_unslash( $_POST['_stock_status'] ) ), + 'stock_quantity' => $stock, + 'low_stock_amount' => wc_stock_amount( wp_unslash( $_POST['_low_stock_amount'] ) ), + 'download_limit' => '' === $_POST['_download_limit'] ? '' : absint( wp_unslash( $_POST['_download_limit'] ) ), + 'download_expiry' => '' === $_POST['_download_expiry'] ? '' : absint( wp_unslash( $_POST['_download_expiry'] ) ), + 'downloads' => self::prepare_downloads( + isset( $_POST['_wc_file_names'] ) ? wp_unslash( $_POST['_wc_file_names'] ) : array(), + isset( $_POST['_wc_file_urls'] ) ? wp_unslash( $_POST['_wc_file_urls'] ) : array(), + isset( $_POST['_wc_file_hashes'] ) ? wp_unslash( $_POST['_wc_file_hashes'] ) : array() + ), + 'product_url' => esc_url_raw( wp_unslash( $_POST['_product_url'] ) ), + 'button_text' => wc_clean( wp_unslash( $_POST['_button_text'] ) ), + 'children' => 'grouped' === $product_type ? self::prepare_children() : null, + 'reviews_allowed' => ! empty( $_POST['comment_status'] ) && 'open' === $_POST['comment_status'], + 'attributes' => $attributes, + 'default_attributes' => self::prepare_set_attributes( $attributes, 'default_attribute_' ), + ) + ); if ( is_wp_error( $errors ) ) { WC_Admin_Meta_Boxes::add_error( $errors->get_error_message() ); @@ -383,12 +403,12 @@ class WC_Meta_Box_Product_Data { /** * Save meta box data. * - * @param int $post_id + * @param int $post_id * @param WP_Post $post */ public static function save_variations( $post_id, $post ) { if ( isset( $_POST['variable_post_id'] ) ) { - $parent = wc_get_product( $post_id ); + $parent = wc_get_product( $post_id ); $parent->set_default_attributes( self::prepare_set_attributes( $parent->get_attributes(), 'default_attribute_' ) ); $parent->save(); @@ -415,37 +435,39 @@ class WC_Meta_Box_Product_Data { } } - $errors = $variation->set_props( array( - 'status' => isset( $_POST['variable_enabled'][ $i ] ) ? 'publish' : 'private', - 'menu_order' => wc_clean( $_POST['variation_menu_order'][ $i ] ), - 'regular_price' => wc_clean( $_POST['variable_regular_price'][ $i ] ), - 'sale_price' => wc_clean( $_POST['variable_sale_price'][ $i ] ), - 'virtual' => isset( $_POST['variable_is_virtual'][ $i ] ), - 'downloadable' => isset( $_POST['variable_is_downloadable'][ $i ] ), - 'date_on_sale_from' => wc_clean( $_POST['variable_sale_price_dates_from'][ $i ] ), - 'date_on_sale_to' => wc_clean( $_POST['variable_sale_price_dates_to'][ $i ] ), - 'description' => wp_kses_post( $_POST['variable_description'][ $i ] ), - 'download_limit' => wc_clean( $_POST['variable_download_limit'][ $i ] ), - 'download_expiry' => wc_clean( $_POST['variable_download_expiry'][ $i ] ), - 'downloads' => self::prepare_downloads( - isset( $_POST['_wc_variation_file_names'][ $variation_id ] ) ? $_POST['_wc_variation_file_names'][ $variation_id ] : array(), - isset( $_POST['_wc_variation_file_urls'][ $variation_id ] ) ? $_POST['_wc_variation_file_urls'][ $variation_id ] : array(), - isset( $_POST['_wc_variation_file_hashes'][ $variation_id ] ) ? $_POST['_wc_variation_file_hashes'][ $variation_id ] : array() - ), - 'manage_stock' => isset( $_POST['variable_manage_stock'][ $i ] ), - 'stock_quantity' => $stock, - 'backorders' => isset( $_POST['variable_backorders'], $_POST['variable_backorders'][ $i ] ) ? wc_clean( $_POST['variable_backorders'][ $i ] ) : null, - 'stock_status' => wc_clean( $_POST['variable_stock_status'][ $i ] ), - 'image_id' => wc_clean( $_POST['upload_image_id'][ $i ] ), - 'attributes' => self::prepare_set_attributes( $parent->get_attributes(), 'attribute_', $i ), - 'sku' => isset( $_POST['variable_sku'][ $i ] ) ? wc_clean( $_POST['variable_sku'][ $i ] ) : '', - 'weight' => isset( $_POST['variable_weight'][ $i ] ) ? wc_clean( $_POST['variable_weight'][ $i ] ) : '', - 'length' => isset( $_POST['variable_length'][ $i ] ) ? wc_clean( $_POST['variable_length'][ $i ] ) : '', - 'width' => isset( $_POST['variable_width'][ $i ] ) ? wc_clean( $_POST['variable_width'][ $i ] ) : '', - 'height' => isset( $_POST['variable_height'][ $i ] ) ? wc_clean( $_POST['variable_height'][ $i ] ) : '', - 'shipping_class_id' => wc_clean( $_POST['variable_shipping_class'][ $i ] ), - 'tax_class' => isset( $_POST['variable_tax_class'][ $i ] ) ? wc_clean( $_POST['variable_tax_class'][ $i ] ) : null, - ) ); + $errors = $variation->set_props( + array( + 'status' => isset( $_POST['variable_enabled'][ $i ] ) ? 'publish' : 'private', + 'menu_order' => wc_clean( $_POST['variation_menu_order'][ $i ] ), + 'regular_price' => wc_clean( $_POST['variable_regular_price'][ $i ] ), + 'sale_price' => wc_clean( $_POST['variable_sale_price'][ $i ] ), + 'virtual' => isset( $_POST['variable_is_virtual'][ $i ] ), + 'downloadable' => isset( $_POST['variable_is_downloadable'][ $i ] ), + 'date_on_sale_from' => wc_clean( $_POST['variable_sale_price_dates_from'][ $i ] ), + 'date_on_sale_to' => wc_clean( $_POST['variable_sale_price_dates_to'][ $i ] ), + 'description' => wp_kses_post( $_POST['variable_description'][ $i ] ), + 'download_limit' => wc_clean( $_POST['variable_download_limit'][ $i ] ), + 'download_expiry' => wc_clean( $_POST['variable_download_expiry'][ $i ] ), + 'downloads' => self::prepare_downloads( + isset( $_POST['_wc_variation_file_names'][ $variation_id ] ) ? $_POST['_wc_variation_file_names'][ $variation_id ] : array(), + isset( $_POST['_wc_variation_file_urls'][ $variation_id ] ) ? $_POST['_wc_variation_file_urls'][ $variation_id ] : array(), + isset( $_POST['_wc_variation_file_hashes'][ $variation_id ] ) ? $_POST['_wc_variation_file_hashes'][ $variation_id ] : array() + ), + 'manage_stock' => isset( $_POST['variable_manage_stock'][ $i ] ), + 'stock_quantity' => $stock, + 'backorders' => isset( $_POST['variable_backorders'], $_POST['variable_backorders'][ $i ] ) ? wc_clean( $_POST['variable_backorders'][ $i ] ) : null, + 'stock_status' => wc_clean( $_POST['variable_stock_status'][ $i ] ), + 'image_id' => wc_clean( $_POST['upload_image_id'][ $i ] ), + 'attributes' => self::prepare_set_attributes( $parent->get_attributes(), 'attribute_', $i ), + 'sku' => isset( $_POST['variable_sku'][ $i ] ) ? wc_clean( wp_unslash( $_POST['variable_sku'][ $i ] ) ) : '', + 'weight' => isset( $_POST['variable_weight'][ $i ] ) ? wc_clean( $_POST['variable_weight'][ $i ] ) : '', + 'length' => isset( $_POST['variable_length'][ $i ] ) ? wc_clean( $_POST['variable_length'][ $i ] ) : '', + 'width' => isset( $_POST['variable_width'][ $i ] ) ? wc_clean( $_POST['variable_width'][ $i ] ) : '', + 'height' => isset( $_POST['variable_height'][ $i ] ) ? wc_clean( $_POST['variable_height'][ $i ] ) : '', + 'shipping_class_id' => wc_clean( $_POST['variable_shipping_class'][ $i ] ), + 'tax_class' => isset( $_POST['variable_tax_class'][ $i ] ) ? wc_clean( $_POST['variable_tax_class'][ $i ] ) : null, + ) + ); if ( is_wp_error( $errors ) ) { WC_Admin_Meta_Boxes::add_error( $errors->get_error_message() ); diff --git a/includes/admin/meta-boxes/class-wc-meta-box-product-images.php b/includes/admin/meta-boxes/class-wc-meta-box-product-images.php index 5ac7cca74bd..62639e9f43b 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-product-images.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-product-images.php @@ -25,53 +25,51 @@ class WC_Meta_Box_Product_Images { * @param WP_Post $post */ public static function output( $post ) { + global $thepostid, $product_object; + + $thepostid = $post->ID; + $product_object = $thepostid ? wc_get_product( $thepostid ) : new WC_Product(); + wp_nonce_field( 'woocommerce_save_data', 'woocommerce_meta_nonce' ); ?>

            ID, '_product_image_gallery' ) ) { - $product_image_gallery = get_post_meta( $post->ID, '_product_image_gallery', true ); - } else { - // Backwards compat - $attachment_ids = get_posts( 'post_parent=' . $post->ID . '&numberposts=-1&post_type=attachment&orderby=menu_order&order=ASC&post_mime_type=image&fields=ids&meta_key=_woocommerce_exclude_image&meta_value=0' ); - $attachment_ids = array_diff( $attachment_ids, array( get_post_thumbnail_id() ) ); - $product_image_gallery = implode( ',', $attachment_ids ); - } + $product_image_gallery = $product_object->get_gallery_image_ids( 'edit' ); - $attachments = array_filter( explode( ',', $product_image_gallery ) ); - $update_meta = false; - $updated_gallery_ids = array(); + $attachments = array_filter( $product_image_gallery ); + $update_meta = false; + $updated_gallery_ids = array(); - if ( ! empty( $attachments ) ) { - foreach ( $attachments as $attachment_id ) { - $attachment = wp_get_attachment_image( $attachment_id, 'thumbnail' ); + if ( ! empty( $attachments ) ) { + foreach ( $attachments as $attachment_id ) { + $attachment = wp_get_attachment_image( $attachment_id, 'thumbnail' ); - // if attachment is empty skip - if ( empty( $attachment ) ) { - $update_meta = true; - continue; - } + // if attachment is empty skip. + if ( empty( $attachment ) ) { + $update_meta = true; + continue; + } - echo '
          • + echo '
          • ' . $attachment . '
            • '; - // rebuild ids to be saved - $updated_gallery_ids[] = $attachment_id; - } - - // need to update product meta to set new gallery ids - if ( $update_meta ) { - update_post_meta( $post->ID, '_product_image_gallery', implode( ',', $updated_gallery_ids ) ); - } + // rebuild ids to be saved. + $updated_gallery_ids[] = $attachment_id; } + + // need to update product meta to set new gallery ids + if ( $update_meta ) { + update_post_meta( $post->ID, '_product_image_gallery', implode( ',', $updated_gallery_ids ) ); + } + } ?>
          - +

          @@ -83,12 +81,16 @@ class WC_Meta_Box_Product_Images { /** * Save meta box data. * - * @param int $post_id + * @param int $post_id * @param WP_Post $post */ public static function save( $post_id, $post ) { + $product_type = empty( $_POST['product-type'] ) ? WC_Product_Factory::get_product_type( $post_id ) : sanitize_title( stripslashes( $_POST['product-type'] ) ); + $classname = WC_Product_Factory::get_product_classname( $post_id, $product_type ? $product_type : 'simple' ); + $product = new $classname( $post_id ); $attachment_ids = isset( $_POST['product_image_gallery'] ) ? array_filter( explode( ',', wc_clean( $_POST['product_image_gallery'] ) ) ) : array(); - update_post_meta( $post_id, '_product_image_gallery', implode( ',', $attachment_ids ) ); + $product->set_gallery_image_ids( $attachment_ids ); + $product->save(); } } diff --git a/includes/admin/meta-boxes/class-wc-meta-box-product-reviews.php b/includes/admin/meta-boxes/class-wc-meta-box-product-reviews.php index 0ec9111cb9d..2b845692997 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-product-reviews.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-product-reviews.php @@ -4,13 +4,10 @@ * * Functions for displaying product reviews data meta box. * - * @author WooThemes - * @category Admin - * @package WooCommerce/Admin/Meta Boxes + * @package WooCommerce/Admin/Meta Boxes */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; /** * WC_Meta_Box_Product_Reviews @@ -18,9 +15,9 @@ if ( ! defined( 'ABSPATH' ) ) { class WC_Meta_Box_Product_Reviews { /** - * Output the metabox + * Output the metabox. * - * @param object $comment + * @param object $comment Comment being shown. */ public static function output( $comment ) { wp_nonce_field( 'woocommerce_save_data', 'woocommerce_meta_nonce' ); @@ -28,9 +25,11 @@ class WC_Meta_Box_Product_Reviews { $current = get_comment_meta( $comment->comment_ID, 'rating', true ); ?> 5 || $_POST['rating'] < 0 ) { // WPCS: input var ok. + return $data; + } - // Return regular value after updating - return $location; + $comment_id = $data['comment_ID']; + + update_comment_meta( $comment_id, 'rating', intval( wp_unslash( $_POST['rating'] ) ) ); // WPCS: input var ok. + + // Return regular value after updating. + return $data; } } diff --git a/includes/admin/meta-boxes/class-wc-meta-box-product-short-description.php b/includes/admin/meta-boxes/class-wc-meta-box-product-short-description.php index 7bc9f286238..736ffcb717a 100644 --- a/includes/admin/meta-boxes/class-wc-meta-box-product-short-description.php +++ b/includes/admin/meta-boxes/class-wc-meta-box-product-short-description.php @@ -4,15 +4,11 @@ * * Replaces the standard excerpt box. * - * @author WooThemes - * @category Admin * @package WooCommerce/Admin/Meta Boxes * @version 2.1.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; /** * WC_Meta_Box_Product_Short_Description Class. @@ -22,7 +18,7 @@ class WC_Meta_Box_Product_Short_Description { /** * Output the metabox. * - * @param WP_Post $post + * @param WP_Post $post Post object. */ public static function output( $post ) { @@ -36,6 +32,6 @@ class WC_Meta_Box_Product_Short_Description { 'editor_css' => '', ); - wp_editor( htmlspecialchars_decode( $post->post_excerpt ), 'excerpt', apply_filters( 'woocommerce_product_short_description_editor_settings', $settings ) ); + wp_editor( htmlspecialchars_decode( $post->post_excerpt, ENT_QUOTES ), 'excerpt', apply_filters( 'woocommerce_product_short_description_editor_settings', $settings ) ); } } diff --git a/includes/admin/meta-boxes/views/html-order-download-permission.php b/includes/admin/meta-boxes/views/html-order-download-permission.php index d4ed1309b7f..6d8bef87242 100644 --- a/includes/admin/meta-boxes/views/html-order-download-permission.php +++ b/includes/admin/meta-boxes/views/html-order-download-permission.php @@ -5,9 +5,10 @@ if ( ! defined( 'ABSPATH' ) ) { ?>

          - +
          - + get_id() ), @@ -16,31 +17,46 @@ if ( ! defined( 'ABSPATH' ) ) { esc_html( wc_get_filename_from_url( $product->get_file_download_path( $download->get_download_id() ) ) ) ); printf( _n( 'Downloaded %s time', 'Downloaded %s times', $download->get_download_count(), 'woocommerce' ), esc_html( $download->get_download_count() ) ) - ?> + ?> +

          + diff --git a/includes/admin/meta-boxes/views/html-order-fee.php b/includes/admin/meta-boxes/views/html-order-fee.php index b04e1fbb7ff..d5f3945d028 100644 --- a/includes/admin/meta-boxes/views/html-order-fee.php +++ b/includes/admin/meta-boxes/views/html-order-fee.php @@ -10,7 +10,7 @@ if ( ! defined( 'ABSPATH' ) ) { exit; } ?> - + @@ -33,48 +33,47 @@ if ( ! defined( 'ABSPATH' ) ) { get_taxes() ) && wc_tax_enabled() ) { - foreach ( $order_taxes as $tax_item ) { - $tax_item_id = $tax_item->get_rate_id(); - $tax_item_total = isset( $tax_data['total'][ $tax_item_id ] ) ? $tax_data['total'][ $tax_item_id ] : ''; - ?> - - - get_tax_refunded_for_item( $item_id, $tax_item_id, 'fee' ) ) { + echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; + } + ?> + + + + + + @@ -50,9 +51,9 @@ $thumbnail = $product ? apply_filters( 'woocommerce_admin_order_item_thumbnai get_item_total( $item, false, true ), array( 'currency' => $order->get_currency() ) ); - if ( $item->get_subtotal() !== $item->get_total() ) { - echo '-' . wc_price( wc_format_decimal( $order->get_item_subtotal( $item, false, false ) - $order->get_item_total( $item, false, false ), '' ), array( 'currency' => $order->get_currency() ) ) . ''; - } + if ( $item->get_subtotal() !== $item->get_total() ) { + echo '-' . wc_price( wc_format_decimal( $order->get_item_subtotal( $item, false, false ) - $order->get_item_total( $item, false, false ), '' ), array( 'currency' => $order->get_currency() ) ) . ''; + } ?> @@ -61,97 +62,97 @@ $thumbnail = $product ? apply_filters( 'woocommerce_admin_order_item_thumbnai × ' . esc_html( $item->get_quantity() ); - if ( $refunded_qty = $order->get_qty_refunded_for_item( $item_id ) ) { - echo '' . ( $refunded_qty * -1 ) . ''; - } + if ( $refunded_qty = $order->get_qty_refunded_for_item( $item_id ) ) { + echo '-' . ( $refunded_qty * -1 ) . ''; + } ?> get_taxes() ) && wc_tax_enabled() ) { - foreach ( $order_taxes as $tax_item ) { - $tax_item_id = $tax_item->get_rate_id(); - $tax_item_total = isset( $tax_data['total'][ $tax_item_id ] ) ? $tax_data['total'][ $tax_item_id ] : ''; - $tax_item_subtotal = isset( $tax_data['subtotal'][ $tax_item_id ] ) ? $tax_data['subtotal'][ $tax_item_id ] : ''; - ?> - - + + + + - + diff --git a/includes/admin/meta-boxes/views/html-order-shipping.php b/includes/admin/meta-boxes/views/html-order-shipping.php index e81d1848364..b453a863eef 100644 --- a/includes/admin/meta-boxes/views/html-order-shipping.php +++ b/includes/admin/meta-boxes/views/html-order-shipping.php @@ -9,7 +9,7 @@ if ( ! defined( 'ABSPATH' ) ) { exit; } ?> - + @@ -58,47 +58,47 @@ if ( ! defined( 'ABSPATH' ) ) { get_taxes() ) && wc_tax_enabled() ) { - foreach ( $order_taxes as $tax_item ) { - $tax_item_id = $tax_item->get_rate_id(); - $tax_item_total = isset( $tax_data['total'][ $tax_item_id ] ) ? $tax_data['total'][ $tax_item_id ] : ''; - ?> - - get_taxes() ) && wc_tax_enabled() ) { + foreach ( $order_taxes as $tax_item ) { + $tax_item_id = $tax_item->get_rate_id(); + $tax_item_total = isset( $tax_data['total'][ $tax_item_id ] ) ? $tax_data['total'][ $tax_item_id ] : ''; + ?> + + - - - + + + diff --git a/includes/admin/meta-boxes/views/html-product-variation-download.php b/includes/admin/meta-boxes/views/html-product-variation-download.php index ad802d1db51..6c39752cc0f 100644 --- a/includes/admin/meta-boxes/views/html-product-variation-download.php +++ b/includes/admin/meta-boxes/views/html-product-variation-download.php @@ -5,10 +5,10 @@ if ( ! defined( 'ABSPATH' ) ) { ?> - - - + + + diff --git a/includes/admin/meta-boxes/views/html-variation-admin.php b/includes/admin/meta-boxes/views/html-variation-admin.php index 13c380dca16..06e3823884f 100644 --- a/includes/admin/meta-boxes/views/html-variation-admin.php +++ b/includes/admin/meta-boxes/views/html-variation-admin.php @@ -4,7 +4,7 @@ * * @var int $variation_id * @var WP_POST $variation - * @var WP_Product_Variation $variation_object + * @var WC_Product_Variation $variation_object * @var array $variation_data array of variation data @deprecated. */ if ( ! defined( 'ABSPATH' ) ) { @@ -13,50 +13,53 @@ if ( ! defined( 'ABSPATH' ) ) { ?>

          - +
          # get_attributes( 'edit' ); + $attribute_values = $variation_object->get_attributes( 'edit' ); - foreach ( $product_object->get_attributes( 'edit' ) as $attribute ) { - if ( ! $attribute->get_variation() ) { - continue; - } - $selected_value = isset( $attribute_values[ sanitize_title( $attribute->get_name() ) ] ) ? $attribute_values[ sanitize_title( $attribute->get_name() ) ] : ''; - ?> - - get_attributes( 'edit' ) as $attribute ) { + if ( ! $attribute->get_variation() ) { + continue; } + $selected_value = isset( $attribute_values[ sanitize_title( $attribute->get_name() ) ] ) ? $attribute_values[ sanitize_title( $attribute->get_name() ) ] : ''; + ?> + + - - + +

          - - - + + + - - + + - + $download->get_product_id(), - 'order' => $download->get_order_key(), - 'email' => urlencode( $download->get_user_email() ), - 'key' => $download->get_download_id(), - ), trailingslashit( home_url() ) ); - - echo '' . esc_html( $file_count ) . ''; + $download_link = add_query_arg( + array( + 'download_file' => $download->get_product_id(), + 'order' => $download->get_order_key(), + 'email' => urlencode( $download->get_user_email() ), + 'key' => $download->get_download_id(), + ), trailingslashit( home_url() ) + ); + ?> + + + + get_id() ), + admin_url( 'admin.php?page=wc-reports&tab=orders&report=downloads' ) + ); + echo ''; + esc_html_e( 'View report', 'woocommerce' ); + echo ''; ?>
          		@@ -22,7 +22,7 @@ if ( ! defined( 'ABSPATH' ) ) { - +
          get_total(), array( 'currency' => $order->get_currency() ) ); + echo wc_price( $item->get_total(), array( 'currency' => $order->get_currency() ) ); - if ( $refunded = $order->get_total_refunded_for_item( $item_id, 'fee' ) ) { - echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; - } + if ( $refunded = $order->get_total_refunded_for_item( $item_id, 'fee' ) ) { + echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; + } ?>
          		-
          - $order->get_currency() ) ) : '–'; + if ( ( $tax_data = $item->get_taxes() ) && wc_tax_enabled() ) { + foreach ( $order_taxes as $tax_item ) { + $tax_item_id = $tax_item->get_rate_id(); + $tax_item_total = isset( $tax_data['total'][ $tax_item_id ] ) ? $tax_data['total'][ $tax_item_id ] : ''; + ?> +
          		+
          + $order->get_currency() ) ) : '–'; - if ( $refunded = $order->get_tax_refunded_for_item( $item_id, $tax_item_id, 'fee' ) ) { - echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; - } - ?> -
          - - -           		is_editable() ) : ?> diff --git a/includes/admin/meta-boxes/views/html-order-item-meta.php b/includes/admin/meta-boxes/views/html-order-item-meta.php index 7e2dc47996d..50e80f9f478 100644 --- a/includes/admin/meta-boxes/views/html-order-item-meta.php +++ b/includes/admin/meta-boxes/views/html-order-item-meta.php @@ -3,23 +3,27 @@ if ( ! defined( 'ABSPATH' ) ) { exit; } -$hidden_order_itemmeta = apply_filters( 'woocommerce_hidden_order_itemmeta', array( - '_qty', - '_tax_class', - '_product_id', - '_variation_id', - '_line_subtotal', - '_line_subtotal_tax', - '_line_total', - '_line_tax', - 'method_id', - 'cost', -) ); +$hidden_order_itemmeta = apply_filters( + 'woocommerce_hidden_order_itemmeta', array( + '_qty', + '_tax_class', + '_product_id', + '_variation_id', + '_line_subtotal', + '_line_subtotal_tax', + '_line_total', + '_line_tax', + 'method_id', + 'cost', + '_reduced_stock', + ) +); ?>
          get_formatted_meta_data( '' ) ) : ?> - $meta ) : - if ( in_array( $meta->key, $hidden_order_itemmeta ) ) { + $meta ) : + if ( in_array( $meta->key, $hidden_order_itemmeta, true ) ) { continue; } ?> @@ -35,14 +39,15 @@ $hidden_order_itemmeta = apply_filters( 'woocommerce_hidden_order_itemmeta', arr
          get_formatted_meta_data( '' ) ) : ?> - $meta ) : - if ( in_array( $meta->key, $hidden_order_itemmeta ) ) { + $meta ) : + if ( in_array( $meta->key, $hidden_order_itemmeta, true ) ) { continue; } ?> @@ -52,7 +57,7 @@ $hidden_order_itemmeta = apply_filters( 'woocommerce_hidden_order_itemmeta', arr - +
          - +
          diff --git a/includes/admin/meta-boxes/views/html-order-item.php b/includes/admin/meta-boxes/views/html-order-item.php index 2e5bbbda402..3879f7b3ad6 100644 --- a/includes/admin/meta-boxes/views/html-order-item.php +++ b/includes/admin/meta-boxes/views/html-order-item.php @@ -11,36 +11,37 @@ if ( ! defined( 'ABSPATH' ) ) { $product = $item->get_product(); $product_link = $product ? admin_url( 'post.php?post=' . $item->get_product_id() . '&action=edit' ) : ''; $thumbnail = $product ? apply_filters( 'woocommerce_admin_order_item_thumbnail', $product->get_image( 'thumbnail', array( 'title' => '' ), false ), $item_id, $item ) : ''; +$row_class = apply_filters( 'woocommerce_admin_html_order_item_class', ! empty( $class ) ? $class : '', $item, $order ); ?> -
          ' . wp_kses_post( $thumbnail ) . ''; ?> ' . esc_html( $item->get_name() ) . '' : '
          ' . esc_html( $item->get_name() ) . '
          '; + echo $product_link ? '' . esc_html( $item->get_name() ) . '' : '
          ' . esc_html( $item->get_name() ) . '
          '; - if ( $product && $product->get_sku() ) { - echo '
          ' . __( 'SKU:', 'woocommerce' ) . ' ' . esc_html( $product->get_sku() ) . '
          '; - } + if ( $product && $product->get_sku() ) { + echo '
          ' . esc_html__( 'SKU:', 'woocommerce' ) . ' ' . esc_html( $product->get_sku() ) . '
          '; + } - if ( $item->get_variation_id() ) { - echo '
          ' . __( 'Variation ID:', 'woocommerce' ) . ' '; - if ( 'product_variation' === get_post_type( $item->get_variation_id() ) ) { - echo esc_html( $item->get_variation_id() ); - } else { - /* translators: %s: variation id */ - printf( esc_html__( '%s (No longer exists)', 'woocommerce' ), $item->get_variation_id() ); - } - echo '
          '; + if ( $item->get_variation_id() ) { + echo '
          ' . esc_html__( 'Variation ID:', 'woocommerce' ) . ' '; + if ( 'product_variation' === get_post_type( $item->get_variation_id() ) ) { + echo esc_html( $item->get_variation_id() ); + } else { + /* translators: %s: variation id */ + printf( esc_html__( '%s (No longer exists)', 'woocommerce' ), $item->get_variation_id() ); } + echo '
          '; + } ?> - - - + + +
          get_total(), array( 'currency' => $order->get_currency() ) ); + echo wc_price( $item->get_total(), array( 'currency' => $order->get_currency() ) ); - if ( $item->get_subtotal() !== $item->get_total() ) { - echo '-' . wc_price( wc_format_decimal( $item->get_subtotal() - $item->get_total(), '' ), array( 'currency' => $order->get_currency() ) ) . ''; - } + if ( $item->get_subtotal() !== $item->get_total() ) { + echo '-' . wc_price( wc_format_decimal( $item->get_subtotal() - $item->get_total(), '' ), array( 'currency' => $order->get_currency() ) ) . ''; + } - if ( $refunded = $order->get_total_refunded_for_item( $item_id ) ) { - echo '' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; - } + if ( $refunded = $order->get_total_refunded_for_item( $item_id ) ) { + echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; + } ?>
          		-
          - $order->get_currency() ) ); - } else { - echo '–'; - } + if ( ( $tax_data = $item->get_taxes() ) && wc_tax_enabled() ) { + foreach ( $order_taxes as $tax_item ) { + $tax_item_id = $tax_item->get_rate_id(); + $tax_item_total = isset( $tax_data['total'][ $tax_item_id ] ) ? $tax_data['total'][ $tax_item_id ] : ''; + $tax_item_subtotal = isset( $tax_data['subtotal'][ $tax_item_id ] ) ? $tax_data['subtotal'][ $tax_item_id ] : ''; + ?> +
          		+
          + $order->get_currency() ) ); + } else { + echo '–'; + } - if ( $item->get_subtotal() !== $item->get_total() ) { - if ( '' === $tax_item_total ) { - echo '–'; - } else { - echo '-' . wc_price( wc_round_tax_total( $tax_item_subtotal - $tax_item_total ), array( 'currency' => $order->get_currency() ) ) . ''; - } - } + if ( $item->get_subtotal() !== $item->get_total() ) { + if ( '' === $tax_item_total ) { + echo '–'; + } else { + echo '-' . wc_price( wc_round_tax_total( $tax_item_subtotal - $tax_item_total ), array( 'currency' => $order->get_currency() ) ) . ''; + } + } - if ( $refunded = $order->get_tax_refunded_for_item( $item_id, $tax_item_id ) ) { - echo '' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; - } - ?> -
          -
          diff --git a/includes/admin/meta-boxes/views/html-order-items.php b/includes/admin/meta-boxes/views/html-order-items.php index 6df69a54ebe..201b26f86bd 100644 --- a/includes/admin/meta-boxes/views/html-order-items.php +++ b/includes/admin/meta-boxes/views/html-order-items.php @@ -1,16 +1,17 @@ get_items( apply_filters( 'woocommerce_admin_order_item_types', 'line_item' ) ); +$discounts = $order->get_items( 'discount' ); $line_items_fee = $order->get_items( 'fee' ); $line_items_shipping = $order->get_items( 'shipping' ); @@ -18,141 +19,169 @@ if ( wc_tax_enabled() ) { $order_taxes = $order->get_taxes(); $tax_classes = WC_Tax::get_tax_classes(); $classes_options = wc_get_product_tax_class_options(); - $show_tax_columns = sizeof( $order_taxes ) === 1; + $show_tax_columns = count( $order_taxes ) === 1; } ?>
          - + - - - + + + $tax_item ) : - $tax_class = wc_get_tax_class_by_tax_id( $tax_item['rate_id'] ); - $tax_class_name = isset( $classes_options[ $tax_class ] ) ? $classes_options[ $tax_class ] : __( 'Tax', 'woocommerce' ); - $column_label = ! empty( $tax_item['label'] ) ? $tax_item['label'] : __( 'Tax', 'woocommerce' ); - $column_tip = sprintf( esc_html__( '%1$s (%2$s)', 'woocommerce' ), $tax_item['name'], $tax_class_name ); - ?> - - $tax_item ) : + $tax_class = wc_get_tax_class_by_tax_id( $tax_item['rate_id'] ); + $tax_class_name = isset( $classes_options[ $tax_class ] ) ? $classes_options[ $tax_class ] : __( 'Tax', 'woocommerce' ); + $column_label = ! empty( $tax_item['label'] ) ? $tax_item['label'] : __( 'Tax', 'woocommerce' ); + /* translators: %1$s: tax item name %2$s: tax class name */ + $column_tip = sprintf( esc_html__( '%1$s (%2$s)', 'woocommerce' ), $tax_item['name'], $tax_class_name ); + ?> + + - $item ) { do_action( 'woocommerce_before_order_item_' . $item->get_type() . '_html', $item_id, $item, $order ); - include( 'html-order-item.php' ); + include 'html-order-item.php'; do_action( 'woocommerce_order_item_' . $item->get_type() . '_html', $item_id, $item, $order ); } do_action( 'woocommerce_admin_order_items_after_line_items', $order->get_id() ); - ?> + ?> - shipping() ? WC()->shipping->load_shipping_methods() : array(); foreach ( $line_items_shipping as $item_id => $item ) { - include( 'html-order-shipping.php' ); + include 'html-order-shipping.php'; } do_action( 'woocommerce_admin_order_items_after_shipping', $order->get_id() ); - ?> + ?> - $item ) { - include( 'html-order-fee.php' ); + include 'html-order-fee.php'; } do_action( 'woocommerce_admin_order_items_after_fees', $order->get_id() ); - ?> + ?> - get_refunds() ) { + get_refunds(); + + if ( $refunds ) { foreach ( $refunds as $refund ) { - include( 'html-order-refund.php' ); + include 'html-order-refund.php'; } do_action( 'woocommerce_admin_order_items_after_refunds', $order->get_id() ); } - ?> + ?>
          - - - - + + + +  
          -
          get_items( array( 'coupon' ) ); - if ( $coupons ) { - ?> -
          -
            ' . __( 'Coupon(s)', 'woocommerce' ) . ''; - foreach ( $coupons as $item_id => $item ) { - $post_id = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM {$wpdb->posts} WHERE post_title = %s AND post_type = 'shop_coupon' AND post_status = 'publish' LIMIT 1;", $item->get_code() ) ); - $link = $post_id ? add_query_arg( array( 'post' => $post_id, 'action' => 'edit' ), admin_url( 'post.php' ) ) : add_query_arg( array( 's' => $item->get_code(), 'post_status' => 'all', 'post_type' => 'shop_coupon' ), admin_url( 'edit.php' ) ); - - echo '
          • ' . esc_html( $item->get_code() ) . '
            • '; - } - ?>
          -
          - + $coupons = $order->get_items( 'coupon' ); + if ( $coupons ) : + ?> +
          +
            +
            • + $item ) : + $post_id = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM {$wpdb->posts} WHERE post_title = %s AND post_type = 'shop_coupon' AND post_status = 'publish' LIMIT 1;", $item->get_code() ) ); + $class = $order->is_editable() ? 'code editable' : 'code'; + ?> +
          • + + $post_id, + 'action' => 'edit', + ), + admin_url( 'post.php' ) + ), $item, $order ); + ?> + + get_code() ); ?> + + + + get_code() ); ?> + + + is_editable() ) : ?> + + +
            • + +
          +
          + - - - - - + get_total_discount() ) : ?> + + + + + + get_id() ); ?> - - - - - + get_shipping_methods() ) : ?> + + + + + + get_id() ); ?> get_tax_totals() as $code => $tax ) : ?> - + - + ?> + @@ -160,10 +189,10 @@ if ( wc_tax_enabled() ) { get_id() ); ?> - + @@ -171,9 +200,9 @@ if ( wc_tax_enabled() ) { get_total_refunded() ) : ?> - + - + @@ -185,62 +214,65 @@ if ( wc_tax_enabled() ) {

          is_editable() ) : ?> - + + + + - - - is_editable() ) : ?> - + get_total() - $order->get_total_refunded() || 0 < absint( $order->get_item_count() - $order->get_item_count_refunded() ) ) : ?> - + is_editable() ) : ?> - +

          get_total() - $order->get_total_refunded() || 0 < absint( $order->get_item_count() - $order->get_item_count_refunded() ) ) : ?>
          - get_total_discount(), array( 'currency' => $order->get_currency() ) ); ?> -
          + get_total_discount(), array( 'currency' => $order->get_currency() ) ); // WPCS: XSS ok. ?> +
          get_total_shipping_refunded() ) > 0 ) { - echo '' . strip_tags( wc_price( $order->get_shipping_total(), array( 'currency' => $order->get_currency() ) ) ) . ' ' . wc_price( $order->get_shipping_total() - $refunded, array( 'currency' => $order->get_currency() ) ) . ''; - } else { - echo wc_price( $order->get_shipping_total(), array( 'currency' => $order->get_currency() ) ); - } - ?>
          + get_total_shipping_refunded(); + if ( $refunded > 0 ) { + echo '' . strip_tags( wc_price( $order->get_shipping_total(), array( 'currency' => $order->get_currency() ) ) ) . ' ' . wc_price( $order->get_shipping_total() - $refunded, array( 'currency' => $order->get_currency() ) ) . ''; // WPCS: XSS ok. + } else { + echo wc_price( $order->get_shipping_total(), array( 'currency' => $order->get_currency() ) ); // WPCS: XSS ok. + } + ?> +
          label; ?>:label ); ?>: get_total_tax_refunded_by_rate_id( $tax->rate_id ) ) > 0 ) { - echo '' . strip_tags( $tax->formatted_amount ) . ' ' . wc_price( WC_Tax::round( $tax->amount, wc_get_price_decimals() ) - WC_Tax::round( $refunded, wc_get_price_decimals() ), array( 'currency' => $order->get_currency() ) ) . ''; + + get_total_tax_refunded_by_rate_id( $tax->rate_id ); + if ( $refunded > 0 ) { + echo '' . strip_tags( $tax->formatted_amount ) . ' ' . wc_price( WC_Tax::round( $tax->amount, wc_get_price_decimals() ) - WC_Tax::round( $refunded, wc_get_price_decimals() ), array( 'currency' => $order->get_currency() ) ) . ''; // WPCS: XSS ok. } else { - echo $tax->formatted_amount; + echo wp_kses_post( $tax->formatted_amount ); } - ?>
          :: - get_formatted_order_total(); ?> + get_formatted_order_total(); // WPCS: XSS ok. ?>
          :: -get_total_refunded(), array( 'currency' => $order->get_currency() ) ); ?>-get_total_refunded(), array( 'currency' => $order->get_currency() ) ); // WPCS: XSS ok. ?>
          - - + + - - + + - - + + - + - + - - - - + + + + get_results( "SELECT * FROM {$wpdb->prefix}woocommerce_tax_rates ORDER BY tax_rate_name LIMIT 100" ); - foreach ( $rates as $rate ) { - echo ' + foreach ( $rates as $rate ) { + echo ' @@ -322,13 +376,13 @@ if ( wc_tax_enabled() ) { - '; - } + '; // WPCS: XSS ok. + } ?>
          />
          :-get_total_refunded(), array( 'currency' => $order->get_currency() ) ); ?>:-get_total_refunded(), array( 'currency' => $order->get_currency() ) ); // WPCS: XSS ok. ?>
          :get_total() - $order->get_total_refunded(), array( 'currency' => $order->get_currency() ) ); ?>:get_total() - $order->get_total_refunded(), array( 'currency' => $order->get_currency() ) ); // WPCS: XSS ok. ?>
          @@ -250,13 +282,18 @@ if ( wc_tax_enabled() ) {
          ' . wc_price( 0, array( 'currency' => $order->get_currency() ) ) . ''; - $gateway_supports_refunds = false !== $payment_gateway && $payment_gateway->supports( 'refunds' ); - $gateway_name = false !== $payment_gateway ? ( ! empty( $payment_gateway->method_title ) ? $payment_gateway->method_title : $payment_gateway->get_title() ) : __( 'Payment gateway', 'woocommerce' ); + $refund_amount = '' . wc_price( 0, array( 'currency' => $order->get_currency() ) ) . ''; + $gateway_name = false !== $payment_gateway ? ( ! empty( $payment_gateway->method_title ) ? $payment_gateway->method_title : $payment_gateway->get_title() ) : __( 'Payment gateway', 'woocommerce' ); + + if ( false !== $payment_gateway && $payment_gateway->can_refund_order( $order ) ) { + /* translators: refund amount, gateway name */ + echo ''; + } ?> - - - + + + +
          @@ -267,19 +304,36 @@ if ( wc_tax_enabled() ) {
          -

          +

          - + + + + + + + + + '; + ?> + + + + + +
          - +
          @@ -293,7 +347,7 @@ if ( wc_tax_enabled() ) {
          -

          +

          @@ -304,17 +358,17 @@ if ( wc_tax_enabled() ) {
           
          ' . WC_Tax::get_rate_code( $rate ) . ' ' . WC_Tax::get_rate_percent( $rate ) . '
          get_var( "SELECT COUNT(tax_rate_id) FROM {$wpdb->prefix}woocommerce_tax_rates;" ) ) > 100 ) : ?>

          -
          +

          @@ -336,7 +390,7 @@ if ( wc_tax_enabled() ) {
          - +
          diff --git a/includes/admin/meta-boxes/views/html-order-refund.php b/includes/admin/meta-boxes/views/html-order-refund.php index 21f5ec59c90..720de928047 100644 --- a/includes/admin/meta-boxes/views/html-order-refund.php +++ b/includes/admin/meta-boxes/views/html-order-refund.php @@ -1,24 +1,43 @@ get_refunded_by() ); ?> -
          		 get_id(), wc_format_datetime( $refund->get_date_created(), get_option( 'date_format' ) . ', ' . get_option( 'time_format' ) ) ); - - if ( $who_refunded->exists() ) { - echo ' ' . esc_attr_x( 'by', 'Ex: Refund - $date >by< $username', 'woocommerce' ) . ' ' . '' . esc_attr( $who_refunded->display_name ) . '' ; - } + if ( $who_refunded->exists() ) { + printf( + /* translators: 1: refund id 2: refund date 3: username */ + esc_html__( 'Refund #%1$s - %2$s by %3$s', 'woocommerce' ), + esc_html( $refund->get_id() ), + esc_html( wc_format_datetime( $refund->get_date_created(), get_option( 'date_format' ) . ', ' . get_option( 'time_format' ) ) ), + sprintf( + '%2$s', + /* translators: 1: ID who refunded */ + sprintf( esc_attr__( 'ID: %d', 'woocommerce' ), absint( $who_refunded->ID ) ), + esc_html( $who_refunded->display_name ) + ) + ); + } else { + printf( + /* translators: 1: refund id 2: refund date */ + esc_html__( 'Refund #%1$s - %2$s', 'woocommerce' ), + esc_html( $refund->get_id() ), + esc_html( wc_format_datetime( $refund->get_date_created(), get_option( 'date_format' ) . ', ' . get_option( 'time_format' ) ) ) + ); + } ?> get_reason() ) : ?>

          get_reason() ); ?>

          @@ -33,11 +52,18 @@ $who_refunded = new WP_User( $refund->get_refunded_by() );
          - get_amount() ); ?> + get_amount(), array( 'currency' => $refund->get_currency() ) ) + ); + ?>
          		@@ -21,33 +21,33 @@ if ( ! defined( 'ABSPATH' ) ) { - - - + + +
          get_total(), array( 'currency' => $order->get_currency() ) ); - - if ( $refunded = $order->get_total_refunded_for_item( $item_id, 'shipping' ) ) { - echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; - } + echo wc_price( $item->get_total(), array( 'currency' => $order->get_currency() ) ); + $refunded = $order->get_total_refunded_for_item( $item_id, 'shipping' ); + if ( $refunded ) { + echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; + } ?>
          		-
          - $order->get_currency() ) ) : '–'; - - if ( $refunded = $order->get_tax_refunded_for_item( $item_id, $tax_item_id, 'shipping' ) ) { - echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; - } - ?> -
          - - -           		+
          + $order->get_currency() ) ) : '–'; + $refunded = $order->get_tax_refunded_for_item( $item_id, $tax_item_id, 'shipping' ); + if ( $refunded ) { + echo '-' . wc_price( $refunded, array( 'currency' => $order->get_currency() ) ) . ''; + } + ?> +
          + + +           		is_editable() ) : ?> diff --git a/includes/admin/meta-boxes/views/html-product-attribute.php b/includes/admin/meta-boxes/views/html-product-attribute.php index 3e72569223f..dd26bc9ef18 100644 --- a/includes/admin/meta-boxes/views/html-product-attribute.php +++ b/includes/admin/meta-boxes/views/html-product-attribute.php @@ -5,35 +5,41 @@ if ( ! defined( 'ABSPATH' ) ) { ?>

          - +
          - get_name() ) ); ?> + get_name() ); ?>

          -
          + '_download_limit', 'value' => -1 === $product_object->get_download_limit( 'edit' ) ? '' : $product_object->get_download_limit( 'edit' ), 'label' => __( 'Download limit', 'woocommerce' ), @@ -104,12 +116,14 @@ if ( ! defined( 'ABSPATH' ) ) { 'description' => __( 'Leave blank for unlimited re-downloads.', 'woocommerce' ), 'type' => 'number', 'custom_attributes' => array( - 'step' => '1', - 'min' => '0', + 'step' => '1', + 'min' => '0', ), - ) ); + ) + ); - woocommerce_wp_text_input( array( + woocommerce_wp_text_input( + array( 'id' => '_download_expiry', 'value' => -1 === $product_object->get_download_expiry( 'edit' ) ? '' : $product_object->get_download_expiry( 'edit' ), 'label' => __( 'Download expiry', 'woocommerce' ), @@ -117,41 +131,46 @@ if ( ! defined( 'ABSPATH' ) ) { 'description' => __( 'Enter the number of days before a download link expires, or leave blank.', 'woocommerce' ), 'type' => 'number', 'custom_attributes' => array( - 'step' => '1', - 'min' => '0', + 'step' => '1', + 'min' => '0', ), - ) ); + ) + ); - do_action( 'woocommerce_product_options_downloads' ); + do_action( 'woocommerce_product_options_downloads' ); ?>
          '_tax_status', - 'value' => $product_object->get_tax_status( 'edit' ), - 'label' => __( 'Tax status', 'woocommerce' ), - 'options' => array( - 'taxable' => __( 'Taxable', 'woocommerce' ), - 'shipping' => __( 'Shipping only', 'woocommerce' ), - 'none' => _x( 'None', 'Tax status', 'woocommerce' ), + woocommerce_wp_select( + array( + 'id' => '_tax_status', + 'value' => $product_object->get_tax_status( 'edit' ), + 'label' => __( 'Tax status', 'woocommerce' ), + 'options' => array( + 'taxable' => __( 'Taxable', 'woocommerce' ), + 'shipping' => __( 'Shipping only', 'woocommerce' ), + 'none' => _x( 'None', 'Tax status', 'woocommerce' ), ), - 'desc_tip' => 'true', - 'description' => __( 'Define whether or not the entire product is taxable, or just the cost of shipping it.', 'woocommerce' ), - ) ); + 'desc_tip' => 'true', + 'description' => __( 'Define whether or not the entire product is taxable, or just the cost of shipping it.', 'woocommerce' ), + ) + ); - woocommerce_wp_select( array( + woocommerce_wp_select( + array( 'id' => '_tax_class', 'value' => $product_object->get_tax_class( 'edit' ), 'label' => __( 'Tax class', 'woocommerce' ), 'options' => wc_get_product_tax_class_options(), 'desc_tip' => 'true', 'description' => __( 'Choose a tax class for this product. Tax classes are used to apply different tax rates specific to certain types of product.', 'woocommerce' ), - ) ); + ) + ); - do_action( 'woocommerce_product_options_tax' ); + do_action( 'woocommerce_product_options_tax' ); ?>
          diff --git a/includes/admin/meta-boxes/views/html-product-data-inventory.php b/includes/admin/meta-boxes/views/html-product-data-inventory.php index 00ad5dd1f7e..fe9834feb62 100644 --- a/includes/admin/meta-boxes/views/html-product-data-inventory.php +++ b/includes/admin/meta-boxes/views/html-product-data-inventory.php @@ -1,4 +1,10 @@ '_sku', 'value' => $product_object->get_sku( 'edit' ), - 'label' => '' . __( 'SKU', 'woocommerce' ) . '', + 'label' => '' . esc_html__( 'SKU', 'woocommerce' ) . '', 'desc_tip' => true, 'description' => __( 'SKU refers to a Stock-keeping unit, a unique identifier for each distinct product and service that can be purchased.', 'woocommerce' ), - ) ); - } + ) + ); + } - do_action( 'woocommerce_product_options_sku' ); + do_action( 'woocommerce_product_options_sku' ); - if ( 'yes' === get_option( 'woocommerce_manage_stock' ) ) { + if ( 'yes' === get_option( 'woocommerce_manage_stock' ) ) { - woocommerce_wp_checkbox( array( + woocommerce_wp_checkbox( + array( 'id' => '_manage_stock', 'value' => $product_object->get_manage_stock( 'edit' ) ? 'yes' : 'no', 'wrapper_class' => 'show_if_simple show_if_variable', 'label' => __( 'Manage stock?', 'woocommerce' ), 'description' => __( 'Enable stock management at product level', 'woocommerce' ), - ) ); + ) + ); - do_action( 'woocommerce_product_options_stock' ); + do_action( 'woocommerce_product_options_stock' ); - echo '
          '; + echo '
          '; - woocommerce_wp_text_input( array( + woocommerce_wp_text_input( + array( 'id' => '_stock', 'value' => wc_stock_amount( $product_object->get_stock_quantity( 'edit' ) ), 'label' => __( 'Stock quantity', 'woocommerce' ), @@ -41,52 +52,73 @@ if ( ! defined( 'ABSPATH' ) ) { 'description' => __( 'Stock quantity. If this is a variable product this value will be used to control stock for all variations, unless you define stock at variation level.', 'woocommerce' ), 'type' => 'number', 'custom_attributes' => array( - 'step' => 'any', + 'step' => 'any', ), 'data_type' => 'stock', - ) ); + ) + ); - echo ''; + echo ''; - woocommerce_wp_select( array( + woocommerce_wp_select( + array( 'id' => '_backorders', 'value' => $product_object->get_backorders( 'edit' ), 'label' => __( 'Allow backorders?', 'woocommerce' ), 'options' => wc_get_product_backorder_options(), 'desc_tip' => true, 'description' => __( 'If managing stock, this controls whether or not backorders are allowed. If enabled, stock quantity can go below 0.', 'woocommerce' ), - ) ); + ) + ); - do_action( 'woocommerce_product_options_stock_fields' ); - - echo '
          '; - } - - woocommerce_wp_select( array( - 'id' => '_stock_status', - 'value' => $product_object->get_stock_status( 'edit' ), - 'wrapper_class' => 'hide_if_variable hide_if_external', - 'label' => __( 'Stock status', 'woocommerce' ), - 'options' => wc_get_product_stock_status_options(), - 'desc_tip' => true, - 'description' => __( 'Controls whether or not the product is listed as "in stock" or "out of stock" on the frontend.', 'woocommerce' ), + woocommerce_wp_text_input( array( + 'id' => '_low_stock_amount', + 'value' => $product_object->get_low_stock_amount( 'edit' ), + 'placeholder' => get_option( 'woocommerce_notify_low_stock_amount' ), + 'label' => __( 'Low stock threshold', 'woocommerce' ), + 'desc_tip' => true, + 'description' => __( 'When product stock reaches this amount you will be notified by email', 'woocommerce' ), + 'type' => 'number', + 'custom_attributes' => array( + 'step' => 'any', + ), + 'data_type' => 'stock', ) ); - do_action( 'woocommerce_product_options_stock_status' ); + do_action( 'woocommerce_product_options_stock_fields' ); + + echo '
          '; + } + + woocommerce_wp_select( + array( + 'id' => '_stock_status', + 'value' => $product_object->get_stock_status( 'edit' ), + 'wrapper_class' => 'stock_status_field hide_if_variable hide_if_external hide_if_grouped', + 'label' => __( 'Stock status', 'woocommerce' ), + 'options' => wc_get_product_stock_status_options(), + 'desc_tip' => true, + 'description' => __( 'Controls whether or not the product is listed as "in stock" or "out of stock" on the frontend.', 'woocommerce' ), + ) + ); + + do_action( 'woocommerce_product_options_stock_status' ); ?>
          '_sold_individually', 'value' => $product_object->get_sold_individually( 'edit' ) ? 'yes' : 'no', 'wrapper_class' => 'show_if_simple show_if_variable', 'label' => __( 'Sold individually', 'woocommerce' ), 'description' => __( 'Enable this to only allow one of this item to be bought in a single order', 'woocommerce' ), - ) ); + ) + ); - do_action( 'woocommerce_product_options_sold_individually' ); + do_action( 'woocommerce_product_options_sold_individually' ); ?>
          diff --git a/includes/admin/meta-boxes/views/html-product-data-linked-products.php b/includes/admin/meta-boxes/views/html-product-data-linked-products.php index 774fd54cbcf..dfbdd2d17d2 100644 --- a/includes/admin/meta-boxes/views/html-product-data-linked-products.php +++ b/includes/admin/meta-boxes/views/html-product-data-linked-products.php @@ -1,59 +1,63 @@           		" name="_wc_file_urls[]" value="" />
          - - + + " name="_wc_variation_file_urls[][]" value="" />
          -
          - + + @@ -328,7 +361,7 @@ if ( ! defined( 'ABSPATH' ) ) { get_downloads( 'edit' ) ) { foreach ( $downloads as $key => $file ) { - include( 'html-product-variation-download.php' ); + include 'html-product-variation-download.php'; } } ?> @@ -336,16 +369,18 @@ if ( ! defined( 'ABSPATH' ) ) {
          @@ -354,7 +389,8 @@ if ( ! defined( 'ABSPATH' ) ) { diff --git a/includes/admin/plugin-updates/class-wc-plugin-updates.php b/includes/admin/plugin-updates/class-wc-plugin-updates.php new file mode 100644 index 00000000000..fc0d70f78a1 --- /dev/null +++ b/includes/admin/plugin-updates/class-wc-plugin-updates.php @@ -0,0 +1,264 @@ + + + major_untested_plugins ) ? array_diff_key( $this->minor_untested_plugins, $this->major_untested_plugins ) : $this->minor_untested_plugins; + $version_parts = explode( '.', $this->new_version ); + $new_version = $version_parts[0] . '.' . $version_parts[1]; + + if ( empty( $plugins ) ) { + return; + } + + /* translators: %s: version number */ + $message = sprintf( __( "Heads up! The versions of the following plugins you're running haven't been tested with the latest version of WooCommerce (%s).", 'woocommerce' ), $new_version ); + + ob_start(); + include 'views/html-notice-untested-extensions-inline.php'; + return ob_get_clean(); + } + + /** + * Get the inline warning notice for major version updates. + * + * @return string + */ + protected function get_extensions_inline_warning_major() { + $upgrade_type = 'major'; + $plugins = $this->major_untested_plugins; + $version_parts = explode( '.', $this->new_version ); + $new_version = $version_parts[0] . '.0'; + + if ( empty( $plugins ) ) { + return; + } + + /* translators: %s: version number */ + $message = sprintf( __( "Heads up! The versions of the following plugins you're running haven't been tested with WooCommerce %s. Please update them or confirm compatibility before updating WooCommerce, or you may experience issues:", 'woocommerce' ), $new_version ); + + ob_start(); + include 'views/html-notice-untested-extensions-inline.php'; + return ob_get_clean(); + } + + /** + * Get the warning notice for the modal window. + * + * @return string + */ + protected function get_extensions_modal_warning() { + $version_parts = explode( '.', $this->new_version ); + $new_version = $version_parts[0] . '.0'; + $plugins = $this->major_untested_plugins; + + ob_start(); + include 'views/html-notice-untested-extensions-modal.php'; + return ob_get_clean(); + } + + /* + |-------------------------------------------------------------------------- + | Data Helpers + |-------------------------------------------------------------------------- + | + | Methods for getting & manipulating data. + */ + + /** + * Get active plugins that have a tested version lower than the input version. + * + * @param string $new_version WooCommerce version to test against. + * @param string $release 'major' or 'minor'. + * @return array of plugin info arrays + */ + public function get_untested_plugins( $new_version, $release ) { + $extensions = array_merge( $this->get_plugins_with_header( self::VERSION_TESTED_HEADER ), $this->get_plugins_for_woocommerce() ); + $untested = array(); + $new_version_parts = explode( '.', $new_version ); + $version = $new_version_parts[0]; + + if ( 'minor' === $release ) { + $version .= '.' . $new_version_parts[1]; + } + + if ( 'major' === $release ) { + $current_version_parts = explode( '.', WC_VERSION ); + + // If user has already moved to the major version, we don't need to flag up anything. + if ( version_compare( $current_version_parts[0] . '.' . $current_version_parts[1], $new_version_parts[0] . '.0', '>=' ) ) { + return array(); + } + } + + foreach ( $extensions as $file => $plugin ) { + if ( ! empty( $plugin[ self::VERSION_TESTED_HEADER ] ) ) { + $plugin_version_parts = explode( '.', $plugin[ self::VERSION_TESTED_HEADER ] ); + + if ( ! is_numeric( $plugin_version_parts[0] ) + || ( 'minor' === $release && ! isset( $plugin_version_parts[1] ) ) + || ( 'minor' === $release && ! is_numeric( $plugin_version_parts[1] ) ) + ) { + continue; + } + + $plugin_version = $plugin_version_parts[0]; + + if ( 'minor' === $release ) { + $plugin_version .= '.' . $plugin_version_parts[1]; + } + + if ( version_compare( $plugin_version, $version, '<' ) ) { + $untested[ $file ] = $plugin; + } + } else { + $plugin[ self::VERSION_TESTED_HEADER ] = __( 'unknown', 'woocommerce' ); + $untested[ $file ] = $plugin; + } + } + + return $untested; + } + + /** + * Get plugins that have a valid value for a specific header. + * + * @param string $header Plugin header to search for. + * @return array Array of plugins that contain the searched header. + */ + protected function get_plugins_with_header( $header ) { + $plugins = get_plugins(); + $matches = array(); + + foreach ( $plugins as $file => $plugin ) { + if ( ! empty( $plugin[ $header ] ) ) { + $matches[ $file ] = $plugin; + } + } + + return apply_filters( 'woocommerce_get_plugins_with_header', $matches, $header, $plugins ); + } + + /** + * Get plugins which "maybe" are for WooCommerce. + * + * @return array of plugin info arrays + */ + protected function get_plugins_for_woocommerce() { + $plugins = get_plugins(); + $matches = array(); + + foreach ( $plugins as $file => $plugin ) { + if ( 'WooCommerce' !== $plugin['Name'] && ( stristr( $plugin['Name'], 'woocommerce' ) || stristr( $plugin['Description'], 'woocommerce' ) ) ) { + $matches[ $file ] = $plugin; + } + } + + return apply_filters( 'woocommerce_get_plugins_for_woocommerce', $matches, $plugins ); + } +} diff --git a/includes/admin/plugin-updates/class-wc-plugins-screen-updates.php b/includes/admin/plugin-updates/class-wc-plugins-screen-updates.php new file mode 100644 index 00000000000..2b34a24fd4f --- /dev/null +++ b/includes/admin/plugin-updates/class-wc-plugins-screen-updates.php @@ -0,0 +1,171 @@ +new_version = $response->new_version; + $this->upgrade_notice = $this->get_upgrade_notice( $response->new_version ); + $this->major_untested_plugins = $this->get_untested_plugins( $response->new_version, 'major' ); + $this->minor_untested_plugins = $this->get_untested_plugins( $response->new_version, 'minor' ); + + $current_version_parts = explode( '.', WC_VERSION ); + $new_version_parts = explode( '.', $this->new_version ); + + // If user has already moved to the minor version, we don't need to flag up anything. + if ( version_compare( $current_version_parts[0] . '.' . $current_version_parts[1], $new_version_parts[0] . '.' . $new_version_parts[1], '=' ) ) { + return; + } + + if ( ! empty( $this->major_untested_plugins ) ) { + $this->upgrade_notice .= $this->get_extensions_inline_warning_major(); + } + + if ( ! empty( $this->minor_untested_plugins ) ) { + $this->upgrade_notice .= $this->get_extensions_inline_warning_minor(); + } + + if ( ! empty( $this->major_untested_plugins ) ) { + $this->upgrade_notice .= $this->get_extensions_modal_warning(); + add_action( 'admin_print_footer_scripts', array( $this, 'plugin_screen_modal_js' ) ); + } + + echo apply_filters( 'woocommerce_in_plugin_update_message', $this->upgrade_notice ? '

          ' . wp_kses_post( $this->upgrade_notice ) . '

          ' : '' ); // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped + } + + /** + * Get the upgrade notice from WordPress.org. + * + * @param string $version WooCommerce new version. + * @return string + */ + protected function get_upgrade_notice( $version ) { + $transient_name = 'wc_upgrade_notice_' . $version; + $upgrade_notice = get_transient( $transient_name ); + + if ( false === $upgrade_notice ) { + $response = wp_safe_remote_get( 'https://plugins.svn.wordpress.org/woocommerce/trunk/readme.txt' ); + + if ( ! is_wp_error( $response ) && ! empty( $response['body'] ) ) { + $upgrade_notice = $this->parse_update_notice( $response['body'], $version ); + set_transient( $transient_name, $upgrade_notice, DAY_IN_SECONDS ); + } + } + return $upgrade_notice; + } + + /** + * Parse update notice from readme file. + * + * @param string $content WooCommerce readme file content. + * @param string $new_version WooCommerce new version. + * @return string + */ + private function parse_update_notice( $content, $new_version ) { + $version_parts = explode( '.', $new_version ); + $check_for_notices = array( + $version_parts[0] . '.0', // Major. + $version_parts[0] . '.0.0', // Major. + $version_parts[0] . '.' . $version_parts[1], // Minor. + $version_parts[0] . '.' . $version_parts[1] . '.' . $version_parts[2], // Patch. + ); + $notice_regexp = '~==\s*Upgrade Notice\s*==\s*=\s*(.*)\s*=(.*)(=\s*' . preg_quote( $new_version ) . '\s*=|$)~Uis'; + $upgrade_notice = ''; + + foreach ( $check_for_notices as $check_version ) { + if ( version_compare( WC_VERSION, $check_version, '>' ) ) { + continue; + } + + $matches = null; + if ( preg_match( $notice_regexp, $content, $matches ) ) { + $notices = (array) preg_split( '~[\r\n]+~', trim( $matches[2] ) ); + + if ( version_compare( trim( $matches[1] ), $check_version, '=' ) ) { + $upgrade_notice .= '

          '; + + foreach ( $notices as $index => $line ) { + $upgrade_notice .= preg_replace( '~\[([^\]]*)\]\(([^\)]*)\)~', '${1}', $line ); + } + + $upgrade_notice .= '

          '; + } + break; + } + } + return wp_kses_post( $upgrade_notice ); + } + + /** + * JS for the modal window on the plugins screen. + */ + public function plugin_screen_modal_js() { + ?> + + generic_modal_js(); + } +} +new WC_Plugins_Screen_Updates(); diff --git a/includes/admin/plugin-updates/class-wc-updates-screen-updates.php b/includes/admin/plugin-updates/class-wc-updates-screen-updates.php new file mode 100644 index 00000000000..5e55da51488 --- /dev/null +++ b/includes/admin/plugin-updates/class-wc-updates-screen-updates.php @@ -0,0 +1,95 @@ +update ) + || empty( $updateable_plugins['woocommerce/woocommerce.php']->update->new_version ) ) { + return; + } + + $this->new_version = wc_clean( $updateable_plugins['woocommerce/woocommerce.php']->update->new_version ); + $this->major_untested_plugins = $this->get_untested_plugins( $this->new_version, 'major' ); + + if ( ! empty( $this->major_untested_plugins ) ) { + echo $this->get_extensions_modal_warning(); // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped + $this->update_screen_modal_js(); + } + } + + /** + * JS for the modal window on the updates screen. + */ + protected function update_screen_modal_js() { + ?> + + generic_modal_js(); + } +} +new WC_Updates_Screen_Updates(); diff --git a/includes/admin/plugin-updates/views/html-notice-untested-extensions-inline.php b/includes/admin/plugin-updates/views/html-notice-untested-extensions-inline.php new file mode 100644 index 00000000000..86950a43207 --- /dev/null +++ b/includes/admin/plugin-updates/views/html-notice-untested-extensions-inline.php @@ -0,0 +1,31 @@ + +
          +

          + +
           
          - +
          + + + + + + + + + + + + + + +
          +
          diff --git a/includes/admin/plugin-updates/views/html-notice-untested-extensions-modal.php b/includes/admin/plugin-updates/views/html-notice-untested-extensions-modal.php new file mode 100644 index 00000000000..23c1fe21a19 --- /dev/null +++ b/includes/admin/plugin-updates/views/html-notice-untested-extensions-modal.php @@ -0,0 +1,54 @@ + +
          +
          +

          +
          +

          + +
          + + + + + + + + + + + + + + + +
          +
          + +

          + + +
          + + +
          + +
          +
          +
          diff --git a/includes/admin/reports/class-wc-admin-report.php b/includes/admin/reports/class-wc-admin-report.php index 9499cc832f4..9467e058837 100644 --- a/includes/admin/reports/class-wc-admin-report.php +++ b/includes/admin/reports/class-wc-admin-report.php @@ -90,8 +90,8 @@ class WC_Admin_Report { 'order_status' => array( 'completed', 'processing', 'on-hold' ), 'parent_order_status' => false, ); - $args = apply_filters( 'woocommerce_reports_get_order_report_data_args', $args ); - $args = wp_parse_args( $args, $default_args ); + $args = apply_filters( 'woocommerce_reports_get_order_report_data_args', $args ); + $args = wp_parse_args( $args, $default_args ); extract( $args ); @@ -113,22 +113,22 @@ class WC_Admin_Report { } switch ( $value['type'] ) { - case 'meta' : + case 'meta': $get_key = "meta_{$key}.meta_value"; break; - case 'parent_meta' : + case 'parent_meta': $get_key = "parent_meta_{$key}.meta_value"; break; - case 'post_data' : + case 'post_data': $get_key = "posts.{$key}"; break; - case 'order_item_meta' : + case 'order_item_meta': $get_key = "order_item_meta_{$key}.meta_value"; break; - case 'order_item' : + case 'order_item': $get_key = "order_items.{$key}"; break; - default : + default: continue; } @@ -141,7 +141,7 @@ class WC_Admin_Report { $select[] = "{$get} as {$value['name']}"; } - $query['select'] = "SELECT " . implode( ',', $select ); + $query['select'] = 'SELECT ' . implode( ',', $select ); $query['from'] = "FROM {$wpdb->posts} AS posts"; // Joins @@ -153,25 +153,25 @@ class WC_Admin_Report { $key = sanitize_key( $raw_key ); switch ( $type ) { - case 'meta' : + case 'meta': $joins[ "meta_{$key}" ] = "{$join_type} JOIN {$wpdb->postmeta} AS meta_{$key} ON ( posts.ID = meta_{$key}.post_id AND meta_{$key}.meta_key = '{$raw_key}' )"; break; - case 'parent_meta' : + case 'parent_meta': $joins[ "parent_meta_{$key}" ] = "{$join_type} JOIN {$wpdb->postmeta} AS parent_meta_{$key} ON (posts.post_parent = parent_meta_{$key}.post_id) AND (parent_meta_{$key}.meta_key = '{$raw_key}')"; break; - case 'order_item_meta' : - $joins["order_items"] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON (posts.ID = order_items.order_id)"; + case 'order_item_meta': + $joins['order_items'] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON (posts.ID = order_items.order_id)"; if ( ! empty( $value['order_item_type'] ) ) { - $joins["order_items"] .= " AND (order_items.order_item_type = '{$value['order_item_type']}')"; + $joins['order_items'] .= " AND (order_items.order_item_type = '{$value['order_item_type']}')"; } - $joins[ "order_item_meta_{$key}" ] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_itemmeta AS order_item_meta_{$key} ON " . + $joins[ "order_item_meta_{$key}" ] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_itemmeta AS order_item_meta_{$key} ON " . "(order_items.order_item_id = order_item_meta_{$key}.order_item_id) " . " AND (order_item_meta_{$key}.meta_key = '{$raw_key}')"; break; - case 'order_item' : - $joins["order_items"] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON posts.ID = order_items.order_id"; + case 'order_item': + $joins['order_items'] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON posts.ID = order_items.order_id"; break; } } @@ -187,7 +187,7 @@ class WC_Admin_Report { if ( 'order_item_meta' === $type ) { - $joins["order_items"] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON posts.ID = order_items.order_id"; + $joins['order_items'] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON posts.ID = order_items.order_id"; $joins[ "order_item_meta_{$key}" ] = "{$join_type} JOIN {$wpdb->prefix}woocommerce_order_itemmeta AS order_item_meta_{$key} ON order_items.order_item_id = order_item_meta_{$key}.order_item_id"; } else { @@ -198,12 +198,12 @@ class WC_Admin_Report { } if ( ! empty( $parent_order_status ) ) { - $joins["parent"] = "LEFT JOIN {$wpdb->posts} AS parent ON posts.post_parent = parent.ID"; + $joins['parent'] = "LEFT JOIN {$wpdb->posts} AS parent ON posts.post_parent = parent.ID"; } $query['join'] = implode( ' ', $joins ); - $query['where'] = " + $query['where'] = " WHERE posts.post_type IN ( '" . implode( "','", $order_types ) . "' ) "; @@ -232,7 +232,7 @@ class WC_Admin_Report { $relation = isset( $where_meta['relation'] ) ? $where_meta['relation'] : 'AND'; - $query['where'] .= " AND ("; + $query['where'] .= ' AND ('; foreach ( $where_meta as $index => $value ) { @@ -282,7 +282,7 @@ class WC_Admin_Report { } } - $query['where'] .= ")"; + $query['where'] .= ')'; } if ( ! empty( $where ) ) { @@ -332,8 +332,13 @@ class WC_Admin_Report { } if ( $debug || $nocache || false === $cached_results || ! isset( $cached_results[ $query_hash ] ) ) { - // Enable big selects for reports - $wpdb->query( 'SET SESSION SQL_BIG_SELECTS=1' ); + static $big_selects = false; + // Enable big selects for reports, just once for this session + if ( ! $big_selects ) { + $wpdb->query( 'SET SESSION SQL_BIG_SELECTS=1' ); + $big_selects = true; + } + $cached_results[ $query_hash ] = apply_filters( 'woocommerce_reports_get_order_report_data', $wpdb->$query_type( $query ), $data ); set_transient( strtolower( get_class( $this ) ), $cached_results, DAY_IN_SECONDS ); } @@ -346,10 +351,10 @@ class WC_Admin_Report { /** * Put data with post_date's into an array of times. * - * @param array $data array of your data + * @param array $data array of your data * @param string $date_key key for the 'date' field. e.g. 'post_date' * @param string $data_key key for the data you are charting - * @param int $interval + * @param int $interval * @param string $start_date * @param string $group_by * @return array @@ -388,13 +393,13 @@ class WC_Admin_Report { foreach ( $data as $d ) { switch ( $group_by ) { - case 'day' : + case 'day': $time = strtotime( date( 'Ymd', strtotime( $d->$date_key ) ) ) . '000'; - break; - case 'month' : - default : + break; + case 'month': + default: $time = strtotime( date( 'Ym', strtotime( $d->$date_key ) ) . '01' ) . '000'; - break; + break; } if ( ! isset( $prepared_data[ $time ] ) ) { @@ -414,8 +419,8 @@ class WC_Admin_Report { /** * Prepares a sparkline to show sales in the last X days. * - * @param int $id ID of the product to show. Blank to get all orders. - * @param int $days Days of stats to get. + * @param int $id ID of the product to show. Blank to get all orders. + * @param int $days Days of stats to get. * @param string $type Type of sparkline to get. Ignored if ID is not set. * @return string */ @@ -424,68 +429,72 @@ class WC_Admin_Report { if ( $id ) { $meta_key = ( 'sales' === $type ) ? '_line_total' : '_qty'; - $data = $this->get_order_report_data( array( - 'data' => array( - '_product_id' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => '', - 'name' => 'product_id', + $data = $this->get_order_report_data( + array( + 'data' => array( + '_product_id' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => '', + 'name' => 'product_id', + ), + $meta_key => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'sparkline_value', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), ), - $meta_key => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'sparkline_value', + 'where' => array( + array( + 'key' => 'post_date', + 'value' => date( 'Y-m-d', strtotime( 'midnight -' . ( $days - 1 ) . ' days', current_time( 'timestamp' ) ) ), + 'operator' => '>', + ), + array( + 'key' => 'order_item_meta__product_id.meta_value', + 'value' => $id, + 'operator' => '=', + ), ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', - ), - ), - 'where' => array( - array( - 'key' => 'post_date', - 'value' => date( 'Y-m-d', strtotime( 'midnight -' . ( $days - 1 ) . ' days', current_time( 'timestamp' ) ) ), - 'operator' => '>', - ), - array( - 'key' => 'order_item_meta__product_id.meta_value', - 'value' => $id, - 'operator' => '=', - ), - ), - 'group_by' => 'YEAR(posts.post_date), MONTH(posts.post_date), DAY(posts.post_date)', - 'query_type' => 'get_results', - 'filter_range' => false, - ) ); + 'group_by' => 'YEAR(posts.post_date), MONTH(posts.post_date), DAY(posts.post_date)', + 'query_type' => 'get_results', + 'filter_range' => false, + ) + ); } else { - $data = $this->get_order_report_data( array( - 'data' => array( - '_order_total' => array( - 'type' => 'meta', - 'function' => 'SUM', - 'name' => 'sparkline_value', + $data = $this->get_order_report_data( + array( + 'data' => array( + '_order_total' => array( + 'type' => 'meta', + 'function' => 'SUM', + 'name' => 'sparkline_value', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', + 'where' => array( + array( + 'key' => 'post_date', + 'value' => date( 'Y-m-d', strtotime( 'midnight -' . ( $days - 1 ) . ' days', current_time( 'timestamp' ) ) ), + 'operator' => '>', + ), ), - ), - 'where' => array( - array( - 'key' => 'post_date', - 'value' => date( 'Y-m-d', strtotime( 'midnight -' . ( $days - 1 ) . ' days', current_time( 'timestamp' ) ) ), - 'operator' => '>', - ), - ), - 'group_by' => 'YEAR(posts.post_date), MONTH(posts.post_date), DAY(posts.post_date)', - 'query_type' => 'get_results', - 'filter_range' => false, - ) ); + 'group_by' => 'YEAR(posts.post_date), MONTH(posts.post_date), DAY(posts.post_date)', + 'query_type' => 'get_results', + 'filter_range' => false, + ) + ); } $total = 0; @@ -515,8 +524,7 @@ class WC_Admin_Report { switch ( $current_range ) { - case 'custom' : - + case 'custom': $this->start_date = max( strtotime( '-20 years' ), strtotime( sanitize_text_field( $_GET['start_date'] ) ) ); if ( empty( $_GET['end_date'] ) ) { @@ -528,7 +536,7 @@ class WC_Admin_Report { $interval = 0; $min_date = $this->start_date; - while ( ( $min_date = strtotime( "+1 MONTH", $min_date ) ) <= $this->end_date ) { + while ( ( $min_date = strtotime( '+1 MONTH', $min_date ) ) <= $this->end_date ) { $interval ++; } @@ -538,54 +546,54 @@ class WC_Admin_Report { } else { $this->chart_groupby = 'day'; } - break; + break; - case 'year' : + case 'year': $this->start_date = strtotime( date( 'Y-01-01', current_time( 'timestamp' ) ) ); $this->end_date = strtotime( 'midnight', current_time( 'timestamp' ) ); $this->chart_groupby = 'month'; - break; + break; - case 'last_month' : + case 'last_month': $first_day_current_month = strtotime( date( 'Y-m-01', current_time( 'timestamp' ) ) ); $this->start_date = strtotime( date( 'Y-m-01', strtotime( '-1 DAY', $first_day_current_month ) ) ); $this->end_date = strtotime( date( 'Y-m-t', strtotime( '-1 DAY', $first_day_current_month ) ) ); $this->chart_groupby = 'day'; - break; + break; - case 'month' : + case 'month': $this->start_date = strtotime( date( 'Y-m-01', current_time( 'timestamp' ) ) ); $this->end_date = strtotime( 'midnight', current_time( 'timestamp' ) ); $this->chart_groupby = 'day'; - break; + break; - case '7day' : + case '7day': $this->start_date = strtotime( '-6 days', strtotime( 'midnight', current_time( 'timestamp' ) ) ); $this->end_date = strtotime( 'midnight', current_time( 'timestamp' ) ); $this->chart_groupby = 'day'; - break; + break; } // Group by switch ( $this->chart_groupby ) { - case 'day' : + case 'day': $this->group_by_query = 'YEAR(posts.post_date), MONTH(posts.post_date), DAY(posts.post_date)'; $this->chart_interval = absint( ceil( max( 0, ( $this->end_date - $this->start_date ) / ( 60 * 60 * 24 ) ) ) ); $this->barwidth = 60 * 60 * 24 * 1000; - break; + break; - case 'month' : + case 'month': $this->group_by_query = 'YEAR(posts.post_date), MONTH(posts.post_date)'; $this->chart_interval = 0; $min_date = strtotime( date( 'Y-m-01', $this->start_date ) ); - while ( ( $min_date = strtotime( "+1 MONTH", $min_date ) ) <= $this->end_date ) { + while ( ( $min_date = strtotime( '+1 MONTH', $min_date ) ) <= $this->end_date ) { $this->chart_interval ++; } $this->barwidth = 60 * 60 * 24 * 7 * 4 * 1000; - break; + break; } } @@ -616,8 +624,6 @@ class WC_Admin_Report { /** * Get the main chart. - * - * @return string */ public function get_main_chart() {} @@ -660,8 +666,12 @@ class WC_Admin_Report { return; } - if ( ! isset( $_GET['wc_reports_nonce'] ) || ! wp_verify_nonce( $_GET['wc_reports_nonce'], 'custom_range' ) ) { - wp_safe_redirect( remove_query_arg( array( 'start_date', 'end_date', 'range', 'wc_reports_nonce' ) ) ); + if ( ! isset( $_GET['wc_reports_nonce'] ) || ! wp_verify_nonce( sanitize_key( $_GET['wc_reports_nonce'] ), 'custom_range' ) ) { // WPCS: input var ok, CSRF ok. + wp_die( + /* translators: %1$s: open link, %2$s: close link */ + sprintf( esc_html__( 'This report link has expired. %1$sClick here to view the filtered report%2$s.', 'woocommerce' ), '', '' ), // @codingStandardsIgnoreLine. + esc_attr__( 'Confirm navigation', 'woocommerce' ) + ); exit; } } diff --git a/includes/admin/reports/class-wc-report-coupon-usage.php b/includes/admin/reports/class-wc-report-coupon-usage.php index 2df70e25fb8..59141e02b05 100644 --- a/includes/admin/reports/class-wc-report-coupon-usage.php +++ b/includes/admin/reports/class-wc-report-coupon-usage.php @@ -1,7 +1,12 @@ coupon_codes = array_filter( array_map( 'sanitize_text_field', $_GET['coupon_codes'] ) ); + $this->coupon_codes = array_filter( array_map( 'sanitize_text_field', wp_unslash( $_GET['coupon_codes'] ) ) ); } elseif ( isset( $_GET['coupon_codes'] ) ) { - $this->coupon_codes = array_filter( array( sanitize_text_field( $_GET['coupon_codes'] ) ) ); + $this->coupon_codes = array_filter( array( sanitize_text_field( wp_unslash( $_GET['coupon_codes'] ) ) ) ); } } @@ -48,7 +53,7 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { $legend = array(); $total_discount_query = array( - 'data' => array( + 'data' => array( 'discount_amount' => array( 'type' => 'order_item_meta', 'order_item_type' => 'coupon', @@ -56,7 +61,7 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { 'name' => 'discount_amount', ), ), - 'where' => array( + 'where' => array( array( 'key' => 'order_item_type', 'value' => 'coupon', @@ -69,7 +74,7 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { ); $total_coupons_query = array( - 'data' => array( + 'data' => array( 'order_item_id' => array( 'type' => 'order_item', 'order_item_type' => 'coupon', @@ -77,7 +82,7 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { 'name' => 'order_coupon_count', ), ), - 'where' => array( + 'where' => array( array( 'key' => 'order_item_type', 'value' => 'coupon', @@ -106,15 +111,15 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { $legend[] = array( /* translators: %s: discount amount */ - 'title' => sprintf( __( '%s discounts in total', 'woocommerce' ), '' . wc_price( $total_discount ) . '' ), - 'color' => $this->chart_colours['discount_amount'], + 'title' => sprintf( __( '%s discounts in total', 'woocommerce' ), '' . wc_price( $total_discount ) . '' ), + 'color' => $this->chart_colours['discount_amount'], 'highlight_series' => 1, ); $legend[] = array( /* translators: %s: coupons amount */ - 'title' => sprintf( __( '%s coupons used in total', 'woocommerce' ), '' . $total_coupons . '' ), - 'color' => $this->chart_colours['coupon_count'], + 'title' => sprintf( __( '%s coupons used in total', 'woocommerce' ), '' . $total_coupons . '' ), + 'color' => $this->chart_colours['coupon_count'], 'highlight_series' => 0, ); @@ -127,10 +132,10 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { public function output_report() { $ranges = array( - 'year' => __( 'Year', 'woocommerce' ), - 'last_month' => __( 'Last month', 'woocommerce' ), - 'month' => __( 'This month', 'woocommerce' ), - '7day' => __( 'Last 7 days', 'woocommerce' ), + 'year' => __( 'Year', 'woocommerce' ), + 'last_month' => __( 'Last month', 'woocommerce' ), + 'month' => __( 'This month', 'woocommerce' ), + '7day' => __( 'Last 7 days', 'woocommerce' ), ); $this->chart_colours = array( @@ -138,7 +143,7 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { 'coupon_count' => '#d4d9dc', ); - $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( $_GET['range'] ) : '7day'; + $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( wp_unslash( $_GET['range'] ) ) : '7day'; if ( ! in_array( $current_range, array( 'custom', 'year', 'last_month', 'month', '7day' ) ) ) { $current_range = '7day'; @@ -147,7 +152,7 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { $this->check_current_range_nonce( $current_range ); $this->calculate_current_range( $current_range ); - include( WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php' ); + include WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php'; } /** @@ -171,13 +176,14 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { */ public function coupons_widget() { ?> -

          +

          get_order_report_data( array( - 'data' => array( + $used_coupons = $this->get_order_report_data( + array( + 'data' => array( 'order_item_name' => array( 'type' => 'order_item', 'order_item_type' => 'coupon', @@ -186,7 +192,7 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { 'name' => 'order_item_name', ), ), - 'where' => array( + 'where' => array( array( 'key' => 'order_item_type', 'value' => 'coupon', @@ -195,121 +201,130 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { ), 'query_type' => 'get_col', 'filter_range' => false, - ) ); + ) + ); - if ( ! empty( $used_coupons ) && is_array( $used_coupons ) ) : + if ( ! empty( $used_coupons ) && is_array( $used_coupons ) ) : ?> - - - - - - - + + + + + + + + + - +
          -

          +

          get_order_report_data( array( - 'data' => array( - 'order_item_name' => array( - 'type' => 'order_item', - 'order_item_type' => 'coupon', - 'function' => '', - 'name' => 'coupon_code', + $most_popular = $this->get_order_report_data( + array( + 'data' => array( + 'order_item_name' => array( + 'type' => 'order_item', + 'order_item_type' => 'coupon', + 'function' => '', + 'name' => 'coupon_code', + ), + 'order_item_id' => array( + 'type' => 'order_item', + 'order_item_type' => 'coupon', + 'function' => 'COUNT', + 'name' => 'coupon_count', + ), ), - 'order_item_id' => array( - 'type' => 'order_item', - 'order_item_type' => 'coupon', - 'function' => 'COUNT', - 'name' => 'coupon_count', + 'where' => array( + array( + 'type' => 'order_item', + 'key' => 'order_item_type', + 'value' => 'coupon', + 'operator' => '=', + ), ), - ), - 'where' => array( - array( - 'type' => 'order_item', - 'key' => 'order_item_type', - 'value' => 'coupon', - 'operator' => '=', - ), - ), - 'order_by' => 'coupon_count DESC', - 'group_by' => 'order_item_name', - 'limit' => 12, - 'query_type' => 'get_results', - 'filter_range' => true, - ) ); + 'order_by' => 'coupon_count DESC', + 'group_by' => 'order_item_name', + 'limit' => 12, + 'query_type' => 'get_results', + 'filter_range' => true, + ) + ); if ( ! empty( $most_popular ) && is_array( $most_popular ) ) { foreach ( $most_popular as $coupon ) { echo ' - - + + '; } } else { - echo ''; + echo ''; } ?>
          ' . $coupon->coupon_count . '' . $coupon->coupon_code . '' . esc_html( $coupon->coupon_count ) . '' . esc_html( $coupon->coupon_code ) . '
          ' . __( 'No coupons found in range', 'woocommerce' ) . '
          ' . esc_html__( 'No coupons found in range', 'woocommerce' ) . '
          -

          +

          get_order_report_data( array( - 'data' => array( - 'order_item_name' => array( - 'type' => 'order_item', - 'order_item_type' => 'coupon', - 'function' => '', - 'name' => 'coupon_code', + $most_discount = $this->get_order_report_data( + array( + 'data' => array( + 'order_item_name' => array( + 'type' => 'order_item', + 'order_item_type' => 'coupon', + 'function' => '', + 'name' => 'coupon_code', + ), + 'discount_amount' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'coupon', + 'function' => 'SUM', + 'name' => 'discount_amount', + ), ), - 'discount_amount' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'coupon', - 'function' => 'SUM', - 'name' => 'discount_amount', + 'where' => array( + array( + 'type' => 'order_item', + 'key' => 'order_item_type', + 'value' => 'coupon', + 'operator' => '=', + ), ), - ), - 'where' => array( - array( - 'type' => 'order_item', - 'key' => 'order_item_type', - 'value' => 'coupon', - 'operator' => '=', - ), - ), - 'order_by' => 'discount_amount DESC', - 'group_by' => 'order_item_name', - 'limit' => 12, - 'query_type' => 'get_results', - 'filter_range' => true, - ) ); + 'order_by' => 'discount_amount DESC', + 'group_by' => 'order_item_name', + 'limit' => 12, + 'query_type' => 'get_results', + 'filter_range' => true, + ) + ); if ( ! empty( $most_discount ) && is_array( $most_discount ) ) { foreach ( $most_discount as $coupon ) { + // @codingStandardsIgnoreStart echo ' - + '; + // @codingStandardsIgnoreEnd } } else { - echo ''; + echo ''; } ?>
          ' . wc_price( $coupon->discount_amount ) . '' . $coupon->coupon_code . '' . esc_html( $coupon->coupon_code ) . '
          ' . __( 'No coupons found in range', 'woocommerce' ) . '
          ' . esc_html__( 'No coupons found in range', 'woocommerce' ) . '
          @@ -342,45 +357,43 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { * Output an export link. */ public function get_export_button() { - $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( $_GET['range'] ) : '7day'; + $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( wp_unslash( $_GET['range'] ) ) : '7day'; ?> - + array( + 'data' => array( 'order_item_name' => array( 'type' => 'order_item', 'order_item_type' => 'coupon', 'function' => 'COUNT', 'name' => 'order_coupon_count', ), - 'post_date' => array( + 'post_date' => array( 'type' => 'post_data', 'function' => '', 'name' => 'post_date', ), ), - 'where' => array( + 'where' => array( array( 'key' => 'order_item_type', 'value' => 'coupon', @@ -395,20 +408,20 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { ); $order_discount_amounts_query = array( - 'data' => array( + 'data' => array( 'discount_amount' => array( 'type' => 'order_item_meta', 'order_item_type' => 'coupon', 'function' => 'SUM', 'name' => 'discount_amount', ), - 'post_date' => array( + 'post_date' => array( 'type' => 'post_data', 'function' => '', 'name' => 'post_date', ), ), - 'where' => array( + 'where' => array( array( 'key' => 'order_item_type', 'value' => 'coupon', @@ -437,15 +450,17 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { $order_coupon_counts = $this->get_order_report_data( $order_coupon_counts_query ); $order_discount_amounts = $this->get_order_report_data( $order_discount_amounts_query ); - // Prepare data for report - $order_coupon_counts = $this->prepare_chart_data( $order_coupon_counts, 'post_date', 'order_coupon_count' , $this->chart_interval, $this->start_date, $this->chart_groupby ); + // Prepare data for report. + $order_coupon_counts = $this->prepare_chart_data( $order_coupon_counts, 'post_date', 'order_coupon_count', $this->chart_interval, $this->start_date, $this->chart_groupby ); $order_discount_amounts = $this->prepare_chart_data( $order_discount_amounts, 'post_date', 'discount_amount', $this->chart_interval, $this->start_date, $this->chart_groupby ); - // Encode in json format - $chart_data = json_encode( array( - 'order_coupon_counts' => array_values( $order_coupon_counts ), - 'order_discount_amounts' => array_values( $order_discount_amounts ), - ) ); + // Encode in json format. + $chart_data = json_encode( + array( + 'order_coupon_counts' => array_values( $order_coupon_counts ), + 'order_discount_amounts' => array_values( $order_discount_amounts ), + ) + ); ?>
          @@ -454,27 +469,27 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { var main_chart; jQuery(function(){ - var order_data = jQuery.parseJSON( '' ); + var order_data = jQuery.parseJSON( '' ); var drawGraph = function( highlight ) { var series = [ { - label: "", + label: "", data: order_data.order_coupon_counts, - color: 'chart_colours['coupon_count']; ?>', - bars: { fillColor: 'chart_colours['coupon_count']; ?>', fill: true, show: true, lineWidth: 0, barWidth: barwidth; ?> * 0.5, align: 'center' }, + color: 'chart_colours['coupon_count'] ); ?>', + bars: { fillColor: 'chart_colours['coupon_count'] ); ?>', fill: true, show: true, lineWidth: 0, barWidth: barwidth ); ?> * 0.5, align: 'center' }, shadowSize: 0, hoverable: false }, { - label: "", + label: "", data: order_data.order_discount_amounts, yaxis: 2, - color: 'chart_colours['discount_amount']; ?>', + color: 'chart_colours['discount_amount'] ); ?>', points: { show: true, radius: 5, lineWidth: 3, fillColor: '#fff', fill: true }, lines: { show: true, lineWidth: 4, fill: false }, shadowSize: 0, - get_currency_tooltip(); ?> + get_currency_tooltip(); ?> } ]; @@ -510,9 +525,9 @@ class WC_Report_Coupon_Usage extends WC_Admin_Report { tickColor: 'transparent', mode: "time", timeformat: "chart_groupby ) ? '%d %b' : '%b'; ?>", - monthNames: month_abbrev ) ) ?>, + monthNames: month_abbrev ) ); ?>, tickLength: 1, - minTickSize: [1, "chart_groupby; ?>"], + minTickSize: [1, "chart_groupby ); ?>"], font: { color: "#aaa" } diff --git a/includes/admin/reports/class-wc-report-customer-list.php b/includes/admin/reports/class-wc-report-customer-list.php index e01bedfe5e2..2e70569ceda 100644 --- a/includes/admin/reports/class-wc-report-customer-list.php +++ b/includes/admin/reports/class-wc-report-customer-list.php @@ -5,7 +5,7 @@ if ( ! defined( 'ABSPATH' ) ) { } if ( ! class_exists( 'WP_List_Table' ) ) { - require_once( ABSPATH . 'wp-admin/includes/class-wp-list-table.php' ); + require_once ABSPATH . 'wp-admin/includes/class-wp-list-table.php'; } /** @@ -23,11 +23,13 @@ class WC_Report_Customer_List extends WP_List_Table { */ public function __construct() { - parent::__construct( array( - 'singular' => 'customer', - 'plural' => 'customers', - 'ajax' => false, - ) ); + parent::__construct( + array( + 'singular' => 'customer', + 'plural' => 'customers', + 'ajax' => false, + ) + ); } /** @@ -74,24 +76,23 @@ class WC_Report_Customer_List extends WP_List_Table { * Get column value. * * @param WP_User $user - * @param string $column_name + * @param string $column_name * @return string */ public function column_default( $user, $column_name ) { switch ( $column_name ) { - case 'customer_name' : + case 'customer_name': if ( $user->last_name && $user->first_name ) { return $user->last_name . ', ' . $user->first_name; } else { return '-'; } - case 'username' : + case 'username': return $user->user_login; - case 'location' : - + case 'location': $state_code = get_user_meta( $user->ID, 'billing_state', true ); $country_code = get_user_meta( $user->ID, 'billing_country', true ); @@ -112,22 +113,23 @@ class WC_Report_Customer_List extends WP_List_Table { return '-'; } - case 'email' : + case 'email': return '' . $user->user_email . ''; - case 'spent' : + case 'spent': return wc_price( wc_get_customer_total_spent( $user->ID ) ); - case 'orders' : + case 'orders': return wc_get_customer_order_count( $user->ID ); - case 'last_order' : - - $orders = wc_get_orders( array( - 'limit' => 1, - 'status' => array_map( 'wc_get_order_status_name', wc_get_is_paid_statuses() ), - 'customer' => $user->ID, - ) ); + case 'last_order': + $orders = wc_get_orders( + array( + 'limit' => 1, + 'status' => array_map( 'wc_get_order_status_name', wc_get_is_paid_statuses() ), + 'customer' => $user->ID, + ) + ); if ( ! empty( $orders ) ) { $order = $orders[0]; @@ -136,57 +138,60 @@ class WC_Report_Customer_List extends WP_List_Table { return '-'; } - break; + break; - case 'user_actions' : + case 'wc_actions': ob_start(); ?>

          wp_nonce_url( add_query_arg( 'refresh', $user->ID ), 'refresh' ), - 'name' => __( 'Refresh stats', 'woocommerce' ), - 'action' => "refresh", + $actions['refresh'] = array( + 'url' => wp_nonce_url( add_query_arg( 'refresh', $user->ID ), 'refresh' ), + 'name' => __( 'Refresh stats', 'woocommerce' ), + 'action' => 'refresh', + ); + + $actions['edit'] = array( + 'url' => admin_url( 'user-edit.php?user_id=' . $user->ID ), + 'name' => __( 'Edit', 'woocommerce' ), + 'action' => 'edit', + ); + + $actions['view'] = array( + 'url' => admin_url( 'edit.php?post_type=shop_order&_customer_user=' . $user->ID ), + 'name' => __( 'View orders', 'woocommerce' ), + 'action' => 'view', + ); + + $orders = wc_get_orders( + array( + 'limit' => 1, + 'status' => array_map( 'wc_get_order_status_name', wc_get_is_paid_statuses() ), + 'customer' => array( array( 0, $user->user_email ) ), + ) + ); + + if ( $orders ) { + $actions['link'] = array( + 'url' => wp_nonce_url( add_query_arg( 'link_orders', $user->ID ), 'link_orders' ), + 'name' => __( 'Link previous orders', 'woocommerce' ), + 'action' => 'link', ); + } - $actions['edit'] = array( - 'url' => admin_url( 'user-edit.php?user_id=' . $user->ID ), - 'name' => __( 'Edit', 'woocommerce' ), - 'action' => "edit", - ); + $actions = apply_filters( 'woocommerce_admin_user_actions', $actions, $user ); - $actions['view'] = array( - 'url' => admin_url( 'edit.php?post_type=shop_order&_customer_user=' . $user->ID ), - 'name' => __( 'View orders', 'woocommerce' ), - 'action' => "view", - ); + foreach ( $actions as $action ) { + printf( '%s', esc_attr( $action['action'] ), esc_url( $action['url'] ), esc_attr( $action['name'] ), esc_attr( $action['name'] ) ); + } - $orders = wc_get_orders( array( - 'limit' => 1, - 'status' => array_map( 'wc_get_order_status_name', wc_get_is_paid_statuses() ), - 'customer' => array( array( 0, $user->user_email ) ), - ) ); - - if ( $orders ) { - $actions['link'] = array( - 'url' => wp_nonce_url( add_query_arg( 'link_orders', $user->ID ), 'link_orders' ), - 'name' => __( 'Link previous orders', 'woocommerce' ), - 'action' => "link", - ); - } - - $actions = apply_filters( 'woocommerce_admin_user_actions', $actions, $user ); - - foreach ( $actions as $action ) { - printf( '%s', esc_attr( $action['action'] ), esc_url( $action['url'] ), esc_attr( $action['name'] ), esc_attr( $action['name'] ) ); - } - - do_action( 'woocommerce_admin_user_actions_end', $user ); + do_action( 'woocommerce_admin_user_actions_end', $user ); ?> -

          + __( 'Name (Last, First)', 'woocommerce' ), - 'username' => __( 'Username', 'woocommerce' ), - 'email' => __( 'Email', 'woocommerce' ), - 'location' => __( 'Location', 'woocommerce' ), - 'orders' => __( 'Orders', 'woocommerce' ), - 'spent' => __( 'Money spent', 'woocommerce' ), - 'last_order' => __( 'Last order', 'woocommerce' ), - 'user_actions' => __( 'Actions', 'woocommerce' ), + 'customer_name' => __( 'Name (Last, First)', 'woocommerce' ), + 'username' => __( 'Username', 'woocommerce' ), + 'email' => __( 'Email', 'woocommerce' ), + 'location' => __( 'Location', 'woocommerce' ), + 'orders' => __( 'Orders', 'woocommerce' ), + 'spent' => __( 'Money spent', 'woocommerce' ), + 'last_order' => __( 'Last order', 'woocommerce' ), + 'wc_actions' => __( 'Actions', 'woocommerce' ), ); return $columns; @@ -228,14 +233,14 @@ class WC_Report_Customer_List extends WP_List_Table { $s = ! empty( $_REQUEST['s'] ) ? stripslashes( $_REQUEST['s'] ) : ''; - $query->query_from .= " LEFT JOIN {$wpdb->usermeta} as meta2 ON ({$wpdb->users}.ID = meta2.user_id) "; - $query->query_where .= " AND meta2.meta_key = 'last_name' "; - $query->query_orderby = " ORDER BY meta2.meta_value, user_login ASC "; + $query->query_from .= " LEFT JOIN {$wpdb->usermeta} as meta2 ON ({$wpdb->users}.ID = meta2.user_id) "; + $query->query_where .= " AND meta2.meta_key = 'last_name' "; + $query->query_orderby = ' ORDER BY meta2.meta_value, user_login ASC '; if ( $s ) { - $query->query_from .= " LEFT JOIN {$wpdb->usermeta} as meta3 ON ({$wpdb->users}.ID = meta3.user_id)"; - $query->query_where .= " AND ( user_login LIKE '%" . esc_sql( str_replace( '*', '', $s ) ) . "%' OR user_nicename LIKE '%" . esc_sql( str_replace( '*', '', $s ) ) . "%' OR meta3.meta_value LIKE '%" . esc_sql( str_replace( '*', '', $s ) ) . "%' ) "; - $query->query_orderby = " GROUP BY ID " . $query->query_orderby; + $query->query_from .= " LEFT JOIN {$wpdb->usermeta} as meta3 ON ({$wpdb->users}.ID = meta3.user_id)"; + $query->query_where .= " AND ( user_login LIKE '%" . esc_sql( str_replace( '*', '', $s ) ) . "%' OR user_nicename LIKE '%" . esc_sql( str_replace( '*', '', $s ) ) . "%' OR meta3.meta_value LIKE '%" . esc_sql( str_replace( '*', '', $s ) ) . "%' ) "; + $query->query_orderby = ' GROUP BY ID ' . $query->query_orderby; } return $query; @@ -260,7 +265,7 @@ class WC_Report_Customer_List extends WP_List_Table { */ $admin_users = new WP_User_Query( array( - 'role' => 'administrator1', + 'role' => 'administrator', 'fields' => 'ID', ) ); @@ -272,11 +277,13 @@ class WC_Report_Customer_List extends WP_List_Table { ) ); - $query = new WP_User_Query( array( - 'exclude' => array_merge( $admin_users->get_results(), $manager_users->get_results() ), - 'number' => $per_page, - 'offset' => ( $current_page - 1 ) * $per_page, - ) ); + $query = new WP_User_Query( + array( + 'exclude' => array_merge( $admin_users->get_results(), $manager_users->get_results() ), + 'number' => $per_page, + 'offset' => ( $current_page - 1 ) * $per_page, + ) + ); $this->items = $query->get_results(); @@ -285,10 +292,12 @@ class WC_Report_Customer_List extends WP_List_Table { /** * Pagination. */ - $this->set_pagination_args( array( - 'total_items' => $query->total_users, - 'per_page' => $per_page, - 'total_pages' => ceil( $query->total_users / $per_page ), - ) ); + $this->set_pagination_args( + array( + 'total_items' => $query->total_users, + 'per_page' => $per_page, + 'total_pages' => ceil( $query->total_users / $per_page ), + ) + ); } } diff --git a/includes/admin/reports/class-wc-report-customers.php b/includes/admin/reports/class-wc-report-customers.php index 2386e9dd326..326ad5334f5 100644 --- a/includes/admin/reports/class-wc-report-customers.php +++ b/includes/admin/reports/class-wc-report-customers.php @@ -1,14 +1,17 @@ sprintf( __( '%s signups in this period', 'woocommerce' ), '' . sizeof( $this->customers ) . '' ), - 'color' => $this->chart_colours['signups'], + 'title' => sprintf( __( '%s signups in this period', 'woocommerce' ), '' . count( $this->customers ) . '' ), + 'color' => $this->chart_colours['signups'], 'highlight_series' => 2, ); @@ -66,64 +69,78 @@ class WC_Report_Customers extends WC_Admin_Report { * Output customers vs guests chart. */ public function customers_vs_guests() { - - $customer_order_totals = $this->get_order_report_data( array( - 'data' => array( + $customer_args = array( + 'data' => array( 'ID' => array( 'type' => 'post_data', 'function' => 'COUNT', 'name' => 'total_orders', ), ), - 'where_meta' => array( + 'filter_range' => true, + ); + $guest_args = $customer_args; + + // On WC 3.5.0 the ID of the user that placed the order was moved from the post meta _customer_user to the post_author field in the wp_posts table. + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '>=' ) ) { + $customer_args['where'] = array( + array( + 'key' => 'post_author', + 'value' => '0', + 'operator' => '>', + ), + ); + + $guest_args['where'] = array( + array( + 'key' => 'post_author', + 'value' => '0', + 'operator' => '=', + ), + ); + } else { + $customer_args['where_meta'] = array( array( 'meta_key' => '_customer_user', 'meta_value' => '0', 'operator' => '>', ), - ), - 'filter_range' => true, - ) ); + ); - $guest_order_totals = $this->get_order_report_data( array( - 'data' => array( - 'ID' => array( - 'type' => 'post_data', - 'function' => 'COUNT', - 'name' => 'total_orders', - ), - ), - 'where_meta' => array( + $guest_args['where_meta'] = array( array( 'meta_key' => '_customer_user', 'meta_value' => '0', 'operator' => '=', ), - ), - 'filter_range' => true, - ) ); + ); + } + + $customer_order_totals = $this->get_order_report_data( $customer_args ); + $guest_order_totals = $this->get_order_report_data( $guest_args ); + ?>
            -
            • -
            • +
            • +
          + report_data = new stdClass; + $this->report_data = new stdClass(); - $this->report_data->order_counts = (array) $this->get_order_report_data( array( - 'data' => array( - 'ID' => array( - 'type' => 'post_data', - 'function' => 'COUNT', - 'name' => 'count', - 'distinct' => true, + $this->report_data->order_counts = (array) $this->get_order_report_data( + array( + 'data' => array( + 'ID' => array( + 'type' => 'post_data', + 'function' => 'COUNT', + 'name' => 'count', + 'distinct' => true, + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', - ), - ), - 'group_by' => $this->group_by_query, - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_types' => wc_get_order_types( 'order-count' ), - 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), - ) ); + 'group_by' => $this->group_by_query, + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_types' => wc_get_order_types( 'order-count' ), + 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), + ) + ); - $this->report_data->coupons = (array) $this->get_order_report_data( array( - 'data' => array( - 'order_item_name' => array( - 'type' => 'order_item', - 'function' => '', - 'name' => 'order_item_name', + $this->report_data->coupons = (array) $this->get_order_report_data( + array( + 'data' => array( + 'order_item_name' => array( + 'type' => 'order_item', + 'function' => '', + 'name' => 'order_item_name', + ), + 'discount_amount' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'coupon', + 'function' => 'SUM', + 'name' => 'discount_amount', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), ), - 'discount_amount' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'coupon', - 'function' => 'SUM', - 'name' => 'discount_amount', + 'where' => array( + array( + 'key' => 'order_items.order_item_type', + 'value' => 'coupon', + 'operator' => '=', + ), ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', - ), - ), - 'where' => array( - array( - 'key' => 'order_items.order_item_type', - 'value' => 'coupon', - 'operator' => '=', - ), - ), - 'group_by' => $this->group_by_query . ', order_item_name', - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_types' => wc_get_order_types( 'order-count' ), - 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), - ) ); + 'group_by' => $this->group_by_query . ', order_item_name', + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_types' => wc_get_order_types( 'order-count' ), + 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), + ) + ); // All items from orders - even those refunded - $this->report_data->order_items = (array) $this->get_order_report_data( array( - 'data' => array( - '_qty' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_count', + $this->report_data->order_items = (array) $this->get_order_report_data( + array( + 'data' => array( + '_qty' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_count', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', + 'where' => array( + array( + 'key' => 'order_items.order_item_type', + 'value' => 'line_item', + 'operator' => '=', + ), ), - ), - 'where' => array( - array( - 'key' => 'order_items.order_item_type', - 'value' => 'line_item', - 'operator' => '=', - ), - ), - 'group_by' => $this->group_by_query, - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_types' => wc_get_order_types( 'order-count' ), - 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), - ) ); + 'group_by' => $this->group_by_query, + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_types' => wc_get_order_types( 'order-count' ), + 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), + ) + ); /** * Get total of fully refunded items. */ - $this->report_data->refunded_order_items = absint( $this->get_order_report_data( array( - 'data' => array( - '_qty' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_count', - ), - ), - 'where' => array( + $this->report_data->refunded_order_items = absint( + $this->get_order_report_data( array( - 'key' => 'order_items.order_item_type', - 'value' => 'line_item', - 'operator' => '=', - ), - ), - 'query_type' => 'get_var', - 'filter_range' => true, - 'order_types' => wc_get_order_types( 'order-count' ), - 'order_status' => array( 'refunded' ), - ) ) ); + 'data' => array( + '_qty' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_count', + ), + ), + 'where' => array( + array( + 'key' => 'order_items.order_item_type', + 'value' => 'line_item', + 'operator' => '=', + ), + ), + 'query_type' => 'get_var', + 'filter_range' => true, + 'order_types' => wc_get_order_types( 'order-count' ), + 'order_status' => array( 'refunded' ), + ) + ) + ); /** * Order totals by date. Charts should show GROSS amounts to avoid going -ve. */ - $this->report_data->orders = (array) $this->get_order_report_data( array( - 'data' => array( - '_order_total' => array( - 'type' => 'meta', - 'function' => 'SUM', - 'name' => 'total_sales', + $this->report_data->orders = (array) $this->get_order_report_data( + array( + 'data' => array( + '_order_total' => array( + 'type' => 'meta', + 'function' => 'SUM', + 'name' => 'total_sales', + ), + '_order_shipping' => array( + 'type' => 'meta', + 'function' => 'SUM', + 'name' => 'total_shipping', + ), + '_order_tax' => array( + 'type' => 'meta', + 'function' => 'SUM', + 'name' => 'total_tax', + ), + '_order_shipping_tax' => array( + 'type' => 'meta', + 'function' => 'SUM', + 'name' => 'total_shipping_tax', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), ), - '_order_shipping' => array( - 'type' => 'meta', - 'function' => 'SUM', - 'name' => 'total_shipping', - ), - '_order_tax' => array( - 'type' => 'meta', - 'function' => 'SUM', - 'name' => 'total_tax', - ), - '_order_shipping_tax' => array( - 'type' => 'meta', - 'function' => 'SUM', - 'name' => 'total_shipping_tax', - ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', - ), - ), - 'group_by' => $this->group_by_query, - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_types' => wc_get_order_types( 'sales-reports' ), - 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), - ) ); + 'group_by' => $this->group_by_query, + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_types' => wc_get_order_types( 'sales-reports' ), + 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), + ) + ); /** * If an order is 100% refunded we should look at the parent's totals, but the refunds dates. * We also need to ensure each parent order's values are only counted/summed once. */ - $this->report_data->full_refunds = (array) $this->get_order_report_data( array( - 'data' => array( - '_order_total' => array( - 'type' => 'parent_meta', - 'function' => '', - 'name' => 'total_refund', + $this->report_data->full_refunds = (array) $this->get_order_report_data( + array( + 'data' => array( + '_order_total' => array( + 'type' => 'parent_meta', + 'function' => '', + 'name' => 'total_refund', + ), + '_order_shipping' => array( + 'type' => 'parent_meta', + 'function' => '', + 'name' => 'total_shipping', + ), + '_order_tax' => array( + 'type' => 'parent_meta', + 'function' => '', + 'name' => 'total_tax', + ), + '_order_shipping_tax' => array( + 'type' => 'parent_meta', + 'function' => '', + 'name' => 'total_shipping_tax', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), ), - '_order_shipping' => array( - 'type' => 'parent_meta', - 'function' => '', - 'name' => 'total_shipping', - ), - '_order_tax' => array( - 'type' => 'parent_meta', - 'function' => '', - 'name' => 'total_tax', - ), - '_order_shipping_tax' => array( - 'type' => 'parent_meta', - 'function' => '', - 'name' => 'total_shipping_tax', - ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', - ), - ), - 'group_by' => 'posts.post_parent', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_status' => false, - 'parent_order_status' => array( 'refunded' ), - ) ); + 'group_by' => 'posts.post_parent', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_status' => false, + 'parent_order_status' => array( 'refunded' ), + ) + ); /** * Partial refunds. This includes line items, shipping and taxes. Not grouped by date. */ - $this->report_data->partial_refunds = (array) $this->get_order_report_data( array( - 'data' => array( - 'ID' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'refund_id', + $this->report_data->partial_refunds = (array) $this->get_order_report_data( + array( + 'data' => array( + 'ID' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'refund_id', + ), + '_refund_amount' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_refund', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), + 'order_item_type' => array( + 'type' => 'order_item', + 'function' => '', + 'name' => 'item_type', + 'join_type' => 'LEFT', + ), + '_order_total' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_sales', + ), + '_order_shipping' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_shipping', + 'join_type' => 'LEFT', + ), + '_order_tax' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_tax', + 'join_type' => 'LEFT', + ), + '_order_shipping_tax' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_shipping_tax', + 'join_type' => 'LEFT', + ), + '_qty' => array( + 'type' => 'order_item_meta', + 'function' => 'SUM', + 'name' => 'order_item_count', + 'join_type' => 'LEFT', + ), ), - '_refund_amount' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_refund', - ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', - ), - 'order_item_type' => array( - 'type' => 'order_item', - 'function' => '', - 'name' => 'item_type', - 'join_type' => 'LEFT', - ), - '_order_total' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_sales', - ), - '_order_shipping' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_shipping', - 'join_type' => 'LEFT', - ), - '_order_tax' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_tax', - 'join_type' => 'LEFT', - ), - '_order_shipping_tax' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_shipping_tax', - 'join_type' => 'LEFT', - ), - '_qty' => array( - 'type' => 'order_item_meta', - 'function' => 'SUM', - 'name' => 'order_item_count', - 'join_type' => 'LEFT', - ), - ), - 'group_by' => 'refund_id', - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_status' => false, - 'parent_order_status' => array( 'completed', 'processing', 'on-hold' ), - ) ); + 'group_by' => 'refund_id', + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_status' => false, + 'parent_order_status' => array( 'completed', 'processing', 'on-hold' ), + ) + ); /** * Refund lines - all partial refunds on all order types so we can plot full AND partial refunds on the chart. */ - $this->report_data->refund_lines = (array) $this->get_order_report_data( array( - 'data' => array( - 'ID' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'refund_id', + $this->report_data->refund_lines = (array) $this->get_order_report_data( + array( + 'data' => array( + 'ID' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'refund_id', + ), + '_refund_amount' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_refund', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), + 'order_item_type' => array( + 'type' => 'order_item', + 'function' => '', + 'name' => 'item_type', + 'join_type' => 'LEFT', + ), + '_order_total' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_sales', + ), + '_order_shipping' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_shipping', + 'join_type' => 'LEFT', + ), + '_order_tax' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_tax', + 'join_type' => 'LEFT', + ), + '_order_shipping_tax' => array( + 'type' => 'meta', + 'function' => '', + 'name' => 'total_shipping_tax', + 'join_type' => 'LEFT', + ), + '_qty' => array( + 'type' => 'order_item_meta', + 'function' => 'SUM', + 'name' => 'order_item_count', + 'join_type' => 'LEFT', + ), ), - '_refund_amount' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_refund', - ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', - ), - 'order_item_type' => array( - 'type' => 'order_item', - 'function' => '', - 'name' => 'item_type', - 'join_type' => 'LEFT', - ), - '_order_total' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_sales', - ), - '_order_shipping' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_shipping', - 'join_type' => 'LEFT', - ), - '_order_tax' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_tax', - 'join_type' => 'LEFT', - ), - '_order_shipping_tax' => array( - 'type' => 'meta', - 'function' => '', - 'name' => 'total_shipping_tax', - 'join_type' => 'LEFT', - ), - '_qty' => array( - 'type' => 'order_item_meta', - 'function' => 'SUM', - 'name' => 'order_item_count', - 'join_type' => 'LEFT', - ), - ), - 'group_by' => 'refund_id', - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_status' => false, - 'parent_order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), - ) ); + 'group_by' => 'refund_id', + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_status' => false, + 'parent_order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), + ) + ); /** * Total up refunds. Note: when an order is fully refunded, a refund line will be added. @@ -373,14 +392,14 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { $refunded_orders = array_merge( $this->report_data->partial_refunds, $this->report_data->full_refunds ); foreach ( $refunded_orders as $key => $value ) { - $this->report_data->total_tax_refunded += ( $value->total_tax < 0 ? $value->total_tax * -1 : $value->total_tax ); - $this->report_data->total_refunds += $value->total_refund; - $this->report_data->total_shipping_tax_refunded += ( $value->total_shipping_tax < 0 ? $value->total_shipping_tax * -1 : $value->total_shipping_tax ); - $this->report_data->total_shipping_refunded += ( $value->total_shipping < 0 ? $value->total_shipping * -1 : $value->total_shipping ); + $this->report_data->total_tax_refunded += floatval( $value->total_tax < 0 ? $value->total_tax * -1 : $value->total_tax ); + $this->report_data->total_refunds += floatval( $value->total_refund ); + $this->report_data->total_shipping_tax_refunded += floatval( $value->total_shipping_tax < 0 ? $value->total_shipping_tax * -1 : $value->total_shipping_tax ); + $this->report_data->total_shipping_refunded += floatval( $value->total_shipping < 0 ? $value->total_shipping * -1 : $value->total_shipping ); // Only applies to parial. if ( isset( $value->order_item_count ) ) { - $this->report_data->refunded_order_items += ( $value->order_item_count < 0 ? $value->order_item_count * -1 : $value->order_item_count ); + $this->report_data->refunded_order_items += floatval( $value->order_item_count < 0 ? $value->order_item_count * -1 : $value->order_item_count ); } } @@ -391,7 +410,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { // Total the refunds and sales amounts. Sales subract refunds. Note - total_sales also includes shipping costs. $this->report_data->total_sales = wc_format_decimal( array_sum( wp_list_pluck( $this->report_data->orders, 'total_sales' ) ) - $this->report_data->total_refunds, 2 ); - $this->report_data->net_sales = wc_format_decimal( $this->report_data->total_sales - $this->report_data->total_shipping - $this->report_data->total_tax - $this->report_data->total_shipping_tax, 2 ); + $this->report_data->net_sales = wc_format_decimal( $this->report_data->total_sales - $this->report_data->total_shipping - max( 0, $this->report_data->total_tax ) - max( 0, $this->report_data->total_shipping_tax ), 2 ); // Calculate average based on net $this->report_data->average_sales = wc_format_decimal( $this->report_data->net_sales / ( $this->chart_interval + 1 ), 2 ); @@ -402,7 +421,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { $this->report_data->total_refunded_orders = absint( count( $this->report_data->full_refunds ) ); // Total orders in this period, even if refunded. - $this->report_data->total_orders = absint( array_sum( wp_list_pluck( $this->report_data->order_counts, 'count' ) ) ); + $this->report_data->total_orders = absint( array_sum( wp_list_pluck( $this->report_data->order_counts, 'count' ) ) ); // Item items ordered in this period, even if refunded. $this->report_data->total_items = absint( array_sum( wp_list_pluck( $this->report_data->order_items, 'order_item_count' ) ) ); @@ -413,6 +432,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { /** * Get the legend for the main chart sidebar. + * * @return array */ public function get_chart_legend() { @@ -420,7 +440,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { $data = $this->get_report_data(); switch ( $this->chart_groupby ) { - case 'day' : + case 'day': /* translators: %s: average total sales */ $average_total_sales_title = sprintf( __( '%s average gross daily sales', 'woocommerce' ), @@ -431,9 +451,9 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { __( '%s average net daily sales', 'woocommerce' ), '' . wc_price( $data->average_sales ) . '' ); - break; - case 'month' : - default : + break; + case 'month': + default: /* translators: %s: average total sales */ $average_total_sales_title = sprintf( __( '%s average gross monthly sales', 'woocommerce' ), @@ -444,12 +464,12 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { __( '%s average net monthly sales', 'woocommerce' ), '' . wc_price( $data->average_sales ) . '' ); - break; + break; } $legend[] = array( /* translators: %s: total sales */ - 'title' => sprintf( + 'title' => sprintf( __( '%s gross sales in this period', 'woocommerce' ), '' . wc_price( $data->total_sales ) . '' ), @@ -459,15 +479,15 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { ); if ( $data->average_total_sales > 0 ) { $legend[] = array( - 'title' => $average_total_sales_title, - 'color' => $this->chart_colours['average'], + 'title' => $average_total_sales_title, + 'color' => $this->chart_colours['average'], 'highlight_series' => 2, ); } $legend[] = array( /* translators: %s: net sales */ - 'title' => sprintf( + 'title' => sprintf( __( '%s net sales in this period', 'woocommerce' ), '' . wc_price( $data->net_sales ) . '' ), @@ -477,58 +497,58 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { ); if ( $data->average_sales > 0 ) { $legend[] = array( - 'title' => $average_sales_title, - 'color' => $this->chart_colours['net_average'], + 'title' => $average_sales_title, + 'color' => $this->chart_colours['net_average'], 'highlight_series' => 3, ); } $legend[] = array( /* translators: %s: total orders */ - 'title' => sprintf( + 'title' => sprintf( __( '%s orders placed', 'woocommerce' ), '' . $data->total_orders . '' ), - 'color' => $this->chart_colours['order_count'], + 'color' => $this->chart_colours['order_count'], 'highlight_series' => 1, ); $legend[] = array( /* translators: %s: total items */ - 'title' => sprintf( + 'title' => sprintf( __( '%s items purchased', 'woocommerce' ), '' . $data->total_items . '' ), - 'color' => $this->chart_colours['item_count'], + 'color' => $this->chart_colours['item_count'], 'highlight_series' => 0, ); $legend[] = array( /* translators: 1: total refunds 2: total refunded orders 3: refunded items */ - 'title' => sprintf( + 'title' => sprintf( _n( '%1$s refunded %2$d order (%3$d item)', '%1$s refunded %2$d orders (%3$d items)', $this->report_data->total_refunded_orders, 'woocommerce' ), '' . wc_price( $data->total_refunds ) . '', $this->report_data->total_refunded_orders, $this->report_data->refunded_order_items ), - 'color' => $this->chart_colours['refund_amount'], + 'color' => $this->chart_colours['refund_amount'], 'highlight_series' => 8, ); $legend[] = array( /* translators: %s: total shipping */ - 'title' => sprintf( + 'title' => sprintf( __( '%s charged for shipping', 'woocommerce' ), '' . wc_price( $data->total_shipping ) . '' ), - 'color' => $this->chart_colours['shipping_amount'], + 'color' => $this->chart_colours['shipping_amount'], 'highlight_series' => 5, ); $legend[] = array( /* translators: %s: total coupons */ - 'title' => sprintf( + 'title' => sprintf( __( '%s worth of coupons used', 'woocommerce' ), '' . wc_price( $data->total_coupons ) . '' ), - 'color' => $this->chart_colours['coupon_amount'], + 'color' => $this->chart_colours['coupon_amount'], 'highlight_series' => 4, ); @@ -540,10 +560,10 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { */ public function output_report() { $ranges = array( - 'year' => __( 'Year', 'woocommerce' ), - 'last_month' => __( 'Last month', 'woocommerce' ), - 'month' => __( 'This month', 'woocommerce' ), - '7day' => __( 'Last 7 days', 'woocommerce' ), + 'year' => __( 'Year', 'woocommerce' ), + 'last_month' => __( 'Last month', 'woocommerce' ), + 'month' => __( 'This month', 'woocommerce' ), + '7day' => __( 'Last 7 days', 'woocommerce' ), ); $this->chart_colours = array( @@ -567,7 +587,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { $this->check_current_range_nonce( $current_range ); $this->calculate_current_range( $current_range ); - include( WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php' ); + include WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php'; } /** @@ -607,8 +627,6 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { /** * Get the main chart. - * - * @return string */ public function get_main_chart() { global $wp_locale; @@ -628,10 +646,10 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { ); foreach ( $data['order_amounts'] as $order_amount_key => $order_amount_value ) { - $data['gross_order_amounts'][ $order_amount_key ] = $order_amount_value; + $data['gross_order_amounts'][ $order_amount_key ] = $order_amount_value; $data['gross_order_amounts'][ $order_amount_key ][1] -= $data['refund_amounts'][ $order_amount_key ][1]; - $data['net_order_amounts'][ $order_amount_key ] = $order_amount_value; + $data['net_order_amounts'][ $order_amount_key ] = $order_amount_value; // subtract the sum of the values from net order amounts $data['net_order_amounts'][ $order_amount_key ][1] -= $data['refund_amounts'][ $order_amount_key ][1] + @@ -644,16 +662,18 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { $data = apply_filters( 'woocommerce_admin_report_chart_data', $data ); // Encode in json format - $chart_data = json_encode( array( - 'order_counts' => array_values( $data['order_counts'] ), - 'order_item_counts' => array_values( $data['order_item_counts'] ), - 'order_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['order_amounts'] ) ), - 'gross_order_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['gross_order_amounts'] ) ), - 'net_order_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['net_order_amounts'] ) ), - 'shipping_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['shipping_amounts'] ) ), - 'coupon_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['coupon_amounts'] ) ), - 'refund_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['refund_amounts'] ) ), - ) ); + $chart_data = json_encode( + array( + 'order_counts' => array_values( $data['order_counts'] ), + 'order_item_counts' => array_values( $data['order_item_counts'] ), + 'order_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['order_amounts'] ) ), + 'gross_order_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['gross_order_amounts'] ) ), + 'net_order_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['net_order_amounts'] ) ), + 'shipping_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['shipping_amounts'] ) ), + 'coupon_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['coupon_amounts'] ) ), + 'refund_amounts' => array_map( array( $this, 'round_chart_totals' ), array_values( $data['refund_amounts'] ) ), + ) + ); ?>
          @@ -667,7 +687,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { var drawGraph = function( highlight ) { var series = [ { - label: "", + label: "", data: order_data.order_item_counts, color: 'chart_colours['item_count']; ?>', bars: { fillColor: 'chart_colours['item_count']; ?>', fill: true, show: true, lineWidth: 0, barWidth: barwidth; ?> * 0.5, align: 'center' }, @@ -675,7 +695,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { hoverable: false }, { - label: "", + label: "", data: order_data.order_counts, color: 'chart_colours['order_count']; ?>', bars: { fillColor: 'chart_colours['order_count']; ?>', fill: true, show: true, lineWidth: 0, barWidth: barwidth; ?> * 0.5, align: 'center' }, @@ -683,7 +703,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { hoverable: false }, { - label: "", + label: "", data: [ [ , report_data->average_total_sales; ?> ], [ , report_data->average_total_sales; ?> ] ], yaxis: 2, color: 'chart_colours['average']; ?>', @@ -693,7 +713,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { hoverable: false }, { - label: "", + label: "", data: [ [ , report_data->average_sales; ?> ], [ , report_data->average_sales; ?> ] ], yaxis: 2, color: 'chart_colours['net_average']; ?>', @@ -703,7 +723,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { hoverable: false }, { - label: "", + label: "", data: order_data.coupon_amounts, yaxis: 2, color: 'chart_colours['coupon_amount']; ?>', @@ -713,7 +733,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { get_currency_tooltip(); ?> }, { - label: "", + label: "", data: order_data.shipping_amounts, yaxis: 2, color: 'chart_colours['shipping_amount']; ?>', @@ -723,7 +743,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { prepend_tooltip: "" }, { - label: "", + label: "", data: order_data.gross_order_amounts, yaxis: 2, color: 'chart_colours['sales_amount']; ?>', @@ -733,7 +753,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { get_currency_tooltip(); ?> }, { - label: "", + label: "", data: order_data.net_order_amounts, yaxis: 2, color: 'chart_colours['net_sales_amount']; ?>', @@ -743,7 +763,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { get_currency_tooltip(); ?> }, { - label: "", + label: "", data: order_data.refund_amounts, yaxis: 2, color: 'chart_colours['refund_amount']; ?>', @@ -787,7 +807,7 @@ class WC_Report_Sales_By_Date extends WC_Admin_Report { tickColor: 'transparent', mode: "time", timeformat: "chart_groupby ) ? '%d %b' : '%b'; ?>", - monthNames: month_abbrev ) ) ?>, + monthNames: month_abbrev ) ); ?>, tickLength: 1, minTickSize: [1, "chart_groupby; ?>"], font: { diff --git a/includes/admin/reports/class-wc-report-sales-by-product.php b/includes/admin/reports/class-wc-report-sales-by-product.php index 95858057158..ddd2303b9c6 100644 --- a/includes/admin/reports/class-wc-report-sales-by-product.php +++ b/includes/admin/reports/class-wc-report-sales-by-product.php @@ -1,7 +1,12 @@ get_order_report_data( array( - 'data' => array( - '_line_total' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_amount', + $total_sales = $this->get_order_report_data( + array( + 'data' => array( + '_line_total' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_amount', + ), ), - ), - 'where_meta' => array( - 'relation' => 'OR', - array( - 'type' => 'order_item_meta', - 'meta_key' => array( '_product_id', '_variation_id' ), - 'meta_value' => $this->product_ids, - 'operator' => 'IN', - ) - ), - 'query_type' => 'get_var', - 'filter_range' => true, - ) ); + 'where_meta' => array( + 'relation' => 'OR', + array( + 'type' => 'order_item_meta', + 'meta_key' => array( '_product_id', '_variation_id' ), + 'meta_value' => $this->product_ids, + 'operator' => 'IN', + ), + ), + 'query_type' => 'get_var', + 'filter_range' => true, + ) + ); - $total_items = absint( $this->get_order_report_data( array( - 'data' => array( - '_qty' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_count', - ), - ), - 'where_meta' => array( - 'relation' => 'OR', + $total_items = absint( + $this->get_order_report_data( array( - 'type' => 'order_item_meta', - 'meta_key' => array( '_product_id', '_variation_id' ), - 'meta_value' => $this->product_ids, - 'operator' => 'IN', + 'data' => array( + '_qty' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_count', + ), + ), + 'where_meta' => array( + 'relation' => 'OR', + array( + 'type' => 'order_item_meta', + 'meta_key' => array( '_product_id', '_variation_id' ), + 'meta_value' => $this->product_ids, + 'operator' => 'IN', + ), + ), + 'query_type' => 'get_var', + 'filter_range' => true, ) - ), - 'query_type' => 'get_var', - 'filter_range' => true, - ) ) ); + ) + ); $legend[] = array( /* translators: %s: total items sold */ - 'title' => sprintf( __( '%s sales for the selected items', 'woocommerce' ), '' . wc_price( $total_sales ) . '' ), - 'color' => $this->chart_colours['sales_amount'], + 'title' => sprintf( __( '%s sales for the selected items', 'woocommerce' ), '' . wc_price( $total_sales ) . '' ), + 'color' => $this->chart_colours['sales_amount'], 'highlight_series' => 1, ); $legend[] = array( /* translators: %s: total items purchased */ - 'title' => sprintf( __( '%s purchases for the selected items', 'woocommerce' ), '' . ( $total_items ) . '' ), - 'color' => $this->chart_colours['item_count'], + 'title' => sprintf( __( '%s purchases for the selected items', 'woocommerce' ), '' . ( $total_items ) . '' ), + 'color' => $this->chart_colours['item_count'], 'highlight_series' => 0, ); @@ -125,10 +137,10 @@ class WC_Report_Sales_By_Product extends WC_Admin_Report { public function output_report() { $ranges = array( - 'year' => __( 'Year', 'woocommerce' ), - 'last_month' => __( 'Last month', 'woocommerce' ), - 'month' => __( 'This month', 'woocommerce' ), - '7day' => __( 'Last 7 days', 'woocommerce' ), + 'year' => __( 'Year', 'woocommerce' ), + 'last_month' => __( 'Last month', 'woocommerce' ), + 'month' => __( 'This month', 'woocommerce' ), + '7day' => __( 'Last 7 days', 'woocommerce' ), ); $this->chart_colours = array( @@ -136,7 +148,7 @@ class WC_Report_Sales_By_Product extends WC_Admin_Report { 'item_count' => '#d4d9dc', ); - $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( $_GET['range'] ) : '7day'; + $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( wp_unslash( $_GET['range'] ) ) : '7day'; if ( ! in_array( $current_range, array( 'custom', 'year', 'last_month', 'month', '7day' ) ) ) { $current_range = '7day'; @@ -145,7 +157,7 @@ class WC_Report_Sales_By_Product extends WC_Admin_Report { $this->check_current_range_nonce( $current_range ); $this->calculate_current_range( $current_range ); - include( WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php' ); + include WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php'; } /** @@ -190,8 +202,8 @@ class WC_Report_Sales_By_Product extends WC_Admin_Report { } } - echo '

          ' . ' ' . esc_html( implode( ', ', $this->product_ids_titles ) ) . '

          '; - echo '

          ' . __( 'Reset', 'woocommerce' ) . '

          '; + echo '

          ' . wp_kses_post( implode( ', ', $this->product_ids_titles ) ) . '

          '; + echo '

          ' . esc_html__( 'Reset', 'woocommerce' ) . '

          '; } /** @@ -199,12 +211,13 @@ class WC_Report_Sales_By_Product extends WC_Admin_Report { */ public function products_widget() { ?> -

          +

          + - + @@ -212,133 +225,146 @@ class WC_Report_Sales_By_Product extends WC_Admin_Report { +
          -

          +

          get_order_report_data( array( - 'data' => array( - '_product_id' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => '', - 'name' => 'product_id', + $top_sellers = $this->get_order_report_data( + array( + 'data' => array( + '_product_id' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => '', + 'name' => 'product_id', + ), + '_qty' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_qty', + ), ), - '_qty' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_qty', - ), - ), - 'order_by' => 'order_item_qty DESC', - 'group_by' => 'product_id', - 'limit' => 12, - 'query_type' => 'get_results', - 'filter_range' => true, - ) ); + 'order_by' => 'order_item_qty DESC', + 'group_by' => 'product_id', + 'limit' => 12, + 'query_type' => 'get_results', + 'filter_range' => true, + ) + ); if ( $top_sellers ) { + // @codingStandardsIgnoreStart foreach ( $top_sellers as $product ) { echo ' - - + + '; } + // @codingStandardsIgnoreEnd } else { - echo ''; + echo ''; } ?>
          ' . $product->order_item_qty . '' . get_the_title( $product->product_id ) . '' . esc_html( $product->order_item_qty ) . '' . esc_html( get_the_title( $product->product_id ) ) . ' ' . $this->sales_sparkline( $product->product_id, 7, 'count' ) . '
          ' . __( 'No products found in range', 'woocommerce' ) . '
          ' . esc_html__( 'No products found in range', 'woocommerce' ) . '
          -

          +

          get_order_report_data( array( - 'data' => array( - '_product_id' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => '', - 'name' => 'product_id', + $top_freebies = $this->get_order_report_data( + array( + 'data' => array( + '_product_id' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => '', + 'name' => 'product_id', + ), + '_qty' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_qty', + ), ), - '_qty' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_qty', + 'where_meta' => array( + array( + 'type' => 'order_item_meta', + 'meta_key' => '_line_subtotal', + 'meta_value' => '0', + 'operator' => '=', + ), ), - ), - 'where_meta' => array( - array( - 'type' => 'order_item_meta', - 'meta_key' => '_line_subtotal', - 'meta_value' => '0', - 'operator' => '=', - ), - ), - 'order_by' => 'order_item_qty DESC', - 'group_by' => 'product_id', - 'limit' => 12, - 'query_type' => 'get_results', - 'filter_range' => true, - ) ); + 'order_by' => 'order_item_qty DESC', + 'group_by' => 'product_id', + 'limit' => 12, + 'query_type' => 'get_results', + 'filter_range' => true, + ) + ); if ( $top_freebies ) { + // @codingStandardsIgnoreStart foreach ( $top_freebies as $product ) { echo ' - - + + '; } + // @codingStandardsIgnoreEnd } else { - echo ''; + echo ''; } ?>
          ' . $product->order_item_qty . '' . get_the_title( $product->product_id ) . '' . esc_html( $product->order_item_qty ) . '' . esc_html( get_the_title( $product->product_id ) ) . ' ' . $this->sales_sparkline( $product->product_id, 7, 'count' ) . '
          ' . __( 'No products found in range', 'woocommerce' ) . '
          ' . esc_html__( 'No products found in range', 'woocommerce' ) . '
          -

          +

          get_order_report_data( array( - 'data' => array( - '_product_id' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => '', - 'name' => 'product_id', + $top_earners = $this->get_order_report_data( + array( + 'data' => array( + '_product_id' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => '', + 'name' => 'product_id', + ), + '_line_total' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_total', + ), ), - '_line_total' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_total', - ), - ), - 'order_by' => 'order_item_total DESC', - 'group_by' => 'product_id', - 'limit' => 12, - 'query_type' => 'get_results', - 'filter_range' => true, - ) ); + 'order_by' => 'order_item_total DESC', + 'group_by' => 'product_id', + 'limit' => 12, + 'query_type' => 'get_results', + 'filter_range' => true, + ) + ); if ( $top_earners ) { + // @codingStandardsIgnoreStart foreach ( $top_earners as $product ) { echo ' - + '; } + // @codingStandardsIgnoreEnd } else { - echo ''; + echo ''; } ?>
          ' . wc_price( $product->order_item_total ) . '' . get_the_title( $product->product_id ) . '' . esc_html( get_the_title( $product->product_id ) ) . ' ' . $this->sales_sparkline( $product->product_id, 7, 'sales' ) . '
          ' . __( 'No products found in range', 'woocommerce' ) . '
          ' . esc_html__( 'No products found in range', 'woocommerce' ) . '
          @@ -370,25 +396,23 @@ class WC_Report_Sales_By_Product extends WC_Admin_Report { */ public function get_export_button() { - $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( $_GET['range'] ) : '7day'; + $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( wp_unslash( $_GET['range'] ) ) : '7day'; ?> > - + product_ids ) ) { ?>
          -

          +

          get_order_report_data( array( - 'data' => array( - '_qty' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_count', + // Get orders and dates in range - we want the SUM of order totals, COUNT of order items, COUNT of orders, and the date. + $order_item_counts = $this->get_order_report_data( + array( + 'data' => array( + '_qty' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_count', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), + '_product_id' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => '', + 'name' => 'product_id', + ), ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', + 'where_meta' => array( + 'relation' => 'OR', + array( + 'type' => 'order_item_meta', + 'meta_key' => array( '_product_id', '_variation_id' ), + 'meta_value' => $this->product_ids, + 'operator' => 'IN', + ), ), - '_product_id' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => '', - 'name' => 'product_id', - ), - ), - 'where_meta' => array( - 'relation' => 'OR', - array( - 'type' => 'order_item_meta', - 'meta_key' => array( '_product_id', '_variation_id' ), - 'meta_value' => $this->product_ids, - 'operator' => 'IN', - ), - ), - 'group_by' => 'product_id,' . $this->group_by_query, - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - ) ); + 'group_by' => 'product_id,' . $this->group_by_query, + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + ) + ); - $order_item_amounts = $this->get_order_report_data( array( - 'data' => array( - '_line_total' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => 'SUM', - 'name' => 'order_item_amount', + $order_item_amounts = $this->get_order_report_data( + array( + 'data' => array( + '_line_total' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => 'SUM', + 'name' => 'order_item_amount', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), + '_product_id' => array( + 'type' => 'order_item_meta', + 'order_item_type' => 'line_item', + 'function' => '', + 'name' => 'product_id', + ), ), - 'post_date' => array( - 'type' => 'post_data', - 'function' => '', - 'name' => 'post_date', + 'where_meta' => array( + 'relation' => 'OR', + array( + 'type' => 'order_item_meta', + 'meta_key' => array( '_product_id', '_variation_id' ), + 'meta_value' => $this->product_ids, + 'operator' => 'IN', + ), ), - '_product_id' => array( - 'type' => 'order_item_meta', - 'order_item_type' => 'line_item', - 'function' => '', - 'name' => 'product_id', - ), - ), - 'where_meta' => array( - 'relation' => 'OR', - array( - 'type' => 'order_item_meta', - 'meta_key' => array( '_product_id', '_variation_id' ), - 'meta_value' => $this->product_ids, - 'operator' => 'IN', - ), - ), - 'group_by' => 'product_id, ' . $this->group_by_query, - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - ) ); + 'group_by' => 'product_id, ' . $this->group_by_query, + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + ) + ); - // Prepare data for report + // Prepare data for report. $order_item_counts = $this->prepare_chart_data( $order_item_counts, 'post_date', 'order_item_count', $this->chart_interval, $this->start_date, $this->chart_groupby ); $order_item_amounts = $this->prepare_chart_data( $order_item_amounts, 'post_date', 'order_item_amount', $this->chart_interval, $this->start_date, $this->chart_groupby ); - // Encode in json format - $chart_data = json_encode( array( - 'order_item_counts' => array_values( $order_item_counts ), - 'order_item_amounts' => array_values( $order_item_amounts ), - ) ); + // Encode in json format. + $chart_data = json_encode( + array( + 'order_item_counts' => array_values( $order_item_counts ), + 'order_item_amounts' => array_values( $order_item_amounts ), + ) + ); ?>
          + 'stock', - 'plural' => 'stock', - 'ajax' => false, - ) ); + parent::__construct( + array( + 'singular' => 'stock', + 'plural' => 'stock', + 'ajax' => false, + ) + ); } /** @@ -70,7 +72,7 @@ class WC_Report_Stock extends WP_List_Table { /** * Get column value. * - * @param mixed $item + * @param mixed $item * @param string $column_name */ public function column_default( $item, $column_name ) { @@ -86,7 +88,7 @@ class WC_Report_Stock extends WP_List_Table { switch ( $column_name ) { - case 'product' : + case 'product': if ( $sku = $product->get_sku() ) { echo esc_html( $sku ) . ' - '; } @@ -97,63 +99,66 @@ class WC_Report_Stock extends WP_List_Table { if ( $product->is_type( 'variation' ) ) { echo '
          ' . wp_kses_post( wc_get_formatted_variation( $product, true ) ) . '
          '; } - break; + break; - case 'parent' : + case 'parent': if ( $item->parent ) { - echo get_the_title( $item->parent ); + echo esc_html( get_the_title( $item->parent ) ); } else { echo '-'; } - break; + break; - case 'stock_status' : - if ( $product->is_in_stock() ) { + case 'stock_status': + if ( $product->is_on_backorder() ) { + $stock_html = '' . __( 'On backorder', 'woocommerce' ) . ''; + } elseif ( $product->is_in_stock() ) { $stock_html = '' . __( 'In stock', 'woocommerce' ) . ''; } else { $stock_html = '' . __( 'Out of stock', 'woocommerce' ) . ''; } echo apply_filters( 'woocommerce_admin_stock_html', $stock_html, $product ); - break; + break; - case 'stock_level' : + case 'stock_level': echo esc_html( $product->get_stock_quantity() ); - break; + break; - case 'wc_actions' : + case 'wc_actions': ?>

          is_type( 'variation' ) ? $item->parent : $item->id; + $actions = array(); + $action_id = $product->is_type( 'variation' ) ? $item->parent : $item->id; - $actions['edit'] = array( - 'url' => admin_url( 'post.php?post=' . $action_id . '&action=edit' ), - 'name' => __( 'Edit', 'woocommerce' ), - 'action' => "edit", + $actions['edit'] = array( + 'url' => admin_url( 'post.php?post=' . $action_id . '&action=edit' ), + 'name' => __( 'Edit', 'woocommerce' ), + 'action' => 'edit', + ); + + if ( $product->is_visible() ) { + $actions['view'] = array( + 'url' => get_permalink( $action_id ), + 'name' => __( 'View', 'woocommerce' ), + 'action' => 'view', ); + } - if ( $product->is_visible() ) { - $actions['view'] = array( - 'url' => get_permalink( $action_id ), - 'name' => __( 'View', 'woocommerce' ), - 'action' => "view", - ); - } + $actions = apply_filters( 'woocommerce_admin_stock_report_product_actions', $actions, $product ); - $actions = apply_filters( 'woocommerce_admin_stock_report_product_actions', $actions, $product ); - - foreach ( $actions as $action ) { - printf( - '%4$s', - esc_attr( $action['action'] ), - esc_url( $action['url'] ), - sprintf( esc_attr__( '%s product', 'woocommerce' ), $action['name'] ), - esc_html( $action['name'] ) - ); - } + foreach ( $actions as $action ) { + printf( + '%4$s', + esc_attr( $action['action'] ), + esc_url( $action['url'] ), + sprintf( esc_attr__( '%s product', 'woocommerce' ), $action['name'] ), + esc_html( $action['name'] ) + ); + } ?> -

          + set_pagination_args( array( - 'total_items' => $this->max_items, - 'per_page' => $per_page, - 'total_pages' => ceil( $this->max_items / $per_page ), - ) ); + $this->set_pagination_args( + array( + 'total_items' => $this->max_items, + 'per_page' => $per_page, + 'total_pages' => ceil( $this->max_items / $per_page ), + ) + ); } } diff --git a/includes/admin/reports/class-wc-report-taxes-by-code.php b/includes/admin/reports/class-wc-report-taxes-by-code.php index 7950e3bb002..5904533777f 100644 --- a/includes/admin/reports/class-wc-report-taxes-by-code.php +++ b/includes/admin/reports/class-wc-report-taxes-by-code.php @@ -16,6 +16,7 @@ class WC_Report_Taxes_By_Code extends WC_Admin_Report { /** * Get the legend for the main chart sidebar. + * * @return array */ public function get_chart_legend() { @@ -46,9 +47,9 @@ class WC_Report_Taxes_By_Code extends WC_Admin_Report { public function output_report() { $ranges = array( - 'year' => __( 'Year', 'woocommerce' ), - 'last_month' => __( 'Last month', 'woocommerce' ), - 'month' => __( 'This month', 'woocommerce' ), + 'year' => __( 'Year', 'woocommerce' ), + 'last_month' => __( 'Last month', 'woocommerce' ), + 'month' => __( 'This month', 'woocommerce' ), ); $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( $_GET['range'] ) : 'last_month'; @@ -62,24 +63,22 @@ class WC_Report_Taxes_By_Code extends WC_Admin_Report { $hide_sidebar = true; - include( WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php' ); + include WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php'; } /** * Get the main chart. - * - * @return string */ public function get_main_chart() { global $wpdb; $query_data = array( - 'order_item_name' => array( + 'order_item_name' => array( 'type' => 'order_item', 'function' => '', 'name' => 'tax_rate', ), - 'tax_amount' => array( + 'tax_amount' => array( 'type' => 'order_item_meta', 'order_item_type' => 'tax', 'function' => '', @@ -91,13 +90,13 @@ class WC_Report_Taxes_By_Code extends WC_Admin_Report { 'function' => '', 'name' => 'shipping_tax_amount', ), - 'rate_id' => array( + 'rate_id' => array( 'type' => 'order_item_meta', 'order_item_type' => 'tax', 'function' => '', 'name' => 'rate_id', ), - 'ID' => array( + 'ID' => array( 'type' => 'post_data', 'function' => '', 'name' => 'post_id', @@ -117,29 +116,35 @@ class WC_Report_Taxes_By_Code extends WC_Admin_Report { ), ); - $tax_rows_orders = $this->get_order_report_data( array( - 'data' => $query_data, - 'where' => $query_where, - 'order_by' => 'posts.post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_types' => array_merge( wc_get_order_types( 'sales-reports' ), array( 'shop_order_refund' ) ), - 'order_status' => array( 'completed', 'processing', 'on-hold' ), - 'parent_order_status' => array( 'completed', 'processing', 'on-hold' ), // Partial refunds inside refunded orders should be ignored - ) ); + $tax_rows_orders = $this->get_order_report_data( + array( + 'data' => $query_data, + 'where' => $query_where, + 'order_by' => 'posts.post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_types' => array_merge( wc_get_order_types( 'sales-reports' ), array( 'shop_order_refund' ) ), + 'order_status' => array( 'completed', 'processing', 'on-hold' ), + 'parent_order_status' => array( 'completed', 'processing', 'on-hold' ), // Partial refunds inside refunded orders should be ignored + ) + ); // Merge $tax_rows = array(); foreach ( $tax_rows_orders as $tax_row ) { $key = $tax_row->rate_id; - $tax_rows[ $key ] = isset( $tax_rows[ $key ] ) ? $tax_rows[ $key ] : (object) array( 'tax_amount' => 0, 'shipping_tax_amount' => 0, 'total_orders' => 0 ); + $tax_rows[ $key ] = isset( $tax_rows[ $key ] ) ? $tax_rows[ $key ] : (object) array( + 'tax_amount' => 0, + 'shipping_tax_amount' => 0, + 'total_orders' => 0, + ); if ( 'shop_order_refund' !== get_post_type( $tax_row->post_id ) ) { - $tax_rows[ $key ]->total_orders += 1; + $tax_rows[ $key ]->total_orders += 1; } - $tax_rows[ $key ]->tax_rate = $tax_row->tax_rate; + $tax_rows[ $key ]->tax_rate = $tax_row->tax_rate; $tax_rows[ $key ]->tax_amount += wc_round_tax_total( $tax_row->tax_amount ); $tax_rows[ $key ]->shipping_tax_amount += wc_round_tax_total( $tax_row->shipping_tax_amount ); } diff --git a/includes/admin/reports/class-wc-report-taxes-by-date.php b/includes/admin/reports/class-wc-report-taxes-by-date.php index 2ffa0ea864e..8e0c1a45c1b 100644 --- a/includes/admin/reports/class-wc-report-taxes-by-date.php +++ b/includes/admin/reports/class-wc-report-taxes-by-date.php @@ -16,6 +16,7 @@ class WC_Report_Taxes_By_Date extends WC_Admin_Report { /** * Get the legend for the main chart sidebar. + * * @return array */ public function get_chart_legend() { @@ -46,9 +47,9 @@ class WC_Report_Taxes_By_Date extends WC_Admin_Report { public function output_report() { $ranges = array( - 'year' => __( 'Year', 'woocommerce' ), - 'last_month' => __( 'Last month', 'woocommerce' ), - 'month' => __( 'This month', 'woocommerce' ), + 'year' => __( 'Year', 'woocommerce' ), + 'last_month' => __( 'Last month', 'woocommerce' ), + 'month' => __( 'This month', 'woocommerce' ), ); $current_range = ! empty( $_GET['range'] ) ? sanitize_text_field( $_GET['range'] ) : 'last_month'; @@ -62,90 +63,146 @@ class WC_Report_Taxes_By_Date extends WC_Admin_Report { $hide_sidebar = true; - include( WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php' ); + include WC()->plugin_path() . '/includes/admin/views/html-report-by-date.php'; } /** * Get the main chart. - * - * @return string */ public function get_main_chart() { $query_data = array( - '_order_tax' => array( - 'type' => 'meta', - 'function' => 'SUM', - 'name' => 'tax_amount', + '_order_tax' => array( + 'type' => 'meta', + 'function' => 'SUM', + 'name' => 'tax_amount', ), '_order_shipping_tax' => array( - 'type' => 'meta', - 'function' => 'SUM', - 'name' => 'shipping_tax_amount', + 'type' => 'meta', + 'function' => 'SUM', + 'name' => 'shipping_tax_amount', ), - '_order_total' => array( + '_order_total' => array( 'type' => 'meta', 'function' => 'SUM', 'name' => 'total_sales', ), - '_order_shipping' => array( + '_order_shipping' => array( 'type' => 'meta', 'function' => 'SUM', 'name' => 'total_shipping', ), - 'ID' => array( + 'ID' => array( 'type' => 'post_data', 'function' => 'COUNT', 'name' => 'total_orders', 'distinct' => true, ), - 'post_date' => array( + 'post_date' => array( 'type' => 'post_data', 'function' => '', 'name' => 'post_date', ), ); - $tax_rows_orders = $this->get_order_report_data( array( - 'data' => $query_data, - 'group_by' => $this->group_by_query, - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_types' => wc_get_order_types( 'sales-reports' ), - 'order_status' => array( 'completed', 'processing', 'on-hold' ), - ) ); + $tax_rows_orders = $this->get_order_report_data( + array( + 'data' => $query_data, + 'group_by' => $this->group_by_query, + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_types' => wc_get_order_types( 'sales-reports' ), + 'order_status' => array( 'completed', 'processing', 'on-hold', 'refunded' ), + ) + ); - $tax_rows_partial_refunds = $this->get_order_report_data( array( - 'data' => $query_data, - 'group_by' => $this->group_by_query, - 'order_by' => 'post_date ASC', - 'query_type' => 'get_results', - 'filter_range' => true, - 'order_types' => array( 'shop_order_refund' ), - 'parent_order_status' => array( 'completed', 'processing', 'on-hold' ),// Partial refunds inside refunded orders should be ignored - ) ); + $tax_rows_full_refunds = $this->get_order_report_data( + array( + 'data' => array( + 'ID' => array( + 'type' => 'post_data', + 'distinct' => true, + 'function' => '', + 'name' => 'ID', + ), + 'post_parent' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_parent', + ), + 'post_date' => array( + 'type' => 'post_data', + 'function' => '', + 'name' => 'post_date', + ), + ), + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_types' => array( 'shop_order_refund' ), + 'parent_order_status' => array( 'refunded' ), + ) + ); + + $tax_rows_partial_refunds = $this->get_order_report_data( + array( + 'data' => $query_data, + 'group_by' => $this->group_by_query, + 'order_by' => 'post_date ASC', + 'query_type' => 'get_results', + 'filter_range' => true, + 'order_types' => array( 'shop_order_refund' ), + 'parent_order_status' => array( 'completed', 'processing', 'on-hold' ), // Partial refunds inside refunded orders should be ignored. + ) + ); - // Merge $tax_rows = array(); + foreach ( $tax_rows_orders + $tax_rows_partial_refunds as $tax_row ) { + $key = date( ( 'month' === $this->chart_groupby ) ? 'Ym' : 'Ymd', strtotime( $tax_row->post_date ) ); + $tax_rows[ $key ] = isset( $tax_rows[ $key ] ) ? $tax_rows[ $key ] : (object) array( + 'tax_amount' => 0, + 'shipping_tax_amount' => 0, + 'total_sales' => 0, + 'total_shipping' => 0, + 'total_orders' => 0, + ); + } + foreach ( $tax_rows_orders as $tax_row ) { - $key = date( ( 'month' === $this->chart_groupby ) ? 'Ym' : 'Ymd', strtotime( $tax_row->post_date ) ); - $tax_rows[ $key ] = isset( $tax_rows[ $key ] ) ? $tax_rows[ $key ] : (object) array( 'tax_amount' => 0, 'shipping_tax_amount' => 0, 'total_sales' => 0, 'total_shipping' => 0, 'total_orders' => 0 ); + $key = date( ( 'month' === $this->chart_groupby ) ? 'Ym' : 'Ymd', strtotime( $tax_row->post_date ) ); + $tax_rows[ $key ]->total_orders += $tax_row->total_orders; $tax_rows[ $key ]->tax_amount += $tax_row->tax_amount; $tax_rows[ $key ]->shipping_tax_amount += $tax_row->shipping_tax_amount; $tax_rows[ $key ]->total_sales += $tax_row->total_sales; $tax_rows[ $key ]->total_shipping += $tax_row->total_shipping; - $tax_rows[ $key ]->total_orders += $tax_row->total_orders; } foreach ( $tax_rows_partial_refunds as $tax_row ) { - $key = date( ( 'month' === $this->chart_groupby ) ? 'Ym' : 'Ymd', strtotime( $tax_row->post_date ) ); - $tax_rows[ $key ] = isset( $tax_rows[ $key ] ) ? $tax_rows[ $key ] : (object) array( 'tax_amount' => 0, 'shipping_tax_amount' => 0, 'total_sales' => 0, 'total_shipping' => 0, 'total_orders' => 0 ); + $key = date( ( 'month' === $this->chart_groupby ) ? 'Ym' : 'Ymd', strtotime( $tax_row->post_date ) ); $tax_rows[ $key ]->tax_amount += $tax_row->tax_amount; $tax_rows[ $key ]->shipping_tax_amount += $tax_row->shipping_tax_amount; $tax_rows[ $key ]->total_sales += $tax_row->total_sales; $tax_rows[ $key ]->total_shipping += $tax_row->total_shipping; } + + foreach ( $tax_rows_full_refunds as $tax_row ) { + $key = date( ( 'month' === $this->chart_groupby ) ? 'Ym' : 'Ymd', strtotime( $tax_row->post_date ) ); + $tax_rows[ $key ] = isset( $tax_rows[ $key ] ) ? $tax_rows[ $key ] : (object) array( + 'tax_amount' => 0, + 'shipping_tax_amount' => 0, + 'total_sales' => 0, + 'total_shipping' => 0, + 'total_orders' => 0, + ); + $parent_order = wc_get_order( $tax_row->post_parent ); + + if ( $parent_order ) { + $tax_rows[ $key ]->tax_amount += $parent_order->get_cart_tax() * -1; + $tax_rows[ $key ]->shipping_tax_amount += $parent_order->get_shipping_tax() * -1; + $tax_rows[ $key ]->total_sales += $parent_order->get_total() * -1; + $tax_rows[ $key ]->total_shipping += $parent_order->get_shipping_total() * -1; + } + } ?> @@ -155,7 +212,7 @@ class WC_Report_Taxes_By_Date extends WC_Admin_Report { - + diff --git a/includes/admin/settings/class-wc-settings-accounts.php b/includes/admin/settings/class-wc-settings-accounts.php index 1f667ad967d..2cc0861ba15 100644 --- a/includes/admin/settings/class-wc-settings-accounts.php +++ b/includes/admin/settings/class-wc-settings-accounts.php @@ -1,18 +1,15 @@ id = 'account'; - $this->label = __( 'Accounts', 'woocommerce' ); - - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); + $this->label = __( 'Accounts & Privacy', 'woocommerce' ); + parent::__construct(); } /** @@ -38,157 +31,201 @@ class WC_Settings_Accounts extends WC_Settings_Page { * @return array */ public function get_settings() { - $settings = apply_filters( 'woocommerce_' . $this->id . '_settings', array( + $erasure_text = esc_html( 'account erasure request', 'woocommerce' ); + if ( current_user_can( 'manage_privacy_options' ) ) { + $erasure_text = sprintf( '%s', esc_url( admin_url( 'tools.php?page=remove_personal_data' ) ), $erasure_text ); + } - array( 'title' => __( 'Account pages', 'woocommerce' ), 'type' => 'title', 'desc' => __( 'These pages need to be set so that WooCommerce knows where to send users to access account related functionality.', 'woocommerce' ), 'id' => 'account_page_options' ), + $settings = apply_filters( + 'woocommerce_' . $this->id . '_settings', array( + array( + 'title' => '', + 'type' => 'title', + 'id' => 'account_registration_options', + ), + array( + 'title' => __( 'Guest checkout', 'woocommerce' ), + 'desc' => __( 'Allow customers to place orders without an account', 'woocommerce' ), + 'id' => 'woocommerce_enable_guest_checkout', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + 'autoload' => false, + ), + array( + 'title' => __( 'Login', 'woocommerce' ), + 'desc' => __( 'Allow customers to log into an existing account during checkout', 'woocommerce' ), + 'id' => 'woocommerce_enable_checkout_login_reminder', + 'default' => 'no', + 'type' => 'checkbox', + 'checkboxgroup' => 'end', + 'autoload' => false, + ), + array( + 'title' => __( 'Account creation', 'woocommerce' ), + 'desc' => __( 'Allow customers to create an account during checkout', 'woocommerce' ), + 'id' => 'woocommerce_enable_signup_and_login_from_checkout', + 'default' => 'no', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + 'autoload' => false, + ), + array( + 'desc' => __( 'Allow customers to create an account on the "My account" page', 'woocommerce' ), + 'id' => 'woocommerce_enable_myaccount_registration', + 'default' => 'no', + 'type' => 'checkbox', + 'checkboxgroup' => '', + 'autoload' => false, + ), + array( + 'desc' => __( 'When creating an account, automatically generate a username from the customer\'s email address', 'woocommerce' ), + 'id' => 'woocommerce_registration_generate_username', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => '', + 'autoload' => false, + ), + array( + 'desc' => __( 'When creating an account, automatically generate an account password', 'woocommerce' ), + 'id' => 'woocommerce_registration_generate_password', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'end', + 'autoload' => false, + ), + array( + 'title' => __( 'Account erasure requests', 'woocommerce' ), + 'desc' => __( 'Remove personal data from orders', 'woocommerce' ), + /* Translators: %s URL to erasure request screen. */ + 'desc_tip' => sprintf( esc_html__( 'When handling an %s, should personal data within orders be retained or removed?', 'woocommerce' ), $erasure_text ), + 'id' => 'woocommerce_erasure_request_removes_order_data', + 'type' => 'checkbox', + 'default' => 'no', + 'checkboxgroup' => 'start', + 'autoload' => false, + ), + array( + 'desc' => __( 'Remove access to downloads', 'woocommerce' ), + /* Translators: %s URL to erasure request screen. */ + 'desc_tip' => sprintf( esc_html__( 'When handling an %s, should access to downloadable files be revoked and download logs cleared?', 'woocommerce' ), $erasure_text ), + 'id' => 'woocommerce_erasure_request_removes_download_data', + 'type' => 'checkbox', + 'default' => 'no', + 'checkboxgroup' => 'end', + 'autoload' => false, + ), + array( + 'type' => 'sectionend', + 'id' => 'account_registration_options', + ), + array( + 'title' => __( 'Privacy policy', 'woocommerce' ), + 'type' => 'title', + 'id' => 'privacy_policy_options', + 'desc' => __( 'This section controls the display of your website privacy policy. The privacy notices below will not show up unless a privacy page is first set.', 'woocommerce' ), + ), - array( - 'title' => __( 'My account page', 'woocommerce' ), - 'desc' => sprintf( __( 'Page contents: [%s]', 'woocommerce' ), apply_filters( 'woocommerce_my_account_shortcode_tag', 'woocommerce_my_account' ) ), - 'id' => 'woocommerce_myaccount_page_id', - 'type' => 'single_select_page', - 'default' => '', - 'class' => 'wc-enhanced-select-nostd', - 'css' => 'min-width:300px;', - 'desc_tip' => true, - ), + array( + 'title' => __( 'Privacy page', 'woocommerce' ), + 'desc' => __( 'Choose a page to act as your privacy policy.', 'woocommerce' ), + 'id' => 'wp_page_for_privacy_policy', + 'type' => 'single_select_page', + 'default' => '', + 'class' => 'wc-enhanced-select-nostd', + 'css' => 'min-width:300px;', + 'desc_tip' => true, + ), - array( 'type' => 'sectionend', 'id' => 'account_page_options' ), + array( + 'title' => __( 'Registration privacy policy', 'woocommerce' ), + 'desc_tip' => __( 'Optionally add some text about your store privacy policy to show on account registration forms.', 'woocommerce' ), + 'id' => 'woocommerce_registration_privacy_policy_text', + /* translators: %s privacy policy page name and link */ + 'default' => sprintf( __( 'Your personal data will be used to support your experience throughout this website, to manage access to your account, and for other purposes described in our %s.', 'woocommerce' ), '[privacy_policy]' ), + 'type' => 'textarea', + 'css' => 'min-width: 50%; height: 75px;', + ), - array( 'title' => '', 'type' => 'title', 'id' => 'account_registration_options' ), - - array( - 'title' => __( 'Customer registration', 'woocommerce' ), - 'desc' => __( 'Enable customer registration on the "Checkout" page.', 'woocommerce' ), - 'id' => 'woocommerce_enable_signup_and_login_from_checkout', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'autoload' => false, - ), - - array( - 'desc' => __( 'Enable customer registration on the "My account" page.', 'woocommerce' ), - 'id' => 'woocommerce_enable_myaccount_registration', - 'default' => 'no', - 'type' => 'checkbox', - 'checkboxgroup' => 'end', - 'autoload' => false, - ), - - array( - 'title' => __( 'Login', 'woocommerce' ), - 'desc' => __( 'Display returning customer login reminder on the "Checkout" page.', 'woocommerce' ), - 'id' => 'woocommerce_enable_checkout_login_reminder', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'autoload' => false, - ), - - array( - 'title' => __( 'Account creation', 'woocommerce' ), - 'desc' => __( 'Automatically generate username from customer email.', 'woocommerce' ), - 'id' => 'woocommerce_registration_generate_username', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'autoload' => false, - ), - - array( - 'desc' => __( 'Automatically generate customer password', 'woocommerce' ), - 'id' => 'woocommerce_registration_generate_password', - 'default' => 'no', - 'type' => 'checkbox', - 'checkboxgroup' => 'end', - 'autoload' => false, - ), - - array( 'type' => 'sectionend', 'id' => 'account_registration_options' ), - - array( 'title' => __( 'My account endpoints', 'woocommerce' ), 'type' => 'title', 'desc' => __( 'Endpoints are appended to your page URLs to handle specific actions on the accounts pages. They should be unique and can be left blank to disable the endpoint.', 'woocommerce' ), 'id' => 'account_endpoint_options' ), - - array( - 'title' => __( 'Orders', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "My account → Orders" page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_orders_endpoint', - 'type' => 'text', - 'default' => 'orders', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'View order', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "My account → View order" page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_view_order_endpoint', - 'type' => 'text', - 'default' => 'view-order', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Downloads', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "My account → Downloads" page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_downloads_endpoint', - 'type' => 'text', - 'default' => 'downloads', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Edit account', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "My account → Edit account" page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_edit_account_endpoint', - 'type' => 'text', - 'default' => 'edit-account', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Addresses', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "My account → Addresses" page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_edit_address_endpoint', - 'type' => 'text', - 'default' => 'edit-address', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Payment methods', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "My account → Payment methods" page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_payment_methods_endpoint', - 'type' => 'text', - 'default' => 'payment-methods', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Lost password', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "My account → Lost password" page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_lost_password_endpoint', - 'type' => 'text', - 'default' => 'lost-password', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Logout', 'woocommerce' ), - 'desc' => __( 'Endpoint for the triggering logout. You can add this to your menus via a custom link: yoursite.com/?customer-logout=true', 'woocommerce' ), - 'id' => 'woocommerce_logout_endpoint', - 'type' => 'text', - 'default' => 'customer-logout', - 'desc_tip' => true, - ), - - array( 'type' => 'sectionend', 'id' => 'account_endpoint_options' ), - - ) ); + array( + 'title' => __( 'Checkout privacy policy', 'woocommerce' ), + 'desc_tip' => __( 'Optionally add some text about your store privacy policy to show during checkout.', 'woocommerce' ), + 'id' => 'woocommerce_checkout_privacy_policy_text', + /* translators: %s privacy policy page name and link */ + 'default' => sprintf( __( 'Your personal data will be used to process your order, support your experience throughout this website, and for other purposes described in our %s.', 'woocommerce' ), '[privacy_policy]' ), + 'type' => 'textarea', + 'css' => 'min-width: 50%; height: 75px;', + ), + array( + 'type' => 'sectionend', + 'id' => 'privacy_policy_options', + ), + array( + 'title' => __( 'Personal data retention', 'woocommerce' ), + 'desc' => __( 'Choose how long to retain personal data when it\'s no longer needed for processing. Leave the following options blank to retain this data indefinitely.', 'woocommerce' ), + 'type' => 'title', + 'id' => 'personal_data_retention', + ), + array( + 'title' => __( 'Retain inactive accounts ', 'woocommerce' ), + 'desc_tip' => __( 'Inactive accounts are those which have not logged in, or placed an order, for the specified duration. They will be deleted. Any orders will be converted into guest orders.', 'woocommerce' ), + 'id' => 'woocommerce_delete_inactive_accounts', + 'type' => 'relative_date_selector', + 'placeholder' => __( 'N/A', 'woocommerce' ), + 'default' => array( + 'number' => '', + 'unit' => 'months', + ), + 'autoload' => false, + ), + array( + 'title' => __( 'Retain pending orders ', 'woocommerce' ), + 'desc_tip' => __( 'Pending orders are unpaid and may have been abandoned by the customer. They will be trashed after the specified duration.', 'woocommerce' ), + 'id' => 'woocommerce_trash_pending_orders', + 'type' => 'relative_date_selector', + 'placeholder' => __( 'N/A', 'woocommerce' ), + 'default' => '', + 'autoload' => false, + ), + array( + 'title' => __( 'Retain failed orders', 'woocommerce' ), + 'desc_tip' => __( 'Failed orders are unpaid and may have been abandoned by the customer. They will be trashed after the specified duration.', 'woocommerce' ), + 'id' => 'woocommerce_trash_failed_orders', + 'type' => 'relative_date_selector', + 'placeholder' => __( 'N/A', 'woocommerce' ), + 'default' => '', + 'autoload' => false, + ), + array( + 'title' => __( 'Retain cancelled orders', 'woocommerce' ), + 'desc_tip' => __( 'Cancelled orders are unpaid and may have been cancelled by the store owner or customer. They will be trashed after the specified duration.', 'woocommerce' ), + 'id' => 'woocommerce_trash_cancelled_orders', + 'type' => 'relative_date_selector', + 'placeholder' => __( 'N/A', 'woocommerce' ), + 'default' => '', + 'autoload' => false, + ), + array( + 'title' => __( 'Retain completed orders', 'woocommerce' ), + 'desc_tip' => __( 'Retain completed orders for a specified duration before anonymizing the personal data within them.', 'woocommerce' ), + 'id' => 'woocommerce_anonymize_completed_orders', + 'type' => 'relative_date_selector', + 'placeholder' => __( 'N/A', 'woocommerce' ), + 'default' => array( + 'number' => '', + 'unit' => 'months', + ), + 'autoload' => false, + ), + array( + 'type' => 'sectionend', + 'id' => 'personal_data_retention', + ), + ) + ); return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings ); } } -endif; - return new WC_Settings_Accounts(); diff --git a/includes/admin/settings/class-wc-settings-advanced.php b/includes/admin/settings/class-wc-settings-advanced.php new file mode 100644 index 00000000000..106c4aec0ea --- /dev/null +++ b/includes/admin/settings/class-wc-settings-advanced.php @@ -0,0 +1,398 @@ +id = 'advanced'; + $this->label = __( 'Advanced', 'woocommerce' ); + + parent::__construct(); + $this->notices(); + } + + /** + * Get sections. + * + * @return array + */ + public function get_sections() { + $sections = array( + '' => __( 'Page setup', 'woocommerce' ), + 'keys' => __( 'REST API', 'woocommerce' ), + 'webhooks' => __( 'Webhooks', 'woocommerce' ), + 'legacy_api' => __( 'Legacy API', 'woocommerce' ), + ); + + return apply_filters( 'woocommerce_get_sections_' . $this->id, $sections ); + } + + /** + * Get settings array. + * + * @param string $current_section Current section slug. + * @return array + */ + public function get_settings( $current_section = '' ) { + $settings = array(); + + if ( '' === $current_section ) { + $settings = apply_filters( + 'woocommerce_settings_pages', array( + + array( + 'title' => __( 'Page setup', 'woocommerce' ), + 'desc' => __( 'These pages need to be set so that WooCommerce knows where to send users to checkout.', 'woocommerce' ), + 'type' => 'title', + 'id' => 'advanced_page_options', + ), + + array( + 'title' => __( 'Cart page', 'woocommerce' ), + /* Translators: %s Page contents. */ + 'desc' => sprintf( __( 'Page contents: [%s]', 'woocommerce' ), apply_filters( 'woocommerce_cart_shortcode_tag', 'woocommerce_cart' ) ), + 'id' => 'woocommerce_cart_page_id', + 'type' => 'single_select_page', + 'default' => '', + 'class' => 'wc-enhanced-select-nostd', + 'css' => 'min-width:300px;', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Checkout page', 'woocommerce' ), + /* Translators: %s Page contents. */ + 'desc' => sprintf( __( 'Page contents: [%s]', 'woocommerce' ), apply_filters( 'woocommerce_checkout_shortcode_tag', 'woocommerce_checkout' ) ), + 'id' => 'woocommerce_checkout_page_id', + 'type' => 'single_select_page', + 'default' => '', + 'class' => 'wc-enhanced-select-nostd', + 'css' => 'min-width:300px;', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'My account page', 'woocommerce' ), + /* Translators: %s Page contents. */ + 'desc' => sprintf( __( 'Page contents: [%s]', 'woocommerce' ), apply_filters( 'woocommerce_my_account_shortcode_tag', 'woocommerce_my_account' ) ), + 'id' => 'woocommerce_myaccount_page_id', + 'type' => 'single_select_page', + 'default' => '', + 'class' => 'wc-enhanced-select-nostd', + 'css' => 'min-width:300px;', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Terms and conditions', 'woocommerce' ), + 'desc' => __( 'If you define a "Terms" page the customer will be asked if they accept them when checking out.', 'woocommerce' ), + 'id' => 'woocommerce_terms_page_id', + 'default' => '', + 'class' => 'wc-enhanced-select-nostd', + 'css' => 'min-width:300px;', + 'type' => 'single_select_page', + 'args' => array( 'exclude' => wc_get_page_id( 'checkout' ) ), + 'desc_tip' => true, + 'autoload' => false, + ), + + array( + 'type' => 'sectionend', + 'id' => 'advanced_page_options', + ), + + array( + 'title' => '', + 'type' => 'title', + 'id' => 'checkout_process_options', + ), + + 'force_ssl_checkout' => array( + 'title' => __( 'Secure checkout', 'woocommerce' ), + 'desc' => __( 'Force secure checkout', 'woocommerce' ), + 'id' => 'woocommerce_force_ssl_checkout', + 'default' => 'no', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + 'show_if_checked' => 'option', + /* Translators: %s Docs URL. */ + 'desc_tip' => sprintf( __( 'Force SSL (HTTPS) on the checkout pages (an SSL Certificate is required).', 'woocommerce' ), 'https://docs.woocommerce.com/document/ssl-and-https/#section-3' ), + ), + + 'unforce_ssl_checkout' => array( + 'desc' => __( 'Force HTTP when leaving the checkout', 'woocommerce' ), + 'id' => 'woocommerce_unforce_ssl_checkout', + 'default' => 'no', + 'type' => 'checkbox', + 'checkboxgroup' => 'end', + 'show_if_checked' => 'yes', + ), + + array( + 'type' => 'sectionend', + 'id' => 'checkout_process_options', + ), + + array( + 'title' => __( 'Checkout endpoints', 'woocommerce' ), + 'type' => 'title', + 'desc' => __( 'Endpoints are appended to your page URLs to handle specific actions during the checkout process. They should be unique.', 'woocommerce' ), + 'id' => 'account_endpoint_options', + ), + + array( + 'title' => __( 'Pay', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "Checkout → Pay" page.', 'woocommerce' ), + 'id' => 'woocommerce_checkout_pay_endpoint', + 'type' => 'text', + 'default' => 'order-pay', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Order received', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "Checkout → Order received" page.', 'woocommerce' ), + 'id' => 'woocommerce_checkout_order_received_endpoint', + 'type' => 'text', + 'default' => 'order-received', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Add payment method', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "Checkout → Add payment method" page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_add_payment_method_endpoint', + 'type' => 'text', + 'default' => 'add-payment-method', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Delete payment method', 'woocommerce' ), + 'desc' => __( 'Endpoint for the delete payment method page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_delete_payment_method_endpoint', + 'type' => 'text', + 'default' => 'delete-payment-method', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Set default payment method', 'woocommerce' ), + 'desc' => __( 'Endpoint for the setting a default payment method page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_set_default_payment_method_endpoint', + 'type' => 'text', + 'default' => 'set-default-payment-method', + 'desc_tip' => true, + ), + + array( + 'type' => 'sectionend', + 'id' => 'checkout_endpoint_options', + ), + + array( + 'title' => __( 'Account endpoints', 'woocommerce' ), + 'type' => 'title', + 'desc' => __( 'Endpoints are appended to your page URLs to handle specific actions on the accounts pages. They should be unique and can be left blank to disable the endpoint.', 'woocommerce' ), + 'id' => 'account_endpoint_options', + ), + + array( + 'title' => __( 'Orders', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "My account → Orders" page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_orders_endpoint', + 'type' => 'text', + 'default' => 'orders', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'View order', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "My account → View order" page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_view_order_endpoint', + 'type' => 'text', + 'default' => 'view-order', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Downloads', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "My account → Downloads" page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_downloads_endpoint', + 'type' => 'text', + 'default' => 'downloads', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Edit account', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "My account → Edit account" page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_edit_account_endpoint', + 'type' => 'text', + 'default' => 'edit-account', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Addresses', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "My account → Addresses" page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_edit_address_endpoint', + 'type' => 'text', + 'default' => 'edit-address', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Payment methods', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "My account → Payment methods" page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_payment_methods_endpoint', + 'type' => 'text', + 'default' => 'payment-methods', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Lost password', 'woocommerce' ), + 'desc' => __( 'Endpoint for the "My account → Lost password" page.', 'woocommerce' ), + 'id' => 'woocommerce_myaccount_lost_password_endpoint', + 'type' => 'text', + 'default' => 'lost-password', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Logout', 'woocommerce' ), + 'desc' => __( 'Endpoint for the triggering logout. You can add this to your menus via a custom link: yoursite.com/?customer-logout=true', 'woocommerce' ), + 'id' => 'woocommerce_logout_endpoint', + 'type' => 'text', + 'default' => 'customer-logout', + 'desc_tip' => true, + ), + + array( + 'type' => 'sectionend', + 'id' => 'account_endpoint_options', + ), + ) + ); + + if ( wc_site_is_https() ) { + unset( $settings['unforce_ssl_checkout'], $settings['force_ssl_checkout'] ); + } + } elseif ( 'legacy_api' === $current_section ) { + $settings = apply_filters( + 'woocommerce_settings_rest_api', array( + array( + 'title' => '', + 'type' => 'title', + 'desc' => '', + 'id' => 'legacy_api_options', + ), + array( + 'title' => __( 'Legacy API', 'woocommerce' ), + 'desc' => __( 'Enable the legacy REST API', 'woocommerce' ), + 'id' => 'woocommerce_api_enabled', + 'type' => 'checkbox', + 'default' => 'no', + ), + array( + 'type' => 'sectionend', + 'id' => 'legacy_api_options', + ), + ) + ); + } + + return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings, $current_section ); + } + + /** + * Form method. + * + * @deprecated 3.4.4 + * @param string $method Method name. + * @return string + */ + public function form_method( $method ) { + return 'post'; + } + + /** + * Notices. + */ + private function notices() { + if ( isset( $_GET['section'] ) && 'webhooks' === $_GET['section'] ) { // WPCS: input var okay, CSRF ok. + WC_Admin_Webhooks::notices(); + } + if ( isset( $_GET['section'] ) && 'keys' === $_GET['section'] ) { // WPCS: input var okay, CSRF ok. + WC_Admin_API_Keys::notices(); + } + } + + /** + * Output the settings. + */ + public function output() { + global $current_section; + + if ( 'webhooks' === $current_section ) { + WC_Admin_Webhooks::page_output(); + } elseif ( 'keys' === $current_section ) { + WC_Admin_API_Keys::page_output(); + } else { + $settings = $this->get_settings( $current_section ); + WC_Admin_Settings::output_fields( $settings ); + } + } + + /** + * Save settings. + */ + public function save() { + global $current_section; + + if ( apply_filters( 'woocommerce_rest_api_valid_to_save', ! in_array( $current_section, array( 'keys', 'webhooks' ), true ) ) ) { + $settings = $this->get_settings( $current_section ); + + // Prevent the T&Cs and checkout page from being set to the same page. + if ( isset( $_POST['woocommerce_terms_page_id'], $_POST['woocommerce_checkout_page_id'] ) && $_POST['woocommerce_terms_page_id'] === $_POST['woocommerce_checkout_page_id'] ) { // WPCS: input var ok, CSRF ok. + $_POST['woocommerce_terms_page_id'] = ''; + } + + WC_Admin_Settings::save_fields( $settings ); + + if ( $current_section ) { + do_action( 'woocommerce_update_options_' . $this->id . '_' . $current_section ); + } + } + } +} + +/** + * WC_Settings_Rest_API class. + * + * @deprecated 3.4 in favour of WC_Settings_Advanced. + * @todo remove in 4.0. + */ +class WC_Settings_Rest_API extends WC_Settings_Advanced {} // @codingStandardsIgnoreLine. + +return new WC_Settings_Advanced(); diff --git a/includes/admin/settings/class-wc-settings-api.php b/includes/admin/settings/class-wc-settings-api.php deleted file mode 100644 index d5e304c39b1..00000000000 --- a/includes/admin/settings/class-wc-settings-api.php +++ /dev/null @@ -1,166 +0,0 @@ -id = 'api'; - $this->label = __( 'API', 'woocommerce' ); - - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); - add_action( 'woocommerce_settings_form_method_tab_' . $this->id, array( $this, 'form_method' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); - - $this->notices(); - } - - /** - * Get sections. - * - * @return array - */ - public function get_sections() { - $sections = array( - '' => __( 'Settings', 'woocommerce' ), - 'keys' => __( 'Keys/Apps', 'woocommerce' ), - 'webhooks' => __( 'Webhooks', 'woocommerce' ), - ); - - return apply_filters( 'woocommerce_get_sections_' . $this->id, $sections ); - } - - /** - * Get settings array. - * - * @param string $current_section - * @return array - */ - public function get_settings( $current_section = '' ) { - $settings = array(); - - if ( '' === $current_section ) { - $settings = apply_filters( 'woocommerce_settings_rest_api', array( - array( - 'title' => __( 'General options', 'woocommerce' ), - 'type' => 'title', - 'desc' => '', - 'id' => 'general_options', - ), - - array( - 'title' => __( 'API', 'woocommerce' ), - 'desc' => __( 'Enable the REST API', 'woocommerce' ), - 'id' => 'woocommerce_api_enabled', - 'type' => 'checkbox', - 'default' => 'yes', - ), - - array( - 'type' => 'sectionend', - 'id' => 'general_options', - ), - ) ); - } - - return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings, $current_section ); - } - - /** - * Form method. - * - * @param string $method - * - * @return string - */ - public function form_method( $method ) { - global $current_section; - - if ( 'webhooks' == $current_section ) { - if ( isset( $_GET['edit-webhook'] ) ) { - $webhook_id = absint( $_GET['edit-webhook'] ); - $webhook = new WC_Webhook( $webhook_id ); - - if ( 'trash' != $webhook->post_data->post_status ) { - return 'post'; - } - } - - return 'get'; - } - - if ( 'keys' == $current_section ) { - if ( isset( $_GET['create-key'] ) || isset( $_GET['edit-key'] ) ) { - return 'post'; - } - - return 'get'; - } - - return 'post'; - } - - /** - * Notices. - */ - private function notices() { - if ( isset( $_GET['section'] ) && 'webhooks' == $_GET['section'] ) { - WC_Admin_Webhooks::notices(); - } - if ( isset( $_GET['section'] ) && 'keys' == $_GET['section'] ) { - WC_Admin_API_Keys::notices(); - } - } - - /** - * Output the settings. - */ - public function output() { - global $current_section; - - if ( 'webhooks' == $current_section ) { - WC_Admin_Webhooks::page_output(); - } elseif ( 'keys' === $current_section ) { - WC_Admin_API_Keys::page_output(); - } else { - $settings = $this->get_settings( $current_section ); - WC_Admin_Settings::output_fields( $settings ); - } - } - - /** - * Save settings. - */ - public function save() { - global $current_section; - - if ( apply_filters( 'woocommerce_rest_api_valid_to_save', ! in_array( $current_section, array( 'keys', 'webhooks' ) ) ) ) { - $settings = $this->get_settings(); - WC_Admin_Settings::save_fields( $settings ); - } - } -} - -endif; - -return new WC_Settings_Rest_API(); diff --git a/includes/admin/settings/class-wc-settings-checkout.php b/includes/admin/settings/class-wc-settings-checkout.php index 85c5cd9b1c4..3ddfd970c88 100644 --- a/includes/admin/settings/class-wc-settings-checkout.php +++ b/includes/admin/settings/class-wc-settings-checkout.php @@ -1,385 +1,11 @@ -id = 'checkout'; - $this->label = _x( 'Checkout', 'Settings tab label', 'woocommerce' ); - - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_admin_field_payment_gateways', array( $this, 'payment_gateways_setting' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); - } - - /** - * Get sections. - * - * @return array - */ - public function get_sections() { - $sections = array( - '' => __( 'Checkout options', 'woocommerce' ), - ); - - if ( ! defined( 'WC_INSTALLING' ) ) { - $payment_gateways = WC()->payment_gateways->payment_gateways(); - - foreach ( $payment_gateways as $gateway ) { - $title = empty( $gateway->method_title ) ? ucfirst( $gateway->id ) : $gateway->method_title; - $sections[ strtolower( $gateway->id ) ] = esc_html( $title ); - } - } - - return apply_filters( 'woocommerce_get_sections_' . $this->id, $sections ); - } - - /** - * Get settings array. - * - * @param string $current_section - * - * @return array - */ - public function get_settings( $current_section = '' ) { - $settings = array(); - - if ( '' === $current_section ) { - $settings = apply_filters( 'woocommerce_payment_gateways_settings', array( - - array( - 'title' => __( 'Checkout process', 'woocommerce' ), - 'type' => 'title', - 'id' => 'checkout_process_options', - ), - - array( - 'title' => __( 'Coupons', 'woocommerce' ), - 'desc' => __( 'Enable the use of coupons', 'woocommerce' ), - 'id' => 'woocommerce_enable_coupons', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'desc_tip' => __( 'Coupons can be applied from the cart and checkout pages.', 'woocommerce' ), - ), - - array( - 'desc' => __( 'Calculate coupon discounts sequentially', 'woocommerce' ), - 'id' => 'woocommerce_calc_discounts_sequentially', - 'default' => 'no', - 'type' => 'checkbox', - 'desc_tip' => __( 'When applying multiple coupons, apply the first coupon to the full price and the second coupon to the discounted price and so on.', 'woocommerce' ), - 'checkboxgroup' => 'end', - 'autoload' => false, - ), - - array( - 'title' => __( 'Checkout process', 'woocommerce' ), - 'desc' => __( 'Enable guest checkout', 'woocommerce' ), - 'desc_tip' => __( 'Allows customers to checkout without creating an account.', 'woocommerce' ), - 'id' => 'woocommerce_enable_guest_checkout', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'autoload' => false, - ), - - array( - 'desc' => __( 'Force secure checkout', 'woocommerce' ), - 'id' => 'woocommerce_force_ssl_checkout', - 'default' => 'no', - 'type' => 'checkbox', - 'checkboxgroup' => '', - 'show_if_checked' => 'option', - 'desc_tip' => sprintf( __( 'Force SSL (HTTPS) on the checkout pages (an SSL Certificate is required).', 'woocommerce' ), 'https://docs.woocommerce.com/document/ssl-and-https/#section-3' ), - ), - - 'unforce_ssl_checkout' => array( - 'desc' => __( 'Force HTTP when leaving the checkout', 'woocommerce' ), - 'id' => 'woocommerce_unforce_ssl_checkout', - 'default' => 'no', - 'type' => 'checkbox', - 'checkboxgroup' => 'end', - 'show_if_checked' => 'yes', - ), - - array( - 'type' => 'sectionend', - 'id' => 'checkout_process_options', - ), - - array( - 'title' => __( 'Checkout pages', 'woocommerce' ), - 'desc' => __( 'These pages need to be set so that WooCommerce knows where to send users to checkout.', 'woocommerce' ), - 'type' => 'title', - 'id' => 'checkout_page_options', - ), - - array( - 'title' => __( 'Cart page', 'woocommerce' ), - 'desc' => sprintf( __( 'Page contents: [%s]', 'woocommerce' ), apply_filters( 'woocommerce_cart_shortcode_tag', 'woocommerce_cart' ) ), - 'id' => 'woocommerce_cart_page_id', - 'type' => 'single_select_page', - 'default' => '', - 'class' => 'wc-enhanced-select-nostd', - 'css' => 'min-width:300px;', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Checkout page', 'woocommerce' ), - 'desc' => sprintf( __( 'Page contents: [%s]', 'woocommerce' ), apply_filters( 'woocommerce_checkout_shortcode_tag', 'woocommerce_checkout' ) ), - 'id' => 'woocommerce_checkout_page_id', - 'type' => 'single_select_page', - 'default' => '', - 'class' => 'wc-enhanced-select-nostd', - 'css' => 'min-width:300px;', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Terms and conditions', 'woocommerce' ), - 'desc' => __( 'If you define a "Terms" page the customer will be asked if they accept them when checking out.', 'woocommerce' ), - 'id' => 'woocommerce_terms_page_id', - 'default' => '', - 'class' => 'wc-enhanced-select-nostd', - 'css' => 'min-width:300px;', - 'type' => 'single_select_page', - 'args' => array( 'exclude' => wc_get_page_id( 'checkout' ) ), - 'desc_tip' => true, - 'autoload' => false, - ), - - array( - 'type' => 'sectionend', - 'id' => 'checkout_page_options', - ), - - array( 'title' => __( 'Checkout endpoints', 'woocommerce' ), 'type' => 'title', 'desc' => __( 'Endpoints are appended to your page URLs to handle specific actions during the checkout process. They should be unique.', 'woocommerce' ), 'id' => 'account_endpoint_options' ), - - array( - 'title' => __( 'Pay', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "Checkout → Pay" page.', 'woocommerce' ), - 'id' => 'woocommerce_checkout_pay_endpoint', - 'type' => 'text', - 'default' => 'order-pay', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Order received', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "Checkout → Order received" page.', 'woocommerce' ), - 'id' => 'woocommerce_checkout_order_received_endpoint', - 'type' => 'text', - 'default' => 'order-received', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Add payment method', 'woocommerce' ), - 'desc' => __( 'Endpoint for the "Checkout → Add payment method" page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_add_payment_method_endpoint', - 'type' => 'text', - 'default' => 'add-payment-method', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Delete payment method', 'woocommerce' ), - 'desc' => __( 'Endpoint for the delete payment method page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_delete_payment_method_endpoint', - 'type' => 'text', - 'default' => 'delete-payment-method', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Set default payment method', 'woocommerce' ), - 'desc' => __( 'Endpoint for the setting a default payment method page.', 'woocommerce' ), - 'id' => 'woocommerce_myaccount_set_default_payment_method_endpoint', - 'type' => 'text', - 'default' => 'set-default-payment-method', - 'desc_tip' => true, - ), - - array( - 'type' => 'sectionend', - 'id' => 'checkout_endpoint_options', - ), - - array( - 'title' => __( 'Payment gateways', 'woocommerce' ), - 'desc' => __( 'Installed gateways are listed below. Drag and drop gateways to control their display order on the frontend.', 'woocommerce' ), - 'type' => 'title', - 'id' => 'payment_gateways_options', - ), - - array( - 'type' => 'payment_gateways', - ), - - array( - 'type' => 'sectionend', - 'id' => 'payment_gateways_options', - ), - - ) ); - - if ( wc_site_is_https() ) { - unset( $settings['unforce_ssl_checkout'] ); - } - } - - return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings, $current_section ); - } - - /** - * Output the settings. - */ - public function output() { - global $current_section; - - // Load shipping methods so we can show any global options they may have. - $payment_gateways = WC()->payment_gateways->payment_gateways(); - - if ( $current_section ) { - foreach ( $payment_gateways as $gateway ) { - if ( in_array( $current_section, array( $gateway->id, sanitize_title( get_class( $gateway ) ) ) ) ) { - $gateway->admin_options(); - break; - } - } - } else { - $settings = $this->get_settings(); - - WC_Admin_Settings::output_fields( $settings ); - } - } - - /** - * Output payment gateway settings. - */ - public function payment_gateways_setting() { - ?> - - - - - get_settings() ); - $wc_payment_gateways->process_admin_options(); - - } else { - foreach ( $wc_payment_gateways->payment_gateways() as $gateway ) { - if ( in_array( $current_section, array( $gateway->id, sanitize_title( get_class( $gateway ) ) ) ) ) { - do_action( 'woocommerce_update_options_payment_gateways_' . $gateway->id ); - $wc_payment_gateways->init(); - } - } - } - } -} - -endif; - -return new WC_Settings_Payment_Gateways(); +return include 'class-wc-settings-payment-gateways.php'; diff --git a/includes/admin/settings/class-wc-settings-emails.php b/includes/admin/settings/class-wc-settings-emails.php index 79ce1838dbb..44f7df15781 100644 --- a/includes/admin/settings/class-wc-settings-emails.php +++ b/includes/admin/settings/class-wc-settings-emails.php @@ -2,17 +2,15 @@ /** * WooCommerce Email Settings * - * @author WooThemes - * @category Admin - * @package WooCommerce/Admin - * @version 2.1.0 + * @package WooCommerce/Admin + * @version 2.1.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; -if ( ! class_exists( 'WC_Settings_Emails', false ) ) : +if ( class_exists( 'WC_Settings_Emails', false ) ) { + return new WC_Settings_Emails(); +} /** * WC_Settings_Emails. @@ -26,11 +24,8 @@ class WC_Settings_Emails extends WC_Settings_Page { $this->id = 'email'; $this->label = __( 'Emails', 'woocommerce' ); - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); add_action( 'woocommerce_admin_field_email_notification', array( $this, 'email_notification_setting' ) ); + parent::__construct(); } /** @@ -51,123 +46,153 @@ class WC_Settings_Emails extends WC_Settings_Page { * @return array */ public function get_settings() { - $settings = apply_filters( 'woocommerce_email_settings', array( + $settings = apply_filters( + 'woocommerce_email_settings', array( - array( 'title' => __( 'Email notifications', 'woocommerce' ), 'desc' => __( 'Email notifications sent from WooCommerce are listed below. Click on an email to configure it.', 'woocommerce' ), 'type' => 'title', 'id' => 'email_notification_settings' ), - - array( 'type' => 'email_notification' ), - - array( 'type' => 'sectionend', 'id' => 'email_notification_settings' ), - - array( 'type' => 'sectionend', 'id' => 'email_recipient_options' ), - - array( 'title' => __( 'Email sender options', 'woocommerce' ), 'type' => 'title', 'desc' => '', 'id' => 'email_options' ), - - array( - 'title' => __( '"From" name', 'woocommerce' ), - 'desc' => __( 'How the sender name appears in outgoing WooCommerce emails.', 'woocommerce' ), - 'id' => 'woocommerce_email_from_name', - 'type' => 'text', - 'css' => 'min-width:300px;', - 'default' => esc_attr( get_bloginfo( 'name', 'display' ) ), - 'autoload' => false, - 'desc_tip' => true, - ), - - array( - 'title' => __( '"From" address', 'woocommerce' ), - 'desc' => __( 'How the sender email appears in outgoing WooCommerce emails.', 'woocommerce' ), - 'id' => 'woocommerce_email_from_address', - 'type' => 'email', - 'custom_attributes' => array( - 'multiple' => 'multiple', + array( + 'title' => __( 'Email notifications', 'woocommerce' ), + 'desc' => __( 'Email notifications sent from WooCommerce are listed below. Click on an email to configure it.', 'woocommerce' ), + 'type' => 'title', + 'id' => 'email_notification_settings', ), - 'css' => 'min-width:300px;', - 'default' => get_option( 'admin_email' ), - 'autoload' => false, - 'desc_tip' => true, - ), - array( 'type' => 'sectionend', 'id' => 'email_options' ), + array( 'type' => 'email_notification' ), - array( 'title' => __( 'Email template', 'woocommerce' ), 'type' => 'title', 'desc' => sprintf( __( 'This section lets you customize the WooCommerce emails. Click here to preview your email template.', 'woocommerce' ), wp_nonce_url( admin_url( '?preview_woocommerce_mail=true' ), 'preview-mail' ) ), 'id' => 'email_template_options' ), + array( + 'type' => 'sectionend', + 'id' => 'email_notification_settings', + ), - array( - 'title' => __( 'Header image', 'woocommerce' ), - 'desc' => __( 'URL to an image you want to show in the email header. Upload images using the media uploader (Admin > Media).', 'woocommerce' ), - 'id' => 'woocommerce_email_header_image', - 'type' => 'text', - 'css' => 'min-width:300px;', - 'placeholder' => __( 'N/A', 'woocommerce' ), - 'default' => '', - 'autoload' => false, - 'desc_tip' => true, - ), + array( + 'type' => 'sectionend', + 'id' => 'email_recipient_options', + ), - array( - 'title' => __( 'Footer text', 'woocommerce' ), - 'desc' => __( 'The text to appear in the footer of WooCommerce emails.', 'woocommerce' ), - 'id' => 'woocommerce_email_footer_text', - 'css' => 'width:300px; height: 75px;', - 'placeholder' => __( 'N/A', 'woocommerce' ), - 'type' => 'textarea', - /* translators: %s: site name */ - 'default' => sprintf( __( '%s - Powered by WooCommerce', 'woocommerce' ), get_bloginfo( 'name', 'display' ) ), - 'autoload' => false, - 'desc_tip' => true, - ), + array( + 'title' => __( 'Email sender options', 'woocommerce' ), + 'type' => 'title', + 'desc' => '', + 'id' => 'email_options', + ), - array( - 'title' => __( 'Base color', 'woocommerce' ), - /* translators: %s: default color */ - 'desc' => sprintf( __( 'The base color for WooCommerce email templates. Default %s.', 'woocommerce' ), '#96588a' ), - 'id' => 'woocommerce_email_base_color', - 'type' => 'color', - 'css' => 'width:6em;', - 'default' => '#96588a', - 'autoload' => false, - 'desc_tip' => true, - ), + array( + 'title' => __( '"From" name', 'woocommerce' ), + 'desc' => __( 'How the sender name appears in outgoing WooCommerce emails.', 'woocommerce' ), + 'id' => 'woocommerce_email_from_name', + 'type' => 'text', + 'css' => 'min-width:300px;', + 'default' => esc_attr( get_bloginfo( 'name', 'display' ) ), + 'autoload' => false, + 'desc_tip' => true, + ), - array( - 'title' => __( 'Background color', 'woocommerce' ), - /* translators: %s: default color */ - 'desc' => sprintf( __( 'The background color for WooCommerce email templates. Default %s.', 'woocommerce' ), '#f7f7f7' ), - 'id' => 'woocommerce_email_background_color', - 'type' => 'color', - 'css' => 'width:6em;', - 'default' => '#f7f7f7', - 'autoload' => false, - 'desc_tip' => true, - ), + array( + 'title' => __( '"From" address', 'woocommerce' ), + 'desc' => __( 'How the sender email appears in outgoing WooCommerce emails.', 'woocommerce' ), + 'id' => 'woocommerce_email_from_address', + 'type' => 'email', + 'custom_attributes' => array( + 'multiple' => 'multiple', + ), + 'css' => 'min-width:300px;', + 'default' => get_option( 'admin_email' ), + 'autoload' => false, + 'desc_tip' => true, + ), - array( - 'title' => __( 'Body background color', 'woocommerce' ), - /* translators: %s: default color */ - 'desc' => sprintf( __( 'The main body background color. Default %s.', 'woocommerce' ), '#ffffff' ), - 'id' => 'woocommerce_email_body_background_color', - 'type' => 'color', - 'css' => 'width:6em;', - 'default' => '#ffffff', - 'autoload' => false, - 'desc_tip' => true, - ), + array( + 'type' => 'sectionend', + 'id' => 'email_options', + ), - array( - 'title' => __( 'Body text color', 'woocommerce' ), - /* translators: %s: default color */ - 'desc' => sprintf( __( 'The main body text color. Default %s.', 'woocommerce' ), '#3c3c3c' ), - 'id' => 'woocommerce_email_text_color', - 'type' => 'color', - 'css' => 'width:6em;', - 'default' => '#3c3c3c', - 'autoload' => false, - 'desc_tip' => true, - ), + array( + 'title' => __( 'Email template', 'woocommerce' ), + 'type' => 'title', + /* translators: %s: Nonced email preview link */ + 'desc' => sprintf( __( 'This section lets you customize the WooCommerce emails. Click here to preview your email template.', 'woocommerce' ), wp_nonce_url( admin_url( '?preview_woocommerce_mail=true' ), 'preview-mail' ) ), + 'id' => 'email_template_options', + ), - array( 'type' => 'sectionend', 'id' => 'email_template_options' ), + array( + 'title' => __( 'Header image', 'woocommerce' ), + 'desc' => __( 'URL to an image you want to show in the email header. Upload images using the media uploader (Admin > Media).', 'woocommerce' ), + 'id' => 'woocommerce_email_header_image', + 'type' => 'text', + 'css' => 'min-width:300px;', + 'placeholder' => __( 'N/A', 'woocommerce' ), + 'default' => '', + 'autoload' => false, + 'desc_tip' => true, + ), - ) ); + array( + 'title' => __( 'Footer text', 'woocommerce' ), + /* translators: %s: Available placeholders for use */ + 'desc' => __( 'The text to appear in the footer of WooCommerce emails.', 'woocommerce' ) . ' ' . sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}' ), + 'id' => 'woocommerce_email_footer_text', + 'css' => 'width:300px; height: 75px;', + 'placeholder' => __( 'N/A', 'woocommerce' ), + 'type' => 'textarea', + 'default' => '{site_title}
          Powered by WooCommerce', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Base color', 'woocommerce' ), + /* translators: %s: default color */ + 'desc' => sprintf( __( 'The base color for WooCommerce email templates. Default %s.', 'woocommerce' ), '#96588a' ), + 'id' => 'woocommerce_email_base_color', + 'type' => 'color', + 'css' => 'width:6em;', + 'default' => '#96588a', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Background color', 'woocommerce' ), + /* translators: %s: default color */ + 'desc' => sprintf( __( 'The background color for WooCommerce email templates. Default %s.', 'woocommerce' ), '#f7f7f7' ), + 'id' => 'woocommerce_email_background_color', + 'type' => 'color', + 'css' => 'width:6em;', + 'default' => '#f7f7f7', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Body background color', 'woocommerce' ), + /* translators: %s: default color */ + 'desc' => sprintf( __( 'The main body background color. Default %s.', 'woocommerce' ), '#ffffff' ), + 'id' => 'woocommerce_email_body_background_color', + 'type' => 'color', + 'css' => 'width:6em;', + 'default' => '#ffffff', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Body text color', 'woocommerce' ), + /* translators: %s: default color */ + 'desc' => sprintf( __( 'The main body text color. Default %s.', 'woocommerce' ), '#3c3c3c' ), + 'id' => 'woocommerce_email_text_color', + 'type' => 'color', + 'css' => 'width:6em;', + 'default' => '#3c3c3c', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'type' => 'sectionend', + 'id' => 'email_template_options', + ), + + ) + ); return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings ); } @@ -178,13 +203,13 @@ class WC_Settings_Emails extends WC_Settings_Page { public function output() { global $current_section; - // Define emails that can be customised here + // Define emails that can be customised here. $mailer = WC()->mailer(); $email_templates = $mailer->get_emails(); if ( $current_section ) { foreach ( $email_templates as $email_key => $email ) { - if ( strtolower( $email_key ) == $current_section ) { + if ( strtolower( $email_key ) === $current_section ) { $email->admin_options(); break; } @@ -207,7 +232,7 @@ class WC_Settings_Emails extends WC_Settings_Page { } else { $wc_emails = WC_Emails::instance(); - if ( in_array( $current_section, array_map( 'sanitize_title', array_keys( $wc_emails->get_emails() ) ) ) ) { + if ( in_array( $current_section, array_map( 'sanitize_title', array_keys( $wc_emails->get_emails() ) ), true ) ) { foreach ( $wc_emails->get_emails() as $email_id => $email ) { if ( sanitize_title( $email_id ) === $current_section ) { do_action( 'woocommerce_update_options_' . $this->id . '_' . $email->id ); @@ -223,27 +248,30 @@ class WC_Settings_Emails extends WC_Settings_Page { * Output email notification settings. */ public function email_notification_setting() { - // Define emails that can be customised here + // Define emails that can be customised here. $mailer = WC()->mailer(); $email_templates = $mailer->get_emails(); + ?> - + - + + + ' . esc_attr__( 'Product image', 'woocommerce' ) . '', $item ); - } - - // Product name - echo apply_filters( 'woocommerce_order_item_name', $item->get_name(), $item, false ); - - // SKU - if ( $show_sku && is_object( $product ) && $product->get_sku() ) { - echo ' (#' . $product->get_sku() . ')'; - } - - // allow other plugins to add additional product information here - do_action( 'woocommerce_order_item_meta_start', $item_id, $item, $order, $plain_text ); - - wc_display_item_meta( $item ); - - // allow other plugins to add additional product information here - do_action( 'woocommerce_order_item_meta_end', $item_id, $item, $order, $plain_text ); - - ?> - - + if ( $show_purchase_note && $purchase_note ) { + ?> + + get_purchase_note() ) ) : ?> - - - - + ?> diff --git a/templates/emails/email-styles.php b/templates/emails/email-styles.php index 4da21ac1086..152ec467282 100644 --- a/templates/emails/email-styles.php +++ b/templates/emails/email-styles.php @@ -11,22 +11,27 @@ * the readme will list any important changes. * * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes * @package WooCommerce/Templates/Emails - * @version 2.3.0 + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + exit; } -// Load colors +// Load colors. $bg = get_option( 'woocommerce_email_background_color' ); $body = get_option( 'woocommerce_email_body_background_color' ); $base = get_option( 'woocommerce_email_base_color' ); $base_text = wc_light_or_dark( $base, '#202020', '#ffffff' ); $text = get_option( 'woocommerce_email_text_color' ); +// Pick a contrasting color for links. +$link = wc_hex_is_light( $base ) ? $base : $base_text; +if ( wc_hex_is_light( $body ) ) { + $link = wc_hex_is_light( $base ) ? $base_text : $base; +} + $bg_darker_10 = wc_hex_darker( $bg, 10 ); $body_darker_10 = wc_hex_darker( $body, 10 ); $base_lighter_20 = wc_hex_lighter( $base, 20 ); @@ -86,7 +91,7 @@ $text_lighter_20 = wc_hex_lighter( $text, 20 ); } #body_content table td { - padding: 48px; + padding: 48px 48px 0; } #body_content table td td { @@ -128,6 +133,7 @@ $text_lighter_20 = wc_hex_lighter( $text, 20 ); .td { color: ; border: 1px solid ; + vertical-align: middle; } .address { @@ -159,7 +165,6 @@ h1 { margin: 0; text-align: ; text-shadow: 0 1px 0 ; - -webkit-font-smoothing: antialiased; } h2 { @@ -185,20 +190,21 @@ h3 { } a { - color: ; + color: ; font-weight: normal; text-decoration: underline; } img { border: none; - display: inline; + display: inline-block; font-size: 14px; font-weight: bold; height: auto; - line-height: 100%; outline: none; text-decoration: none; text-transform: capitalize; + vertical-align: middle; + margin-: 10px; } get_id(), $order->get_formatted_billing_full_name() ) . "\n\n"; +/* translators: %1$s: Customer full name. %2$s: Order numer */ +echo sprintf( esc_html__( 'Alas. Just to let you know — %1$s has cancelled order #%2$s:', 'woocommerce' ), esc_html( $order->get_formatted_billing_full_name() ), esc_html( $order->get_order_number() ) ) . "\n\n"; echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -36,17 +36,19 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +echo esc_html__( 'Thanks for reading.', 'woocommerce' ) . "\n\n"; + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo esc_html( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) ); diff --git a/templates/emails/plain/admin-failed-order.php b/templates/emails/plain/admin-failed-order.php index 26f63648a32..84f9b6c6678 100644 --- a/templates/emails/plain/admin-failed-order.php +++ b/templates/emails/plain/admin-failed-order.php @@ -10,23 +10,23 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . $email_heading . " =\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped -echo sprintf( __( 'Payment for order #%1$d from %2$s has failed. The order was as follows:', 'woocommerce' ), $order->get_id(), $order->get_formatted_billing_full_name() ) . "\n\n"; +/* translators: %1$s: Order number. %2$s: Customer full name. */ +echo sprintf( esc_html__( 'Payment for order #%1$s from %2$s has failed. The order was as follows:', 'woocommerce' ), esc_html( $order->get_order_number() ), esc_html( $order->get_formatted_billing_full_name() ) ) . "\n\n"; echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -36,17 +36,19 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +echo esc_html__( 'Hopefully they’ll be back. Read more about troubleshooting failed payments.', 'woocommerce' ) . "\n\n"; + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo esc_html( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) ); diff --git a/templates/emails/plain/admin-new-order.php b/templates/emails/plain/admin-new-order.php index cc920b80450..5624ba53425 100644 --- a/templates/emails/plain/admin-new-order.php +++ b/templates/emails/plain/admin-new-order.php @@ -10,23 +10,23 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . esc_html( $email_heading ) . " =\n\n"; -echo sprintf( __( 'You have received an order from %s.', 'woocommerce' ), $order->get_formatted_billing_full_name() ) . "\n\n"; +/* translators: %s: Customer billing full name */ +echo sprintf( esc_html__( 'You’ve received the following order from %s:', 'woocommerce' ), esc_html( $order->get_formatted_billing_full_name() ) ) . "\n\n"; echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -36,17 +36,19 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +echo esc_html__( 'Over to you.', 'woocommerce' ) . "\n\n"; + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo esc_html( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) ); diff --git a/templates/emails/plain/customer-completed-order.php b/templates/emails/plain/customer-completed-order.php index e6b5abe03dc..4e2aa4afa5e 100644 --- a/templates/emails/plain/customer-completed-order.php +++ b/templates/emails/plain/customer-completed-order.php @@ -10,23 +10,25 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . esc_html( $email_heading ) . " =\n\n"; -echo sprintf( __( "Hi there. Your recent order on %s has been completed. Your order details are shown below for your reference:", 'woocommerce' ), get_option( 'blogname' ) ) . "\n\n"; +/* translators: %s: Customer first name */ +echo sprintf( esc_html__( 'Hi %s,', 'woocommerce' ), esc_html( $order->get_billing_first_name() ) ) . "\n\n"; +/* translators: %s: Site title */ +echo sprintf( esc_html__( 'Your %s order has been marked complete on our side.', 'woocommerce' ), esc_html( wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES ) ) ) . "\n\n"; echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -36,17 +38,19 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +echo esc_html__( 'Thanks for shopping with us.', 'woocommerce' ) . "\n\n"; + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo esc_html( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) ); // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped diff --git a/templates/emails/plain/customer-invoice.php b/templates/emails/plain/customer-invoice.php index 41d5c6f8520..24c6376e257 100644 --- a/templates/emails/plain/customer-invoice.php +++ b/templates/emails/plain/customer-invoice.php @@ -10,25 +10,37 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . esc_html( $email_heading ) . " =\n\n"; + +/* translators: %s: Customer first name */ +echo sprintf( esc_html__( 'Hi %s,', 'woocommerce' ), esc_html( $order->get_billing_first_name() ) ) . "\n\n"; if ( $order->has_status( 'pending' ) ) { - echo sprintf( __( 'An order has been created for you on %1$s. To pay for this order please use the following link: %2$s', 'woocommerce' ), get_bloginfo( 'name', 'display' ), $order->get_checkout_payment_url() ) . "\n\n"; -} + echo sprintf( + /* translators: %1$s Site title, %2$s Order pay link */ + __( 'An order has been created for you on %1$s. Your invoice is below, with a link to make payment when you’re ready: %2$s', 'woocommerce' ), + esc_html( get_bloginfo( 'name', 'display' ) ), + esc_url( $order->get_checkout_payment_url() ) + ) . "\n\n"; +} else { + /* translators: %s Order date */ + echo sprintf( esc_html__( 'Here are the details of your order placed on %s:', 'woocommerce' ), esc_html( wc_format_datetime( $this->object->get_date_created() ) ) ) . "\n\n"; +} echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; /** + * Hook for the woocommerce_email_order_details. + * * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -39,16 +51,22 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; /** + * Hook for the woocommerce_email_order_meta. + * * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); /** + * Hook for woocommerce_email_customer_details + * * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +echo esc_html__( 'Thanks for reading.', 'woocommerce' ) . "\n\n"; + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo esc_html( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) ); diff --git a/templates/emails/plain/customer-new-account.php b/templates/emails/plain/customer-new-account.php index 82180ab4454..9fc86d042a2 100644 --- a/templates/emails/plain/customer-new-account.php +++ b/templates/emails/plain/customer-new-account.php @@ -10,26 +10,29 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.0.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + exit; // Exit if accessed directly. } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . esc_html( $email_heading ) . " =\n\n"; -echo sprintf( __( 'Thanks for creating an account on %1$s. Your username is %2$s', 'woocommerce' ), $blogname, '' . $user_login . '' ) . "\n\n"; +/* translators: %s Customer first name */ +echo sprintf( esc_html__( 'Hi %s,', 'woocommerce' ), esc_html( $user_login ) ) . "\n\n"; +/* translators: %1$s: Site title, %2$s: Username, %3$s: My account link */ +echo sprintf( esc_html__( 'Thanks for creating an account on %1$s. As a reminder, the username you chose is %2$s. You can access your account area to view orders, change your password, and more at: %3$s', 'woocommerce' ), esc_html( $blogname ), '' . esc_html( $user_login ) . '', esc_html( wc_get_page_permalink( 'myaccount' ) ) ) . "\n\n"; if ( 'yes' === get_option( 'woocommerce_registration_generate_password' ) && $password_generated ) { - echo sprintf( __( 'Your password is %s.', 'woocommerce' ), '' . $user_pass . '' ) . "\n\n"; + /* translators: %s Auto generated password */ + echo sprintf( esc_html__( 'Your password has been automatically generated: %s.', 'woocommerce' ), esc_html( $user_pass ) ) . "\n\n"; } -echo sprintf( __( 'You can access your account area to view your orders and change your password here: %s.', 'woocommerce' ), wc_get_page_permalink( 'myaccount' ) ) . "\n\n"; +echo esc_html__( 'We look forward to seeing you soon.', 'woocommerce' ) . "\n\n"; echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped diff --git a/templates/emails/plain/customer-note.php b/templates/emails/plain/customer-note.php index e4b2affe443..28d19c10491 100644 --- a/templates/emails/plain/customer-note.php +++ b/templates/emails/plain/customer-note.php @@ -10,31 +10,33 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . esc_html( $email_heading ) . " =\n\n"; -echo __( "Hello, a note has just been added to your order:", 'woocommerce' ) . "\n\n"; +/* translators: %s Customer first name */ +echo sprintf( esc_html__( 'Hi %s,', 'woocommerce' ), esc_html( $order->get_billing_first_name() ) ) . "\n\n"; +echo esc_html__( 'The following note has been added to your order:', 'woocommerce' ) . "\n\n"; echo "----------\n\n"; -echo wptexturize( $customer_note ) . "\n\n"; +echo wptexturize( $customer_note ) . "\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped echo "----------\n\n"; -echo __( "For your reference, your order details are shown below.", 'woocommerce' ) . "\n\n"; +echo esc_html__( 'As a reminder, here are your order details:', 'woocommerce' ) . "\n\n"; echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -44,17 +46,19 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +echo esc_html__( 'Thanks for reading.', 'woocommerce' ) . "\n\n"; + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo esc_html( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) ); diff --git a/templates/emails/plain/customer-on-hold-order.php b/templates/emails/plain/customer-on-hold-order.php index 04bec34671a..c61f43ff856 100644 --- a/templates/emails/plain/customer-on-hold-order.php +++ b/templates/emails/plain/customer-on-hold-order.php @@ -10,23 +10,24 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . $email_heading . " =\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped -echo __( "Your order is on-hold until we confirm payment has been received. Your order details are shown below for your reference:", 'woocommerce' ) . "\n\n"; +/* translators: %s: Customer first name */ +echo sprintf( __( 'Hi %s,', 'woocommerce' ), $order->get_billing_first_name() ) . "\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped +echo __( 'Thanks for your order. It’s on-hold until we confirm that payment has been received. In the meantime, here’s a reminder of what you ordered:', 'woocommerce' ) . "\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -36,17 +37,19 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +_e( 'We look forward to fulfilling your order soon.', 'woocommerce' ); // phpcs:ignore WordPress.XSS.EscapeOutput + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); // phpcs:ignore WordPress.XSS.EscapeOutput diff --git a/templates/emails/plain/customer-processing-order.php b/templates/emails/plain/customer-processing-order.php index 43d251b1a39..4ea616b1e19 100644 --- a/templates/emails/plain/customer-processing-order.php +++ b/templates/emails/plain/customer-processing-order.php @@ -10,23 +10,25 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . esc_html( $email_heading ) . " =\n\n"; -echo __( "Your order has been received and is now being processed. Your order details are shown below for your reference:", 'woocommerce' ) . "\n\n"; +/* translators: %s: Customer first name */ +echo sprintf( esc_html__( 'Hi %s,', 'woocommerce' ), esc_html( $order->get_billing_first_name() ) ) . "\n\n"; +/* translators: %s: Order number */ +echo sprintf( esc_html__( 'Just to let you know — your payment has been confirmed, and order #%s is now being processed:', 'woocommerce' ), esc_html( $order->get_order_number() ) ) . "\n\n"; echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -36,17 +38,19 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +echo esc_html_e( 'Thanks!', 'woocommerce' ) . "\n\n"; + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo esc_html( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) ); diff --git a/templates/emails/plain/customer-refunded-order.php b/templates/emails/plain/customer-refunded-order.php index d87d65d42b0..37831394d84 100644 --- a/templates/emails/plain/customer-refunded-order.php +++ b/templates/emails/plain/customer-refunded-order.php @@ -10,23 +10,29 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "= " . $email_heading . " =\n\n"; - -echo sprintf( __( "Hi there. Your order on %s has been refunded. Your order details are shown below for your reference:", 'woocommerce' ), get_option( 'blogname' ) ) . "\n\n"; +echo '= ' . $email_heading . " =\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped +/* translators: %s: Customer first name */ +echo sprintf( __( 'Hi %s,', 'woocommerce' ), $order->get_billing_first_name() ) . "\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped +if ( $partial_refund ) { + /* translators: %s: Site title */ + echo sprintf( __( 'Your order on %s has been partially refunded. There are more details below for your reference:', 'woocommerce' ), wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES ) ) . "\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped +} else { + /* translators: %s: Site title */ + echo sprintf( __( 'Your order on %s has been refunded. There are more details below for your reference:', 'woocommerce' ), wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES ) ) . "\n\n"; // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped +} echo "=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_details() Shows the order details table. * @hooked WC_Structured_Data::generate_order_data() Generates structured data. * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. @@ -36,17 +42,19 @@ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_tex echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +echo esc_html__( 'We hope to see you again soon.', 'woocommerce' ) . "\n\n"; + echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped diff --git a/templates/emails/plain/customer-reset-password.php b/templates/emails/plain/customer-reset-password.php index ad36cb3e48e..3c6df74c8be 100644 --- a/templates/emails/plain/customer-reset-password.php +++ b/templates/emails/plain/customer-reset-password.php @@ -10,26 +10,27 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates/Emails/Plain - * @version 2.3.0 + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + exit; // Exit if accessed directly. } -echo "= " . $email_heading . " =\n\n"; +echo '= ' . esc_html( $email_heading ) . " =\n\n"; -echo __( 'Someone requested that the password be reset for the following account:', 'woocommerce' ) . "\r\n\r\n"; -echo esc_url( network_home_url( '/' ) ) . "\r\n\r\n"; -echo sprintf( __( 'Username: %s', 'woocommerce' ), $user_login ) . "\r\n\r\n"; -echo __( 'If this was a mistake, just ignore this email and nothing will happen.', 'woocommerce' ) . "\r\n\r\n"; -echo __( 'To reset your password, visit the following address:', 'woocommerce' ) . "\r\n\r\n"; - -echo esc_url( add_query_arg( array( 'key' => $reset_key, 'login' => $user_login ), wc_get_endpoint_url( 'lost-password', '', wc_get_page_permalink( 'myaccount' ) ) ) ) . "\r\n"; +/* translators: %s: Customer first name */ +echo sprintf( esc_html__( 'Hi %s,', 'woocommerce' ), esc_html( $user_login ) ) . "\n\n"; +/* translators: %s: Store name */ +echo sprintf( esc_html__( 'Someone has requested a new password for the following account on %s:', 'woocommerce' ), esc_html( wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES ) ) ) . "\n\n"; +/* translators: %s: Customer username */ +echo sprintf( esc_html__( 'Username: %s', 'woocommerce' ), esc_html( $user_login ) ) . "\n\n"; +echo esc_html__( 'If you didn\'t make this request, just ignore this email. If you\'d like to proceed:', 'woocommerce' ) . "\n\n"; +echo esc_url( add_query_arg( array( 'key' => $reset_key, 'id' => $user_id ), wc_get_endpoint_url( 'lost-password', '', wc_get_page_permalink( 'myaccount' ) ) ) ) . "\n\n"; // phpcs:ignore +echo esc_html__( 'Thanks for reading.', 'woocommerce' ) . "\n\n"; echo "\n=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n\n"; -echo apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ); +echo esc_html( apply_filters( 'woocommerce_email_footer_text', get_option( 'woocommerce_email_footer_text' ) ) ); diff --git a/templates/emails/plain/email-addresses.php b/templates/emails/plain/email-addresses.php index e051d48fc48..d460c99d90f 100644 --- a/templates/emails/plain/email-addresses.php +++ b/templates/emails/plain/email-addresses.php @@ -10,24 +10,31 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 3.2.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.4.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo "\n" . strtoupper( __( 'Billing address', 'woocommerce' ) ) . "\n\n"; -echo preg_replace( '##i', "\n", $order->get_formatted_billing_address() ) . "\n"; +echo "\n" . esc_html( wc_strtoupper( __( 'Billing address', 'woocommerce' ) ) ) . "\n\n"; +echo preg_replace( '##i', "\n", $order->get_formatted_billing_address() ) . "\n"; // WPCS: XSS ok. if ( $order->get_billing_phone() ) { - echo $order->get_billing_phone() . "\n"; + echo $order->get_billing_phone() . "\n"; // WPCS: XSS ok. } -if ( ! wc_ship_to_billing_address_only() && $order->needs_shipping_address() && ( $shipping = $order->get_formatted_shipping_address() ) ) { - echo "\n" . strtoupper( __( 'Shipping address', 'woocommerce' ) ) . "\n\n"; - echo preg_replace( '##i', "\n", $shipping ) . "\n"; +if ( $order->get_billing_email() ) { + echo $order->get_billing_email() . "\n"; // WPCS: XSS ok. +} + +if ( ! wc_ship_to_billing_address_only() && $order->needs_shipping_address() ) { + $shipping = $order->get_formatted_shipping_address(); + + if ( $shipping ) { + echo "\n" . esc_html( wc_strtoupper( __( 'Shipping address', 'woocommerce' ) ) ) . "\n\n"; + echo preg_replace( '##i', "\n", $shipping ) . "\n"; // WPCS: XSS ok. + } } diff --git a/templates/emails/plain/email-customer-details.php b/templates/emails/plain/email-customer-details.php index 55e3b48e632..2671ac1db7c 100644 --- a/templates/emails/plain/email-customer-details.php +++ b/templates/emails/plain/email-customer-details.php @@ -12,17 +12,16 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails/Plain - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails/Plain + * @version 3.4.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -echo strtoupper( __( 'Customer details', 'woocommerce' ) ) . "\n\n"; +echo esc_html( wc_strtoupper( __( 'Customer details', 'woocommerce' ) ) ) . "\n\n"; foreach ( $fields as $field ) { echo wp_kses_post( $field['label'] ) . ': ' . wp_kses_post( $field['value'] ) . "\n"; diff --git a/templates/emails/plain/email-downloads.php b/templates/emails/plain/email-downloads.php index dfb3d49ba5b..9f0a3f646fe 100644 --- a/templates/emails/plain/email-downloads.php +++ b/templates/emails/plain/email-downloads.php @@ -10,39 +10,36 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 3.2.0 + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; -echo strtoupper( __( 'Downloads', 'woocommerce' ) ) . "\n\n"; +echo esc_html( wc_strtoupper( __( 'Downloads', 'woocommerce' ) ) ) . "\n\n"; foreach ( $downloads as $download ) { foreach ( $columns as $column_id => $column_name ) { - echo $column_name . ": "; + echo wp_kses_post( $column_name ) . ': '; if ( has_action( 'woocommerce_email_downloads_column_' . $column_id ) ) { - do_action( 'woocommerce_email_downloads_column_' . $column_id, $download ); + do_action( 'woocommerce_email_downloads_column_' . $column_id, $download, $plain_text ); } else { switch ( $column_id ) { - case 'download-product' : + case 'download-product': echo esc_html( $download['product_name'] ); - break; - case 'download-file' : + break; + case 'download-file': echo esc_html( $download['download_name'] ) . ' - ' . esc_url( $download['download_url'] ); - break; - case 'download-expires' : + break; + case 'download-expires': if ( ! empty( $download['access_expires'] ) ) { - echo date_i18n( get_option( 'date_format' ), strtotime( $download['access_expires'] ) ); + echo esc_html( date_i18n( get_option( 'date_format' ), strtotime( $download['access_expires'] ) ) ); } else { - _e( 'Never', 'woocommerce' ); + esc_html_e( 'Never', 'woocommerce' ); } - break; + break; } } echo "\n"; diff --git a/templates/emails/plain/email-order-details.php b/templates/emails/plain/email-order-details.php index 853f3a81df4..b9df61272ab 100644 --- a/templates/emails/plain/email-order-details.php +++ b/templates/emails/plain/email-order-details.php @@ -10,10 +10,9 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails - * @version 3.2.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { @@ -22,9 +21,9 @@ if ( ! defined( 'ABSPATH' ) ) { do_action( 'woocommerce_email_before_order_table', $order, $sent_to_admin, $plain_text, $email ); -echo strtoupper( sprintf( __( 'Order number: %s', 'woocommerce' ), $order->get_order_number() ) ) . "\n"; -echo wc_format_datetime( $order->get_date_created() ) . "\n"; -echo "\n" . wc_get_email_order_items( $order, array( +/* translators: %1$s: Order ID. %2$s: Order date */ +echo wp_kses_post( wc_strtoupper( sprintf( __( '[Order #%1$s] (%2$s)', 'woocommerce' ), $order->get_order_number(), wc_format_datetime( $order->get_date_created() ) ) ) ) . "\n"; +echo "\n" . wc_get_email_order_items( $order, array( // WPCS: XSS ok. 'show_sku' => $sent_to_admin, 'show_image' => false, 'image_size' => array( 32, 32 ), @@ -34,18 +33,21 @@ echo "\n" . wc_get_email_order_items( $order, array( echo "==========\n\n"; -if ( $totals = $order->get_order_item_totals() ) { +$totals = $order->get_order_item_totals(); + +if ( $totals ) { foreach ( $totals as $total ) { - echo $total['label'] . "\t " . $total['value'] . "\n"; + echo wp_kses_post( $total['label'] . "\t " . $total['value'] ) . "\n"; } } if ( $order->get_customer_note() ) { - echo __( 'Note:', 'woocommerce' ) . "\t " . wptexturize( $order->get_customer_note() ) . "\n"; + echo esc_html__( 'Note:', 'woocommerce' ) . "\t " . wp_kses_post( wptexturize( $order->get_customer_note() ) ) . "\n"; } if ( $sent_to_admin ) { - echo "\n" . sprintf( __( 'View order: %s', 'woocommerce' ), admin_url( 'post.php?post=' . $order->get_id() . '&action=edit' ) ) . "\n"; + /* translators: %s: Order link. */ + echo "\n" . sprintf( esc_html__( 'View order: %s', 'woocommerce' ), esc_url( $order->get_edit_order_url() ) ) . "\n"; } do_action( 'woocommerce_email_after_order_table', $order, $sent_to_admin, $plain_text, $email ); diff --git a/templates/global/form-login.php b/templates/global/form-login.php index 82793796c48..3dc991879e8 100644 --- a/templates/global/form-login.php +++ b/templates/global/form-login.php @@ -13,11 +13,11 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 2.1.0 + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + exit; // Exit if accessed directly. } if ( is_user_logged_in() ) { @@ -25,34 +25,34 @@ if ( is_user_logged_in() ) { } ?> -> +> - +

          - - + +

          - - + +

          - - + +

          - +

          diff --git a/templates/global/quantity-input.php b/templates/global/quantity-input.php index cd691556e53..f5333e876a5 100644 --- a/templates/global/quantity-input.php +++ b/templates/global/quantity-input.php @@ -10,26 +10,39 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; if ( $max_value && $min_value === $max_value ) { ?>
          - + +
          '; + break; case 'twentyeleven' : echo ''; get_sidebar( 'shop' ); @@ -45,6 +48,6 @@ switch ( $template ) { echo ''; break; default : - echo ''; + echo ''; break; } diff --git a/templates/global/wrapper-start.php b/templates/global/wrapper-start.php index 55117b0ce15..3b0d787eb76 100644 --- a/templates/global/wrapper-start.php +++ b/templates/global/wrapper-start.php @@ -13,16 +13,19 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 1.6.4 + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly } -$template = get_option( 'template' ); +$template = wc_get_theme_slug_for_templates(); switch ( $template ) { + case 'twentyten' : + echo '
          '; + break; case 'twentyeleven' : echo '
          '; break; @@ -42,6 +45,6 @@ switch ( $template ) { echo '
          '; break; default : - echo '
          '; + echo '
          '; break; } diff --git a/templates/loop/add-to-cart.php b/templates/loop/add-to-cart.php index 5a20a0cdb31..67182c69576 100644 --- a/templates/loop/add-to-cart.php +++ b/templates/loop/add-to-cart.php @@ -13,7 +13,7 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 3.0.0 + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { @@ -22,13 +22,12 @@ if ( ! defined( 'ABSPATH' ) ) { global $product; -echo apply_filters( 'woocommerce_loop_add_to_cart_link', - sprintf( '%s', +echo apply_filters( 'woocommerce_loop_add_to_cart_link', // WPCS: XSS ok. + sprintf( '%s', esc_url( $product->add_to_cart_url() ), - esc_attr( isset( $quantity ) ? $quantity : 1 ), - esc_attr( $product->get_id() ), - esc_attr( $product->get_sku() ), - esc_attr( isset( $class ) ? $class : 'button' ), + esc_attr( isset( $args['quantity'] ) ? $args['quantity'] : 1 ), + esc_attr( isset( $args['class'] ) ? $args['class'] : 'button' ), + isset( $args['attributes'] ) ? wc_implode_html_attributes( $args['attributes'] ) : '', esc_html( $product->add_to_cart_text() ) ), -$product ); +$product, $args ); diff --git a/templates/loop/loop-end.php b/templates/loop/loop-end.php index 93faec1bd02..7d4e229fffa 100644 --- a/templates/loop/loop-end.php +++ b/templates/loop/loop-end.php @@ -15,5 +15,9 @@ * @package WooCommerce/Templates * @version 2.0.0 */ + +if ( ! defined( 'ABSPATH' ) ) { + exit; +} ?> diff --git a/templates/loop/loop-start.php b/templates/loop/loop-start.php index 2d9c5f53fd0..34bbd5b8af3 100644 --- a/templates/loop/loop-start.php +++ b/templates/loop/loop-start.php @@ -13,7 +13,11 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 2.0.0 + * @version 3.3.0 */ + +if ( ! defined( 'ABSPATH' ) ) { + exit; +} ?> -
            +
              diff --git a/templates/loop/orderby.php b/templates/loop/orderby.php index f262297d35d..5ffb058e7bd 100644 --- a/templates/loop/orderby.php +++ b/templates/loop/orderby.php @@ -13,11 +13,11 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 2.2.0 + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + exit; } ?> @@ -27,5 +27,6 @@ if ( ! defined( 'ABSPATH' ) ) { - + + diff --git a/templates/loop/pagination.php b/templates/loop/pagination.php index cf394db03b2..a3b32259ae4 100644 --- a/templates/loop/pagination.php +++ b/templates/loop/pagination.php @@ -10,30 +10,32 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 2.2.2 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.3.1 */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + exit; } -global $wp_query; +$total = isset( $total ) ? $total : wc_get_loop_prop( 'total_pages' ); +$current = isset( $current ) ? $current : wc_get_loop_prop( 'current_page' ); +$base = isset( $base ) ? $base : esc_url_raw( str_replace( 999999999, '%#%', remove_query_arg( 'add-to-cart', get_pagenum_link( 999999999, false ) ) ) ); +$format = isset( $format ) ? $format : ''; -if ( $wp_query->max_num_pages <= 1 ) { +if ( $total <= 1 ) { return; } ?>
          - + diff --git a/templates/order/order-details.php b/templates/order/order-details.php index e9c678a9984..b3c3d5af810 100644 --- a/templates/order/order-details.php +++ b/templates/order/order-details.php @@ -13,7 +13,7 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 3.2.0 + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { @@ -34,6 +34,8 @@ if ( $show_downloads ) { } ?>
          + +

          - - - - '', - 'name' => __( 'Gateway', 'woocommerce' ), - 'id' => __( 'Gateway ID', 'woocommerce' ), - 'status' => __( 'Enabled', 'woocommerce' ), - ) ); - - foreach ( $columns as $key => $column ) { - echo ''; - } - ?> - - - - payment_gateways->payment_gateways() as $gateway ) { - - echo ''; - - foreach ( $columns as $key => $column ) { - - switch ( $key ) { - - case 'sort' : - echo ''; - break; - - case 'name' : - $method_title = $gateway->get_title() ? $gateway->get_title() : __( '(no title)', 'woocommerce' ); - echo ''; - break; - - case 'id' : - echo ''; - break; - - case 'status' : - echo ''; - break; - - default : - do_action( 'woocommerce_payment_gateways_setting_column_' . $key, $gateway ); - break; - } - } - - echo ''; - } - ?> - -
          ' . esc_html( $column ) . '
          - - - ' . esc_html( $method_title ) . ' - ' . esc_html( $gateway->id ) . ''; - echo ( 'yes' === $gateway->enabled ) ? '' . esc_html__( 'Yes', 'woocommerce' ) . '' : '-'; - echo '
          -
          - - - - '', - 'name' => __( 'Email', 'woocommerce' ), - 'email_type' => __( 'Content type', 'woocommerce' ), - 'recipient' => __( 'Recipient(s)', 'woocommerce' ), - 'actions' => '', - ) ); - foreach ( $columns as $key => $column ) { - echo ''; - } - ?> +
          + + + + '', + 'name' => __( 'Email', 'woocommerce' ), + 'email_type' => __( 'Content type', 'woocommerce' ), + 'recipient' => __( 'Recipient(s)', 'woocommerce' ), + 'actions' => '', + ) + ); + foreach ( $columns as $key => $column ) { + echo ''; + } + ?> @@ -254,18 +282,18 @@ class WC_Settings_Emails extends WC_Settings_Page { foreach ( $columns as $key => $column ) { switch ( $key ) { - case 'name' : + case 'name': echo ''; - break; - case 'recipient' : + ' . esc_html( $email->get_title() ) . ' + ' . wc_help_tip( $email->get_description() ) . ' + '; + break; + case 'recipient': echo ''; - break; - case 'status' : + ' . esc_html( $email->is_customer_email() ? __( 'Customer', 'woocommerce' ) : $email->get_recipient() ) . ' + '; + break; + case 'status': echo ''; - break; - case 'email_type' : + break; + case 'email_type': echo ''; - break; - case 'actions' : + ' . esc_html( $email->get_content_type() ) . ' + '; + break; + case 'actions': echo ''; - break; - default : + ' . esc_html__( 'Manage', 'woocommerce' ) . ' + '; + break; + default: do_action( 'woocommerce_email_setting_column_' . $key, $email ); - break; + break; } } @@ -305,6 +333,4 @@ class WC_Settings_Emails extends WC_Settings_Page { } } -endif; - return new WC_Settings_Emails(); diff --git a/includes/admin/settings/class-wc-settings-general.php b/includes/admin/settings/class-wc-settings-general.php index 716945c4aca..06d0d6c6fdd 100644 --- a/includes/admin/settings/class-wc-settings-general.php +++ b/includes/admin/settings/class-wc-settings-general.php @@ -2,17 +2,14 @@ /** * WooCommerce General Settings * - * @author WooThemes - * @category Admin - * @package WooCommerce/Admin - * @version 2.1.0 + * @package WooCommerce/Admin */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; -if ( ! class_exists( 'WC_Settings_General', false ) ) : +if ( class_exists( 'WC_Settings_General', false ) ) { + return new WC_Settings_General(); +} /** * WC_Admin_Settings_General. @@ -23,13 +20,10 @@ class WC_Settings_General extends WC_Settings_Page { * Constructor. */ public function __construct() { - $this->id = 'general'; $this->label = __( 'General', 'woocommerce' ); - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); + parent::__construct(); } /** @@ -45,233 +39,265 @@ class WC_Settings_General extends WC_Settings_Page { $currency_code_options[ $code ] = $name . ' (' . get_woocommerce_currency_symbol( $code ) . ')'; } - $settings = apply_filters( 'woocommerce_general_settings', array( + $woocommerce_default_customer_address_options = array( + '' => __( 'No location by default', 'woocommerce' ), + 'base' => __( 'Shop base address', 'woocommerce' ), + 'geolocation' => __( 'Geolocate', 'woocommerce' ), + 'geolocation_ajax' => __( 'Geolocate (with page caching support)', 'woocommerce' ), + ); - array( - 'title' => __( 'Store Address', 'woocommerce' ), - 'type' => 'title', - 'desc' => __( 'This is where your business is located. Tax rates and shipping rates will use this address.', 'woocommerce' ), - 'id' => 'store_address', - ), + if ( version_compare( PHP_VERSION, '5.4', '<' ) ) { + unset( $woocommerce_default_customer_address_options['geolocation'], $woocommerce_default_customer_address_options['geolocation_ajax'] ); + } - array( - 'title' => __( 'Address line 1', 'woocommerce' ), - 'desc' => __( 'The street address for your business location.', 'woocommerce' ), - 'id' => 'woocommerce_store_address', - 'default' => '', - 'type' => 'text', - 'desc_tip' => true, - ), + $settings = apply_filters( + 'woocommerce_general_settings', array( - array( - 'title' => __( 'Address line 2', 'woocommerce' ), - 'desc' => __( 'An additional, optional address line for your business location.', 'woocommerce' ), - 'id' => 'woocommerce_store_address_2', - 'default' => '', - 'type' => 'text', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'City', 'woocommerce' ), - 'desc' => __( 'The city in which your business is located.', 'woocommerce' ), - 'id' => 'woocommerce_store_city', - 'default' => '', - 'type' => 'text', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Country / State', 'woocommerce' ), - 'desc' => __( 'The country and state or province, if any, in which your business is located.', 'woocommerce' ), - 'id' => 'woocommerce_default_country', - 'default' => 'GB', - 'type' => 'single_select_country', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Postcode / ZIP', 'woocommerce' ), - 'desc' => __( 'The postal code, if any, in which your business is located.', 'woocommerce' ), - 'id' => 'woocommerce_store_postcode', - 'css' => 'min-width:50px;', - 'default' => '', - 'type' => 'text', - 'desc_tip' => true, - ), - - array( 'type' => 'sectionend', 'id' => 'store_address' ), - - array( 'title' => __( 'General options', 'woocommerce' ), 'type' => 'title', 'desc' => '', 'id' => 'general_options' ), - - array( - 'title' => __( 'Selling location(s)', 'woocommerce' ), - 'desc' => __( 'This option lets you limit which countries you are willing to sell to.', 'woocommerce' ), - 'id' => 'woocommerce_allowed_countries', - 'default' => 'all', - 'type' => 'select', - 'class' => 'wc-enhanced-select', - 'css' => 'min-width: 350px;', - 'desc_tip' => true, - 'options' => array( - 'all' => __( 'Sell to all countries', 'woocommerce' ), - 'all_except' => __( 'Sell to all countries, except for…', 'woocommerce' ), - 'specific' => __( 'Sell to specific countries', 'woocommerce' ), + array( + 'title' => __( 'Store Address', 'woocommerce' ), + 'type' => 'title', + 'desc' => __( 'This is where your business is located. Tax rates and shipping rates will use this address.', 'woocommerce' ), + 'id' => 'store_address', ), - ), - array( - 'title' => __( 'Sell to all countries, except for…', 'woocommerce' ), - 'desc' => '', - 'id' => 'woocommerce_all_except_countries', - 'css' => 'min-width: 350px;', - 'default' => '', - 'type' => 'multi_select_countries', - ), - - array( - 'title' => __( 'Sell to specific countries', 'woocommerce' ), - 'desc' => '', - 'id' => 'woocommerce_specific_allowed_countries', - 'css' => 'min-width: 350px;', - 'default' => '', - 'type' => 'multi_select_countries', - ), - - array( - 'title' => __( 'Shipping location(s)', 'woocommerce' ), - 'desc' => __( 'Choose which countries you want to ship to, or choose to ship to all locations you sell to.', 'woocommerce' ), - 'id' => 'woocommerce_ship_to_countries', - 'default' => '', - 'type' => 'select', - 'class' => 'wc-enhanced-select', - 'desc_tip' => true, - 'options' => array( - '' => __( 'Ship to all countries you sell to', 'woocommerce' ), - 'all' => __( 'Ship to all countries', 'woocommerce' ), - 'specific' => __( 'Ship to specific countries only', 'woocommerce' ), - 'disabled' => __( 'Disable shipping & shipping calculations', 'woocommerce' ), + array( + 'title' => __( 'Address line 1', 'woocommerce' ), + 'desc' => __( 'The street address for your business location.', 'woocommerce' ), + 'id' => 'woocommerce_store_address', + 'default' => '', + 'type' => 'text', + 'desc_tip' => true, ), - ), - array( - 'title' => __( 'Ship to specific countries', 'woocommerce' ), - 'desc' => '', - 'id' => 'woocommerce_specific_ship_to_countries', - 'css' => '', - 'default' => '', - 'type' => 'multi_select_countries', - ), - - array( - 'title' => __( 'Default customer location', 'woocommerce' ), - 'id' => 'woocommerce_default_customer_address', - 'desc_tip' => __( 'This option determines a customers default location. The MaxMind GeoLite Database will be periodically downloaded to your wp-content directory if using geolocation.', 'woocommerce' ), - 'default' => 'geolocation', - 'type' => 'select', - 'class' => 'wc-enhanced-select', - 'options' => array( - '' => __( 'No location by default', 'woocommerce' ), - 'base' => __( 'Shop base address', 'woocommerce' ), - 'geolocation' => __( 'Geolocate', 'woocommerce' ), - 'geolocation_ajax' => __( 'Geolocate (with page caching support)', 'woocommerce' ), + array( + 'title' => __( 'Address line 2', 'woocommerce' ), + 'desc' => __( 'An additional, optional address line for your business location.', 'woocommerce' ), + 'id' => 'woocommerce_store_address_2', + 'default' => '', + 'type' => 'text', + 'desc_tip' => true, ), - ), - array( - 'title' => __( 'Enable taxes', 'woocommerce' ), - 'desc' => __( 'Enable taxes and tax calculations', 'woocommerce' ), - 'id' => 'woocommerce_calc_taxes', - 'default' => 'no', - 'type' => 'checkbox', - ), - - array( - 'title' => __( 'Store notice', 'woocommerce' ), - 'desc' => __( 'Enable site-wide store notice text', 'woocommerce' ), - 'id' => 'woocommerce_demo_store', - 'default' => 'no', - 'type' => 'checkbox', - ), - - array( - 'title' => __( 'Store notice text', 'woocommerce' ), - 'desc' => '', - 'id' => 'woocommerce_demo_store_notice', - 'default' => __( 'This is a demo store for testing purposes — no orders shall be fulfilled.', 'woocommerce' ), - 'type' => 'textarea', - 'css' => 'width:350px; height: 65px;', - 'autoload' => false, - ), - - array( 'type' => 'sectionend', 'id' => 'general_options' ), - - array( 'title' => __( 'Currency options', 'woocommerce' ), 'type' => 'title', 'desc' => __( 'The following options affect how prices are displayed on the frontend.', 'woocommerce' ), 'id' => 'pricing_options' ), - - array( - 'title' => __( 'Currency', 'woocommerce' ), - 'desc' => __( 'This controls what currency prices are listed at in the catalog and which currency gateways will take payments in.', 'woocommerce' ), - 'id' => 'woocommerce_currency', - 'default' => 'GBP', - 'type' => 'select', - 'class' => 'wc-enhanced-select', - 'desc_tip' => true, - 'options' => $currency_code_options, - ), - - array( - 'title' => __( 'Currency position', 'woocommerce' ), - 'desc' => __( 'This controls the position of the currency symbol.', 'woocommerce' ), - 'id' => 'woocommerce_currency_pos', - 'class' => 'wc-enhanced-select', - 'default' => 'left', - 'type' => 'select', - 'options' => array( - 'left' => __( 'Left', 'woocommerce' ) . ' (' . get_woocommerce_currency_symbol() . '99.99)', - 'right' => __( 'Right', 'woocommerce' ) . ' (99.99' . get_woocommerce_currency_symbol() . ')', - 'left_space' => __( 'Left with space', 'woocommerce' ) . ' (' . get_woocommerce_currency_symbol() . ' 99.99)', - 'right_space' => __( 'Right with space', 'woocommerce' ) . ' (99.99 ' . get_woocommerce_currency_symbol() . ')', + array( + 'title' => __( 'City', 'woocommerce' ), + 'desc' => __( 'The city in which your business is located.', 'woocommerce' ), + 'id' => 'woocommerce_store_city', + 'default' => '', + 'type' => 'text', + 'desc_tip' => true, ), - 'desc_tip' => true, - ), - array( - 'title' => __( 'Thousand separator', 'woocommerce' ), - 'desc' => __( 'This sets the thousand separator of displayed prices.', 'woocommerce' ), - 'id' => 'woocommerce_price_thousand_sep', - 'css' => 'width:50px;', - 'default' => ',', - 'type' => 'text', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Decimal separator', 'woocommerce' ), - 'desc' => __( 'This sets the decimal separator of displayed prices.', 'woocommerce' ), - 'id' => 'woocommerce_price_decimal_sep', - 'css' => 'width:50px;', - 'default' => '.', - 'type' => 'text', - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Number of decimals', 'woocommerce' ), - 'desc' => __( 'This sets the number of decimal points shown in displayed prices.', 'woocommerce' ), - 'id' => 'woocommerce_price_num_decimals', - 'css' => 'width:50px;', - 'default' => '2', - 'desc_tip' => true, - 'type' => 'number', - 'custom_attributes' => array( - 'min' => 0, - 'step' => 1, + array( + 'title' => __( 'Country / State', 'woocommerce' ), + 'desc' => __( 'The country and state or province, if any, in which your business is located.', 'woocommerce' ), + 'id' => 'woocommerce_default_country', + 'default' => 'GB', + 'type' => 'single_select_country', + 'desc_tip' => true, ), - ), - array( 'type' => 'sectionend', 'id' => 'pricing_options' ), + array( + 'title' => __( 'Postcode / ZIP', 'woocommerce' ), + 'desc' => __( 'The postal code, if any, in which your business is located.', 'woocommerce' ), + 'id' => 'woocommerce_store_postcode', + 'css' => 'min-width:50px;', + 'default' => '', + 'type' => 'text', + 'desc_tip' => true, + ), - ) ); + array( + 'type' => 'sectionend', + 'id' => 'store_address', + ), + + array( + 'title' => __( 'General options', 'woocommerce' ), + 'type' => 'title', + 'desc' => '', + 'id' => 'general_options', + ), + + array( + 'title' => __( 'Selling location(s)', 'woocommerce' ), + 'desc' => __( 'This option lets you limit which countries you are willing to sell to.', 'woocommerce' ), + 'id' => 'woocommerce_allowed_countries', + 'default' => 'all', + 'type' => 'select', + 'class' => 'wc-enhanced-select', + 'css' => 'min-width: 350px;', + 'desc_tip' => true, + 'options' => array( + 'all' => __( 'Sell to all countries', 'woocommerce' ), + 'all_except' => __( 'Sell to all countries, except for…', 'woocommerce' ), + 'specific' => __( 'Sell to specific countries', 'woocommerce' ), + ), + ), + + array( + 'title' => __( 'Sell to all countries, except for…', 'woocommerce' ), + 'desc' => '', + 'id' => 'woocommerce_all_except_countries', + 'css' => 'min-width: 350px;', + 'default' => '', + 'type' => 'multi_select_countries', + ), + + array( + 'title' => __( 'Sell to specific countries', 'woocommerce' ), + 'desc' => '', + 'id' => 'woocommerce_specific_allowed_countries', + 'css' => 'min-width: 350px;', + 'default' => '', + 'type' => 'multi_select_countries', + ), + + array( + 'title' => __( 'Shipping location(s)', 'woocommerce' ), + 'desc' => __( 'Choose which countries you want to ship to, or choose to ship to all locations you sell to.', 'woocommerce' ), + 'id' => 'woocommerce_ship_to_countries', + 'default' => '', + 'type' => 'select', + 'class' => 'wc-enhanced-select', + 'desc_tip' => true, + 'options' => array( + '' => __( 'Ship to all countries you sell to', 'woocommerce' ), + 'all' => __( 'Ship to all countries', 'woocommerce' ), + 'specific' => __( 'Ship to specific countries only', 'woocommerce' ), + 'disabled' => __( 'Disable shipping & shipping calculations', 'woocommerce' ), + ), + ), + + array( + 'title' => __( 'Ship to specific countries', 'woocommerce' ), + 'desc' => '', + 'id' => 'woocommerce_specific_ship_to_countries', + 'css' => '', + 'default' => '', + 'type' => 'multi_select_countries', + ), + + array( + 'title' => __( 'Default customer location', 'woocommerce' ), + 'id' => 'woocommerce_default_customer_address', + 'desc_tip' => __( 'This option determines a customers default location. The MaxMind GeoLite Database will be periodically downloaded to your wp-content directory if using geolocation.', 'woocommerce' ), + 'default' => 'geolocation', + 'type' => 'select', + 'class' => 'wc-enhanced-select', + 'options' => $woocommerce_default_customer_address_options, + ), + + array( + 'title' => __( 'Enable taxes', 'woocommerce' ), + 'desc' => __( 'Enable tax rates and calculations', 'woocommerce' ), + 'id' => 'woocommerce_calc_taxes', + 'default' => 'no', + 'type' => 'checkbox', + 'desc_tip' => __( 'Rates will be configurable and taxes will be calculated during checkout.', 'woocommerce' ), + ), + + array( + 'title' => __( 'Enable coupons', 'woocommerce' ), + 'desc' => __( 'Enable the use of coupon codes', 'woocommerce' ), + 'id' => 'woocommerce_enable_coupons', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + 'show_if_checked' => 'option', + 'desc_tip' => __( 'Coupons can be applied from the cart and checkout pages.', 'woocommerce' ), + ), + + array( + 'desc' => __( 'Calculate coupon discounts sequentially', 'woocommerce' ), + 'id' => 'woocommerce_calc_discounts_sequentially', + 'default' => 'no', + 'type' => 'checkbox', + 'desc_tip' => __( 'When applying multiple coupons, apply the first coupon to the full price and the second coupon to the discounted price and so on.', 'woocommerce' ), + 'show_if_checked' => 'yes', + 'checkboxgroup' => 'end', + 'autoload' => false, + ), + + array( + 'type' => 'sectionend', + 'id' => 'general_options', + ), + + array( + 'title' => __( 'Currency options', 'woocommerce' ), + 'type' => 'title', + 'desc' => __( 'The following options affect how prices are displayed on the frontend.', 'woocommerce' ), + 'id' => 'pricing_options', + ), + + array( + 'title' => __( 'Currency', 'woocommerce' ), + 'desc' => __( 'This controls what currency prices are listed at in the catalog and which currency gateways will take payments in.', 'woocommerce' ), + 'id' => 'woocommerce_currency', + 'default' => 'GBP', + 'type' => 'select', + 'class' => 'wc-enhanced-select', + 'desc_tip' => true, + 'options' => $currency_code_options, + ), + + array( + 'title' => __( 'Currency position', 'woocommerce' ), + 'desc' => __( 'This controls the position of the currency symbol.', 'woocommerce' ), + 'id' => 'woocommerce_currency_pos', + 'class' => 'wc-enhanced-select', + 'default' => 'left', + 'type' => 'select', + 'options' => array( + 'left' => __( 'Left', 'woocommerce' ), + 'right' => __( 'Right', 'woocommerce' ), + 'left_space' => __( 'Left with space', 'woocommerce' ), + 'right_space' => __( 'Right with space', 'woocommerce' ), + ), + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Thousand separator', 'woocommerce' ), + 'desc' => __( 'This sets the thousand separator of displayed prices.', 'woocommerce' ), + 'id' => 'woocommerce_price_thousand_sep', + 'css' => 'width:50px;', + 'default' => ',', + 'type' => 'text', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Decimal separator', 'woocommerce' ), + 'desc' => __( 'This sets the decimal separator of displayed prices.', 'woocommerce' ), + 'id' => 'woocommerce_price_decimal_sep', + 'css' => 'width:50px;', + 'default' => '.', + 'type' => 'text', + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Number of decimals', 'woocommerce' ), + 'desc' => __( 'This sets the number of decimal points shown in displayed prices.', 'woocommerce' ), + 'id' => 'woocommerce_price_num_decimals', + 'css' => 'width:50px;', + 'default' => '2', + 'desc_tip' => true, + 'type' => 'number', + 'custom_attributes' => array( + 'min' => 0, + 'step' => 1, + ), + ), + + array( + 'type' => 'sectionend', + 'id' => 'pricing_options', + ), + + ) + ); return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings ); } @@ -279,10 +305,10 @@ class WC_Settings_General extends WC_Settings_Page { /** * Output a color picker input box. * - * @param mixed $name - * @param string $id - * @param mixed $value - * @param string $desc (default: '') + * @param mixed $name Name of input. + * @param string $id ID of input. + * @param mixed $value Value of input. + * @param string $desc (default: '') Description for input. */ public function color_picker( $name, $id, $value, $desc = '' ) { echo '
          ' . wc_help_tip( $desc ) . ' @@ -290,6 +316,59 @@ class WC_Settings_General extends WC_Settings_Page {
          '; } + /** + * Show a notice showing where the store notice setting has moved. + * + * @since 3.3.1 + * @todo remove in next major release. + */ + private function store_notice_setting_moved_notice() { + if ( get_user_meta( get_current_user_id(), 'dismissed_store_notice_setting_moved_notice', true ) ) { + return; + } + ?> +
          + + +

          + in the Customizer.', 'woocommerce' ), esc_url( + add_query_arg( + array( + 'autofocus' => array( + 'panel' => 'woocommerce', + ), + 'url' => wc_get_page_permalink( 'shop' ), + ), admin_url( 'customize.php' ) + ) + ) + ), array( + 'a' => array( + 'href' => array(), + 'title' => array(), + ), + ) + ); + ?> +

          +
          + get_settings(); + + $this->store_notice_setting_moved_notice(); + + WC_Admin_Settings::output_fields( $settings ); + } + /** * Save settings. */ @@ -300,6 +379,4 @@ class WC_Settings_General extends WC_Settings_Page { } } -endif; - return new WC_Settings_General(); diff --git a/includes/admin/settings/class-wc-settings-integrations.php b/includes/admin/settings/class-wc-settings-integrations.php index 126844c85f6..5c6ab9e2602 100644 --- a/includes/admin/settings/class-wc-settings-integrations.php +++ b/includes/admin/settings/class-wc-settings-integrations.php @@ -14,68 +14,64 @@ if ( ! defined( 'ABSPATH' ) ) { if ( ! class_exists( 'WC_Settings_Integrations', false ) ) : -/** - * WC_Settings_Integrations. - */ -class WC_Settings_Integrations extends WC_Settings_Page { - /** - * Constructor. + * WC_Settings_Integrations. */ - public function __construct() { + class WC_Settings_Integrations extends WC_Settings_Page { - $this->id = 'integration'; - $this->label = __( 'Integration', 'woocommerce' ); + /** + * Constructor. + */ + public function __construct() { + $this->id = 'integration'; + $this->label = __( 'Integration', 'woocommerce' ); - if ( isset( WC()->integrations ) && WC()->integrations->get_integrations() ) { - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); - } - } - - /** - * Get sections. - * - * @return array - */ - public function get_sections() { - global $current_section; - - $sections = array(); - - if ( ! defined( 'WC_INSTALLING' ) ) { - $integrations = WC()->integrations->get_integrations(); - - if ( ! $current_section && ! empty( $integrations ) ) { - $current_section = current( $integrations )->id; + if ( isset( WC()->integrations ) && WC()->integrations->get_integrations() ) { + parent::__construct(); } + } - if ( sizeof( $integrations ) > 1 ) { - foreach ( $integrations as $integration ) { - $title = empty( $integration->method_title ) ? ucfirst( $integration->id ) : $integration->method_title; - $sections[ strtolower( $integration->id ) ] = esc_html( $title ); + /** + * Get sections. + * + * @return array + */ + public function get_sections() { + global $current_section; + + $sections = array(); + + if ( ! defined( 'WC_INSTALLING' ) ) { + $integrations = WC()->integrations->get_integrations(); + + if ( ! $current_section && ! empty( $integrations ) ) { + $current_section = current( $integrations )->id; + } + + if ( sizeof( $integrations ) > 1 ) { + foreach ( $integrations as $integration ) { + $title = empty( $integration->method_title ) ? ucfirst( $integration->id ) : $integration->method_title; + $sections[ strtolower( $integration->id ) ] = esc_html( $title ); + } } } + + return apply_filters( 'woocommerce_get_sections_' . $this->id, $sections ); } - return apply_filters( 'woocommerce_get_sections_' . $this->id, $sections ); - } + /** + * Output the settings. + */ + public function output() { + global $current_section; - /** - * Output the settings. - */ - public function output() { - global $current_section; + $integrations = WC()->integrations->get_integrations(); - $integrations = WC()->integrations->get_integrations(); - - if ( isset( $integrations[ $current_section ] ) ) { - $integrations[ $current_section ]->admin_options(); + if ( isset( $integrations[ $current_section ] ) ) { + $integrations[ $current_section ]->admin_options(); + } } } -} endif; diff --git a/includes/admin/settings/class-wc-settings-page.php b/includes/admin/settings/class-wc-settings-page.php index 830fa25e030..90b8cc8090a 100644 --- a/includes/admin/settings/class-wc-settings-page.php +++ b/includes/admin/settings/class-wc-settings-page.php @@ -14,129 +14,131 @@ if ( ! defined( 'ABSPATH' ) ) { if ( ! class_exists( 'WC_Settings_Page', false ) ) : -/** - * WC_Settings_Page. - */ -abstract class WC_Settings_Page { - /** - * Setting page id. - * - * @var string + * WC_Settings_Page. */ - protected $id = ''; + abstract class WC_Settings_Page { - /** - * Setting page label. - * - * @var string - */ - protected $label = ''; + /** + * Setting page id. + * + * @var string + */ + protected $id = ''; - /** - * Constructor. - */ - public function __construct() { - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); - } + /** + * Setting page label. + * + * @var string + */ + protected $label = ''; - /** - * Get settings page ID. - * @since 3.0.0 - * @return string - */ - public function get_id() { - return $this->id; - } - - /** - * Get settings page label. - * @since 3.0.0 - * @return string - */ - public function get_label() { - return $this->label; - } - - /** - * Add this page to settings. - * - * @param array $pages - * - * @return mixed - */ - public function add_settings_page( $pages ) { - $pages[ $this->id ] = $this->label; - - return $pages; - } - - /** - * Get settings array. - * - * @return array - */ - public function get_settings() { - return apply_filters( 'woocommerce_get_settings_' . $this->id, array() ); - } - - /** - * Get sections. - * - * @return array - */ - public function get_sections() { - return apply_filters( 'woocommerce_get_sections_' . $this->id, array() ); - } - - /** - * Output sections. - */ - public function output_sections() { - global $current_section; - - $sections = $this->get_sections(); - - if ( empty( $sections ) || 1 === sizeof( $sections ) ) { - return; + /** + * Constructor. + */ + public function __construct() { + add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); + add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); + add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); + add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); } - echo '
            '; - - $array_keys = array_keys( $sections ); - - foreach ( $sections as $id => $label ) { - echo '
          • ' . $label . ' ' . ( end( $array_keys ) == $id ? '' : '|' ) . '
            • '; + /** + * Get settings page ID. + * + * @since 3.0.0 + * @return string + */ + public function get_id() { + return $this->id; } - echo '

          '; - } + /** + * Get settings page label. + * + * @since 3.0.0 + * @return string + */ + public function get_label() { + return $this->label; + } - /** - * Output the settings. - */ - public function output() { - $settings = $this->get_settings(); + /** + * Add this page to settings. + * + * @param array $pages + * + * @return mixed + */ + public function add_settings_page( $pages ) { + $pages[ $this->id ] = $this->label; - WC_Admin_Settings::output_fields( $settings ); - } + return $pages; + } - /** - * Save settings. - */ - public function save() { - global $current_section; + /** + * Get settings array. + * + * @return array + */ + public function get_settings() { + return apply_filters( 'woocommerce_get_settings_' . $this->id, array() ); + } - $settings = $this->get_settings(); - WC_Admin_Settings::save_fields( $settings ); + /** + * Get sections. + * + * @return array + */ + public function get_sections() { + return apply_filters( 'woocommerce_get_sections_' . $this->id, array() ); + } - if ( $current_section ) { - do_action( 'woocommerce_update_options_' . $this->id . '_' . $current_section ); + /** + * Output sections. + */ + public function output_sections() { + global $current_section; + + $sections = $this->get_sections(); + + if ( empty( $sections ) || 1 === sizeof( $sections ) ) { + return; + } + + echo '
            '; + + $array_keys = array_keys( $sections ); + + foreach ( $sections as $id => $label ) { + echo '
          • ' . $label . ' ' . ( end( $array_keys ) == $id ? '' : '|' ) . '
            • '; + } + + echo '

          '; + } + + /** + * Output the settings. + */ + public function output() { + $settings = $this->get_settings(); + + WC_Admin_Settings::output_fields( $settings ); + } + + /** + * Save settings. + */ + public function save() { + global $current_section; + + $settings = $this->get_settings(); + WC_Admin_Settings::save_fields( $settings ); + + if ( $current_section ) { + do_action( 'woocommerce_update_options_' . $this->id . '_' . $current_section ); + } } } -} endif; diff --git a/includes/admin/settings/class-wc-settings-payment-gateways.php b/includes/admin/settings/class-wc-settings-payment-gateways.php new file mode 100644 index 00000000000..62800001bea --- /dev/null +++ b/includes/admin/settings/class-wc-settings-payment-gateways.php @@ -0,0 +1,235 @@ +id = 'checkout'; // @todo In future versions this may make more sense as 'payment' however to avoid breakage lets leave this alone until we refactor settings APIs in general. + $this->label = _x( 'Payments', 'Settings tab label', 'woocommerce' ); + + add_action( 'woocommerce_admin_field_payment_gateways', array( $this, 'payment_gateways_setting' ) ); + parent::__construct(); + } + + /** + * Get sections. + * + * @return array + */ + public function get_sections() { + $sections = array( + '' => __( 'Payment methods', 'woocommerce' ), + ); + return apply_filters( 'woocommerce_get_sections_' . $this->id, $sections ); + } + + /** + * Get settings array. + * + * @param string $current_section Section being shown. + * @return array + */ + public function get_settings( $current_section = '' ) { + $settings = array(); + + if ( '' === $current_section ) { + $settings = apply_filters( + 'woocommerce_payment_gateways_settings', array( + array( + 'title' => __( 'Payment methods', 'woocommerce' ), + 'desc' => __( 'Installed payment methods are listed below and can be sorted to control their display order on the frontend.', 'woocommerce' ), + 'type' => 'title', + 'id' => 'payment_gateways_options', + ), + array( + 'type' => 'payment_gateways', + ), + array( + 'type' => 'sectionend', + 'id' => 'payment_gateways_options', + ), + ) + ); + } + + return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings, $current_section ); + } + + /** + * Output the settings. + */ + public function output() { + global $current_section; + + // Load gateways so we can show any global options they may have. + $payment_gateways = WC()->payment_gateways->payment_gateways(); + + if ( $current_section ) { + foreach ( $payment_gateways as $gateway ) { + if ( in_array( $current_section, array( $gateway->id, sanitize_title( get_class( $gateway ) ) ), true ) ) { + if ( isset( $_GET['toggle_enabled'] ) ) { // WPCS: input var ok, CSRF ok. + $enabled = $gateway->get_option( 'enabled' ); + + if ( $enabled ) { + $gateway->settings['enabled'] = wc_string_to_bool( $enabled ) ? 'no' : 'yes'; + } + } + $gateway->admin_options(); + break; + } + } + } else { + $settings = $this->get_settings(); + WC_Admin_Settings::output_fields( $settings ); + } + } + + /** + * Output payment gateway settings. + */ + public function payment_gateways_setting() { + ?> + + + + get_settings() ); + $wc_payment_gateways->process_admin_options(); + $wc_payment_gateways->init(); + } else { + foreach ( $wc_payment_gateways->payment_gateways() as $gateway ) { + if ( in_array( $current_section, array( $gateway->id, sanitize_title( get_class( $gateway ) ) ), true ) ) { + do_action( 'woocommerce_update_options_payment_gateways_' . $gateway->id ); + $wc_payment_gateways->init(); + } + } + } + + if ( $current_section ) { + do_action( 'woocommerce_update_options_' . $this->id . '_' . $current_section ); + } + } +} + +return new WC_Settings_Payment_Gateways(); diff --git a/includes/admin/settings/class-wc-settings-products.php b/includes/admin/settings/class-wc-settings-products.php index eecdd0defb6..14f92cfae37 100644 --- a/includes/admin/settings/class-wc-settings-products.php +++ b/includes/admin/settings/class-wc-settings-products.php @@ -2,17 +2,17 @@ /** * WooCommerce Product Settings * - * @author WooThemes - * @category Admin - * @package WooCommerce/Admin - * @version 2.4.0 + * @package WooCommerce/Admin + * @version 2.4.0 */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + exit; } -if ( ! class_exists( 'WC_Settings_Products', false ) ) : +if ( class_exists( 'WC_Settings_Products', false ) ) { + return new WC_Settings_Products(); +} /** * WC_Settings_Products. @@ -23,14 +23,10 @@ class WC_Settings_Products extends WC_Settings_Page { * Constructor. */ public function __construct() { - $this->id = 'products'; $this->label = __( 'Products', 'woocommerce' ); - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); - add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); + parent::__construct(); } /** @@ -39,12 +35,10 @@ class WC_Settings_Products extends WC_Settings_Page { * @return array */ public function get_sections() { - $sections = array( - '' => __( 'General', 'woocommerce' ), - 'display' => __( 'Display', 'woocommerce' ), - 'inventory' => __( 'Inventory', 'woocommerce' ), - 'downloadable' => __( 'Downloadable products', 'woocommerce' ), + '' => __( 'General', 'woocommerce' ), + 'inventory' => __( 'Inventory', 'woocommerce' ), + 'downloadable' => __( 'Downloadable products', 'woocommerce' ), ); return apply_filters( 'woocommerce_get_sections_' . $this->id, $sections ); @@ -58,9 +52,53 @@ class WC_Settings_Products extends WC_Settings_Page { $settings = $this->get_settings( $current_section ); + $this->product_display_settings_moved_notice(); + WC_Admin_Settings::output_fields( $settings ); } + /** + * Show a notice showing where some options have moved. + * + * @since 3.3.0 + * @todo remove in next major release. + */ + private function product_display_settings_moved_notice() { + if ( get_user_meta( get_current_user_id(), 'dismissed_product_display_settings_moved_notice', true ) ) { + return; + } + ?> +
          + + +

          + Go see them in action here.', 'woocommerce' ), esc_url( + add_query_arg( + array( + 'autofocus' => array( + 'panel' => 'woocommerce', + ), + 'url' => wc_get_page_permalink( 'shop' ), + ), admin_url( 'customize.php' ) + ) + ) + ), array( + 'a' => array( + 'href' => array(), + 'title' => array(), + ), + ) + ); + ?> +

          +
          + get_settings( $current_section ); WC_Admin_Settings::save_fields( $settings ); + + if ( $current_section ) { + do_action( 'woocommerce_update_options_' . $this->id . '_' . $current_section ); + } } /** * Get settings array. * - * @param string $current_section - * + * @param string $current_section Current section name. * @return array */ public function get_settings( $current_section = '' ) { - if ( 'display' == $current_section ) { + if ( 'inventory' === $current_section ) { + $settings = apply_filters( + 'woocommerce_inventory_settings', array( - $settings = apply_filters( 'woocommerce_product_settings', array( - - array( - 'title' => __( 'Shop & product pages', 'woocommerce' ), - 'type' => 'title', - 'desc' => '', - 'id' => 'catalog_options', - ), - - array( - 'title' => __( 'Shop page', 'woocommerce' ), - 'desc' => '
          ' . sprintf( __( 'The base page can also be used in your product permalinks.', 'woocommerce' ), admin_url( 'options-permalink.php' ) ), - 'id' => 'woocommerce_shop_page_id', - 'type' => 'single_select_page', - 'default' => '', - 'class' => 'wc-enhanced-select-nostd', - 'css' => 'min-width:300px;', - 'desc_tip' => __( 'This sets the base page of your shop - this is where your product archive will be.', 'woocommerce' ), - ), - - array( - 'title' => __( 'Shop page display', 'woocommerce' ), - 'desc' => __( 'This controls what is shown on the product archive.', 'woocommerce' ), - 'id' => 'woocommerce_shop_page_display', - 'class' => 'wc-enhanced-select', - 'css' => 'min-width:300px;', - 'default' => '', - 'type' => 'select', - 'options' => array( - '' => __( 'Show products', 'woocommerce' ), - 'subcategories' => __( 'Show categories', 'woocommerce' ), - 'both' => __( 'Show categories & products', 'woocommerce' ), + array( + 'title' => __( 'Inventory', 'woocommerce' ), + 'type' => 'title', + 'desc' => '', + 'id' => 'product_inventory_options', ), - 'desc_tip' => true, - ), - array( - 'title' => __( 'Default category display', 'woocommerce' ), - 'desc' => __( 'This controls what is shown on category archives.', 'woocommerce' ), - 'id' => 'woocommerce_category_archive_display', - 'class' => 'wc-enhanced-select', - 'css' => 'min-width:300px;', - 'default' => '', - 'type' => 'select', - 'options' => array( - '' => __( 'Show products', 'woocommerce' ), - 'subcategories' => __( 'Show subcategories', 'woocommerce' ), - 'both' => __( 'Show subcategories & products', 'woocommerce' ), + array( + 'title' => __( 'Manage stock', 'woocommerce' ), + 'desc' => __( 'Enable stock management', 'woocommerce' ), + 'id' => 'woocommerce_manage_stock', + 'default' => 'yes', + 'type' => 'checkbox', ), - 'desc_tip' => true, - ), - array( - 'title' => __( 'Default product sorting', 'woocommerce' ), - 'desc' => __( 'This controls the default sort order of the catalog.', 'woocommerce' ), - 'id' => 'woocommerce_default_catalog_orderby', - 'class' => 'wc-enhanced-select', - 'css' => 'min-width:300px;', - 'default' => 'menu_order', - 'type' => 'select', - 'options' => apply_filters( 'woocommerce_default_catalog_orderby_options', array( - 'menu_order' => __( 'Default sorting (custom ordering + name)', 'woocommerce' ), - 'popularity' => __( 'Popularity (sales)', 'woocommerce' ), - 'rating' => __( 'Average rating', 'woocommerce' ), - 'date' => __( 'Sort by most recent', 'woocommerce' ), - 'price' => __( 'Sort by price (asc)', 'woocommerce' ), - 'price-desc' => __( 'Sort by price (desc)', 'woocommerce' ), - ) ), - 'desc_tip' => true, - ), - - array( - 'title' => __( 'Add to cart behaviour', 'woocommerce' ), - 'desc' => __( 'Redirect to the cart page after successful addition', 'woocommerce' ), - 'id' => 'woocommerce_cart_redirect_after_add', - 'default' => 'no', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - ), - - array( - 'desc' => __( 'Enable AJAX add to cart buttons on archives', 'woocommerce' ), - 'id' => 'woocommerce_enable_ajax_add_to_cart', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'end', - ), - - array( - 'type' => 'sectionend', - 'id' => 'catalog_options', - ), - - array( - 'title' => __( 'Product images', 'woocommerce' ), - 'type' => 'title', - 'desc' => sprintf( __( 'These settings affect the display and dimensions of images in your catalog - the display on the front-end will still be affected by CSS styles. After changing these settings you may need to regenerate your thumbnails.', 'woocommerce' ), 'https://wordpress.org/plugins/regenerate-thumbnails/' ), - 'id' => 'image_options', - ), - - array( - 'title' => __( 'Catalog images', 'woocommerce' ), - 'desc' => __( 'This size is usually used in product listings. (W x H)', 'woocommerce' ), - 'id' => 'shop_catalog_image_size', - 'css' => '', - 'type' => 'image_width', - 'default' => array( - 'width' => '300', - 'height' => '300', - 'crop' => 1, + array( + 'title' => __( 'Hold stock (minutes)', 'woocommerce' ), + 'desc' => __( 'Hold stock (for unpaid orders) for x minutes. When this limit is reached, the pending order will be cancelled. Leave blank to disable.', 'woocommerce' ), + 'id' => 'woocommerce_hold_stock_minutes', + 'type' => 'number', + 'custom_attributes' => array( + 'min' => 0, + 'step' => 1, + ), + 'css' => 'width: 80px;', + 'default' => '60', + 'autoload' => false, + 'class' => 'manage_stock_field', ), - 'desc_tip' => true, - ), - array( - 'title' => __( 'Single product image', 'woocommerce' ), - 'desc' => __( 'This is the size used by the main image on the product page. (W x H)', 'woocommerce' ), - 'id' => 'shop_single_image_size', - 'css' => '', - 'type' => 'image_width', - 'default' => array( - 'width' => '600', - 'height' => '600', - 'crop' => 1, + array( + 'title' => __( 'Notifications', 'woocommerce' ), + 'desc' => __( 'Enable low stock notifications', 'woocommerce' ), + 'id' => 'woocommerce_notify_low_stock', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + 'autoload' => false, + 'class' => 'manage_stock_field', ), - 'desc_tip' => true, - ), - array( - 'title' => __( 'Product thumbnails', 'woocommerce' ), - 'desc' => __( 'This size is usually used for the gallery of images on the product page. (W x H)', 'woocommerce' ), - 'id' => 'shop_thumbnail_image_size', - 'css' => '', - 'type' => 'image_width', - 'default' => array( - 'width' => '180', - 'height' => '180', - 'crop' => 1, + array( + 'desc' => __( 'Enable out of stock notifications', 'woocommerce' ), + 'id' => 'woocommerce_notify_no_stock', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'end', + 'autoload' => false, + 'class' => 'manage_stock_field', ), - 'desc_tip' => true, - ), - array( - 'type' => 'sectionend', - 'id' => 'image_options', - ), - - )); - } elseif ( 'inventory' == $current_section ) { - - $settings = apply_filters( 'woocommerce_inventory_settings', array( - - array( - 'title' => __( 'Inventory', 'woocommerce' ), - 'type' => 'title', - 'desc' => '', - 'id' => 'product_inventory_options', - ), - - array( - 'title' => __( 'Manage stock', 'woocommerce' ), - 'desc' => __( 'Enable stock management', 'woocommerce' ), - 'id' => 'woocommerce_manage_stock', - 'default' => 'yes', - 'type' => 'checkbox', - ), - - array( - 'title' => __( 'Hold stock (minutes)', 'woocommerce' ), - 'desc' => __( 'Hold stock (for unpaid orders) for x minutes. When this limit is reached, the pending order will be cancelled. Leave blank to disable.', 'woocommerce' ), - 'id' => 'woocommerce_hold_stock_minutes', - 'type' => 'number', - 'custom_attributes' => array( - 'min' => 0, - 'step' => 1, + array( + 'title' => __( 'Notification recipient(s)', 'woocommerce' ), + 'desc' => __( 'Enter recipients (comma separated) that will receive this notification.', 'woocommerce' ), + 'id' => 'woocommerce_stock_email_recipient', + 'type' => 'text', + 'default' => get_option( 'admin_email' ), + 'css' => 'width: 250px;', + 'autoload' => false, + 'desc_tip' => true, + 'class' => 'manage_stock_field', ), - 'css' => 'width: 80px;', - 'default' => '60', - 'autoload' => false, - 'class' => 'manage_stock_field', - ), - array( - 'title' => __( 'Notifications', 'woocommerce' ), - 'desc' => __( 'Enable low stock notifications', 'woocommerce' ), - 'id' => 'woocommerce_notify_low_stock', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'autoload' => false, - 'class' => 'manage_stock_field', - ), - - array( - 'desc' => __( 'Enable out of stock notifications', 'woocommerce' ), - 'id' => 'woocommerce_notify_no_stock', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'end', - 'autoload' => false, - 'class' => 'manage_stock_field', - ), - - array( - 'title' => __( 'Notification recipient(s)', 'woocommerce' ), - 'desc' => __( 'Enter recipients (comma separated) that will receive this notification.', 'woocommerce' ), - 'id' => 'woocommerce_stock_email_recipient', - 'type' => 'text', - 'default' => get_option( 'admin_email' ), - 'css' => 'width: 250px;', - 'autoload' => false, - 'desc_tip' => true, - 'class' => 'manage_stock_field', - ), - - array( - 'title' => __( 'Low stock threshold', 'woocommerce' ), - 'desc' => __( 'When product stock reaches this amount you will be notified via email.', 'woocommerce' ), - 'id' => 'woocommerce_notify_low_stock_amount', - 'css' => 'width:50px;', - 'type' => 'number', - 'custom_attributes' => array( - 'min' => 0, - 'step' => 1, + array( + 'title' => __( 'Low stock threshold', 'woocommerce' ), + 'desc' => __( 'When product stock reaches this amount you will be notified via email.', 'woocommerce' ), + 'id' => 'woocommerce_notify_low_stock_amount', + 'css' => 'width:50px;', + 'type' => 'number', + 'custom_attributes' => array( + 'min' => 0, + 'step' => 1, + ), + 'default' => '2', + 'autoload' => false, + 'desc_tip' => true, + 'class' => 'manage_stock_field', ), - 'default' => '2', - 'autoload' => false, - 'desc_tip' => true, - 'class' => 'manage_stock_field', - ), - array( - 'title' => __( 'Out of stock threshold', 'woocommerce' ), - 'desc' => __( 'When product stock reaches this amount the stock status will change to "out of stock" and you will be notified via email. This setting does not affect existing "in stock" products.', 'woocommerce' ), - 'id' => 'woocommerce_notify_no_stock_amount', - 'css' => 'width:50px;', - 'type' => 'number', - 'custom_attributes' => array( - 'min' => 0, - 'step' => 1, + array( + 'title' => __( 'Out of stock threshold', 'woocommerce' ), + 'desc' => __( 'When product stock reaches this amount the stock status will change to "out of stock" and you will be notified via email. This setting does not affect existing "in stock" products.', 'woocommerce' ), + 'id' => 'woocommerce_notify_no_stock_amount', + 'css' => 'width:50px;', + 'type' => 'number', + 'custom_attributes' => array( + 'min' => 0, + 'step' => 1, + ), + 'default' => '0', + 'desc_tip' => true, + 'class' => 'manage_stock_field', ), - 'default' => '0', - 'desc_tip' => true, - 'class' => 'manage_stock_field', - ), - array( - 'title' => __( 'Out of stock visibility', 'woocommerce' ), - 'desc' => __( 'Hide out of stock items from the catalog', 'woocommerce' ), - 'id' => 'woocommerce_hide_out_of_stock_items', - 'default' => 'no', - 'type' => 'checkbox', - ), - - array( - 'title' => __( 'Stock display format', 'woocommerce' ), - 'desc' => __( 'This controls how stock quantities are displayed on the frontend.', 'woocommerce' ), - 'id' => 'woocommerce_stock_format', - 'css' => 'min-width:150px;', - 'class' => 'wc-enhanced-select', - 'default' => '', - 'type' => 'select', - 'options' => array( - '' => __( 'Always show quantity remaining in stock e.g. "12 in stock"', 'woocommerce' ), - 'low_amount' => __( 'Only show quantity remaining in stock when low e.g. "Only 2 left in stock"', 'woocommerce' ), - 'no_amount' => __( 'Never show quantity remaining in stock', 'woocommerce' ), + array( + 'title' => __( 'Out of stock visibility', 'woocommerce' ), + 'desc' => __( 'Hide out of stock items from the catalog', 'woocommerce' ), + 'id' => 'woocommerce_hide_out_of_stock_items', + 'default' => 'no', + 'type' => 'checkbox', ), - 'desc_tip' => true, - ), - array( - 'type' => 'sectionend', - 'id' => 'product_inventory_options', - ), - - )); - - } elseif ( 'downloadable' == $current_section ) { - $settings = apply_filters( 'woocommerce_downloadable_products_settings', array( - array( - 'title' => __( 'Downloadable products', 'woocommerce' ), - 'type' => 'title', - 'id' => 'digital_download_options', - ), - - array( - 'title' => __( 'File download method', 'woocommerce' ), - 'desc' => __( 'Forcing downloads will keep URLs hidden, but some servers may serve large files unreliably. If supported, X-Accel-Redirect/ X-Sendfile can be used to serve downloads instead (server requires mod_xsendfile).', 'woocommerce' ), - 'id' => 'woocommerce_file_download_method', - 'type' => 'select', - 'class' => 'wc-enhanced-select', - 'css' => 'min-width:300px;', - 'default' => 'force', - 'desc_tip' => true, - 'options' => array( - 'force' => __( 'Force downloads', 'woocommerce' ), - 'xsendfile' => __( 'X-Accel-Redirect/X-Sendfile', 'woocommerce' ), - 'redirect' => __( 'Redirect only', 'woocommerce' ), + array( + 'title' => __( 'Stock display format', 'woocommerce' ), + 'desc' => __( 'This controls how stock quantities are displayed on the frontend.', 'woocommerce' ), + 'id' => 'woocommerce_stock_format', + 'css' => 'min-width:150px;', + 'class' => 'wc-enhanced-select', + 'default' => '', + 'type' => 'select', + 'options' => array( + '' => __( 'Always show quantity remaining in stock e.g. "12 in stock"', 'woocommerce' ), + 'low_amount' => __( 'Only show quantity remaining in stock when low e.g. "Only 2 left in stock"', 'woocommerce' ), + 'no_amount' => __( 'Never show quantity remaining in stock', 'woocommerce' ), + ), + 'desc_tip' => true, ), - 'autoload' => false, - ), - array( - 'title' => __( 'Access restriction', 'woocommerce' ), - 'desc' => __( 'Downloads require login', 'woocommerce' ), - 'id' => 'woocommerce_downloads_require_login', - 'type' => 'checkbox', - 'default' => 'no', - 'desc_tip' => __( 'This setting does not apply to guest purchases.', 'woocommerce' ), - 'checkboxgroup' => 'start', - 'autoload' => false, - ), + array( + 'type' => 'sectionend', + 'id' => 'product_inventory_options', + ), - array( - 'desc' => __( 'Grant access to downloadable products after payment', 'woocommerce' ), - 'id' => 'woocommerce_downloads_grant_access_after_payment', - 'type' => 'checkbox', - 'default' => 'yes', - 'desc_tip' => __( 'Enable this option to grant access to downloads when orders are "processing", rather than "completed".', 'woocommerce' ), - 'checkboxgroup' => 'end', - 'autoload' => false, - ), + ) + ); - array( - 'type' => 'sectionend', - 'id' => 'digital_download_options', - ), + } elseif ( 'downloadable' === $current_section ) { + $settings = apply_filters( + 'woocommerce_downloadable_products_settings', array( + array( + 'title' => __( 'Downloadable products', 'woocommerce' ), + 'type' => 'title', + 'id' => 'digital_download_options', + ), - )); + array( + 'title' => __( 'File download method', 'woocommerce' ), + 'desc' => sprintf( + /* translators: 1: X-Accel-Redirect 2: X-Sendfile 3: mod_xsendfile */ + __( 'Forcing downloads will keep URLs hidden, but some servers may serve large files unreliably. If supported, %1$s / %2$s can be used to serve downloads instead (server requires %3$s).', 'woocommerce' ), + 'X-Accel-Redirect', + 'X-Sendfile', + 'mod_xsendfile' + ), + 'id' => 'woocommerce_file_download_method', + 'type' => 'select', + 'class' => 'wc-enhanced-select', + 'css' => 'min-width:300px;', + 'default' => 'force', + 'desc_tip' => true, + 'options' => array( + 'force' => __( 'Force downloads', 'woocommerce' ), + 'xsendfile' => __( 'X-Accel-Redirect/X-Sendfile', 'woocommerce' ), + 'redirect' => __( 'Redirect only', 'woocommerce' ), + ), + 'autoload' => false, + ), + + array( + 'title' => __( 'Access restriction', 'woocommerce' ), + 'desc' => __( 'Downloads require login', 'woocommerce' ), + 'id' => 'woocommerce_downloads_require_login', + 'type' => 'checkbox', + 'default' => 'no', + 'desc_tip' => __( 'This setting does not apply to guest purchases.', 'woocommerce' ), + 'checkboxgroup' => 'start', + 'autoload' => false, + ), + + array( + 'desc' => __( 'Grant access to downloadable products after payment', 'woocommerce' ), + 'id' => 'woocommerce_downloads_grant_access_after_payment', + 'type' => 'checkbox', + 'default' => 'yes', + 'desc_tip' => __( 'Enable this option to grant access to downloads when orders are "processing", rather than "completed".', 'woocommerce' ), + 'checkboxgroup' => 'end', + 'autoload' => false, + ), + + array( + 'type' => 'sectionend', + 'id' => 'digital_download_options', + ), + + ) + ); } else { - $settings = apply_filters( 'woocommerce_products_general_settings', array( - array( - 'title' => __( 'Measurements', 'woocommerce' ), - 'type' => 'title', - 'id' => 'product_measurement_options', - ), + $settings = apply_filters( + 'woocommerce_product_settings', apply_filters( + 'woocommerce_products_general_settings', array( + array( + 'title' => __( 'Shop pages', 'woocommerce' ), + 'type' => 'title', + 'desc' => '', + 'id' => 'catalog_options', + ), + array( + 'title' => __( 'Shop page', 'woocommerce' ), + /* translators: %s: URL to settings. */ + 'desc' => '
          ' . sprintf( __( 'The base page can also be used in your product permalinks.', 'woocommerce' ), admin_url( 'options-permalink.php' ) ), + 'id' => 'woocommerce_shop_page_id', + 'type' => 'single_select_page', + 'default' => '', + 'class' => 'wc-enhanced-select-nostd', + 'css' => 'min-width:300px;', + 'desc_tip' => __( 'This sets the base page of your shop - this is where your product archive will be.', 'woocommerce' ), + ), + array( + 'title' => __( 'Add to cart behaviour', 'woocommerce' ), + 'desc' => __( 'Redirect to the cart page after successful addition', 'woocommerce' ), + 'id' => 'woocommerce_cart_redirect_after_add', + 'default' => 'no', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + ), + array( + 'desc' => __( 'Enable AJAX add to cart buttons on archives', 'woocommerce' ), + 'id' => 'woocommerce_enable_ajax_add_to_cart', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'end', + ), + array( + 'title' => __( 'Placeholder image', 'woocommerce' ), + 'id' => 'woocommerce_placeholder_image', + 'type' => 'text', + 'default' => '', + 'class' => '', + 'css' => '', + 'placeholder' => __( 'Enter attachment ID or URL to an image', 'woocommerce' ), + 'desc_tip' => __( 'This is the attachment ID, or image URL, used for placeholder images in the product catalog. Products with no image will use this.', 'woocommerce' ), + ), + array( + 'type' => 'sectionend', + 'id' => 'catalog_options', + ), - array( - 'title' => __( 'Weight unit', 'woocommerce' ), - 'desc' => __( 'This controls what unit you will define weights in.', 'woocommerce' ), - 'id' => 'woocommerce_weight_unit', - 'class' => 'wc-enhanced-select', - 'css' => 'min-width:300px;', - 'default' => 'kg', - 'type' => 'select', - 'options' => array( - 'kg' => __( 'kg', 'woocommerce' ), - 'g' => __( 'g', 'woocommerce' ), - 'lbs' => __( 'lbs', 'woocommerce' ), - 'oz' => __( 'oz', 'woocommerce' ), - ), - 'desc_tip' => true, - ), + array( + 'title' => __( 'Measurements', 'woocommerce' ), + 'type' => 'title', + 'id' => 'product_measurement_options', + ), - array( - 'title' => __( 'Dimensions unit', 'woocommerce' ), - 'desc' => __( 'This controls what unit you will define lengths in.', 'woocommerce' ), - 'id' => 'woocommerce_dimension_unit', - 'class' => 'wc-enhanced-select', - 'css' => 'min-width:300px;', - 'default' => 'cm', - 'type' => 'select', - 'options' => array( - 'm' => __( 'm', 'woocommerce' ), - 'cm' => __( 'cm', 'woocommerce' ), - 'mm' => __( 'mm', 'woocommerce' ), - 'in' => __( 'in', 'woocommerce' ), - 'yd' => __( 'yd', 'woocommerce' ), - ), - 'desc_tip' => true, - ), + array( + 'title' => __( 'Weight unit', 'woocommerce' ), + 'desc' => __( 'This controls what unit you will define weights in.', 'woocommerce' ), + 'id' => 'woocommerce_weight_unit', + 'class' => 'wc-enhanced-select', + 'css' => 'min-width:300px;', + 'default' => 'kg', + 'type' => 'select', + 'options' => array( + 'kg' => __( 'kg', 'woocommerce' ), + 'g' => __( 'g', 'woocommerce' ), + 'lbs' => __( 'lbs', 'woocommerce' ), + 'oz' => __( 'oz', 'woocommerce' ), + ), + 'desc_tip' => true, + ), - array( - 'type' => 'sectionend', - 'id' => 'product_measurement_options', - ), + array( + 'title' => __( 'Dimensions unit', 'woocommerce' ), + 'desc' => __( 'This controls what unit you will define lengths in.', 'woocommerce' ), + 'id' => 'woocommerce_dimension_unit', + 'class' => 'wc-enhanced-select', + 'css' => 'min-width:300px;', + 'default' => 'cm', + 'type' => 'select', + 'options' => array( + 'm' => __( 'm', 'woocommerce' ), + 'cm' => __( 'cm', 'woocommerce' ), + 'mm' => __( 'mm', 'woocommerce' ), + 'in' => __( 'in', 'woocommerce' ), + 'yd' => __( 'yd', 'woocommerce' ), + ), + 'desc_tip' => true, + ), - array( - 'title' => __( 'Reviews', 'woocommerce' ), - 'type' => 'title', - 'desc' => '', - 'id' => 'product_rating_options', - ), + array( + 'type' => 'sectionend', + 'id' => 'product_measurement_options', + ), - array( - 'title' => __( 'Enable reviews', 'woocommerce' ), - 'desc' => __( 'Enable product reviews', 'woocommerce' ), - 'id' => 'woocommerce_enable_reviews', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'show_if_checked' => 'option', - ), + array( + 'title' => __( 'Reviews', 'woocommerce' ), + 'type' => 'title', + 'desc' => '', + 'id' => 'product_rating_options', + ), - array( - 'desc' => __( 'Show "verified owner" label on customer reviews', 'woocommerce' ), - 'id' => 'woocommerce_review_rating_verification_label', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => '', - 'show_if_checked' => 'yes', - 'autoload' => false, - ), + array( + 'title' => __( 'Enable reviews', 'woocommerce' ), + 'desc' => __( 'Enable product reviews', 'woocommerce' ), + 'id' => 'woocommerce_enable_reviews', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + 'show_if_checked' => 'option', + ), - array( - 'desc' => __( 'Reviews can only be left by "verified owners"', 'woocommerce' ), - 'id' => 'woocommerce_review_rating_verification_required', - 'default' => 'no', - 'type' => 'checkbox', - 'checkboxgroup' => 'end', - 'show_if_checked' => 'yes', - 'autoload' => false, - ), + array( + 'desc' => __( 'Show "verified owner" label on customer reviews', 'woocommerce' ), + 'id' => 'woocommerce_review_rating_verification_label', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => '', + 'show_if_checked' => 'yes', + 'autoload' => false, + ), - array( - 'title' => __( 'Product ratings', 'woocommerce' ), - 'desc' => __( 'Enable star rating on reviews', 'woocommerce' ), - 'id' => 'woocommerce_enable_review_rating', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'show_if_checked' => 'option', - ), + array( + 'desc' => __( 'Reviews can only be left by "verified owners"', 'woocommerce' ), + 'id' => 'woocommerce_review_rating_verification_required', + 'default' => 'no', + 'type' => 'checkbox', + 'checkboxgroup' => 'end', + 'show_if_checked' => 'yes', + 'autoload' => false, + ), - array( - 'desc' => __( 'Star ratings should be required, not optional', 'woocommerce' ), - 'id' => 'woocommerce_review_rating_required', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'end', - 'show_if_checked' => 'yes', - 'autoload' => false, - ), + array( + 'title' => __( 'Product ratings', 'woocommerce' ), + 'desc' => __( 'Enable star rating on reviews', 'woocommerce' ), + 'id' => 'woocommerce_enable_review_rating', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + 'show_if_checked' => 'option', + ), - array( - 'type' => 'sectionend', - 'id' => 'product_rating_options', - ), + array( + 'desc' => __( 'Star ratings should be required, not optional', 'woocommerce' ), + 'id' => 'woocommerce_review_rating_required', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'end', + 'show_if_checked' => 'yes', + 'autoload' => false, + ), - )); + array( + 'type' => 'sectionend', + 'id' => 'product_rating_options', + ), + + ) + ) + ); } return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings, $current_section ); } } -endif; - return new WC_Settings_Products(); diff --git a/includes/admin/settings/class-wc-settings-shipping.php b/includes/admin/settings/class-wc-settings-shipping.php index f510bf83411..797551b0925 100644 --- a/includes/admin/settings/class-wc-settings-shipping.php +++ b/includes/admin/settings/class-wc-settings-shipping.php @@ -2,17 +2,15 @@ /** * WooCommerce Shipping Settings * - * @author WooThemes - * @category Admin * @package WooCommerce/Admin * @version 2.6.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; -if ( ! class_exists( 'WC_Settings_Shipping', false ) ) : +if ( class_exists( 'WC_Settings_Shipping', false ) ) { + return new WC_Settings_Shipping(); +} /** * WC_Settings_Shipping. @@ -25,17 +23,14 @@ class WC_Settings_Shipping extends WC_Settings_Page { public function __construct() { $this->id = 'shipping'; $this->label = __( 'Shipping', 'woocommerce' ); - add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); - add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); - add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); - add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); + + parent::__construct(); } /** * Add this page to settings. * - * @param array $pages - * + * @param array $pages Current pages. * @return array|mixed */ public function add_settings_page( $pages ) { @@ -55,14 +50,14 @@ class WC_Settings_Shipping extends WC_Settings_Page { ); if ( ! defined( 'WC_INSTALLING' ) ) { - // Load shipping methods so we can show any global options they may have + // Load shipping methods so we can show any global options they may have. $shipping_methods = WC()->shipping->load_shipping_methods(); foreach ( $shipping_methods as $method ) { if ( ! $method->has_settings() ) { continue; } - $title = empty( $method->method_title ) ? ucfirst( $method->id ) : $method->method_title; + $title = empty( $method->method_title ) ? ucfirst( $method->id ) : $method->method_title; $sections[ strtolower( $method->id ) ] = esc_html( $title ); } } @@ -73,66 +68,72 @@ class WC_Settings_Shipping extends WC_Settings_Page { /** * Get settings array. * - * @param string $current_section - * + * @param string $current_section Current section. * @return array */ public function get_settings( $current_section = '' ) { $settings = array(); if ( '' === $current_section ) { - $settings = apply_filters( 'woocommerce_shipping_settings', array( + $settings = apply_filters( + 'woocommerce_shipping_settings', array( - array( 'title' => __( 'Shipping options', 'woocommerce' ), 'type' => 'title', 'id' => 'shipping_options' ), - - array( - 'title' => __( 'Calculations', 'woocommerce' ), - 'desc' => __( 'Enable the shipping calculator on the cart page', 'woocommerce' ), - 'id' => 'woocommerce_enable_shipping_calc', - 'default' => 'yes', - 'type' => 'checkbox', - 'checkboxgroup' => 'start', - 'autoload' => false, - ), - - array( - 'desc' => __( 'Hide shipping costs until an address is entered', 'woocommerce' ), - 'id' => 'woocommerce_shipping_cost_requires_address', - 'default' => 'no', - 'type' => 'checkbox', - 'checkboxgroup' => 'end', - 'autoload' => false, - ), - - array( - 'title' => __( 'Shipping destination', 'woocommerce' ), - 'desc' => __( 'This controls which shipping address is used by default.', 'woocommerce' ), - 'id' => 'woocommerce_ship_to_destination', - 'default' => 'billing', - 'type' => 'radio', - 'options' => array( - 'shipping' => __( 'Default to customer shipping address', 'woocommerce' ), - 'billing' => __( 'Default to customer billing address', 'woocommerce' ), - 'billing_only' => __( 'Force shipping to the customer billing address', 'woocommerce' ), + array( + 'title' => __( 'Shipping options', 'woocommerce' ), + 'type' => 'title', + 'id' => 'shipping_options', ), - 'autoload' => false, - 'desc_tip' => true, - 'show_if_checked' => 'option', - ), - array( - 'title' => __( 'Debug mode', 'woocommerce' ), - 'desc' => __( 'Enable debug mode', 'woocommerce' ), - 'desc_tip' => __( 'Enable shipping debug mode to show matching shipping zones and to bypass shipping rate cache.', 'woocommerce' ), - 'id' => 'woocommerce_shipping_debug_mode', - 'default' => 'no', - 'type' => 'checkbox', - 'autoload' => false, - ), + array( + 'title' => __( 'Calculations', 'woocommerce' ), + 'desc' => __( 'Enable the shipping calculator on the cart page', 'woocommerce' ), + 'id' => 'woocommerce_enable_shipping_calc', + 'default' => 'yes', + 'type' => 'checkbox', + 'checkboxgroup' => 'start', + 'autoload' => false, + ), - array( 'type' => 'sectionend', 'id' => 'shipping_options' ), + array( + 'desc' => __( 'Hide shipping costs until an address is entered', 'woocommerce' ), + 'id' => 'woocommerce_shipping_cost_requires_address', + 'default' => 'no', + 'type' => 'checkbox', + 'checkboxgroup' => 'end', + ), - ) ); + array( + 'title' => __( 'Shipping destination', 'woocommerce' ), + 'desc' => __( 'This controls which shipping address is used by default.', 'woocommerce' ), + 'id' => 'woocommerce_ship_to_destination', + 'default' => 'billing', + 'type' => 'radio', + 'options' => array( + 'shipping' => __( 'Default to customer shipping address', 'woocommerce' ), + 'billing' => __( 'Default to customer billing address', 'woocommerce' ), + 'billing_only' => __( 'Force shipping to the customer billing address', 'woocommerce' ), + ), + 'autoload' => false, + 'desc_tip' => true, + 'show_if_checked' => 'option', + ), + + array( + 'title' => __( 'Debug mode', 'woocommerce' ), + 'desc' => __( 'Enable debug mode', 'woocommerce' ), + 'desc_tip' => __( 'Enable shipping debug mode to show matching shipping zones and to bypass shipping rate cache.', 'woocommerce' ), + 'id' => 'woocommerce_shipping_debug_mode', + 'default' => 'no', + 'type' => 'checkbox', + ), + + array( + 'type' => 'sectionend', + 'id' => 'shipping_options', + ), + + ) + ); } return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings, $current_section ); @@ -144,7 +145,7 @@ class WC_Settings_Shipping extends WC_Settings_Page { public function output() { global $current_section, $hide_save_button; - // Load shipping methods so we can show any global options they may have + // Load shipping methods so we can show any global options they may have. $shipping_methods = WC()->shipping->load_shipping_methods(); if ( '' === $current_section ) { @@ -157,7 +158,7 @@ class WC_Settings_Shipping extends WC_Settings_Page { $this->output_shipping_class_screen(); } else { foreach ( $shipping_methods as $method ) { - if ( in_array( $current_section, array( $method->id, sanitize_title( get_class( $method ) ) ) ) && $method->has_settings() ) { + if ( in_array( $current_section, array( $method->id, sanitize_title( get_class( $method ) ) ), true ) && $method->has_settings() ) { $method->admin_options(); } } @@ -171,24 +172,27 @@ class WC_Settings_Shipping extends WC_Settings_Page { global $current_section; switch ( $current_section ) { - case 'options' : + case 'options': WC_Admin_Settings::save_fields( $this->get_settings() ); - break; - case 'classes' : - case '' : - break; - default : + do_action( 'woocommerce_update_options_' . $this->id . '_options' ); + break; + case 'classes': + do_action( 'woocommerce_update_options_' . $this->id . '_classes' ); + break; + case '': + break; + default: $wc_shipping = WC_Shipping::instance(); foreach ( $wc_shipping->get_shipping_methods() as $method_id => $method ) { - if ( in_array( $current_section, array( $method->id, sanitize_title( get_class( $method ) ) ) ) ) { + if ( in_array( $current_section, array( $method->id, sanitize_title( get_class( $method ) ) ), true ) ) { do_action( 'woocommerce_update_options_' . $this->id . '_' . $method->id ); } } - break; + break; } - // Increments the transient version to invalidate cache + // Increments the transient version to invalidate cache. WC_Cache_Helper::get_transient_version( 'shipping', true ); } @@ -198,11 +202,11 @@ class WC_Settings_Shipping extends WC_Settings_Page { protected function output_zones_screen() { global $hide_save_button; - if ( isset( $_REQUEST['zone_id'] ) ) { + if ( isset( $_REQUEST['zone_id'] ) ) { // WPCS: input var ok, CSRF ok. $hide_save_button = true; - $this->zone_methods_screen( wc_clean( $_REQUEST['zone_id'] ) ); + $this->zone_methods_screen( wc_clean( wp_unslash( $_REQUEST['zone_id'] ) ) ); // WPCS: input var ok, CSRF ok. } elseif ( isset( $_REQUEST['instance_id'] ) ) { - $this->instance_settings_screen( absint( $_REQUEST['instance_id'] ) ); + $this->instance_settings_screen( absint( wp_unslash( $_REQUEST['instance_id'] ) ) ); // WPCS: input var ok, CSRF ok. } else { $hide_save_button = true; $this->zones_screen(); @@ -211,7 +215,8 @@ class WC_Settings_Shipping extends WC_Settings_Page { /** * Show method for a zone - * @param int $zone_id + * + * @param int $zone_id Zone ID. */ protected function zone_methods_screen( $zone_id ) { if ( 'new' === $zone_id ) { @@ -221,15 +226,15 @@ class WC_Settings_Shipping extends WC_Settings_Page { } if ( ! $zone ) { - wp_die( __( 'Zone does not exist!', 'woocommerce' ) ); + wp_die( esc_html__( 'Zone does not exist!', 'woocommerce' ) ); } $allowed_countries = WC()->countries->get_allowed_countries(); - $wc_shipping = WC_Shipping ::instance(); + $wc_shipping = WC_Shipping::instance(); $shipping_methods = $wc_shipping->get_shipping_methods(); $continents = WC()->countries->get_continents(); - // Prepare locations + // Prepare locations. $locations = array(); $postcodes = array(); @@ -241,24 +246,26 @@ class WC_Settings_Shipping extends WC_Settings_Page { } } - wp_localize_script( 'wc-shipping-zone-methods', 'shippingZoneMethodsLocalizeScript', array( - 'methods' => $zone->get_shipping_methods(), - 'zone_name' => $zone->get_zone_name(), - 'zone_id' => $zone->get_id(), - 'wc_shipping_zones_nonce' => wp_create_nonce( 'wc_shipping_zones_nonce' ), - 'strings' => array( - 'unload_confirmation_msg' => __( 'Your changed data will be lost if you leave this page without saving.', 'woocommerce' ), - 'save_changes_prompt' => __( 'Do you wish to save your changes first? Your changed data will be discarded if you choose to cancel.', 'woocommerce' ), - 'save_failed' => __( 'Your changes were not saved. Please retry.', 'woocommerce' ), - 'add_method_failed' => __( 'Shipping method could not be added. Please retry.', 'woocommerce' ), - 'yes' => __( 'Yes', 'woocommerce' ), - 'no' => __( 'No', 'woocommerce' ), - 'default_zone_name' => __( 'Zone', 'woocommerce' ), - ), - ) ); + wp_localize_script( + 'wc-shipping-zone-methods', 'shippingZoneMethodsLocalizeScript', array( + 'methods' => $zone->get_shipping_methods( false, 'json' ), + 'zone_name' => $zone->get_zone_name(), + 'zone_id' => $zone->get_id(), + 'wc_shipping_zones_nonce' => wp_create_nonce( 'wc_shipping_zones_nonce' ), + 'strings' => array( + 'unload_confirmation_msg' => __( 'Your changed data will be lost if you leave this page without saving.', 'woocommerce' ), + 'save_changes_prompt' => __( 'Do you wish to save your changes first? Your changed data will be discarded if you choose to cancel.', 'woocommerce' ), + 'save_failed' => __( 'Your changes were not saved. Please retry.', 'woocommerce' ), + 'add_method_failed' => __( 'Shipping method could not be added. Please retry.', 'woocommerce' ), + 'yes' => __( 'Yes', 'woocommerce' ), + 'no' => __( 'No', 'woocommerce' ), + 'default_zone_name' => __( 'Zone', 'woocommerce' ), + ), + ) + ); wp_enqueue_script( 'wc-shipping-zone-methods' ); - include_once( dirname( __FILE__ ) . '/views/html-admin-page-shipping-zone-methods.php' ); + include_once dirname( __FILE__ ) . '/views/html-admin-page-shipping-zone-methods.php'; } /** @@ -269,55 +276,58 @@ class WC_Settings_Shipping extends WC_Settings_Page { $continents = WC()->countries->get_continents(); $method_count = wc_get_shipping_method_count(); - wp_localize_script( 'wc-shipping-zones', 'shippingZonesLocalizeScript', array( - 'zones' => WC_Shipping_Zones::get_zones(), - 'default_zone' => array( - 'zone_id' => 0, - 'zone_name' => '', - 'zone_order' => null, - ), - 'wc_shipping_zones_nonce' => wp_create_nonce( 'wc_shipping_zones_nonce' ), - 'strings' => array( - 'unload_confirmation_msg' => __( 'Your changed data will be lost if you leave this page without saving.', 'woocommerce' ), - 'delete_confirmation_msg' => __( 'Are you sure you want to delete this zone? This action cannot be undone.', 'woocommerce' ), - 'save_failed' => __( 'Your changes were not saved. Please retry.', 'woocommerce' ), - 'no_shipping_methods_offered' => __( 'No shipping methods offered to this zone.', 'woocommerce' ), - ), - ) ); + wp_localize_script( + 'wc-shipping-zones', 'shippingZonesLocalizeScript', array( + 'zones' => WC_Shipping_Zones::get_zones( 'json' ), + 'default_zone' => array( + 'zone_id' => 0, + 'zone_name' => '', + 'zone_order' => null, + ), + 'wc_shipping_zones_nonce' => wp_create_nonce( 'wc_shipping_zones_nonce' ), + 'strings' => array( + 'unload_confirmation_msg' => __( 'Your changed data will be lost if you leave this page without saving.', 'woocommerce' ), + 'delete_confirmation_msg' => __( 'Are you sure you want to delete this zone? This action cannot be undone.', 'woocommerce' ), + 'save_failed' => __( 'Your changes were not saved. Please retry.', 'woocommerce' ), + 'no_shipping_methods_offered' => __( 'No shipping methods offered to this zone.', 'woocommerce' ), + ), + ) + ); wp_enqueue_script( 'wc-shipping-zones' ); - include_once( dirname( __FILE__ ) . '/views/html-admin-page-shipping-zones.php' ); + include_once dirname( __FILE__ ) . '/views/html-admin-page-shipping-zones.php'; } /** * Show instance settings - * @param int $instance_id + * + * @param int $instance_id Shipping instance ID. */ protected function instance_settings_screen( $instance_id ) { $zone = WC_Shipping_Zones::get_zone_by( 'instance_id', $instance_id ); $shipping_method = WC_Shipping_Zones::get_shipping_method( $instance_id ); if ( ! $shipping_method ) { - wp_die( __( 'Invalid shipping method!', 'woocommerce' ) ); + wp_die( esc_html__( 'Invalid shipping method!', 'woocommerce' ) ); } if ( ! $zone ) { - wp_die( __( 'Zone does not exist!', 'woocommerce' ) ); + wp_die( esc_html__( 'Zone does not exist!', 'woocommerce' ) ); } if ( ! $shipping_method->has_settings() ) { - wp_die( __( 'This shipping method does not have any settings to configure.', 'woocommerce' ) ); + wp_die( esc_html__( 'This shipping method does not have any settings to configure.', 'woocommerce' ) ); } - if ( ! empty( $_POST['save'] ) ) { + if ( ! empty( $_POST['save'] ) ) { // WPCS: input var ok, sanitization ok. - if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'woocommerce-settings' ) ) { - echo '

          ' . __( 'Edit failed. Please try again.', 'woocommerce' ) . '

          '; + if ( empty( $_REQUEST['_wpnonce'] ) || ! wp_verify_nonce( wp_unslash( $_REQUEST['_wpnonce'] ), 'woocommerce-settings' ) ) { // WPCS: input var ok, sanitization ok. + echo '

          ' . esc_html__( 'Edit failed. Please try again.', 'woocommerce' ) . '

          '; } $shipping_method->process_admin_options(); $shipping_method->display_errors(); } - include_once( dirname( __FILE__ ) . '/views/html-admin-page-shipping-zones-instance.php' ); + include_once dirname( __FILE__ ) . '/views/html-admin-page-shipping-zones-instance.php'; } /** @@ -325,33 +335,35 @@ class WC_Settings_Shipping extends WC_Settings_Page { */ protected function output_shipping_class_screen() { $wc_shipping = WC_Shipping::instance(); - wp_localize_script( 'wc-shipping-classes', 'shippingClassesLocalizeScript', array( - 'classes' => $wc_shipping->get_shipping_classes(), - 'default_shipping_class' => array( - 'term_id' => 0, - 'name' => '', - 'description' => '', - ), - 'wc_shipping_classes_nonce' => wp_create_nonce( 'wc_shipping_classes_nonce' ), - 'strings' => array( - 'unload_confirmation_msg' => __( 'Your changed data will be lost if you leave this page without saving.', 'woocommerce' ), - 'save_failed' => __( 'Your changes were not saved. Please retry.', 'woocommerce' ), - ), - ) ); + wp_localize_script( + 'wc-shipping-classes', 'shippingClassesLocalizeScript', array( + 'classes' => $wc_shipping->get_shipping_classes(), + 'default_shipping_class' => array( + 'term_id' => 0, + 'name' => '', + 'description' => '', + ), + 'wc_shipping_classes_nonce' => wp_create_nonce( 'wc_shipping_classes_nonce' ), + 'strings' => array( + 'unload_confirmation_msg' => __( 'Your changed data will be lost if you leave this page without saving.', 'woocommerce' ), + 'save_failed' => __( 'Your changes were not saved. Please retry.', 'woocommerce' ), + ), + ) + ); wp_enqueue_script( 'wc-shipping-classes' ); // Extendable columns to show on the shipping classes screen. - $shipping_class_columns = apply_filters( 'woocommerce_shipping_classes_columns', array( - 'wc-shipping-class-name' => __( 'Shipping class', 'woocommerce' ), - 'wc-shipping-class-slug' => __( 'Slug', 'woocommerce' ), - 'wc-shipping-class-description' => __( 'Description', 'woocommerce' ), - 'wc-shipping-class-count' => __( 'Product count', 'woocommerce' ), - ) ); + $shipping_class_columns = apply_filters( + 'woocommerce_shipping_classes_columns', array( + 'wc-shipping-class-name' => __( 'Shipping class', 'woocommerce' ), + 'wc-shipping-class-slug' => __( 'Slug', 'woocommerce' ), + 'wc-shipping-class-description' => __( 'Description', 'woocommerce' ), + 'wc-shipping-class-count' => __( 'Product count', 'woocommerce' ), + ) + ); - include_once( dirname( __FILE__ ) . '/views/html-admin-page-shipping-classes.php' ); + include_once dirname( __FILE__ ) . '/views/html-admin-page-shipping-classes.php'; } } -endif; - return new WC_Settings_Shipping(); diff --git a/includes/admin/settings/class-wc-settings-tax.php b/includes/admin/settings/class-wc-settings-tax.php index 958390bd60b..a21142595b5 100644 --- a/includes/admin/settings/class-wc-settings-tax.php +++ b/includes/admin/settings/class-wc-settings-tax.php @@ -12,33 +12,35 @@ if ( ! defined( 'ABSPATH' ) ) { exit; } -if ( ! class_exists( 'WC_Settings_Tax', false ) ) : +if ( class_exists( 'WC_Settings_Tax', false ) ) { + return new WC_Settings_Tax(); +} /** * WC_Settings_Tax. */ class WC_Settings_Tax extends WC_Settings_Page { - /** - * Setting page id. - * - * @var string - */ - protected $id = 'tax'; - /** * Constructor. */ public function __construct() { + $this->id = 'tax'; $this->label = __( 'Tax', 'woocommerce' ); - parent::__construct(); + + add_filter( 'woocommerce_settings_tabs_array', array( $this, 'add_settings_page' ), 20 ); + + if ( wc_tax_enabled() ) { + add_action( 'woocommerce_sections_' . $this->id, array( $this, 'output_sections' ) ); + add_action( 'woocommerce_settings_' . $this->id, array( $this, 'output' ) ); + add_action( 'woocommerce_settings_save_' . $this->id, array( $this, 'save' ) ); + } } /** * Add this page to settings. * - * @param array $pages - * + * @param array $pages Existing pages. * @return array|mixed */ public function add_settings_page( $pages ) { @@ -60,7 +62,7 @@ class WC_Settings_Tax extends WC_Settings_Page { 'standard' => __( 'Standard rates', 'woocommerce' ), ); - // Get tax classes and display as links + // Get tax classes and display as links. $tax_classes = WC_Tax::get_tax_classes(); foreach ( $tax_classes as $class ) { @@ -73,15 +75,15 @@ class WC_Settings_Tax extends WC_Settings_Page { /** * Get settings array. * - * @param string $current_section + * @param string $current_section Current section being shown. * @return array */ public function get_settings( $current_section = '' ) { $settings = array(); if ( '' === $current_section ) { - $settings = include( 'views/settings-tax.php' ); - } + $settings = include 'views/settings-tax.php'; + } return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings, $current_section ); } @@ -93,7 +95,7 @@ class WC_Settings_Tax extends WC_Settings_Page { $tax_classes = WC_Tax::get_tax_class_slugs(); - if ( 'standard' === $current_section || in_array( $current_section, $tax_classes ) ) { + if ( 'standard' === $current_section || in_array( $current_section, $tax_classes, true ) ) { $this->output_tax_rates(); } else { $settings = $this->get_settings(); @@ -116,7 +118,13 @@ class WC_Settings_Tax extends WC_Settings_Page { $this->save_tax_rates(); } + if ( $current_section ) { + do_action( 'woocommerce_update_options_' . $this->id . '_' . $current_section ); + } + + // Invalidate caches. WC_Cache_Helper::incr_cache_prefix( 'taxes' ); + WC_Cache_Helper::get_transient_version( 'shipping', true ); } /** @@ -145,58 +153,65 @@ class WC_Settings_Tax extends WC_Settings_Page { } } - $base_url = admin_url( add_query_arg( array( - 'page' => 'wc-settings', - 'tab' => 'tax', - 'section' => $current_section, - ), 'admin.php' ) ); + $base_url = admin_url( + add_query_arg( + array( + 'page' => 'wc-settings', + 'tab' => 'tax', + 'section' => $current_section, + ), 'admin.php' + ) + ); // Localize and enqueue our js. - wp_localize_script( 'wc-settings-tax', 'htmlSettingsTaxLocalizeScript', array( - 'current_class' => $current_class, - 'wc_tax_nonce' => wp_create_nonce( 'wc_tax_nonce-class:' . $current_class ), - 'base_url' => $base_url, - 'rates' => array_values( WC_Tax::get_rates_for_tax_class( $current_class ) ), - 'page' => ! empty( $_GET['p'] ) ? absint( $_GET['p'] ) : 1, - 'limit' => 100, - 'countries' => $countries, - 'states' => $states, - 'default_rate' => array( - 'tax_rate_id' => 0, - 'tax_rate_country' => '', - 'tax_rate_state' => '', - 'tax_rate' => '', - 'tax_rate_name' => '', - 'tax_rate_priority' => 1, - 'tax_rate_compound' => 0, - 'tax_rate_shipping' => 1, - 'tax_rate_order' => null, - 'tax_rate_class' => $current_class, - ), - 'strings' => array( - 'no_rows_selected' => __( 'No row(s) selected', 'woocommerce' ), - 'unload_confirmation_msg' => __( 'Your changed data will be lost if you leave this page without saving.', 'woocommerce' ), - 'csv_data_cols' => array( - __( 'Country code', 'woocommerce' ), - __( 'State code', 'woocommerce' ), - __( 'Postcode / ZIP', 'woocommerce' ), - __( 'City', 'woocommerce' ), - __( 'Rate %', 'woocommerce' ), - __( 'Tax name', 'woocommerce' ), - __( 'Priority', 'woocommerce' ), - __( 'Compound', 'woocommerce' ), - __( 'Shipping', 'woocommerce' ), - __( 'Tax class', 'woocommerce' ), + wp_localize_script( + 'wc-settings-tax', 'htmlSettingsTaxLocalizeScript', array( + 'current_class' => $current_class, + 'wc_tax_nonce' => wp_create_nonce( 'wc_tax_nonce-class:' . $current_class ), + 'base_url' => $base_url, + 'rates' => array_values( WC_Tax::get_rates_for_tax_class( $current_class ) ), + 'page' => ! empty( $_GET['p'] ) ? absint( $_GET['p'] ) : 1, + 'limit' => 100, + 'countries' => $countries, + 'states' => $states, + 'default_rate' => array( + 'tax_rate_id' => 0, + 'tax_rate_country' => '', + 'tax_rate_state' => '', + 'tax_rate' => '', + 'tax_rate_name' => '', + 'tax_rate_priority' => 1, + 'tax_rate_compound' => 0, + 'tax_rate_shipping' => 1, + 'tax_rate_order' => null, + 'tax_rate_class' => $current_class, ), - ), - ) ); + 'strings' => array( + 'no_rows_selected' => __( 'No row(s) selected', 'woocommerce' ), + 'unload_confirmation_msg' => __( 'Your changed data will be lost if you leave this page without saving.', 'woocommerce' ), + 'csv_data_cols' => array( + __( 'Country code', 'woocommerce' ), + __( 'State code', 'woocommerce' ), + __( 'Postcode / ZIP', 'woocommerce' ), + __( 'City', 'woocommerce' ), + __( 'Rate %', 'woocommerce' ), + __( 'Tax name', 'woocommerce' ), + __( 'Priority', 'woocommerce' ), + __( 'Compound', 'woocommerce' ), + __( 'Shipping', 'woocommerce' ), + __( 'Tax class', 'woocommerce' ), + ), + ), + ) + ); wp_enqueue_script( 'wc-settings-tax' ); - include( 'views/html-settings-tax.php' ); + include 'views/html-settings-tax.php'; } /** * Get tax class being edited. + * * @return string */ private static function get_current_tax_class() { @@ -206,7 +221,7 @@ class WC_Settings_Tax extends WC_Settings_Page { $current_class = ''; foreach ( $tax_classes as $class ) { - if ( sanitize_title( $class ) == $current_section ) { + if ( sanitize_title( $class ) === $current_section ) { $current_class = $class; } } @@ -216,13 +231,14 @@ class WC_Settings_Tax extends WC_Settings_Page { /** * Get a posted tax rate. - * @param string $key Key of tax rate in the post data array - * @param int $order Position/order of rate - * @param string $class Tax class for rate + * + * @param string $key Key of tax rate in the post data array. + * @param int $order Position/order of rate. + * @param string $class Tax class for rate. * @return array */ private function get_posted_tax_rate( $key, $order, $class ) { - $tax_rate = array(); + $tax_rate = array(); $tax_rate_keys = array( 'tax_rate_country', 'tax_rate_state', @@ -232,8 +248,8 @@ class WC_Settings_Tax extends WC_Settings_Page { ); foreach ( $tax_rate_keys as $tax_rate_key ) { - if ( isset( $_POST[ $tax_rate_key ] ) && isset( $_POST[ $tax_rate_key ][ $key ] ) ) { - $tax_rate[ $tax_rate_key ] = wc_clean( $_POST[ $tax_rate_key ][ $key ] ); + if ( isset( $_POST[ $tax_rate_key ], $_POST[ $tax_rate_key ][ $key ] ) ) { + $tax_rate[ $tax_rate_key ] = wc_clean( wp_unslash( $_POST[ $tax_rate_key ][ $key ] ) ); } } @@ -251,24 +267,25 @@ class WC_Settings_Tax extends WC_Settings_Page { public function save_tax_rates() { global $wpdb; - $current_class = sanitize_title( $this->get_current_tax_class() ); + $current_class = sanitize_title( $this->get_current_tax_class() ); + $posted_countries = wc_clean( wp_unslash( $_POST['tax_rate_country'] ) ); - // get the tax rate id of the first submited row - $first_tax_rate_id = key( $_POST['tax_rate_country'] ); + // get the tax rate id of the first submited row. + $first_tax_rate_id = key( $posted_countries ); - // get the order position of the first tax rate id + // get the order position of the first tax rate id. $tax_rate_order = absint( $wpdb->get_var( $wpdb->prepare( "SELECT tax_rate_order FROM {$wpdb->prefix}woocommerce_tax_rates WHERE tax_rate_id = %s", $first_tax_rate_id ) ) ); $index = isset( $tax_rate_order ) ? $tax_rate_order : 0; - // Loop posted fields - foreach ( $_POST['tax_rate_country'] as $key => $value ) { - $mode = ( 0 === strpos( $key, 'new-' ) ) ? 'insert' : 'update'; - $tax_rate = $this->get_posted_tax_rate( $key, $index ++, $current_class ); + // Loop posted fields. + foreach ( $posted_countries as $key => $value ) { + $mode = ( 0 === strpos( $key, 'new-' ) ) ? 'insert' : 'update'; + $tax_rate = $this->get_posted_tax_rate( $key, $index ++, $current_class ); if ( 'insert' === $mode ) { $tax_rate_id = WC_Tax::_insert_tax_rate( $tax_rate ); - } elseif ( 1 == $_POST['remove_tax_rate'][ $key ] ) { + } elseif ( 1 === absint( $_POST['remove_tax_rate'][ $key ] ) ) { $tax_rate_id = absint( $key ); WC_Tax::_delete_tax_rate( $tax_rate_id ); continue; @@ -278,15 +295,13 @@ class WC_Settings_Tax extends WC_Settings_Page { } if ( isset( $_POST['tax_rate_postcode'][ $key ] ) ) { - WC_Tax::_update_tax_rate_postcodes( $tax_rate_id, wc_clean( $_POST['tax_rate_postcode'][ $key ] ) ); + WC_Tax::_update_tax_rate_postcodes( $tax_rate_id, wc_clean( wp_unslash( $_POST['tax_rate_postcode'][ $key ] ) ) ); } if ( isset( $_POST['tax_rate_city'][ $key ] ) ) { - WC_Tax::_update_tax_rate_cities( $tax_rate_id, wc_clean( $_POST['tax_rate_city'][ $key ] ) ); + WC_Tax::_update_tax_rate_cities( $tax_rate_id, wc_clean( wp_unslash( $_POST['tax_rate_city'][ $key ] ) ) ); } } } } -endif; - return new WC_Settings_Tax(); diff --git a/includes/admin/settings/views/class-wc-settings-rest-api.php b/includes/admin/settings/views/class-wc-settings-rest-api.php new file mode 100644 index 00000000000..ab8a69a11d2 --- /dev/null +++ b/includes/admin/settings/views/class-wc-settings-rest-api.php @@ -0,0 +1,11 @@ +

          - - + +

          + + + + '', + 'name' => __( 'Method', 'woocommerce' ), + 'status' => __( 'Enabled', 'woocommerce' ), + 'description' => __( 'Description', 'woocommerce' ), + 'action' => '', + ); + + $columns = apply_filters( 'woocommerce_payment_gateways_setting_columns', $default_columns ); + + foreach ( $columns as $key => $column ) { + echo ''; + } + ?> + + + + payment_gateways->payment_gateways() as $gateway ) { + + echo ''; + + foreach ( $columns as $key => $column ) { + if ( ! array_key_exists( $key, $default_columns ) ) { + do_action( 'woocommerce_payment_gateways_setting_column_' . $key, $gateway ); + continue; + } + + $width = ''; + + if ( in_array( $key, array( 'sort', 'status', 'action' ), true ) ) { + $width = '1%'; + } + + $method_title = $gateway->get_method_title() ? $gateway->get_method_title() : $gateway->get_title(); + $custom_title = $gateway->get_title(); + + echo ''; + } + + echo ''; + } + ?> + +
          ' . esc_html( $column ) . '
          '; + + switch ( $key ) { + case 'sort': + ?> +
          + + + +
          + id ) ) ) . '" class="wc-payment-gateway-method-title">' . wp_kses_post( $method_title ) . ''; + + if ( $method_title !== $custom_title ) { + echo ' – ' . wp_kses_post( $custom_title ) . ''; + } + break; + case 'description': + echo wp_kses_post( $gateway->get_method_description() ); + break; + case 'action': + if ( wc_string_to_bool( $gateway->enabled ) ) { + /* Translators: %s Payment gateway name. */ + echo '' . esc_html__( 'Manage', 'woocommerce' ) . ''; + } else { + /* Translators: %s Payment gateway name. */ + echo '' . esc_html__( 'Set up', 'woocommerce' ) . ''; + } + break; + case 'status': + echo ''; + if ( wc_string_to_bool( $gateway->enabled ) ) { + /* Translators: %s Payment gateway name. */ + echo '' . esc_attr__( 'Yes', 'woocommerce' ) . ''; + } else { + /* Translators: %s Payment gateway name. */ + echo '' . esc_attr__( 'No', 'woocommerce' ) . ''; + } + echo ''; + break; + } + + echo '
          +
          @@ -19,8 +25,8 @@ if ( ! defined( 'ABSPATH' ) ) { - @@ -30,55 +36,55 @@ if ( ! defined( 'ABSPATH' ) ) { diff --git a/includes/admin/settings/views/html-admin-page-shipping-zone-methods.php b/includes/admin/settings/views/html-admin-page-shipping-zone-methods.php index b293677329c..9524a51a17d 100644 --- a/includes/admin/settings/views/html-admin-page-shipping-zone-methods.php +++ b/includes/admin/settings/views/html-admin-page-shipping-zone-methods.php @@ -1,11 +1,17 @@

          - > + > get_zone_name() ? $zone->get_zone_name() : __( 'Zone', 'woocommerce' ) ); ?>

          @@ -16,59 +22,66 @@ if ( ! defined( 'ABSPATH' ) ) { get_id() ) : ?> @@ -120,15 +136,17 @@ if ( ! defined( 'ABSPATH' ) ) {
          -

          +

          + ?> +
          @@ -139,7 +157,7 @@ if ( ! defined( 'ABSPATH' ) ) {
          - +
          @@ -153,9 +171,9 @@ if ( ! defined( 'ABSPATH' ) ) {
          -

          +

          @@ -165,12 +183,12 @@ if ( ! defined( 'ABSPATH' ) ) {
          @@ -178,7 +196,7 @@ if ( ! defined( 'ABSPATH' ) ) {
          - +
          diff --git a/includes/admin/settings/views/html-admin-page-shipping-zones.php b/includes/admin/settings/views/html-admin-page-shipping-zones.php index 04d2963167a..339707bd669 100644 --- a/includes/admin/settings/views/html-admin-page-shipping-zones.php +++ b/includes/admin/settings/views/html-admin-page-shipping-zones.php @@ -32,18 +32,18 @@ if ( ! defined( 'ABSPATH' ) ) {
          @@ -104,12 +104,12 @@ if ( ! defined( 'ABSPATH' ) ) { diff --git a/includes/admin/settings/views/html-keys-edit.php b/includes/admin/settings/views/html-keys-edit.php index 7b7d339251f..c98e3c89105 100644 --- a/includes/admin/settings/views/html-keys-edit.php +++ b/includes/admin/settings/views/html-keys-edit.php @@ -5,7 +5,7 @@ if ( ! defined( 'ABSPATH' ) ) { ?>
          -

          +

          @@ -13,8 +13,10 @@ if ( ! defined( 'ABSPATH' ) ) {
          @@ -97,16 +106,16 @@ if ( ! defined( 'ABSPATH' ) ) { -

          - - -

          - +

          + + +

          + @@ -116,23 +125,23 @@ if ( ! defined( 'ABSPATH' ) ) { + diff --git a/templates/cart/cart-totals.php b/templates/cart/cart-totals.php index 3084cee5215..517c803d866 100644 --- a/templates/cart/cart-totals.php +++ b/templates/cart/cart-totals.php @@ -65,7 +65,7 @@ if ( ! defined( 'ABSPATH' ) ) { - cart->tax_display_cart ) : + cart->display_prices_including_tax() ) : $taxable_address = WC()->customer->get_taxable_address(); $estimated_text = WC()->customer->is_customer_outside_base() && ! WC()->customer->has_calculated_shipping() ? sprintf( ' ' . __( '(estimated for %s)', 'woocommerce' ) . '', WC()->countries->estimated_for_prefix( $taxable_address[0] ) . WC()->countries->countries[ $taxable_address[0] ] ) diff --git a/templates/cart/cart.php b/templates/cart/cart.php index d458113d567..8a9c11f6139 100644 --- a/templates/cart/cart.php +++ b/templates/cart/cart.php @@ -11,16 +11,11 @@ * the readme will list any important changes. * * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes * @package WooCommerce/Templates - * @version 3.1.0 + * @version 3.5.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} - -wc_print_notices(); +defined( 'ABSPATH' ) || exit; do_action( 'woocommerce_before_cart' ); ?> @@ -32,10 +27,10 @@ do_action( 'woocommerce_before_cart' ); ?> - - - - + + + + @@ -53,9 +48,10 @@ do_action( 'woocommerce_before_cart' ); ?> @@ -134,16 +133,16 @@ do_action( 'woocommerce_before_cart' ); ?>
          - +
          - + - + @@ -156,12 +155,12 @@ do_action( 'woocommerce_before_cart' ); ?>
          diff --git a/templates/cart/mini-cart.php b/templates/cart/mini-cart.php index f7679dee0cc..2ef59e98baf 100644 --- a/templates/cart/mini-cart.php +++ b/templates/cart/mini-cart.php @@ -15,7 +15,7 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 3.2.0 + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; @@ -43,22 +43,21 @@ do_action( 'woocommerce_before_mini_cart' ); ?> ×', - esc_url( WC()->cart->get_remove_url( $cart_item_key ) ), + esc_url( wc_get_cart_remove_url( $cart_item_key ) ), __( 'Remove this item', 'woocommerce' ), esc_attr( $product_id ), esc_attr( $cart_item_key ), esc_attr( $_product->get_sku() ) ), $cart_item_key ); ?> - is_visible() ) : ?> - + + - + - cart->get_item_data( $cart_item ); ?> - + ' . sprintf( '%s × %s', $cart_item['quantity'], $product_price ) . '', $cart_item, $cart_item_key ); ?> cart->needs_shipping() ) { - return; -} - -wp_enqueue_script( 'wc-country-select' ); +defined( 'ABSPATH' ) || exit; do_action( 'woocommerce_before_shipping_calculator' ); ?> -

          + %s', esc_html( ! empty( $button_text ) ? $button_text : __( 'Calculate shipping', 'woocommerce' ) ) ); ?> diff --git a/templates/checkout/cart-errors.php b/templates/checkout/cart-errors.php index a50eef6e0a5..500245e16bc 100644 --- a/templates/checkout/cart-errors.php +++ b/templates/checkout/cart-errors.php @@ -10,22 +10,16 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 2.4.0 + * @version 3.5.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} - +defined( 'ABSPATH' ) || exit; ?> - - -

          +

          -

          +

          diff --git a/templates/checkout/form-checkout.php b/templates/checkout/form-checkout.php index 1249303e042..1fccf5e7d80 100644 --- a/templates/checkout/form-checkout.php +++ b/templates/checkout/form-checkout.php @@ -10,23 +10,20 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 2.3.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } -wc_print_notices(); - do_action( 'woocommerce_before_checkout_form', $checkout ); -// If checkout registration is disabled and not logged in, the user cannot checkout +// If checkout registration is disabled and not logged in, the user cannot checkout. if ( ! $checkout->is_registration_enabled() && $checkout->is_registration_required() && ! is_user_logged_in() ) { - echo apply_filters( 'woocommerce_checkout_must_be_logged_in_message', __( 'You must be logged in to checkout.', 'woocommerce' ) ); + echo esc_html( apply_filters( 'woocommerce_checkout_must_be_logged_in_message', __( 'You must be logged in to checkout.', 'woocommerce' ) ) ); return; } @@ -52,7 +49,7 @@ if ( ! $checkout->is_registration_enabled() && $checkout->is_registration_requir -

          +

          diff --git a/templates/checkout/form-coupon.php b/templates/checkout/form-coupon.php index d9c71293937..f530f94aca6 100644 --- a/templates/checkout/form-coupon.php +++ b/templates/checkout/form-coupon.php @@ -10,34 +10,32 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 2.2 + * @version 3.4.4 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; -if ( ! wc_coupons_enabled() ) { +if ( ! wc_coupons_enabled() ) { // @codingStandardsIgnoreLine. return; } -if ( empty( WC()->cart->applied_coupons ) ) { - $info_message = apply_filters( 'woocommerce_checkout_coupon_message', __( 'Have a coupon?', 'woocommerce' ) . ' ' . __( 'Click here to enter your code', 'woocommerce' ) . '' ); - wc_print_notice( $info_message, 'notice' ); -} ?> +
          + ' . __( 'Click here to enter your code', 'woocommerce' ) . '' ), 'notice' ); ?> +
          - + + +

          - +

          diff --git a/templates/checkout/form-login.php b/templates/checkout/form-login.php index 15ff3937401..1ed162bdd14 100644 --- a/templates/checkout/form-login.php +++ b/templates/checkout/form-login.php @@ -10,30 +10,27 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 2.0.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; if ( is_user_logged_in() || 'no' === get_option( 'woocommerce_enable_checkout_login_reminder' ) ) { return; } -$info_message = apply_filters( 'woocommerce_checkout_login_message', __( 'Returning customer?', 'woocommerce' ) ); -$info_message .= ' ' . __( 'Click here to login', 'woocommerce' ) . ''; -wc_print_notice( $info_message, 'notice' ); +?> + + __( 'If you have shopped with us before, please enter your details in the boxes below. If you are a new customer, please proceed to the Billing & Shipping section.', 'woocommerce' ), + 'message' => __( 'If you have shopped with us before, please enter your details below. If you are a new customer, please proceed to the Billing & Shipping section.', 'woocommerce' ), 'redirect' => wc_get_page_permalink( 'checkout' ), 'hidden' => true, ) ); - -/* Omit closing PHP tag at the end of PHP files to avoid "headers already sent" issues. */ diff --git a/templates/checkout/form-pay.php b/templates/checkout/form-pay.php index 66a5437ec51..112dc5d60dc 100644 --- a/templates/checkout/form-pay.php +++ b/templates/checkout/form-pay.php @@ -10,59 +10,57 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 2.5.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; +$totals = $order->get_order_item_totals(); ?>
          - + +
          - - + - +
          - - + - $continent ) { - echo ''; + foreach ( $continents as $continent_code => $continent ) { + echo ''; - $countries = array_intersect( array_keys( $allowed_countries ), $continent['countries'] ); + $countries = array_intersect( array_keys( $allowed_countries ), $continent['countries'] ); - foreach ( $countries as $country_code ) { - echo ''; + foreach ( $countries as $country_code ) { + echo ''; - if ( $states = WC()->countries->get_states( $country_code ) ) { - foreach ( $states as $state_code => $state_name ) { - echo ''; - } + if ( $states = WC()->countries->get_states( $country_code ) ) { + foreach ( $states as $state_code => $state_name ) { + echo ''; } } } + } ?> - +
          - 90210...99000) are also supported.', 'woocommerce' ) ?> + + 90210...99000) are also supported. Please see the shipping zones documentation) for more information.', 'woocommerce' ), 'https://docs.woocommerce.com/document/setting-up-shipping-zones/#section-3' ); ?>
          - - + - + @@ -76,7 +89,7 @@ if ( ! defined( 'ABSPATH' ) ) { @@ -86,14 +99,17 @@ if ( ! defined( 'ABSPATH' ) ) {
          - +
          + + +

          - +

          @@ -104,7 +120,7 @@ if ( ! defined( 'ABSPATH' ) ) {           		{{{ data.title }}}
          - | + |
          		{{{ data.enabled_icon }}}
            get_shipping_methods(); - uasort( $methods, 'wc_shipping_zone_method_order_uasort_comparison' ); + $worldwide = new WC_Shipping_Zone( 0 ); + $methods = $worldwide->get_shipping_methods(); + uasort( $methods, 'wc_shipping_zone_method_order_uasort_comparison' ); - if ( ! empty( $methods ) ) { - foreach ( $methods as $method ) { - $class_name = 'yes' === $method->enabled ? 'method_enabled' : 'method_disabled'; - echo '
          • ' . esc_html( $method->get_title() ) . '
            • '; - } - } else { - echo '
          • ' . __( 'No shipping methods offered to this zone.', 'woocommerce' ) . '
            • '; + if ( ! empty( $methods ) ) { + foreach ( $methods as $method ) { + $class_name = 'yes' === $method->enabled ? 'method_enabled' : 'method_disabled'; + echo '
          • ' . esc_html( $method->get_title() ) . '
            • '; } + } else { + echo '
          • ' . __( 'No shipping methods offered to this zone.', 'woocommerce' ) . '
            • '; + } ?>
          - - + @@ -22,21 +24,23 @@ if ( ! defined( 'ABSPATH' ) ) {
          - - + display_name, - absint( $user->ID ), - $user->user_email - ); + $curent_user_id = get_current_user_id(); + $user_id = ! empty( $key_data['user_id'] ) ? absint( $key_data['user_id'] ) : $curent_user_id; + $user = get_user_by( 'id', $user_id ); + /* translators: 1: user display name 2: user ID 3: user email */ + $user_string = sprintf( + esc_html__( '%1$s (#%2$s – %3$s)', 'woocommerce' ), + $user->display_name, + absint( $user->ID ), + $user->user_email + ); ?>
          - - + @@ -67,7 +74,7 @@ if ( ! defined( 'ABSPATH' ) ) {
          - + … @@ -75,19 +82,21 @@ if ( ! defined( 'ABSPATH' ) ) {
          - + - + + echo apply_filters( 'woocommerce_api_key_last_access_datetime', $date, $key_data['last_access'] ); + } else { + esc_html_e( 'Unknown', 'woocommerce' ); + } + ?> +
          - + - +
          - + - +
          - +
          diff --git a/includes/admin/settings/views/html-settings-tax.php b/includes/admin/settings/views/html-settings-tax.php index f9d426cc301..98b6e910527 100644 --- a/includes/admin/settings/views/html-settings-tax.php +++ b/includes/admin/settings/views/html-settings-tax.php @@ -5,18 +5,20 @@ if ( ! defined( 'ABSPATH' ) ) { ?>
          -

          +

          + ?> + @@ -68,7 +70,7 @@ if ( ! defined( 'ABSPATH' ) ) { - + + + + + +
          - + @@ -98,13 +100,15 @@ if ( ! defined( 'ABSPATH' ) ) { '; } } @@ -193,28 +192,65 @@ class WC_Structured_Data { return; } - $shop_name = get_bloginfo( 'name' ); - $shop_url = home_url(); - $currency = get_woocommerce_currency(); - $markup = array(); - $markup['@type'] = 'Product'; - $markup['@id'] = get_permalink( $product->get_id() ); - $markup['url'] = $markup['@id']; - $markup['name'] = $product->get_name(); + $shop_name = get_bloginfo( 'name' ); + $shop_url = home_url(); + $currency = get_woocommerce_currency(); + + $markup = array( + '@type' => 'Product', + '@id' => get_permalink( $product->get_id() ), + 'name' => $product->get_name(), + ); if ( apply_filters( 'woocommerce_structured_data_product_limit', is_product_taxonomy() || is_shop() ) ) { + $markup['url'] = $markup['@id']; + $this->set_data( apply_filters( 'woocommerce_structured_data_product_limited', $markup, $product ) ); return; } + $markup['image'] = wp_get_attachment_url( $product->get_image_id() ); + $markup['description'] = wpautop( do_shortcode( $product->get_short_description() ? $product->get_short_description() : $product->get_description() ) ); + $markup['sku'] = $product->get_sku(); + if ( '' !== $product->get_price() ) { - $markup_offer = array( - '@type' => 'Offer', + if ( $product->is_type( 'variable' ) ) { + $lowest = $product->get_variation_price( 'min', false ); + $highest = $product->get_variation_price( 'max', false ); + + if ( $lowest === $highest ) { + $markup_offer = array( + '@type' => 'Offer', + 'price' => wc_format_decimal( $lowest, wc_get_price_decimals() ), + 'priceSpecification' => array( + 'price' => wc_format_decimal( $lowest, wc_get_price_decimals() ), + 'priceCurrency' => $currency, + 'valueAddedTaxIncluded' => wc_prices_include_tax() ? 'true' : 'false', + ), + ); + } else { + $markup_offer = array( + '@type' => 'AggregateOffer', + 'lowPrice' => wc_format_decimal( $lowest, wc_get_price_decimals() ), + 'highPrice' => wc_format_decimal( $highest, wc_get_price_decimals() ), + ); + } + } else { + $markup_offer = array( + '@type' => 'Offer', + 'price' => wc_format_decimal( $product->get_price(), wc_get_price_decimals() ), + 'priceSpecification' => array( + 'price' => wc_format_decimal( $product->get_price(), wc_get_price_decimals() ), + 'priceCurrency' => $currency, + 'valueAddedTaxIncluded' => wc_prices_include_tax() ? 'true' : 'false', + ), + ); + } + + $markup_offer += array( 'priceCurrency' => $currency, - 'availability' => 'https://schema.org/' . $stock = ( $product->is_in_stock() ? 'InStock' : 'OutOfStock' ), - 'sku' => $product->get_sku(), - 'image' => wp_get_attachment_url( $product->get_image_id() ), - 'description' => $product->get_description(), + 'availability' => 'https://schema.org/' . ( $product->is_in_stock() ? 'InStock' : 'OutOfStock' ), + 'url' => $markup['@id'], 'seller' => array( '@type' => 'Organization', 'name' => $shop_name, @@ -222,33 +258,13 @@ class WC_Structured_Data { ), ); - if ( $product->is_type( 'variable' ) ) { - $prices = $product->get_variation_prices(); - $lowest = reset( $prices['price'] ); - $highest = end( $prices['price'] ); - - if ( $lowest === $highest ) { - $markup_offer['price'] = wc_format_decimal( $product->get_price(), wc_get_price_decimals() ); - } else { - $markup_offer['priceSpecification'] = array( - 'price' => wc_format_decimal( $product->get_price(), wc_get_price_decimals() ), - 'minPrice' => wc_format_decimal( $lowest, wc_get_price_decimals() ), - 'maxPrice' => wc_format_decimal( $highest, wc_get_price_decimals() ), - 'priceCurrency' => $currency, - ); - } - } else { - $markup_offer['price'] = wc_format_decimal( $product->get_price(), wc_get_price_decimals() ); - } - $markup['offers'] = array( apply_filters( 'woocommerce_structured_data_product_offer', $markup_offer, $product ) ); } - if ( $product->get_rating_count() ) { + if ( $product->get_review_count() && 'yes' === get_option( 'woocommerce_enable_review_rating' ) ) { $markup['aggregateRating'] = array( '@type' => 'AggregateRating', 'ratingValue' => $product->get_average_rating(), - 'ratingCount' => $product->get_rating_count(), 'reviewCount' => $product->get_review_count(), ); } @@ -273,18 +289,20 @@ class WC_Structured_Data { '@type' => 'Product', 'name' => get_the_title( $comment->comment_post_ID ), ); - if ( $rating = get_comment_meta( $comment->comment_ID, 'rating', true ) ) { - $markup['reviewRating'] = array( + + // Skip replies unless they have a rating. + $rating = get_comment_meta( $comment->comment_ID, 'rating', true ); + + if ( $rating ) { + $markup['reviewRating'] = array( '@type' => 'rating', 'ratingValue' => $rating, ); - - // Skip replies unless they have a rating. } elseif ( $comment->comment_parent ) { return; } - $markup['author'] = array( + $markup['author'] = array( '@type' => 'Person', 'name' => get_comment_author( $comment->comment_ID ), ); @@ -319,7 +337,7 @@ class WC_Structured_Data { ), ); - if ( ! empty( $crumb[1] ) && sizeof( $crumbs ) !== $key + 1 ) { + if ( ! empty( $crumb[1] ) ) { $markup['itemListElement'][ $key ]['item'] += array( '@id' => $crumb[1] ); } } @@ -351,9 +369,9 @@ class WC_Structured_Data { * * Hooked into `woocommerce_email_order_details` action hook. * - * @param WP_Order $order Order data. - * @param bool $sent_to_admin Send to admin (default: false). - * @param bool $plain_text Plain text email (default: false). + * @param WP_Order $order Order data. + * @param bool $sent_to_admin Send to admin (default: false). + * @param bool $plain_text Plain text email (default: false). */ public function generate_order_data( $order, $sent_to_admin = false, $plain_text = false ) { if ( $plain_text || ! is_a( $order, 'WC_Order' ) ) { @@ -362,7 +380,7 @@ class WC_Structured_Data { $shop_name = get_bloginfo( 'name' ); $shop_url = home_url(); - $order_url = $sent_to_admin ? admin_url( 'post.php?post=' . absint( $order->get_id() ) . '&action=edit' ) : $order->get_view_order_url(); + $order_url = $sent_to_admin ? $order->get_edit_order_url() : $order->get_view_order_url(); $order_statuses = array( 'pending' => 'https://schema.org/OrderPaymentDue', 'processing' => 'https://schema.org/OrderProcessing', @@ -379,11 +397,11 @@ class WC_Structured_Data { continue; } - $product = apply_filters( 'woocommerce_order_item_product', $order->get_product_from_item( $item ), $item ); + $product = $order->get_product_from_item( $item ); $product_exists = is_object( $product ); $is_visible = $product_exists && $product->is_visible(); - $markup_offers[] = array( + $markup_offers[] = array( '@type' => 'Offer', 'price' => $order->get_line_subtotal( $item ), 'priceCurrency' => $order->get_currency(), @@ -424,7 +442,7 @@ class WC_Structured_Data { $markup['priceSpecification'] = array( 'price' => $order->get_total(), 'priceCurrency' => $order->get_currency(), - 'valueAddedTaxIncluded' => true, + 'valueAddedTaxIncluded' => 'true', ); $markup['billingAddress'] = array( '@type' => 'PostalAddress', diff --git a/includes/class-wc-tax.php b/includes/class-wc-tax.php index 2325f0e9cc9..65be6044158 100644 --- a/includes/class-wc-tax.php +++ b/includes/class-wc-tax.php @@ -27,7 +27,7 @@ class WC_Tax { * * @var bool */ - public static $round_at_subtotal; + public static $round_at_subtotal = false; /** * Load options. @@ -64,32 +64,20 @@ class WC_Tax { /** * Calculate tax for a line. - * @param float $price Price to calc tax on - * @param array $rates Rates to apply - * @param boolean $price_includes_tax Whether the passed price has taxes included - * @param boolean $suppress_rounding Whether to suppress any rounding from taking place - * @return array Array of rates + prices after tax + * + * @param float $price Price to calc tax on. + * @param array $rates Rates to apply. + * @param boolean $price_includes_tax Whether the passed price has taxes included. + * @param boolean $deprecated Whether to suppress any rounding from taking place. No longer used here. + * @return array Array of rates + prices after tax. */ - public static function calc_tax( $price, $rates, $price_includes_tax = false, $suppress_rounding = false ) { - // Work in pence to X precision - $price = self::precision( $price ); - + public static function calc_tax( $price, $rates, $price_includes_tax = false, $deprecated = false ) { if ( $price_includes_tax ) { $taxes = self::calc_inclusive_tax( $price, $rates ); } else { $taxes = self::calc_exclusive_tax( $price, $rates ); } - - // Round to precision - if ( ! self::$round_at_subtotal && ! $suppress_rounding ) { - $taxes = array_map( 'round', $taxes ); // Round to precision - } - - // Remove precision - $price = self::remove_precision( $price ); - $taxes = array_map( array( __CLASS__, 'remove_precision' ), $taxes ); - - return apply_filters( 'woocommerce_calc_tax', $taxes, $price, $rates, $price_includes_tax, $suppress_rounding ); + return apply_filters( 'woocommerce_calc_tax', $taxes, $price, $rates, $price_includes_tax, $deprecated ); } /** @@ -104,24 +92,6 @@ class WC_Tax { return apply_filters( 'woocommerce_calc_shipping_tax', $taxes, $price, $rates ); } - /** - * Multiply cost by pow precision. - * @param float $price - * @return float - */ - private static function precision( $price ) { - return $price * ( pow( 10, self::$precision ) ); - } - - /** - * Divide cost by pow precision. - * @param float $price - * @return float - */ - private static function remove_precision( $price ) { - return $price / ( pow( 10, self::$precision ) ); - } - /** * Round to precision. * @@ -137,51 +107,50 @@ class WC_Tax { * @return float */ public static function round( $in ) { - return apply_filters( 'woocommerce_tax_round', round( $in, self::$precision ), $in ); + return apply_filters( 'woocommerce_tax_round', round( $in, wc_get_rounding_precision() ), $in ); } /** * Calc tax from inclusive price. * - * @param float $price - * @param array $rates + * @param float $price Price to calculate tax for. + * @param array $rates Array of tax rates. * @return array */ public static function calc_inclusive_tax( $price, $rates ) { - $taxes = array(); - - $regular_tax_rates = $compound_tax_rates = 0; + $taxes = array(); + $compound_rates = array(); + $regular_rates = array(); + // Index array so taxes are output in correct order and see what compound/regular rates we have to calculate. foreach ( $rates as $key => $rate ) { + $taxes[ $key ] = 0; + if ( 'yes' === $rate['compound'] ) { - $compound_tax_rates = $compound_tax_rates + $rate['rate']; + $compound_rates[ $key ] = $rate['rate']; } else { - $regular_tax_rates = $regular_tax_rates + $rate['rate']; + $regular_rates[ $key ] = $rate['rate']; } } - $regular_tax_rate = 1 + ( $regular_tax_rates / 100 ); - $compound_tax_rate = 1 + ( $compound_tax_rates / 100 ); - $non_compound_price = $price / $compound_tax_rate; + $compound_rates = array_reverse( $compound_rates, true ); // Working backwards. - foreach ( $rates as $key => $rate ) { - if ( ! isset( $taxes[ $key ] ) ) { - $taxes[ $key ] = 0; - } + $non_compound_price = $price; - $the_rate = $rate['rate'] / 100; + foreach ( $compound_rates as $key => $compound_rate ) { + $tax_amount = apply_filters( 'woocommerce_price_inc_tax_amount', $non_compound_price - ( $non_compound_price / ( 1 + ( $compound_rate / 100 ) ) ), $key, $rates[ $key ], $price ); + $taxes[ $key ] += $tax_amount; + $non_compound_price = $non_compound_price - $tax_amount; + } - if ( 'yes' === $rate['compound'] ) { - $the_price = $price; - $the_rate = $the_rate / $compound_tax_rate; - } else { - $the_price = $non_compound_price; - $the_rate = $the_rate / $regular_tax_rate; - } + // Regular taxes. + $regular_tax_rate = 1 + ( array_sum( $regular_rates ) / 100 ); - $net_price = $price - ( $the_rate * $the_price ); - $tax_amount = $price - $net_price; - $taxes[ $key ] += apply_filters( 'woocommerce_price_inc_tax_amount', $tax_amount, $key, $rate, $price ); + foreach ( $regular_rates as $key => $regular_rate ) { + $the_rate = ( $regular_rate / 100 ) / $regular_tax_rate; + $net_price = $price - ( $the_rate * $non_compound_price ); + $tax_amount = apply_filters( 'woocommerce_price_inc_tax_amount', $price - $net_price, $key, $rates[ $key ], $price ); + $taxes[ $key ] += $tax_amount; } return $taxes; @@ -190,27 +159,22 @@ class WC_Tax { /** * Calc tax from exclusive price. * - * @param float $price - * @param array $rates + * @param float $price Price to calculate tax for. + * @param array $rates Array of tax rates. * @return array */ public static function calc_exclusive_tax( $price, $rates ) { $taxes = array(); if ( ! empty( $rates ) ) { - // Multiple taxes foreach ( $rates as $key => $rate ) { - if ( 'yes' === $rate['compound'] ) { continue; } $tax_amount = $price * ( $rate['rate'] / 100 ); + $tax_amount = apply_filters( 'woocommerce_price_ex_tax_amount', $tax_amount, $key, $rate, $price ); // ADVANCED: Allow third parties to modify this rate. - // ADVANCED: Allow third parties to modify this rate - $tax_amount = apply_filters( 'woocommerce_price_ex_tax_amount', $tax_amount, $key, $rate, $price ); - - // Add rate if ( ! isset( $taxes[ $key ] ) ) { $taxes[ $key ] = $tax_amount; } else { @@ -220,26 +184,22 @@ class WC_Tax { $pre_compound_total = array_sum( $taxes ); - // Compound taxes + // Compound taxes. foreach ( $rates as $key => $rate ) { - if ( 'no' === $rate['compound'] ) { continue; } - $the_price_inc_tax = $price + ( $pre_compound_total ); + $tax_amount = $the_price_inc_tax * ( $rate['rate'] / 100 ); + $tax_amount = apply_filters( 'woocommerce_price_ex_tax_amount', $tax_amount, $key, $rate, $price, $the_price_inc_tax, $pre_compound_total ); // ADVANCED: Allow third parties to modify this rate. - $tax_amount = $the_price_inc_tax * ( $rate['rate'] / 100 ); - - // ADVANCED: Allow third parties to modify this rate - $tax_amount = apply_filters( 'woocommerce_price_ex_tax_amount', $tax_amount, $key, $rate, $price, $the_price_inc_tax, $pre_compound_total ); - - // Add rate if ( ! isset( $taxes[ $key ] ) ) { $taxes[ $key ] = $tax_amount; } else { $taxes[ $key ] += $tax_amount; } + + $pre_compound_total = array_sum( $taxes ); } } @@ -301,17 +261,24 @@ class WC_Tax { } /** - * Does the sort comparison. - * - * @param object $rate1 - * @param object $rate2 + * Does the sort comparison. Compares (in this order): + * - Priority + * - Country + * - State + * - Number of postcodes + * - Number of cities + * - ID * + * @param object $rate1 First rate to compare. + * @param object $rate2 Second rate to compare. * @return int */ private static function sort_rates_callback( $rate1, $rate2 ) { if ( $rate1->tax_rate_priority !== $rate2->tax_rate_priority ) { return $rate1->tax_rate_priority < $rate2->tax_rate_priority ? -1 : 1; // ASC - } elseif ( $rate1->tax_rate_country !== $rate2->tax_rate_country ) { + } + + if ( $rate1->tax_rate_country !== $rate2->tax_rate_country ) { if ( '' === $rate1->tax_rate_country ) { return 1; } @@ -319,7 +286,9 @@ class WC_Tax { return -1; } return strcmp( $rate1->tax_rate_country, $rate2->tax_rate_country ) > 0 ? 1 : -1; - } elseif ( $rate1->tax_rate_state !== $rate2->tax_rate_state ) { + } + + if ( $rate1->tax_rate_state !== $rate2->tax_rate_state ) { if ( '' === $rate1->tax_rate_state ) { return 1; } @@ -327,17 +296,23 @@ class WC_Tax { return -1; } return strcmp( $rate1->tax_rate_state, $rate2->tax_rate_state ) > 0 ? 1 : -1; - } else { - return $rate1->tax_rate_id < $rate2->tax_rate_id ? -1 : 1; // Identical - use ID } + + if ( isset( $rate1->postcode_count, $rate2->postcode_count ) && $rate1->postcode_count !== $rate2->postcode_count ) { + return $rate1->postcode_count < $rate2->postcode_count ? 1 : -1; + } + + if ( isset( $rate1->city_count, $rate2->city_count ) && $rate1->city_count !== $rate2->city_count ) { + return $rate1->city_count < $rate2->city_count ? 1 : -1; + } + + return $rate1->tax_rate_id < $rate2->tax_rate_id ? -1 : 1; } /** - * Logical sort order for tax rates based on the following in order of priority: - * - Priority - * - County code - * - State code - * @param array $rates + * Logical sort order for tax rates based on the following in order of priority. + * + * @param array $rates Rates to be sorted. * @return array */ private static function sort_rates( $rates ) { @@ -352,21 +327,21 @@ class WC_Tax { /** * Loop through a set of tax rates and get the matching rates (1 per priority). * - * @param string $country - * @param string $state - * @param string $postcode - * @param string $city - * @param string $tax_class + * @param string $country Country code to match against. + * @param string $state State code to match against. + * @param string $postcode Postcode to match against. + * @param string $city City to match against. + * @param string $tax_class Tax class to match against. * @return array */ private static function get_matched_tax_rates( $country, $state, $postcode, $city, $tax_class ) { global $wpdb; - // Query criteria - these will be ANDed + // Query criteria - these will be ANDed. $criteria = array(); $criteria[] = $wpdb->prepare( "tax_rate_country IN ( %s, '' )", strtoupper( $country ) ); $criteria[] = $wpdb->prepare( "tax_rate_state IN ( %s, '' )", strtoupper( $state ) ); - $criteria[] = $wpdb->prepare( "tax_rate_class = %s", sanitize_title( $tax_class ) ); + $criteria[] = $wpdb->prepare( 'tax_rate_class = %s', sanitize_title( $tax_class ) ); // Pre-query postcode ranges for PHP based matching. $postcode_search = wc_get_wildcard_postcodes( $postcode, $country ); @@ -392,7 +367,7 @@ class WC_Tax { * - rates with matching city, no postcode */ $locations_criteria = array(); - $locations_criteria[] = "locations.location_type IS NULL"; + $locations_criteria[] = 'locations.location_type IS NULL'; $locations_criteria[] = " locations.location_type = 'postcode' AND locations.location_code IN ('" . implode( "','", array_map( 'esc_sql', $postcode_search ) ) . "') AND ( @@ -415,7 +390,7 @@ class WC_Tax { $criteria[] = '( ( ' . implode( ' ) OR ( ', $locations_criteria ) . ' ) )'; $found_rates = $wpdb->get_results( " - SELECT tax_rates.* + SELECT tax_rates.*, COUNT( locations.location_id ) as postcode_count, COUNT( locations2.location_id ) as city_count FROM {$wpdb->prefix}woocommerce_tax_rates as tax_rates LEFT OUTER JOIN {$wpdb->prefix}woocommerce_tax_rate_locations as locations ON tax_rates.tax_rate_id = locations.tax_rate_id LEFT OUTER JOIN {$wpdb->prefix}woocommerce_tax_rate_locations as locations2 ON tax_rates.tax_rate_id = locations2.tax_rate_id @@ -429,12 +404,12 @@ class WC_Tax { $found_priority = array(); foreach ( $found_rates as $found_rate ) { - if ( in_array( $found_rate->tax_rate_priority, $found_priority ) ) { + if ( in_array( $found_rate->tax_rate_priority, $found_priority, true ) ) { continue; } $matched_tax_rates[ $found_rate->tax_rate_id ] = array( - 'rate' => $found_rate->tax_rate, + 'rate' => (float) $found_rate->tax_rate, 'label' => $found_rate->tax_rate_name, 'shipping' => $found_rate->tax_rate_shipping ? 'yes' : 'no', 'compound' => $found_rate->tax_rate_compound ? 'yes' : 'no', @@ -452,13 +427,18 @@ class WC_Tax { * Used by get_rates(), get_shipping_rates(). * * @param $tax_class string Optional, passed to the filter for advanced tax setups. + * @param object $customer Override the customer object to get their location. * @return array */ - public static function get_tax_location( $tax_class = '' ) { + public static function get_tax_location( $tax_class = '', $customer = null ) { $location = array(); - if ( ! empty( WC()->customer ) ) { - $location = WC()->customer->get_taxable_address(); + if ( is_null( $customer ) && ! empty( WC()->customer ) ) { + $customer = WC()->customer; + } + + if ( ! empty( $customer ) ) { + $location = $customer->get_taxable_address(); } elseif ( wc_prices_include_tax() || 'base' === get_option( 'woocommerce_default_customer_address' ) || 'base' === get_option( 'woocommerce_tax_based_on' ) ) { $location = array( WC()->countries->get_base_country(), @@ -468,17 +448,19 @@ class WC_Tax { ); } - return apply_filters( 'woocommerce_get_tax_location', $location, $tax_class ); + return apply_filters( 'woocommerce_get_tax_location', $location, $tax_class, $customer ); } /** * Get's an array of matching rates for a tax class. - * @param string $tax_class + * + * @param string $tax_class Tax class to get rates for. + * @param object $customer Override the customer object to get their location. * @return array */ - public static function get_rates( $tax_class = '' ) { + public static function get_rates( $tax_class = '', $customer = null ) { $tax_class = sanitize_title( $tax_class ); - $location = self::get_tax_location( $tax_class ); + $location = self::get_tax_location( $tax_class, $customer ); $matched_tax_rates = array(); if ( sizeof( $location ) === 4 ) { @@ -526,10 +508,11 @@ class WC_Tax { /** * Gets an array of matching shipping tax rates for a given class. * - * @param string Tax Class - * @return mixed + * @param string $tax_class Tax class to get rates for. + * @param object $customer Override the customer object to get their location. + * @return mixed */ - public static function get_shipping_tax_rates( $tax_class = null ) { + public static function get_shipping_tax_rates( $tax_class = null, $customer = null ) { // See if we have an explicitly set shipping tax class $shipping_tax_class = get_option( 'woocommerce_shipping_tax_class' ); @@ -537,7 +520,7 @@ class WC_Tax { $tax_class = $shipping_tax_class; } - $location = self::get_tax_location( $tax_class ); + $location = self::get_tax_location( $tax_class, $customer ); $matched_tax_rates = array(); if ( sizeof( $location ) === 4 ) { @@ -553,12 +536,17 @@ class WC_Tax { 'tax_class' => $tax_class, ) ); - } else { + } elseif ( WC()->cart->get_cart() ) { // This will be per order shipping - loop through the order and find the highest tax class rate - $cart_tax_classes = WC()->cart->get_cart_item_tax_classes(); + $cart_tax_classes = WC()->cart->get_cart_item_tax_classes_for_shipping(); - // If multiple classes are found, use the first one found unless a standard rate item is found. This will be the first listed in the 'additonal tax class' section. + // No tax classes = no taxable items. + if ( empty( $cart_tax_classes ) ) { + return array(); + } + + // If multiple classes are found, use the first one found unless a standard rate item is found. This will be the first listed in the 'additional tax class' section. if ( sizeof( $cart_tax_classes ) > 1 && ! in_array( '', $cart_tax_classes ) ) { $tax_classes = self::get_tax_class_slugs(); @@ -615,7 +603,7 @@ class WC_Tax { $compound = $key_or_rate->tax_rate_compound; } else { $key = $key_or_rate; - $compound = $wpdb->get_var( $wpdb->prepare( "SELECT tax_rate_compound FROM {$wpdb->prefix}woocommerce_tax_rates WHERE tax_rate_id = %s", $key ) ) ? true : false; + $compound = (bool) $wpdb->get_var( $wpdb->prepare( "SELECT tax_rate_compound FROM {$wpdb->prefix}woocommerce_tax_rates WHERE tax_rate_id = %s", $key ) ); } return (bool) apply_filters( 'woocommerce_rate_compound', $compound, $key ); @@ -709,10 +697,21 @@ class WC_Tax { /** * Get store tax classes. + * * @return array Array of class names ("Reduced rate", "Zero rate", etc). */ public static function get_tax_classes() { - return array_filter( array_map( 'trim', explode( "\n", get_option( 'woocommerce_tax_classes' ) ) ) ); + return array_filter( array_map( 'trim', explode( "\n", get_option( 'woocommerce_tax_classes' ) ) ), array( __CLASS__, 'is_valid_tax_class' ) ); + } + + /** + * Filter out invalid tax classes. + * + * @param string $tax_class Tax class name. + * @return boolean + */ + private static function is_valid_tax_class( $tax_class ) { + return ! empty( $tax_class ) && sanitize_title( $tax_class ); } /** @@ -722,7 +721,7 @@ class WC_Tax { * @return array Array of class slugs ("reduced-rate", "zero-rate", etc). */ public static function get_tax_class_slugs() { - return array_map( 'sanitize_title', self::get_tax_classes() ); + return array_filter( array_map( 'sanitize_title', self::get_tax_classes() ) ); } /** @@ -803,7 +802,11 @@ class WC_Tax { private static function prepare_tax_rate( $tax_rate ) { foreach ( $tax_rate as $key => $value ) { if ( method_exists( __CLASS__, 'format_' . $key ) ) { - $tax_rate[ $key ] = call_user_func( array( __CLASS__, 'format_' . $key ), $value ); + if ( 'tax_rate_state' === $key ) { + $tax_rate[ $key ] = call_user_func( array( __CLASS__, 'format_' . $key ), sanitize_key( $value ) ); + } else { + $tax_rate[ $key ] = call_user_func( array( __CLASS__, 'format_' . $key ), $value ); + } } } return $tax_rate; @@ -916,7 +919,6 @@ class WC_Tax { * * @param int $tax_rate_id * @param string $postcodes String of postcodes separated by ; characters - * @return string */ public static function _update_tax_rate_postcodes( $tax_rate_id, $postcodes ) { if ( ! is_array( $postcodes ) ) { @@ -939,7 +941,6 @@ class WC_Tax { * * @param int $tax_rate_id * @param string $cities - * @return string */ public static function _update_tax_rate_cities( $tax_rate_id, $cities ) { if ( ! is_array( $cities ) ) { @@ -961,8 +962,6 @@ class WC_Tax { * @param int $tax_rate_id * @param array $values * @param string $type - * - * @return string */ private static function _update_tax_rate_locations( $tax_rate_id, $values, $type ) { global $wpdb; @@ -998,7 +997,7 @@ class WC_Tax { global $wpdb; // Get all the rates and locations. Snagging all at once should significantly cut down on the number of queries. - $rates = self::sort_rates( $wpdb->get_results( $wpdb->prepare( "SELECT * FROM `{$wpdb->prefix}woocommerce_tax_rates` WHERE `tax_rate_class` = %s;", sanitize_title( $tax_class ) ) ) ); + $rates = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM `{$wpdb->prefix}woocommerce_tax_rates` WHERE `tax_rate_class` = %s;", sanitize_title( $tax_class ) ) ); $locations = $wpdb->get_results( "SELECT * FROM `{$wpdb->prefix}woocommerce_tax_rate_locations`" ); if ( ! empty( $rates ) ) { @@ -1019,6 +1018,13 @@ class WC_Tax { $rates[ $location->tax_rate_id ]->{$location->location_type}[] = $location->location_code; } + foreach ( $rates as $rate_id => $rate ) { + $rates[ $rate_id ]->postcode_count = isset( $rates[ $rate_id ]->postcode ) ? count( $rates[ $rate_id ]->postcode ) : 0; + $rates[ $rate_id ]->city_count = isset( $rates[ $rate_id ]->city ) ? count( $rates[ $rate_id ]->city ) : 0; + } + + $rates = self::sort_rates( $rates ); + return $rates; } } diff --git a/includes/class-wc-template-loader.php b/includes/class-wc-template-loader.php index 334dd40a093..8df29358555 100644 --- a/includes/class-wc-template-loader.php +++ b/includes/class-wc-template-loader.php @@ -1,26 +1,53 @@ taxonomy . '.php'; + $default_file = 'taxonomy-' . $object->taxonomy . '.php'; } else { $default_file = 'archive-product.php'; } } elseif ( is_post_type_archive( 'product' ) || is_page( wc_get_page_id( 'shop' ) ) ) { - $default_file = 'archive-product.php'; + $default_file = self::$theme_support ? 'archive-product.php' : ''; } else { $default_file = ''; } @@ -94,27 +123,40 @@ class WC_Template_Loader { * @return string[] */ private static function get_template_loader_files( $default_file ) { - $search_files = apply_filters( 'woocommerce_template_loader_files', array(), $default_file ); - $search_files[] = 'woocommerce.php'; + $templates = apply_filters( 'woocommerce_template_loader_files', array(), $default_file ); + $templates[] = 'woocommerce.php'; - if ( is_product_taxonomy() ) { - $term = get_queried_object(); - $search_files[] = 'taxonomy-' . $term->taxonomy . '-' . $term->slug . '.php'; - $search_files[] = WC()->template_path() . 'taxonomy-' . $term->taxonomy . '-' . $term->slug . '.php'; - $search_files[] = 'taxonomy-' . $term->taxonomy . '.php'; - $search_files[] = WC()->template_path() . 'taxonomy-' . $term->taxonomy . '.php'; + if ( is_page_template() ) { + $templates[] = get_page_template_slug(); } - $search_files[] = $default_file; - $search_files[] = WC()->template_path() . $default_file; + if ( is_singular( 'product' ) ) { + $object = get_queried_object(); + $name_decoded = urldecode( $object->post_name ); + if ( $name_decoded !== $object->post_name ) { + $templates[] = "single-product-{$name_decoded}.php"; + } + $templates[] = "single-product-{$object->post_name}.php"; + } - return array_unique( $search_files ); + if ( is_product_taxonomy() ) { + $object = get_queried_object(); + $templates[] = 'taxonomy-' . $object->taxonomy . '-' . $object->slug . '.php'; + $templates[] = WC()->template_path() . 'taxonomy-' . $object->taxonomy . '-' . $object->slug . '.php'; + $templates[] = 'taxonomy-' . $object->taxonomy . '.php'; + $templates[] = WC()->template_path() . 'taxonomy-' . $object->taxonomy . '.php'; + } + + $templates[] = $default_file; + $templates[] = WC()->template_path() . $default_file; + + return array_unique( $templates ); } /** * Load comments template. * - * @param mixed $template + * @param string $template template to load. * @return string */ public static function comments_template_loader( $template ) { @@ -140,6 +182,376 @@ class WC_Template_Loader { } } } + + /** + * Unsupported theme compatibility methods. + */ + + /** + * Hook in methods to enhance the unsupported theme experience on pages. + * + * @since 3.3.0 + */ + public static function unsupported_theme_init() { + if ( 0 < self::$shop_page_id ) { + if ( is_product_taxonomy() ) { + self::unsupported_theme_tax_archive_init(); + } elseif ( is_product() ) { + self::unsupported_theme_product_page_init(); + } else { + self::unsupported_theme_shop_page_init(); + } + } + } + + /** + * Hook in methods to enhance the unsupported theme experience on the Shop page. + * + * @since 3.3.0 + */ + private static function unsupported_theme_shop_page_init() { + add_filter( 'the_content', array( __CLASS__, 'unsupported_theme_shop_content_filter' ), 10 ); + add_filter( 'the_title', array( __CLASS__, 'unsupported_theme_title_filter' ), 10, 2 ); + add_filter( 'comments_number', array( __CLASS__, 'unsupported_theme_comments_number_filter' ) ); + } + + /** + * Hook in methods to enhance the unsupported theme experience on Product pages. + * + * @since 3.3.0 + */ + private static function unsupported_theme_product_page_init() { + add_filter( 'the_content', array( __CLASS__, 'unsupported_theme_product_content_filter' ), 10 ); + add_filter( 'post_thumbnail_html', array( __CLASS__, 'unsupported_theme_single_featured_image_filter' ) ); + add_filter( 'woocommerce_product_tabs', array( __CLASS__, 'unsupported_theme_remove_review_tab' ) ); + remove_action( 'woocommerce_before_main_content', 'woocommerce_output_content_wrapper', 10 ); + remove_action( 'woocommerce_after_main_content', 'woocommerce_output_content_wrapper_end', 10 ); + add_theme_support( 'wc-product-gallery-zoom' ); + add_theme_support( 'wc-product-gallery-lightbox' ); + add_theme_support( 'wc-product-gallery-slider' ); + } + + /** + * Enhance the unsupported theme experience on Product Category and Attribute pages by rendering + * those pages using the single template and shortcode-based content. To do this we make a dummy + * post and set a shortcode as the post content. This approach is adapted from bbPress. + * + * @since 3.3.0 + */ + private static function unsupported_theme_tax_archive_init() { + global $wp_query, $post; + + $queried_object = get_queried_object(); + $args = self::get_current_shop_view_args(); + $shortcode_args = array( + 'page' => $args->page, + 'columns' => $args->columns, + 'rows' => $args->rows, + 'orderby' => '', + 'order' => '', + 'paginate' => true, + 'cache' => false, + ); + + if ( is_product_category() ) { + $shortcode_args['category'] = sanitize_title( $queried_object->slug ); + } elseif ( taxonomy_is_product_attribute( $queried_object->taxonomy ) ) { + $shortcode_args['attribute'] = sanitize_title( $queried_object->taxonomy ); + $shortcode_args['terms'] = sanitize_title( $queried_object->slug ); + } elseif ( is_product_tag() ) { + $shortcode_args['tag'] = sanitize_title( $queried_object->slug ); + } else { + // Default theme archive for all other taxonomies. + return; + } + + // Description handling. + if ( ! empty( $queried_object->description ) && ( empty( $_GET['product-page'] ) || 1 === absint( $_GET['product-page'] ) ) ) { // WPCS: input var ok, CSRF ok. + $prefix = '
          ' . wc_format_content( $queried_object->description ) . '
          '; // WPCS: XSS ok. + } else { + $prefix = ''; + } + + add_filter( 'woocommerce_shortcode_products_query', array( __CLASS__, 'unsupported_archive_layered_nav_compatibility' ) ); + $shortcode = new WC_Shortcode_Products( $shortcode_args ); + remove_filter( 'woocommerce_shortcode_products_query', array( __CLASS__, 'unsupported_archive_layered_nav_compatibility' ) ); + $shop_page = get_post( self::$shop_page_id ); + + $dummy_post_properties = array( + 'ID' => 0, + 'post_status' => 'publish', + 'post_author' => $shop_page->post_author, + 'post_parent' => 0, + 'post_type' => 'page', + 'post_date' => $shop_page->post_date, + 'post_date_gmt' => $shop_page->post_date_gmt, + 'post_modified' => $shop_page->post_modified, + 'post_modified_gmt' => $shop_page->post_modified_gmt, + 'post_content' => $prefix . $shortcode->get_content(), + 'post_title' => wc_clean( $queried_object->name ), + 'post_excerpt' => '', + 'post_content_filtered' => '', + 'post_mime_type' => '', + 'post_password' => '', + 'post_name' => $queried_object->slug, + 'guid' => '', + 'menu_order' => 0, + 'pinged' => '', + 'to_ping' => '', + 'ping_status' => '', + 'comment_status' => 'closed', + 'comment_count' => 0, + 'filter' => 'raw', + ); + + // Set the $post global. + $post = new WP_Post( (object) $dummy_post_properties ); // @codingStandardsIgnoreLine. + + // Copy the new post global into the main $wp_query. + $wp_query->post = $post; + $wp_query->posts = array( $post ); + + // Prevent comments form from appearing. + $wp_query->post_count = 1; + $wp_query->is_404 = false; + $wp_query->is_page = true; + $wp_query->is_single = true; + $wp_query->is_archive = false; + $wp_query->is_tax = true; + $wp_query->max_num_pages = 0; + + // Prepare everything for rendering. + setup_postdata( $post ); + remove_all_filters( 'the_content' ); + remove_all_filters( 'the_excerpt' ); + add_filter( 'template_include', array( __CLASS__, 'force_single_template_filter' ) ); + } + + /** + * Add layered nav args to WP_Query args generated by the 'products' shortcode. + * + * @since 3.3.4 + * @param array $query WP_Query args. + * @return array + */ + public static function unsupported_archive_layered_nav_compatibility( $query ) { + foreach ( WC()->query->get_layered_nav_chosen_attributes() as $taxonomy => $data ) { + $query['tax_query'][] = array( + 'taxonomy' => $taxonomy, + 'field' => 'slug', + 'terms' => $data['terms'], + 'operator' => 'and' === $data['query_type'] ? 'AND' : 'IN', + 'include_children' => false, + ); + } + return $query; + } + + /** + * Force the loading of one of the single templates instead of whatever template was about to be loaded. + * + * @since 3.3.0 + * @param string $template Path to template. + * @return string + */ + public static function force_single_template_filter( $template ) { + $possible_templates = array( + 'page', + 'single', + 'singular', + 'index', + ); + + foreach ( $possible_templates as $possible_template ) { + $path = get_query_template( $possible_template ); + if ( $path ) { + return $path; + } + } + + return $template; + } + + /** + * Get information about the current shop page view. + * + * @since 3.3.0 + * @return array + */ + private static function get_current_shop_view_args() { + return (object) array( + 'page' => absint( max( 1, absint( get_query_var( 'paged' ) ) ) ), + 'columns' => wc_get_default_products_per_row(), + 'rows' => wc_get_default_product_rows_per_page(), + ); + } + + /** + * Filter the title and insert WooCommerce content on the shop page. + * + * For non-WC themes, this will setup the main shop page to be shortcode based to improve default appearance. + * + * @since 3.3.0 + * @param string $title Existing title. + * @param int $id ID of the post being filtered. + * @return string + */ + public static function unsupported_theme_title_filter( $title, $id ) { + if ( self::$theme_support || ! $id !== self::$shop_page_id ) { + return $title; + } + + if ( is_page( self::$shop_page_id ) || ( is_home() && 'page' === get_option( 'show_on_front' ) && absint( get_option( 'page_on_front' ) ) === self::$shop_page_id ) ) { + $args = self::get_current_shop_view_args(); + $title_suffix = array(); + + if ( $args->page > 1 ) { + /* translators: %d: Page number. */ + $title_suffix[] = sprintf( esc_html__( 'Page %d', 'woocommerce' ), $args->page ); + } + + if ( $title_suffix ) { + $title = $title . ' – ' . implode( ', ', $title_suffix ); + } + } + return $title; + } + + /** + * Filter the content and insert WooCommerce content on the shop page. + * + * For non-WC themes, this will setup the main shop page to be shortcode based to improve default appearance. + * + * @since 3.3.0 + * @param string $content Existing post content. + * @return string + */ + public static function unsupported_theme_shop_content_filter( $content ) { + global $wp_query; + + if ( self::$theme_support || ! is_main_query() || ! in_the_loop() ) { + return $content; + } + + self::$in_content_filter = true; + + // Remove the filter we're in to avoid nested calls. + remove_filter( 'the_content', array( __CLASS__, 'unsupported_theme_shop_content_filter' ) ); + + // Unsupported theme shop page. + if ( is_page( self::$shop_page_id ) ) { + $args = self::get_current_shop_view_args(); + $shortcode = new WC_Shortcode_Products( + array_merge( + wc()->query->get_catalog_ordering_args(), + array( + 'page' => $args->page, + 'columns' => $args->columns, + 'rows' => $args->rows, + 'orderby' => '', + 'order' => '', + 'paginate' => true, + 'cache' => false, + ) + ), + 'products' ); + + // Allow queries to run e.g. layered nav. + add_action( 'pre_get_posts', array( wc()->query, 'product_query' ) ); + + $content = $content . $shortcode->get_content(); + + // Remove actions and self to avoid nested calls. + remove_action( 'pre_get_posts', array( wc()->query, 'product_query' ) ); + WC()->query->remove_ordering_args(); + } + + self::$in_content_filter = false; + + return $content; + } + + /** + * Filter the content and insert WooCommerce content on the shop page. + * + * For non-WC themes, this will setup the main shop page to be shortcode based to improve default appearance. + * + * @since 3.3.0 + * @param string $content Existing post content. + * @return string + */ + public static function unsupported_theme_product_content_filter( $content ) { + global $wp_query; + + if ( self::$theme_support || ! is_main_query() || ! in_the_loop() ) { + return $content; + } + + self::$in_content_filter = true; + + // Remove the filter we're in to avoid nested calls. + remove_filter( 'the_content', array( __CLASS__, 'unsupported_theme_product_content_filter' ) ); + + if ( is_product() ) { + $content = do_shortcode( '[product_page id="' . get_the_ID() . '" show_title=0 status="any"]' ); + } + + self::$in_content_filter = false; + + return $content; + } + + /** + * Suppress the comments number on the Shop page for unsupported themes since there is no commenting on the Shop page. + * + * @since 3.4.5 + * @param string $comments_number The comments number text. + * @return string + */ + public static function unsupported_theme_comments_number_filter( $comments_number ) { + if ( is_page( self::$shop_page_id ) ) { + return ''; + } + + return $comments_number; + } + + /** + * Are we filtering content for unsupported themes? + * + * @since 3.3.2 + * @return bool + */ + public static function in_content_filter() { + return (bool) self::$in_content_filter; + } + + /** + * Prevent the main featured image on product pages because there will be another featured image + * in the gallery. + * + * @since 3.3.0 + * @param string $html Img element HTML. + * @return string + */ + public static function unsupported_theme_single_featured_image_filter( $html ) { + if ( self::in_content_filter() || ! is_product() || ! is_main_query() ) { + return $html; + } + + return ''; + } + + /** + * Remove the Review tab and just use the regular comment form. + * + * @param array $tabs Tab info. + * @return array + */ + public static function unsupported_theme_remove_review_tab( $tabs ) { + unset( $tabs['reviews'] ); + return $tabs; + } } -WC_Template_Loader::init(); +add_action( 'init', array( 'WC_Template_Loader', 'init' ) ); diff --git a/includes/class-wc-tracker.php b/includes/class-wc-tracker.php index 9c784c42fa3..ac7b2f26ea6 100644 --- a/includes/class-wc-tracker.php +++ b/includes/class-wc-tracker.php @@ -5,21 +5,21 @@ * The WooCommerce tracker class adds functionality to track WooCommerce usage based on if the customer opted in. * No personal information is tracked, only general WooCommerce settings, general product, order and user counts and admin email for discount code. * - * @class WC_Tracker - * @version 2.3.0 - * @package WooCommerce/Classes - * @category Class - * @author WooThemes + * @class WC_Tracker + * @since 2.3.0 + * @package WooCommerce/Classes */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; +/** + * WooCommerce Tracker Class + */ class WC_Tracker { /** * URL to the WooThemes Tracker API endpoint. + * * @var string */ private static $api_url = 'https://tracking.woocommerce.com/v1/'; @@ -34,10 +34,10 @@ class WC_Tracker { /** * Decide whether to send tracking data or not. * - * @param boolean $override + * @param boolean $override Should override?. */ public static function send_tracking_data( $override = false ) { - // Don't trigger this on AJAX Requests + // Don't trigger this on AJAX Requests. if ( defined( 'DOING_AJAX' ) && DOING_AJAX ) { return; } @@ -56,25 +56,25 @@ class WC_Tracker { } } - // Update time first before sending to ensure it is set + // Update time first before sending to ensure it is set. update_option( 'woocommerce_tracker_last_send', time() ); - $params = self::get_tracking_data(); + $params = self::get_tracking_data(); wp_safe_remote_post( self::$api_url, array( - 'method' => 'POST', - 'timeout' => 45, - 'redirection' => 5, - 'httpversion' => '1.0', - 'blocking' => false, - 'headers' => array( 'user-agent' => 'WooCommerceTracker/' . md5( esc_url( home_url( '/' ) ) ) . ';' ), - 'body' => json_encode( $params ), - 'cookies' => array(), - ) - ); + 'method' => 'POST', + 'timeout' => 45, + 'redirection' => 5, + 'httpversion' => '1.0', + 'blocking' => false, + 'headers' => array( 'user-agent' => 'WooCommerceTracker/' . md5( esc_url_raw( home_url( '/' ) ) ) . ';' ), + 'body' => wp_json_encode( $params ), + 'cookies' => array(), + ) ); } /** * Get the last time tracking data was sent. + * * @return int|bool */ private static function get_last_send_time() { @@ -83,52 +83,56 @@ class WC_Tracker { /** * Get all the tracking data. + * * @return array */ private static function get_tracking_data() { $data = array(); - // General site info + // General site info. $data['url'] = home_url(); $data['email'] = apply_filters( 'woocommerce_tracker_admin_email', get_option( 'admin_email' ) ); $data['theme'] = self::get_theme_info(); - // WordPress Info + // WordPress Info. $data['wp'] = self::get_wordpress_info(); - // Server Info + // Server Info. $data['server'] = self::get_server_info(); - // Plugin info + // Plugin info. $all_plugins = self::get_all_plugins(); $data['active_plugins'] = $all_plugins['active_plugins']; $data['inactive_plugins'] = $all_plugins['inactive_plugins']; - // Jetpack & WooCommerce Connect + // Jetpack & WooCommerce Connect. $data['jetpack_version'] = defined( 'JETPACK__VERSION' ) ? JETPACK__VERSION : 'none'; $data['jetpack_connected'] = ( class_exists( 'Jetpack' ) && is_callable( 'Jetpack::is_active' ) && Jetpack::is_active() ) ? 'yes' : 'no'; $data['jetpack_is_staging'] = ( class_exists( 'Jetpack' ) && is_callable( 'Jetpack::is_staging_site' ) && Jetpack::is_staging_site() ) ? 'yes' : 'no'; $data['connect_installed'] = class_exists( 'WC_Connect_Loader' ) ? 'yes' : 'no'; $data['connect_active'] = ( class_exists( 'WC_Connect_Loader' ) && wp_next_scheduled( 'wc_connect_fetch_service_schemas' ) ) ? 'yes' : 'no'; + $data['helper_connected'] = self::get_helper_connected(); - // Store count info + // Store count info. $data['users'] = self::get_user_counts(); $data['products'] = self::get_product_counts(); - $data['orders'] = self::get_order_counts(); + $data['orders'] = self::get_orders(); + $data['reviews'] = self::get_review_counts(); + $data['categories'] = self::get_category_counts(); - // Payment gateway info + // Payment gateway info. $data['gateways'] = self::get_active_payment_gateways(); - // Shipping method info + // Shipping method info. $data['shipping_methods'] = self::get_active_shipping_methods(); - // Get all WooCommerce options info + // Get all WooCommerce options info. $data['settings'] = self::get_all_woocommerce_options_values(); - // Template overrides + // Template overrides. $data['template_overrides'] = self::get_all_template_overrides(); - // Template overrides + // Template overrides. $data['admin_user_agents'] = self::get_admin_user_agents(); return apply_filters( 'woocommerce_tracker_data', $data ); @@ -136,18 +140,25 @@ class WC_Tracker { /** * Get the current theme info, theme name and version. + * * @return array */ public static function get_theme_info() { $theme_data = wp_get_theme(); - $theme_child_theme = is_child_theme() ? 'Yes' : 'No'; - $theme_wc_support = ( ! current_theme_supports( 'woocommerce' ) && ! in_array( $theme_data->template, wc_get_core_supported_themes() ) ) ? 'No' : 'Yes'; + $theme_child_theme = wc_bool_to_string( is_child_theme() ); + $theme_wc_support = wc_bool_to_string( current_theme_supports( 'woocommerce' ) ); - return array( 'name' => $theme_data->Name, 'version' => $theme_data->Version, 'child_theme' => $theme_child_theme, 'wc_support' => $theme_wc_support ); + return array( + 'name' => $theme_data->Name, // @phpcs:ignore + 'version' => $theme_data->Version, // @phpcs:ignore + 'child_theme' => $theme_child_theme, + 'wc_support' => $theme_wc_support, + ); } /** * Get WordPress related data. + * * @return array */ private static function get_wordpress_info() { @@ -171,13 +182,14 @@ class WC_Tracker { /** * Get server related info. + * * @return array */ private static function get_server_info() { $server_data = array(); - if ( isset( $_SERVER['SERVER_SOFTWARE'] ) && ! empty( $_SERVER['SERVER_SOFTWARE'] ) ) { - $server_data['software'] = $_SERVER['SERVER_SOFTWARE']; + if ( ! empty( $_SERVER['SERVER_SOFTWARE'] ) ) { + $server_data['software'] = $_SERVER['SERVER_SOFTWARE']; // @phpcs:ignore } if ( function_exists( 'phpversion' ) ) { @@ -191,8 +203,8 @@ class WC_Tracker { $server_data['php_suhosin'] = extension_loaded( 'suhosin' ) ? 'Yes' : 'No'; } - global $wpdb; - $server_data['mysql_version'] = $wpdb->db_version(); + $database_version = wc_get_server_database_version(); + $server_data['mysql_version'] = $database_version['number']; $server_data['php_max_upload_size'] = size_format( wp_max_upload_size() ); $server_data['php_default_timezone'] = date_default_timezone_get(); @@ -205,17 +217,18 @@ class WC_Tracker { /** * Get all plugins grouped into activated or not. + * * @return array */ private static function get_all_plugins() { - // Ensure get_plugins function is loaded + // Ensure get_plugins function is loaded. if ( ! function_exists( 'get_plugins' ) ) { include ABSPATH . '/wp-admin/includes/plugin.php'; } - $plugins = get_plugins(); + $plugins = get_plugins(); $active_plugins_keys = get_option( 'active_plugins', array() ); - $active_plugins = array(); + $active_plugins = array(); foreach ( $plugins as $k => $v ) { // Take care of formatting the data how we want it. @@ -234,7 +247,7 @@ class WC_Tracker { $formatted['plugin_uri'] = strip_tags( $v['PluginURI'] ); } if ( in_array( $k, $active_plugins_keys ) ) { - // Remove active plugins from list so we can show active and inactive separately + // Remove active plugins from list so we can show active and inactive separately. unset( $plugins[ $k ] ); $active_plugins[ $k ] = $formatted; } else { @@ -242,11 +255,30 @@ class WC_Tracker { } } - return array( 'active_plugins' => $active_plugins, 'inactive_plugins' => $plugins ); + return array( + 'active_plugins' => $active_plugins, + 'inactive_plugins' => $plugins, + ); } + /** + * Check to see if the helper is connected to woocommerce.com + * + * @return string + */ + private static function get_helper_connected() { + if ( class_exists( 'WC_Helper_Options' ) && is_callable( 'WC_Helper_Options::get' ) ) { + $authenticated = WC_Helper_Options::get( 'auth' ); + } else { + $authenticated = ''; + } + return ( ! empty( $authenticated ) ) ? 'yes' : 'no'; + } + + /** * Get user totals based on user role. + * * @return array */ private static function get_user_counts() { @@ -254,7 +286,7 @@ class WC_Tracker { $user_count_data = count_users(); $user_count['total'] = $user_count_data['total_users']; - // Get user count based on user role + // Get user count based on user role. foreach ( $user_count_data['avail_roles'] as $role => $count ) { $user_count[ $role ] = $count; } @@ -264,6 +296,7 @@ class WC_Tracker { /** * Get product totals based on product type. + * * @return array */ private static function get_product_counts() { @@ -280,22 +313,70 @@ class WC_Tracker { } /** - * Get order counts based on order status. + * Get order counts + * * @return array */ private static function get_order_counts() { $order_count = array(); $order_count_data = wp_count_posts( 'shop_order' ); - foreach ( wc_get_order_statuses() as $status_slug => $status_name ) { $order_count[ $status_slug ] = $order_count_data->{ $status_slug }; } - return $order_count; } + /** + * Combine all order data. + * + * @return array + */ + private static function get_orders() { + $order_dates = self::get_order_dates(); + $order_counts = self::get_order_counts(); + $order_totals = self::get_order_totals(); + + return array_merge( $order_dates, $order_counts, $order_totals ); + } + + /** + * Get review counts for different statuses. + * + * @return array + */ + private static function get_review_counts() { + global $wpdb; + $review_count = array(); + $counts = $wpdb->get_results( " + SELECT comment_approved, COUNT(*) AS num_reviews + FROM {$wpdb->comments} + WHERE comment_type = 'review' + GROUP BY comment_approved + ", ARRAY_A ); + if ( $counts ) { + foreach ( $counts as $count ) { + if ( 1 === $count['comment_approved'] ) { + $review_count['approved'] = $count['num_reviews']; + } else { + $review_count['pending'] = $count['num_reviews']; + } + } + } + return $review_count; + } + + /** + * Get the number of product categories. + * + * @return int + */ + private static function get_category_counts() { + return wp_count_terms( 'product_cat' ); + } + /** * Get a list of all active payment gateways. + * * @return array */ private static function get_active_payment_gateways() { @@ -303,7 +384,10 @@ class WC_Tracker { $gateways = WC()->payment_gateways->payment_gateways(); foreach ( $gateways as $id => $gateway ) { if ( isset( $gateway->enabled ) && 'yes' === $gateway->enabled ) { - $active_gateways[ $id ] = array( 'title' => $gateway->title, 'supports' => $gateway->supports ); + $active_gateways[ $id ] = array( + 'title' => $gateway->title, + 'supports' => $gateway->supports, + ); } } @@ -312,6 +396,7 @@ class WC_Tracker { /** * Get a list of all active shipping methods. + * * @return array */ private static function get_active_shipping_methods() { @@ -319,7 +404,10 @@ class WC_Tracker { $shipping_methods = WC()->shipping->get_shipping_methods(); foreach ( $shipping_methods as $id => $shipping_method ) { if ( isset( $shipping_method->enabled ) && 'yes' === $shipping_method->enabled ) { - $active_methods[ $id ] = array( 'title' => $shipping_method->title, 'tax_status' => $shipping_method->tax_status ); + $active_methods[ $id ] = array( + 'title' => $shipping_method->title, + 'tax_status' => $shipping_method->tax_status, + ); } } @@ -328,6 +416,7 @@ class WC_Tracker { /** * Get all options starting with woocommerce_ prefix. + * * @return array */ private static function get_all_woocommerce_options_values() { @@ -354,6 +443,7 @@ class WC_Tracker { /** * Look for any template override and return filenames. + * * @return array */ private static function get_all_template_overrides() { @@ -371,12 +461,12 @@ class WC_Tracker { foreach ( $files as $file ) { if ( file_exists( get_stylesheet_directory() . '/' . $file ) ) { $theme_file = get_stylesheet_directory() . '/' . $file; - } elseif ( file_exists( get_stylesheet_directory() . '/woocommerce/' . $file ) ) { - $theme_file = get_stylesheet_directory() . '/woocommerce/' . $file; + } elseif ( file_exists( get_stylesheet_directory() . '/' . WC()->template_path() . $file ) ) { + $theme_file = get_stylesheet_directory() . '/' . WC()->template_path() . $file; } elseif ( file_exists( get_template_directory() . '/' . $file ) ) { $theme_file = get_template_directory() . '/' . $file; - } elseif ( file_exists( get_template_directory() . '/woocommerce/' . $file ) ) { - $theme_file = get_template_directory() . '/woocommerce/' . $file; + } elseif ( file_exists( get_template_directory() . '/' . WC()->template_path() . $file ) ) { + $theme_file = get_template_directory() . '/' . WC()->template_path() . $file; } else { $theme_file = false; } @@ -391,11 +481,87 @@ class WC_Tracker { /** * When an admin user logs in, there user agent is tracked in user meta and collected here. + * * @return array */ private static function get_admin_user_agents() { return array_filter( (array) get_option( 'woocommerce_tracker_ua', array() ) ); } + + /** + * Get order totals + * + * @return array + */ + private static function get_order_totals() { + global $wpdb; + + $gross_total = $wpdb->get_var( " + SELECT + SUM( order_meta.meta_value ) AS 'gross_total' + FROM {$wpdb->prefix}posts AS orders + LEFT JOIN {$wpdb->prefix}postmeta AS order_meta ON order_meta.post_id = orders.ID + WHERE order_meta.meta_key = '_order_total' + AND orders.post_status = 'wc-completed' + GROUP BY order_meta.meta_key + " ); + + if ( is_null( $gross_total ) ) { + $gross_total = 0; + } + + return array( + 'gross' => $gross_total, + ); + } + + /** + * Get last order date + * + * @return string + */ + private static function get_order_dates() { + global $wpdb; + + $min_max = $wpdb->get_row( " + SELECT + MIN( post_date_gmt ) as 'first', MAX( post_date_gmt ) as 'last' + FROM {$wpdb->prefix}posts + WHERE post_type = 'shop_order' + AND post_status = 'wc-completed' + ", ARRAY_A ); + + if ( is_null( $min_max ) ) { + $min_max = array( + 'first' => '-', + 'last' => '-', + ); + } + + return $min_max; + } + + /** + * Make a request when opting out of tracker usage. + * + * @return void + */ + public static function opt_out_request() { + $body = array( + 'event' => 'opt-out', + 'email' => apply_filters( 'woocommerce_tracker_admin_email', get_option( 'admin_email' ) ), + 'url' => home_url(), + ); + wp_safe_remote_post( self::$api_url . 'event/', array( + 'method' => 'POST', + 'redirection' => 5, + 'httpversion' => '1.0', + 'blocking' => false, + 'headers' => array( 'user-agent' => 'WooCommerceTracker/' . md5( esc_url_raw( home_url( '/' ) ) ) . ';' ), + 'body' => wp_json_encode( $body ), + 'cookies' => array(), + ) ); + } } WC_Tracker::init(); diff --git a/includes/class-wc-validation.php b/includes/class-wc-validation.php index 8e5bd0ccba1..f6675cd49e3 100644 --- a/includes/class-wc-validation.php +++ b/includes/class-wc-validation.php @@ -1,25 +1,23 @@ 0 ) { @@ -52,43 +50,50 @@ class WC_Validation { } switch ( $country ) { - case 'AT' : + case 'AT': $valid = (bool) preg_match( '/^([0-9]{4})$/', $postcode ); break; - case 'BR' : + case 'BR': $valid = (bool) preg_match( '/^([0-9]{5})([-])?([0-9]{3})$/', $postcode ); break; - case 'CH' : + case 'CH': $valid = (bool) preg_match( '/^([0-9]{4})$/i', $postcode ); break; - case 'DE' : + case 'DE': $valid = (bool) preg_match( '/^([0]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{3}$/', $postcode ); break; - case 'ES' : - case 'FR' : + case 'ES': + case 'FR': $valid = (bool) preg_match( '/^([0-9]{5})$/i', $postcode ); break; - case 'GB' : - $valid = self::is_GB_postcode( $postcode ); + case 'GB': + $valid = self::is_gb_postcode( $postcode ); break; - case 'JP' : + case 'IE': + $valid = (bool) preg_match( '/([AC-FHKNPRTV-Y]\d{2}|D6W)[0-9AC-FHKNPRTV-Y]{4}/', wc_normalize_postcode( $postcode ) ); + break; + case 'JP': $valid = (bool) preg_match( '/^([0-9]{3})([-])([0-9]{4})$/', $postcode ); break; - case 'PT' : + case 'PT': $valid = (bool) preg_match( '/^([0-9]{4})([-])([0-9]{3})$/', $postcode ); break; - case 'US' : + case 'US': $valid = (bool) preg_match( '/^([0-9]{5})(-[0-9]{4})?$/i', $postcode ); break; - case 'CA' : - // CA Postal codes cannot contain D,F,I,O,Q,U and cannot start with W or Z. https://en.wikipedia.org/wiki/Postal_codes_in_Canada#Number_of_possible_postal_codes + case 'CA': + // CA Postal codes cannot contain D,F,I,O,Q,U and cannot start with W or Z. https://en.wikipedia.org/wiki/Postal_codes_in_Canada#Number_of_possible_postal_codes. $valid = (bool) preg_match( '/^([ABCEGHJKLMNPRSTVXY]\d[ABCEGHJKLMNPRSTVWXYZ])([\ ])?(\d[ABCEGHJKLMNPRSTVWXYZ]\d)$/i', $postcode ); break; case 'PL': $valid = (bool) preg_match( '/^([0-9]{2})([-])([0-9]{3})$/', $postcode ); break; + case 'CZ': + case 'SK': + $valid = (bool) preg_match( '/^([0-9]{3})(\s?)([0-9]{2})$/', $postcode ); + break; - default : + default: $valid = true; break; } @@ -99,51 +104,50 @@ class WC_Validation { /** * Check if is a GB postcode. * - * @author John Gardner - * @param string $to_check A postcode + * @param string $to_check A postcode. * @return bool */ - public static function is_GB_postcode( $to_check ) { + public static function is_gb_postcode( $to_check ) { // Permitted letters depend upon their position in the postcode. - // https://en.wikipedia.org/wiki/Postcodes_in_the_United_Kingdom#Validation - $alpha1 = "[abcdefghijklmnoprstuwyz]"; // Character 1 - $alpha2 = "[abcdefghklmnopqrstuvwxy]"; // Character 2 - $alpha3 = "[abcdefghjkpstuw]"; // Character 3 == ABCDEFGHJKPSTUW - $alpha4 = "[abehmnprvwxy]"; // Character 4 == ABEHMNPRVWXY - $alpha5 = "[abdefghjlnpqrstuwxyz]"; // Character 5 != CIKMOV + // https://en.wikipedia.org/wiki/Postcodes_in_the_United_Kingdom#Validation. + $alpha1 = '[abcdefghijklmnoprstuwyz]'; // Character 1. + $alpha2 = '[abcdefghklmnopqrstuvwxy]'; // Character 2. + $alpha3 = '[abcdefghjkpstuw]'; // Character 3 == ABCDEFGHJKPSTUW. + $alpha4 = '[abehmnprvwxy]'; // Character 4 == ABEHMNPRVWXY. + $alpha5 = '[abdefghjlnpqrstuwxyz]'; // Character 5 != CIKMOV. $pcexp = array(); - // Expression for postcodes: AN NAA, ANN NAA, AAN NAA, and AANN NAA + // Expression for postcodes: AN NAA, ANN NAA, AAN NAA, and AANN NAA. $pcexp[0] = '/^(' . $alpha1 . '{1}' . $alpha2 . '{0,1}[0-9]{1,2})([0-9]{1}' . $alpha5 . '{2})$/'; - // Expression for postcodes: ANA NAA + // Expression for postcodes: ANA NAA. $pcexp[1] = '/^(' . $alpha1 . '{1}[0-9]{1}' . $alpha3 . '{1})([0-9]{1}' . $alpha5 . '{2})$/'; - // Expression for postcodes: AANA NAA + // Expression for postcodes: AANA NAA. $pcexp[2] = '/^(' . $alpha1 . '{1}' . $alpha2 . '[0-9]{1}' . $alpha4 . ')([0-9]{1}' . $alpha5 . '{2})$/'; - // Exception for the special postcode GIR 0AA + // Exception for the special postcode GIR 0AA. $pcexp[3] = '/^(gir)(0aa)$/'; - // Standard BFPO numbers + // Standard BFPO numbers. $pcexp[4] = '/^(bfpo)([0-9]{1,4})$/'; - // c/o BFPO numbers + // c/o BFPO numbers. $pcexp[5] = '/^(bfpo)(c\/o[0-9]{1,3})$/'; - // Load up the string to check, converting into lowercase and removing spaces + // Load up the string to check, converting into lowercase and removing spaces. $postcode = strtolower( $to_check ); $postcode = str_replace( ' ', '', $postcode ); - // Assume we are not going to find a valid postcode + // Assume we are not going to find a valid postcode. $valid = false; - // Check the string against the six types of postcodes + // Check the string against the six types of postcodes. foreach ( $pcexp as $regexp ) { if ( preg_match( $regexp, $postcode, $matches ) ) { - // Remember that we have found that the code is valid and break from loop + // Remember that we have found that the code is valid and break from loop. $valid = true; break; } @@ -155,18 +159,18 @@ class WC_Validation { /** * Format the postcode according to the country and length of the postcode. * - * @param string $postcode Postcode to format. - * @param string $country Country to format the postcode for. - * @return string Formatted postcode. + * @param string $postcode Postcode to format. + * @param string $country Country to format the postcode for. + * @return string Formatted postcode. */ public static function format_postcode( $postcode, $country ) { return wc_format_postcode( $postcode, $country ); } /** - * format_phone function. + * Format a given phone number. * - * @param mixed $tel Phone number to format. + * @param mixed $tel Phone number to format. * @return string */ public static function format_phone( $tel ) { diff --git a/includes/class-wc-webhook.php b/includes/class-wc-webhook.php index 7722874cb0f..5306f6e1b7e 100644 --- a/includes/class-wc-webhook.php +++ b/includes/class-wc-webhook.php @@ -1,85 +1,81 @@ null, + 'date_modified' => null, + 'status' => 'disabled', + 'delivery_url' => '', + 'secret' => '', + 'name' => '', + 'topic' => '', + 'hooks' => '', + 'resource' => '', + 'event' => '', + 'failure_count' => 0, + 'user_id' => 0, + 'api_version' => 2, + 'pending_delivery' => false, + ); - $id = absint( $id ); + /** + * Load webhook data based on how WC_Webhook is called. + * + * @param WC_Webhook|int $data Webhook ID or data. + * @throws Exception If webhook cannot be read/found and $data is set. + */ + public function __construct( $data = 0 ) { + parent::__construct( $data ); - if ( ! $id ) { - return; + if ( $data instanceof WC_Webhook ) { + $this->set_id( absint( $data->get_id() ) ); + } elseif ( is_numeric( $data ) ) { + $this->set_id( $data ); } - $this->id = $id; - $this->post_data = get_post( $id ); - } + $this->data_store = WC_Data_Store::load( 'webhook' ); - - /** - * Magic isset as a wrapper around metadata_exists(). - * - * @since 2.2 - * @param string $key - * @return bool true if $key isset, false otherwise - */ - public function __isset( $key ) { - if ( ! $this->id ) { - return false; - } - return metadata_exists( 'post', $this->id, '_' . $key ); - } - - - /** - * Magic get, wraps get_post_meta() for all keys except $status. - * - * @since 2.2 - * @param string $key - * @return mixed value - */ - public function __get( $key ) { - - if ( 'status' === $key ) { - $value = $this->get_status(); + // If we have an ID, load the user from the DB. + if ( $this->get_id() ) { + try { + $this->data_store->read( $this ); + } catch ( Exception $e ) { + $this->set_id( 0 ); + $this->set_object_read( true ); + } } else { - $value = get_post_meta( $this->id, '_' . $key, true ); + $this->set_object_read( true ); } - - return $value; } - /** * Enqueue the hooks associated with the webhook. * - * @since 2.2 + * @since 2.2.0 */ public function enqueue() { $hooks = $this->get_hooks(); @@ -92,54 +88,47 @@ class WC_Webhook { } } - /** * Process the webhook for delivery by verifying that it should be delivered. * and scheduling the delivery (in the background by default, or immediately). * - * @since 2.2 - * @param mixed $arg the first argument provided from the associated hooks + * @since 2.2.0 + * @param mixed $arg The first argument provided from the associated hooks. */ public function process( $arg ) { - // verify that webhook should be processed for delivery + // Verify that webhook should be processed for delivery. if ( ! $this->should_deliver( $arg ) ) { return; } - // webhooks are processed in the background by default - // so as to avoid delays or failures in delivery from affecting the - // user who triggered it - if ( apply_filters( 'woocommerce_webhook_deliver_async', true, $this, $arg ) ) { - - // deliver in background - wp_schedule_single_event( time(), 'woocommerce_deliver_webhook_async', array( $this->id, $arg ) ); - - } else { - - // deliver immediately - $this->deliver( $arg ); - } + /** + * Process webhook delivery. + * + * @since 3.3.0 + * @hooked wc_webhook_process_delivery - 10 + */ + do_action( 'woocommerce_webhook_process_delivery', $this, $arg ); } /** * Helper to check if the webhook should be delivered, as some hooks. * (like `wp_trash_post`) will fire for every post type, not just ours. * - * @since 2.2 - * @param mixed $arg first hook argument - * @return bool true if webhook should be delivered, false otherwise + * @since 2.2.0 + * @param mixed $arg First hook argument. + * @return bool True if webhook should be delivered, false otherwise. */ private function should_deliver( $arg ) { $should_deliver = true; $current_action = current_action(); - // only active webhooks can be delivered - if ( 'active' != $this->get_status() ) { + // Only active webhooks can be delivered. + if ( 'active' !== $this->get_status() ) { $should_deliver = false; } elseif ( in_array( $current_action, array( 'delete_post', 'wp_trash_post', 'untrashed_post' ), true ) ) { // Only deliver deleted/restored event for coupons, orders, and products. - if ( isset( $GLOBALS['post_type'] ) && ! in_array( $GLOBALS['post_type'], array( 'shop_coupon', 'shop_order', 'product' ) ) ) { + if ( isset( $GLOBALS['post_type'] ) && ! in_array( $GLOBALS['post_type'], array( 'shop_coupon', 'shop_order', 'product' ), true ) ) { $should_deliver = false; } @@ -147,52 +136,51 @@ class WC_Webhook { if ( isset( $GLOBALS['post_type'] ) && str_replace( 'shop_', '', $GLOBALS['post_type'] ) !== $this->get_resource() ) { $should_deliver = false; } - } elseif ( 'delete_user' == $current_action ) { + } elseif ( 'delete_user' === $current_action ) { $user = get_userdata( absint( $arg ) ); - // only deliver deleted customer event for users with customer role - if ( ! $user || ! in_array( 'customer', (array) $user->roles ) ) { + // Only deliver deleted customer event for users with customer role. + if ( ! $user || ! in_array( 'customer', (array) $user->roles, true ) ) { $should_deliver = false; } - - // check if the custom order type has chosen to exclude order webhooks from triggering along with its own webhooks. - } elseif ( 'order' == $this->get_resource() && ! in_array( get_post_type( absint( $arg ) ), wc_get_order_types( 'order-webhooks' ) ) ) { + } elseif ( 'order' === $this->get_resource() && ! in_array( get_post_type( absint( $arg ) ), wc_get_order_types( 'order-webhooks' ), true ) ) { + // Only if the custom order type has chosen to exclude order webhooks from triggering along with its own webhooks. $should_deliver = false; } elseif ( 0 === strpos( $current_action, 'woocommerce_process_shop' ) || 0 === strpos( $current_action, 'woocommerce_process_product' ) ) { - // the `woocommerce_process_shop_*` and `woocommerce_process_product_*` hooks + // The `woocommerce_process_shop_*` and `woocommerce_process_product_*` hooks // fire for create and update of products and orders, so check the post - // creation date to determine the actual event + // creation date to determine the actual event. $resource = get_post( absint( $arg ) ); - // Drafts don't have post_date_gmt so calculate it here + // Drafts don't have post_date_gmt so calculate it here. $gmt_date = get_gmt_from_date( $resource->post_date ); - // a resource is considered created when the hook is executed within 10 seconds of the post creation date + // A resource is considered created when the hook is executed within 10 seconds of the post creation date. $resource_created = ( ( time() - 10 ) <= strtotime( $gmt_date ) ); - if ( 'created' == $this->get_event() && ! $resource_created ) { + if ( 'created' === $this->get_event() && ! $resource_created ) { $should_deliver = false; - } elseif ( 'updated' == $this->get_event() && $resource_created ) { + } elseif ( 'updated' === $this->get_event() && $resource_created ) { $should_deliver = false; } } /* - * Let other plugins intercept deliver for some messages queue like rabbit/zeromq + * Let other plugins intercept deliver for some messages queue like rabbit/zeromq. */ return apply_filters( 'woocommerce_webhook_should_deliver', $should_deliver, $this, $arg ); } - /** * Deliver the webhook payload using wp_safe_remote_request(). * - * @since 2.2 + * @since 2.2.0 * @param mixed $arg First hook argument. */ public function deliver( $arg ) { - $payload = $this->build_payload( $arg ); + $start_time = microtime( true ); + $payload = $this->build_payload( $arg ); // Setup request args. $http_args = array( @@ -202,23 +190,24 @@ class WC_Webhook { 'httpversion' => '1.0', 'blocking' => true, 'user-agent' => sprintf( 'WooCommerce/%s Hookshot (WordPress/%s)', WC_VERSION, $GLOBALS['wp_version'] ), - 'body' => trim( json_encode( $payload ) ), - 'headers' => array( 'Content-Type' => 'application/json' ), + 'body' => trim( wp_json_encode( $payload ) ), + 'headers' => array( + 'Content-Type' => 'application/json', + ), 'cookies' => array(), ); - $http_args = apply_filters( 'woocommerce_webhook_http_args', $http_args, $arg, $this->id ); + $http_args = apply_filters( 'woocommerce_webhook_http_args', $http_args, $arg, $this->get_id() ); // Add custom headers. + $delivery_id = $this->get_new_delivery_id(); $http_args['headers']['X-WC-Webhook-Source'] = home_url( '/' ); // Since 2.6.0. $http_args['headers']['X-WC-Webhook-Topic'] = $this->get_topic(); $http_args['headers']['X-WC-Webhook-Resource'] = $this->get_resource(); $http_args['headers']['X-WC-Webhook-Event'] = $this->get_event(); $http_args['headers']['X-WC-Webhook-Signature'] = $this->generate_signature( $http_args['body'] ); - $http_args['headers']['X-WC-Webhook-ID'] = $this->id; - $http_args['headers']['X-WC-Webhook-Delivery-ID'] = $delivery_id = $this->get_new_delivery_id(); - - $start_time = microtime( true ); + $http_args['headers']['X-WC-Webhook-ID'] = $this->get_id(); + $http_args['headers']['X-WC-Webhook-Delivery-ID'] = $delivery_id; // Webhook away! $response = wp_safe_remote_request( $this->get_delivery_url(), $http_args ); @@ -227,7 +216,7 @@ class WC_Webhook { $this->log_delivery( $delivery_id, $http_args, $response, $duration ); - do_action( 'woocommerce_webhook_delivery', $http_args, $response, $duration, $arg, $this->id ); + do_action( 'woocommerce_webhook_delivery', $http_args, $response, $duration, $arg, $this->get_id() ); } /** @@ -245,19 +234,19 @@ class WC_Webhook { WC()->api->register_resources( new WC_API_Server( '/' ) ); switch ( $resource ) { - case 'coupon' : + case 'coupon': $payload = WC()->api->WC_API_Coupons->get_coupon( $resource_id ); break; - case 'customer' : + case 'customer': $payload = WC()->api->WC_API_Customers->get_customer( $resource_id ); break; - case 'order' : + case 'order': $payload = WC()->api->WC_API_Orders->get_order( $resource_id, null, apply_filters( 'woocommerce_webhook_order_payload_filters', array() ) ); break; - case 'product' : + case 'product': // Bulk and quick edit action hooks return a product object instead of an ID. if ( 'updated' === $event && is_a( $resource_id, 'WC_Product' ) ) { $resource_id = $resource_id->get_id(); @@ -266,14 +255,14 @@ class WC_Webhook { break; // Custom topics include the first hook argument. - case 'action' : + case 'action': $payload = array( 'action' => current( $this->get_hooks() ), 'arg' => $resource_id, ); break; - default : + default: $payload = array(); break; } @@ -294,13 +283,13 @@ class WC_Webhook { $version_suffix = 'wp_api_v1' === $this->get_api_version() ? '_V1' : ''; switch ( $resource ) { - case 'coupon' : - case 'customer' : - case 'order' : - case 'product' : + case 'coupon': + case 'customer': + case 'order': + case 'product': $class = 'WC_REST_' . ucfirst( $resource ) . 's' . $version_suffix . '_Controller'; $request = new WP_REST_Request( 'GET' ); - $controller = new $class; + $controller = new $class(); // Bulk and quick edit action hooks return a product object instead of an ID. if ( 'product' === $resource && 'updated' === $event && is_a( $resource_id, 'WC_Product' ) ) { @@ -313,14 +302,14 @@ class WC_Webhook { break; // Custom topics include the first hook argument. - case 'action' : + case 'action': $payload = array( 'action' => current( $this->get_hooks() ), 'arg' => $resource_id, ); break; - default : + default: $payload = array(); break; } @@ -331,14 +320,14 @@ class WC_Webhook { /** * Build the payload data for the webhook. * - * @since 2.2 - * @param mixed $resource_id first hook argument, typically the resource ID - * @return mixed payload data + * @since 2.2.0 + * @param mixed $resource_id First hook argument, typically the resource ID. + * @return mixed Payload data. */ public function build_payload( $resource_id ) { - // build the payload with the same user context as the user who created + // Build the payload with the same user context as the user who created // the webhook -- this avoids permission errors as background processing - // runs with no user context + // runs with no user context. $current_user = get_current_user_id(); wp_set_current_user( $this->get_user_id() ); @@ -346,7 +335,7 @@ class WC_Webhook { $event = $this->get_event(); // If a resource has been deleted, just include the ID. - if ( 'deleted' == $event ) { + if ( 'deleted' === $event ) { $payload = array( 'id' => $resource_id, ); @@ -361,75 +350,72 @@ class WC_Webhook { // Restore the current user. wp_set_current_user( $current_user ); - return apply_filters( 'woocommerce_webhook_payload', $payload, $resource, $resource_id, $this->id ); + return apply_filters( 'woocommerce_webhook_payload', $payload, $resource, $resource_id, $this->get_id() ); } - /** * Generate a base64-encoded HMAC-SHA256 signature of the payload body so the. * recipient can verify the authenticity of the webhook. Note that the signature. * is calculated after the body has already been encoded (JSON by default). * - * @since 2.2 - * @param string $payload payload data to hash - * @return string hash + * @since 2.2.0 + * @param string $payload Payload data to hash. + * @return string */ public function generate_signature( $payload ) { - - $hash_algo = apply_filters( 'woocommerce_webhook_hash_algorithm', 'sha256', $payload, $this->id ); + $hash_algo = apply_filters( 'woocommerce_webhook_hash_algorithm', 'sha256', $payload, $this->get_id() ); return base64_encode( hash_hmac( $hash_algo, $payload, $this->get_secret(), true ) ); } - /** - * Create a new comment for log the delivery request/response and. - * return the ID for inclusion in the webhook request. + * Generate a new unique hash as a delivery id based on current time and wehbook id. + * Return the hash for inclusion in the webhook request. * - * @since 2.2 - * @return int delivery (comment) ID + * @since 2.2.0 + * @return string */ public function get_new_delivery_id() { - - $comment_data = apply_filters( 'woocommerce_new_webhook_delivery_data', array( - 'comment_author' => __( 'WooCommerce', 'woocommerce' ), - 'comment_author_email' => sanitize_email( sprintf( '%s@%s', strtolower( __( 'WooCommerce', 'woocommerce' ) ), isset( $_SERVER['HTTP_HOST'] ) ? str_replace( 'www.', '', $_SERVER['HTTP_HOST'] ) : 'noreply.com' ) ), - 'comment_post_ID' => $this->id, - 'comment_agent' => 'WooCommerce Hookshot', - 'comment_type' => 'webhook_delivery', - 'comment_parent' => 0, - 'comment_approved' => 1, - ), $this->id ); - - $comment_id = wp_insert_comment( $comment_data ); - - return $comment_id; + // Since we no longer use comments to store delivery logs, we generate a unique hash instead based on current time and webhook ID. + return wp_hash( $this->get_id() . strtotime( 'now' ) ); } - /** * Log the delivery request/response. * - * @since 2.2 - * @param int $delivery_id previously created comment ID - * @param array $request request data - * @param array|WP_Error $response response data - * @param float $duration request duration + * @since 2.2.0 + * @param string $delivery_id Previously created hash. + * @param array $request Request data. + * @param array|WP_Error $response Response data. + * @param float $duration Request duration. */ public function log_delivery( $delivery_id, $request, $response, $duration ) { + $logger = wc_get_logger(); + $message = array( + 'Webhook Delivery' => array( + 'Delivery ID' => $delivery_id, + 'Date' => date_i18n( __( 'M j, Y @ G:i', 'woocommerce' ), strtotime( 'now' ), true ), + 'URL' => $this->get_delivery_url(), + 'Duration' => $duration, + 'Request' => array( + 'Method' => $request['method'], + 'Headers' => array_merge( + array( + 'User-Agent' => $request['user-agent'], + ), + $request['headers'] + ), + ), + 'Body' => wp_slash( $request['body'] ), + ), + ); - // save request data - add_comment_meta( $delivery_id, '_request_method', $request['method'] ); - add_comment_meta( $delivery_id, '_request_headers', array_merge( array( 'User-Agent' => $request['user-agent'] ), $request['headers'] ) ); - add_comment_meta( $delivery_id, '_request_body', wp_slash( $request['body'] ) ); - - // parse response + // Parse response. if ( is_wp_error( $response ) ) { $response_code = $response->get_error_code(); $response_message = $response->get_error_message(); $response_headers = array(); $response_body = ''; - } else { $response_code = wp_remote_retrieve_response_code( $response ); $response_message = wp_remote_retrieve_response_message( $response ); @@ -437,40 +423,31 @@ class WC_Webhook { $response_body = wp_remote_retrieve_body( $response ); } - // save response data - add_comment_meta( $delivery_id, '_response_code', $response_code ); - add_comment_meta( $delivery_id, '_response_message', $response_message ); - add_comment_meta( $delivery_id, '_response_headers', $response_headers ); - add_comment_meta( $delivery_id, '_response_body', $response_body ); - - // save duration - add_comment_meta( $delivery_id, '_duration', $duration ); - - // set a summary for quick display - $args = array( - 'comment_ID' => $delivery_id, - 'comment_content' => sprintf( 'HTTP %s %s: %s', $response_code, $response_message, $response_body ), + $message['Webhook Delivery']['Response'] = array( + 'Code' => $response_code, + 'Message' => $response_message, + 'Headers' => $response_headers, + 'Body' => $response_body, ); - wp_update_comment( $args ); - - // track failures - if ( intval( $response_code ) >= 200 && intval( $response_code ) < 300 ) { - delete_post_meta( $this->id, '_failure_count' ); - } else { - $this->failed_delivery(); + if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG ) { + $message['Webhook Delivery']['Body'] = 'Webhook body is not logged unless WP_DEBUG mode is turned on. This is to avoid the storing of personal data in the logs.'; + $message['Webhook Delivery']['Response']['Body'] = 'Webhook body is not logged unless WP_DEBUG mode is turned on. This is to avoid the storing of personal data in the logs.'; } - // keep the 25 most recent delivery logs - $log = wp_count_comments( $this->id ); - if ( $log->total_comments > apply_filters( 'woocommerce_max_webhook_delivery_logs', 25 ) ) { - global $wpdb; + $logger->info( + wc_print_r( $message, true ), array( + 'source' => 'webhooks-delivery', + ) + ); - $comment_id = $wpdb->get_var( $wpdb->prepare( "SELECT comment_ID FROM {$wpdb->comments} WHERE comment_post_ID = %d ORDER BY comment_date_gmt ASC LIMIT 1", $this->id ) ); - - if ( $comment_id ) { - wp_delete_comment( $comment_id, true ); - } + // Track failures. + // Check for a success, which is a 2xx, 301 or 302 Response Code. + if ( intval( $response_code ) >= 200 && intval( $response_code ) < 303 ) { + $this->set_failure_count( 0 ); + $this->save(); + } else { + $this->failed_delivery(); } } @@ -479,56 +456,32 @@ class WC_Webhook { * if more than 5 consecutive failures occur. A failure is defined as a. * non-2xx response. * - * @since 2.2 + * @since 2.2.0 */ private function failed_delivery() { - $failures = $this->get_failure_count(); if ( $failures > apply_filters( 'woocommerce_max_webhook_delivery_failures', 5 ) ) { + $this->set_status( 'disabled' ); - $this->update_status( 'disabled' ); - + do_action( 'woocommerce_webhook_disabled_due_delivery_failures', $this->get_id() ); } else { - - update_post_meta( $this->id, '_failure_count', ++$failures ); + $this->set_failure_count( ++$failures ); } - } + $this->save(); + } /** * Get the delivery logs for this webhook. * - * @since 2.2 - * @return array + * @since 3.3.0 + * @return string */ public function get_delivery_logs() { - - $args = array( - 'post_id' => $this->id, - 'status' => 'approve', - 'type' => 'webhook_delivery', - ); - - remove_filter( 'comments_clauses', array( 'WC_Comments', 'exclude_webhook_comments' ), 10, 1 ); - - $logs = get_comments( $args ); - - add_filter( 'comments_clauses', array( 'WC_Comments', 'exclude_webhook_comments' ), 10, 1 ); - - $delivery_logs = array(); - - foreach ( $logs as $log ) { - - $log = $this->get_delivery_log( $log->comment_ID ); - - $delivery_logs[] = ( ! empty( $log ) ? $log : array() ); - } - - return $delivery_logs; + return esc_url( add_query_arg( 'log_file', wc_get_log_file_name( 'webhooks-delivery' ), admin_url( 'admin.php?page=wc-status&tab=logs' ) ) ); } - /** * Get the delivery log specified by the ID. The delivery log includes: * @@ -539,130 +492,392 @@ class WC_Webhook { * + response code/message/headers/body * * @since 2.2 - * @param int $delivery_id - * @return bool|array false if invalid delivery ID, array of log data otherwise + * @deprecated 3.3.0 + * @param int $delivery_id Delivery ID. + * @return void */ public function get_delivery_log( $delivery_id ) { - - $log = get_comment( $delivery_id ); - - // valid comment and ensure delivery log belongs to this webhook - if ( is_null( $log ) || $log->comment_post_ID != $this->id ) { - return false; - } - - $delivery_log = array( - 'id' => intval( $delivery_id ), - 'duration' => get_comment_meta( $delivery_id, '_duration', true ), - 'summary' => $log->comment_content, - 'request_method' => get_comment_meta( $delivery_id, '_request_method', true ), - 'request_url' => $this->get_delivery_url(), - 'request_headers' => get_comment_meta( $delivery_id, '_request_headers', true ), - 'request_body' => get_comment_meta( $delivery_id, '_request_body', true ), - 'response_code' => get_comment_meta( $delivery_id, '_response_code', true ), - 'response_message' => get_comment_meta( $delivery_id, '_response_message', true ), - 'response_headers' => get_comment_meta( $delivery_id, '_response_headers', true ), - 'response_body' => get_comment_meta( $delivery_id, '_response_body', true ), - 'comment' => $log, - ); - - return apply_filters( 'woocommerce_webhook_delivery_log', $delivery_log, $delivery_id, $this->id ); + wc_deprecated_function( 'WC_Webhook::get_delivery_log', '3.3' ); } /** - * Set the webhook topic and associated hooks. The topic resource & event. - * are also saved separately. + * Send a test ping to the delivery URL, sent when the webhook is first created. * - * @since 2.2 - * @param string $topic + * @since 2.2.0 + * @return bool|WP_Error + */ + public function deliver_ping() { + $args = array( + 'user-agent' => sprintf( 'WooCommerce/%s Hookshot (WordPress/%s)', WC_VERSION, $GLOBALS['wp_version'] ), + 'body' => 'webhook_id=' . $this->get_id(), + ); + + $test = wp_safe_remote_post( $this->get_delivery_url(), $args ); + $response_code = wp_remote_retrieve_response_code( $test ); + + if ( is_wp_error( $test ) ) { + /* translators: error message */ + return new WP_Error( 'error', sprintf( __( 'Error: Delivery URL cannot be reached: %s', 'woocommerce' ), $test->get_error_message() ) ); + } + + if ( 200 !== $response_code ) { + /* translators: error message */ + return new WP_Error( 'error', sprintf( __( 'Error: Delivery URL returned response code: %s', 'woocommerce' ), absint( $response_code ) ) ); + } + + $this->set_pending_delivery( false ); + $this->save(); + + return true; + } + + /* + |-------------------------------------------------------------------------- + | Getters + |-------------------------------------------------------------------------- + */ + + /** + * Get the friendly name for the webhook. + * + * @since 2.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return string + */ + public function get_name( $context = 'view' ) { + return apply_filters( 'woocommerce_webhook_name', $this->get_prop( 'name', $context ), $this->get_id() ); + } + + /** + * Get the webhook status. + * + * - 'active' - delivers payload. + * - 'paused' - does not deliver payload, paused by admin. + * - 'disabled' - does not delivery payload, paused automatically due to consecutive failures. + * + * @since 2.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return string status + */ + public function get_status( $context = 'view' ) { + return apply_filters( 'woocommerce_webhook_status', $this->get_prop( 'status', $context ), $this->get_id() ); + } + + /** + * Get webhopk created date. + * + * @since 3.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return WC_DateTime|null Object if the date is set or null if there is no date. + */ + public function get_date_created( $context = 'view' ) { + return $this->get_prop( 'date_created', $context ); + } + + /** + * Get webhopk modified date. + * + * @since 3.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return WC_DateTime|null Object if the date is set or null if there is no date. + */ + public function get_date_modified( $context = 'view' ) { + return $this->get_prop( 'date_modified', $context ); + } + + /** + * Get the secret used for generating the HMAC-SHA256 signature. + * + * @since 2.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return string + */ + public function get_secret( $context = 'view' ) { + return apply_filters( 'woocommerce_webhook_secret', $this->get_prop( 'secret', $context ), $this->get_id() ); + } + + /** + * Get the webhook topic, e.g. `order.created`. + * + * @since 2.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return string + */ + public function get_topic( $context = 'view' ) { + return apply_filters( 'woocommerce_webhook_topic', $this->get_prop( 'topic', $context ), $this->get_id() ); + } + + /** + * Get the delivery URL. + * + * @since 2.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return string + */ + public function get_delivery_url( $context = 'view' ) { + return apply_filters( 'woocommerce_webhook_delivery_url', $this->get_prop( 'delivery_url', $context ), $this->get_id() ); + } + + /** + * Get the user ID for this webhook. + * + * @since 2.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return int + */ + public function get_user_id( $context = 'view' ) { + return $this->get_prop( 'user_id', $context ); + } + + /** + * API version. + * + * @since 3.0.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return string + */ + public function get_api_version( $context = 'view' ) { + $version = $this->get_prop( 'api_version', $context ); + + return 0 < $version ? 'wp_api_v' . $version : 'legacy_v3'; + } + + /** + * Get the failure count. + * + * @since 2.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return int + */ + public function get_failure_count( $context = 'view' ) { + return $this->get_prop( 'failure_count', $context ); + } + + /** + * Get pending delivery. + * + * @since 3.2.0 + * @param string $context What the value is for. + * Valid values are 'view' and 'edit'. + * @return bool + */ + public function get_pending_delivery( $context = 'view' ) { + return $this->get_prop( 'pending_delivery', $context ); + } + + /* + |-------------------------------------------------------------------------- + | Setters + |-------------------------------------------------------------------------- + */ + + /** + * Set webhook name. + * + * @since 3.2.0 + * @param string $name Webhook name. + */ + public function set_name( $name ) { + $this->set_prop( 'name', $name ); + } + + /** + * Set webhook created date. + * + * @since 3.2.0 + * @param string|integer|null $date UTC timestamp, or ISO 8601 DateTime. + * If the DateTime string has no timezone or offset, + * WordPress site timezone will be assumed. + * Null if their is no date. + */ + public function set_date_created( $date = null ) { + $this->set_date_prop( 'date_created', $date ); + } + + /** + * Set webhook modified date. + * + * @since 3.2.0 + * @param string|integer|null $date UTC timestamp, or ISO 8601 DateTime. + * If the DateTime string has no timezone or offset, + * WordPress site timezone will be assumed. + * Null if their is no date. + */ + public function set_date_modified( $date = null ) { + $this->set_date_prop( 'date_modified', $date ); + } + + /** + * Set status. + * + * @since 3.2.0 + * @param string $status Status. + */ + public function set_status( $status ) { + if ( ! array_key_exists( $status, wc_get_webhook_statuses() ) ) { + $status = 'disabled'; + } + + $this->set_prop( 'status', $status ); + } + + /** + * Set the secret used for generating the HMAC-SHA256 signature. + * + * @since 2.2.0 + * @param string $secret Secret. + */ + public function set_secret( $secret ) { + $this->set_prop( 'secret', $secret ); + } + + /** + * Set the webhook topic and associated hooks. + * The topic resource & event are also saved separately. + * + * @since 2.2.0 + * @param string $topic Webhook topic. */ public function set_topic( $topic ) { + $topic = wc_clean( $topic ); - $topic = strtolower( $topic ); - - list( $resource, $event ) = explode( '.', $topic ); - - update_post_meta( $this->id, '_topic', $topic ); - update_post_meta( $this->id, '_resource', $resource ); - update_post_meta( $this->id, '_event', $event ); - - // custom topics are mapped to a single hook - if ( 'action' === $resource ) { - - update_post_meta( $this->id, '_hooks', array( $event ) ); - - } else { - - // API topics have multiple hooks - update_post_meta( $this->id, '_hooks', $this->get_topic_hooks( $topic ) ); + if ( ! wc_is_webhook_valid_topic( $topic ) ) { + $topic = ''; } + + $this->set_prop( 'topic', $topic ); } + /** + * Set the delivery URL. + * + * @since 2.2.0 + * @param string $url Delivery URL. + */ + public function set_delivery_url( $url ) { + $this->set_prop( 'delivery_url', esc_url_raw( $url, array( 'http', 'https' ) ) ); + } + + /** + * Set user ID. + * + * @since 3.2.0 + * @param int $user_id User ID. + */ + public function set_user_id( $user_id ) { + $this->set_prop( 'user_id', (int) $user_id ); + } + + /** + * Set API version. + * + * @since 3.0.0 + * @param int|string $version REST API version. + */ + public function set_api_version( $version ) { + if ( ! is_numeric( $version ) ) { + $version = $this->data_store->get_api_version_number( $version ); + } + + $this->set_prop( 'api_version', (int) $version ); + } + + /** + * Set pending delivery. + * + * @since 3.2.0 + * @param bool $pending_delivery Set true if is pending for delivery. + */ + public function set_pending_delivery( $pending_delivery ) { + $this->set_prop( 'pending_delivery', (bool) $pending_delivery ); + } + + /** + * Set failure count. + * + * @since 3.2.0 + * @param bool $failure_count Total of failures. + */ + public function set_failure_count( $failure_count ) { + $this->set_prop( 'failure_count', intval( $failure_count ) ); + } + + /* + |-------------------------------------------------------------------------- + | Non-CRUD Getters + |-------------------------------------------------------------------------- + */ + /** * Get the associated hook names for a topic. * - * @since 2.2 - * @param string $topic - * @return array hook names + * @since 2.2.0 + * @param string $topic Topic name. + * @return array */ private function get_topic_hooks( $topic ) { - $topic_hooks = array( - 'coupon.created' => array( + 'coupon.created' => array( 'woocommerce_process_shop_coupon_meta', - 'woocommerce_api_create_coupon', + 'woocommerce_new_coupon', ), - 'coupon.updated' => array( + 'coupon.updated' => array( 'woocommerce_process_shop_coupon_meta', - 'woocommerce_api_edit_coupon', + 'woocommerce_update_coupon', ), - 'coupon.deleted' => array( + 'coupon.deleted' => array( 'wp_trash_post', ), - 'coupon.restored' => array( + 'coupon.restored' => array( 'untrashed_post', ), 'customer.created' => array( 'user_register', 'woocommerce_created_customer', - 'woocommerce_api_create_customer', + 'woocommerce_new_customer', ), 'customer.updated' => array( 'profile_update', - 'woocommerce_api_edit_customer', - 'woocommerce_customer_save_address', + 'woocommerce_update_customer', ), 'customer.deleted' => array( 'delete_user', ), 'order.created' => array( - 'woocommerce_checkout_order_processed', 'woocommerce_process_shop_order_meta', - 'woocommerce_api_create_order', + 'woocommerce_new_order', ), - 'order.updated' => array( + 'order.updated' => array( 'woocommerce_process_shop_order_meta', - 'woocommerce_api_edit_order', - 'woocommerce_order_edit_status', - 'woocommerce_order_status_changed', + 'woocommerce_update_order', ), - 'order.deleted' => array( + 'order.deleted' => array( 'wp_trash_post', ), - 'order.restored' => array( + 'order.restored' => array( 'untrashed_post', ), - 'product.created' => array( + 'product.created' => array( 'woocommerce_process_product_meta', - 'woocommerce_api_create_product', + 'woocommerce_new_product', + 'woocommerce_new_product_variation', ), - 'product.updated' => array( + 'product.updated' => array( 'woocommerce_process_product_meta', - 'woocommerce_api_edit_product', - 'woocommerce_product_quick_edit_save', - 'woocommerce_product_bulk_edit_save', + 'woocommerce_update_product', + 'woocommerce_update_product_variation', ), - 'product.deleted' => array( + 'product.deleted' => array( 'wp_trash_post', ), 'product.restored' => array( @@ -676,65 +891,43 @@ class WC_Webhook { } /** - * Send a test ping to the delivery URL, sent when the webhook is first created. + * Get the hook names for the webhook. * - * @since 2.2 - * @return bool|WP_Error + * @since 2.2.0 + * @return array */ - public function deliver_ping() { - $args = array( - 'user-agent' => sprintf( 'WooCommerce/%s Hookshot (WordPress/%s)', WC_VERSION, $GLOBALS['wp_version'] ), - 'body' => "webhook_id={$this->id}", - ); - - $test = wp_safe_remote_post( $this->get_delivery_url(), $args ); - $response_code = wp_remote_retrieve_response_code( $test ); - - if ( is_wp_error( $test ) ) { - return new WP_Error( 'error', sprintf( __( 'Error: Delivery URL cannot be reached: %s', 'woocommerce' ), $test->get_error_message() ) ); + public function get_hooks() { + if ( 'action' === $this->get_resource() ) { + $hooks = array( $this->get_event() ); + } else { + $hooks = $this->get_topic_hooks( $this->get_topic() ); } - if ( 200 !== $response_code ) { - return new WP_Error( 'error', sprintf( __( 'Error: Delivery URL returned response code: %s', 'woocommerce' ), absint( $response_code ) ) ); - } - - delete_post_meta( $this->id, '_webhook_pending_delivery' ); - - return true; + return apply_filters( 'woocommerce_webhook_hooks', $hooks, $this->get_id() ); } /** - * Get the webhook status: + * Get the resource for the webhook, e.g. `order`. * - * + `active` - delivers payload. - * + `paused` - does not deliver payload, paused by admin. - * + `disabled` - does not delivery payload, paused automatically due to. - * consecutive failures. - * - * @since 2.2 - * @return string status + * @since 2.2.0 + * @return string */ - public function get_status() { + public function get_resource() { + $topic = explode( '.', $this->get_topic() ); - switch ( $this->get_post_data()->post_status ) { + return apply_filters( 'woocommerce_webhook_resource', $topic[0], $this->get_id() ); + } - case 'publish': - $status = 'active'; - break; + /** + * Get the event for the webhook, e.g. `created`. + * + * @since 2.2.0 + * @return string + */ + public function get_event() { + $topic = explode( '.', $this->get_topic() ); - case 'draft': - $status = 'paused'; - break; - - case 'pending': - $status = 'disabled'; - break; - - default: - $status = 'paused'; - } - - return apply_filters( 'woocommerce_webhook_status', $status, $this->id ); + return apply_filters( 'woocommerce_webhook_event', isset( $topic[1] ) ? $topic[1] : '', $this->get_id() ); } /** @@ -748,190 +941,4 @@ class WC_Webhook { return isset( $statuses[ $status ] ) ? $statuses[ $status ] : $status; } - - /** - * Update the webhook status, see get_status() for valid statuses. - * - * @since 2.2 - * @param $status - */ - public function update_status( $status ) { - global $wpdb; - - switch ( $status ) { - - case 'active' : - $post_status = 'publish'; - break; - - case 'paused' : - $post_status = 'draft'; - break; - - case 'disabled' : - $post_status = 'pending'; - break; - - default : - $post_status = 'draft'; - break; - } - - $wpdb->update( $wpdb->posts, array( 'post_status' => $post_status ), array( 'ID' => $this->id ) ); - clean_post_cache( $this->id ); - } - - /** - * Set the delivery URL. - * - * @since 2.2 - * @param string $url - */ - public function set_delivery_url( $url ) { - if ( update_post_meta( $this->id, '_delivery_url', esc_url_raw( $url, array( 'http', 'https' ) ) ) ) { - update_post_meta( $this->id, '_webhook_pending_delivery', true ); - } - } - - /** - * Get the delivery URL. - * - * @since 2.2 - * @return string - */ - public function get_delivery_url() { - - return apply_filters( 'woocommerce_webhook_delivery_url', $this->delivery_url, $this->id ); - } - - /** - * Set the secret used for generating the HMAC-SHA256 signature. - * - * @since 2.2 - * @param string $secret - */ - public function set_secret( $secret ) { - - update_post_meta( $this->id, '_secret', $secret ); - } - - /** - * Get the secret used for generating the HMAC-SHA256 signature. - * - * @since 2.2 - * @return string - */ - public function get_secret() { - return apply_filters( 'woocommerce_webhook_secret', $this->secret, $this->id ); - } - - /** - * Get the friendly name for the webhook. - * - * @since 2.2 - * @return string - */ - public function get_name() { - return apply_filters( 'woocommerce_webhook_name', $this->get_post_data()->post_title, $this->id ); - } - - /** - * Get the webhook topic, e.g. `order.created`. - * - * @since 2.2 - * @return string - */ - public function get_topic() { - return apply_filters( 'woocommerce_webhook_topic', $this->topic, $this->id ); - } - - /** - * Get the hook names for the webhook. - * - * @since 2.2 - * @return array hook names - */ - public function get_hooks() { - return apply_filters( 'woocommerce_webhook_hooks', $this->hooks, $this->id ); - } - - /** - * Get the resource for the webhook, e.g. `order`. - * - * @since 2.2 - * @return string - */ - public function get_resource() { - return apply_filters( 'woocommerce_webhook_resource', $this->resource, $this->id ); - } - - /** - * Get the event for the webhook, e.g. `created`. - * - * @since 2.2 - * @return string - */ - public function get_event() { - return apply_filters( 'woocommerce_webhook_event', $this->event, $this->id ); - } - - /** - * Get the failure count. - * - * @since 2.2 - * @return int - */ - public function get_failure_count() { - return intval( $this->failure_count ); - } - - /** - * Get the user ID for this webhook. - * - * @since 2.2 - * @return int|string user ID - */ - public function get_user_id() { - return $this->get_post_data()->post_author; - } - - /** - * Get the post data for the webhook. - * - * @since 2.2 - * @return null|WP_Post - */ - public function get_post_data() { - return $this->post_data; - } - - /** - * Set API version. - * - * @since 3.0.0 - * @param string $version REST API version. - */ - public function set_api_version( $version ) { - $versions = array( - 'wp_api_v2', - 'wp_api_v1', - 'legacy_v3', - ); - - if ( ! in_array( $version, $versions, true ) ) { - $version = 'wp_api_v2'; - } - - update_post_meta( $this->id, '_api_version', $version ); - } - - /** - * API version. - * - * @since 3.0.0 - * @return string - */ - public function get_api_version() { - return $this->api_version ? $this->api_version : 'legacy_v3'; - } } diff --git a/includes/class-woocommerce.php b/includes/class-woocommerce.php new file mode 100644 index 00000000000..65d341dd266 --- /dev/null +++ b/includes/class-woocommerce.php @@ -0,0 +1,707 @@ +$key(); + } + } + + /** + * WooCommerce Constructor. + */ + public function __construct() { + $this->define_constants(); + $this->includes(); + $this->init_hooks(); + + do_action( 'woocommerce_loaded' ); + } + + /** + * Hook into actions and filters. + * + * @since 2.3 + */ + private function init_hooks() { + register_activation_hook( WC_PLUGIN_FILE, array( 'WC_Install', 'install' ) ); + register_shutdown_function( array( $this, 'log_errors' ) ); + add_action( 'after_setup_theme', array( $this, 'setup_environment' ) ); + add_action( 'after_setup_theme', array( $this, 'include_template_functions' ), 11 ); + add_action( 'init', array( $this, 'init' ), 0 ); + add_action( 'init', array( 'WC_Shortcodes', 'init' ) ); + add_action( 'init', array( 'WC_Emails', 'init_transactional_emails' ) ); + add_action( 'init', array( $this, 'wpdb_table_fix' ), 0 ); + add_action( 'init', array( $this, 'add_image_sizes' ) ); + add_action( 'switch_blog', array( $this, 'wpdb_table_fix' ), 0 ); + } + + /** + * Ensures fatal errors are logged so they can be picked up in the status report. + * + * @since 3.2.0 + */ + public function log_errors() { + $error = error_get_last(); + if ( in_array( $error['type'], array( E_ERROR, E_PARSE, E_COMPILE_ERROR, E_USER_ERROR, E_RECOVERABLE_ERROR ) ) ) { + $logger = wc_get_logger(); + $logger->critical( + /* translators: 1: error message 2: file name and path 3: line number */ + sprintf( __( '%1$s in %2$s on line %3$s', 'woocommerce' ), $error['message'], $error['file'], $error['line'] ) . PHP_EOL, + array( + 'source' => 'fatal-errors', + ) + ); + do_action( 'woocommerce_shutdown_error', $error ); + } + } + + /** + * Define WC Constants. + */ + private function define_constants() { + $upload_dir = wp_upload_dir( null, false ); + + $this->define( 'WC_ABSPATH', dirname( WC_PLUGIN_FILE ) . '/' ); + $this->define( 'WC_PLUGIN_BASENAME', plugin_basename( WC_PLUGIN_FILE ) ); + $this->define( 'WC_VERSION', $this->version ); + $this->define( 'WOOCOMMERCE_VERSION', $this->version ); + $this->define( 'WC_ROUNDING_PRECISION', 6 ); + $this->define( 'WC_DISCOUNT_ROUNDING_MODE', 2 ); + $this->define( 'WC_TAX_ROUNDING_MODE', 'yes' === get_option( 'woocommerce_prices_include_tax', 'no' ) ? 2 : 1 ); + $this->define( 'WC_DELIMITER', '|' ); + $this->define( 'WC_LOG_DIR', $upload_dir['basedir'] . '/wc-logs/' ); + $this->define( 'WC_SESSION_CACHE_GROUP', 'wc_session_id' ); + $this->define( 'WC_TEMPLATE_DEBUG_MODE', false ); + } + + /** + * Define constant if not already set. + * + * @param string $name Constant name. + * @param string|bool $value Constant value. + */ + private function define( $name, $value ) { + if ( ! defined( $name ) ) { + define( $name, $value ); + } + } + + /** + * What type of request is this? + * + * @param string $type admin, ajax, cron or frontend. + * @return bool + */ + private function is_request( $type ) { + switch ( $type ) { + case 'admin': + return is_admin(); + case 'ajax': + return defined( 'DOING_AJAX' ); + case 'cron': + return defined( 'DOING_CRON' ); + case 'frontend': + return ( ! is_admin() || defined( 'DOING_AJAX' ) ) && ! defined( 'DOING_CRON' ) && ! defined( 'REST_REQUEST' ); + } + } + + /** + * Include required core files used in admin and on the frontend. + */ + public function includes() { + /** + * Class autoloader. + */ + include_once WC_ABSPATH . 'includes/class-wc-autoloader.php'; + + /** + * Interfaces. + */ + include_once WC_ABSPATH . 'includes/interfaces/class-wc-abstract-order-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-coupon-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-customer-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-customer-download-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-customer-download-log-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-object-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-order-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-order-item-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-order-item-product-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-order-item-type-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-order-refund-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-payment-token-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-product-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-product-variable-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-shipping-zone-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-logger-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-log-handler-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-webhooks-data-store-interface.php'; + include_once WC_ABSPATH . 'includes/interfaces/class-wc-queue-interface.php'; + + /** + * Abstract classes. + */ + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-data.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-object-query.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-payment-token.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-product.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-order.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-settings-api.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-shipping-method.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-payment-gateway.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-integration.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-log-handler.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-deprecated-hooks.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-session.php'; + include_once WC_ABSPATH . 'includes/abstracts/abstract-wc-privacy.php'; + + /** + * Core classes. + */ + include_once WC_ABSPATH . 'includes/wc-core-functions.php'; + include_once WC_ABSPATH . 'includes/class-wc-datetime.php'; + include_once WC_ABSPATH . 'includes/class-wc-post-types.php'; + include_once WC_ABSPATH . 'includes/class-wc-install.php'; + include_once WC_ABSPATH . 'includes/class-wc-geolocation.php'; + include_once WC_ABSPATH . 'includes/class-wc-download-handler.php'; + include_once WC_ABSPATH . 'includes/class-wc-comments.php'; + include_once WC_ABSPATH . 'includes/class-wc-post-data.php'; + include_once WC_ABSPATH . 'includes/class-wc-ajax.php'; + include_once WC_ABSPATH . 'includes/class-wc-emails.php'; + include_once WC_ABSPATH . 'includes/class-wc-data-exception.php'; + include_once WC_ABSPATH . 'includes/class-wc-query.php'; + include_once WC_ABSPATH . 'includes/class-wc-meta-data.php'; + include_once WC_ABSPATH . 'includes/class-wc-order-factory.php'; + include_once WC_ABSPATH . 'includes/class-wc-order-query.php'; + include_once WC_ABSPATH . 'includes/class-wc-product-factory.php'; + include_once WC_ABSPATH . 'includes/class-wc-product-query.php'; + include_once WC_ABSPATH . 'includes/class-wc-payment-tokens.php'; + include_once WC_ABSPATH . 'includes/class-wc-shipping-zone.php'; + include_once WC_ABSPATH . 'includes/gateways/class-wc-payment-gateway-cc.php'; + include_once WC_ABSPATH . 'includes/gateways/class-wc-payment-gateway-echeck.php'; + include_once WC_ABSPATH . 'includes/class-wc-countries.php'; + include_once WC_ABSPATH . 'includes/class-wc-integrations.php'; + include_once WC_ABSPATH . 'includes/class-wc-cache-helper.php'; + include_once WC_ABSPATH . 'includes/class-wc-https.php'; + include_once WC_ABSPATH . 'includes/class-wc-deprecated-action-hooks.php'; + include_once WC_ABSPATH . 'includes/class-wc-deprecated-filter-hooks.php'; + include_once WC_ABSPATH . 'includes/class-wc-background-emailer.php'; + include_once WC_ABSPATH . 'includes/class-wc-discounts.php'; + include_once WC_ABSPATH . 'includes/class-wc-cart-totals.php'; + include_once WC_ABSPATH . 'includes/customizer/class-wc-shop-customizer.php'; + include_once WC_ABSPATH . 'includes/class-wc-regenerate-images.php'; + include_once WC_ABSPATH . 'includes/class-wc-privacy.php'; + include_once WC_ABSPATH . 'includes/class-wc-structured-data.php'; + include_once WC_ABSPATH . 'includes/class-wc-shortcodes.php'; + include_once WC_ABSPATH . 'includes/class-wc-logger.php'; + include_once WC_ABSPATH . 'includes/queue/class-wc-action-queue.php'; + include_once WC_ABSPATH . 'includes/queue/class-wc-queue.php'; + + /** + * Data stores - used to store and retrieve CRUD object data from the database. + */ + include_once WC_ABSPATH . 'includes/class-wc-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-data-store-wp.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-coupon-data-store-cpt.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-product-data-store-cpt.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-product-grouped-data-store-cpt.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-product-variable-data-store-cpt.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-product-variation-data-store-cpt.php'; + include_once WC_ABSPATH . 'includes/data-stores/abstract-wc-order-item-type-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-order-item-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-order-item-coupon-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-order-item-fee-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-order-item-product-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-order-item-shipping-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-order-item-tax-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-payment-token-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-customer-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-customer-data-store-session.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-customer-download-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-customer-download-log-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-shipping-zone-data-store.php'; + include_once WC_ABSPATH . 'includes/data-stores/abstract-wc-order-data-store-cpt.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-order-data-store-cpt.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-order-refund-data-store-cpt.php'; + include_once WC_ABSPATH . 'includes/data-stores/class-wc-webhook-data-store.php'; + + /** + * REST API. + */ + include_once WC_ABSPATH . 'includes/legacy/class-wc-legacy-api.php'; + include_once WC_ABSPATH . 'includes/class-wc-api.php'; + include_once WC_ABSPATH . 'includes/class-wc-auth.php'; + include_once WC_ABSPATH . 'includes/class-wc-register-wp-admin-settings.php'; + + /** + * Libraries + */ + include_once WC_ABSPATH . 'includes/libraries/action-scheduler/action-scheduler.php'; + + if ( defined( 'WP_CLI' ) && WP_CLI ) { + include_once WC_ABSPATH . 'includes/class-wc-cli.php'; + } + + if ( $this->is_request( 'admin' ) ) { + include_once WC_ABSPATH . 'includes/admin/class-wc-admin.php'; + } + + if ( $this->is_request( 'frontend' ) ) { + $this->frontend_includes(); + } + + if ( $this->is_request( 'cron' ) && 'yes' === get_option( 'woocommerce_allow_tracking', 'no' ) ) { + include_once WC_ABSPATH . 'includes/class-wc-tracker.php'; + } + + $this->theme_support_includes(); + $this->query = new WC_Query(); + $this->api = new WC_API(); + } + + /** + * Include classes for theme support. + * + * @since 3.3.0 + */ + private function theme_support_includes() { + if ( wc_is_active_theme( array( 'twentyseventeen', 'twentysixteen', 'twentyfifteen', 'twentyfourteen', 'twentythirteen', 'twentyeleven', 'twentytwelve', 'twentyten' ) ) ) { + switch ( get_template() ) { + case 'twentyten': + include_once WC_ABSPATH . 'includes/theme-support/class-wc-twenty-ten.php'; + break; + case 'twentyeleven': + include_once WC_ABSPATH . 'includes/theme-support/class-wc-twenty-eleven.php'; + break; + case 'twentytwelve': + include_once WC_ABSPATH . 'includes/theme-support/class-wc-twenty-twelve.php'; + break; + case 'twentythirteen': + include_once WC_ABSPATH . 'includes/theme-support/class-wc-twenty-thirteen.php'; + break; + case 'twentyfourteen': + include_once WC_ABSPATH . 'includes/theme-support/class-wc-twenty-fourteen.php'; + break; + case 'twentyfifteen': + include_once WC_ABSPATH . 'includes/theme-support/class-wc-twenty-fifteen.php'; + break; + case 'twentysixteen': + include_once WC_ABSPATH . 'includes/theme-support/class-wc-twenty-sixteen.php'; + break; + case 'twentyseventeen': + include_once WC_ABSPATH . 'includes/theme-support/class-wc-twenty-seventeen.php'; + break; + } + } + } + + /** + * Include required frontend files. + */ + public function frontend_includes() { + include_once WC_ABSPATH . 'includes/wc-cart-functions.php'; + include_once WC_ABSPATH . 'includes/wc-notice-functions.php'; + include_once WC_ABSPATH . 'includes/wc-template-hooks.php'; + include_once WC_ABSPATH . 'includes/class-wc-template-loader.php'; + include_once WC_ABSPATH . 'includes/class-wc-frontend-scripts.php'; + include_once WC_ABSPATH . 'includes/class-wc-form-handler.php'; + include_once WC_ABSPATH . 'includes/class-wc-cart.php'; + include_once WC_ABSPATH . 'includes/class-wc-tax.php'; + include_once WC_ABSPATH . 'includes/class-wc-shipping-zones.php'; + include_once WC_ABSPATH . 'includes/class-wc-customer.php'; + include_once WC_ABSPATH . 'includes/class-wc-embed.php'; + include_once WC_ABSPATH . 'includes/class-wc-session-handler.php'; + } + + /** + * Function used to Init WooCommerce Template Functions - This makes them pluggable by plugins and themes. + */ + public function include_template_functions() { + include_once WC_ABSPATH . 'includes/wc-template-functions.php'; + } + + /** + * Init WooCommerce when WordPress Initialises. + */ + public function init() { + // Before init action. + do_action( 'before_woocommerce_init' ); + + // Set up localisation. + $this->load_plugin_textdomain(); + + // Load class instances. + $this->product_factory = new WC_Product_Factory(); + $this->order_factory = new WC_Order_Factory(); + $this->countries = new WC_Countries(); + $this->integrations = new WC_Integrations(); + $this->structured_data = new WC_Structured_Data(); + $this->deprecated_hook_handlers['actions'] = new WC_Deprecated_Action_Hooks(); + $this->deprecated_hook_handlers['filters'] = new WC_Deprecated_Filter_Hooks(); + + // Classes/actions loaded for the frontend and for ajax requests. + if ( $this->is_request( 'frontend' ) ) { + // Session class, handles session data for users - can be overwritten if custom handler is needed. + $session_class = apply_filters( 'woocommerce_session_handler', 'WC_Session_Handler' ); + $this->session = new $session_class(); + $this->session->init(); + + $this->customer = new WC_Customer( get_current_user_id(), true ); + // Cart needs the customer info. + $this->cart = new WC_Cart(); + + // Customer should be saved during shutdown. + add_action( 'shutdown', array( $this->customer, 'save' ), 10 ); + } + + $this->load_webhooks(); + + // Init action. + do_action( 'woocommerce_init' ); + } + + /** + * Load Localisation files. + * + * Note: the first-loaded translation file overrides any following ones if the same translation is present. + * + * Locales found in: + * - WP_LANG_DIR/woocommerce/woocommerce-LOCALE.mo + * - WP_LANG_DIR/plugins/woocommerce-LOCALE.mo + */ + public function load_plugin_textdomain() { + $locale = is_admin() && function_exists( 'get_user_locale' ) ? get_user_locale() : get_locale(); + $locale = apply_filters( 'plugin_locale', $locale, 'woocommerce' ); + + unload_textdomain( 'woocommerce' ); + load_textdomain( 'woocommerce', WP_LANG_DIR . '/woocommerce/woocommerce-' . $locale . '.mo' ); + load_plugin_textdomain( 'woocommerce', false, plugin_basename( dirname( WC_PLUGIN_FILE ) ) . '/i18n/languages' ); + } + + /** + * Ensure theme and server variable compatibility and setup image sizes. + */ + public function setup_environment() { + /* @deprecated 2.2 Use WC()->template_path() instead. */ + $this->define( 'WC_TEMPLATE_PATH', $this->template_path() ); + + $this->add_thumbnail_support(); + } + + /** + * Ensure post thumbnail support is turned on. + */ + private function add_thumbnail_support() { + if ( ! current_theme_supports( 'post-thumbnails' ) ) { + add_theme_support( 'post-thumbnails' ); + } + add_post_type_support( 'product', 'thumbnail' ); + } + + /** + * Add WC Image sizes to WP. + * + * As of 3.3, image sizes can be registered via themes using add_theme_support for woocommerce + * and defining an array of args. If these are not defined, we will use defaults. This is + * handled in wc_get_image_size function. + * + * 3.3 sizes: + * + * woocommerce_thumbnail - Used in product listings. We assume these work for a 3 column grid layout. + * woocommerce_single - Used on single product pages for the main image. + * + * @since 2.3 + */ + public function add_image_sizes() { + $thumbnail = wc_get_image_size( 'thumbnail' ); + $single = wc_get_image_size( 'single' ); + $gallery_thumbnail = wc_get_image_size( 'gallery_thumbnail' ); + + add_image_size( 'woocommerce_thumbnail', $thumbnail['width'], $thumbnail['height'], $thumbnail['crop'] ); + add_image_size( 'woocommerce_single', $single['width'], $single['height'], $single['crop'] ); + add_image_size( 'woocommerce_gallery_thumbnail', $gallery_thumbnail['width'], $gallery_thumbnail['height'], $gallery_thumbnail['crop'] ); + + // Registered for bw compat. @todo remove in 4.0. + add_image_size( 'shop_catalog', $thumbnail['width'], $thumbnail['height'], $thumbnail['crop'] ); + add_image_size( 'shop_single', $single['width'], $single['height'], $single['crop'] ); + add_image_size( 'shop_thumbnail', $gallery_thumbnail['width'], $gallery_thumbnail['height'], $gallery_thumbnail['crop'] ); + } + + /** + * Get the plugin url. + * + * @return string + */ + public function plugin_url() { + return untrailingslashit( plugins_url( '/', WC_PLUGIN_FILE ) ); + } + + /** + * Get the plugin path. + * + * @return string + */ + public function plugin_path() { + return untrailingslashit( plugin_dir_path( WC_PLUGIN_FILE ) ); + } + + /** + * Get the template path. + * + * @return string + */ + public function template_path() { + return apply_filters( 'woocommerce_template_path', 'woocommerce/' ); + } + + /** + * Get Ajax URL. + * + * @return string + */ + public function ajax_url() { + return admin_url( 'admin-ajax.php', 'relative' ); + } + + /** + * Return the WC API URL for a given request. + * + * @param string $request Requested endpoint. + * @param bool|null $ssl If should use SSL, null if should auto detect. Default: null. + * @return string + */ + public function api_request_url( $request, $ssl = null ) { + if ( is_null( $ssl ) ) { + $scheme = wp_parse_url( home_url(), PHP_URL_SCHEME ); + } elseif ( $ssl ) { + $scheme = 'https'; + } else { + $scheme = 'http'; + } + + if ( strstr( get_option( 'permalink_structure' ), '/index.php/' ) ) { + $api_request_url = trailingslashit( home_url( '/index.php/wc-api/' . $request, $scheme ) ); + } elseif ( get_option( 'permalink_structure' ) ) { + $api_request_url = trailingslashit( home_url( '/wc-api/' . $request, $scheme ) ); + } else { + $api_request_url = add_query_arg( 'wc-api', $request, trailingslashit( home_url( '', $scheme ) ) ); + } + + return esc_url_raw( apply_filters( 'woocommerce_api_request_url', $api_request_url, $request, $ssl ) ); + } + + /** + * Load & enqueue active webhooks. + * + * @since 2.2 + */ + private function load_webhooks() { + + if ( ! is_blog_installed() ) { + return; + } + + wc_load_webhooks(); + } + + /** + * WooCommerce Payment Token Meta API and Term/Order item Meta - set table names. + */ + public function wpdb_table_fix() { + global $wpdb; + $wpdb->payment_tokenmeta = $wpdb->prefix . 'woocommerce_payment_tokenmeta'; + $wpdb->order_itemmeta = $wpdb->prefix . 'woocommerce_order_itemmeta'; + $wpdb->tables[] = 'woocommerce_payment_tokenmeta'; + $wpdb->tables[] = 'woocommerce_order_itemmeta'; + + if ( get_option( 'db_version' ) < 34370 ) { + $wpdb->woocommerce_termmeta = $wpdb->prefix . 'woocommerce_termmeta'; + $wpdb->tables[] = 'woocommerce_termmeta'; + } + } + + /** + * Get queue instance. + * + * @return WC_Queue_Interface + */ + public function queue() { + return WC_Queue::instance(); + } + + /** + * Get Checkout Class. + * + * @return WC_Checkout + */ + public function checkout() { + return WC_Checkout::instance(); + } + + /** + * Get gateways class. + * + * @return WC_Payment_Gateways + */ + public function payment_gateways() { + return WC_Payment_Gateways::instance(); + } + + /** + * Get shipping class. + * + * @return WC_Shipping + */ + public function shipping() { + return WC_Shipping::instance(); + } + + /** + * Email Class. + * + * @return WC_Emails + */ + public function mailer() { + return WC_Emails::instance(); + } +} diff --git a/includes/cli/class-wc-cli-rest-command.php b/includes/cli/class-wc-cli-rest-command.php index daad9e4ed73..2b0a218739e 100644 --- a/includes/cli/class-wc-cli-rest-command.php +++ b/includes/cli/class-wc-cli-rest-command.php @@ -1,4 +1,9 @@ desc). + * + * @var array */ private $supported_ids = array(); /** * Sets up REST Command. * - * @param string $name Name of endpoint object (comes from schema) - * @param string $route Path to route of this endpoint - * @param array $schema Schema object + * @param string $name Name of endpoint object (comes from schema). + * @param string $route Path to route of this endpoint. + * @param array $schema Schema object. */ public function __construct( $name, $route, $schema ) { - $this->name = $name; + $this->name = $name; preg_match_all( '#\([^\)]+\)#', $route, $matches ); $first_match = $matches[0]; @@ -76,7 +88,7 @@ class WC_CLI_REST_Command { $this->schema = $schema; $this->resource_identifier = $resource_id; - if ( in_array( $name, $this->routes_with_parent_id ) ) { + if ( in_array( $name, $this->routes_with_parent_id, true ) ) { $is_singular = substr( $this->route, - strlen( $resource_id ) ) === $resource_id; if ( ! $is_singular ) { $this->resource_identifier = $first_match[0]; @@ -87,14 +99,14 @@ class WC_CLI_REST_Command { /** * Passes supported ID arguments (things like product_id, order_id, etc) that we should look for in addition to id. * - * @param array $supported_ids + * @param array $supported_ids List of supported IDs. */ public function set_supported_ids( $supported_ids = array() ) { $this->supported_ids = $supported_ids; } /** - * Peturns an ID of supported ID arguments (things like product_id, order_id, etc) that we should look for in addition to id. + * Returns an ID of supported ID arguments (things like product_id, order_id, etc) that we should look for in addition to id. * * @return array */ @@ -107,11 +119,11 @@ class WC_CLI_REST_Command { * * @subcommand create * - * @param array $args - * @param array $assoc_args + * @param array $args WP-CLI positional arguments. + * @param array $assoc_args WP-CLI associative arguments. */ public function create_item( $args, $assoc_args ) { - $assoc_args = self::decode_json( $assoc_args ); + $assoc_args = self::decode_json( $assoc_args ); list( $status, $body ) = $this->do_request( 'POST', $this->get_filled_route( $args ), $assoc_args ); if ( \WP_CLI\Utils\get_flag_value( $assoc_args, 'porcelain' ) ) { WP_CLI::line( $body['id'] ); @@ -125,8 +137,8 @@ class WC_CLI_REST_Command { * * @subcommand delete * - * @param array $args - * @param array $assoc_args + * @param array $args WP-CLI positional arguments. + * @param array $assoc_args WP-CLI associative arguments. */ public function delete_item( $args, $assoc_args ) { list( $status, $body ) = $this->do_request( 'DELETE', $this->get_filled_route( $args ), $assoc_args ); @@ -146,27 +158,33 @@ class WC_CLI_REST_Command { * * @subcommand get * - * @param array $args - * @param array $assoc_args + * @param array $args WP-CLI positional arguments. + * @param array $assoc_args WP-CLI associative arguments. */ public function get_item( $args, $assoc_args ) { - $route = $this->get_filled_route( $args ); + $route = $this->get_filled_route( $args ); list( $status, $body, $headers ) = $this->do_request( 'GET', $route, $assoc_args ); if ( ! empty( $assoc_args['fields'] ) ) { $body = self::limit_item_to_fields( $body, $assoc_args['fields'] ); } + if ( empty( $assoc_args['format'] ) ) { + $assoc_args['format'] = 'table'; + } + if ( 'headers' === $assoc_args['format'] ) { - echo json_encode( $headers ); + echo wp_json_encode( $headers ); } elseif ( 'body' === $assoc_args['format'] ) { - echo json_encode( $body ); + echo wp_json_encode( $body ); } elseif ( 'envelope' === $assoc_args['format'] ) { - echo json_encode( array( - 'body' => $body, - 'headers' => $headers, - 'status' => $status, - ) ); + echo wp_json_encode( + array( + 'body' => $body, + 'headers' => $headers, + 'status' => $status, + ) + ); } else { $formatter = $this->get_formatter( $assoc_args ); $formatter->display_item( $body ); @@ -178,8 +196,8 @@ class WC_CLI_REST_Command { * * @subcommand list * - * @param array $args - * @param array $assoc_args + * @param array $args WP-CLI positional arguments. + * @param array $assoc_args WP-CLI associative arguments. */ public function list_items( $args, $assoc_args ) { if ( ! empty( $assoc_args['format'] ) && 'count' === $assoc_args['format'] ) { @@ -188,6 +206,10 @@ class WC_CLI_REST_Command { $method = 'GET'; } + if ( ! isset( $assoc_args['per_page'] ) || empty( $assoc_args['per_page'] ) ) { + $assoc_args['per_page'] = '100'; + } + list( $status, $body, $headers ) = $this->do_request( $method, $this->get_filled_route( $args ), $assoc_args ); if ( ! empty( $assoc_args['format'] ) && 'ids' === $assoc_args['format'] ) { $items = array_column( $body, 'id' ); @@ -201,19 +223,25 @@ class WC_CLI_REST_Command { } } + if ( empty( $assoc_args['format'] ) ) { + $assoc_args['format'] = 'table'; + } + if ( ! empty( $assoc_args['format'] ) && 'count' === $assoc_args['format'] ) { echo (int) $headers['X-WP-Total']; } elseif ( 'headers' === $assoc_args['format'] ) { - echo json_encode( $headers ); + echo wp_json_encode( $headers ); } elseif ( 'body' === $assoc_args['format'] ) { - echo json_encode( $body ); + echo wp_json_encode( $body ); } elseif ( 'envelope' === $assoc_args['format'] ) { - echo json_encode( array( - 'body' => $body, - 'headers' => $headers, - 'status' => $status, - 'api_url' => $this->api_url, - ) ); + echo wp_json_encode( + array( + 'body' => $body, + 'headers' => $headers, + 'status' => $status, + 'api_url' => $this->api_url, + ) + ); } else { $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( $items ); @@ -225,11 +253,11 @@ class WC_CLI_REST_Command { * * @subcommand update * - * @param array $args - * @param array $assoc_args + * @param array $args WP-CLI positional arguments. + * @param array $assoc_args WP-CLI associative arguments. */ public function update_item( $args, $assoc_args ) { - $assoc_args = self::decode_json( $assoc_args ); + $assoc_args = self::decode_json( $assoc_args ); list( $status, $body ) = $this->do_request( 'POST', $this->get_filled_route( $args ), $assoc_args ); if ( \WP_CLI\Utils\get_flag_value( $assoc_args, 'porcelain' ) ) { WP_CLI::line( $body['id'] ); @@ -241,18 +269,17 @@ class WC_CLI_REST_Command { /** * Do a REST Request * - * @param string $method - * @param string $route - * @param array $assoc_args + * @param string $method Request method. Examples: 'POST', 'PUT', 'DELETE' or 'GET'. + * @param string $route Resource route. + * @param array $assoc_args Associative arguments passed to the originating WP-CLI command. * * @return array */ private function do_request( $method, $route, $assoc_args ) { - if ( ! defined( 'REST_REQUEST' ) ) { - define( 'REST_REQUEST', true ); - } + wc_maybe_define_constant( 'REST_REQUEST', true ); + $request = new WP_REST_Request( $method, $route ); - if ( in_array( $method, array( 'POST', 'PUT' ) ) ) { + if ( in_array( $method, array( 'POST', 'PUT' ), true ) ) { $request->set_body_params( $assoc_args ); } else { foreach ( $assoc_args as $key => $value ) { @@ -266,19 +293,21 @@ class WC_CLI_REST_Command { if ( defined( 'SAVEQUERIES' ) && SAVEQUERIES ) { $performed_queries = array(); foreach ( (array) $GLOBALS['wpdb']->queries as $key => $query ) { - if ( in_array( $key, $original_queries ) ) { + if ( in_array( $key, $original_queries, true ) ) { continue; } $performed_queries[] = $query; } - usort( $performed_queries, function( $a, $b ) { - if ( $a[1] === $b[1] ) { - return 0; + usort( + $performed_queries, function( $a, $b ) { + if ( $a[1] === $b[1] ) { + return 0; + } + return ( $a[1] > $b[1] ) ? -1 : 1; } - return ( $a[1] > $b[1] ) ? -1 : 1; - }); + ); - $query_count = count( $performed_queries ); + $query_count = count( $performed_queries ); $query_total_time = 0; foreach ( $performed_queries as $query ) { $query_total_time += $query[1]; @@ -288,9 +317,9 @@ class WC_CLI_REST_Command { $slow_query_message .= '. Ordered by slowness, the queries are:' . PHP_EOL; foreach ( $performed_queries as $i => $query ) { $i++; - $bits = explode( ', ', $query[2] ); - $backtrace = implode( ', ', array_slice( $bits, 13 ) ); - $seconds = round( $query[1], 6 ); + $bits = explode( ', ', $query[2] ); + $backtrace = implode( ', ', array_slice( $bits, 13 ) ); + $seconds = round( $query[1], 6 ); $slow_query_message .= <<as_error() ) { + $error = $response->as_error(); + + if ( $error ) { // For authentication errors (status 401), include a reminder to set the --user flag. // WP_CLI::error will only return the first message from WP_Error, so we will pass a string containing both instead. if ( 401 === $response->get_status() ) { @@ -345,13 +376,13 @@ EOT; /** * Get a list of fields present in a given context * - * @param string $context + * @param string $context Scope under which the request is made. Determines fields present in response. * @return array */ private function get_context_fields( $context ) { $fields = array(); foreach ( $this->schema['properties'] as $key => $args ) { - if ( empty( $args['context'] ) || in_array( $context, $args['context'] ) ) { + if ( empty( $args['context'] ) || in_array( $context, $args['context'], true ) ) { $fields[] = $key; } } @@ -361,7 +392,7 @@ EOT; /** * Get the route for this resource * - * @param array $args + * @param array $args Positional arguments passed to the originating WP-CLI command. * @return string */ private function get_filled_route( $args = array() ) { @@ -369,7 +400,7 @@ EOT; $route = $this->route; foreach ( $this->get_supported_ids() as $id_name => $id_desc ) { - if ( strpos( $route, '<' . $id_name . '>' ) !== false && ! empty( $args ) ) { + if ( 'id' !== $id_name && strpos( $route, '<' . $id_name . '>' ) !== false && ! empty( $args ) ) { $route = str_replace( '(?P<' . $id_name . '>[\d]+)', $args[0], $route ); $supported_id_matched = true; } @@ -383,65 +414,11 @@ EOT; return rtrim( $route ); } - /** - * Output a line to be added - * - * @param string - */ - private function add_line( $line ) { - $this->nested_line( $line, 'add' ); - } - - /** - * Output a line to be removed - * - * @param string - */ - private function remove_line( $line ) { - $this->nested_line( $line, 'remove' ); - } - - /** - * Output a line that's appropriately nested - * - * @param string $line - * @param bool|string $change - */ - private function nested_line( $line, $change = false ) { - if ( 'add' == $change ) { - $label = '+ '; - } elseif ( 'remove' == $change ) { - $label = '- '; - } else { - $label = false; - } - - $spaces = ( $this->output_nesting_level * 2 ) + 2; - if ( $label ) { - $line = $label . $line; - $spaces = $spaces - 2; - } - WP_CLI::line( str_pad( ' ', $spaces ) . $line ); - } - - /** - * Whether or not this is an associative array - * - * @param array - * @return bool - */ - private function is_assoc_array( $array ) { - if ( ! is_array( $array ) ) { - return false; - } - return array_keys( $array ) !== range( 0, count( $array ) - 1 ); - } - /** * Reduce an item to specific fields. * - * @param array $item - * @param array $fields + * @param array $item Item to reduce. + * @param array $fields Fields to keep. * @return array */ private static function limit_item_to_fields( $item, $fields ) { @@ -452,7 +429,7 @@ EOT; $fields = explode( ',', $fields ); } foreach ( $item as $i => $field ) { - if ( ! in_array( $i, $fields ) ) { + if ( ! in_array( $i, $fields, true ) ) { unset( $item[ $i ] ); } } @@ -463,7 +440,7 @@ EOT; * JSON can be passed in some more complicated objects, like the payment gateway settings array. * This function decodes the json (if present) and tries to get it's value. * - * @param array $arr + * @param array $arr Array that will be scanned for JSON encoded values. * * @return array */ diff --git a/includes/cli/class-wc-cli-runner.php b/includes/cli/class-wc-cli-runner.php index f34e69f4cb1..a4194b8139b 100644 --- a/includes/cli/class-wc-cli-runner.php +++ b/includes/cli/class-wc-cli-runner.php @@ -1,4 +1,9 @@ __( 'ID.', 'woocommerce' ), - 'product_id' => __( 'Product ID.', 'woocommerce' ), - 'customer_id' => __( 'Customer ID.', 'woocommerce' ), - 'order_id' => __( 'Order ID.', 'woocommerce' ), - 'refund_id' => __( 'Refund ID.', 'woocommerce' ), - 'attribute_id' => __( 'Attribute ID.', 'woocommerce' ), - 'zone_id' => __( 'Zone ID.', 'woocommerce' ), + 'product_id' => __( 'Product ID.', 'woocommerce' ), + 'customer_id' => __( 'Customer ID.', 'woocommerce' ), + 'order_id' => __( 'Order ID.', 'woocommerce' ), + 'refund_id' => __( 'Refund ID.', 'woocommerce' ), + 'attribute_id' => __( 'Attribute ID.', 'woocommerce' ), + 'zone_id' => __( 'Zone ID.', 'woocommerce' ), + 'id' => __( 'ID.', 'woocommerce' ), ); $rest_command->set_supported_ids( $supported_ids ); $positional_args = array_keys( $supported_ids ); - $parent = "wc {$route_data['schema']['title']}"; + $parent = "wc {$route_data['schema']['title']}"; $supported_commands = array(); // Get a list of supported commands for each route. @@ -118,24 +128,24 @@ class WC_CLI_Runner { $trimmed_route = rtrim( $route ); $is_singular = substr( $trimmed_route, - strlen( $resource_id ) ) === $resource_id; - // List a collection - if ( array( 'GET' ) == $endpoint['methods'] && ! $is_singular ) { + // List a collection. + if ( array( 'GET' ) === $endpoint['methods'] && ! $is_singular ) { $supported_commands['list'] = ! empty( $endpoint['args'] ) ? $endpoint['args'] : array(); } - // Create a specific resource - if ( array( 'POST' ) == $endpoint['methods'] && ! $is_singular ) { + // Create a specific resource. + if ( array( 'POST' ) === $endpoint['methods'] && ! $is_singular ) { $supported_commands['create'] = ! empty( $endpoint['args'] ) ? $endpoint['args'] : array(); } - // Get a specific resource - if ( array( 'GET' ) == $endpoint['methods'] && $is_singular ) { + // Get a specific resource. + if ( array( 'GET' ) === $endpoint['methods'] && $is_singular ) { $supported_commands['get'] = ! empty( $endpoint['args'] ) ? $endpoint['args'] : array(); } - // Update a specific resource - if ( in_array( 'POST', $endpoint['methods'] ) && $is_singular ) { + // Update a specific resource. + if ( in_array( 'POST', $endpoint['methods'], true ) && $is_singular ) { $supported_commands['update'] = ! empty( $endpoint['args'] ) ? $endpoint['args'] : array(); } - // Delete a specific resource - if ( array( 'DELETE' ) == $endpoint['methods'] && $is_singular ) { + // Delete a specific resource. + if ( array( 'DELETE' ) === $endpoint['methods'] && $is_singular ) { $supported_commands['delete'] = ! empty( $endpoint['args'] ) ? $endpoint['args'] : array(); } } @@ -153,25 +163,25 @@ class WC_CLI_Runner { 'description' => $id_desc, 'optional' => false, ); - $ids[] = $id_name; + $ids[] = $id_name; } } - if ( in_array( $command, array( 'delete', 'get', 'update' ) ) && ! in_array( 'id', $ids ) ) { + if ( in_array( $command, array( 'delete', 'get', 'update' ), true ) && ! in_array( 'id', $ids, true ) ) { $synopsis[] = array( - 'name' => 'id', - 'type' => 'positional', + 'name' => 'id', + 'type' => 'positional', 'description' => __( 'The id for the resource.', 'woocommerce' ), - 'optional' => false, + 'optional' => false, ); } foreach ( $endpoint_args as $name => $args ) { - if ( ! in_array( $name, $positional_args ) || strpos( $route, '<' . $id_name . '>' ) === false ) { + if ( ! in_array( $name, $positional_args, true ) || strpos( $route, '<' . $id_name . '>' ) === false ) { $arg_regs[] = array( - 'name' => $name, - 'type' => 'assoc', + 'name' => $name, + 'type' => 'assoc', 'description' => ! empty( $args['description'] ) ? $args['description'] : '', - 'optional' => empty( $args['required'] ) ? true : false, + 'optional' => empty( $args['required'] ), ); } } @@ -180,26 +190,26 @@ class WC_CLI_Runner { $synopsis[] = $arg_reg; } - if ( in_array( $command, array( 'list', 'get' ) ) ) { + if ( in_array( $command, array( 'list', 'get' ), true ) ) { $synopsis[] = array( - 'name' => 'fields', - 'type' => 'assoc', + 'name' => 'fields', + 'type' => 'assoc', 'description' => __( 'Limit response to specific fields. Defaults to all fields.', 'woocommerce' ), - 'optional' => true, + 'optional' => true, ); $synopsis[] = array( - 'name' => 'field', - 'type' => 'assoc', + 'name' => 'field', + 'type' => 'assoc', 'description' => __( 'Get the value of an individual field.', 'woocommerce' ), - 'optional' => true, + 'optional' => true, ); $synopsis[] = array( - 'name' => 'format', - 'type' => 'assoc', + 'name' => 'format', + 'type' => 'assoc', 'description' => __( 'Render response in a particular format.', 'woocommerce' ), - 'optional' => true, - 'default' => 'table', - 'options' => array( + 'optional' => true, + 'default' => 'table', + 'options' => array( 'table', 'json', 'csv', @@ -213,12 +223,12 @@ class WC_CLI_Runner { ); } - if ( in_array( $command, array( 'create', 'update', 'delete' ) ) ) { + if ( in_array( $command, array( 'create', 'update', 'delete' ), true ) ) { $synopsis[] = array( - 'name' => 'porcelain', - 'type' => 'flag', + 'name' => 'porcelain', + 'type' => 'flag', 'description' => __( 'Output just the id when the operation is successful.', 'woocommerce' ), - 'optional' => true, + 'optional' => true, ); } @@ -226,24 +236,26 @@ class WC_CLI_Runner { 'list' => 'list_items', 'create' => 'create_item', 'delete' => 'delete_item', - 'get' => 'get_item', + 'get' => 'get_item', 'update' => 'update_item', ); $before_invoke = null; if ( empty( $command_args['when'] ) && \WP_CLI::get_config( 'debug' ) ) { $before_invoke = function() { - if ( ! defined( 'SAVEQUERIES' ) ) { - define( 'SAVEQUERIES', true ); - } + wc_maybe_define_constant( 'SAVEQUERIES', true ); }; } - WP_CLI::add_command( "{$parent} {$command}", array( $rest_command, $methods[ $command ] ), array( - 'synopsis' => $synopsis, - 'when' => ! empty( $command_args['when'] ) ? $command_args['when'] : '', - 'before_invoke' => $before_invoke, - ) ); + WP_CLI::add_command( + "{$parent} {$command}", + array( $rest_command, $methods[ $command ] ), + array( + 'synopsis' => $synopsis, + 'when' => ! empty( $command_args['when'] ) ? $command_args['when'] : '', + 'before_invoke' => $before_invoke, + ) + ); } } } diff --git a/includes/cli/class-wc-cli-tool-command.php b/includes/cli/class-wc-cli-tool-command.php index f2859cd4b12..c3b54334f91 100644 --- a/includes/cli/class-wc-cli-tool-command.php +++ b/includes/cli/class-wc-cli-tool-command.php @@ -1,4 +1,9 @@ dispatch( $request ); $response_data = $response->get_data(); if ( empty( $response_data ) ) { return; } - $parent = "wc tool"; + $parent = 'wc tool'; $supported_commands = array( 'list', 'run' ); foreach ( $supported_commands as $command ) { $synopsis = array(); if ( 'run' === $command ) { $synopsis[] = array( - 'name' => 'id', - 'type' => 'positional', + 'name' => 'id', + 'type' => 'positional', 'description' => __( 'The id for the resource.', 'woocommerce' ), - 'optional' => false, + 'optional' => false, ); - $method = 'update_item'; - $route = '/wc/v1/system_status/tools/(?P[\w-]+)'; + $method = 'update_item'; + $route = '/wc/v2/system_status/tools/(?P[\w-]+)'; } elseif ( 'list' === $command ) { $synopsis[] = array( - 'name' => 'fields', - 'type' => 'assoc', + 'name' => 'fields', + 'type' => 'assoc', 'description' => __( 'Limit response to specific fields. Defaults to all fields.', 'woocommerce' ), 'optional' => true, ); $synopsis[] = array( - 'name' => 'field', - 'type' => 'assoc', + 'name' => 'field', + 'type' => 'assoc', 'description' => __( 'Get the value of an individual field.', 'woocommerce' ), - 'optional' => true, + 'optional' => true, ); $synopsis[] = array( - 'name' => 'format', - 'type' => 'assoc', + 'name' => 'format', + 'type' => 'assoc', 'description' => __( 'Render response in a particular format.', 'woocommerce' ), - 'optional' => true, - 'default' => 'table', - 'options' => array( + 'optional' => true, + 'default' => 'table', + 'options' => array( 'table', 'json', 'csv', @@ -74,26 +79,26 @@ class WC_CLI_Tool_Command { 'envelope', ), ); - $method = 'list_items'; - $route = '/wc/v1/system_status/tools'; + $method = 'list_items'; + $route = '/wc/v2/system_status/tools'; } $before_invoke = null; if ( empty( $command_args['when'] ) && WP_CLI::get_config( 'debug' ) ) { $before_invoke = function() { - if ( ! defined( 'SAVEQUERIES' ) ) { - define( 'SAVEQUERIES', true ); - } + wc_maybe_define_constant( 'SAVEQUERIES', true ); }; } $rest_command = new WC_CLI_REST_Command( 'system_status_tool', $route, $response_data['schema'] ); - WP_CLI::add_command( "{$parent} {$command}", array( $rest_command, $method ), array( - 'synopsis' => $synopsis, - 'when' => ! empty( $command_args['when'] ) ? $command_args['when'] : '', - 'before_invoke' => $before_invoke, - ) ); + WP_CLI::add_command( + "{$parent} {$command}", array( $rest_command, $method ), array( + 'synopsis' => $synopsis, + 'when' => ! empty( $command_args['when'] ) ? $command_args['when'] : '', + 'before_invoke' => $before_invoke, + ) + ); } } diff --git a/includes/cli/class-wc-cli-update-command.php b/includes/cli/class-wc-cli-update-command.php index e338f36fbbb..3c0c1881f5c 100644 --- a/includes/cli/class-wc-cli-update-command.php +++ b/includes/cli/class-wc-cli-update-command.php @@ -1,4 +1,9 @@ hide_errors(); - include_once( WC_ABSPATH . 'includes/class-wc-install.php' ); - include_once( WC_ABSPATH . 'includes/wc-update-functions.php' ); + include_once WC_ABSPATH . 'includes/class-wc-install.php'; + include_once WC_ABSPATH . 'includes/wc-update-functions.php'; $current_db_version = get_option( 'woocommerce_db_version' ); $update_count = 0; @@ -36,6 +41,7 @@ class WC_CLI_Update_Command { foreach ( WC_Install::get_db_update_callbacks() as $version => $update_callbacks ) { if ( version_compare( $current_db_version, $version, '<' ) ) { foreach ( $update_callbacks as $update_callback ) { + /* translators: %s: DB update callback key */ WP_CLI::log( sprintf( __( 'Calling update function: %s', 'woocommerce' ), $update_callback ) ); call_user_func( $update_callback ); $update_count ++; @@ -44,6 +50,7 @@ class WC_CLI_Update_Command { } WC_Admin_Notices::remove_notice( 'update' ); + /* translators: 1: Number of database updates performed 2: Database version number */ WP_CLI::success( sprintf( __( '%1$d updates complete. Database version is %2$s', 'woocommerce' ), absint( $update_count ), get_option( 'woocommerce_db_version' ) ) ); } } diff --git a/includes/customizer/class-wc-customizer-control-cropping.php b/includes/customizer/class-wc-customizer-control-cropping.php new file mode 100644 index 00000000000..675f6980c91 --- /dev/null +++ b/includes/customizer/class-wc-customizer-control-cropping.php @@ -0,0 +1,64 @@ +choices ) ) { + return; + } + + $value = $this->value( 'cropping' ); + $custom_width = $this->value( 'custom_width' ); + $custom_height = $this->value( 'custom_height' ); + ?> + + + label ); ?> + + + description ) ) : ?> + description ); ?> + + +
            + choices as $key => $radio ) : ?> +
          • + link( 'cropping' ); ?> /> + + + + + link( 'custom_width' ); ?> /> : link( 'custom_height' ); ?> /> + + +
            • + +
          + add_panel( 'woocommerce', array( + 'priority' => 200, + 'capability' => 'manage_woocommerce', + 'theme_supports' => '', + 'title' => __( 'WooCommerce', 'woocommerce' ), + ) ); + + $this->add_store_notice_section( $wp_customize ); + $this->add_product_catalog_section( $wp_customize ); + $this->add_product_images_section( $wp_customize ); + $this->add_checkout_section( $wp_customize ); + } + + /** + * Frontend CSS styles. + */ + public function add_frontend_scripts() { + if ( ! is_customize_preview() || ! is_store_notice_showing() ) { + return; + } + + $css = '.woocommerce-store-notice, p.demo_store { display: block !important; }'; + wp_add_inline_style( 'customize-preview', $css ); + } + + /** + * CSS styles to improve our form. + */ + public function add_styles() { + ?> + + + + __( 'Default sorting (custom ordering + name)', 'woocommerce' ), + 'popularity' => __( 'Popularity (sales)', 'woocommerce' ), + 'rating' => __( 'Average rating', 'woocommerce' ), + 'date' => __( 'Sort by most recent', 'woocommerce' ), + 'price' => __( 'Sort by price (asc)', 'woocommerce' ), + 'price-desc' => __( 'Sort by price (desc)', 'woocommerce' ), + ) ); + + return array_key_exists( $value, $options ) ? $value : 'menu_order'; + } + + /** + * Store notice section. + * + * @param WP_Customize_Manager $wp_customize Theme Customizer object. + */ + private function add_store_notice_section( $wp_customize ) { + $wp_customize->add_section( + 'woocommerce_store_notice', + array( + 'title' => __( 'Store Notice', 'woocommerce' ), + 'priority' => 10, + 'panel' => 'woocommerce', + ) + ); + + $wp_customize->add_setting( + 'woocommerce_demo_store', + array( + 'default' => 'no', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'wc_bool_to_string', + 'sanitize_js_callback' => 'wc_string_to_bool', + ) + ); + + $wp_customize->add_setting( + 'woocommerce_demo_store_notice', + array( + 'default' => __( 'This is a demo store for testing purposes — no orders shall be fulfilled.', 'woocommerce' ), + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'wp_kses_post', + 'transport' => 'postMessage', + ) + ); + + $wp_customize->add_control( + 'woocommerce_demo_store_notice', + array( + 'label' => __( 'Store notice', 'woocommerce' ), + 'description' => __( 'If enabled, this text will be shown site-wide. You can use it to show events or promotions to visitors!', 'woocommerce' ), + 'section' => 'woocommerce_store_notice', + 'settings' => 'woocommerce_demo_store_notice', + 'type' => 'textarea', + ) + ); + + $wp_customize->add_control( + 'woocommerce_demo_store', + array( + 'label' => __( 'Enable store notice', 'woocommerce' ), + 'section' => 'woocommerce_store_notice', + 'settings' => 'woocommerce_demo_store', + 'type' => 'checkbox', + ) + ); + + if ( isset( $wp_customize->selective_refresh ) ) { + $wp_customize->selective_refresh->add_partial( + 'woocommerce_demo_store_notice', array( + 'selector' => '.woocommerce-store-notice', + 'container_inclusive' => true, + 'render_callback' => 'woocommerce_demo_store', + ) + ); + } + } + + /** + * Product catalog section. + * + * @param WP_Customize_Manager $wp_customize Theme Customizer object. + */ + public function add_product_catalog_section( $wp_customize ) { + $wp_customize->add_section( + 'woocommerce_product_catalog', + array( + 'title' => __( 'Product Catalog', 'woocommerce' ), + 'priority' => 10, + 'panel' => 'woocommerce', + ) + ); + + $wp_customize->add_setting( + 'woocommerce_shop_page_display', + array( + 'default' => '', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => array( $this, 'sanitize_archive_display' ), + ) + ); + + $wp_customize->add_control( + 'woocommerce_shop_page_display', + array( + 'label' => __( 'Shop page display', 'woocommerce' ), + 'description' => __( 'Choose what to display on the main shop page.', 'woocommerce' ), + 'section' => 'woocommerce_product_catalog', + 'settings' => 'woocommerce_shop_page_display', + 'type' => 'select', + 'choices' => array( + '' => __( 'Show products', 'woocommerce' ), + 'subcategories' => __( 'Show categories', 'woocommerce' ), + 'both' => __( 'Show categories & products', 'woocommerce' ), + ), + ) + ); + + $wp_customize->add_setting( + 'woocommerce_category_archive_display', + array( + 'default' => '', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => array( $this, 'sanitize_archive_display' ), + ) + ); + + $wp_customize->add_control( + 'woocommerce_category_archive_display', + array( + 'label' => __( 'Category display', 'woocommerce' ), + 'description' => __( 'Choose what to display on product category pages.', 'woocommerce' ), + 'section' => 'woocommerce_product_catalog', + 'settings' => 'woocommerce_category_archive_display', + 'type' => 'select', + 'choices' => array( + '' => __( 'Show products', 'woocommerce' ), + 'subcategories' => __( 'Show subcategories', 'woocommerce' ), + 'both' => __( 'Show subcategories & products', 'woocommerce' ), + ), + ) + ); + + $wp_customize->add_setting( + 'woocommerce_default_catalog_orderby', + array( + 'default' => 'menu_order', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => array( $this, 'sanitize_default_catalog_orderby' ), + ) + ); + + $wp_customize->add_control( + 'woocommerce_default_catalog_orderby', + array( + 'label' => __( 'Default product sorting', 'woocommerce' ), + 'description' => __( 'How should products be sorted in the catalog by default?', 'woocommerce' ), + 'section' => 'woocommerce_product_catalog', + 'settings' => 'woocommerce_default_catalog_orderby', + 'type' => 'select', + 'choices' => apply_filters( 'woocommerce_default_catalog_orderby_options', array( + 'menu_order' => __( 'Default sorting (custom ordering + name)', 'woocommerce' ), + 'popularity' => __( 'Popularity (sales)', 'woocommerce' ), + 'rating' => __( 'Average rating', 'woocommerce' ), + 'date' => __( 'Sort by most recent', 'woocommerce' ), + 'price' => __( 'Sort by price (asc)', 'woocommerce' ), + 'price-desc' => __( 'Sort by price (desc)', 'woocommerce' ), + ) ), + ) + ); + + // The following settings should be hidden if the theme is declaring the values. + if ( has_filter( 'loop_shop_columns' ) ) { + return; + } + + $wp_customize->add_setting( + 'woocommerce_catalog_columns', + array( + 'default' => 4, + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'absint', + 'sanitize_js_callback' => 'absint', + ) + ); + + $wp_customize->add_control( + 'woocommerce_catalog_columns', + array( + 'label' => __( 'Products per row', 'woocommerce' ), + 'description' => __( 'How many products should be shown per row?', 'woocommerce' ), + 'section' => 'woocommerce_product_catalog', + 'settings' => 'woocommerce_catalog_columns', + 'type' => 'number', + 'input_attrs' => array( + 'min' => wc_get_theme_support( 'product_grid::min_columns', 1 ), + 'max' => wc_get_theme_support( 'product_grid::max_columns', '' ), + 'step' => 1, + ), + ) + ); + + // Only add this setting if something else isn't managing the number of products per page. + if ( ! has_filter( 'loop_shop_per_page' ) ) { + $wp_customize->add_setting( + 'woocommerce_catalog_rows', + array( + 'default' => 4, + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'absint', + 'sanitize_js_callback' => 'absint', + ) + ); + } + + $wp_customize->add_control( + 'woocommerce_catalog_rows', + array( + 'label' => __( 'Rows per page', 'woocommerce' ), + 'description' => __( 'How many rows of products should be shown per page?', 'woocommerce' ), + 'section' => 'woocommerce_product_catalog', + 'settings' => 'woocommerce_catalog_rows', + 'type' => 'number', + 'input_attrs' => array( + 'min' => wc_get_theme_support( 'product_grid::min_rows', 1 ), + 'max' => wc_get_theme_support( 'product_grid::max_rows', '' ), + 'step' => 1, + ), + ) + ); + } + + /** + * Product images section. + * + * @param WP_Customize_Manager $wp_customize Theme Customizer object. + */ + private function add_product_images_section( $wp_customize ) { + if ( class_exists( 'Jetpack' ) && Jetpack::is_module_active( 'photon' ) ) { + $regen_description = ''; // Nothing to report; Jetpack will handle magically. + } elseif ( apply_filters( 'woocommerce_background_image_regeneration', true ) && ! is_multisite() ) { + $regen_description = __( 'After publishing your changes, new image sizes will be generated automatically.', 'woocommerce' ); + } elseif ( apply_filters( 'woocommerce_background_image_regeneration', true ) && is_multisite() ) { + /* translators: 1: tools URL 2: regen thumbs url */ + $regen_description = sprintf( __( 'After publishing your changes, new image sizes may not be shown until you regenerate thumbnails. You can do this from the tools section in WooCommerce or by using a plugin such as Regenerate Thumbnails.', 'woocommerce' ), admin_url( 'admin.php?page=wc-status&tab=tools' ), 'https://en-gb.wordpress.org/plugins/regenerate-thumbnails/' ); + } else { + /* translators: %s: regen thumbs url */ + $regen_description = sprintf( __( 'After publishing your changes, new image sizes may not be shown until you Regenerate Thumbnails.', 'woocommerce' ), 'https://en-gb.wordpress.org/plugins/regenerate-thumbnails/' ); + } + + $wp_customize->add_section( + 'woocommerce_product_images', + array( + 'title' => __( 'Product Images', 'woocommerce' ), + 'description' => $regen_description, + 'priority' => 20, + 'panel' => 'woocommerce', + ) + ); + + if ( ! wc_get_theme_support( 'single_image_width' ) ) { + $wp_customize->add_setting( + 'woocommerce_single_image_width', + array( + 'default' => 600, + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'absint', + 'sanitize_js_callback' => 'absint', + ) + ); + + $wp_customize->add_control( + 'woocommerce_single_image_width', + array( + 'label' => __( 'Main image width', 'woocommerce' ), + 'description' => __( 'Image size used for the main image on single product pages. These images will remain uncropped.', 'woocommerce' ), + 'section' => 'woocommerce_product_images', + 'settings' => 'woocommerce_single_image_width', + 'type' => 'number', + 'input_attrs' => array( + 'min' => 0, + 'step' => 1, + ), + ) + ); + } + + if ( ! wc_get_theme_support( 'thumbnail_image_width' ) ) { + $wp_customize->add_setting( + 'woocommerce_thumbnail_image_width', + array( + 'default' => 300, + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'absint', + 'sanitize_js_callback' => 'absint', + ) + ); + + $wp_customize->add_control( + 'woocommerce_thumbnail_image_width', + array( + 'label' => __( 'Thumbnail width', 'woocommerce' ), + 'description' => __( 'Image size used for products in the catalog.', 'woocommerce' ), + 'section' => 'woocommerce_product_images', + 'settings' => 'woocommerce_thumbnail_image_width', + 'type' => 'number', + 'input_attrs' => array( + 'min' => 0, + 'step' => 1, + ), + ) + ); + } + + include_once WC_ABSPATH . 'includes/customizer/class-wc-customizer-control-cropping.php'; + + $wp_customize->add_setting( + 'woocommerce_thumbnail_cropping', + array( + 'default' => '1:1', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'wc_clean', + ) + ); + + $wp_customize->add_setting( + 'woocommerce_thumbnail_cropping_custom_width', + array( + 'default' => '4', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'absint', + 'sanitize_js_callback' => 'absint', + ) + ); + + $wp_customize->add_setting( + 'woocommerce_thumbnail_cropping_custom_height', + array( + 'default' => '3', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'absint', + 'sanitize_js_callback' => 'absint', + ) + ); + + $wp_customize->add_control( + new WC_Customizer_Control_Cropping( + $wp_customize, + 'woocommerce_thumbnail_cropping', + array( + 'section' => 'woocommerce_product_images', + 'settings' => array( + 'cropping' => 'woocommerce_thumbnail_cropping', + 'custom_width' => 'woocommerce_thumbnail_cropping_custom_width', + 'custom_height' => 'woocommerce_thumbnail_cropping_custom_height', + ), + 'label' => __( 'Thumbnail cropping', 'woocommerce' ), + 'choices' => array( + '1:1' => array( + 'label' => __( '1:1', 'woocommerce' ), + 'description' => __( 'Images will be cropped into a square', 'woocommerce' ), + ), + 'custom' => array( + 'label' => __( 'Custom', 'woocommerce' ), + 'description' => __( 'Images will be cropped to a custom aspect ratio', 'woocommerce' ), + ), + 'uncropped' => array( + 'label' => __( 'Uncropped', 'woocommerce' ), + 'description' => __( 'Images will display using the aspect ratio in which they were uploaded', 'woocommerce' ), + ), + ), + ) + ) + ); + } + + /** + * Checkout section. + * + * @param WP_Customize_Manager $wp_customize Theme Customizer object. + */ + public function add_checkout_section( $wp_customize ) { + $wp_customize->add_section( + 'woocommerce_checkout', + array( + 'title' => __( 'Checkout', 'woocommerce' ), + 'priority' => 20, + 'panel' => 'woocommerce', + 'description' => __( 'These options let you change the appearance of the WooCommerce checkout.', 'woocommerce' ), + ) + ); + + // Checkout field controls. + $fields = array( + 'company' => __( 'Company name', 'woocommerce' ), + 'address_2' => __( 'Address line 2', 'woocommerce' ), + 'phone' => __( 'Phone', 'woocommerce' ), + ); + foreach ( $fields as $field => $label ) { + $wp_customize->add_setting( + 'woocommerce_checkout_' . $field . '_field', + array( + 'default' => 'phone' === $field ? 'required' : 'optional', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => array( $this, 'sanitize_checkout_field_display' ), + ) + ); + $wp_customize->add_control( + 'woocommerce_checkout_' . $field . '_field', + array( + /* Translators: %s field name. */ + 'label' => sprintf( __( '%s field', 'woocommerce' ), $label ), + 'section' => 'woocommerce_checkout', + 'settings' => 'woocommerce_checkout_' . $field . '_field', + 'type' => 'select', + 'choices' => array( + 'hidden' => __( 'Hidden', 'woocommerce' ), + 'optional' => __( 'Optional', 'woocommerce' ), + 'required' => __( 'Required', 'woocommerce' ), + ), + ) + ); + } + + // Register settings. + $wp_customize->add_setting( + 'woocommerce_checkout_highlight_required_fields', + array( + 'default' => 'yes', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'wc_bool_to_string', + 'sanitize_js_callback' => 'wc_string_to_bool', + ) + ); + + $wp_customize->add_setting( + 'woocommerce_checkout_terms_and_conditions_checkbox_text', + array( + /* translators: %s terms and conditions page name and link */ + 'default' => sprintf( __( 'I have read and agree to the website %s', 'woocommerce' ), '[terms]' ), + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'wp_kses_post', + 'transport' => 'postMessage', + ) + ); + + $wp_customize->add_setting( + 'woocommerce_checkout_privacy_policy_text', + array( + /* translators: %s privacy policy page name and link */ + 'default' => sprintf( __( 'Your personal data will be used to process your order, support your experience throughout this website, and for other purposes described in our %s.', 'woocommerce' ), '[privacy_policy]' ), + 'type' => 'option', + 'capability' => 'manage_woocommerce', + 'sanitize_callback' => 'wp_kses_post', + 'transport' => 'postMessage', + ) + ); + + // Register controls. + $wp_customize->add_control( + 'woocommerce_checkout_highlight_required_fields', + array( + 'label' => __( 'Highlight required fields with an asterisk', 'woocommerce' ), + 'section' => 'woocommerce_checkout', + 'settings' => 'woocommerce_checkout_highlight_required_fields', + 'type' => 'checkbox', + ) + ); + + $choose_pages = array( + 'wp_page_for_privacy_policy' => __( 'Privacy policy', 'woocommerce' ), + 'woocommerce_terms_page_id' => __( 'Terms and conditions', 'woocommerce' ), + ); + $pages = get_pages( array( + 'post_type' => 'page', + 'post_status' => 'publish,private,draft', + 'child_of' => 0, + 'parent' => -1, + 'exclude' => array( + wc_get_page_id( 'cart' ), + wc_get_page_id( 'checkout' ), + wc_get_page_id( 'myaccount' ), + ), + 'sort_order' => 'asc', + 'sort_column' => 'post_title', + ) ); + $page_choices = array( '' => __( 'No page set', 'woocommerce' ) ) + array_combine( array_map( 'strval', wp_list_pluck( $pages, 'ID' ) ), wp_list_pluck( $pages, 'post_title' ) ); + + foreach ( $choose_pages as $id => $name ) { + $wp_customize->add_setting( + $id, + array( + 'default' => '', + 'type' => 'option', + 'capability' => 'manage_woocommerce', + ) + ); + $wp_customize->add_control( + $id, + array( + /* Translators: %s: page name. */ + 'label' => sprintf( __( '%s page', 'woocommerce' ), $name ), + 'section' => 'woocommerce_checkout', + 'settings' => $id, + 'type' => 'select', + 'choices' => $page_choices, + ) + ); + } + + $wp_customize->add_control( + 'woocommerce_checkout_privacy_policy_text', + array( + 'label' => __( 'Privacy policy', 'woocommerce' ), + 'description' => __( 'Optionally add some text about your store privacy policy to show during checkout.', 'woocommerce' ), + 'section' => 'woocommerce_checkout', + 'settings' => 'woocommerce_checkout_privacy_policy_text', + 'active_callback' => 'wc_privacy_policy_page_id', + 'type' => 'textarea', + ) + ); + + $wp_customize->add_control( + 'woocommerce_checkout_terms_and_conditions_checkbox_text', + array( + 'label' => __( 'Terms and conditions', 'woocommerce' ), + 'description' => __( 'Optionally add some text for the terms checkbox that customers must accept.', 'woocommerce' ), + 'section' => 'woocommerce_checkout', + 'settings' => 'woocommerce_checkout_terms_and_conditions_checkbox_text', + 'active_callback' => 'wc_terms_and_conditions_page_id', + 'type' => 'text', + ) + ); + + if ( isset( $wp_customize->selective_refresh ) ) { + $wp_customize->selective_refresh->add_partial( + 'woocommerce_checkout_privacy_policy_text', array( + 'selector' => '.woocommerce-privacy-policy-text', + 'container_inclusive' => true, + 'render_callback' => 'wc_checkout_privacy_policy_text', + ) + ); + $wp_customize->selective_refresh->add_partial( + 'woocommerce_checkout_terms_and_conditions_checkbox_text', array( + 'selector' => '.woocommerce-terms-and-conditions-checkbox-text', + 'container_inclusive' => false, + 'render_callback' => 'wc_terms_and_conditions_checkbox_text', + ) + ); + } + } + + /** + * Sanitize field display. + * + * @param string $value '', 'subcategories', or 'both'. + * @return string + */ + public function sanitize_checkout_field_display( $value ) { + $options = array( 'hidden', 'optional', 'required' ); + return in_array( $value, $options, true ) ? $value : ''; + } +} + +new WC_Shop_Customizer(); diff --git a/includes/data-stores/abstract-wc-order-data-store-cpt.php b/includes/data-stores/abstract-wc-order-data-store-cpt.php index 4ba1553ed87..0d6208887da 100644 --- a/includes/data-stores/abstract-wc-order-data-store-cpt.php +++ b/includes/data-stores/abstract-wc-order-data-store-cpt.php @@ -1,4 +1,10 @@ set_version( WC_VERSION ); $order->set_date_created( current_time( 'timestamp', true ) ); $order->set_currency( $order->get_currency() ? $order->get_currency() : get_woocommerce_currency() ); - $id = wp_insert_post( apply_filters( 'woocommerce_new_order_data', array( - 'post_date' => gmdate( 'Y-m-d H:i:s', $order->get_date_created( 'edit' )->getOffsetTimestamp() ), - 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $order->get_date_created( 'edit' )->getTimestamp() ), - 'post_type' => $order->get_type( 'edit' ), - 'post_status' => 'wc-' . ( $order->get_status( 'edit' ) ? $order->get_status( 'edit' ) : apply_filters( 'woocommerce_default_order_status', 'pending' ) ), - 'ping_status' => 'closed', - 'post_author' => 1, - 'post_title' => $this->get_post_title(), - 'post_password' => uniqid( 'order_' ), - 'post_parent' => $order->get_parent_id( 'edit' ), - 'post_excerpt' => $this->get_post_excerpt( $order ), - ) ), true ); + $id = wp_insert_post( + apply_filters( + 'woocommerce_new_order_data', + array( + 'post_date' => gmdate( 'Y-m-d H:i:s', $order->get_date_created( 'edit' )->getOffsetTimestamp() ), + 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $order->get_date_created( 'edit' )->getTimestamp() ), + 'post_type' => $order->get_type( 'edit' ), + 'post_status' => 'wc-' . ( $order->get_status( 'edit' ) ? $order->get_status( 'edit' ) : apply_filters( 'woocommerce_default_order_status', 'pending' ) ), + 'ping_status' => 'closed', + 'post_author' => is_callable( array( $order, 'get_customer_id' ) ) ? $order->get_customer_id() : 0, + 'post_title' => $this->get_post_title(), + 'post_password' => uniqid( 'order_' ), + 'post_parent' => $order->get_parent_id( 'edit' ), + 'post_excerpt' => $this->get_post_excerpt( $order ), + ) + ), true + ); if ( $id && ! is_wp_error( $id ) ) { $order->set_id( $id ); @@ -78,23 +88,26 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Method to read an order from the database. * - * @param WC_Data $order + * @param WC_Data $order Order object. * - * @throws Exception + * @throws Exception If passed order is invalid. */ public function read( &$order ) { $order->set_defaults(); + $post_object = get_post( $order->get_id() ); - if ( ! $order->get_id() || ! ( $post_object = get_post( $order->get_id() ) ) || ! in_array( $post_object->post_type, wc_get_order_types() ) ) { + if ( ! $order->get_id() || ! $post_object || ! in_array( $post_object->post_type, wc_get_order_types(), true ) ) { throw new Exception( __( 'Invalid order.', 'woocommerce' ) ); } - $order->set_props( array( - 'parent_id' => $post_object->post_parent, - 'date_created' => 0 < $post_object->post_date_gmt ? wc_string_to_timestamp( $post_object->post_date_gmt ) : null, - 'date_modified' => 0 < $post_object->post_modified_gmt ? wc_string_to_timestamp( $post_object->post_modified_gmt ) : null, - 'status' => $post_object->post_status, - ) ); + $order->set_props( + array( + 'parent_id' => $post_object->post_parent, + 'date_created' => 0 < $post_object->post_date_gmt ? wc_string_to_timestamp( $post_object->post_date_gmt ) : null, + 'date_modified' => 0 < $post_object->post_modified_gmt ? wc_string_to_timestamp( $post_object->post_modified_gmt ) : null, + 'status' => $post_object->post_status, + ) + ); $this->read_order_data( $order, $post_object ); $order->read_meta_data(); @@ -112,16 +125,21 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Method to update an order in the database. - * @param WC_Order $order + * + * @param WC_Order $order Order object. */ public function update( &$order ) { $order->save_meta_data(); $order->set_version( WC_VERSION ); + if ( null === $order->get_date_created( 'edit' ) ) { + $order->set_date_created( current_time( 'timestamp', true ) ); + } + $changes = $order->get_changes(); // Only update the post when the post data changes. - if ( array_intersect( array( 'date_created', 'date_modified', 'status', 'parent_id', 'post_excerpt' ), array_keys( $changes ) ) ) { + if ( array_intersect( array( 'date_created', 'date_modified', 'status', 'parent_id', 'post_excerpt', 'customer_id' ), array_keys( $changes ) ) ) { $post_data = array( 'post_date' => gmdate( 'Y-m-d H:i:s', $order->get_date_created( 'edit' )->getOffsetTimestamp() ), 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $order->get_date_created( 'edit' )->getTimestamp() ), @@ -130,6 +148,7 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme 'post_excerpt' => $this->get_post_excerpt( $order ), 'post_modified' => isset( $changes['date_modified'] ) ? gmdate( 'Y-m-d H:i:s', $order->get_date_modified( 'edit' )->getOffsetTimestamp() ) : current_time( 'mysql' ), 'post_modified_gmt' => isset( $changes['date_modified'] ) ? gmdate( 'Y-m-d H:i:s', $order->get_date_modified( 'edit' )->getTimestamp() ) : current_time( 'mysql', 1 ), + 'post_author' => is_callable( array( $order, 'get_customer_id' ) ) ? $order->get_customer_id() : 0, ); /** @@ -147,22 +166,43 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme wp_update_post( array_merge( array( 'ID' => $order->get_id() ), $post_data ) ); } $order->read_meta_data( true ); // Refresh internal meta data, in case things were hooked into `save_post` or another WP hook. + + // If customer changed, update any downloadable permissions. + if ( in_array( 'customer_id', $changes ) ) { + $this->update_downloadable_permissions( $order ); + } } $this->update_post_meta( $order ); $order->apply_changes(); $this->clear_caches( $order ); } + /** + * Update downloadable permissions for a given order. + * + * @param WC_Order $order Order object. + */ + protected function update_downloadable_permissions( $order ) { + $data_store = WC_Data_Store::load( 'customer-download' ); + $data_store->update_user_by_order_id( $order->get_id(), $order->get_customer_id(), $order->get_billing_email() ); + } + /** * Method to delete an order from the database. - * @param WC_Order $order - * @param array $args Array of args to pass to the delete method. + * + * @param WC_Order $order Order object. + * @param array $args Array of args to pass to the delete method. + * + * @return void */ public function delete( &$order, $args = array() ) { $id = $order->get_id(); - $args = wp_parse_args( $args, array( - 'force_delete' => false, - ) ); + $args = wp_parse_args( + $args, + array( + 'force_delete' => false, + ) + ); if ( ! $id ) { return; @@ -188,7 +228,7 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Excerpt for post. * - * @param WC_order $order + * @param WC_order $order Order object. * @return string */ protected function get_post_excerpt( $order ) { @@ -210,24 +250,26 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Read order data. Can be overridden by child classes to load other props. * - * @param WC_Order - * @param object $post_object + * @param WC_Order $order Order object. + * @param object $post_object Post object. * @since 3.0.0 */ protected function read_order_data( &$order, $post_object ) { $id = $order->get_id(); - $order->set_props( array( - 'currency' => get_post_meta( $id, '_order_currency', true ), - 'discount_total' => get_post_meta( $id, '_cart_discount', true ), - 'discount_tax' => get_post_meta( $id, '_cart_discount_tax', true ), - 'shipping_total' => get_post_meta( $id, '_order_shipping', true ), - 'shipping_tax' => get_post_meta( $id, '_order_shipping_tax', true ), - 'cart_tax' => get_post_meta( $id, '_order_tax', true ), - 'total' => get_post_meta( $id, '_order_total', true ), - 'version' => get_post_meta( $id, '_order_version', true ), - 'prices_include_tax' => metadata_exists( 'post', $id, '_prices_include_tax' ) ? 'yes' === get_post_meta( $id, '_prices_include_tax', true ) : 'yes' === get_option( 'woocommerce_prices_include_tax' ), - ) ); + $order->set_props( + array( + 'currency' => get_post_meta( $id, '_order_currency', true ), + 'discount_total' => get_post_meta( $id, '_cart_discount', true ), + 'discount_tax' => get_post_meta( $id, '_cart_discount_tax', true ), + 'shipping_total' => get_post_meta( $id, '_order_shipping', true ), + 'shipping_tax' => get_post_meta( $id, '_order_shipping_tax', true ), + 'cart_tax' => get_post_meta( $id, '_order_tax', true ), + 'total' => get_post_meta( $id, '_order_total', true ), + 'version' => get_post_meta( $id, '_order_version', true ), + 'prices_include_tax' => metadata_exists( 'post', $id, '_prices_include_tax' ) ? 'yes' === get_post_meta( $id, '_prices_include_tax', true ) : 'yes' === get_option( 'woocommerce_prices_include_tax' ), + ) + ); // Gets extra data associated with the order if needed. foreach ( $order->get_extra_data_keys() as $key ) { @@ -241,7 +283,7 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Helper method that updates all the post meta for an order based on it's settings in the WC_Order class. * - * @param $order WC_Order + * @param WC_Order $order Order object. * @since 3.0.0 */ protected function update_post_meta( &$order ) { @@ -278,7 +320,7 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Clear any caches. * - * @param WC_Order + * @param WC_Order $order Order object. * @since 3.0.0 */ protected function clear_caches( &$order ) { @@ -290,23 +332,26 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Read order items of a specific type from the database for this order. * - * @param WC_Order $order - * @param string $type + * @param WC_Order $order Order object. + * @param string $type Order item type. * @return array */ public function read_items( $order, $type ) { global $wpdb; // Get from cache if available. - $items = wp_cache_get( 'order-items-' . $order->get_id(), 'orders' ); + $items = 0 < $order->get_id() ? wp_cache_get( 'order-items-' . $order->get_id(), 'orders' ) : false; if ( false === $items ) { - $get_items_sql = $wpdb->prepare( "SELECT order_item_type, order_item_id, order_id, order_item_name FROM {$wpdb->prefix}woocommerce_order_items WHERE order_id = %d ORDER BY order_item_id;", $order->get_id() ); - $items = $wpdb->get_results( $get_items_sql ); + $items = $wpdb->get_results( + $wpdb->prepare( "SELECT order_item_type, order_item_id, order_id, order_item_name FROM {$wpdb->prefix}woocommerce_order_items WHERE order_id = %d ORDER BY order_item_id;", $order->get_id() ) + ); foreach ( $items as $item ) { wp_cache_set( 'item-' . $item->order_item_id, $item, 'order-items' ); } - wp_cache_set( 'order-items-' . $order->get_id(), $items, 'orders' ); + if ( 0 < $order->get_id() ) { + wp_cache_set( 'order-items-' . $order->get_id(), $items, 'orders' ); + } } $items = wp_list_filter( $items, array( 'order_item_type' => $type ) ); @@ -323,8 +368,8 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Remove all line items (products, coupons, shipping, taxes) from the order. * - * @param WC_Order - * @param string $type Order item type. Default null. + * @param WC_Order $order Order object. + * @param string $type Order item type. Default null. */ public function delete_items( $order, $type = null ) { global $wpdb; @@ -341,7 +386,7 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Get token ids for an order. * - * @param WC_Order + * @param WC_Order $order Order object. * @return array */ public function get_payment_token_ids( $order ) { @@ -352,8 +397,8 @@ abstract class Abstract_WC_Order_Data_Store_CPT extends WC_Data_Store_WP impleme /** * Update token ids for an order. * - * @param WC_Order - * @param array $token_ids + * @param WC_Order $order Order object. + * @param array $token_ids Payment token ids. */ public function update_payment_token_ids( $order, $token_ids ) { update_post_meta( $order->get_id(), '_payment_tokens', $token_ids ); diff --git a/includes/data-stores/abstract-wc-order-item-type-data-store.php b/includes/data-stores/abstract-wc-order-item-type-data-store.php index 61d8e71de46..99beda776d5 100644 --- a/includes/data-stores/abstract-wc-order-item-type-data-store.php +++ b/includes/data-stores/abstract-wc-order-item-type-data-store.php @@ -1,4 +1,10 @@ insert( $wpdb->prefix . 'woocommerce_order_items', array( - 'order_item_name' => $item->get_name(), - 'order_item_type' => $item->get_type(), - 'order_id' => $item->get_order_id(), - ) ); + $wpdb->insert( + $wpdb->prefix . 'woocommerce_order_items', array( + 'order_item_name' => $item->get_name(), + 'order_item_type' => $item->get_type(), + 'order_id' => $item->get_order_id(), + ) + ); $item->set_id( $wpdb->insert_id ); $this->save_item_data( $item ); $item->save_meta_data(); @@ -54,7 +63,7 @@ abstract class Abstract_WC_Order_Item_Type_Data_Store extends WC_Data_Store_WP i * Update a order item in the database. * * @since 3.0.0 - * @param WC_Order_Item $item + * @param WC_Order_Item $item Order item object. */ public function update( &$item ) { global $wpdb; @@ -62,11 +71,13 @@ abstract class Abstract_WC_Order_Item_Type_Data_Store extends WC_Data_Store_WP i $changes = $item->get_changes(); if ( array_intersect( array( 'name', 'order_id' ), array_keys( $changes ) ) ) { - $wpdb->update( $wpdb->prefix . 'woocommerce_order_items', array( - 'order_item_name' => $item->get_name(), - 'order_item_type' => $item->get_type(), - 'order_id' => $item->get_order_id(), - ), array( 'order_item_id' => $item->get_id() ) ); + $wpdb->update( + $wpdb->prefix . 'woocommerce_order_items', array( + 'order_item_name' => $item->get_name(), + 'order_item_type' => $item->get_type(), + 'order_id' => $item->get_order_id(), + ), array( 'order_item_id' => $item->get_id() ) + ); } $this->save_item_data( $item ); @@ -81,8 +92,8 @@ abstract class Abstract_WC_Order_Item_Type_Data_Store extends WC_Data_Store_WP i * Remove an order item from the database. * * @since 3.0.0 - * @param WC_Order_Item $item - * @param array $args Array of args to pass to the delete method. + * @param WC_Order_Item $item Order item object. + * @param array $args Array of args to pass to the delete method. */ public function delete( &$item, $args = array() ) { if ( $item->get_id() ) { @@ -91,6 +102,7 @@ abstract class Abstract_WC_Order_Item_Type_Data_Store extends WC_Data_Store_WP i $wpdb->delete( $wpdb->prefix . 'woocommerce_order_items', array( 'order_item_id' => $item->get_id() ) ); $wpdb->delete( $wpdb->prefix . 'woocommerce_order_itemmeta', array( 'order_item_id' => $item->get_id() ) ); do_action( 'woocommerce_delete_order_item', $item->get_id() ); + $this->clear_cache( $item ); } } @@ -99,9 +111,9 @@ abstract class Abstract_WC_Order_Item_Type_Data_Store extends WC_Data_Store_WP i * * @since 3.0.0 * - * @param WC_Order_Item $item + * @param WC_Order_Item $item Order item object. * - * @throws Exception + * @throws Exception If invalid order item. */ public function read( &$item ) { global $wpdb; @@ -120,10 +132,12 @@ abstract class Abstract_WC_Order_Item_Type_Data_Store extends WC_Data_Store_WP i throw new Exception( __( 'Invalid order item.', 'woocommerce' ) ); } - $item->set_props( array( - 'order_id' => $data->order_id, - 'name' => $data->order_item_name, - ) ); + $item->set_props( + array( + 'order_id' => $data->order_id, + 'name' => $data->order_item_name, + ) + ); $item->read_meta_data(); } @@ -132,16 +146,18 @@ abstract class Abstract_WC_Order_Item_Type_Data_Store extends WC_Data_Store_WP i * Ran after both create and update, so $item->get_id() will be set. * * @since 3.0.0 - * @param WC_Order_Item $item + * @param WC_Order_Item $item Order item object. */ public function save_item_data( &$item ) {} /** - * Clear meta cachce. + * Clear meta cache. * - * @param WC_Order_Item $item + * @param WC_Order_Item $item Order item object. */ public function clear_cache( &$item ) { wp_cache_delete( 'item-' . $item->get_id(), 'order-items' ); + wp_cache_delete( 'order-items-' . $item->get_order_id(), 'orders' ); + wp_cache_delete( $item->get_id(), $this->meta_type . '_meta' ); } } diff --git a/includes/data-stores/class-wc-coupon-data-store-cpt.php b/includes/data-stores/class-wc-coupon-data-store-cpt.php index cbeebcb749f..507dd0d063c 100644 --- a/includes/data-stores/class-wc-coupon-data-store-cpt.php +++ b/includes/data-stores/class-wc-coupon-data-store-cpt.php @@ -1,4 +1,10 @@ set_date_created( current_time( 'timestamp', true ) ); - $coupon_id = wp_insert_post( apply_filters( 'woocommerce_new_coupon_data', array( - 'post_type' => 'shop_coupon', - 'post_status' => 'publish', - 'post_author' => get_current_user_id(), - 'post_title' => $coupon->get_code( 'edit' ), - 'post_content' => '', - 'post_excerpt' => $coupon->get_description( 'edit' ), - 'post_date' => gmdate( 'Y-m-d H:i:s', $coupon->get_date_created()->getOffsetTimestamp() ), - 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $coupon->get_date_created()->getTimestamp() ), - ) ), true ); + $coupon_id = wp_insert_post( + apply_filters( + 'woocommerce_new_coupon_data', + array( + 'post_type' => 'shop_coupon', + 'post_status' => 'publish', + 'post_author' => get_current_user_id(), + 'post_title' => $coupon->get_code( 'edit' ), + 'post_content' => '', + 'post_excerpt' => $coupon->get_description( 'edit' ), + 'post_date' => gmdate( 'Y-m-d H:i:s', $coupon->get_date_created()->getOffsetTimestamp() ), + 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $coupon->get_date_created()->getTimestamp() ), + ) + ), true + ); if ( $coupon_id ) { $coupon->set_id( $coupon_id ); $this->update_post_meta( $coupon ); $coupon->save_meta_data(); $coupon->apply_changes(); + delete_transient( 'rest_api_coupons_type_count' ); do_action( 'woocommerce_new_coupon', $coupon_id ); } } @@ -82,42 +94,46 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * * @since 3.0.0 * - * @param WC_Data $coupon + * @param WC_Coupon $coupon Coupon object. * - * @throws Exception + * @throws Exception If invalid coupon. */ public function read( &$coupon ) { $coupon->set_defaults(); - if ( ! $coupon->get_id() || ! ( $post_object = get_post( $coupon->get_id() ) ) || 'shop_coupon' !== $post_object->post_type ) { + $post_object = get_post( $coupon->get_id() ); + + if ( ! $coupon->get_id() || ! $post_object || 'shop_coupon' !== $post_object->post_type ) { throw new Exception( __( 'Invalid coupon.', 'woocommerce' ) ); } $coupon_id = $coupon->get_id(); - $coupon->set_props( array( - 'code' => $post_object->post_title, - 'description' => $post_object->post_excerpt, - 'date_created' => 0 < $post_object->post_date_gmt ? wc_string_to_timestamp( $post_object->post_date_gmt ) : null, - 'date_modified' => 0 < $post_object->post_modified_gmt ? wc_string_to_timestamp( $post_object->post_modified_gmt ) : null, - 'date_expires' => metadata_exists( 'post', $coupon_id, 'date_expires' ) ? get_post_meta( $coupon_id, 'date_expires', true ) : get_post_meta( $coupon_id, 'expiry_date', true ), - 'discount_type' => get_post_meta( $coupon_id, 'discount_type', true ), - 'amount' => get_post_meta( $coupon_id, 'coupon_amount', true ), - 'usage_count' => get_post_meta( $coupon_id, 'usage_count', true ), - 'individual_use' => 'yes' === get_post_meta( $coupon_id, 'individual_use', true ), - 'product_ids' => array_filter( (array) explode( ',', get_post_meta( $coupon_id, 'product_ids', true ) ) ), - 'excluded_product_ids' => array_filter( (array) explode( ',', get_post_meta( $coupon_id, 'exclude_product_ids', true ) ) ), - 'usage_limit' => get_post_meta( $coupon_id, 'usage_limit', true ), - 'usage_limit_per_user' => get_post_meta( $coupon_id, 'usage_limit_per_user', true ), - 'limit_usage_to_x_items' => 0 < get_post_meta( $coupon_id, 'limit_usage_to_x_items', true ) ? get_post_meta( $coupon_id, 'limit_usage_to_x_items', true ) : null, - 'free_shipping' => 'yes' === get_post_meta( $coupon_id, 'free_shipping', true ), - 'product_categories' => array_filter( (array) get_post_meta( $coupon_id, 'product_categories', true ) ), - 'excluded_product_categories' => array_filter( (array) get_post_meta( $coupon_id, 'exclude_product_categories', true ) ), - 'exclude_sale_items' => 'yes' === get_post_meta( $coupon_id, 'exclude_sale_items', true ), - 'minimum_amount' => get_post_meta( $coupon_id, 'minimum_amount', true ), - 'maximum_amount' => get_post_meta( $coupon_id, 'maximum_amount', true ), - 'email_restrictions' => array_filter( (array) get_post_meta( $coupon_id, 'customer_email', true ) ), - 'used_by' => array_filter( (array) get_post_meta( $coupon_id, '_used_by' ) ), - ) ); + $coupon->set_props( + array( + 'code' => $post_object->post_title, + 'description' => $post_object->post_excerpt, + 'date_created' => 0 < $post_object->post_date_gmt ? wc_string_to_timestamp( $post_object->post_date_gmt ) : null, + 'date_modified' => 0 < $post_object->post_modified_gmt ? wc_string_to_timestamp( $post_object->post_modified_gmt ) : null, + 'date_expires' => metadata_exists( 'post', $coupon_id, 'date_expires' ) ? get_post_meta( $coupon_id, 'date_expires', true ) : get_post_meta( $coupon_id, 'expiry_date', true ), + 'discount_type' => get_post_meta( $coupon_id, 'discount_type', true ), + 'amount' => get_post_meta( $coupon_id, 'coupon_amount', true ), + 'usage_count' => get_post_meta( $coupon_id, 'usage_count', true ), + 'individual_use' => 'yes' === get_post_meta( $coupon_id, 'individual_use', true ), + 'product_ids' => array_filter( (array) explode( ',', get_post_meta( $coupon_id, 'product_ids', true ) ) ), + 'excluded_product_ids' => array_filter( (array) explode( ',', get_post_meta( $coupon_id, 'exclude_product_ids', true ) ) ), + 'usage_limit' => get_post_meta( $coupon_id, 'usage_limit', true ), + 'usage_limit_per_user' => get_post_meta( $coupon_id, 'usage_limit_per_user', true ), + 'limit_usage_to_x_items' => 0 < get_post_meta( $coupon_id, 'limit_usage_to_x_items', true ) ? get_post_meta( $coupon_id, 'limit_usage_to_x_items', true ) : null, + 'free_shipping' => 'yes' === get_post_meta( $coupon_id, 'free_shipping', true ), + 'product_categories' => array_filter( (array) get_post_meta( $coupon_id, 'product_categories', true ) ), + 'excluded_product_categories' => array_filter( (array) get_post_meta( $coupon_id, 'exclude_product_categories', true ) ), + 'exclude_sale_items' => 'yes' === get_post_meta( $coupon_id, 'exclude_sale_items', true ), + 'minimum_amount' => get_post_meta( $coupon_id, 'minimum_amount', true ), + 'maximum_amount' => get_post_meta( $coupon_id, 'maximum_amount', true ), + 'email_restrictions' => array_filter( (array) get_post_meta( $coupon_id, 'customer_email', true ) ), + 'used_by' => array_filter( (array) get_post_meta( $coupon_id, '_used_by' ) ), + ) + ); $coupon->read_meta_data(); $coupon->set_object_read( true ); do_action( 'woocommerce_coupon_loaded', $coupon ); @@ -127,7 +143,7 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * Updates a coupon in the database. * * @since 3.0.0 - * @param WC_Coupon $coupon + * @param WC_Coupon $coupon Coupon object. */ public function update( &$coupon ) { $coupon->save_meta_data(); @@ -140,7 +156,7 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat 'post_date' => gmdate( 'Y-m-d H:i:s', $coupon->get_date_created( 'edit' )->getOffsetTimestamp() ), 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $coupon->get_date_created( 'edit' )->getTimestamp() ), 'post_modified' => isset( $changes['date_modified'] ) ? gmdate( 'Y-m-d H:i:s', $coupon->get_date_modified( 'edit' )->getOffsetTimestamp() ) : current_time( 'mysql' ), - 'post_modified_gmt' => isset( $changes['date_modified'] ) ? gmdate( 'Y-m-d H:i:s', $coupon->get_date_modified( 'edit' )->getTimestamp() ) : current_time( 'mysql', 1 ), + 'post_modified_gmt' => isset( $changes['date_modified'] ) ? gmdate( 'Y-m-d H:i:s', $coupon->get_date_modified( 'edit' )->getTimestamp() ) : current_time( 'mysql', 1 ), ); /** @@ -161,6 +177,7 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat } $this->update_post_meta( $coupon ); $coupon->apply_changes(); + delete_transient( 'rest_api_coupons_type_count' ); do_action( 'woocommerce_update_coupon', $coupon->get_id() ); } @@ -169,13 +186,15 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * * @since 3.0.0 * - * @param WC_Coupon $coupon + * @param WC_Coupon $coupon Coupon object. * @param array $args Array of args to pass to the delete method. */ public function delete( &$coupon, $args = array() ) { - $args = wp_parse_args( $args, array( - 'force_delete' => false, - ) ); + $args = wp_parse_args( + $args, array( + 'force_delete' => false, + ) + ); $id = $coupon->get_id(); @@ -185,6 +204,9 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat if ( $args['force_delete'] ) { wp_delete_post( $id ); + + wp_cache_delete( WC_Cache_Helper::get_cache_prefix( 'coupons' ) . 'coupon_id_from_code_' . $coupon->get_code(), 'coupons' ); + $coupon->set_id( 0 ); do_action( 'woocommerce_delete_coupon', $id ); } else { @@ -196,7 +218,7 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat /** * Helper method that updates all the post meta for a coupon based on it's settings in the WC_Coupon class. * - * @param WC_Coupon + * @param WC_Coupon $coupon Coupon object. * @since 3.0.0 */ private function update_post_meta( &$coupon ) { @@ -211,7 +233,7 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat 'usage_limit_per_user' => 'usage_limit_per_user', 'limit_usage_to_x_items' => 'limit_usage_to_x_items', 'usage_count' => 'usage_count', - 'date_expires' => 'date_expires', + 'date_expires' => 'date_expires', 'free_shipping' => 'free_shipping', 'product_categories' => 'product_categories', 'exclude_product_categories' => 'excluded_product_categories', @@ -225,27 +247,27 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat foreach ( $props_to_update as $meta_key => $prop ) { $value = $coupon->{"get_$prop"}( 'edit' ); switch ( $prop ) { - case 'individual_use' : - case 'free_shipping' : - case 'exclude_sale_items' : + case 'individual_use': + case 'free_shipping': + case 'exclude_sale_items': $updated = update_post_meta( $coupon->get_id(), $meta_key, wc_bool_to_string( $value ) ); break; - case 'product_ids' : - case 'excluded_product_ids' : + case 'product_ids': + case 'excluded_product_ids': $updated = update_post_meta( $coupon->get_id(), $meta_key, implode( ',', array_filter( array_map( 'intval', $value ) ) ) ); break; - case 'product_categories' : - case 'excluded_product_categories' : + case 'product_categories': + case 'excluded_product_categories': $updated = update_post_meta( $coupon->get_id(), $meta_key, array_filter( array_map( 'intval', $value ) ) ); break; - case 'email_restrictions' : + case 'email_restrictions': $updated = update_post_meta( $coupon->get_id(), $meta_key, array_filter( array_map( 'sanitize_email', $value ) ) ); break; - case 'date_expires' : + case 'date_expires': $updated = update_post_meta( $coupon->get_id(), $meta_key, ( $value ? $value->getTimestamp() : null ) ); update_post_meta( $coupon->get_id(), 'expiry_date', ( $value ? $value->date( 'Y-m-d' ) : '' ) ); // Update the old meta key for backwards compatibility. break; - default : + default: $updated = update_post_meta( $coupon->get_id(), $meta_key, $value ); break; } @@ -261,9 +283,9 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * Increase usage count for current coupon. * * @since 3.0.0 - * @param WC_Coupon - * @param string $used_by Either user ID or billing email - * @return int New usage count + * @param WC_Coupon $coupon Coupon object. + * @param string $used_by Either user ID or billing email. + * @return int New usage count. */ public function increase_usage_count( &$coupon, $used_by = '' ) { $new_count = $this->update_usage_count_meta( $coupon, 'increase' ); @@ -271,6 +293,9 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat add_post_meta( $coupon->get_id(), '_used_by', strtolower( $used_by ) ); $coupon->set_used_by( (array) get_post_meta( $coupon->get_id(), '_used_by' ) ); } + + do_action( 'woocommerce_increase_coupon_usage_count', $coupon, $new_count, $used_by ); + return $new_count; } @@ -278,9 +303,9 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * Decrease usage count for current coupon. * * @since 3.0.0 - * @param WC_Coupon - * @param string $used_by Either user ID or billing email - * @return int New usage count + * @param WC_Coupon $coupon Coupon object. + * @param string $used_by Either user ID or billing email. + * @return int New usage count. */ public function decrease_usage_count( &$coupon, $used_by = '' ) { global $wpdb; @@ -296,6 +321,9 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat $coupon->set_used_by( (array) get_post_meta( $coupon->get_id(), '_used_by' ) ); } } + + do_action( 'woocommerce_decrease_coupon_usage_count', $coupon, $new_count, $used_by ); + return $new_count; } @@ -303,17 +331,22 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * Increase or decrease the usage count for a coupon by 1. * * @since 3.0.0 - * @param WC_Coupon - * @param string $operation 'increase' or 'decrease' + * @param WC_Coupon $coupon Coupon object. + * @param string $operation 'increase' or 'decrease'. * @return int New usage count */ private function update_usage_count_meta( &$coupon, $operation = 'increase' ) { global $wpdb; - $id = $coupon->get_id(); + $id = $coupon->get_id(); $operator = ( 'increase' === $operation ) ? '+' : '-'; add_post_meta( $id, 'usage_count', $coupon->get_usage_count( 'edit' ), true ); - $wpdb->query( $wpdb->prepare( "UPDATE $wpdb->postmeta SET meta_value = meta_value {$operator} 1 WHERE meta_key = 'usage_count' AND post_id = %d;", $id ) ); + $wpdb->query( + $wpdb->prepare( + "UPDATE $wpdb->postmeta SET meta_value = meta_value {$operator} 1 WHERE meta_key = 'usage_count' AND post_id = %d;", // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $id + ) + ); // Get the latest value direct from the DB, instead of possibly the WP meta cache. return (int) $wpdb->get_var( $wpdb->prepare( "SELECT meta_value FROM $wpdb->postmeta WHERE meta_key = 'usage_count' AND post_id = %d;", $id ) ); @@ -323,8 +356,8 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * Get the number of uses for a coupon by user ID. * * @since 3.0.0 - * @param WC_Coupon - * @param id $user_id + * @param WC_Coupon $coupon Coupon object. + * @param id $user_id User ID. * @return int */ public function get_usage_by_user_id( &$coupon, $user_id ) { @@ -336,18 +369,21 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * Return a coupon code for a specific ID. * * @since 3.0.0 - * @param int $id + * @param int $id Coupon ID. * @return string Coupon Code */ public function get_code_by_id( $id ) { global $wpdb; - return $wpdb->get_var( $wpdb->prepare( " - SELECT post_title - FROM $wpdb->posts - WHERE ID = %d - AND post_type = 'shop_coupon' - AND post_status = 'publish'; - ", $id ) ); + return $wpdb->get_var( + $wpdb->prepare( + "SELECT post_title + FROM $wpdb->posts + WHERE ID = %d + AND post_type = 'shop_coupon' + AND post_status = 'publish'", + $id + ) + ); } /** @@ -355,11 +391,16 @@ class WC_Coupon_Data_Store_CPT extends WC_Data_Store_WP implements WC_Coupon_Dat * Can return multiple to check for existence. * * @since 3.0.0 - * @param string $code + * @param string $code Coupon code. * @return array Array of IDs. */ public function get_ids_by_code( $code ) { global $wpdb; - return $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_title = %s AND post_type = 'shop_coupon' AND post_status = 'publish' ORDER BY post_date DESC;", $code ) ); + return $wpdb->get_col( + $wpdb->prepare( + "SELECT ID FROM $wpdb->posts WHERE post_title = %s AND post_type = 'shop_coupon' AND post_status = 'publish' ORDER BY post_date DESC", + $code + ) + ); } } diff --git a/includes/data-stores/class-wc-customer-data-store-session.php b/includes/data-stores/class-wc-customer-data-store-session.php index bbce155c2a7..adaa2aca2e9 100644 --- a/includes/data-stores/class-wc-customer-data-store-session.php +++ b/includes/data-stores/class-wc-customer-data-store-session.php @@ -1,4 +1,10 @@ save_to_session( $customer ); @@ -56,7 +62,7 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust /** * Simply update the session. * - * @param WC_Customer $customer + * @param WC_Customer $customer Customer object. */ public function update( &$customer ) { $this->save_to_session( $customer ); @@ -65,7 +71,7 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust /** * Saves all customer data to the session. * - * @param WC_Customer $customer + * @param WC_Customer $customer Customer object. */ public function save_to_session( $customer ) { $data = array(); @@ -74,11 +80,9 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust if ( 'billing_' === substr( $session_key, 0, 8 ) ) { $session_key = str_replace( 'billing_', '', $session_key ); } - $data[ $session_key ] = $customer->{"get_$function_key"}( 'edit' ); - } - if ( WC()->session->get( 'customer' ) !== $data ) { - WC()->session->set( 'customer', $data ); + $data[ $session_key ] = (string) $customer->{"get_$function_key"}( 'edit' ); } + WC()->session->set( 'customer', $data ); } /** @@ -86,18 +90,27 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust * which case the stored ID will differ from the actual ID. * * @since 3.0.0 - * @param WC_Customer $customer + * @param WC_Customer $customer Customer object. */ public function read( &$customer ) { $data = (array) WC()->session->get( 'customer' ); - if ( ! empty( $data ) && isset( $data['id'] ) && $data['id'] === $customer->get_id() ) { + + /** + * There is a valid session if $data is not empty, and the ID matches the logged in user ID. + * + * If the user object has been updated since the session was created (based on date_modified) we should not load the session - data should be reloaded. + */ + if ( isset( $data['id'], $data['date_modified'] ) && $data['id'] === (string) $customer->get_id() && $data['date_modified'] === (string) $customer->get_date_modified( 'edit' ) ) { foreach ( $this->session_keys as $session_key ) { + if ( in_array( $session_key, array( 'id', 'date_modified' ), true ) ) { + continue; + } $function_key = $session_key; if ( 'billing_' === substr( $session_key, 0, 8 ) ) { $session_key = str_replace( 'billing_', '', $session_key ); } if ( ! empty( $data[ $session_key ] ) && is_callable( array( $customer, "set_{$function_key}" ) ) ) { - $customer->{"set_{$function_key}"}( $data[ $session_key ] ); + $customer->{"set_{$function_key}"}( wp_unslash( $data[ $session_key ] ) ); } } } @@ -108,7 +121,7 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust /** * Load default values if props are unset. * - * @param WC_Customer $customer + * @param WC_Customer $customer Customer object. */ protected function set_defaults( &$customer ) { try { @@ -134,15 +147,16 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust $current_user = wp_get_current_user(); $customer->set_billing_email( $current_user->user_email ); } - } catch ( WC_Data_Exception $e ) {} + } catch ( WC_Data_Exception $e ) { // phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedCatch + } } /** * Deletes a customer from the database. * * @since 3.0.0 - * @param WC_Customer $customer - * @param array $args Array of args to pass to the delete method. + * @param WC_Customer $customer Customer object. + * @param array $args Array of args to pass to the delete method. */ public function delete( &$customer, $args = array() ) { WC()->session->set( 'customer', null ); @@ -152,7 +166,7 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust * Gets the customers last order. * * @since 3.0.0 - * @param WC_Customer + * @param WC_Customer $customer Customer object. * @return WC_Order|false */ public function get_last_order( &$customer ) { @@ -163,7 +177,7 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust * Return the number of orders this customer has. * * @since 3.0.0 - * @param WC_Customer + * @param WC_Customer $customer Customer object. * @return integer */ public function get_order_count( &$customer ) { @@ -174,7 +188,7 @@ class WC_Customer_Data_Store_Session extends WC_Data_Store_WP implements WC_Cust * Return how much money this customer has spent. * * @since 3.0.0 - * @param WC_Customer + * @param WC_Customer $customer Customer object. * @return float */ public function get_total_spent( &$customer ) { diff --git a/includes/data-stores/class-wc-customer-data-store.php b/includes/data-stores/class-wc-customer-data-store.php index d6596487d5c..8ad38340b3f 100644 --- a/includes/data-stores/class-wc-customer-data-store.php +++ b/includes/data-stores/class-wc-customer-data-store.php @@ -1,4 +1,10 @@ prefix ? $wpdb->prefix : 'wp_'; - return ! in_array( $meta->meta_key, $this->internal_meta_keys ) + return ! in_array( $meta->meta_key, $this->internal_meta_keys, true ) && 0 !== strpos( $meta->meta_key, '_woocommerce_persistent_cart' ) && 0 !== strpos( $meta->meta_key, 'closedpostboxes_' ) && 0 !== strpos( $meta->meta_key, 'metaboxhidden_' ) && 0 !== strpos( $meta->meta_key, 'manageedit-' ) && ! strstr( $meta->meta_key, $table_prefix ) && 0 !== stripos( $meta->meta_key, 'wp_' ); - } + } /** * Method to create a new customer in the database. * * @since 3.0.0 * - * @param WC_Data $customer + * @param WC_Customer $customer Customer object. * - * @throws WC_Data_Exception + * @throws WC_Data_Exception If unable to create new customer. */ public function create( &$customer ) { $id = wc_create_new_customer( $customer->get_email(), $customer->get_username(), $customer->get_password() ); @@ -107,14 +112,18 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat $customer->set_id( $id ); $this->update_user_meta( $customer ); - // Prevent wp_update_user calls in the same request and customer trigger the 'Notice of Password Changed' email + // Prevent wp_update_user calls in the same request and customer trigger the 'Notice of Password Changed' email. $customer->set_password( '' ); - wp_update_user( apply_filters( 'woocommerce_update_customer_args', array( - 'ID' => $customer->get_id(), - 'role' => $customer->get_role(), - 'display_name' => $customer->get_first_name() . ' ' . $customer->get_last_name(), - ), $customer ) ); + wp_update_user( + apply_filters( + 'woocommerce_update_customer_args', array( + 'ID' => $customer->get_id(), + 'role' => $customer->get_role(), + 'display_name' => $customer->get_display_name(), + ), $customer + ) + ); $wp_user = new WP_User( $customer->get_id() ); $customer->set_date_created( $wp_user->user_registered ); $customer->set_date_modified( get_user_meta( $customer->get_id(), 'last_update', true ) ); @@ -127,12 +136,14 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat * Method to read a customer object. * * @since 3.0.0 - * @param WC_Customer $customer - * @throws Exception + * @param WC_Customer $customer Customer object. + * @throws Exception If invalid customer. */ public function read( &$customer ) { + $user_object = $customer->get_id() ? get_user_by( 'id', $customer->get_id() ) : false; + // User object is required. - if ( ! $customer->get_id() || ! ( $user_object = get_user_by( 'id', $customer->get_id() ) ) || empty( $user_object->ID ) ) { + if ( ! $user_object || empty( $user_object->ID ) ) { throw new Exception( __( 'Invalid customer.', 'woocommerce' ) ); } @@ -142,18 +153,25 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat } $customer_id = $customer->get_id(); + // Load meta but exclude deprecated props. - $user_meta = array_diff_key( array_map( 'wc_flatten_meta_callback', get_user_meta( $customer_id ) ), array_flip( array( 'country', 'state', 'postcode', 'city', 'address', 'address_2', 'default', 'location' ) ) ); + $user_meta = array_diff_key( + array_map( 'wc_flatten_meta_callback', get_user_meta( $customer_id ) ), + array_flip( array( 'country', 'state', 'postcode', 'city', 'address', 'address_2', 'default', 'location' ) ) + ); + $customer->set_props( $user_meta ); - $customer->set_props( array( - 'is_paying_customer' => get_user_meta( $customer_id, 'paying_customer', true ), - 'email' => $user_object->user_email, - 'username' => $user_object->user_login, - 'display_name' => $user_object->display_name, - 'date_created' => $user_object->user_registered, // Mysql string in local format. - 'date_modified' => get_user_meta( $customer_id, 'last_update', true ), - 'role' => ! empty( $user_object->roles[0] ) ? $user_object->roles[0] : 'customer', - ) ); + $customer->set_props( + array( + 'is_paying_customer' => get_user_meta( $customer_id, 'paying_customer', true ), + 'email' => $user_object->user_email, + 'username' => $user_object->user_login, + 'display_name' => $user_object->display_name, + 'date_created' => $user_object->user_registered, // Mysql string in local format. + 'date_modified' => get_user_meta( $customer_id, 'last_update', true ), + 'role' => ! empty( $user_object->roles[0] ) ? $user_object->roles[0] : 'customer', + ) + ); $customer->read_meta_data(); $customer->set_object_read( true ); do_action( 'woocommerce_customer_loaded', $customer ); @@ -163,19 +181,30 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat * Updates a customer in the database. * * @since 3.0.0 - * @param WC_Customer $customer + * @param WC_Customer $customer Customer object. */ public function update( &$customer ) { - wp_update_user( apply_filters( 'woocommerce_update_customer_args', array( - 'ID' => $customer->get_id(), - 'user_email' => $customer->get_email(), - 'display_name' => $customer->get_display_name(), - ), $customer ) ); + wp_update_user( + apply_filters( + 'woocommerce_update_customer_args', array( + 'ID' => $customer->get_id(), + 'user_email' => $customer->get_email(), + 'display_name' => $customer->get_display_name(), + ), $customer + ) + ); + // Only update password if a new one was set with set_password. if ( $customer->get_password() ) { - wp_update_user( array( 'ID' => $customer->get_id(), 'user_pass' => $customer->get_password() ) ); + wp_update_user( + array( + 'ID' => $customer->get_id(), + 'user_pass' => $customer->get_password(), + ) + ); $customer->set_password( '' ); } + $this->update_user_meta( $customer ); $customer->set_date_modified( get_user_meta( $customer->get_id(), 'last_update', true ) ); $customer->save_meta_data(); @@ -187,16 +216,19 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat * Deletes a customer from the database. * * @since 3.0.0 - * @param WC_Customer $customer - * @param array $args Array of args to pass to the delete method. + * @param WC_Customer $customer Customer object. + * @param array $args Array of args to pass to the delete method. */ public function delete( &$customer, $args = array() ) { if ( ! $customer->get_id() ) { return; } - $args = wp_parse_args( $args, array( - 'reassign' => 0, - ) ); + + $args = wp_parse_args( + $args, array( + 'reassign' => 0, + ) + ); $id = $customer->get_id(); wp_delete_user( $id, $args['reassign'] ); @@ -206,8 +238,9 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat /** * Helper method that updates all the meta for a customer. Used for update & create. + * * @since 3.0.0 - * @param WC_Customer + * @param WC_Customer $customer Customer object. */ private function update_user_meta( $customer ) { $updated_props = array(); @@ -245,9 +278,11 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat foreach ( $billing_address_props as $meta_key => $prop ) { $prop_key = substr( $prop, 8 ); + if ( ! isset( $changed_props['billing'] ) || ! array_key_exists( $prop_key, $changed_props['billing'] ) ) { continue; } + if ( update_user_meta( $customer->get_id(), $meta_key, $customer->{"get_$prop"}( 'edit' ) ) ) { $updated_props[] = $prop; } @@ -267,9 +302,11 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat foreach ( $shipping_address_props as $meta_key => $prop ) { $prop_key = substr( $prop, 9 ); + if ( ! isset( $changed_props['shipping'] ) || ! array_key_exists( $prop_key, $changed_props['shipping'] ) ) { continue; } + if ( update_user_meta( $customer->get_id(), $meta_key, $customer->{"get_$prop"}( 'edit' ) ) ) { $updated_props[] = $prop; } @@ -282,34 +319,46 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat * Gets the customers last order. * * @since 3.0.0 - * @param WC_Customer + * @param WC_Customer $customer Customer object. * @return WC_Order|false */ public function get_last_order( &$customer ) { global $wpdb; - $last_order = $wpdb->get_var( "SELECT posts.ID + // On WC 3.5.0 the ID of the user that placed the order was moved from the post meta _customer_user to the post_author field in the wp_posts table. + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '>=' ) ) { + $query = "SELECT ID + FROM $wpdb->posts + WHERE post_author = '" . esc_sql( $customer->get_id() ) . "' + AND post_type = 'shop_order' + AND post_status IN ( '" . implode( "','", array_map( 'esc_sql', array_keys( wc_get_order_statuses() ) ) ) . "' ) + ORDER BY ID DESC"; + } else { + $query = "SELECT posts.ID FROM $wpdb->posts AS posts LEFT JOIN {$wpdb->postmeta} AS meta on posts.ID = meta.post_id WHERE meta.meta_key = '_customer_user' AND meta.meta_value = '" . esc_sql( $customer->get_id() ) . "' AND posts.post_type = 'shop_order' AND posts.post_status IN ( '" . implode( "','", array_map( 'esc_sql', array_keys( wc_get_order_statuses() ) ) ) . "' ) - ORDER BY posts.ID DESC - " ); + ORDER BY posts.ID DESC"; + } - if ( $last_order ) { - return wc_get_order( absint( $last_order ) ); - } else { + // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $last_order = $wpdb->get_var( $query ); + + if ( ! $last_order ) { return false; } + + return wc_get_order( absint( $last_order ) ); } /** * Return the number of orders this customer has. * * @since 3.0.0 - * @param WC_Customer + * @param WC_Customer $customer Customer object. * @return integer */ public function get_order_count( &$customer ) { @@ -318,14 +367,25 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat if ( '' === $count ) { global $wpdb; - $count = $wpdb->get_var( "SELECT COUNT(*) + // On WC 3.5.0 the ID of the user that placed the order was moved from the post meta _customer_user to the post_author field in the wp_posts table. + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '>=' ) ) { + $query = "SELECT COUNT(*) + FROM $wpdb->posts + WHERE post_type = 'shop_order' + AND post_status IN ( '" . implode( "','", array_map( 'esc_sql', array_keys( wc_get_order_statuses() ) ) ) . "' ) + AND post_author = " . esc_sql( $customer->get_id() ); + } else { + $query = "SELECT COUNT(*) FROM $wpdb->posts as posts LEFT JOIN {$wpdb->postmeta} AS meta ON posts.ID = meta.post_id WHERE meta.meta_key = '_customer_user' AND posts.post_type = 'shop_order' AND posts.post_status IN ( '" . implode( "','", array_map( 'esc_sql', array_keys( wc_get_order_statuses() ) ) ) . "' ) - AND meta_value = '" . esc_sql( $customer->get_id() ) . "' - " ); + AND meta_value = '" . esc_sql( $customer->get_id() ) . "'"; + } + + // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $count = $wpdb->get_var( $query ); update_user_meta( $customer->get_id(), '_order_count', $count ); } @@ -336,26 +396,44 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat * Return how much money this customer has spent. * * @since 3.0.0 - * @param WC_Customer + * @param WC_Customer $customer Customer object. * @return float */ public function get_total_spent( &$customer ) { - $spent = apply_filters( 'woocommerce_customer_get_total_spent', get_user_meta( $customer->get_id(), '_money_spent', true ), $customer ); + $spent = apply_filters( + 'woocommerce_customer_get_total_spent', + get_user_meta( $customer->get_id(), '_money_spent', true ), + $customer + ); if ( '' === $spent ) { global $wpdb; $statuses = array_map( 'esc_sql', wc_get_is_paid_statuses() ); - $spent = $wpdb->get_var( apply_filters( 'woocommerce_customer_get_total_spent_query', "SELECT SUM(meta2.meta_value) - FROM $wpdb->posts as posts - LEFT JOIN {$wpdb->postmeta} AS meta ON posts.ID = meta.post_id - LEFT JOIN {$wpdb->postmeta} AS meta2 ON posts.ID = meta2.post_id - WHERE meta.meta_key = '_customer_user' - AND meta.meta_value = '" . esc_sql( $customer->get_id() ) . "' - AND posts.post_type = 'shop_order' - AND posts.post_status IN ( 'wc-" . implode( "','wc-", $statuses ) . "' ) - AND meta2.meta_key = '_order_total' - ", $customer ) ); + + // On WC 3.5.0 the ID of the user that placed the order was moved from the post meta _customer_user to the post_author field in the wp_posts table. + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '>=' ) ) { + $query = "SELECT SUM(meta.meta_value) + FROM $wpdb->posts as posts + LEFT JOIN {$wpdb->postmeta} AS meta ON posts.ID = meta.post_id + WHERE posts.post_author = '" . esc_sql( $customer->get_id() ) . "' + AND posts.post_type = 'shop_order' + AND posts.post_status IN ( 'wc-" . implode( "','wc-", $statuses ) . "' ) + AND meta.meta_key = '_order_total'"; + } else { + $query = "SELECT SUM(meta2.meta_value) + FROM $wpdb->posts as posts + LEFT JOIN {$wpdb->postmeta} AS meta ON posts.ID = meta.post_id + LEFT JOIN {$wpdb->postmeta} AS meta2 ON posts.ID = meta2.post_id + WHERE meta.meta_key = '_customer_user' + AND meta.meta_value = '" . esc_sql( $customer->get_id() ) . "' + AND posts.post_type = 'shop_order' + AND posts.post_status IN ( 'wc-" . implode( "','wc-", $statuses ) . "' ) + AND meta2.meta_key = '_order_total'"; + } + + // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $spent = $wpdb->get_var( apply_filters( 'woocommerce_customer_get_total_spent_query', $query, $customer ) ); if ( ! $spent ) { $spent = 0; @@ -369,37 +447,52 @@ class WC_Customer_Data_Store extends WC_Data_Store_WP implements WC_Customer_Dat /** * Search customers and return customer IDs. * - * @param string $term - * @oaram int|string $limit @since 3.0.7 + * @param string $term Search term. + * @param int|string $limit Limit search results. + * @since 3.0.7 + * * @return array */ public function search_customers( $term, $limit = '' ) { - $query = new WP_User_Query( apply_filters( 'woocommerce_customer_search_customers', array( - 'search' => '*' . esc_attr( $term ) . '*', - 'search_columns' => array( 'user_login', 'user_url', 'user_email', 'user_nicename', 'display_name' ), - 'fields' => 'ID', - 'number' => $limit, - ), $term, $limit, 'main_query' ) ); + $results = apply_filters( 'woocommerce_customer_pre_search_customers', false, $term, $limit ); + if ( is_array( $results ) ) { + return $results; + } - $query2 = new WP_User_Query( apply_filters( 'woocommerce_customer_search_customers', array( - 'fields' => 'ID', - 'number' => $limit, - 'meta_query' => array( - 'relation' => 'OR', - array( - 'key' => 'first_name', - 'value' => $term, - 'compare' => 'LIKE', - ), - array( - 'key' => 'last_name', - 'value' => $term, - 'compare' => 'LIKE', - ), - ), - ), $term, $limit, 'meta_query' ) ); + $query = new WP_User_Query( + apply_filters( + 'woocommerce_customer_search_customers', array( + 'search' => '*' . esc_attr( $term ) . '*', + 'search_columns' => array( 'user_login', 'user_url', 'user_email', 'user_nicename', 'display_name' ), + 'fields' => 'ID', + 'number' => $limit, + ), $term, $limit, 'main_query' + ) + ); - $results = wp_parse_id_list( array_merge( $query->get_results(), $query2->get_results() ) ); + $query2 = new WP_User_Query( + apply_filters( + 'woocommerce_customer_search_customers', array( + 'fields' => 'ID', + 'number' => $limit, + 'meta_query' => array( + 'relation' => 'OR', + array( + 'key' => 'first_name', + 'value' => $term, + 'compare' => 'LIKE', + ), + array( + 'key' => 'last_name', + 'value' => $term, + 'compare' => 'LIKE', + ), + ), + ), $term, $limit, 'meta_query' + ) + ); + + $results = wp_parse_id_list( array_merge( (array) $query->get_results(), (array) $query2->get_results() ) ); if ( $limit && count( $results ) > $limit ) { $results = array_slice( $results, 0, $limit ); diff --git a/includes/data-stores/class-wc-customer-download-data-store.php b/includes/data-stores/class-wc-customer-download-data-store.php index f55fe4e2bc4..95179f1b904 100644 --- a/includes/data-stores/class-wc-customer-download-data-store.php +++ b/includes/data-stores/class-wc-customer-download-data-store.php @@ -1,4 +1,10 @@ set_id( $wpdb->insert_id ); $download->apply_changes(); } + + do_action( 'woocommerce_grant_product_download_access', $data ); } /** * Method to read a download permission from the database. * - * @param $download + * @param WC_Customer_Download $download WC_Customer_Download object. * - * @throws Exception + * @throws Exception Throw exception if invalid download is passed. */ public function read( &$download ) { global $wpdb; - $download->set_defaults(); - - if ( ! $download->get_id() || ! ( $raw_download = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions WHERE permission_id = %d", $download->get_id() ) ) ) ) { + if ( ! $download->get_id() ) { throw new Exception( __( 'Invalid download.', 'woocommerce' ) ); } - $download->set_props( array( - 'download_id' => $raw_download->download_id, - 'product_id' => $raw_download->product_id, - 'user_id' => $raw_download->user_id, - 'user_email' => $raw_download->user_email, - 'order_id' => $raw_download->order_id, - 'order_key' => $raw_download->order_key, - 'downloads_remaining' => $raw_download->downloads_remaining, - 'access_granted' => strtotime( $raw_download->access_granted ), - 'download_count' => $raw_download->download_count, - 'access_expires' => is_null( $raw_download->access_expires ) ? null : strtotime( $raw_download->access_expires ), - ) ); + $download->set_defaults(); + $raw_download = $wpdb->get_row( + $wpdb->prepare( + "SELECT * FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions WHERE permission_id = %d", + $download->get_id() + ) + ); + + if ( ! $raw_download ) { + throw new Exception( __( 'Invalid download.', 'woocommerce' ) ); + } + + $download->set_props( + array( + 'download_id' => $raw_download->download_id, + 'product_id' => $raw_download->product_id, + 'user_id' => $raw_download->user_id, + 'user_email' => $raw_download->user_email, + 'order_id' => $raw_download->order_id, + 'order_key' => $raw_download->order_key, + 'downloads_remaining' => $raw_download->downloads_remaining, + 'access_granted' => strtotime( $raw_download->access_granted ), + 'download_count' => $raw_download->download_count, + 'access_expires' => is_null( $raw_download->access_expires ) ? null : strtotime( $raw_download->access_expires ), + ) + ); $download->set_object_read( true ); } /** * Method to update a download in the database. * - * @param WC_Customer_Download $download + * @param WC_Customer_Download $download WC_Customer_Download object. */ public function update( &$download ) { global $wpdb; @@ -144,16 +160,19 @@ class WC_Customer_Download_Data_Store implements WC_Customer_Download_Data_Store /** * Method to delete a download permission from the database. * - * @param WC_Customer_Download $download - * @param array $args Array of args to pass to the delete method. + * @param WC_Customer_Download $download WC_Customer_Download object. + * @param array $args Array of args to pass to the delete method. */ public function delete( &$download, $args = array() ) { global $wpdb; - $wpdb->query( $wpdb->prepare( " - DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions - WHERE permission_id = %d - ", $download->get_id() ) ); + $wpdb->query( + $wpdb->prepare( + "DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions + WHERE permission_id = %d", + $download->get_id() + ) + ); $download->set_id( 0 ); } @@ -161,40 +180,85 @@ class WC_Customer_Download_Data_Store implements WC_Customer_Download_Data_Store /** * Method to delete a download permission from the database by ID. * - * @param int $id + * @param int $id permission_id of the download to be deleted. */ public function delete_by_id( $id ) { global $wpdb; - $wpdb->query( $wpdb->prepare( " - DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions - WHERE permission_id = %d - ", $id ) ); + $wpdb->query( + $wpdb->prepare( + "DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions + WHERE permission_id = %d", + $id + ) + ); } /** * Method to delete a download permission from the database by order ID. * - * @param int $id + * @param int $id Order ID of the downloads that will be deleted. */ public function delete_by_order_id( $id ) { global $wpdb; - $wpdb->query( $wpdb->prepare( " - DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions - WHERE order_id = %d - ", $id ) ); + $wpdb->query( + $wpdb->prepare( + "DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions + WHERE order_id = %d", + $id + ) + ); } /** * Method to delete a download permission from the database by download ID. * - * @param int $id + * @param int $id download_id of the downloads that will be deleted. */ public function delete_by_download_id( $id ) { global $wpdb; - $wpdb->query( $wpdb->prepare( " - DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions - WHERE download_id = %s - ", $id ) ); + $wpdb->query( + $wpdb->prepare( + "DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions + WHERE download_id = %s", + $id + ) + ); + } + + /** + * Method to delete a download permission from the database by user ID. + * + * @since 3.4.0 + * @param int $id user ID of the downloads that will be deleted. + * @return bool True if deleted rows. + */ + public function delete_by_user_id( $id ) { + global $wpdb; + return (bool) $wpdb->query( + $wpdb->prepare( + "DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions + WHERE user_id = %d", + $id + ) + ); + } + + /** + * Method to delete a download permission from the database by user email. + * + * @since 3.4.0 + * @param string $email email of the downloads that will be deleted. + * @return bool True if deleted rows. + */ + public function delete_by_user_email( $email ) { + global $wpdb; + return (bool) $wpdb->query( + $wpdb->prepare( + "DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions + WHERE user_email = %s", + $email + ) + ); } /** @@ -210,77 +274,104 @@ class WC_Customer_Download_Data_Store implements WC_Customer_Download_Data_Store /** * Get array of download ids by specified args. * - * @param array $args - * @return array + * @param array $args Arguments to filter downloads. $args['return'] accepts the following values: 'objects' (default), 'ids' or a comma separeted list of fields (for example: 'order_id,user_id,user_email'). + * @return array Can be an array of permission_ids, an array of WC_Customer_Download objects or an array of arrays containing specified fields depending on the value of $args['return']. */ public function get_downloads( $args = array() ) { global $wpdb; - $args = wp_parse_args( $args, array( - 'user_email' => '', - 'order_id' => '', - 'order_key' => '', - 'product_id' => '', - 'download_id' => '', - 'orderby' => 'permission_id', - 'order' => 'DESC', - 'limit' => -1, - 'return' => 'objects', - ) ); + $args = wp_parse_args( + $args, array( + 'user_email' => '', + 'user_id' => '', + 'order_id' => '', + 'order_key' => '', + 'product_id' => '', + 'download_id' => '', + 'orderby' => 'permission_id', + 'order' => 'ASC', + 'limit' => -1, + 'page' => 1, + 'return' => 'objects', + ) + ); + + $valid_fields = array( 'permission_id', 'download_id', 'product_id', 'order_id', 'order_key', 'user_email', 'user_id', 'downloads_remaining', 'access_granted', 'access_expires', 'download_count' ); + $get_results_output = ARRAY_A; + + if ( 'ids' === $args['return'] ) { + $fields = 'permission_id'; + } elseif ( 'objects' === $args['return'] ) { + $fields = '*'; + $get_results_output = OBJECT; + } else { + $fields = explode( ',', (string) $args['return'] ); + $fields = implode( ', ', array_intersect( $fields, $valid_fields ) ); + } $query = array(); - $query[] = "SELECT * FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions WHERE 1=1"; + $query[] = "SELECT {$fields} FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions WHERE 1=1"; if ( $args['user_email'] ) { - $query[] = $wpdb->prepare( "AND user_email = %s", sanitize_email( $args['user_email'] ) ); + $query[] = $wpdb->prepare( 'AND user_email = %s', sanitize_email( $args['user_email'] ) ); + } + + if ( $args['user_id'] ) { + $query[] = $wpdb->prepare( 'AND user_id = %d', absint( $args['user_id'] ) ); } if ( $args['order_id'] ) { - $query[] = $wpdb->prepare( "AND order_id = %d", $args['order_id'] ); + $query[] = $wpdb->prepare( 'AND order_id = %d', $args['order_id'] ); } if ( $args['order_key'] ) { - $query[] = $wpdb->prepare( "AND order_key = %s", $args['order_key'] ); + $query[] = $wpdb->prepare( 'AND order_key = %s', $args['order_key'] ); } if ( $args['product_id'] ) { - $query[] = $wpdb->prepare( "AND product_id = %d", $args['product_id'] ); + $query[] = $wpdb->prepare( 'AND product_id = %d', $args['product_id'] ); } if ( $args['download_id'] ) { - $query[] = $wpdb->prepare( "AND download_id = %s", $args['download_id'] ); + $query[] = $wpdb->prepare( 'AND download_id = %s', $args['download_id'] ); } - $allowed_orders = array( 'permission_id', 'download_id', 'product_id', 'order_id', 'order_key', 'user_email', 'user_id', 'downloads_remaining', 'access_granted', 'access_expires', 'download_count' ); - $order = in_array( $args['order'], $allowed_orders ) ? $args['order'] : 'permission_id'; - $orderby = 'DESC' === strtoupper( $args['orderby'] ) ? 'DESC' : 'ASC'; - $orderby_sql = sanitize_sql_orderby( "{$order} {$orderby}" ); - $query[] = "ORDER BY {$orderby_sql}"; + $orderby = in_array( $args['orderby'], $valid_fields, true ) ? $args['orderby'] : 'permission_id'; + $order = 'DESC' === strtoupper( $args['order'] ) ? 'DESC' : 'ASC'; + $orderby_sql = sanitize_sql_orderby( "{$orderby} {$order}" ); + $query[] = "ORDER BY {$orderby_sql}"; if ( 0 < $args['limit'] ) { - $query[] = $wpdb->prepare( "LIMIT %d", $args['limit'] ); + $query[] = $wpdb->prepare( 'LIMIT %d, %d', absint( $args['limit'] ) * absint( $args['page'] - 1 ), absint( $args['limit'] ) ); } - $raw_downloads = $wpdb->get_results( implode( ' ', $query ) ); + // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $results = $wpdb->get_results( implode( ' ', $query ), $get_results_output ); switch ( $args['return'] ) { - case 'ids' : - return wp_list_pluck( $raw_downloads, 'permission_id' ); - default : - return array_map( array( $this, 'get_download' ), $raw_downloads ); + case 'ids': + return wp_list_pluck( $results, 'permission_id' ); + case 'objects': + return array_map( array( $this, 'get_download' ), $results ); + default: + return $results; } } /** * Update download ids if the hash changes. * - * @param int $product_id - * @param string $old_id - * @param string $new_id + * @deprecated 3.3.0 Download id is now a static UUID and should not be changed based on file hash. + * + * @param int $product_id Product ID. + * @param string $old_id Old download_id. + * @param string $new_id New download_id. */ public function update_download_id( $product_id, $old_id, $new_id ) { global $wpdb; + wc_deprecated_function( __METHOD__, '3.3' ); + $wpdb->update( $wpdb->prefix . 'woocommerce_downloadable_product_permissions', array( @@ -296,15 +387,15 @@ class WC_Customer_Download_Data_Store implements WC_Customer_Download_Data_Store /** * Get a customers downloads. * - * @param int $customer_id + * @param int $customer_id Customer ID. * @return array */ public function get_downloads_for_customer( $customer_id ) { global $wpdb; return $wpdb->get_results( - $wpdb->prepare( " - SELECT * FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions as permissions + $wpdb->prepare( + "SELECT * FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions as permissions WHERE user_id = %d AND permissions.order_id > 0 AND @@ -318,8 +409,7 @@ class WC_Customer_Download_Data_Store implements WC_Customer_Download_Data_Store OR permissions.access_expires >= %s OR permissions.access_expires = '0000-00-00 00:00:00' ) - ORDER BY permissions.order_id, permissions.product_id, permissions.permission_id; - ", + ORDER BY permissions.order_id, permissions.product_id, permissions.permission_id;", $customer_id, date( 'Y-m-d', current_time( 'timestamp' ) ) ) @@ -329,19 +419,20 @@ class WC_Customer_Download_Data_Store implements WC_Customer_Download_Data_Store /** * Update user prop for downloads based on order id. * - * @param int $order_id - * @param int $customer_id - * @param string $email + * @param int $order_id Order ID. + * @param int $customer_id Customer ID. + * @param string $email Customer email address. */ public function update_user_by_order_id( $order_id, $customer_id, $email ) { global $wpdb; - $wpdb->update( $wpdb->prefix . 'woocommerce_downloadable_product_permissions', + $wpdb->update( + $wpdb->prefix . 'woocommerce_downloadable_product_permissions', array( 'user_id' => $customer_id, 'user_email' => $email, ), array( - 'order_id' => $order_id, + 'order_id' => $order_id, ), array( '%d', diff --git a/includes/data-stores/class-wc-customer-download-log-data-store.php b/includes/data-stores/class-wc-customer-download-log-data-store.php new file mode 100644 index 00000000000..a577fdbe6e3 --- /dev/null +++ b/includes/data-stores/class-wc-customer-download-log-data-store.php @@ -0,0 +1,236 @@ +get_timestamp( 'edit' ) ) ) { + $download_log->set_timestamp( current_time( 'timestamp', true ) ); + } + + $data = array( + 'timestamp' => date( 'Y-m-d H:i:s', $download_log->get_timestamp( 'edit' )->getTimestamp() ), + 'permission_id' => $download_log->get_permission_id( 'edit' ), + 'user_id' => $download_log->get_user_id( 'edit' ), + 'user_ip_address' => $download_log->get_user_ip_address( 'edit' ), + ); + + $format = array( + '%s', + '%s', + '%s', + '%s', + ); + + $result = $wpdb->insert( + $wpdb->prefix . self::get_table_name(), + apply_filters( 'woocommerce_downloadable_product_download_log_insert_data', $data ), + apply_filters( 'woocommerce_downloadable_product_download_log_insert_format', $format, $data ) + ); + + do_action( 'woocommerce_downloadable_product_download_log_insert', $data ); + + if ( $result ) { + $download_log->set_id( $wpdb->insert_id ); + $download_log->apply_changes(); + } else { + wp_die( esc_html__( 'Unable to insert download log entry in database.', 'woocommerce' ) ); + } + } + + /** + * Method to read a download log from the database. + * + * @param WC_Customer_Download_Log $download_log Download log object. + * @throws Exception Exception when read is not possible. + */ + public function read( &$download_log ) { + global $wpdb; + + $download_log->set_defaults(); + + // Ensure we have an id to pull from the DB. + if ( ! $download_log->get_id() ) { + throw new Exception( __( 'Invalid download log: no ID.', 'woocommerce' ) ); + } + + $table = $wpdb->prefix . self::get_table_name(); + + // Query the DB for the download log. + $raw_download_log = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM {$table} WHERE download_log_id = %d", $download_log->get_id() ) ); // WPCS: unprepared SQL ok. + + if ( ! $raw_download_log ) { + throw new Exception( __( 'Invalid download log: not found.', 'woocommerce' ) ); + } + + $download_log->set_props( + array( + 'timestamp' => strtotime( $raw_download_log->timestamp ), + 'permission_id' => $raw_download_log->permission_id, + 'user_id' => $raw_download_log->user_id, + 'user_ip_address' => $raw_download_log->user_ip_address, + ) + ); + + $download_log->set_object_read( true ); + } + + /** + * Method to update a download log in the database. + * + * @param WC_Customer_Download_Log $download_log Download log object. + */ + public function update( &$download_log ) { + global $wpdb; + + $data = array( + 'timestamp' => date( 'Y-m-d H:i:s', $download_log->get_timestamp( 'edit' )->getTimestamp() ), + 'permission_id' => $download_log->get_permission_id( 'edit' ), + 'user_id' => $download_log->get_user_id( 'edit' ), + 'user_ip_address' => $download_log->get_user_ip_address( 'edit' ), + ); + + $format = array( + '%s', + '%s', + '%s', + '%s', + ); + + $wpdb->update( + $wpdb->prefix . self::get_table_name(), + $data, + array( + 'download_log_id' => $download_log->get_id(), + ), + $format + ); + $download_log->apply_changes(); + } + + /** + * Get a download log object. + * + * @param array $data From the DB. + * @return WC_Customer_Download_Log + */ + private function get_download_log( $data ) { + return new WC_Customer_Download_Log( $data ); + } + + /** + * Get array of download log ids by specified args. + * + * @param array $args Arguments to define download logs to retrieve. + * @return array + */ + public function get_download_logs( $args = array() ) { + global $wpdb; + + $args = wp_parse_args( $args, array( + 'permission_id' => '', + 'user_id' => '', + 'user_ip_address' => '', + 'orderby' => 'download_log_id', + 'order' => 'ASC', + 'limit' => -1, + 'page' => 1, + 'return' => 'objects', + ) ); + + $query = array(); + $table = $wpdb->prefix . self::get_table_name(); + $query[] = "SELECT * FROM {$table} WHERE 1=1"; + + if ( $args['permission_id'] ) { + $query[] = $wpdb->prepare( 'AND permission_id = %d', $args['permission_id'] ); + } + + if ( $args['user_id'] ) { + $query[] = $wpdb->prepare( 'AND user_id = %d', $args['user_id'] ); + } + + if ( $args['user_ip_address'] ) { + $query[] = $wpdb->prepare( 'AND user_ip_address = %s', $args['user_ip_address'] ); + } + + $allowed_orders = array( 'download_log_id', 'timestamp', 'permission_id', 'user_id' ); + $orderby = in_array( $args['orderby'], $allowed_orders, true ) ? $args['orderby'] : 'download_log_id'; + $order = 'DESC' === strtoupper( $args['order'] ) ? 'DESC' : 'ASC'; + $orderby_sql = sanitize_sql_orderby( "{$orderby} {$order}" ); + $query[] = "ORDER BY {$orderby_sql}"; + + if ( 0 < $args['limit'] ) { + $query[] = $wpdb->prepare( 'LIMIT %d, %d', absint( $args['limit'] ) * absint( $args['page'] - 1 ), absint( $args['limit'] ) ); + } + + $raw_download_logs = $wpdb->get_results( implode( ' ', $query ) ); // WPCS: unprepared SQL ok. + + switch ( $args['return'] ) { + case 'ids': + return wp_list_pluck( $raw_download_logs, 'download_log_id' ); + default: + return array_map( array( $this, 'get_download_log' ), $raw_download_logs ); + } + } + + /** + * Get download logs for a given download permission. + * + * @param int $permission_id Permission to get logs for. + * @return array + */ + public function get_download_logs_for_permission( $permission_id ) { + // If no permission_id is passed, return an empty array. + if ( empty( $permission_id ) ) { + return array(); + } + + return $this->get_download_logs( + array( + 'permission_id' => $permission_id, + ) + ); + } + + /** + * Method to delete download logs for a given permission ID. + * + * @since 3.4.0 + * @param int $id download_id of the downloads that will be deleted. + */ + public function delete_by_permission_id( $id ) { + global $wpdb; + $wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions WHERE permission_id = %d", $id ) ); + } +} diff --git a/includes/data-stores/class-wc-data-store-wp.php b/includes/data-stores/class-wc-data-store-wp.php index 821b16a91ab..229d144a9b5 100644 --- a/includes/data-stores/class-wc-data-store-wp.php +++ b/includes/data-stores/class-wc-data-store-wp.php @@ -1,17 +1,18 @@ get_db_info(); - $raw_meta_data = $wpdb->get_results( $wpdb->prepare( " - SELECT {$db_info['meta_id_field']} as meta_id, meta_key, meta_value - FROM {$db_info['table']} - WHERE {$db_info['object_id_field']} = %d - ORDER BY {$db_info['meta_id_field']} - ", $object->get_id() ) ); + $raw_meta_data = $wpdb->get_results( + $wpdb->prepare( + // phpcs:disable WordPress.WP.PreparedSQL.NotPrepared + "SELECT {$db_info['meta_id_field']} as meta_id, meta_key, meta_value + FROM {$db_info['table']} + WHERE {$db_info['object_id_field']} = %d + ORDER BY {$db_info['meta_id_field']}", + // phpcs:enable + $object->get_id() + ) + ); $this->internal_meta_keys = array_merge( array_map( array( $this, 'prefix_key' ), $object->get_data_keys() ), $this->internal_meta_keys ); - return array_filter( $raw_meta_data, array( $this, 'exclude_internal_meta_keys' ) ); + $meta_data = array_filter( $raw_meta_data, array( $this, 'exclude_internal_meta_keys' ) ); + return apply_filters( "woocommerce_data_store_wp_{$this->meta_type}_read_meta", $meta_data, $object, $this ); } /** * Deletes meta based on meta ID. * * @since 3.0.0 - * @param WC_Data - * @param stdClass (containing at least ->id) - * @return array + * @param WC_Data $object WC_Data object. + * @param stdClass $meta (containing at least ->id). */ public function delete_meta( &$object, $meta ) { delete_metadata_by_mid( $this->meta_type, $meta->id ); @@ -95,8 +105,8 @@ class WC_Data_Store_WP { * Add new piece of meta. * * @since 3.0.0 - * @param WC_Data - * @param stdClass (containing ->key and ->value) + * @param WC_Data $object WC_Data object. + * @param stdClass $meta (containing ->key and ->value). * @return int meta ID */ public function add_meta( &$object, $meta ) { @@ -107,8 +117,8 @@ class WC_Data_Store_WP { * Update meta. * * @since 3.0.0 - * @param WC_Data - * @param stdClass (containing ->id, ->key and ->value) + * @param WC_Data $object WC_Data object. + * @param stdClass $meta (containing ->id, ->key and ->value). */ public function update_meta( &$object, $meta ) { update_metadata_by_mid( $this->meta_type, $meta->id, $meta->value, $meta->key ); @@ -123,11 +133,11 @@ class WC_Data_Store_WP { protected function get_db_info() { global $wpdb; - $meta_id_field = 'meta_id'; // for some reason users calls this umeta_id so we need to track this as well. - $table = $wpdb->prefix; + $meta_id_field = 'meta_id'; // for some reason users calls this umeta_id so we need to track this as well. + $table = $wpdb->prefix; // If we are dealing with a type of metadata that is not a core type, the table should be prefixed. - if ( ! in_array( $this->meta_type, array( 'post', 'user', 'comment', 'term' ) ) ) { + if ( ! in_array( $this->meta_type, array( 'post', 'user', 'comment', 'term' ), true ) ) { $table .= 'woocommerce_'; } @@ -154,10 +164,10 @@ class WC_Data_Store_WP { /** * Internal meta keys we don't want exposed as part of meta_data. This is in * addition to all data props with _ prefix. + * * @since 2.6.0 * - * @param string $key - * + * @param string $key Prefix to be added to meta keys. * @return string */ protected function prefix_key( $key ) { @@ -167,11 +177,11 @@ class WC_Data_Store_WP { /** * Callback to remove unwanted meta data. * - * @param object $meta + * @param object $meta Meta object to check if it should be excluded or not. * @return bool */ protected function exclude_internal_meta_keys( $meta ) { - return ! in_array( $meta->meta_key, $this->internal_meta_keys ) && 0 !== stripos( $meta->meta_key, 'wp_' ); + return ! in_array( $meta->meta_key, $this->internal_meta_keys, true ) && 0 !== stripos( $meta->meta_key, 'wp_' ); } /** @@ -201,15 +211,15 @@ class WC_Data_Store_WP { * Get valid WP_Query args from a WC_Object_Query's query variables. * * @since 3.1.0 - * @param array $query_vars query vars from a WC_Object_Query + * @param array $query_vars query vars from a WC_Object_Query. * @return array */ protected function get_wp_query_args( $query_vars ) { $skipped_values = array( '', array(), null ); - $wp_query_args = array( + $wp_query_args = array( 'errors' => array(), - 'meta_query' => array(), + 'meta_query' => array(), // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_query ); foreach ( $query_vars as $key => $value ) { @@ -218,14 +228,28 @@ class WC_Data_Store_WP { } // Build meta queries out of vars that are stored in internal meta keys. - if ( in_array( '_' . $key, $this->internal_meta_keys ) ) { - $wp_query_args['meta_query'][] = array( - 'key' => '_' . $key, - 'value' => $value, - 'compare' => '=', - ); - // Other vars get mapped to wp_query args or just left alone. - } else { + if ( in_array( '_' . $key, $this->internal_meta_keys, true ) ) { + // Check for existing values if wildcard is used. + if ( '*' === $value ) { + $wp_query_args['meta_query'][] = array( + array( + 'key' => '_' . $key, + 'compare' => 'EXISTS', + ), + array( + 'key' => '_' . $key, + 'value' => '', + 'compare' => '!=', + ), + ); + } else { + $wp_query_args['meta_query'][] = array( + 'key' => '_' . $key, + 'value' => $value, + 'compare' => is_array( $value ) ? 'IN' : '=', + ); + } + } else { // Other vars get mapped to wp_query args or just left alone. $key_mapping = array( 'parent' => 'post_parent', 'parent_exclude' => 'post_parent__not_in', @@ -250,12 +274,14 @@ class WC_Data_Store_WP { * Map a valid date query var to WP_Query arguments. * Valid date formats: YYYY-MM-DD or timestamp, possibly combined with an operator from $valid_operators. * Also accepts a WC_DateTime object. - * @param mixed $query_var A valid date format - * @param string $key meta or db column key - * @param array $wp_query_args WP_Query args + * + * @since 3.2.0 + * @param mixed $query_var A valid date format. + * @param string $key meta or db column key. + * @param array $wp_query_args WP_Query args. * @return array Modified $wp_query_args */ - protected function parse_date_for_wp_query( $query_var, $key, $wp_query_args = array() ) { + public function parse_date_for_wp_query( $query_var, $key, $wp_query_args = array() ) { $query_parse_regex = '/([^.<>]*)(>=|<=|>|<|\.\.\.)([^.<>]+)/'; $valid_operators = array( '>', '>=', '=', '<=', '<', '...' ); @@ -269,27 +295,21 @@ class WC_Data_Store_WP { // Specific time query with a WC_DateTime. if ( is_a( $query_var, 'WC_DateTime' ) ) { $dates[] = $query_var; - - // Specific time query with a timestamp. - } elseif ( is_numeric( $query_var ) ) { + } elseif ( is_numeric( $query_var ) ) { // Specific time query with a timestamp. $dates[] = new WC_DateTime( "@{$query_var}", new DateTimeZone( 'UTC' ) ); - - // Query with operators and possible range of dates. - } elseif ( preg_match( $query_parse_regex, $query_var, $sections ) ) { + } elseif ( preg_match( $query_parse_regex, $query_var, $sections ) ) { // Query with operators and possible range of dates. if ( ! empty( $sections[1] ) ) { $dates[] = is_numeric( $sections[1] ) ? new WC_DateTime( "@{$sections[1]}", new DateTimeZone( 'UTC' ) ) : wc_string_to_datetime( $sections[1] ); } - $operator = in_array( $sections[2], $valid_operators ) ? $sections[2] : ''; - $dates[] = is_numeric( $sections[3] ) ? new WC_DateTime( "@{$sections[3]}", new DateTimeZone( 'UTC' ) ) : wc_string_to_datetime( $sections[3] ); + $operator = in_array( $sections[2], $valid_operators, true ) ? $sections[2] : ''; + $dates[] = is_numeric( $sections[3] ) ? new WC_DateTime( "@{$sections[3]}", new DateTimeZone( 'UTC' ) ) : wc_string_to_datetime( $sections[3] ); if ( ! is_numeric( $sections[1] ) && ! is_numeric( $sections[3] ) ) { $precision = 'day'; } - - // Specific time query with a string. - } else { - $dates[] = wc_string_to_datetime( $query_var ); + } else { // Specific time query with a string. + $dates[] = wc_string_to_datetime( $query_var ); $precision = 'day'; } } catch ( Exception $e ) { @@ -322,20 +342,21 @@ class WC_Data_Store_WP { } foreach ( $comparisons as $index => $comparison ) { - /** - * WordPress doesn't generate the correct SQL for inclusive day queries with both a 'before' and - * 'after' string query, so we have to use the array format in 'day' precision. - * @see https://core.trac.wordpress.org/ticket/29908 - */ if ( 'day' === $precision ) { + /** + * WordPress doesn't generate the correct SQL for inclusive day queries with both a 'before' and + * 'after' string query, so we have to use the array format in 'day' precision. + * + * @see https://core.trac.wordpress.org/ticket/29908 + */ $query_arg[ $comparison ]['year'] = $dates[ $index ]->date( 'Y' ); $query_arg[ $comparison ]['month'] = $dates[ $index ]->date( 'n' ); $query_arg[ $comparison ]['day'] = $dates[ $index ]->date( 'j' ); - /** - * WordPress doesn't support 'hour'/'second'/'minute' in array format 'before'/'after' queries, - * so we have to use a string query. - */ } else { + /** + * WordPress doesn't support 'hour'/'second'/'minute' in array format 'before'/'after' queries, + * so we have to use a string query. + */ $query_arg[ $comparison ] = gmdate( 'm/d/Y H:i:s', $dates[ $index ]->getTimestamp() ); } } @@ -356,14 +377,14 @@ class WC_Data_Store_WP { // Build meta query for unrecognized keys. if ( ! isset( $wp_query_args['meta_query'] ) ) { - $wp_query_args['meta_query'] = array(); + $wp_query_args['meta_query'] = array(); // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_query } // Meta dates are stored as timestamps in the db. // Check against beginning/end-of-day timestamps when using 'day' precision. if ( 'day' === $precision ) { $start_timestamp = strtotime( gmdate( 'm/d/Y 00:00:00', $dates[0]->getTimestamp() ) ); - $end_timestamp = '...' !== $operator ? ( $start_timestamp + DAY_IN_SECONDS ) : strtotime( gmdate( 'm/d/Y 00:00:00', $dates[1]->getTimestamp() ) ); + $end_timestamp = '...' !== $operator ? ( $start_timestamp + DAY_IN_SECONDS ) : strtotime( gmdate( 'm/d/Y 00:00:00', $dates[1]->getTimestamp() ) ); switch ( $operator ) { case '>': case '<=': @@ -372,8 +393,7 @@ class WC_Data_Store_WP { 'value' => $end_timestamp, 'compare' => $operator, ); - break; - + break; case '<': case '>=': $wp_query_args['meta_query'][] = array( @@ -381,8 +401,7 @@ class WC_Data_Store_WP { 'value' => $start_timestamp, 'compare' => $operator, ); - break; - + break; default: $wp_query_args['meta_query'][] = array( 'key' => $key, @@ -418,4 +437,75 @@ class WC_Data_Store_WP { return $wp_query_args; } + + /** + * Return list of internal meta keys. + * + * @since 3.2.0 + * @return array + */ + public function get_internal_meta_keys() { + return $this->internal_meta_keys; + } + + /** + * Check if the terms are suitable for searching. + * + * Uses an array of stopwords (terms) that are excluded from the separate + * term matching when searching for posts. The list of English stopwords is + * the approximate search engines list, and is translatable. + * + * @since 3.4.0 + * @param array $terms Terms to check. + * @return array Terms that are not stopwords. + */ + protected function get_valid_search_terms( $terms ) { + $valid_terms = array(); + $stopwords = $this->get_search_stopwords(); + + foreach ( $terms as $term ) { + // keep before/after spaces when term is for exact match, otherwise trim quotes and spaces. + if ( preg_match( '/^".+"$/', $term ) ) { + $term = trim( $term, "\"'" ); + } else { + $term = trim( $term, "\"' " ); + } + + // Avoid single A-Z and single dashes. + if ( empty( $term ) || ( 1 === strlen( $term ) && preg_match( '/^[a-z\-]$/i', $term ) ) ) { + continue; + } + + if ( in_array( wc_strtolower( $term ), $stopwords, true ) ) { + continue; + } + + $valid_terms[] = $term; + } + + return $valid_terms; + } + + /** + * Retrieve stopwords used when parsing search terms. + * + * @since 3.4.0 + * @return array Stopwords. + */ + protected function get_search_stopwords() { + // Translators: This is a comma-separated list of very common words that should be excluded from a search, like a, an, and the. These are usually called "stopwords". You should not simply translate these individual words into your language. Instead, look for and provide commonly accepted stopwords in your language. + $stopwords = array_map( + 'wc_strtolower', array_map( + 'trim', explode( + ',', _x( + 'about,an,are,as,at,be,by,com,for,from,how,in,is,it,of,on,or,that,the,this,to,was,what,when,where,who,will,with,www', + 'Comma-separated list of search stopwords in your language', + 'woocommerce' + ) + ) + ) + ); + + return apply_filters( 'wp_search_stopwords', $stopwords ); + } } diff --git a/includes/data-stores/class-wc-order-data-store-cpt.php b/includes/data-stores/class-wc-order-data-store-cpt.php index 31483b17ff1..316aa4b8373 100644 --- a/includes/data-stores/class-wc-order-data-store-cpt.php +++ b/includes/data-stores/class-wc-order-data-store-cpt.php @@ -1,4 +1,10 @@ set_order_key( 'wc_' . apply_filters( 'woocommerce_generate_order_key', uniqid( 'order_' ) ) ); @@ -82,8 +89,8 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Read order data. Can be overridden by child classes to load other props. * - * @param WC_Order - * @param object $post_object + * @param WC_Order $order Order object. + * @param object $post_object Post object. * @since 3.0.0 */ protected function read_order_data( &$order, $post_object ) { @@ -100,45 +107,55 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement $date_paid = get_post_meta( $id, '_paid_date', true ); } - $order->set_props( array( - 'order_key' => get_post_meta( $id, '_order_key', true ), - 'customer_id' => get_post_meta( $id, '_customer_user', true ), - 'billing_first_name' => get_post_meta( $id, '_billing_first_name', true ), - 'billing_last_name' => get_post_meta( $id, '_billing_last_name', true ), - 'billing_company' => get_post_meta( $id, '_billing_company', true ), - 'billing_address_1' => get_post_meta( $id, '_billing_address_1', true ), - 'billing_address_2' => get_post_meta( $id, '_billing_address_2', true ), - 'billing_city' => get_post_meta( $id, '_billing_city', true ), - 'billing_state' => get_post_meta( $id, '_billing_state', true ), - 'billing_postcode' => get_post_meta( $id, '_billing_postcode', true ), - 'billing_country' => get_post_meta( $id, '_billing_country', true ), - 'billing_email' => get_post_meta( $id, '_billing_email', true ), - 'billing_phone' => get_post_meta( $id, '_billing_phone', true ), - 'shipping_first_name' => get_post_meta( $id, '_shipping_first_name', true ), - 'shipping_last_name' => get_post_meta( $id, '_shipping_last_name', true ), - 'shipping_company' => get_post_meta( $id, '_shipping_company', true ), - 'shipping_address_1' => get_post_meta( $id, '_shipping_address_1', true ), - 'shipping_address_2' => get_post_meta( $id, '_shipping_address_2', true ), - 'shipping_city' => get_post_meta( $id, '_shipping_city', true ), - 'shipping_state' => get_post_meta( $id, '_shipping_state', true ), - 'shipping_postcode' => get_post_meta( $id, '_shipping_postcode', true ), - 'shipping_country' => get_post_meta( $id, '_shipping_country', true ), - 'payment_method' => get_post_meta( $id, '_payment_method', true ), - 'payment_method_title' => get_post_meta( $id, '_payment_method_title', true ), - 'transaction_id' => get_post_meta( $id, '_transaction_id', true ), - 'customer_ip_address' => get_post_meta( $id, '_customer_ip_address', true ), - 'customer_user_agent' => get_post_meta( $id, '_customer_user_agent', true ), - 'created_via' => get_post_meta( $id, '_created_via', true ), - 'date_completed' => $date_completed, - 'date_paid' => $date_paid, - 'cart_hash' => get_post_meta( $id, '_cart_hash', true ), - 'customer_note' => $post_object->post_excerpt, - ) ); + // On WC 3.5.0 the ID of the user that placed the order was moved from the post meta _customer_user to the post_author field in the wp_posts table. + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '>=' ) ) { + $customer_id = $post_object->post_author; + } else { + $customer_id = get_post_meta( $id, '_customer_user', true ); + } + + $order->set_props( + array( + 'order_key' => get_post_meta( $id, '_order_key', true ), + 'customer_id' => $customer_id, + 'billing_first_name' => get_post_meta( $id, '_billing_first_name', true ), + 'billing_last_name' => get_post_meta( $id, '_billing_last_name', true ), + 'billing_company' => get_post_meta( $id, '_billing_company', true ), + 'billing_address_1' => get_post_meta( $id, '_billing_address_1', true ), + 'billing_address_2' => get_post_meta( $id, '_billing_address_2', true ), + 'billing_city' => get_post_meta( $id, '_billing_city', true ), + 'billing_state' => get_post_meta( $id, '_billing_state', true ), + 'billing_postcode' => get_post_meta( $id, '_billing_postcode', true ), + 'billing_country' => get_post_meta( $id, '_billing_country', true ), + 'billing_email' => get_post_meta( $id, '_billing_email', true ), + 'billing_phone' => get_post_meta( $id, '_billing_phone', true ), + 'shipping_first_name' => get_post_meta( $id, '_shipping_first_name', true ), + 'shipping_last_name' => get_post_meta( $id, '_shipping_last_name', true ), + 'shipping_company' => get_post_meta( $id, '_shipping_company', true ), + 'shipping_address_1' => get_post_meta( $id, '_shipping_address_1', true ), + 'shipping_address_2' => get_post_meta( $id, '_shipping_address_2', true ), + 'shipping_city' => get_post_meta( $id, '_shipping_city', true ), + 'shipping_state' => get_post_meta( $id, '_shipping_state', true ), + 'shipping_postcode' => get_post_meta( $id, '_shipping_postcode', true ), + 'shipping_country' => get_post_meta( $id, '_shipping_country', true ), + 'payment_method' => get_post_meta( $id, '_payment_method', true ), + 'payment_method_title' => get_post_meta( $id, '_payment_method_title', true ), + 'transaction_id' => get_post_meta( $id, '_transaction_id', true ), + 'customer_ip_address' => get_post_meta( $id, '_customer_ip_address', true ), + 'customer_user_agent' => get_post_meta( $id, '_customer_user_agent', true ), + 'created_via' => get_post_meta( $id, '_created_via', true ), + 'date_completed' => $date_completed, + 'date_paid' => $date_paid, + 'cart_hash' => get_post_meta( $id, '_cart_hash', true ), + 'customer_note' => $post_object->post_excerpt, + ) + ); } /** * Method to update an order in the database. - * @param WC_Order $order + * + * @param WC_Order $order Order object. */ public function update( &$order ) { // Before updating, ensure date paid is set if missing. @@ -155,7 +172,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Helper method that updates all the post meta for an order based on it's settings in the WC_Order class. * - * @param WC_Order + * @param WC_Order $order Order object. * @since 3.0.0 */ protected function update_post_meta( &$order ) { @@ -202,7 +219,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement } $address_props = array( - 'billing' => array( + 'billing' => array( '_billing_first_name' => 'billing_first_name', '_billing_last_name' => 'billing_last_name', '_billing_company' => 'billing_company', @@ -241,17 +258,21 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement parent::update_post_meta( $order ); // If address changed, store concatenated version to make searches faster. - if ( in_array( 'billing', $updated_props ) || ! metadata_exists( 'post', $id, '_billing_address_index' ) ) { + if ( in_array( 'billing', $updated_props, true ) || ! metadata_exists( 'post', $id, '_billing_address_index' ) ) { update_post_meta( $id, '_billing_address_index', implode( ' ', $order->get_address( 'billing' ) ) ); } - if ( in_array( 'shipping', $updated_props ) || ! metadata_exists( 'post', $id, '_shipping_address_index' ) ) { + if ( in_array( 'shipping', $updated_props, true ) || ! metadata_exists( 'post', $id, '_shipping_address_index' ) ) { update_post_meta( $id, '_shipping_address_index', implode( ' ', $order->get_address( 'shipping' ) ) ); } - // If customer changed, update any downloadable permissions. - if ( in_array( 'customer_user', $updated_props ) || in_array( 'billing_email', $updated_props ) ) { - $data_store = WC_Data_Store::load( 'customer-download' ); - $data_store->update_user_by_order_id( $id, $order->get_customer_id(), $order->get_billing_email() ); + // If customer email changed, update any downloadable permissions. + if ( in_array( 'billing_email', $updated_props ) ) { + $this->update_downloadable_permissions( $order ); + } + + // Mark user account as active. + if ( in_array( 'customer_id', $updated_props, true ) ) { + wc_update_user_last_active( $order->get_customer_id() ); } do_action( 'woocommerce_order_object_updated_props', $order, $updated_props ); @@ -260,7 +281,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Excerpt for post. * - * @param WC_Order $order + * @param WC_Order $order Order object. * @return string */ protected function get_post_excerpt( $order ) { @@ -270,40 +291,46 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Get amount already refunded. * - * @param WC_Order - * @return string + * @param WC_Order $order Order object. + * @return float */ public function get_total_refunded( $order ) { global $wpdb; - $total = $wpdb->get_var( $wpdb->prepare( " - SELECT SUM( postmeta.meta_value ) - FROM $wpdb->postmeta AS postmeta - INNER JOIN $wpdb->posts AS posts ON ( posts.post_type = 'shop_order_refund' AND posts.post_parent = %d ) - WHERE postmeta.meta_key = '_refund_amount' - AND postmeta.post_id = posts.ID - ", $order->get_id() ) ); + $total = $wpdb->get_var( + $wpdb->prepare( + "SELECT SUM( postmeta.meta_value ) + FROM $wpdb->postmeta AS postmeta + INNER JOIN $wpdb->posts AS posts ON ( posts.post_type = 'shop_order_refund' AND posts.post_parent = %d ) + WHERE postmeta.meta_key = '_refund_amount' + AND postmeta.post_id = posts.ID", + $order->get_id() + ) + ); - return $total; + return floatval( $total ); } /** * Get the total tax refunded. * - * @param WC_Order + * @param WC_Order $order Order object. * @return float */ public function get_total_tax_refunded( $order ) { global $wpdb; - $total = $wpdb->get_var( $wpdb->prepare( " - SELECT SUM( order_itemmeta.meta_value ) - FROM {$wpdb->prefix}woocommerce_order_itemmeta AS order_itemmeta - INNER JOIN $wpdb->posts AS posts ON ( posts.post_type = 'shop_order_refund' AND posts.post_parent = %d ) - INNER JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON ( order_items.order_id = posts.ID AND order_items.order_item_type = 'tax' ) - WHERE order_itemmeta.order_item_id = order_items.order_item_id - AND order_itemmeta.meta_key IN ('tax_amount', 'shipping_tax_amount') - ", $order->get_id() ) ); + $total = $wpdb->get_var( + $wpdb->prepare( + "SELECT SUM( order_itemmeta.meta_value ) + FROM {$wpdb->prefix}woocommerce_order_itemmeta AS order_itemmeta + INNER JOIN $wpdb->posts AS posts ON ( posts.post_type = 'shop_order_refund' AND posts.post_parent = %d ) + INNER JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON ( order_items.order_id = posts.ID AND order_items.order_item_type = 'tax' ) + WHERE order_itemmeta.order_item_id = order_items.order_item_id + AND order_itemmeta.meta_key IN ('tax_amount', 'shipping_tax_amount')", + $order->get_id() + ) + ); return abs( $total ); } @@ -311,20 +338,23 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Get the total shipping refunded. * - * @param WC_Order + * @param WC_Order $order Order object. * @return float */ public function get_total_shipping_refunded( $order ) { global $wpdb; - $total = $wpdb->get_var( $wpdb->prepare( " - SELECT SUM( order_itemmeta.meta_value ) - FROM {$wpdb->prefix}woocommerce_order_itemmeta AS order_itemmeta - INNER JOIN $wpdb->posts AS posts ON ( posts.post_type = 'shop_order_refund' AND posts.post_parent = %d ) - INNER JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON ( order_items.order_id = posts.ID AND order_items.order_item_type = 'shipping' ) - WHERE order_itemmeta.order_item_id = order_items.order_item_id - AND order_itemmeta.meta_key IN ('cost') - ", $order->get_id() ) ); + $total = $wpdb->get_var( + $wpdb->prepare( + "SELECT SUM( order_itemmeta.meta_value ) + FROM {$wpdb->prefix}woocommerce_order_itemmeta AS order_itemmeta + INNER JOIN $wpdb->posts AS posts ON ( posts.post_type = 'shop_order_refund' AND posts.post_parent = %d ) + INNER JOIN {$wpdb->prefix}woocommerce_order_items AS order_items ON ( order_items.order_id = posts.ID AND order_items.order_item_type = 'shipping' ) + WHERE order_itemmeta.order_item_id = order_items.order_item_id + AND order_itemmeta.meta_key IN ('cost')", + $order->get_id() + ) + ); return abs( $total ); } @@ -332,7 +362,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Finds an Order ID based on an order key. * - * @param string $order_key An order key has generated by + * @param string $order_key An order key has generated by. * @return int The ID of an order, or 0 if the order could not be found */ public function get_order_id_by_order_key( $order_key ) { @@ -343,7 +373,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Return count of orders with a specific status. * - * @param string $status + * @param string $status Order status. Function wc_get_order_statuses() returns a list of valid statuses. * @return int */ public function get_order_count( $status ) { @@ -357,7 +387,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement * @deprecated 3.1.0 - Use wc_get_orders instead. * @see wc_get_orders() * - * @param array $args + * @param array $args List of args passed to wc_get_orders(). * * @return array|object */ @@ -369,19 +399,19 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Generate meta query for wc_get_orders. * - * @param array $values - * @param string $relation + * @param array $values List of customers ids or emails. + * @param string $relation 'or' or 'and' relation used to build the WP meta_query. * @return array */ private function get_orders_generate_customer_meta_query( $values, $relation = 'or' ) { $meta_query = array( - 'relation' => strtoupper( $relation ), + 'relation' => strtoupper( $relation ), 'customer_emails' => array( 'key' => '_billing_email', 'value' => array(), 'compare' => 'IN', ), - 'customer_ids' => array( + 'customer_ids' => array( 'key' => '_customer_user', 'value' => array(), 'compare' => 'IN', @@ -419,19 +449,24 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Get unpaid orders after a certain date, * - * @param int $date timestamp + * @param int $date Timestamp. * @return array */ public function get_unpaid_orders( $date ) { global $wpdb; - $unpaid_orders = $wpdb->get_col( $wpdb->prepare( " - SELECT posts.ID - FROM {$wpdb->posts} AS posts - WHERE posts.post_type IN ('" . implode( "','", wc_get_order_types() ) . "') - AND posts.post_status = 'wc-pending' - AND posts.post_modified < %s - ", date( 'Y-m-d H:i:s', absint( $date ) ) ) ); + $unpaid_orders = $wpdb->get_col( + $wpdb->prepare( + // @codingStandardsIgnoreStart + "SELECT posts.ID + FROM {$wpdb->posts} AS posts + WHERE posts.post_type IN ('" . implode( "','", wc_get_order_types() ) . "') + AND posts.post_status = 'wc-pending' + AND posts.post_modified < %s", + // @codingStandardsIgnoreEnd + date( 'Y-m-d H:i:s', absint( $date ) ) + ) + ); return $unpaid_orders; } @@ -439,7 +474,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Search order data for a term and return ids. * - * @param string $term + * @param string $term Searched term. * @return array of ids */ public function search_orders( $term ) { @@ -449,36 +484,45 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement * Searches on meta data can be slow - this lets you choose what fields to search. * 3.0.0 added _billing_address and _shipping_address meta which contains all address data to make this faster. * This however won't work on older orders unless updated, so search a few others (expand this using the filter if needed). + * * @var array */ - $search_fields = array_map( 'wc_clean', apply_filters( 'woocommerce_shop_order_search_fields', array( - '_billing_address_index', - '_shipping_address_index', - '_billing_last_name', - '_billing_email', - ) ) ); - $order_ids = array(); + $search_fields = array_map( + 'wc_clean', apply_filters( + 'woocommerce_shop_order_search_fields', array( + '_billing_address_index', + '_shipping_address_index', + '_billing_last_name', + '_billing_email', + ) + ) + ); + $order_ids = array(); if ( is_numeric( $term ) ) { $order_ids[] = absint( $term ); } if ( ! empty( $search_fields ) ) { - $order_ids = array_unique( array_merge( - $order_ids, - $wpdb->get_col( - $wpdb->prepare( "SELECT DISTINCT p1.post_id FROM {$wpdb->postmeta} p1 WHERE p1.meta_value LIKE '%%%s%%'", $wpdb->esc_like( wc_clean( $term ) ) ) . " AND p1.meta_key IN ('" . implode( "','", array_map( 'esc_sql', $search_fields ) ) . "')" - ), - $wpdb->get_col( - $wpdb->prepare( " - SELECT order_id - FROM {$wpdb->prefix}woocommerce_order_items as order_items - WHERE order_item_name LIKE '%%%s%%' - ", - $wpdb->esc_like( wc_clean( $term ) ) + $order_ids = array_unique( + array_merge( + $order_ids, + $wpdb->get_col( + $wpdb->prepare( + "SELECT DISTINCT p1.post_id FROM {$wpdb->postmeta} p1 WHERE p1.meta_value LIKE %s AND p1.meta_key IN ('" . implode( "','", array_map( 'esc_sql', $search_fields ) ) . "')", // @codingStandardsIgnoreLine + '%' . $wpdb->esc_like( wc_clean( $term ) ) . '%' + ) + ), + $wpdb->get_col( + $wpdb->prepare( + "SELECT order_id + FROM {$wpdb->prefix}woocommerce_order_items as order_items + WHERE order_item_name LIKE %s", + '%' . $wpdb->esc_like( wc_clean( $term ) ) . '%' + ) ) ) - ) ); + ); } return apply_filters( 'woocommerce_shop_order_search_results', $order_ids, $term, $search_fields ); @@ -487,7 +531,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Gets information about whether permissions were generated yet. * - * @param WC_Order|int $order + * @param WC_Order|int $order Order ID or order object. * @return bool */ public function get_download_permissions_granted( $order ) { @@ -498,8 +542,8 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Stores information about whether permissions were generated yet. * - * @param WC_Order|int $order - * @param bool $set + * @param WC_Order|int $order Order ID or order object. + * @param bool $set True or false. */ public function set_download_permissions_granted( $order, $set ) { $order_id = WC_Order_Factory::get_order_id( $order ); @@ -509,7 +553,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Gets information about whether sales were recorded. * - * @param WC_Order|int $order + * @param WC_Order|int $order Order ID or order object. * @return bool */ public function get_recorded_sales( $order ) { @@ -520,8 +564,8 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Stores information about whether sales were recorded. * - * @param WC_Order|int $order - * @param bool $set + * @param WC_Order|int $order Order ID or order object. + * @param bool $set True or false. */ public function set_recorded_sales( $order, $set ) { $order_id = WC_Order_Factory::get_order_id( $order ); @@ -531,7 +575,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Gets information about whether coupon counts were updated. * - * @param WC_Order|int $order + * @param WC_Order|int $order Order ID or order object. * @return bool */ public function get_recorded_coupon_usage_counts( $order ) { @@ -542,8 +586,8 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Stores information about whether coupon counts were updated. * - * @param WC_Order|int $order - * @param bool $set + * @param WC_Order|int $order Order ID or order object. + * @param bool $set True or false. */ public function set_recorded_coupon_usage_counts( $order, $set ) { $order_id = WC_Order_Factory::get_order_id( $order ); @@ -553,7 +597,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Gets information about whether stock was reduced. * - * @param WC_Order|int $order + * @param WC_Order|int $order Order ID or order object. * @return bool */ public function get_stock_reduced( $order ) { @@ -564,8 +608,8 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement /** * Stores information about whether stock was reduced. * - * @param WC_Order|int $order - * @param bool $set + * @param WC_Order|int $order Order ID or order object. + * @param bool $set True or false. */ public function set_stock_reduced( $order, $set ) { $order_id = WC_Order_Factory::get_order_id( $order ); @@ -576,7 +620,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement * Get the order type based on Order ID. * * @since 3.0.0 - * @param int $order_id + * @param int $order_id Order ID. * @return string */ public function get_order_type( $order_id ) { @@ -587,7 +631,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement * Get valid WP_Query args from a WC_Order_Query's query variables. * * @since 3.1.0 - * @param array $query_vars query vars from a WC_Order_Query + * @param array $query_vars query vars from a WC_Order_Query. * @return array */ protected function get_wp_query_args( $query_vars ) { @@ -607,6 +651,11 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement 'page' => 'paged', ); + // On WC 3.5.0 the ID of the user that placed the order was moved from the post meta _customer_user to the post_author field in the wp_posts table. + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '>=' ) ) { + $key_mapping['customer_id'] = 'author'; + } + foreach ( $key_mapping as $query_key => $db_key ) { if ( isset( $query_vars[ $query_key ] ) ) { $query_vars[ $db_key ] = $query_vars[ $query_key ]; @@ -645,8 +694,9 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement // Remove any existing meta queries for the same keys to prevent conflicts. $existing_queries = wp_list_pluck( $wp_query_args['meta_query'], 'key', true ); - foreach ( $existing_queries as $query_index => $query_contents ) { - unset( $wp_query_args['meta_query'][ $query_index ] ); + $meta_query_index = array_search( $db_key, $existing_queries, true ); + if ( false !== $meta_query_index ) { + unset( $wp_query_args['meta_query'][ $meta_query_index ] ); } $wp_query_args = $this->parse_date_for_wp_query( $query_vars[ $query_var_key ], $db_key, $wp_query_args ); @@ -654,7 +704,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement } if ( isset( $query_vars['customer'] ) && '' !== $query_vars['customer'] && array() !== $query_vars['customer'] ) { - $values = is_array( $query_vars['customer'] ) ? $query_vars['customer'] : array( $query_vars['customer'] ); + $values = is_array( $query_vars['customer'] ) ? $query_vars['customer'] : array( $query_vars['customer'] ); $customer_query = $this->get_orders_generate_customer_meta_query( $values ); if ( is_wp_error( $customer_query ) ) { $wp_query_args['errors'][] = $customer_query; @@ -663,6 +713,20 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement } } + if ( isset( $query_vars['anonymized'] ) ) { + if ( $query_vars['anonymized'] ) { + $wp_query_args['meta_query'][] = array( + 'key' => '_anonymized', + 'value' => 'yes', + ); + } else { + $wp_query_args['meta_query'][] = array( + 'key' => '_anonymized', + 'compare' => 'NOT EXISTS', + ); + } + } + if ( ! isset( $query_vars['paginate'] ) || ! $query_vars['paginate'] ) { $wp_query_args['no_found_rows'] = true; } @@ -675,7 +739,7 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement * * @since 3.1.0 * - * @param array $query_vars query vars from a WC_Order_Query + * @param array $query_vars query vars from a WC_Order_Query. * * @return array|object */ @@ -684,8 +748,8 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement if ( ! empty( $args['errors'] ) ) { $query = (object) array( - 'posts' => array(), - 'found_posts' => 0, + 'posts' => array(), + 'found_posts' => 0, 'max_num_pages' => 0, ); } else { @@ -704,4 +768,17 @@ class WC_Order_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT implement return $orders; } + + /** + * Return the order type of a given item which belongs to WC_Order. + * + * @since 3.2.0 + * @param WC_Order $order Order Object. + * @param int $order_item_id Order item id. + * @return string Order Item type + */ + public function get_order_item_type( $order, $order_item_id ) { + global $wpdb; + return $wpdb->get_var( $wpdb->prepare( "SELECT DISTINCT order_item_type FROM {$wpdb->prefix}woocommerce_order_items WHERE order_id = %d and order_item_id = %d;", $order->get_id(), $order_item_id ) ); + } } diff --git a/includes/data-stores/class-wc-order-item-coupon-data-store.php b/includes/data-stores/class-wc-order-item-coupon-data-store.php index ac2780d20ce..01eeb9dc83c 100644 --- a/includes/data-stores/class-wc-order-item-coupon-data-store.php +++ b/includes/data-stores/class-wc-order-item-coupon-data-store.php @@ -1,4 +1,10 @@ get_id(); - $item->set_props( array( - 'discount' => get_metadata( 'order_item', $id, 'discount_amount', true ), - 'discount_tax' => get_metadata( 'order_item', $id, 'discount_amount_tax', true ), - ) ); + $item->set_props( + array( + 'discount' => get_metadata( 'order_item', $id, 'discount_amount', true ), + 'discount_tax' => get_metadata( 'order_item', $id, 'discount_amount_tax', true ), + ) + ); $item->set_object_read( true ); } @@ -40,7 +47,7 @@ class WC_Order_Item_Coupon_Data_Store extends Abstract_WC_Order_Item_Type_Data_S * Ran after both create and update, so $item->get_id() will be set. * * @since 3.0.0 - * @param WC_Order_Item_Coupon $item + * @param WC_Order_Item_Coupon $item Coupon order item. */ public function save_item_data( &$item ) { $id = $item->get_id(); diff --git a/includes/data-stores/class-wc-order-item-data-store.php b/includes/data-stores/class-wc-order-item-data-store.php index 1f847ce7341..be4ea1a5283 100644 --- a/includes/data-stores/class-wc-order-item-data-store.php +++ b/includes/data-stores/class-wc-order-item-data-store.php @@ -1,4 +1,10 @@ insert( - $wpdb->prefix . "woocommerce_order_items", + $wpdb->prefix . 'woocommerce_order_items', array( - 'order_item_name' => $item['order_item_name'], - 'order_item_type' => $item['order_item_type'], - 'order_id' => $order_id, + 'order_item_name' => $item['order_item_name'], + 'order_item_type' => $item['order_item_type'], + 'order_id' => $order_id, ), array( '%s', @@ -43,7 +47,7 @@ class WC_Order_Item_Data_Store implements WC_Order_Item_Data_Store_Interface { * Update an order item. * * @since 3.0.0 - * @param int $item_id + * @param int $item_id Item ID. * @param array $item order_item_name or order_item_type. * @return boolean */ @@ -56,7 +60,7 @@ class WC_Order_Item_Data_Store implements WC_Order_Item_Data_Store_Interface { * Delete an order item. * * @since 3.0.0 - * @param int $item_id + * @param int $item_id Item ID. */ public function delete_order_item( $item_id ) { global $wpdb; @@ -68,10 +72,10 @@ class WC_Order_Item_Data_Store implements WC_Order_Item_Data_Store_Interface { * Update term meta. * * @since 3.0.0 - * @param int $item_id - * @param string $meta_key - * @param mixed $meta_value - * @param string $prev_value (default: '') + * @param int $item_id Item ID. + * @param string $meta_key Meta key. + * @param mixed $meta_value Meta value. + * @param string $prev_value (default: ''). * @return bool */ public function update_metadata( $item_id, $meta_key, $meta_value, $prev_value = '' ) { @@ -82,10 +86,10 @@ class WC_Order_Item_Data_Store implements WC_Order_Item_Data_Store_Interface { * Add term meta. * * @since 3.0.0 - * @param int $item_id - * @param string $meta_key - * @param mixed $meta_value - * @param bool $unique (default: false) + * @param int $item_id Item ID. + * @param string $meta_key Meta key. + * @param mixed $meta_value Meta value. + * @param bool $unique (default: false). * @return int New row ID or 0 */ public function add_metadata( $item_id, $meta_key, $meta_value, $unique = false ) { @@ -96,10 +100,10 @@ class WC_Order_Item_Data_Store implements WC_Order_Item_Data_Store_Interface { * Delete term meta. * * @since 3.0.0 - * @param int $item_id - * @param string $meta_key - * @param string $meta_value (default: '') - * @param bool $delete_all (default: false) + * @param int $item_id Item ID. + * @param string $meta_key Meta key. + * @param string $meta_value (default: ''). + * @param bool $delete_all (default: false). * @return bool */ public function delete_metadata( $item_id, $meta_key, $meta_value = '', $delete_all = false ) { @@ -110,9 +114,9 @@ class WC_Order_Item_Data_Store implements WC_Order_Item_Data_Store_Interface { * Get term meta. * * @since 3.0.0 - * @param int $item_id - * @param string $key - * @param bool $single (default: true) + * @param int $item_id Item ID. + * @param string $key Meta key. + * @param bool $single (default: true). * @return mixed */ public function get_metadata( $item_id, $key, $single = true ) { @@ -123,22 +127,24 @@ class WC_Order_Item_Data_Store implements WC_Order_Item_Data_Store_Interface { * Get order ID by order item ID. * * @since 3.0.0 - * @param int $item_id + * @param int $item_id Item ID. * @return int */ - function get_order_id_by_order_item_id( $item_id ) { + public function get_order_id_by_order_item_id( $item_id ) { global $wpdb; - return (int) $wpdb->get_var( $wpdb->prepare( - "SELECT order_id FROM {$wpdb->prefix}woocommerce_order_items WHERE order_item_id = %d", - $item_id - ) ); + return (int) $wpdb->get_var( + $wpdb->prepare( + "SELECT order_id FROM {$wpdb->prefix}woocommerce_order_items WHERE order_item_id = %d", + $item_id + ) + ); } /** * Get the order item type based on Item ID. * * @since 3.0.0 - * @param int $item_id + * @param int $item_id Item ID. * @return string */ public function get_order_item_type( $item_id ) { diff --git a/includes/data-stores/class-wc-order-item-fee-data-store.php b/includes/data-stores/class-wc-order-item-fee-data-store.php index 6f748dde876..2222d064f31 100644 --- a/includes/data-stores/class-wc-order-item-fee-data-store.php +++ b/includes/data-stores/class-wc-order-item-fee-data-store.php @@ -1,4 +1,10 @@ get_id(); - $item->set_props( array( - 'tax_class' => get_metadata( 'order_item', $id, '_tax_class', true ), - 'tax_status' => get_metadata( 'order_item', $id, '_tax_status', true ), - 'total' => get_metadata( 'order_item', $id, '_line_total', true ), - 'taxes' => get_metadata( 'order_item', $id, '_line_tax_data', true ), - ) ); + $item->set_props( + array( + 'amount' => get_metadata( 'order_item', $id, '_fee_amount', true ), + 'tax_class' => get_metadata( 'order_item', $id, '_tax_class', true ), + 'tax_status' => get_metadata( 'order_item', $id, '_tax_status', true ), + 'total' => get_metadata( 'order_item', $id, '_line_total', true ), + 'taxes' => get_metadata( 'order_item', $id, '_line_tax_data', true ), + ) + ); $item->set_object_read( true ); } @@ -42,11 +50,12 @@ class WC_Order_Item_Fee_Data_Store extends Abstract_WC_Order_Item_Type_Data_Stor * Ran after both create and update, so $id will be set. * * @since 3.0.0 - * @param WC_Order_Item_Fee $item + * @param WC_Order_Item_Fee $item Fee order item object. */ public function save_item_data( &$item ) { $id = $item->get_id(); $save_values = array( + '_fee_amount' => $item->get_amount( 'edit' ), '_tax_class' => $item->get_tax_class( 'edit' ), '_tax_status' => $item->get_tax_status( 'edit' ), '_line_total' => $item->get_total( 'edit' ), diff --git a/includes/data-stores/class-wc-order-item-product-data-store.php b/includes/data-stores/class-wc-order-item-product-data-store.php new file mode 100644 index 00000000000..2f78691b578 --- /dev/null +++ b/includes/data-stores/class-wc-order-item-product-data-store.php @@ -0,0 +1,97 @@ +get_id(); + $item->set_props( + array( + 'product_id' => get_metadata( 'order_item', $id, '_product_id', true ), + 'variation_id' => get_metadata( 'order_item', $id, '_variation_id', true ), + 'quantity' => get_metadata( 'order_item', $id, '_qty', true ), + 'tax_class' => get_metadata( 'order_item', $id, '_tax_class', true ), + 'subtotal' => get_metadata( 'order_item', $id, '_line_subtotal', true ), + 'total' => get_metadata( 'order_item', $id, '_line_total', true ), + 'taxes' => get_metadata( 'order_item', $id, '_line_tax_data', true ), + ) + ); + $item->set_object_read( true ); + } + + /** + * Saves an item's data to the database / item meta. + * Ran after both create and update, so $id will be set. + * + * @since 3.0.0 + * @param WC_Order_Item_Product $item Product order item object. + */ + public function save_item_data( &$item ) { + $id = $item->get_id(); + $changes = $item->get_changes(); + $meta_key_to_props = array( + '_product_id' => 'product_id', + '_variation_id' => 'variation_id', + '_qty' => 'quantity', + '_tax_class' => 'tax_class', + '_line_subtotal' => 'subtotal', + '_line_subtotal_tax' => 'subtotal_tax', + '_line_total' => 'total', + '_line_tax' => 'total_tax', + '_line_tax_data' => 'taxes', + ); + $props_to_update = $this->get_props_to_update( $item, $meta_key_to_props, 'order_item' ); + + foreach ( $props_to_update as $meta_key => $prop ) { + update_metadata( 'order_item', $id, $meta_key, $item->{"get_$prop"}( 'edit' ) ); + } + } + + /** + * Get a list of download IDs for a specific item from an order. + * + * @since 3.0.0 + * @param WC_Order_Item_Product $item Product order item object. + * @param WC_Order $order Order object. + * @return array + */ + public function get_download_ids( $item, $order ) { + global $wpdb; + return $wpdb->get_col( + $wpdb->prepare( + "SELECT download_id FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions WHERE user_email = %s AND order_key = %s AND product_id = %d ORDER BY permission_id", + $order->get_billing_email(), + $order->get_order_key(), + $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id() + ) + ); + } +} diff --git a/includes/data-stores/class-wc-order-item-product-store.php b/includes/data-stores/class-wc-order-item-product-store.php deleted file mode 100644 index f7f8025b640..00000000000 --- a/includes/data-stores/class-wc-order-item-product-store.php +++ /dev/null @@ -1,87 +0,0 @@ -get_id(); - $item->set_props( array( - 'product_id' => get_metadata( 'order_item', $id, '_product_id', true ), - 'variation_id' => get_metadata( 'order_item', $id, '_variation_id', true ), - 'quantity' => get_metadata( 'order_item', $id, '_qty', true ), - 'tax_class' => get_metadata( 'order_item', $id, '_tax_class', true ), - 'subtotal' => get_metadata( 'order_item', $id, '_line_subtotal', true ), - 'total' => get_metadata( 'order_item', $id, '_line_total', true ), - 'taxes' => get_metadata( 'order_item', $id, '_line_tax_data', true ), - ) ); - $item->set_object_read( true ); - } - - /** - * Saves an item's data to the database / item meta. - * Ran after both create and update, so $id will be set. - * - * @since 3.0.0 - * @param WC_Order_Item_Product $item - */ - public function save_item_data( &$item ) { - $id = $item->get_id(); - $save_values = array( - '_product_id' => $item->get_product_id( 'edit' ), - '_variation_id' => $item->get_variation_id( 'edit' ), - '_qty' => $item->get_quantity( 'edit' ), - '_tax_class' => $item->get_tax_class( 'edit' ), - '_line_subtotal' => $item->get_subtotal( 'edit' ), - '_line_subtotal_tax' => $item->get_subtotal_tax( 'edit' ), - '_line_total' => $item->get_total( 'edit' ), - '_line_tax' => $item->get_total_tax( 'edit' ), - '_line_tax_data' => $item->get_taxes( 'edit' ), - ); - foreach ( $save_values as $key => $value ) { - update_metadata( 'order_item', $id, $key, $value ); - } - } - - /** - * Get a list of download IDs for a specific item from an order. - * - * @since 3.0.0 - * @param WC_Order_Item_Product $item - * @param WC_Order $order - * @return array - */ - public function get_download_ids( $item, $order ) { - global $wpdb; - return $wpdb->get_col( - $wpdb->prepare( - "SELECT download_id FROM {$wpdb->prefix}woocommerce_downloadable_product_permissions WHERE user_email = %s AND order_key = %s AND product_id = %d ORDER BY permission_id", - $order->get_billing_email(), - $order->get_order_key(), - $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id() - ) - ); - } -} diff --git a/includes/data-stores/class-wc-order-item-shipping-data-store.php b/includes/data-stores/class-wc-order-item-shipping-data-store.php index 48cd5b8c53d..e09545dfa30 100644 --- a/includes/data-stores/class-wc-order-item-shipping-data-store.php +++ b/includes/data-stores/class-wc-order-item-shipping-data-store.php @@ -1,38 +1,54 @@ get_id(); - $item->set_props( array( - 'method_id' => get_metadata( 'order_item', $id, 'method_id', true ), - 'total' => get_metadata( 'order_item', $id, 'cost', true ), - 'taxes' => get_metadata( 'order_item', $id, 'taxes', true ), - ) ); + $item->set_props( + array( + 'method_id' => get_metadata( 'order_item', $id, 'method_id', true ), + 'instance_id' => get_metadata( 'order_item', $id, 'instance_id', true ), + 'total' => get_metadata( 'order_item', $id, 'cost', true ), + 'taxes' => get_metadata( 'order_item', $id, 'taxes', true ), + ) + ); + + // BW compat. + if ( '' === $item->get_instance_id() && strstr( $item->get_method_id(), ':' ) ) { + $legacy_method_id = explode( ':', $item->get_method_id() ); + $item->set_method_id( $legacy_method_id[0] ); + $item->set_instance_id( $legacy_method_id[1] ); + } + $item->set_object_read( true ); } @@ -41,18 +57,22 @@ class WC_Order_Item_Shipping_Data_Store extends Abstract_WC_Order_Item_Type_Data * Ran after both create and update, so $id will be set. * * @since 3.0.0 - * @param WC_Order_Item_Shipping $item + * @param WC_Order_Item_Shipping $item Item to save. */ public function save_item_data( &$item ) { - $id = $item->get_id(); - $save_values = array( - 'method_id' => $item->get_method_id( 'edit' ), - 'cost' => $item->get_total( 'edit' ), - 'total_tax' => $item->get_total_tax( 'edit' ), - 'taxes' => $item->get_taxes( 'edit' ), + $id = $item->get_id(); + $changes = $item->get_changes(); + $meta_key_to_props = array( + 'method_id' => 'method_id', + 'instance_id' => 'instance_id', + 'cost' => 'total', + 'total_tax' => 'total_tax', + 'taxes' => 'taxes', ); - foreach ( $save_values as $key => $value ) { - update_metadata( 'order_item', $id, $key, $value ); + $props_to_update = $this->get_props_to_update( $item, $meta_key_to_props, 'order_item' ); + + foreach ( $props_to_update as $meta_key => $prop ) { + update_metadata( 'order_item', $id, $meta_key, $item->{"get_$prop"}( 'edit' ) ); } } } diff --git a/includes/data-stores/class-wc-order-item-tax-data-store.php b/includes/data-stores/class-wc-order-item-tax-data-store.php index 5619143ddc5..6a9793dbb1c 100644 --- a/includes/data-stores/class-wc-order-item-tax-data-store.php +++ b/includes/data-stores/class-wc-order-item-tax-data-store.php @@ -1,4 +1,10 @@ get_id(); - $item->set_props( array( - 'rate_id' => get_metadata( 'order_item', $id, 'rate_id', true ), - 'label' => get_metadata( 'order_item', $id, 'label', true ), - 'compound' => get_metadata( 'order_item', $id, 'compound', true ), - 'tax_total' => get_metadata( 'order_item', $id, 'tax_amount', true ), - 'shipping_tax_total' => get_metadata( 'order_item', $id, 'shipping_tax_amount', true ), - ) ); + $item->set_props( + array( + 'rate_id' => get_metadata( 'order_item', $id, 'rate_id', true ), + 'label' => get_metadata( 'order_item', $id, 'label', true ), + 'compound' => get_metadata( 'order_item', $id, 'compound', true ), + 'tax_total' => get_metadata( 'order_item', $id, 'tax_amount', true ), + 'shipping_tax_total' => get_metadata( 'order_item', $id, 'shipping_tax_amount', true ), + ) + ); $item->set_object_read( true ); } @@ -43,19 +51,22 @@ class WC_Order_Item_Tax_Data_Store extends Abstract_WC_Order_Item_Type_Data_Stor * Ran after both create and update, so $id will be set. * * @since 3.0.0 - * @param WC_Order_Item_Tax $item + * @param WC_Order_Item_Tax $item Tax order item object. */ public function save_item_data( &$item ) { - $id = $item->get_id(); - $save_values = array( - 'rate_id' => $item->get_rate_id( 'edit' ), - 'label' => $item->get_label( 'edit' ), - 'compound' => $item->get_compound( 'edit' ), - 'tax_amount' => $item->get_tax_total( 'edit' ), - 'shipping_tax_amount' => $item->get_shipping_tax_total( 'edit' ), + $id = $item->get_id(); + $changes = $item->get_changes(); + $meta_key_to_props = array( + 'rate_id' => 'rate_id', + 'label' => 'label', + 'compound' => 'compound', + 'tax_amount' => 'tax_total', + 'shipping_tax_amount' => 'shipping_tax_total', ); - foreach ( $save_values as $key => $value ) { - update_metadata( 'order_item', $id, $key, $value ); + $props_to_update = $this->get_props_to_update( $item, $meta_key_to_props, 'order_item' ); + + foreach ( $props_to_update as $meta_key => $prop ) { + update_metadata( 'order_item', $id, $meta_key, $item->{"get_$prop"}( 'edit' ) ); } } } diff --git a/includes/data-stores/class-wc-order-refund-data-store-cpt.php b/includes/data-stores/class-wc-order-refund-data-store-cpt.php index b77592aab1e..04cc170dcdd 100644 --- a/includes/data-stores/class-wc-order-refund-data-store-cpt.php +++ b/includes/data-stores/class-wc-order-refund-data-store-cpt.php @@ -1,4 +1,10 @@ get_id(); @@ -53,25 +60,27 @@ class WC_Order_Refund_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT im /** * Read refund data. Can be overridden by child classes to load other props. * - * @param WC_Order $refund - * @param object $post_object + * @param WC_Order $refund Refund object. + * @param object $post_object Post object. * @since 3.0.0 */ protected function read_order_data( &$refund, $post_object ) { parent::read_order_data( $refund, $post_object ); $id = $refund->get_id(); - $refund->set_props( array( - 'amount' => get_post_meta( $id, '_refund_amount', true ), - 'refunded_by' => metadata_exists( 'post', $id, '_refunded_by' ) ? get_post_meta( $id, '_refunded_by', true ) : absint( $post_object->post_author ), - 'reason' => metadata_exists( 'post', $id, '_refund_reason' ) ? get_post_meta( $id, '_refund_reason', true ) : $post_object->post_excerpt, - ) ); + $refund->set_props( + array( + 'amount' => get_post_meta( $id, '_refund_amount', true ), + 'refunded_by' => metadata_exists( 'post', $id, '_refunded_by' ) ? get_post_meta( $id, '_refunded_by', true ) : absint( $post_object->post_author ), + 'refunded_payment' => wc_string_to_bool( get_post_meta( $id, '_refunded_payment', true ) ), + 'reason' => metadata_exists( 'post', $id, '_refund_reason' ) ? get_post_meta( $id, '_refund_reason', true ): $post_object->post_excerpt, + ) + ); } /** * Helper method that updates all the post meta for an order based on it's settings in the WC_Order class. * - * @param WC_Order - * @param WC_Order $refund + * @param WC_Order $refund Refund object. * @since 3.0.0 */ protected function update_post_meta( &$refund ) { @@ -79,9 +88,10 @@ class WC_Order_Refund_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT im $updated_props = array(); $meta_key_to_props = array( - '_refund_amount' => 'amount', - '_refunded_by' => 'refunded_by', - '_refund_reason' => 'reason', + '_refund_amount' => 'amount', + '_refunded_by' => 'refunded_by', + '_refunded_payment' => 'refunded_payment', + '_refund_reason' => 'reason', ); $props_to_update = $this->get_props_to_update( $refund, $meta_key_to_props ); @@ -100,9 +110,10 @@ class WC_Order_Refund_Data_Store_CPT extends Abstract_WC_Order_Data_Store_CPT im * @return string */ protected function get_post_title() { - // @codingStandardsIgnoreStart - /* translators: %s: Order date */ - return sprintf( __( 'Refund – %s', 'woocommerce' ), strftime( _x( '%b %d, %Y @ %I:%M %p', 'Order date parsed by strftime', 'woocommerce' ) ) ); - // @codingStandardsIgnoreEnd + return sprintf( + /* translators: %s: Order date */ + __( 'Refund – %s', 'woocommerce' ), + strftime( _x( '%b %d, %Y @ %I:%M %p', 'Order date parsed by strftime', 'woocommerce' ) ) // phpcs:ignore WordPress.WP.I18n.MissingTranslatorsComment, WordPress.WP.I18n.UnorderedPlaceholdersText + ); } } diff --git a/includes/data-stores/class-wc-payment-token-data-store.php b/includes/data-stores/class-wc-payment-token-data-store.php index cfea3cfa593..e6aee033c00 100644 --- a/includes/data-stores/class-wc-payment-token-data-store.php +++ b/includes/data-stores/class-wc-payment-token-data-store.php @@ -1,4 +1,10 @@ validate() ) { @@ -59,7 +66,7 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment $token->save_meta_data(); $token->apply_changes(); - // Make sure all other tokens are not set to default + // Make sure all other tokens are not set to default. if ( $token->is_default() && $token->get_user_id() > 0 ) { WC_Payment_Tokens::set_users_default( $token->get_user_id(), $token_id ); } @@ -72,9 +79,9 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * * @since 3.0.0 * - * @param WC_Payment_Token $token + * @param WC_Payment_Token $token Payment token object. * - * @throws Exception + * @throws Exception Throw exception if invalid or missing payment token fields. */ public function update( &$token ) { if ( false === $token->validate() ) { @@ -83,16 +90,16 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment global $wpdb; - $updated_props = array(); - $core_props = array( 'gateway_id', 'token', 'user_id', 'type' ); - $changed_props = array_keys( $token->get_changes() ); + $updated_props = array(); + $core_props = array( 'gateway_id', 'token', 'user_id', 'type' ); + $changed_props = array_keys( $token->get_changes() ); foreach ( $changed_props as $prop ) { - if ( ! in_array( $prop, $core_props ) ) { + if ( ! in_array( $prop, $core_props, true ) ) { continue; } $updated_props[] = $prop; - $payment_token_data[ $prop ] = $token->{"get_" . $prop}( 'edit' ); + $payment_token_data[ $prop ] = $token->{'get_' . $prop}( 'edit' ); } if ( ! empty( $payment_token_data ) ) { @@ -108,7 +115,7 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment $token->save_meta_data(); $token->apply_changes(); - // Make sure all other tokens are not set to default + // Make sure all other tokens are not set to default. if ( $token->is_default() && $token->get_user_id() > 0 ) { WC_Payment_Tokens::set_users_default( $token->get_user_id(), $token->get_id() ); } @@ -121,8 +128,8 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * Remove a payment token from the database. * * @since 3.0.0 - * @param WC_Payment_Token $token - * @param bool $force_delete + * @param WC_Payment_Token $token Payment token object. + * @param bool $force_delete Unused param. */ public function delete( &$token, $force_delete = false ) { global $wpdb; @@ -136,19 +143,29 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * * @since 3.0.0 * - * @param WC_Payment_Token $token + * @param WC_Payment_Token $token Payment token object. * - * @throws Exception + * @throws Exception Throw exception if invalid payment token. */ public function read( &$token ) { global $wpdb; - if ( $data = $wpdb->get_row( $wpdb->prepare( "SELECT token, user_id, gateway_id, is_default FROM {$wpdb->prefix}woocommerce_payment_tokens WHERE token_id = %d LIMIT 1;", $token->get_id() ) ) ) { - $token->set_props( array( - 'token' => $data->token, - 'user_id' => $data->user_id, - 'gateway_id' => $data->gateway_id, - 'default' => $data->is_default, - ) ); + + $data = $wpdb->get_row( + $wpdb->prepare( + "SELECT token, user_id, gateway_id, is_default FROM {$wpdb->prefix}woocommerce_payment_tokens WHERE token_id = %d LIMIT 1", + $token->get_id() + ) + ); + + if ( $data ) { + $token->set_props( + array( + 'token' => $data->token, + 'user_id' => $data->user_id, + 'gateway_id' => $data->gateway_id, + 'default' => $data->is_default, + ) + ); $this->read_extra_data( $token ); $token->read_meta_data(); $token->set_object_read( true ); @@ -161,7 +178,7 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment /** * Read extra data associated with the token (like last4 digits of a card for expiry dates). * - * @param WC_Payment_Token + * @param WC_Payment_Token $token Payment token object. * @since 3.0.0 */ protected function read_extra_data( &$token ) { @@ -177,8 +194,8 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * Saves extra token data as meta. * * @since 3.0.0 - * @param $token WC_Token - * @param $force bool + * @param WC_Payment_Token $token Payment token object. + * @param bool $force By default, only changed props are updated. When this param is true all props are updated. * @return array List of updated props. */ protected function save_extra_data( &$token, $force = false ) { @@ -212,17 +229,19 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * Each object should contain the fields token_id, gateway_id, token, user_id, type, is_default. * * @since 3.0.0 - * @param array $args + * @param array $args List of accepted args: token_id, gateway_id, user_id, type. * @return array */ public function get_tokens( $args ) { global $wpdb; - $args = wp_parse_args( $args, array( - 'token_id' => '', - 'user_id' => '', - 'gateway_id' => '', - 'type' => '', - ) ); + $args = wp_parse_args( + $args, array( + 'token_id' => '', + 'user_id' => '', + 'gateway_id' => '', + 'type' => '', + ) + ); $sql = "SELECT * FROM {$wpdb->prefix}woocommerce_payment_tokens"; $where = array( '1=1' ); @@ -243,6 +262,12 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment $gateway_ids = $gateways->get_payment_gateway_ids(); } + $page = isset( $args['page'] ) ? absint( $args['page'] ) : 1; + $posts_per_page = isset( $args['limit'] ) ? absint( $args['limit'] ) : get_option( 'posts_per_page' ); + + $pgstrt = absint( ( $page - 1 ) * $posts_per_page ) . ', '; + $limits = 'LIMIT ' . $pgstrt . $posts_per_page; + $gateway_ids[] = ''; $where[] = "gateway_id IN ('" . implode( "','", array_map( 'esc_sql', $gateway_ids ) ) . "')"; @@ -250,7 +275,8 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment $where[] = $wpdb->prepare( 'type = %s', $args['type'] ); } - $token_results = $wpdb->get_results( $sql . ' WHERE ' . implode( ' AND ', $where ) ); + // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $token_results = $wpdb->get_results( $sql . ' WHERE ' . implode( ' AND ', $where ) . ' ' . $limits ); return $token_results; } @@ -260,15 +286,17 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * Should contain the fields token_id, gateway_id, token, user_id, type, is_default. * * @since 3.0.0 - * @param id $user_id + * @param id $user_id User ID. * @return object */ public function get_users_default_token( $user_id ) { global $wpdb; - return $wpdb->get_row( $wpdb->prepare( - "SELECT * FROM {$wpdb->prefix}woocommerce_payment_tokens WHERE user_id = %d AND is_default = 1", - $user_id - ) ); + return $wpdb->get_row( + $wpdb->prepare( + "SELECT * FROM {$wpdb->prefix}woocommerce_payment_tokens WHERE user_id = %d AND is_default = 1", + $user_id + ) + ); } /** @@ -276,22 +304,24 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * Should contain the fields token_id, gateway_id, token, user_id, type, is_default. * * @since 3.0.0 - * @param id $token_id + * @param id $token_id Token ID. * @return object */ public function get_token_by_id( $token_id ) { global $wpdb; - return $wpdb->get_row( $wpdb->prepare( - "SELECT * FROM {$wpdb->prefix}woocommerce_payment_tokens WHERE token_id = %d", - $token_id - ) ); + return $wpdb->get_row( + $wpdb->prepare( + "SELECT * FROM {$wpdb->prefix}woocommerce_payment_tokens WHERE token_id = %d", + $token_id + ) + ); } /** * Returns metadata for a specific payment token. * * @since 3.0.0 - * @param id $token_id + * @param id $token_id Token ID. * @return array */ public function get_metadata( $token_id ) { @@ -302,15 +332,17 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * Get a token's type by ID. * * @since 3.0.0 - * @param id $token_id + * @param id $token_id Token ID. * @return string */ public function get_token_type_by_id( $token_id ) { global $wpdb; - return $wpdb->get_var( $wpdb->prepare( - "SELECT type FROM {$wpdb->prefix}woocommerce_payment_tokens WHERE token_id = %d", - $token_id - ) ); + return $wpdb->get_var( + $wpdb->prepare( + "SELECT type FROM {$wpdb->prefix}woocommerce_payment_tokens WHERE token_id = %d", + $token_id + ) + ); } /** @@ -320,10 +352,10 @@ class WC_Payment_Token_Data_Store extends WC_Data_Store_WP implements WC_Payment * * @since 3.0.0 * - * @param id $token_id - * @param bool $status + * @param id $token_id Token ID. + * @param bool $status Whether given payment token is the default payment token or not. * - * @return string + * @return void */ public function set_default_status( $token_id, $status = true ) { global $wpdb; diff --git a/includes/data-stores/class-wc-product-data-store-cpt.php b/includes/data-stores/class-wc-product-data-store-cpt.php index 5fa2b9e0d4d..1b51964abe8 100644 --- a/includes/data-stores/class-wc-product-data-store-cpt.php +++ b/includes/data-stores/class-wc-product-data-store-cpt.php @@ -1,4 +1,10 @@ get_date_created() ) { + if ( ! $product->get_date_created( 'edit' ) ) { $product->set_date_created( current_time( 'timestamp', true ) ); } - $id = wp_insert_post( apply_filters( 'woocommerce_new_product_data', array( - 'post_type' => 'product', - 'post_status' => $product->get_status() ? $product->get_status() : 'publish', - 'post_author' => get_current_user_id(), - 'post_title' => $product->get_name() ? $product->get_name() : __( 'Product', 'woocommerce' ), - 'post_content' => $product->get_description(), - 'post_excerpt' => $product->get_short_description(), - 'post_parent' => $product->get_parent_id(), - 'comment_status' => $product->get_reviews_allowed() ? 'open' : 'closed', - 'ping_status' => 'closed', - 'menu_order' => $product->get_menu_order(), - 'post_date' => gmdate( 'Y-m-d H:i:s', $product->get_date_created( 'edit' )->getOffsetTimestamp() ), - 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $product->get_date_created( 'edit' )->getTimestamp() ), - 'post_name' => $product->get_slug( 'edit' ), - ) ), true ); + $id = wp_insert_post( + apply_filters( + 'woocommerce_new_product_data', array( + 'post_type' => 'product', + 'post_status' => $product->get_status() ? $product->get_status() : 'publish', + 'post_author' => get_current_user_id(), + 'post_title' => $product->get_name() ? $product->get_name() : __( 'Product', 'woocommerce' ), + 'post_content' => $product->get_description(), + 'post_excerpt' => $product->get_short_description(), + 'post_parent' => $product->get_parent_id(), + 'comment_status' => $product->get_reviews_allowed() ? 'open' : 'closed', + 'ping_status' => 'closed', + 'menu_order' => $product->get_menu_order(), + 'post_date' => gmdate( 'Y-m-d H:i:s', $product->get_date_created( 'edit' )->getOffsetTimestamp() ), + 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $product->get_date_created( 'edit' )->getTimestamp() ), + 'post_name' => $product->get_slug( 'edit' ), + ) + ), true + ); if ( $id && ! is_wp_error( $id ) ) { $product->set_id( $id ); @@ -124,30 +138,32 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Method to read a product from the database. - * @param WC_Product $product - * @throws Exception + * + * @param WC_Product $product Product object. + * @throws Exception If invalid product. */ public function read( &$product ) { $product->set_defaults(); + $post_object = get_post( $product->get_id() ); - if ( ! $product->get_id() || ! ( $post_object = get_post( $product->get_id() ) ) || 'product' !== $post_object->post_type ) { + if ( ! $product->get_id() || ! $post_object || 'product' !== $post_object->post_type ) { throw new Exception( __( 'Invalid product.', 'woocommerce' ) ); } - $id = $product->get_id(); - - $product->set_props( array( - 'name' => $post_object->post_title, - 'slug' => $post_object->post_name, - 'date_created' => 0 < $post_object->post_date_gmt ? wc_string_to_timestamp( $post_object->post_date_gmt ) : null, - 'date_modified' => 0 < $post_object->post_modified_gmt ? wc_string_to_timestamp( $post_object->post_modified_gmt ) : null, - 'status' => $post_object->post_status, - 'description' => $post_object->post_content, - 'short_description' => $post_object->post_excerpt, - 'parent_id' => $post_object->post_parent, - 'menu_order' => $post_object->menu_order, - 'reviews_allowed' => 'open' === $post_object->comment_status, - ) ); + $product->set_props( + array( + 'name' => $post_object->post_title, + 'slug' => $post_object->post_name, + 'date_created' => 0 < $post_object->post_date_gmt ? wc_string_to_timestamp( $post_object->post_date_gmt ) : null, + 'date_modified' => 0 < $post_object->post_modified_gmt ? wc_string_to_timestamp( $post_object->post_modified_gmt ) : null, + 'status' => $post_object->post_status, + 'description' => $post_object->post_content, + 'short_description' => $post_object->post_excerpt, + 'parent_id' => $post_object->post_parent, + 'menu_order' => $post_object->menu_order, + 'reviews_allowed' => 'open' === $post_object->comment_status, + ) + ); $this->read_attributes( $product ); $this->read_downloads( $product ); @@ -160,7 +176,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Method to update a product in the database. * - * @param WC_Product $product + * @param WC_Product $product Product object. */ public function update( &$product ) { $product->save_meta_data(); @@ -206,6 +222,19 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da wp_update_post( array_merge( array( 'ID' => $product->get_id() ), $post_data ) ); } $product->read_meta_data( true ); // Refresh internal meta data, in case things were hooked into `save_post` or another WP hook. + + } else { // Only update post modified time to record this save event. + $GLOBALS['wpdb']->update( + $GLOBALS['wpdb']->posts, + array( + 'post_modified' => current_time( 'mysql' ), + 'post_modified_gmt' => current_time( 'mysql', 1 ), + ), + array( + 'ID' => $product->get_id(), + ) + ); + clean_post_cache( $product->get_id() ); } $this->update_post_meta( $product ); @@ -224,22 +253,26 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Method to delete a product from the database. - * @param WC_Product $product - * @param array $args Array of args to pass to the delete method. + * + * @param WC_Product $product Product object. + * @param array $args Array of args to pass to the delete method. */ public function delete( &$product, $args = array() ) { $id = $product->get_id(); $post_type = $product->is_type( 'variation' ) ? 'product_variation' : 'product'; - $args = wp_parse_args( $args, array( - 'force_delete' => false, - ) ); + $args = wp_parse_args( + $args, array( + 'force_delete' => false, + ) + ); if ( ! $id ) { return; } if ( $args['force_delete'] ) { + do_action( 'woocommerce_before_delete_' . $post_type, $id ); wp_delete_post( $id ); $product->set_id( 0 ); do_action( 'woocommerce_delete_' . $post_type, $id ); @@ -259,69 +292,81 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Read product data. Can be overridden by child classes to load other props. * - * @param WC_Product + * @param WC_Product $product Product object. * @since 3.0.0 */ protected function read_product_data( &$product ) { - $id = $product->get_id(); + $id = $product->get_id(); + $review_count = get_post_meta( $id, '_wc_review_count', true ); + $rating_counts = get_post_meta( $id, '_wc_rating_count', true ); + $average_rating = get_post_meta( $id, '_wc_average_rating', true ); - if ( '' === ( $review_count = get_post_meta( $id, '_wc_review_count', true ) ) ) { + if ( '' === $review_count ) { WC_Comments::get_review_count_for_product( $product ); } else { $product->set_review_count( $review_count ); } - if ( '' === ( $rating_counts = get_post_meta( $id, '_wc_rating_count', true ) ) ) { + if ( '' === $rating_counts ) { WC_Comments::get_rating_counts_for_product( $product ); } else { $product->set_rating_counts( $rating_counts ); } - if ( '' === ( $average_rating = get_post_meta( $id, '_wc_average_rating', true ) ) ) { + if ( '' === $average_rating ) { WC_Comments::get_average_rating_for_product( $product ); } else { $product->set_average_rating( $average_rating ); } - $product->set_props( array( - 'sku' => get_post_meta( $id, '_sku', true ), - 'regular_price' => get_post_meta( $id, '_regular_price', true ), - 'sale_price' => get_post_meta( $id, '_sale_price', true ), - 'price' => get_post_meta( $id, '_price', true ), - 'date_on_sale_from' => get_post_meta( $id, '_sale_price_dates_from', true ), - 'date_on_sale_to' => get_post_meta( $id, '_sale_price_dates_to', true ), - 'total_sales' => get_post_meta( $id, 'total_sales', true ), - 'tax_status' => get_post_meta( $id, '_tax_status', true ), - 'tax_class' => get_post_meta( $id, '_tax_class', true ), - 'manage_stock' => get_post_meta( $id, '_manage_stock', true ), - 'stock_quantity' => get_post_meta( $id, '_stock', true ), - 'stock_status' => get_post_meta( $id, '_stock_status', true ), - 'backorders' => get_post_meta( $id, '_backorders', true ), - 'sold_individually' => get_post_meta( $id, '_sold_individually', true ), - 'weight' => get_post_meta( $id, '_weight', true ), - 'length' => get_post_meta( $id, '_length', true ), - 'width' => get_post_meta( $id, '_width', true ), - 'height' => get_post_meta( $id, '_height', true ), - 'upsell_ids' => get_post_meta( $id, '_upsell_ids', true ), - 'cross_sell_ids' => get_post_meta( $id, '_crosssell_ids', true ), - 'purchase_note' => get_post_meta( $id, '_purchase_note', true ), - 'default_attributes' => get_post_meta( $id, '_default_attributes', true ), - 'category_ids' => $this->get_term_ids( $product, 'product_cat' ), - 'tag_ids' => $this->get_term_ids( $product, 'product_tag' ), - 'shipping_class_id' => current( $this->get_term_ids( $product, 'product_shipping_class' ) ), - 'virtual' => get_post_meta( $id, '_virtual', true ), - 'downloadable' => get_post_meta( $id, '_downloadable', true ), - 'gallery_image_ids' => array_filter( explode( ',', get_post_meta( $id, '_product_image_gallery', true ) ) ), - 'download_limit' => get_post_meta( $id, '_download_limit', true ), - 'download_expiry' => get_post_meta( $id, '_download_expiry', true ), - 'image_id' => get_post_thumbnail_id( $id ), - ) ); + $product->set_props( + array( + 'sku' => get_post_meta( $id, '_sku', true ), + 'regular_price' => get_post_meta( $id, '_regular_price', true ), + 'sale_price' => get_post_meta( $id, '_sale_price', true ), + 'price' => get_post_meta( $id, '_price', true ), + 'date_on_sale_from' => get_post_meta( $id, '_sale_price_dates_from', true ), + 'date_on_sale_to' => get_post_meta( $id, '_sale_price_dates_to', true ), + 'total_sales' => get_post_meta( $id, 'total_sales', true ), + 'tax_status' => get_post_meta( $id, '_tax_status', true ), + 'tax_class' => get_post_meta( $id, '_tax_class', true ), + 'manage_stock' => get_post_meta( $id, '_manage_stock', true ), + 'stock_quantity' => get_post_meta( $id, '_stock', true ), + 'stock_status' => get_post_meta( $id, '_stock_status', true ), + 'backorders' => get_post_meta( $id, '_backorders', true ), + 'low_stock_amount' => get_post_meta( $id, '_low_stock_amount', true ), + 'sold_individually' => get_post_meta( $id, '_sold_individually', true ), + 'weight' => get_post_meta( $id, '_weight', true ), + 'length' => get_post_meta( $id, '_length', true ), + 'width' => get_post_meta( $id, '_width', true ), + 'height' => get_post_meta( $id, '_height', true ), + 'upsell_ids' => get_post_meta( $id, '_upsell_ids', true ), + 'cross_sell_ids' => get_post_meta( $id, '_crosssell_ids', true ), + 'purchase_note' => get_post_meta( $id, '_purchase_note', true ), + 'default_attributes' => get_post_meta( $id, '_default_attributes', true ), + 'category_ids' => $this->get_term_ids( $product, 'product_cat' ), + 'tag_ids' => $this->get_term_ids( $product, 'product_tag' ), + 'shipping_class_id' => current( $this->get_term_ids( $product, 'product_shipping_class' ) ), + 'virtual' => get_post_meta( $id, '_virtual', true ), + 'downloadable' => get_post_meta( $id, '_downloadable', true ), + 'gallery_image_ids' => array_filter( explode( ',', get_post_meta( $id, '_product_image_gallery', true ) ) ), + 'download_limit' => get_post_meta( $id, '_download_limit', true ), + 'download_expiry' => get_post_meta( $id, '_download_expiry', true ), + 'image_id' => get_post_thumbnail_id( $id ), + ) + ); + + // Handle sale dates on the fly in case of missed cron schedule. + if ( $product->is_type( 'simple' ) && $product->is_on_sale( 'edit' ) && $product->get_sale_price( 'edit' ) !== $product->get_price( 'edit' ) ) { + update_post_meta( $product->get_id(), '_price', $product->get_sale_price( 'edit' ) ); + $product->set_price( $product->get_sale_price( 'edit' ) ); + } } /** * Read extra data associated with the product, like button text or product URL for external products. * - * @param WC_Product + * @param WC_Product $product Product object. * @since 3.0.0 */ protected function read_extra_data( &$product ) { @@ -337,15 +382,15 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Convert visibility terms to props. * Catalog visibility valid values are 'visible', 'catalog', 'search', and 'hidden'. * - * @param WC_Product + * @param WC_Product $product Product object. * @since 3.0.0 */ protected function read_visibility( &$product ) { $terms = get_the_terms( $product->get_id(), 'product_visibility' ); $term_names = is_array( $terms ) ? wp_list_pluck( $terms, 'name' ) : array(); - $featured = in_array( 'featured', $term_names ); - $exclude_search = in_array( 'exclude-from-search', $term_names ); - $exclude_catalog = in_array( 'exclude-from-catalog', $term_names ); + $featured = in_array( 'featured', $term_names, true ); + $exclude_search = in_array( 'exclude-from-search', $term_names, true ); + $exclude_catalog = in_array( 'exclude-from-catalog', $term_names, true ); if ( $exclude_search && $exclude_catalog ) { $catalog_visibility = 'hidden'; @@ -357,33 +402,35 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da $catalog_visibility = 'visible'; } - $product->set_props( array( - 'featured' => $featured, - 'catalog_visibility' => $catalog_visibility, - ) ); + $product->set_props( + array( + 'featured' => $featured, + 'catalog_visibility' => $catalog_visibility, + ) + ); } /** * Read attributes from post meta. * - * @param WC_Product - * @since 3.0.0 + * @param WC_Product $product Product object. */ protected function read_attributes( &$product ) { - $meta_values = get_post_meta( $product->get_id(), '_product_attributes', true ); + $meta_attributes = get_post_meta( $product->get_id(), '_product_attributes', true ); - if ( ! empty( $meta_values ) && is_array( $meta_values ) ) { + if ( ! empty( $meta_attributes ) && is_array( $meta_attributes ) ) { $attributes = array(); - foreach ( $meta_values as $meta_value ) { - $id = 0; - $meta_value = array_merge( array( - 'name' => '', - 'value' => '', - 'position' => 0, - 'is_visible' => 0, - 'is_variation' => 0, - 'is_taxonomy' => 0, - ), (array) $meta_value ); + foreach ( $meta_attributes as $meta_attribute_key => $meta_attribute_value ) { + $meta_value = array_merge( + array( + 'name' => '', + 'value' => '', + 'position' => 0, + 'is_visible' => 0, + 'is_variation' => 0, + 'is_taxonomy' => 0, + ), (array) $meta_attribute_value + ); // Check if is a taxonomy attribute. if ( ! empty( $meta_value['is_taxonomy'] ) ) { @@ -393,11 +440,11 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da $id = wc_attribute_taxonomy_id_by_name( $meta_value['name'] ); $options = wc_get_object_terms( $product->get_id(), $meta_value['name'], 'term_id' ); } else { + $id = 0; $options = wc_get_text_attributes( $meta_value['value'] ); } $attribute = new WC_Product_Attribute(); - $attribute->set_id( $id ); $attribute->set_name( $meta_value['name'] ); $attribute->set_options( $options ); @@ -413,7 +460,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Read downloads from post meta. * - * @param WC_Product + * @param WC_Product $product Product object. * @since 3.0.0 */ protected function read_downloads( &$product ) { @@ -425,7 +472,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da if ( ! isset( $value['name'], $value['file'] ) ) { continue; } - $download = new WC_Product_Download(); + $download = new WC_Product_Download(); $download->set_id( $key ); $download->set_name( $value['name'] ? $value['name'] : wc_get_filename_from_url( $value['file'] ) ); $download->set_file( apply_filters( 'woocommerce_file_download_path', $value['file'], $product, $key ) ); @@ -438,8 +485,8 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Helper method that updates all the post meta for a product based on it's settings in the WC_Product class. * - * @param WC_Product - * @param bool Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. * @since 3.0.0 */ protected function update_post_meta( &$product, $force = false ) { @@ -454,6 +501,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da '_tax_class' => 'tax_class', '_manage_stock' => 'manage_stock', '_backorders' => 'backorders', + '_low_stock_amount' => 'low_stock_amount', '_sold_individually' => 'sold_individually', '_weight' => 'weight', '_length' => 'length', @@ -487,17 +535,18 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da foreach ( $props_to_update as $meta_key => $prop ) { $value = $product->{"get_$prop"}( 'edit' ); + $value = is_string( $value ) ? wp_slash( $value ) : $value; switch ( $prop ) { - case 'virtual' : - case 'downloadable' : - case 'manage_stock' : - case 'sold_individually' : + case 'virtual': + case 'downloadable': + case 'manage_stock': + case 'sold_individually': $updated = update_post_meta( $product->get_id(), $meta_key, wc_bool_to_string( $value ) ); break; - case 'gallery_image_ids' : + case 'gallery_image_ids': $updated = update_post_meta( $product->get_id(), $meta_key, implode( ',', $value ) ); break; - case 'image_id' : + case 'image_id': if ( ! empty( $value ) ) { set_post_thumbnail( $product->get_id(), $value ); } else { @@ -505,11 +554,11 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da } $updated = true; break; - case 'date_on_sale_from' : - case 'date_on_sale_to' : + case 'date_on_sale_from': + case 'date_on_sale_to': $updated = update_post_meta( $product->get_id(), $meta_key, $value ? $value->getTimestamp() : '' ); break; - default : + default: $updated = update_post_meta( $product->get_id(), $meta_key, $value ); break; } @@ -521,12 +570,15 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da // Update extra data associated with the product like button text or product URL for external products. if ( ! $this->extra_data_saved ) { foreach ( $extra_data_keys as $key ) { - if ( ! array_key_exists( $key, $props_to_update ) ) { + if ( ! array_key_exists( '_' . $key, $props_to_update ) ) { continue; } $function = 'get_' . $key; if ( is_callable( array( $product, $function ) ) ) { - if ( update_post_meta( $product->get_id(), '_' . $key, $product->{$function}( 'edit' ) ) ) { + $value = $product->{$function}( 'edit' ); + $value = is_string( $value ) ? wp_slash( $value ) : $value; + + if ( update_post_meta( $product->get_id(), '_' . $key, $value ) ) { $this->updated_props[] = $key; } } @@ -541,26 +593,45 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Handle updated meta props after updating meta data. * - * @since 3.0.0 - * @param WC_Product $product + * @since 3.0.0 + * @param WC_Product $product Product Object. */ protected function handle_updated_props( &$product ) { - if ( in_array( 'date_on_sale_from', $this->updated_props ) || in_array( 'date_on_sale_to', $this->updated_props ) || in_array( 'regular_price', $this->updated_props ) || in_array( 'sale_price', $this->updated_props ) ) { - if ( $product->is_on_sale( 'edit' ) ) { - update_post_meta( $product->get_id(), '_price', $product->get_sale_price( 'edit' ) ); - $product->set_price( $product->get_sale_price( 'edit' ) ); - } else { - update_post_meta( $product->get_id(), '_price', $product->get_regular_price( 'edit' ) ); - $product->set_price( $product->get_regular_price( 'edit' ) ); + $price_is_synced = $product->is_type( array( 'variable', 'grouped' ) ); + + if ( ! $price_is_synced ) { + if ( in_array( 'regular_price', $this->updated_props, true ) || in_array( 'sale_price', $this->updated_props, true ) ) { + if ( $product->get_sale_price( 'edit' ) >= $product->get_regular_price( 'edit' ) ) { + update_post_meta( $product->get_id(), '_sale_price', '' ); + $product->set_sale_price( '' ); + } + } + + if ( in_array( 'date_on_sale_from', $this->updated_props, true ) || in_array( 'date_on_sale_to', $this->updated_props, true ) || in_array( 'regular_price', $this->updated_props, true ) || in_array( 'sale_price', $this->updated_props, true ) || in_array( 'product_type', $this->updated_props, true ) ) { + if ( $product->is_on_sale( 'edit' ) ) { + update_post_meta( $product->get_id(), '_price', $product->get_sale_price( 'edit' ) ); + $product->set_price( $product->get_sale_price( 'edit' ) ); + } else { + update_post_meta( $product->get_id(), '_price', $product->get_regular_price( 'edit' ) ); + $product->set_price( $product->get_regular_price( 'edit' ) ); + } } } - if ( in_array( 'stock_quantity', $this->updated_props ) ) { - do_action( $product->is_type( 'variation' ) ? 'woocommerce_variation_set_stock' : 'woocommerce_product_set_stock' , $product ); + if ( in_array( 'stock_quantity', $this->updated_props, true ) ) { + if ( $product->is_type( 'variation' ) ) { + do_action( 'woocommerce_variation_set_stock', $product ); + } else { + do_action( 'woocommerce_product_set_stock', $product ); + } } - if ( in_array( 'stock_status', $this->updated_props ) ) { - do_action( $product->is_type( 'variation' ) ? 'woocommerce_variation_set_stock_status' : 'woocommerce_product_set_stock_status' , $product->get_id(), $product->get_stock_status(), $product ); + if ( in_array( 'stock_status', $this->updated_props, true ) ) { + if ( $product->is_type( 'variation' ) ) { + do_action( 'woocommerce_variation_set_stock_status', $product->get_id(), $product->get_stock_status(), $product ); + } else { + do_action( 'woocommerce_product_set_stock_status', $product->get_id(), $product->get_stock_status(), $product ); + } } // Trigger action so 3rd parties can deal with updated props. @@ -573,15 +644,21 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * For all stored terms in all taxonomies, save them to the DB. * - * @param WC_Product - * @param bool Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. * @since 3.0.0 */ protected function update_terms( &$product, $force = false ) { $changes = $product->get_changes(); if ( $force || array_key_exists( 'category_ids', $changes ) ) { - wp_set_post_terms( $product->get_id(), $product->get_category_ids( 'edit' ), 'product_cat', false ); + $categories = $product->get_category_ids( 'edit' ); + + if ( empty( $categories ) && get_option( 'default_product_cat', 0 ) ) { + $categories = array( get_option( 'default_product_cat', 0 ) ); + } + + wp_set_post_terms( $product->get_id(), $categories, 'product_cat', false ); } if ( $force || array_key_exists( 'tag_ids', $changes ) ) { wp_set_post_terms( $product->get_id(), $product->get_tag_ids( 'edit' ), 'product_tag', false ); @@ -596,8 +673,8 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * * @since 3.0.0 * - * @param WC_Product $product - * @param bool $force Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. */ protected function update_visibility( &$product, $force = false ) { $changes = $product->get_changes(); @@ -620,14 +697,14 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da } switch ( $product->get_catalog_visibility() ) { - case 'hidden' : + case 'hidden': $terms[] = 'exclude-from-search'; $terms[] = 'exclude-from-catalog'; break; - case 'catalog' : + case 'catalog': $terms[] = 'exclude-from-search'; break; - case 'search' : + case 'search': $terms[] = 'exclude-from-catalog'; break; } @@ -642,8 +719,8 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Update attributes which are a mix of terms and meta data. * - * @param WC_Product - * @param bool Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. * @since 3.0.0 */ protected function update_attributes( &$product, $force = false ) { @@ -657,6 +734,8 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da foreach ( $attributes as $attribute_key => $attribute ) { $value = ''; + delete_transient( 'wc_layered_nav_counts_' . $attribute_key ); + if ( is_null( $attribute ) ) { if ( taxonomy_exists( $attribute_key ) ) { // Handle attributes that have been unset. @@ -665,7 +744,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da continue; } elseif ( $attribute->is_taxonomy() ) { - wp_set_object_terms( $product->get_id(), wp_list_pluck( $attribute->get_terms(), 'term_id' ), $attribute->get_name() ); + wp_set_object_terms( $product->get_id(), wp_list_pluck( (array) $attribute->get_terms(), 'term_id' ), $attribute->get_name() ); } else { $value = wc_implode_text_attributes( $attribute->get_options() ); } @@ -689,8 +768,8 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Update downloads. * * @since 3.0.0 - * @param WC_Product $product - * @param bool Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. * @return bool If updated or not. */ protected function update_downloads( &$product, $force = false ) { @@ -721,7 +800,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Make sure we store the product type and version (to track data changes). * - * @param WC_Product + * @param WC_Product $product Product object. * @since 3.0.0 */ protected function update_version_and_type( &$product ) { @@ -733,6 +812,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da // Action for the transition. if ( $old_type !== $new_type ) { + $this->updated_props[] = 'product_type'; do_action( 'woocommerce_product_type_changed', $product, $old_type, $new_type ); } } @@ -740,11 +820,12 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Clear any caches. * - * @param WC_Product + * @param WC_Product $product Product object. * @since 3.0.0 */ protected function clear_caches( &$product ) { wc_delete_product_transients( $product->get_id() ); + WC_Cache_Helper::incr_cache_prefix( 'product_' . $product->get_id() ); } /* @@ -763,21 +844,42 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da public function get_on_sale_products() { global $wpdb; - $decimals = absint( wc_get_price_decimals() ); + $decimals = absint( wc_get_price_decimals() ); + $exclude_term_ids = array(); + $outofstock_join = ''; + $outofstock_where = ''; + $product_visibility_term_ids = wc_get_product_visibility_term_ids(); - return $wpdb->get_results( " - SELECT post.ID as id, post.post_parent as parent_id FROM `$wpdb->posts` AS post - LEFT JOIN `$wpdb->postmeta` AS meta ON post.ID = meta.post_id - LEFT JOIN `$wpdb->postmeta` AS meta2 ON post.ID = meta2.post_id - WHERE post.post_type IN ( 'product', 'product_variation' ) - AND post.post_status = 'publish' - AND meta.meta_key = '_sale_price' - AND meta2.meta_key = '_price' - AND CAST( meta.meta_value AS DECIMAL ) >= 0 - AND CAST( meta.meta_value AS CHAR ) != '' - AND CAST( meta.meta_value AS DECIMAL( 10, {$decimals} ) ) = CAST( meta2.meta_value AS DECIMAL( 10, {$decimals} ) ) - GROUP BY post.ID; - " ); + if ( 'yes' === get_option( 'woocommerce_hide_out_of_stock_items' ) && $product_visibility_term_ids['outofstock'] ) { + $exclude_term_ids[] = $product_visibility_term_ids['outofstock']; + } + + if ( count( $exclude_term_ids ) ) { + $outofstock_join = " LEFT JOIN ( SELECT object_id FROM {$wpdb->term_relationships} WHERE term_taxonomy_id IN ( " . implode( ',', array_map( 'absint', $exclude_term_ids ) ) . ' ) ) AS exclude_join ON exclude_join.object_id = id'; + $outofstock_where = ' AND exclude_join.object_id IS NULL'; + } + + return $wpdb->get_results( + // phpcs:disable WordPress.WP.PreparedSQL.NotPrepared + $wpdb->prepare( + "SELECT post.ID as id, post.post_parent as parent_id FROM `$wpdb->posts` AS post + LEFT JOIN `$wpdb->postmeta` AS meta ON post.ID = meta.post_id + LEFT JOIN `$wpdb->postmeta` AS meta2 ON post.ID = meta2.post_id + $outofstock_join + WHERE post.post_type IN ( 'product', 'product_variation' ) + AND post.post_status = 'publish' + AND meta.meta_key = '_sale_price' + AND meta2.meta_key = '_price' + AND CAST( meta.meta_value AS DECIMAL ) >= 0 + AND CAST( meta.meta_value AS CHAR ) != '' + AND CAST( meta.meta_value AS DECIMAL( 10, %d ) ) = CAST( meta2.meta_value AS DECIMAL( 10, %d ) ) + $outofstock_where + GROUP BY post.ID", + $decimals, + $decimals + ) + // phpcs:enable + ); } /** @@ -791,68 +893,84 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da public function get_featured_product_ids() { $product_visibility_term_ids = wc_get_product_visibility_term_ids(); - return get_posts( array( - 'post_type' => array( 'product', 'product_variation' ), - 'posts_per_page' => -1, - 'post_status' => 'publish', - 'tax_query' => array( - 'relation' => 'AND', - array( - 'taxonomy' => 'product_visibility', - 'field' => 'term_taxonomy_id', - 'terms' => array( $product_visibility_term_ids['featured'] ), + return get_posts( + array( + 'post_type' => array( 'product', 'product_variation' ), + 'posts_per_page' => -1, + 'post_status' => 'publish', + // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_tax_query + 'tax_query' => array( + 'relation' => 'AND', + array( + 'taxonomy' => 'product_visibility', + 'field' => 'term_taxonomy_id', + 'terms' => array( $product_visibility_term_ids['featured'] ), + ), + array( + 'taxonomy' => 'product_visibility', + 'field' => 'term_taxonomy_id', + 'terms' => array( $product_visibility_term_ids['exclude-from-catalog'] ), + 'operator' => 'NOT IN', + ), ), - array( - 'taxonomy' => 'product_visibility', - 'field' => 'term_taxonomy_id', - 'terms' => array( $product_visibility_term_ids['exclude-from-catalog'] ), - 'operator' => 'NOT IN', - ), - ), - 'fields' => 'id=>parent', - ) ); + 'fields' => 'id=>parent', + ) + ); } /** * Check if product sku is found for any other product IDs. * * @since 3.0.0 - * @param int $product_id - * @param string $sku Will be slashed to work around https://core.trac.wordpress.org/ticket/27421 + * @param int $product_id Product ID. + * @param string $sku Will be slashed to work around https://core.trac.wordpress.org/ticket/27421. * @return bool */ public function is_existing_sku( $product_id, $sku ) { global $wpdb; - return $wpdb->get_var( $wpdb->prepare( " - SELECT $wpdb->posts.ID - FROM $wpdb->posts - LEFT JOIN $wpdb->postmeta ON ( $wpdb->posts.ID = $wpdb->postmeta.post_id ) - WHERE $wpdb->posts.post_type IN ( 'product', 'product_variation' ) - AND $wpdb->posts.post_status != 'trash' - AND $wpdb->postmeta.meta_key = '_sku' AND $wpdb->postmeta.meta_value = '%s' - AND $wpdb->postmeta.post_id <> %d LIMIT 1 - ", wp_slash( $sku ), $product_id ) ); + + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + return $wpdb->get_var( + $wpdb->prepare( + "SELECT $wpdb->posts.ID + FROM $wpdb->posts + LEFT JOIN $wpdb->postmeta ON ( $wpdb->posts.ID = $wpdb->postmeta.post_id ) + WHERE $wpdb->posts.post_type IN ( 'product', 'product_variation' ) + AND $wpdb->posts.post_status != 'trash' + AND $wpdb->postmeta.meta_key = '_sku' AND $wpdb->postmeta.meta_value = %s + AND $wpdb->postmeta.post_id <> %d + LIMIT 1", + wp_slash( $sku ), $product_id + ) + ); } /** * Return product ID based on SKU. * * @since 3.0.0 - * @param string $sku + * @param string $sku Product SKU. * @return int */ public function get_product_id_by_sku( $sku ) { global $wpdb; - return $wpdb->get_var( $wpdb->prepare( " - SELECT posts.ID - FROM $wpdb->posts AS posts - LEFT JOIN $wpdb->postmeta AS postmeta ON ( posts.ID = postmeta.post_id ) - WHERE posts.post_type IN ( 'product', 'product_variation' ) - AND posts.post_status != 'trash' - AND postmeta.meta_key = '_sku' - AND postmeta.meta_value = '%s' - LIMIT 1 - ", $sku ) ); + + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $id = $wpdb->get_var( + $wpdb->prepare( + "SELECT posts.ID + FROM $wpdb->posts AS posts + LEFT JOIN $wpdb->postmeta AS postmeta ON ( posts.ID = postmeta.post_id ) + WHERE posts.post_type IN ( 'product', 'product_variation' ) + AND posts.post_status != 'trash' + AND postmeta.meta_key = '_sku' + AND postmeta.meta_value = %s + LIMIT 1", + $sku + ) + ); + + return (int) apply_filters( 'woocommerce_get_product_id_by_sku', $id, $sku ); } /** @@ -863,17 +981,22 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da */ public function get_starting_sales() { global $wpdb; - return $wpdb->get_col( $wpdb->prepare( " - SELECT postmeta.post_id FROM {$wpdb->postmeta} as postmeta - LEFT JOIN {$wpdb->postmeta} as postmeta_2 ON postmeta.post_id = postmeta_2.post_id - LEFT JOIN {$wpdb->postmeta} as postmeta_3 ON postmeta.post_id = postmeta_3.post_id - WHERE postmeta.meta_key = '_sale_price_dates_from' - AND postmeta_2.meta_key = '_price' - AND postmeta_3.meta_key = '_sale_price' - AND postmeta.meta_value > 0 - AND postmeta.meta_value < %s - AND postmeta_2.meta_value != postmeta_3.meta_value - ", current_time( 'timestamp', true ) ) ); + + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + return $wpdb->get_col( + $wpdb->prepare( + "SELECT postmeta.post_id FROM {$wpdb->postmeta} as postmeta + LEFT JOIN {$wpdb->postmeta} as postmeta_2 ON postmeta.post_id = postmeta_2.post_id + LEFT JOIN {$wpdb->postmeta} as postmeta_3 ON postmeta.post_id = postmeta_3.post_id + WHERE postmeta.meta_key = '_sale_price_dates_from' + AND postmeta_2.meta_key = '_price' + AND postmeta_3.meta_key = '_sale_price' + AND postmeta.meta_value > 0 + AND postmeta.meta_value < %s + AND postmeta_2.meta_value != postmeta_3.meta_value", + current_time( 'timestamp', true ) + ) + ); } /** @@ -884,17 +1007,22 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da */ public function get_ending_sales() { global $wpdb; - return $wpdb->get_col( $wpdb->prepare( " - SELECT postmeta.post_id FROM {$wpdb->postmeta} as postmeta - LEFT JOIN {$wpdb->postmeta} as postmeta_2 ON postmeta.post_id = postmeta_2.post_id - LEFT JOIN {$wpdb->postmeta} as postmeta_3 ON postmeta.post_id = postmeta_3.post_id - WHERE postmeta.meta_key = '_sale_price_dates_to' - AND postmeta_2.meta_key = '_price' - AND postmeta_3.meta_key = '_regular_price' - AND postmeta.meta_value > 0 - AND postmeta.meta_value < %s - AND postmeta_2.meta_value != postmeta_3.meta_value - ", current_time( 'timestamp', true ) ) ); + + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + return $wpdb->get_col( + $wpdb->prepare( + "SELECT postmeta.post_id FROM {$wpdb->postmeta} as postmeta + LEFT JOIN {$wpdb->postmeta} as postmeta_2 ON postmeta.post_id = postmeta_2.post_id + LEFT JOIN {$wpdb->postmeta} as postmeta_3 ON postmeta.post_id = postmeta_3.post_id + WHERE postmeta.meta_key = '_sale_price_dates_to' + AND postmeta_2.meta_key = '_price' + AND postmeta_3.meta_key = '_regular_price' + AND postmeta.meta_value > 0 + AND postmeta.meta_value < %s + AND postmeta_2.meta_value != postmeta_3.meta_value", + current_time( 'timestamp', true ) + ) + ); } /** @@ -902,7 +1030,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * * @since 3.0.0 * @param WC_Product $product Variable product. - * @param array $match_attributes Array of attributes we want to try to match. + * @param array $match_attributes Array of attributes we want to try to match. * @return int Matching variation ID or 0. */ public function find_matching_product_variation( $product, $match_attributes = array() ) { @@ -914,7 +1042,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da 'fields' => 'ids', 'post_status' => 'publish', 'numberposts' => 1, - 'meta_query' => array(), + 'meta_query' => array(), // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_query ); // Allow large queries in case user has many variations or attributes. @@ -944,7 +1072,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da array( 'key' => $attribute_field_name, 'compare' => 'NOT EXISTS', - ) + ), ); } @@ -952,7 +1080,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da if ( $variations && ! is_wp_error( $variations ) ) { return current( $variations ); - } elseif ( version_compare( get_post_meta( $product->get_id(), '_product_version', true ), '2.4.0', '<' ) ) { + } elseif ( version_compare( get_post_meta( $product->get_id(), '_product_version', true ), '2.4.0', '<' ) ) { /** * Pre 2.4 handling where 'slugs' were saved instead of the full text attribute. * Fallback is here because there are cases where data will be 'synced' but the product version will remain the same. @@ -966,14 +1094,22 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Make sure all variations have a sort order set so they can be reordered correctly. * - * @param int $parent_id + * @param int $parent_id Product ID. */ public function sort_all_product_variations( $parent_id ) { global $wpdb; - $ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM {$wpdb->posts} WHERE post_type = 'product_variation' AND post_parent = %d AND post_status = 'publish' ORDER BY menu_order ASC, ID ASC", $parent_id ) ); + + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $ids = $wpdb->get_col( + $wpdb->prepare( + "SELECT ID FROM {$wpdb->posts} WHERE post_type = 'product_variation' AND post_parent = %d AND post_status = 'publish' ORDER BY menu_order ASC, ID ASC", + $parent_id + ) + ); $index = 1; foreach ( $ids as $id ) { + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery $wpdb->update( $wpdb->posts, array( 'menu_order' => ( $index++ ) ), array( 'ID' => absint( $id ) ) ); } } @@ -986,12 +1122,23 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * @param array $tags_array List of tags IDs. * @param array $exclude_ids Excluded IDs. * @param int $limit Limit of results. - * @param int $product_id + * @param int $product_id Product ID. * @return array */ public function get_related_products( $cats_array, $tags_array, $exclude_ids, $limit, $product_id ) { global $wpdb; - return $wpdb->get_col( implode( ' ', apply_filters( 'woocommerce_product_related_posts_query', $this->get_related_products_query( $cats_array, $tags_array, $exclude_ids, $limit + 10 ), $product_id ) ) ); + + $args = array( + 'categories' => $cats_array, + 'tags' => $tags_array, + 'exclude_ids' => $exclude_ids, + 'limit' => $limit + 10, + ); + + $related_product_query = (array) apply_filters( 'woocommerce_product_related_posts_query', $this->get_related_products_query( $cats_array, $tags_array, $exclude_ids, $limit + 10 ), $product_id, $args ); + + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery, WordPress.WP.PreparedSQL.NotPrepared + return $wpdb->get_col( implode( ' ', $related_product_query ) ); } /** @@ -1032,22 +1179,22 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da AND p.post_type = 'product' ", - 'limits' => " - LIMIT " . absint( $limit ) . " - ", + 'limits' => ' + LIMIT ' . absint( $limit ) . ' + ', ); if ( count( $exclude_term_ids ) ) { - $query['join'] .= " LEFT JOIN ( SELECT object_id FROM {$wpdb->term_relationships} WHERE term_taxonomy_id IN ( " . implode( ',', array_map( 'absint', $exclude_term_ids ) ) . " ) ) AS exclude_join ON exclude_join.object_id = p.ID"; - $query['where'] .= " AND exclude_join.object_id IS NULL"; + $query['join'] .= " LEFT JOIN ( SELECT object_id FROM {$wpdb->term_relationships} WHERE term_taxonomy_id IN ( " . implode( ',', array_map( 'absint', $exclude_term_ids ) ) . ' ) ) AS exclude_join ON exclude_join.object_id = p.ID'; + $query['where'] .= ' AND exclude_join.object_id IS NULL'; } if ( count( $include_term_ids ) ) { - $query['join'] .= " INNER JOIN ( SELECT object_id FROM {$wpdb->term_relationships} INNER JOIN {$wpdb->term_taxonomy} using( term_taxonomy_id ) WHERE term_id IN ( " . implode( ',', array_map( 'absint', $include_term_ids ) ) . " ) ) AS include_join ON include_join.object_id = p.ID"; + $query['join'] .= " INNER JOIN ( SELECT object_id FROM {$wpdb->term_relationships} INNER JOIN {$wpdb->term_taxonomy} using( term_taxonomy_id ) WHERE term_id IN ( " . implode( ',', array_map( 'absint', $include_term_ids ) ) . ' ) ) AS include_join ON include_join.object_id = p.ID'; } if ( count( $exclude_ids ) ) { - $query['where'] .= " AND p.ID NOT IN ( " . implode( ',', array_map( 'absint', $exclude_ids ) ) . " )"; + $query['where'] .= ' AND p.ID NOT IN ( ' . implode( ',', array_map( 'absint', $exclude_ids ) ) . ' )'; } return $query; @@ -1059,24 +1206,39 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Uses queries rather than update_post_meta so we can do this in one query (to avoid stock issues). * * @since 3.0.0 this supports set, increase and decrease. - * @param int - * @param int|null $stock_quantity - * @param string $operation set, increase and decrease. + * @param int $product_id_with_stock Product ID. + * @param int|null $stock_quantity Stock quantity. + * @param string $operation Set, increase and decrease. */ public function update_product_stock( $product_id_with_stock, $stock_quantity = null, $operation = 'set' ) { global $wpdb; add_post_meta( $product_id_with_stock, '_stock', 0, true ); - // Update stock in DB directly + // Update stock in DB directly. switch ( $operation ) { - case 'increase' : - $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = meta_value + %f WHERE post_id = %d AND meta_key='_stock'", $stock_quantity, $product_id_with_stock ) ); + case 'increase': + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->postmeta} SET meta_value = meta_value + %f WHERE post_id = %d AND meta_key='_stock'", $stock_quantity, $product_id_with_stock + ) + ); break; - case 'decrease' : - $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = meta_value - %f WHERE post_id = %d AND meta_key='_stock'", $stock_quantity, $product_id_with_stock ) ); + case 'decrease': + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->postmeta} SET meta_value = meta_value - %f WHERE post_id = %d AND meta_key='_stock'", $stock_quantity, $product_id_with_stock + ) + ); break; - default : - $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = %f WHERE post_id = %d AND meta_key='_stock'", $stock_quantity, $product_id_with_stock ) ); + default: + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->postmeta} SET meta_value = %f WHERE post_id = %d AND meta_key='_stock'", $stock_quantity, $product_id_with_stock + ) + ); break; } @@ -1089,24 +1251,39 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Uses queries rather than update_post_meta so we can do this in one query for performance. * * @since 3.0.0 this supports set, increase and decrease. - * @param int - * @param int|null $quantity - * @param string $operation set, increase and decrease. + * @param int $product_id Product ID. + * @param int|null $quantity Quantity. + * @param string $operation set, increase and decrease. */ public function update_product_sales( $product_id, $quantity = null, $operation = 'set' ) { global $wpdb; add_post_meta( $product_id, 'total_sales', 0, true ); - // Update stock in DB directly + // Update stock in DB directly. switch ( $operation ) { - case 'increase' : - $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = meta_value + %f WHERE post_id = %d AND meta_key='total_sales'", $quantity, $product_id ) ); + case 'increase': + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->postmeta} SET meta_value = meta_value + %f WHERE post_id = %d AND meta_key='total_sales'", $quantity, $product_id + ) + ); break; - case 'decrease' : - $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = meta_value - %f WHERE post_id = %d AND meta_key='total_sales'", $quantity, $product_id ) ); + case 'decrease': + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->postmeta} SET meta_value = meta_value - %f WHERE post_id = %d AND meta_key='total_sales'", $quantity, $product_id + ) + ); break; - default : - $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->postmeta} SET meta_value = %f WHERE post_id = %d AND meta_key='total_sales'", $quantity, $product_id ) ); + default: + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->postmeta} SET meta_value = %f WHERE post_id = %d AND meta_key='total_sales'", $quantity, $product_id + ) + ); break; } @@ -1117,7 +1294,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Update a products average rating meta. * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product Product object. */ public function update_average_rating( $product ) { update_post_meta( $product->get_id(), '_wc_average_rating', $product->get_average_rating( 'edit' ) ); @@ -1128,7 +1305,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Update a products review count meta. * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product Product object. */ public function update_review_count( $product ) { update_post_meta( $product->get_id(), '_wc_review_count', $product->get_review_count( 'edit' ) ); @@ -1138,7 +1315,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Update a products rating counts. * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product Product object. */ public function update_rating_counts( $product ) { update_post_meta( $product->get_id(), '_wc_rating_count', $product->get_rating_counts( 'edit' ) ); @@ -1148,7 +1325,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Get shipping class ID by slug. * * @since 3.0.0 - * @param $slug string + * @param string $slug Product shipping class slug. * @return int|false */ public function get_shipping_class_id_by_slug( $slug ) { @@ -1163,181 +1340,109 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da /** * Returns an array of products. * - * @param array $args @see wc_get_products - * + * @param array $args Args to pass to WC_Product_Query(). * @return array|object + * @see wc_get_products */ public function get_products( $args = array() ) { - /** - * Generate WP_Query args. - */ - $wp_query_args = array( - 'post_status' => $args['status'], - 'posts_per_page' => $args['limit'], - 'meta_query' => array(), - 'orderby' => $args['orderby'], - 'order' => $args['order'], - 'tax_query' => array(), - ); - - if ( 'variation' === $args['type'] ) { - $wp_query_args['post_type'] = 'product_variation'; - } elseif ( is_array( $args['type'] ) && in_array( 'variation', $args['type'] ) ) { - $wp_query_args['post_type'] = array( 'product_variation', 'product' ); - $wp_query_args['tax_query'][] = array( - 'relation' => 'OR', - array( - 'taxonomy' => 'product_type', - 'field' => 'slug', - 'terms' => $args['type'], - ), - array( - 'taxonomy' => 'product_type', - 'field' => 'id', - 'operator' => 'NOT EXISTS', - ), - ); - } else { - $wp_query_args['post_type'] = 'product'; - $wp_query_args['tax_query'][] = array( - 'taxonomy' => 'product_type', - 'field' => 'slug', - 'terms' => $args['type'], - ); - } - - // Do not load unnecessary post data if the user only wants IDs. - if ( 'ids' === $args['return'] ) { - $wp_query_args['fields'] = 'ids'; - } - - if ( ! empty( $args['sku'] ) ) { - $wp_query_args['meta_query'][] = array( - 'key' => '_sku', - 'value' => $args['sku'], - 'compare' => 'LIKE', - ); - } - - if ( ! empty( $args['category'] ) ) { - $wp_query_args['tax_query'][] = array( - 'taxonomy' => 'product_cat', - 'field' => 'slug', - 'terms' => $args['category'], - ); - } - - if ( ! empty( $args['tag'] ) ) { - $wp_query_args['tax_query'][] = array( - 'taxonomy' => 'product_tag', - 'field' => 'slug', - 'terms' => $args['tag'], - ); - } - - if ( ! empty( $args['shipping_class'] ) ) { - $wp_query_args['tax_query'][] = array( - 'taxonomy' => 'product_shipping_class', - 'field' => 'slug', - 'terms' => $args['shipping_class'], - ); - } - - if ( ! is_null( $args['parent'] ) ) { - $wp_query_args['post_parent'] = absint( $args['parent'] ); - } - - if ( ! is_null( $args['offset'] ) ) { - $wp_query_args['offset'] = absint( $args['offset'] ); - } else { - $wp_query_args['paged'] = absint( $args['page'] ); - } - - if ( ! empty( $args['include'] ) ) { - $wp_query_args['post__in'] = array_map( 'absint', $args['include'] ); - } - - if ( ! empty( $args['exclude'] ) ) { - $wp_query_args['post__not_in'] = array_map( 'absint', $args['exclude'] ); - } - - if ( ! $args['paginate'] ) { - $wp_query_args['no_found_rows'] = true; - } - - // Get results. - $products = new WP_Query( $wp_query_args ); - - if ( 'objects' === $args['return'] ) { - // Prime caches before grabbing objects. - update_post_caches( $products->posts, array( 'product', 'product_variation' ) ); - - $return = array_filter( array_map( 'wc_get_product', $products->posts ) ); - } else { - $return = $products->posts; - } - - if ( $args['paginate'] ) { - return (object) array( - 'products' => $return, - 'total' => $products->found_posts, - 'max_num_pages' => $products->max_num_pages, - ); - } else { - return $return; - } + $query = new WC_Product_Query( $args ); + return $query->get_products(); } /** * Search product data for a term and return ids. * - * @param string $term - * @param string $type of product - * @param bool $include_variations in search or not + * @param string $term Search term. + * @param string $type Type of product. + * @param bool $include_variations Include variations in search or not. + * @param bool $all_statuses Should we search all statuses or limit to published. + * @param null|int $limit Limit returned results. @since 3.5.0. * @return array of ids */ - public function search_products( $term, $type = '', $include_variations = false ) { + public function search_products( $term, $type = '', $include_variations = false, $all_statuses = false, $limit = null ) { global $wpdb; - $search_fields = array_map( 'wc_clean', apply_filters( 'woocommerce_product_search_fields', array( - '_sku', - ) ) ); - $like_term = '%' . $wpdb->esc_like( $term ) . '%'; $post_types = $include_variations ? array( 'product', 'product_variation' ) : array( 'product' ); $post_statuses = current_user_can( 'edit_private_products' ) ? array( 'private', 'publish' ) : array( 'publish' ); $type_join = ''; $type_where = ''; + $status_where = ''; + $limit_query = ''; + $term = wc_strtolower( $term ); - if ( $type ) { - if ( in_array( $type, array( 'virtual', 'downloadable' ) ) ) { - $type_join = " LEFT JOIN {$wpdb->postmeta} postmeta_type ON posts.ID = postmeta_type.post_id "; - $type_where = " AND ( postmeta_type.meta_key = '_{$type}' AND postmeta_type.meta_value = 'yes' ) "; + // See if search term contains OR keywords. + if ( strstr( $term, ' or ' ) ) { + $term_groups = explode( ' or ', $term ); + } else { + $term_groups = array( $term ); + } + + $search_where = ''; + $search_queries = array(); + + foreach ( $term_groups as $term_group ) { + // Parse search terms. + if ( preg_match_all( '/".*?("|$)|((?<=[\t ",+])|^)[^\t ",+]+/', $term_group, $matches ) ) { + $search_terms = $this->get_valid_search_terms( $matches[0] ); + $count = count( $search_terms ); + + // if the search string has only short terms or stopwords, or is 10+ terms long, match it as sentence. + if ( 9 < $count || 0 === $count ) { + $search_terms = array( $term_group ); + } + } else { + $search_terms = array( $term_group ); + } + + $term_group_query = ''; + $searchand = ''; + + foreach ( $search_terms as $search_term ) { + $like = '%' . $wpdb->esc_like( $search_term ) . '%'; + $term_group_query .= $wpdb->prepare( " {$searchand} ( ( posts.post_title LIKE %s) OR ( posts.post_excerpt LIKE %s) OR ( posts.post_content LIKE %s ) OR ( postmeta.meta_key = '_sku' AND postmeta.meta_value LIKE %s ) )", $like, $like, $like, $like ); // @codingStandardsIgnoreLine. + $searchand = ' AND '; + } + + if ( $term_group_query ) { + $search_queries[] = $term_group_query; } } - $product_ids = $wpdb->get_col( - $wpdb->prepare( " - SELECT DISTINCT posts.ID FROM {$wpdb->posts} posts - LEFT JOIN {$wpdb->postmeta} postmeta ON posts.ID = postmeta.post_id - $type_join - WHERE ( - posts.post_title LIKE %s - OR posts.post_content LIKE %s - OR ( - postmeta.meta_key = '_sku' AND postmeta.meta_value LIKE %s - ) - ) - AND posts.post_type IN ('" . implode( "','", $post_types ) . "') - AND posts.post_status IN ('" . implode( "','", $post_statuses ) . "') - $type_where - ORDER BY posts.post_parent ASC, posts.post_title ASC - ", - $like_term, - $like_term, - $like_term - ) + if ( ! empty( $search_queries ) ) { + $search_where = 'AND (' . implode( ') OR (', $search_queries ) . ')'; + } + + if ( $type && in_array( $type, array( 'virtual', 'downloadable' ), true ) ) { + $type_join = " LEFT JOIN {$wpdb->postmeta} postmeta_type ON posts.ID = postmeta_type.post_id "; + $type_where = " AND ( postmeta_type.meta_key = '_{$type}' AND postmeta_type.meta_value = 'yes' ) "; + } + + if ( ! $all_statuses ) { + $status_where = " AND posts.post_status IN ('" . implode( "','", $post_statuses ) . "') "; + } + + if ( $limit ) { + $limit_query = $wpdb->prepare( ' LIMIT %d ', $limit ); + } + + // phpcs:ignore WordPress.VIP.DirectDatabaseQuery.DirectQuery + $search_results = $wpdb->get_results( + // phpcs:disable + "SELECT DISTINCT posts.ID as product_id, posts.post_parent as parent_id FROM {$wpdb->posts} posts + LEFT JOIN {$wpdb->postmeta} postmeta ON posts.ID = postmeta.post_id + $type_join + WHERE posts.post_type IN ('" . implode( "','", $post_types ) . "') + $search_where + $status_where + $type_where + ORDER BY posts.post_parent ASC, posts.post_title ASC + $limit_query + " + // phpcs:enable ); + $product_ids = wp_parse_id_list( array_merge( wp_list_pluck( $search_results, 'product_id' ), wp_list_pluck( $search_results, 'parent_id' ) ) ); + if ( is_numeric( $term ) ) { $post_id = absint( $term ); $post_type = get_post_type( $post_id ); @@ -1358,7 +1463,7 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da * Get the product type based on product ID. * * @since 3.0.0 - * @param int $product_id + * @param int $product_id Product ID. * @return bool|string */ public function get_product_type( $product_id ) { @@ -1372,4 +1477,312 @@ class WC_Product_Data_Store_CPT extends WC_Data_Store_WP implements WC_Object_Da return false; } } + + /** + * Add ability to get products by 'reviews_allowed' in WC_Product_Query. + * + * @since 3.2.0 + * @param string $where Where clause. + * @param WP_Query $wp_query WP_Query instance. + * @return string + */ + public function reviews_allowed_query_where( $where, $wp_query ) { + global $wpdb; + + if ( isset( $wp_query->query_vars['reviews_allowed'] ) && is_bool( $wp_query->query_vars['reviews_allowed'] ) ) { + if ( $wp_query->query_vars['reviews_allowed'] ) { + $where .= " AND $wpdb->posts.comment_status = 'open'"; + } else { + $where .= " AND $wpdb->posts.comment_status = 'closed'"; + } + } + + return $where; + } + + /** + * Get valid WP_Query args from a WC_Product_Query's query variables. + * + * @since 3.2.0 + * @param array $query_vars Query vars from a WC_Product_Query. + * @return array + */ + protected function get_wp_query_args( $query_vars ) { + + // Map query vars to ones that get_wp_query_args or WP_Query recognize. + $key_mapping = array( + 'status' => 'post_status', + 'page' => 'paged', + 'include' => 'post__in', + 'stock_quantity' => 'stock', + 'average_rating' => 'wc_average_rating', + 'review_count' => 'wc_review_count', + ); + foreach ( $key_mapping as $query_key => $db_key ) { + if ( isset( $query_vars[ $query_key ] ) ) { + $query_vars[ $db_key ] = $query_vars[ $query_key ]; + unset( $query_vars[ $query_key ] ); + } + } + + // Map boolean queries that are stored as 'yes'/'no' in the DB to 'yes' or 'no'. + $boolean_queries = array( + 'virtual', + 'downloadable', + 'sold_individually', + 'manage_stock', + ); + foreach ( $boolean_queries as $boolean_query ) { + if ( isset( $query_vars[ $boolean_query ] ) && '' !== $query_vars[ $boolean_query ] ) { + $query_vars[ $boolean_query ] = $query_vars[ $boolean_query ] ? 'yes' : 'no'; + } + } + + // These queries cannot be auto-generated so we have to remove them and build them manually. + $manual_queries = array( + 'sku' => '', + 'featured' => '', + 'visibility' => '', + ); + foreach ( $manual_queries as $key => $manual_query ) { + if ( isset( $query_vars[ $key ] ) ) { + $manual_queries[ $key ] = $query_vars[ $key ]; + unset( $query_vars[ $key ] ); + } + } + + $wp_query_args = parent::get_wp_query_args( $query_vars ); + + if ( ! isset( $wp_query_args['date_query'] ) ) { + $wp_query_args['date_query'] = array(); + } + if ( ! isset( $wp_query_args['meta_query'] ) ) { + // phpcs:ignore WordPress.VIP.SlowDBQuery.slow_db_query_meta_query + $wp_query_args['meta_query'] = array(); + } + + // Handle product types. + if ( 'variation' === $query_vars['type'] ) { + $wp_query_args['post_type'] = 'product_variation'; + } elseif ( is_array( $query_vars['type'] ) && in_array( 'variation', $query_vars['type'], true ) ) { + $wp_query_args['post_type'] = array( 'product_variation', 'product' ); + $wp_query_args['tax_query'][] = array( + 'relation' => 'OR', + array( + 'taxonomy' => 'product_type', + 'field' => 'slug', + 'terms' => $query_vars['type'], + ), + array( + 'taxonomy' => 'product_type', + 'field' => 'id', + 'operator' => 'NOT EXISTS', + ), + ); + } else { + $wp_query_args['post_type'] = 'product'; + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_type', + 'field' => 'slug', + 'terms' => $query_vars['type'], + ); + } + + // Handle product categories. + if ( ! empty( $query_vars['category'] ) ) { + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_cat', + 'field' => 'slug', + 'terms' => $query_vars['category'], + ); + } + + // Handle product tags. + if ( ! empty( $query_vars['tag'] ) ) { + unset( $wp_query_args['tag'] ); + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_tag', + 'field' => 'slug', + 'terms' => $query_vars['tag'], + ); + } + + // Handle shipping classes. + if ( ! empty( $query_vars['shipping_class'] ) ) { + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_shipping_class', + 'field' => 'slug', + 'terms' => $query_vars['shipping_class'], + ); + } + + // Handle total_sales. + // This query doesn't get auto-generated since the meta key doesn't have the underscore prefix. + if ( isset( $query_vars['total_sales'] ) && '' !== $query_vars['total_sales'] ) { + $wp_query_args['meta_query'][] = array( + 'key' => 'total_sales', + 'value' => absint( $query_vars['total_sales'] ), + 'compare' => '=', + ); + } + + // Handle SKU. + if ( $manual_queries['sku'] ) { + // Check for existing values if wildcard is used. + if ( '*' === $manual_queries['sku'] ) { + $wp_query_args['meta_query'][] = array( + array( + 'key' => '_sku', + 'compare' => 'EXISTS', + ), + array( + 'key' => '_sku', + 'value' => '', + 'compare' => '!=', + ), + ); + } else { + $wp_query_args['meta_query'][] = array( + 'key' => '_sku', + 'value' => $manual_queries['sku'], + 'compare' => 'LIKE', + ); + } + } + + // Handle featured. + if ( '' !== $manual_queries['featured'] ) { + $product_visibility_term_ids = wc_get_product_visibility_term_ids(); + if ( $manual_queries['featured'] ) { + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_visibility', + 'field' => 'term_taxonomy_id', + 'terms' => array( $product_visibility_term_ids['featured'] ), + ); + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_visibility', + 'field' => 'term_taxonomy_id', + 'terms' => array( $product_visibility_term_ids['exclude-from-catalog'] ), + 'operator' => 'NOT IN', + ); + } else { + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_visibility', + 'field' => 'term_taxonomy_id', + 'terms' => array( $product_visibility_term_ids['featured'] ), + 'operator' => 'NOT IN', + ); + } + } + + // Handle visibility. + if ( $manual_queries['visibility'] ) { + switch ( $manual_queries['visibility'] ) { + case 'search': + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_visibility', + 'field' => 'slug', + 'terms' => array( 'exclude-from-search' ), + 'operator' => 'NOT IN', + ); + break; + case 'catalog': + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_visibility', + 'field' => 'slug', + 'terms' => array( 'exclude-from-catalog' ), + 'operator' => 'NOT IN', + ); + break; + case 'visible': + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_visibility', + 'field' => 'slug', + 'terms' => array( 'exclude-from-catalog', 'exclude-from-search' ), + 'operator' => 'NOT IN', + ); + break; + case 'hidden': + $wp_query_args['tax_query'][] = array( + 'taxonomy' => 'product_visibility', + 'field' => 'slug', + 'terms' => array( 'exclude-from-catalog', 'exclude-from-search' ), + 'operator' => 'AND', + ); + break; + } + } + + // Handle date queries. + $date_queries = array( + 'date_created' => 'post_date', + 'date_modified' => 'post_modified', + 'date_on_sale_from' => '_sale_price_dates_from', + 'date_on_sale_to' => '_sale_price_dates_to', + ); + foreach ( $date_queries as $query_var_key => $db_key ) { + if ( isset( $query_vars[ $query_var_key ] ) && '' !== $query_vars[ $query_var_key ] ) { + + // Remove any existing meta queries for the same keys to prevent conflicts. + $existing_queries = wp_list_pluck( $wp_query_args['meta_query'], 'key', true ); + foreach ( $existing_queries as $query_index => $query_contents ) { + unset( $wp_query_args['meta_query'][ $query_index ] ); + } + + $wp_query_args = $this->parse_date_for_wp_query( $query_vars[ $query_var_key ], $db_key, $wp_query_args ); + } + } + + // Handle paginate. + if ( ! isset( $query_vars['paginate'] ) || ! $query_vars['paginate'] ) { + $wp_query_args['no_found_rows'] = true; + } + + // Handle reviews_allowed. + if ( isset( $query_vars['reviews_allowed'] ) && is_bool( $query_vars['reviews_allowed'] ) ) { + add_filter( 'posts_where', array( $this, 'reviews_allowed_query_where' ), 10, 2 ); + } + + return apply_filters( 'woocommerce_product_data_store_cpt_get_products_query', $wp_query_args, $query_vars, $this ); + } + + /** + * Query for Products matching specific criteria. + * + * @since 3.2.0 + * + * @param array $query_vars Query vars from a WC_Product_Query. + * + * @return array|object + */ + public function query( $query_vars ) { + $args = $this->get_wp_query_args( $query_vars ); + + if ( ! empty( $args['errors'] ) ) { + $query = (object) array( + 'posts' => array(), + 'found_posts' => 0, + 'max_num_pages' => 0, + ); + } else { + $query = new WP_Query( $args ); + } + + if ( isset( $query_vars['return'] ) && 'objects' === $query_vars['return'] && ! empty( $query->posts ) ) { + // Prime caches before grabbing objects. + update_post_caches( $query->posts, array( 'product', 'product_variation' ) ); + } + + $products = ( isset( $query_vars['return'] ) && 'ids' === $query_vars['return'] ) ? $query->posts : array_filter( array_map( 'wc_get_product', $query->posts ) ); + + if ( isset( $query_vars['paginate'] ) && $query_vars['paginate'] ) { + return (object) array( + 'products' => $products, + 'total' => $query->found_posts, + 'max_num_pages' => $query->max_num_pages, + ); + } + + return $products; + } } diff --git a/includes/data-stores/class-wc-product-grouped-data-store-cpt.php b/includes/data-stores/class-wc-product-grouped-data-store-cpt.php index d9677c4898e..ea3b9adacdd 100644 --- a/includes/data-stores/class-wc-product-grouped-data-store-cpt.php +++ b/includes/data-stores/class-wc-product-grouped-data-store-cpt.php @@ -1,4 +1,10 @@ updated_props ) ) { - $child_prices = array(); - foreach ( $product->get_children( 'edit' ) as $child_id ) { - $child = wc_get_product( $child_id ); - if ( $child ) { - $child_prices[] = $child->get_price(); - } - } - $child_prices = array_filter( $child_prices ); - delete_post_meta( $product->get_id(), '_price' ); - - if ( ! empty( $child_prices ) ) { - add_post_meta( $product->get_id(), '_price', min( $child_prices ) ); - add_post_meta( $product->get_id(), '_price', max( $child_prices ) ); - } + if ( in_array( 'children', $this->updated_props, true ) ) { + $this->update_prices_from_children( $product ); } parent::handle_updated_props( $product ); } @@ -67,27 +58,33 @@ class WC_Product_Grouped_Data_Store_CPT extends WC_Product_Data_Store_CPT implem * Sync grouped product prices with children. * * @since 3.0.0 - * @param WC_Product|int $product + * @param WC_Product|int $product Product object or product ID. */ public function sync_price( &$product ) { - global $wpdb; + $this->update_prices_from_children( $product ); + } - $children_ids = get_posts( array( - 'post_parent' => $product->get_id(), - 'post_type' => 'product', - 'fields' => 'ids', - ) ); - $prices = $children_ids ? array_unique( $wpdb->get_col( "SELECT meta_value FROM $wpdb->postmeta WHERE meta_key = '_price' AND post_id IN ( " . implode( ',', array_map( 'absint', $children_ids ) ) . " )" ) ) : array(); - - delete_post_meta( $product->get_id(), '_price' ); - delete_transient( 'wc_var_prices_' . $product->get_id() ); - - if ( $prices ) { - sort( $prices ); - // To allow sorting and filtering by multiple values, we have no choice but to store child prices in this manner. - foreach ( $prices as $price ) { - add_post_meta( $product->get_id(), '_price', $price, false ); + /** + * Loop over child products and update the grouped product prices. + * + * @param WC_Product $product Product object. + */ + protected function update_prices_from_children( &$product ) { + $child_prices = array(); + foreach ( $product->get_children( 'edit' ) as $child_id ) { + $child = wc_get_product( $child_id ); + if ( $child ) { + $child_prices[] = $child->get_price( 'edit' ); } } + $child_prices = array_filter( $child_prices ); + delete_post_meta( $product->get_id(), '_price' ); + delete_post_meta( $product->get_id(), '_sale_price' ); + delete_post_meta( $product->get_id(), '_regular_price' ); + + if ( ! empty( $child_prices ) ) { + add_post_meta( $product->get_id(), '_price', min( $child_prices ) ); + add_post_meta( $product->get_id(), '_price', max( $child_prices ) ); + } } } diff --git a/includes/data-stores/class-wc-product-variable-data-store-cpt.php b/includes/data-stores/class-wc-product-variable-data-store-cpt.php index dab9847dbdf..91e19171492 100644 --- a/includes/data-stores/class-wc-product-variable-data-store-cpt.php +++ b/includes/data-stores/class-wc-product-variable-data-store-cpt.php @@ -1,4 +1,10 @@ get_id(), '_product_attributes', true ); + + if ( ! empty( $meta_attributes ) && is_array( $meta_attributes ) ) { + $attributes = array(); + $force_update = false; + foreach ( $meta_attributes as $meta_attribute_key => $meta_attribute_value ) { + $meta_value = array_merge( + array( + 'name' => '', + 'value' => '', + 'position' => 0, + 'is_visible' => 0, + 'is_variation' => 0, + 'is_taxonomy' => 0, + ), (array) $meta_attribute_value + ); + + // Maintain data integrity. 4.9 changed sanitization functions - update the values here so variations function correctly. + if ( $meta_value['is_variation'] && strstr( $meta_value['name'], '/' ) && sanitize_title( $meta_value['name'] ) !== $meta_attribute_key ) { + global $wpdb; + + $old_slug = 'attribute_' . $meta_attribute_key; + $new_slug = 'attribute_' . sanitize_title( $meta_value['name'] ); + $old_meta_rows = $wpdb->get_results( $wpdb->prepare( "SELECT post_id, meta_value FROM {$wpdb->postmeta} WHERE meta_key = %s;", $old_slug ) ); // WPCS: db call ok, cache ok. + + if ( $old_meta_rows ) { + foreach ( $old_meta_rows as $old_meta_row ) { + update_post_meta( $old_meta_row->post_id, $new_slug, $old_meta_row->meta_value ); + } + } + + $force_update = true; + } + + // Check if is a taxonomy attribute. + if ( ! empty( $meta_value['is_taxonomy'] ) ) { + if ( ! taxonomy_exists( $meta_value['name'] ) ) { + continue; + } + $id = wc_attribute_taxonomy_id_by_name( $meta_value['name'] ); + $options = wc_get_object_terms( $product->get_id(), $meta_value['name'], 'term_id' ); + } else { + $id = 0; + $options = wc_get_text_attributes( $meta_value['value'] ); + } + + $attribute = new WC_Product_Attribute(); + $attribute->set_id( $id ); + $attribute->set_name( $meta_value['name'] ); + $attribute->set_options( $options ); + $attribute->set_position( $meta_value['position'] ); + $attribute->set_visible( $meta_value['is_visible'] ); + $attribute->set_variation( $meta_value['is_variation'] ); + $attributes[] = $attribute; + } + $product->set_attributes( $attributes ); + + if ( $force_update ) { + $this->update_attributes( $product, true ); + } + } + } + /** * Read product data. * * @since 3.0.0 * - * @param WC_Product $product + * @param WC_Product $product Product object. */ protected function read_product_data( &$product ) { parent::read_product_data( $product ); - // Set directly since individual data needs changed at the WC_Product_Variation level -- these datasets just pull. - $children = $this->read_children( $product ); - $product->set_children( $children['all'] ); - $product->set_visible_children( $children['visible'] ); - $product->set_variation_attributes( $this->read_variation_attributes( $product ) ); + // Make sure data which does not apply to variables is unset. + $product->set_regular_price( '' ); + $product->set_sale_price( '' ); } /** * Loads variation child IDs. * - * @param WC_Product - * @param bool $force_read True to bypass the transient. + * @param WC_Product $product Product object. + * @param bool $force_read True to bypass the transient. * @return array */ - protected function read_children( &$product, $force_read = false ) { + public function read_children( &$product, $force_read = false ) { $children_transient_name = 'wc_product_children_' . $product->get_id(); $children = get_transient( $children_transient_name ); if ( empty( $children ) || ! is_array( $children ) || ! isset( $children['all'] ) || ! isset( $children['visible'] ) || $force_read ) { - $all_args = $visible_only_args = array( + $all_args = array( 'post_parent' => $product->get_id(), 'post_type' => 'product_variation', - 'orderby' => array( 'menu_order' => 'ASC', 'ID' => 'ASC' ), + 'orderby' => array( + 'menu_order' => 'ASC', + 'ID' => 'ASC', + ), 'fields' => 'ids', - 'post_status' => 'publish', - 'numberposts' => -1, + 'post_status' => array( 'publish', 'private' ), + 'numberposts' => -1, // phpcs:ignore WordPress.VIP.PostsPerPage.posts_per_page_numberposts ); + + $visible_only_args = $all_args; + $visible_only_args['post_status'] = 'publish'; + if ( 'yes' === get_option( 'woocommerce_hide_out_of_stock_items' ) ) { $visible_only_args['tax_query'][] = array( 'taxonomy' => 'product_visibility', @@ -79,15 +157,22 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple /** * Loads an array of attributes used for variations, as well as their possible values. * - * @param WC_Product + * @param WC_Product $product Product object. * @return array */ - protected function read_variation_attributes( &$product ) { + public function read_variation_attributes( &$product ) { global $wpdb; $variation_attributes = array(); $attributes = $product->get_attributes(); $child_ids = $product->get_children(); + $cache_key = WC_Cache_Helper::get_cache_prefix( 'products' ) . 'product_variation_attributes_' . $product->get_id(); + $cache_group = 'products'; + $cached_data = wp_cache_get( $cache_key, $cache_group ); + + if ( false !== $cached_data ) { + return $cached_data; + } if ( ! empty( $child_ids ) && ! empty( $attributes ) ) { foreach ( $attributes as $attribute ) { @@ -96,31 +181,35 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple } // Get possible values for this attribute, for only visible variations. - $values = array_unique( $wpdb->get_col( $wpdb->prepare( - "SELECT meta_value FROM {$wpdb->postmeta} WHERE meta_key = %s AND post_id IN (" . implode( ',', array_map( 'absint', $child_ids ) ) . ")", - wc_variation_attribute_name( $attribute['name'] ) - ) ) ); + $values = array_unique( + $wpdb->get_col( + $wpdb->prepare( + "SELECT meta_value FROM {$wpdb->postmeta} WHERE meta_key = %s AND post_id IN (" . implode( ',', array_map( 'absint', $child_ids ) ) . ')', // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + wc_variation_attribute_name( $attribute['name'] ) + ) + ) + ); // Empty value indicates that all options for given attribute are available. - if ( in_array( '', $values ) || empty( $values ) ) { + if ( in_array( null, $values, true ) || in_array( '', $values, true ) || empty( $values ) ) { $values = $attribute['is_taxonomy'] ? wc_get_object_terms( $product->get_id(), $attribute['name'], 'slug' ) : wc_get_text_attributes( $attribute['value'] ); - // Get custom attributes (non taxonomy) as defined. + // Get custom attributes (non taxonomy) as defined. } elseif ( ! $attribute['is_taxonomy'] ) { $text_attributes = wc_get_text_attributes( $attribute['value'] ); $assigned_text_attributes = $values; $values = array(); - // Pre 2.4 handling where 'slugs' were saved instead of the full text attribute + // Pre 2.4 handling where 'slugs' were saved instead of the full text attribute. if ( version_compare( get_post_meta( $product->get_id(), '_product_version', true ), '2.4.0', '<' ) ) { $assigned_text_attributes = array_map( 'sanitize_title', $assigned_text_attributes ); foreach ( $text_attributes as $text_attribute ) { - if ( in_array( sanitize_title( $text_attribute ), $assigned_text_attributes ) ) { + if ( in_array( sanitize_title( $text_attribute ), $assigned_text_attributes, true ) ) { $values[] = $text_attribute; } } } else { foreach ( $text_attributes as $text_attribute ) { - if ( in_array( $text_attribute, $assigned_text_attributes ) ) { + if ( in_array( $text_attribute, $assigned_text_attributes, true ) ) { $values[] = $text_attribute; } } @@ -130,6 +219,8 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple } } + wp_cache_set( $cache_key, $variation_attributes, $cache_group ); + return $variation_attributes; } @@ -140,19 +231,20 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple * This is to ensure modified prices are not cached, unless intended. * * @since 3.0.0 - * @param WC_Product - * @param bool $include_taxes If taxes should be calculated or not. + * @param WC_Product $product Product object. + * @param bool $for_display If true, prices will be adapted for display based on the `woocommerce_tax_display_shop` setting (including or excluding taxes). * @return array of prices */ - public function read_price_data( &$product, $include_taxes = false ) { + public function read_price_data( &$product, $for_display = false ) { /** * Transient name for storing prices for this product (note: Max transient length is 45) + * * @since 2.5.0 a single transient is used per product for all prices, rather than many transients per product. */ $transient_name = 'wc_var_prices_' . $product->get_id(); - $price_hash = $this->get_price_hash( $product, $include_taxes ); + $price_hash = $this->get_price_hash( $product, $for_display ); /** * $this->prices_array is an array of values which may have been modified from what is stored in transients - this may not match $transient_cached_prices_array. @@ -173,31 +265,63 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple $sale_prices = array(); $variation_ids = $product->get_visible_children(); foreach ( $variation_ids as $variation_id ) { - if ( $variation = wc_get_product( $variation_id ) ) { + $variation = wc_get_product( $variation_id ); + + if ( $variation ) { $price = apply_filters( 'woocommerce_variation_prices_price', $variation->get_price( 'edit' ), $variation, $product ); $regular_price = apply_filters( 'woocommerce_variation_prices_regular_price', $variation->get_regular_price( 'edit' ), $variation, $product ); $sale_price = apply_filters( 'woocommerce_variation_prices_sale_price', $variation->get_sale_price( 'edit' ), $variation, $product ); - // Skip empty prices + // Skip empty prices. if ( '' === $price ) { continue; } - // If sale price does not equal price, the product is not yet on sale + // If sale price does not equal price, the product is not yet on sale. if ( $sale_price === $regular_price || $sale_price !== $price ) { $sale_price = $regular_price; } - // If we are getting prices for display, we need to account for taxes - if ( $include_taxes ) { + // If we are getting prices for display, we need to account for taxes. + if ( $for_display ) { if ( 'incl' === get_option( 'woocommerce_tax_display_shop' ) ) { - $price = '' === $price ? '' : wc_get_price_including_tax( $variation, array( 'qty' => 1, 'price' => $price ) ); - $regular_price = '' === $regular_price ? '' : wc_get_price_including_tax( $variation, array( 'qty' => 1, 'price' => $regular_price ) ); - $sale_price = '' === $sale_price ? '' : wc_get_price_including_tax( $variation, array( 'qty' => 1, 'price' => $sale_price ) ); + $price = '' === $price ? '' : wc_get_price_including_tax( + $variation, array( + 'qty' => 1, + 'price' => $price, + ) + ); + $regular_price = '' === $regular_price ? '' : wc_get_price_including_tax( + $variation, array( + 'qty' => 1, + 'price' => $regular_price, + ) + ); + $sale_price = '' === $sale_price ? '' : wc_get_price_including_tax( + $variation, array( + 'qty' => 1, + 'price' => $sale_price, + ) + ); } else { - $price = '' === $price ? '' : wc_get_price_excluding_tax( $variation, array( 'qty' => 1, 'price' => $price ) ); - $regular_price = '' === $regular_price ? '' : wc_get_price_excluding_tax( $variation, array( 'qty' => 1, 'price' => $regular_price ) ); - $sale_price = '' === $sale_price ? '' : wc_get_price_excluding_tax( $variation, array( 'qty' => 1, 'price' => $sale_price ) ); + $price = '' === $price ? '' : wc_get_price_excluding_tax( + $variation, array( + 'qty' => 1, + 'price' => $price, + ) + ); + $regular_price = '' === $regular_price ? '' : wc_get_price_excluding_tax( + $variation, array( + 'qty' => 1, + 'price' => $regular_price, + ) + ); + $sale_price = '' === $sale_price ? '' : wc_get_price_excluding_tax( + $variation, array( + 'qty' => 1, + 'price' => $sale_price, + ) + ); } } @@ -213,31 +337,31 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple 'sale_price' => $sale_prices, ); - set_transient( $transient_name, json_encode( $transient_cached_prices_array ), DAY_IN_SECONDS * 30 ); + set_transient( $transient_name, wp_json_encode( $transient_cached_prices_array ), DAY_IN_SECONDS * 30 ); } /** * Give plugins one last chance to filter the variation prices array which has been generated and store locally to the class. * This value may differ from the transient cache. It is filtered once before storing locally. */ - $this->prices_array[ $price_hash ] = apply_filters( 'woocommerce_variation_prices', $transient_cached_prices_array[ $price_hash ], $product, $include_taxes ); + $this->prices_array[ $price_hash ] = apply_filters( 'woocommerce_variation_prices', $transient_cached_prices_array[ $price_hash ], $product, $for_display ); } return $this->prices_array[ $price_hash ]; } /** * Create unique cache key based on the tax location (affects displayed/cached prices), product version and active price filters. - * DEVELOPERS should filter this hash if offering conditonal pricing to keep it unique. + * DEVELOPERS should filter this hash if offering conditional pricing to keep it unique. * * @since 3.0.0 - * @param WC_Product - * @param bool $include_taxes If taxes should be calculated or not. + * @param WC_Product $product Product object. + * @param bool $for_display If taxes should be calculated or not. * @return string */ - protected function get_price_hash( &$product, $include_taxes = false ) { + protected function get_price_hash( &$product, $for_display = false ) { global $wp_filter; - $price_hash = $include_taxes ? array( get_option( 'woocommerce_tax_display_shop', 'excl' ), WC_Tax::get_rates() ) : array( false ); + $price_hash = $for_display && wc_tax_enabled() ? array( get_option( 'woocommerce_tax_display_shop', 'excl' ), WC_Tax::get_rates() ) : array( false ); $filter_names = array( 'woocommerce_variation_prices_price', 'woocommerce_variation_prices_regular_price', 'woocommerce_variation_prices_sale_price' ); foreach ( $filter_names as $filter_name ) { @@ -251,7 +375,11 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple } $price_hash[] = WC_Cache_Helper::get_transient_version( 'product' ); - $price_hash = md5( json_encode( apply_filters( 'woocommerce_get_variation_prices_hash', $price_hash, $product, $include_taxes ) ) ); + $price_hash = md5( + wp_json_encode( + apply_filters( 'woocommerce_get_variation_prices_hash', $price_hash, $product, $for_display ) + ) + ); return $price_hash; } @@ -260,65 +388,89 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple * Does a child have a weight set? * * @since 3.0.0 - * @param WC_Product + * @param WC_Product $product Product object. * @return boolean */ public function child_has_weight( $product ) { global $wpdb; $children = $product->get_visible_children(); - return $children ? null !== $wpdb->get_var( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = '_weight' AND meta_value > 0 AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . " )" ) : false; + return $children ? null !== $wpdb->get_var( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = '_weight' AND meta_value > 0 AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . ' )' ) : false; // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared } /** * Does a child have dimensions set? * * @since 3.0.0 - * @param WC_Product + * @param WC_Product $product Product object. * @return boolean */ public function child_has_dimensions( $product ) { global $wpdb; $children = $product->get_visible_children(); - return $children ? null !== $wpdb->get_var( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key IN ( '_length', '_width', '_height' ) AND meta_value > 0 AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . " )" ) : false; + return $children ? null !== $wpdb->get_var( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key IN ( '_length', '_width', '_height' ) AND meta_value > 0 AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . ' )' ) : false; // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared } /** * Is a child in stock? * * @since 3.0.0 - * @param WC_Product + * @param WC_Product $product Product object. * @return boolean */ public function child_is_in_stock( $product ) { + return $this->child_has_stock_status( $product, 'instock' ); + } + + /** + * Does a child have a stock status? + * + * @since 3.3.0 + * @param WC_Product $product Product object. + * @param string $status 'instock', 'outofstock', or 'onbackorder'. + * @return boolean + */ + public function child_has_stock_status( $product, $status ) { global $wpdb; - $children = $product->get_children(); - $oufofstock_children = $children ? $wpdb->get_var( "SELECT COUNT( post_id ) FROM $wpdb->postmeta WHERE meta_key = '_stock_status' AND meta_value = 'outofstock' AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . " )" ) : 0; - return count( $children ) > $oufofstock_children; + + $children = $product->get_children(); + + if ( $children ) { + $children_with_status = $wpdb->get_var( + $wpdb->prepare( + "SELECT COUNT( post_id ) FROM $wpdb->postmeta WHERE meta_key = '_stock_status' AND meta_value = %s AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . ' )', // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $status + ) + ); + } else { + $children_with_status = 0; + } + + return (bool) $children_with_status; } /** * Syncs all variation names if the parent name is changed. * - * @param WC_Product $product - * @param string $previous_name - * @param string $new_name + * @param WC_Product $product Product object. + * @param string $previous_name Variation previous name. + * @param string $new_name Variation new name. * @since 3.0.0 */ public function sync_variation_names( &$product, $previous_name = '', $new_name = '' ) { if ( $new_name !== $previous_name ) { global $wpdb; - $wpdb->query( $wpdb->prepare( - " - UPDATE {$wpdb->posts} + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->posts} SET post_title = REPLACE( post_title, %s, %s ) WHERE post_type = 'product_variation' - AND post_parent = %d - ", - $previous_name ? $previous_name : 'AUTO-DRAFT', - $new_name, - $product->get_id() - ) ); + AND post_parent = %d", + $previous_name ? $previous_name : 'AUTO-DRAFT', + $new_name, + $product->get_id() + ) + ); } } @@ -326,7 +478,7 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple * Stock managed at the parent level - update children being managed by this product. * This sync function syncs downwards (from parent to child) when the variable product is saved. * - * @param WC_Product + * @param WC_Product $product Product object. * @since 3.0.0 */ public function sync_managed_variation_stock_status( &$product ) { @@ -335,7 +487,7 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple if ( $product->get_manage_stock() ) { $status = $product->get_stock_status(); $children = $product->get_children(); - $managed_children = $children ? array_unique( $wpdb->get_col( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = '_manage_stock' AND meta_value != 'yes' AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . " )" ) ) : array(); + $managed_children = $children ? array_unique( $wpdb->get_col( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = '_manage_stock' AND meta_value != 'yes' AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . ' )' ) ) : array(); // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared $changed = false; foreach ( $managed_children as $managed_child ) { if ( update_post_meta( $managed_child, '_stock_status', $status ) ) { @@ -354,15 +506,17 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple * Sync variable product prices with children. * * @since 3.0.0 - * @param WC_Product|int $product + * @param WC_Product $product Product object. */ public function sync_price( &$product ) { global $wpdb; $children = $product->get_visible_children(); - $prices = $children ? array_unique( $wpdb->get_col( "SELECT meta_value FROM $wpdb->postmeta WHERE meta_key = '_price' AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . " )" ) ) : array(); + $prices = $children ? array_unique( $wpdb->get_col( "SELECT meta_value FROM $wpdb->postmeta WHERE meta_key = '_price' AND post_id IN ( " . implode( ',', array_map( 'absint', $children ) ) . ' )' ) ) : array(); // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared delete_post_meta( $product->get_id(), '_price' ); + delete_post_meta( $product->get_id(), '_sale_price' ); + delete_post_meta( $product->get_id(), '_regular_price' ); if ( $prices ) { sort( $prices ); @@ -381,17 +535,23 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple * Change does not persist unless saved by caller. * * @since 3.0.0 - * @param WC_Product|int $product + * @param WC_Product $product Product object. */ public function sync_stock_status( &$product ) { - $product->set_stock_status( $product->child_is_in_stock() ? 'instock' : 'outofstock' ); + if ( $product->child_is_in_stock() ) { + $product->set_stock_status( 'instock' ); + } elseif ( $product->child_is_on_backorder() ) { + $product->set_stock_status( 'onbackorder' ); + } else { + $product->set_stock_status( 'outofstock' ); + } } /** * Delete variations of a product. * * @since 3.0.0 - * @param int $product_id + * @param int $product_id Product ID. * @param bool $force_delete False to trash. */ public function delete_variations( $product_id, $force_delete = false ) { @@ -399,13 +559,17 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple return; } - $variation_ids = wp_parse_id_list( get_posts( array( - 'post_parent' => $product_id, - 'post_type' => 'product_variation', - 'fields' => 'ids', - 'post_status' => array( 'any', 'trash', 'auto-draft' ), - 'numberposts' => -1, - ) ) ); + $variation_ids = wp_parse_id_list( + get_posts( + array( + 'post_parent' => $product_id, + 'post_type' => 'product_variation', + 'fields' => 'ids', + 'post_status' => array( 'any', 'trash', 'auto-draft' ), + 'numberposts' => -1, // phpcs:ignore WordPress.VIP.PostsPerPage.posts_per_page_numberposts + ) + ) + ); if ( ! empty( $variation_ids ) ) { foreach ( $variation_ids as $variation_id ) { @@ -423,16 +587,20 @@ class WC_Product_Variable_Data_Store_CPT extends WC_Product_Data_Store_CPT imple /** * Untrash variations. * - * @param int $product_id + * @param int $product_id Product ID. */ public function untrash_variations( $product_id ) { - $variation_ids = wp_parse_id_list( get_posts( array( - 'post_parent' => $product_id, - 'post_type' => 'product_variation', - 'fields' => 'ids', - 'post_status' => 'trash', - 'numberposts' => -1, - ) ) ); + $variation_ids = wp_parse_id_list( + get_posts( + array( + 'post_parent' => $product_id, + 'post_type' => 'product_variation', + 'fields' => 'ids', + 'post_status' => 'trash', + 'numberposts' => -1, // phpcs:ignore WordPress.VIP.PostsPerPage.posts_per_page_numberposts + ) + ) + ); if ( ! empty( $variation_ids ) ) { foreach ( $variation_ids as $variation_id ) { diff --git a/includes/data-stores/class-wc-product-variation-data-store-cpt.php b/includes/data-stores/class-wc-product-variation-data-store-cpt.php index 5e3ca5b44b9..b209f4b485c 100644 --- a/includes/data-stores/class-wc-product-variation-data-store-cpt.php +++ b/includes/data-stores/class-wc-product-variation-data-store-cpt.php @@ -1,4 +1,10 @@ meta_key, $this->internal_meta_keys ) && 0 !== stripos( $meta->meta_key, 'attribute_' ) && 0 !== stripos( $meta->meta_key, 'wp_' ); + return ! in_array( $meta->meta_key, $this->internal_meta_keys, true ) && 0 !== stripos( $meta->meta_key, 'attribute_' ) && 0 !== stripos( $meta->meta_key, 'wp_' ); } /* @@ -32,26 +36,33 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * Reads a product from the database and sets its data to the class. * * @since 3.0.0 - * @param WC_Product $product - * @throws Exception + * @param WC_Product $product Product object. $product Product object. */ public function read( &$product ) { $product->set_defaults(); - if ( ! $product->get_id() || ! ( $post_object = get_post( $product->get_id() ) ) || ! in_array( $post_object->post_type, array( 'product', 'product_variation' ) ) ) { + if ( ! $product->get_id() ) { return; } - $product->set_props( array( - 'name' => $post_object->post_title, - 'slug' => $post_object->post_name, - 'date_created' => 0 < $post_object->post_date_gmt ? wc_string_to_timestamp( $post_object->post_date_gmt ) : null, - 'date_modified' => 0 < $post_object->post_modified_gmt ? wc_string_to_timestamp( $post_object->post_modified_gmt ) : null, - 'status' => $post_object->post_status, - 'menu_order' => $post_object->menu_order, - 'reviews_allowed' => 'open' === $post_object->comment_status, - 'parent_id' => $post_object->post_parent, - ) ); + $post_object = get_post( $product->get_id() ); + + if ( ! $post_object || ! in_array( $post_object->post_type, array( 'product', 'product_variation' ), true ) ) { + return; + } + + $product->set_props( + array( + 'name' => $post_object->post_title, + 'slug' => $post_object->post_name, + 'date_created' => 0 < $post_object->post_date_gmt ? wc_string_to_timestamp( $post_object->post_date_gmt ) : null, + 'date_modified' => 0 < $post_object->post_modified_gmt ? wc_string_to_timestamp( $post_object->post_modified_gmt ) : null, + 'status' => $post_object->post_status, + 'menu_order' => $post_object->menu_order, + 'reviews_allowed' => 'open' === $post_object->comment_status, + 'parent_id' => $post_object->post_parent, + ) + ); // The post parent is not a valid variable product so we should prevent this. if ( $product->get_parent_id( 'edit' ) && 'product' !== get_post_type( $product->get_parent_id( 'edit' ) ) ) { @@ -82,7 +93,7 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * Create a new product. * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product Product object. */ public function create( &$product ) { if ( ! $product->get_date_created() ) { @@ -100,20 +111,24 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl $product->set_parent_id( 0 ); } - $id = wp_insert_post( apply_filters( 'woocommerce_new_product_variation_data', array( - 'post_type' => 'product_variation', - 'post_status' => $product->get_status() ? $product->get_status() : 'publish', - 'post_author' => get_current_user_id(), - 'post_title' => $product->get_name( 'edit' ), - 'post_content' => '', - 'post_parent' => $product->get_parent_id(), - 'comment_status' => 'closed', - 'ping_status' => 'closed', - 'menu_order' => $product->get_menu_order(), - 'post_date' => gmdate( 'Y-m-d H:i:s', $product->get_date_created( 'edit' )->getOffsetTimestamp() ), - 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $product->get_date_created( 'edit' )->getTimestamp() ), - 'post_name' => $product->get_slug( 'edit' ), - ) ), true ); + $id = wp_insert_post( + apply_filters( + 'woocommerce_new_product_variation_data', array( + 'post_type' => 'product_variation', + 'post_status' => $product->get_status() ? $product->get_status() : 'publish', + 'post_author' => get_current_user_id(), + 'post_title' => $product->get_name( 'edit' ), + 'post_content' => '', + 'post_parent' => $product->get_parent_id(), + 'comment_status' => 'closed', + 'ping_status' => 'closed', + 'menu_order' => $product->get_menu_order(), + 'post_date' => gmdate( 'Y-m-d H:i:s', $product->get_date_created( 'edit' )->getOffsetTimestamp() ), + 'post_date_gmt' => gmdate( 'Y-m-d H:i:s', $product->get_date_created( 'edit' )->getTimestamp() ), + 'post_name' => $product->get_slug( 'edit' ), + ) + ), true + ); if ( $id && ! is_wp_error( $id ) ) { $product->set_id( $id ); @@ -139,7 +154,7 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * Updates an existing product. * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product Product object. */ public function update( &$product ) { $product->save_meta_data(); @@ -192,6 +207,19 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl wp_update_post( array_merge( array( 'ID' => $product->get_id() ), $post_data ) ); } $product->read_meta_data( true ); // Refresh internal meta data, in case things were hooked into `save_post` or another WP hook. + + } else { // Only update post modified time to record this save event. + $GLOBALS['wpdb']->update( + $GLOBALS['wpdb']->posts, + array( + 'post_modified' => current_time( 'mysql' ), + 'post_modified_gmt' => current_time( 'mysql', 1 ), + ), + array( + 'ID' => $product->get_id(), + ) + ); + clean_post_cache( $product->get_id() ); } $this->update_post_meta( $product ); @@ -220,7 +248,7 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * Products will get a title of the form "Name - Value, Value" or just "Name". * * @since 3.0.0 - * @param WC_Product + * @param WC_Product $product Product object. * @return string */ protected function generate_product_title( $product ) { @@ -251,10 +279,11 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl /** * Make sure we store the product version (to track data changes). * - * @param WC_Product + * @param WC_Product $product Product object. * @since 3.0.0 */ protected function update_version_and_type( &$product ) { + wp_set_object_terms( $product->get_id(), '', 'product_type' ); update_post_meta( $product->get_id(), '_product_version', WC_VERSION ); } @@ -262,35 +291,38 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * Read post data. * * @since 3.0.0 - * @param WC_Product + * @param WC_Product $product Product object. + * @throws WC_Data_Exception If WC_Product::set_tax_status() is called with an invalid tax status. */ protected function read_product_data( &$product ) { $id = $product->get_id(); - $product->set_props( array( - 'description' => get_post_meta( $id, '_variation_description', true ), - 'regular_price' => get_post_meta( $id, '_regular_price', true ), - 'sale_price' => get_post_meta( $id, '_sale_price', true ), - 'date_on_sale_from' => get_post_meta( $id, '_sale_price_dates_from', true ), - 'date_on_sale_to' => get_post_meta( $id, '_sale_price_dates_to', true ), - 'manage_stock' => get_post_meta( $id, '_manage_stock', true ), - 'stock_status' => get_post_meta( $id, '_stock_status', true ), - 'shipping_class_id' => current( $this->get_term_ids( $id, 'product_shipping_class' ) ), - 'virtual' => get_post_meta( $id, '_virtual', true ), - 'downloadable' => get_post_meta( $id, '_downloadable', true ), - 'gallery_image_ids' => array_filter( explode( ',', get_post_meta( $id, '_product_image_gallery', true ) ) ), - 'download_limit' => get_post_meta( $id, '_download_limit', true ), - 'download_expiry' => get_post_meta( $id, '_download_expiry', true ), - 'image_id' => get_post_thumbnail_id( $id ), - 'backorders' => get_post_meta( $id, '_backorders', true ), - 'sku' => get_post_meta( $id, '_sku', true ), - 'stock_quantity' => get_post_meta( $id, '_stock', true ), - 'weight' => get_post_meta( $id, '_weight', true ), - 'length' => get_post_meta( $id, '_length', true ), - 'width' => get_post_meta( $id, '_width', true ), - 'height' => get_post_meta( $id, '_height', true ), - 'tax_class' => ! metadata_exists( 'post', $id, '_tax_class' ) ? 'parent' : get_post_meta( $id, '_tax_class', true ), - ) ); + $product->set_props( + array( + 'description' => get_post_meta( $id, '_variation_description', true ), + 'regular_price' => get_post_meta( $id, '_regular_price', true ), + 'sale_price' => get_post_meta( $id, '_sale_price', true ), + 'date_on_sale_from' => get_post_meta( $id, '_sale_price_dates_from', true ), + 'date_on_sale_to' => get_post_meta( $id, '_sale_price_dates_to', true ), + 'manage_stock' => get_post_meta( $id, '_manage_stock', true ), + 'stock_status' => get_post_meta( $id, '_stock_status', true ), + 'shipping_class_id' => current( $this->get_term_ids( $id, 'product_shipping_class' ) ), + 'virtual' => get_post_meta( $id, '_virtual', true ), + 'downloadable' => get_post_meta( $id, '_downloadable', true ), + 'gallery_image_ids' => array_filter( explode( ',', get_post_meta( $id, '_product_image_gallery', true ) ) ), + 'download_limit' => get_post_meta( $id, '_download_limit', true ), + 'download_expiry' => get_post_meta( $id, '_download_expiry', true ), + 'image_id' => get_post_thumbnail_id( $id ), + 'backorders' => get_post_meta( $id, '_backorders', true ), + 'sku' => get_post_meta( $id, '_sku', true ), + 'stock_quantity' => get_post_meta( $id, '_stock', true ), + 'weight' => get_post_meta( $id, '_weight', true ), + 'length' => get_post_meta( $id, '_length', true ), + 'width' => get_post_meta( $id, '_width', true ), + 'height' => get_post_meta( $id, '_height', true ), + 'tax_class' => ! metadata_exists( 'post', $id, '_tax_class' ) ? 'parent' : get_post_meta( $id, '_tax_class', true ), + ) + ); if ( $product->is_on_sale( 'edit' ) ) { $product->set_price( $product->get_sale_price( 'edit' ) ); @@ -301,8 +333,8 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl $parent_object = get_post( $product->get_parent_id() ); $terms = get_the_terms( $product->get_parent_id(), 'product_visibility' ); $term_names = is_array( $terms ) ? wp_list_pluck( $terms, 'name' ) : array(); - $exclude_search = in_array( 'exclude-from-search', $term_names ); - $exclude_catalog = in_array( 'exclude-from-catalog', $term_names ); + $exclude_search = in_array( 'exclude-from-search', $term_names, true ); + $exclude_catalog = in_array( 'exclude-from-catalog', $term_names, true ); if ( $exclude_search && $exclude_catalog ) { $catalog_visibility = 'hidden'; @@ -314,22 +346,26 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl $catalog_visibility = 'visible'; } - $product->set_parent_data( array( - 'title' => $parent_object ? $parent_object->post_title : '', - 'sku' => get_post_meta( $product->get_parent_id(), '_sku', true ), - 'manage_stock' => get_post_meta( $product->get_parent_id(), '_manage_stock', true ), - 'backorders' => get_post_meta( $product->get_parent_id(), '_backorders', true ), - 'stock_quantity' => wc_stock_amount( get_post_meta( $product->get_parent_id(), '_stock', true ) ), - 'weight' => get_post_meta( $product->get_parent_id(), '_weight', true ), - 'length' => get_post_meta( $product->get_parent_id(), '_length', true ), - 'width' => get_post_meta( $product->get_parent_id(), '_width', true ), - 'height' => get_post_meta( $product->get_parent_id(), '_height', true ), - 'tax_class' => get_post_meta( $product->get_parent_id(), '_tax_class', true ), - 'shipping_class_id' => absint( current( $this->get_term_ids( $product->get_parent_id(), 'product_shipping_class' ) ) ), - 'image_id' => get_post_thumbnail_id( $product->get_parent_id() ), - 'purchase_note' => get_post_meta( $product->get_parent_id(), '_purchase_note', true ), - 'catalog_visibility' => $catalog_visibility, - ) ); + $product->set_parent_data( + array( + 'title' => $parent_object ? $parent_object->post_title : '', + 'status' => $parent_object ? $parent_object->post_status : '', + 'sku' => get_post_meta( $product->get_parent_id(), '_sku', true ), + 'manage_stock' => get_post_meta( $product->get_parent_id(), '_manage_stock', true ), + 'backorders' => get_post_meta( $product->get_parent_id(), '_backorders', true ), + 'low_stock_amount' => get_post_meta( $product->get_parent_id(), '_low_stock_amount', true ), + 'stock_quantity' => wc_stock_amount( get_post_meta( $product->get_parent_id(), '_stock', true ) ), + 'weight' => get_post_meta( $product->get_parent_id(), '_weight', true ), + 'length' => get_post_meta( $product->get_parent_id(), '_length', true ), + 'width' => get_post_meta( $product->get_parent_id(), '_width', true ), + 'height' => get_post_meta( $product->get_parent_id(), '_height', true ), + 'tax_class' => get_post_meta( $product->get_parent_id(), '_tax_class', true ), + 'shipping_class_id' => absint( current( $this->get_term_ids( $product->get_parent_id(), 'product_shipping_class' ) ) ), + 'image_id' => get_post_thumbnail_id( $product->get_parent_id() ), + 'purchase_note' => get_post_meta( $product->get_parent_id(), '_purchase_note', true ), + 'catalog_visibility' => $catalog_visibility, + ) + ); // Pull data from the parent when there is no user-facing way to set props. $product->set_sold_individually( get_post_meta( $product->get_parent_id(), '_sold_individually', true ) ); @@ -341,8 +377,8 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * For all stored terms in all taxonomies, save them to the DB. * * @since 3.0.0 - * @param WC_Product - * @param bool Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. */ protected function update_terms( &$product, $force = false ) { $changes = $product->get_changes(); @@ -357,8 +393,8 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * * @since 3.0.0 * - * @param WC_Product $product - * @param bool $force Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. */ protected function update_visibility( &$product, $force = false ) { $changes = $product->get_changes(); @@ -378,8 +414,8 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * Update attribute meta values. * * @since 3.0.0 - * @param WC_Product - * @param bool Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. */ protected function update_attributes( &$product, $force = false ) { $changes = $product->get_changes(); @@ -394,7 +430,13 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl } // Remove old taxonomies attributes so data is kept up to date - first get attribute key names. - $delete_attribute_keys = $wpdb->get_col( $wpdb->prepare( "SELECT meta_key FROM {$wpdb->postmeta} WHERE meta_key LIKE 'attribute_%%' AND meta_key NOT IN ( '" . implode( "','", array_map( 'esc_sql', $updated_attribute_keys ) ) . "' ) AND post_id = %d;", $product->get_id() ) ); + $delete_attribute_keys = $wpdb->get_col( + $wpdb->prepare( + "SELECT meta_key FROM {$wpdb->postmeta} WHERE meta_key LIKE %s AND meta_key NOT IN ( '" . implode( "','", array_map( 'esc_sql', $updated_attribute_keys ) ) . "' ) AND post_id = %d", // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQLPlaceholders.QuotedDynamicPlaceholderGeneration + $wpdb->esc_like( 'attribute_' ) . '%', + $product->get_id() + ) + ); foreach ( $delete_attribute_keys as $key ) { delete_post_meta( $product->get_id(), $key ); @@ -406,8 +448,8 @@ class WC_Product_Variation_Data_Store_CPT extends WC_Product_Data_Store_CPT impl * Helper method that updates all the post meta for a product based on it's settings in the WC_Product class. * * @since 3.0.0 - * @param WC_Product - * @param bool Force update. Used during create. + * @param WC_Product $product Product object. + * @param bool $force Force update. Used during create. */ public function update_post_meta( &$product, $force = false ) { $meta_key_to_props = array( diff --git a/includes/data-stores/class-wc-shipping-zone-data-store.php b/includes/data-stores/class-wc-shipping-zone-data-store.php index b1cff12151e..c6b9f8e3e67 100644 --- a/includes/data-stores/class-wc-shipping-zone-data-store.php +++ b/includes/data-stores/class-wc-shipping-zone-data-store.php @@ -1,4 +1,10 @@ insert( $wpdb->prefix . 'woocommerce_shipping_zones', array( - 'zone_name' => $zone->get_zone_name(), - 'zone_order' => $zone->get_zone_order(), - ) ); + $wpdb->insert( + $wpdb->prefix . 'woocommerce_shipping_zones', array( + 'zone_name' => $zone->get_zone_name(), + 'zone_order' => $zone->get_zone_order(), + ) + ); $zone->set_id( $wpdb->insert_id ); $zone->save_meta_data(); $this->save_locations( $zone ); @@ -36,15 +42,17 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Update zone in the database. * * @since 3.0.0 - * @param WC_Shipping_Zone $zone + * @param WC_Shipping_Zone $zone Shipping zone object. */ public function update( &$zone ) { global $wpdb; if ( $zone->get_id() ) { - $wpdb->update( $wpdb->prefix . 'woocommerce_shipping_zones', array( - 'zone_name' => $zone->get_zone_name(), - 'zone_order' => $zone->get_zone_order(), - ), array( 'zone_id' => $zone->get_id() ) ); + $wpdb->update( + $wpdb->prefix . 'woocommerce_shipping_zones', array( + 'zone_name' => $zone->get_zone_name(), + 'zone_order' => $zone->get_zone_order(), + ), array( 'zone_id' => $zone->get_id() ) + ); } $zone->save_meta_data(); $this->save_locations( $zone ); @@ -57,18 +65,30 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Method to read a shipping zone from the database. * * @since 3.0.0 - * @param WC_Shipping_Zone $zone - * @throws Exception + * @param WC_Shipping_Zone $zone Shipping zone object. + * @throws Exception If invalid data store. */ public function read( &$zone ) { global $wpdb; - if ( 0 === $zone->get_id() || "0" === $zone->get_id() ) { + + $zone_data = false; + + if ( 0 !== $zone->get_id() || '0' !== $zone->get_id() ) { + $zone_data = $wpdb->get_row( + $wpdb->prepare( + "SELECT zone_name, zone_order FROM {$wpdb->prefix}woocommerce_shipping_zones WHERE zone_id = %d LIMIT 1", + $zone->get_id() + ) + ); + } + + if ( 0 === $zone->get_id() || '0' === $zone->get_id() ) { $this->read_zone_locations( $zone ); $zone->set_zone_name( __( 'Locations not covered by your other zones', 'woocommerce' ) ); $zone->read_meta_data(); $zone->set_object_read( true ); do_action( 'woocommerce_shipping_zone_loaded', $zone ); - } elseif ( $zone_data = $wpdb->get_row( $wpdb->prepare( "SELECT zone_name, zone_order FROM {$wpdb->prefix}woocommerce_shipping_zones WHERE zone_id = %d LIMIT 1;", $zone->get_id() ) ) ) { + } elseif ( $zone_data ) { $zone->set_zone_name( $zone_data->zone_name ); $zone->set_zone_order( $zone_data->zone_order ); $this->read_zone_locations( $zone ); @@ -84,9 +104,9 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Deletes a shipping zone from the database. * * @since 3.0.0 - * @param WC_Shipping_Zone $zone - * @param array $args Array of args to pass to the delete method. - * @return bool result + * @param WC_Shipping_Zone $zone Shipping zone object. + * @param array $args Array of args to pass to the delete method. + * @return void */ public function delete( &$zone, $args = array() ) { if ( $zone->get_id() ) { @@ -107,21 +127,27 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Get a list of shipping methods for a specific zone. * * @since 3.0.0 - * @param int $zone_id Zone ID - * @param bool $enabled_only True to request enabled methods only. + * @param int $zone_id Zone ID. + * @param bool $enabled_only True to request enabled methods only. * @return array Array of objects containing method_id, method_order, instance_id, is_enabled */ public function get_methods( $zone_id, $enabled_only ) { global $wpdb; - $raw_methods_sql = $enabled_only ? "SELECT method_id, method_order, instance_id, is_enabled FROM {$wpdb->prefix}woocommerce_shipping_zone_methods WHERE zone_id = %d AND is_enabled = 1;" : "SELECT method_id, method_order, instance_id, is_enabled FROM {$wpdb->prefix}woocommerce_shipping_zone_methods WHERE zone_id = %d;"; - return $wpdb->get_results( $wpdb->prepare( $raw_methods_sql, $zone_id ) ); + + if ( $enabled_only ) { + $raw_methods_sql = "SELECT method_id, method_order, instance_id, is_enabled FROM {$wpdb->prefix}woocommerce_shipping_zone_methods WHERE zone_id = %d AND is_enabled = 1"; + } else { + $raw_methods_sql = "SELECT method_id, method_order, instance_id, is_enabled FROM {$wpdb->prefix}woocommerce_shipping_zone_methods WHERE zone_id = %d"; + } + + return $wpdb->get_results( $wpdb->prepare( $raw_methods_sql, $zone_id ) ); // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared } /** * Get count of methods for a zone. * * @since 3.0.0 - * @param int Zone ID + * @param int $zone_id Zone ID. * @return int Method Count */ public function get_method_count( $zone_id ) { @@ -133,9 +159,9 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Add a shipping method to a zone. * * @since 3.0.0 - * @param int $zone_id Zone ID - * @param string $type Method Type/ID - * @param int $order Method Order + * @param int $zone_id Zone ID. + * @param string $type Method Type/ID. + * @param int $order Method Order. * @return int Instance ID */ public function add_method( $zone_id, $type, $order ) { @@ -160,7 +186,7 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Delete a method instance. * * @since 3.0.0 - * @param int $instance_id + * @param int $instance_id Instance ID. */ public function delete_method( $instance_id ) { global $wpdb; @@ -172,7 +198,7 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Get a shipping zone method instance. * * @since 3.0.0 - * @param int + * @param int $instance_id Instance ID. * @return object */ public function get_method( $instance_id ) { @@ -184,25 +210,25 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Find a matching zone ID for a given package. * * @since 3.0.0 - * @param object $package + * @param object $package Package information. * @return int */ public function get_zone_id_from_package( $package ) { global $wpdb; - $country = strtoupper( wc_clean( $package['destination']['country'] ) ); - $state = strtoupper( wc_clean( $package['destination']['state'] ) ); - $continent = strtoupper( wc_clean( WC()->countries->get_continent_code_for_country( $country ) ) ); - $postcode = wc_normalize_postcode( wc_clean( $package['destination']['postcode'] ) ); + $country = strtoupper( wc_clean( $package['destination']['country'] ) ); + $state = strtoupper( wc_clean( $package['destination']['state'] ) ); + $continent = strtoupper( wc_clean( WC()->countries->get_continent_code_for_country( $country ) ) ); + $postcode = wc_normalize_postcode( wc_clean( $package['destination']['postcode'] ) ); - // Work out criteria for our zone search + // Work out criteria for our zone search. $criteria = array(); $criteria[] = $wpdb->prepare( "( ( location_type = 'country' AND location_code = %s )", $country ); $criteria[] = $wpdb->prepare( "OR ( location_type = 'state' AND location_code = %s )", $country . ':' . $state ); $criteria[] = $wpdb->prepare( "OR ( location_type = 'continent' AND location_code = %s )", $continent ); - $criteria[] = "OR ( location_type IS NULL ) )"; + $criteria[] = 'OR ( location_type IS NULL ) )'; - // Postcode range and wildcard matching + // Postcode range and wildcard matching. $postcode_locations = $wpdb->get_results( "SELECT zone_id, location_code FROM {$wpdb->prefix}woocommerce_shipping_zone_locations WHERE location_type = 'postcode';" ); if ( $postcode_locations ) { @@ -211,17 +237,17 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin $do_not_match = array_unique( array_diff( $zone_ids_with_postcode_rules, array_keys( $matches ) ) ); if ( ! empty( $do_not_match ) ) { - $criteria[] = "AND zones.zone_id NOT IN (" . implode( ',', $do_not_match ) . ")"; + $criteria[] = 'AND zones.zone_id NOT IN (' . implode( ',', $do_not_match ) . ')'; } } - // Get matching zones - return $wpdb->get_var( " - SELECT zones.zone_id FROM {$wpdb->prefix}woocommerce_shipping_zones as zones + // Get matching zones. + return $wpdb->get_var( + "SELECT zones.zone_id FROM {$wpdb->prefix}woocommerce_shipping_zones as zones LEFT OUTER JOIN {$wpdb->prefix}woocommerce_shipping_zone_locations as locations ON zones.zone_id = locations.zone_id AND location_type != 'postcode' - WHERE " . implode( ' ', $criteria ) . " - ORDER BY zone_order ASC LIMIT 1 - " ); + WHERE " . implode( ' ', $criteria ) // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + . ' ORDER BY zone_order ASC, zone_id ASC LIMIT 1' + ); } /** @@ -232,7 +258,7 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin */ public function get_zones() { global $wpdb; - return $wpdb->get_results( "SELECT zone_id, zone_name, zone_order FROM {$wpdb->prefix}woocommerce_shipping_zones order by zone_order ASC;" ); + return $wpdb->get_results( "SELECT zone_id, zone_name, zone_order FROM {$wpdb->prefix}woocommerce_shipping_zones order by zone_order ASC, zone_id ASC;" ); } @@ -240,7 +266,7 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * Return a zone ID from an instance ID. * * @since 3.0.0 - * @param int + * @param int $id Instnace ID. * @return int */ public function get_zone_id_by_instance_id( $id ) { @@ -251,11 +277,19 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin /** * Read location data from the database. * - * @param WC_Shipping_Zone + * @param WC_Shipping_Zone $zone Shipping zone object. */ private function read_zone_locations( &$zone ) { global $wpdb; - if ( $locations = $wpdb->get_results( $wpdb->prepare( "SELECT location_code, location_type FROM {$wpdb->prefix}woocommerce_shipping_zone_locations WHERE zone_id = %d;", $zone->get_id() ) ) ) { + + $locations = $wpdb->get_results( + $wpdb->prepare( + "SELECT location_code, location_type FROM {$wpdb->prefix}woocommerce_shipping_zone_locations WHERE zone_id = %d", + $zone->get_id() + ) + ); + + if ( $locations ) { foreach ( $locations as $location ) { $zone->add_location( $location->location_code, $location->location_type ); } @@ -268,13 +302,13 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin * * @since 3.0.0 * - * @param WC_Shipping_Zone + * @param WC_Shipping_Zone $zone Shipping zone object. * * @return bool|void */ private function save_locations( &$zone ) { $changed_props = array_keys( $zone->get_changes() ); - if ( ! in_array( 'zone_locations', $changed_props ) ) { + if ( ! in_array( 'zone_locations', $changed_props, true ) ) { return false; } @@ -282,11 +316,13 @@ class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Shippin $wpdb->delete( $wpdb->prefix . 'woocommerce_shipping_zone_locations', array( 'zone_id' => $zone->get_id() ) ); foreach ( $zone->get_zone_locations( 'edit' ) as $location ) { - $wpdb->insert( $wpdb->prefix . 'woocommerce_shipping_zone_locations', array( - 'zone_id' => $zone->get_id(), - 'location_code' => $location->code, - 'location_type' => $location->type, - ) ); + $wpdb->insert( + $wpdb->prefix . 'woocommerce_shipping_zone_locations', array( + 'zone_id' => $zone->get_id(), + 'location_code' => $location->code, + 'location_type' => $location->type, + ) + ); } } } diff --git a/includes/data-stores/class-wc-webhook-data-store.php b/includes/data-stores/class-wc-webhook-data-store.php new file mode 100644 index 00000000000..fd3a53bfed9 --- /dev/null +++ b/includes/data-stores/class-wc-webhook-data-store.php @@ -0,0 +1,352 @@ +get_changes(); + if ( isset( $changes['date_created'] ) ) { + $date_created = $webhook->get_date_created()->date( 'Y-m-d H:i:s' ); + $date_created_gmt = gmdate( 'Y-m-d H:i:s', $webhook->get_date_created()->getTimestamp() ); + } else { + $date_created = current_time( 'mysql' ); + $date_created_gmt = current_time( 'mysql', 1 ); + $webhook->set_date_created( $date_created ); + } + + // Pending delivery by default if not set while creating a new webhook. + if ( ! isset( $changes['pending_delivery'] ) ) { + $webhook->set_pending_delivery( true ); + } + + $data = array( + 'status' => $webhook->get_status( 'edit' ), + 'name' => $webhook->get_name( 'edit' ), + 'user_id' => $webhook->get_user_id( 'edit' ), + 'delivery_url' => $webhook->get_delivery_url( 'edit' ), + 'secret' => $webhook->get_secret( 'edit' ), + 'topic' => $webhook->get_topic( 'edit' ), + 'date_created' => $date_created, + 'date_created_gmt' => $date_created_gmt, + 'api_version' => $this->get_api_version_number( $webhook->get_api_version( 'edit' ) ), + 'failure_count' => $webhook->get_failure_count( 'edit' ), + 'pending_delivery' => $webhook->get_pending_delivery( 'edit' ), + ); + + $wpdb->insert( $wpdb->prefix . 'wc_webhooks', $data ); // WPCS: DB call ok. + + $webhook_id = $wpdb->insert_id; + $webhook->set_id( $webhook_id ); + $webhook->apply_changes(); + + delete_transient( 'woocommerce_webhook_ids' ); + WC_Cache_Helper::incr_cache_prefix( 'webhooks' ); + do_action( 'woocommerce_new_webhook', $webhook_id ); + } + + /** + * Read a webhook from the database. + * + * @since 3.3.0 + * @param WC_Webhook $webhook Webhook instance. + * @throws Exception When webhook is invalid. + */ + public function read( &$webhook ) { + global $wpdb; + + $data = wp_cache_get( $webhook->get_id(), 'webhooks' ); + + if ( false === $data ) { + $data = $wpdb->get_row( $wpdb->prepare( "SELECT webhook_id, status, name, user_id, delivery_url, secret, topic, date_created, date_modified, api_version, failure_count, pending_delivery FROM {$wpdb->prefix}wc_webhooks WHERE webhook_id = %d LIMIT 1;", $webhook->get_id() ), ARRAY_A ); // WPCS: cache ok, DB call ok. + + wp_cache_add( $webhook->get_id(), $data, 'webhooks' ); + } + + if ( is_array( $data ) ) { + $webhook->set_props( + array( + 'id' => $data['webhook_id'], + 'status' => $data['status'], + 'name' => $data['name'], + 'user_id' => $data['user_id'], + 'delivery_url' => $data['delivery_url'], + 'secret' => $data['secret'], + 'topic' => $data['topic'], + 'date_created' => '0000-00-00 00:00:00' === $data['date_created'] ? null : $data['date_created'], + 'date_modified' => '0000-00-00 00:00:00' === $data['date_modified'] ? null : $data['date_modified'], + 'api_version' => $data['api_version'], + 'failure_count' => $data['failure_count'], + 'pending_delivery' => $data['pending_delivery'], + ) + ); + $webhook->set_object_read( true ); + + do_action( 'woocommerce_webhook_loaded', $webhook ); + } else { + throw new Exception( __( 'Invalid webhook.', 'woocommerce' ) ); + } + } + + /** + * Update a webhook. + * + * @since 3.3.0 + * @param WC_Webhook $webhook Webhook instance. + */ + public function update( &$webhook ) { + global $wpdb; + + $changes = $webhook->get_changes(); + $trigger = isset( $changes['delivery_url'] ); + + if ( isset( $changes['date_modified'] ) ) { + $date_modified = $webhook->get_date_modified()->date( 'Y-m-d H:i:s' ); + $date_modified_gmt = gmdate( 'Y-m-d H:i:s', $webhook->get_date_modified()->getTimestamp() ); + } else { + $date_modified = current_time( 'mysql' ); + $date_modified_gmt = current_time( 'mysql', 1 ); + $webhook->set_date_modified( $date_modified ); + } + + $data = array( + 'status' => $webhook->get_status( 'edit' ), + 'name' => $webhook->get_name( 'edit' ), + 'user_id' => $webhook->get_user_id( 'edit' ), + 'delivery_url' => $webhook->get_delivery_url( 'edit' ), + 'secret' => $webhook->get_secret( 'edit' ), + 'topic' => $webhook->get_topic( 'edit' ), + 'date_modified' => $date_modified, + 'date_modified_gmt' => $date_modified_gmt, + 'api_version' => $this->get_api_version_number( $webhook->get_api_version( 'edit' ) ), + 'failure_count' => $webhook->get_failure_count( 'edit' ), + 'pending_delivery' => $webhook->get_pending_delivery( 'edit' ), + ); + + $wpdb->update( + $wpdb->prefix . 'wc_webhooks', + $data, + array( + 'webhook_id' => $webhook->get_id( 'edit' ), + ) + ); // WPCS: DB call ok. + + $webhook->apply_changes(); + + wp_cache_delete( $webhook->get_id(), 'webhooks' ); + WC_Cache_Helper::incr_cache_prefix( 'webhooks' ); + + if ( 'active' === $webhook->get_status() && ( $trigger || $webhook->get_pending_delivery() ) ) { + $webhook->deliver_ping(); + } + + do_action( 'woocommerce_webhook_updated', $webhook->get_id() ); + } + + /** + * Remove a webhook from the database. + * + * @since 3.3.0 + * @param WC_Webhook $webhook Webhook instance. + * @param bool $force_delete Skip trash bin forcing to delete. + */ + public function delete( &$webhook, $force_delete = false ) { + global $wpdb; + + $wpdb->delete( + $wpdb->prefix . 'wc_webhooks', + array( + 'webhook_id' => $webhook->get_id(), + ), + array( '%d' ) + ); // WPCS: cache ok, DB call ok. + + delete_transient( 'woocommerce_webhook_ids' ); + WC_Cache_Helper::incr_cache_prefix( 'webhooks' ); + do_action( 'woocommerce_webhook_deleted', $webhook->get_id(), $webhook ); + } + + /** + * Get API version number. + * + * @since 3.3.0 + * @param string $api_version REST API version. + * @return int + */ + public function get_api_version_number( $api_version ) { + return 'legacy_v3' === $api_version ? -1 : intval( substr( $api_version, -1 ) ); + } + + /** + * Get all webhooks IDs. + * + * @since 3.3.0 + * @return int[] + */ + public function get_webhooks_ids() { + global $wpdb; + + $ids = get_transient( 'woocommerce_webhook_ids' ); + + if ( false === $ids ) { + $results = $wpdb->get_results( "SELECT webhook_id FROM {$wpdb->prefix}wc_webhooks" ); // WPCS: cache ok, DB call ok. + $ids = array_map( 'intval', wp_list_pluck( $results, 'webhook_id' ) ); + + set_transient( 'woocommerce_webhook_ids', $ids ); + } + + return $ids; + } + + /** + * Search webhooks. + * + * @param array $args Search arguments. + * @return array + */ + public function search_webhooks( $args ) { + global $wpdb; + + $args = wp_parse_args( + $args, array( + 'limit' => 10, + 'offset' => 0, + 'order' => 'DESC', + 'orderby' => 'id', + ) + ); + + // Map post statuses. + $statuses = array( + 'publish' => 'active', + 'draft' => 'paused', + 'pending' => 'disabled', + ); + + // Map orderby to support a few post keys. + $orderby_mapping = array( + 'ID' => 'webhook_id', + 'id' => 'webhook_id', + 'name' => 'name', + 'title' => 'name', + 'post_title' => 'name', + 'post_name' => 'name', + 'date_created' => 'date_created_gmt', + 'date' => 'date_created_gmt', + 'post_date' => 'date_created_gmt', + 'date_modified' => 'date_modified_gmt', + 'modified' => 'date_modified_gmt', + 'post_modified' => 'date_modified_gmt', + ); + $orderby = isset( $orderby_mapping[ $args['orderby'] ] ) ? $orderby_mapping[ $args['orderby'] ] : 'webhook_id'; + + $limit = -1 < $args['limit'] ? sprintf( 'LIMIT %d', $args['limit'] ) : ''; + $offset = 0 < $args['offset'] ? sprintf( 'OFFSET %d', $args['offset'] ) : ''; + $status = ! empty( $args['status'] ) ? "AND `status` = '" . sanitize_key( isset( $statuses[ $args['status'] ] ) ? $statuses[ $args['status'] ] : $args['status'] ) . "'" : ''; + $search = ! empty( $args['search'] ) ? "AND `name` LIKE '%" . $wpdb->esc_like( sanitize_text_field( $args['search'] ) ) . "%'" : ''; + $include = ''; + $exclude = ''; + $date_created = ''; + $date_modified = ''; + + if ( ! empty( $args['include'] ) ) { + $args['include'] = implode( ',', wp_parse_id_list( $args['include'] ) ); + $include = 'AND webhook_id IN (' . $args['include'] . ')'; + } + + if ( ! empty( $args['exclude'] ) ) { + $args['exclude'] = implode( ',', wp_parse_id_list( $args['exclude'] ) ); + $exclude = 'AND webhook_id NOT IN (' . $args['exclude'] . ')'; + } + + if ( ! empty( $args['after'] ) || ! empty( $args['before'] ) ) { + $args['after'] = empty( $args['after'] ) ? '0000-00-00' : $args['after']; + $args['before'] = empty( $args['before'] ) ? current_time( 'mysql', 1 ) : $args['before']; + + $date_created = "AND `date_created_gmt` BETWEEN STR_TO_DATE('" . $args['after'] . "', '%Y-%m-%d %H:%i:%s') and STR_TO_DATE('" . $args['before'] . "', '%Y-%m-%d %H:%i:%s')"; + } + + if ( ! empty( $args['modified_after'] ) || ! empty( $args['modified_before'] ) ) { + $args['modified_after'] = empty( $args['modified_after'] ) ? '0000-00-00' : $args['modified_after']; + $args['modified_before'] = empty( $args['modified_before'] ) ? current_time( 'mysql', 1 ) : $args['modified_before']; + + $date_modified = "AND `date_modified_gmt` BETWEEN STR_TO_DATE('" . $args['modified_after'] . "', '%Y-%m-%d %H:%i:%s') and STR_TO_DATE('" . $args['modified_before'] . "', '%Y-%m-%d %H:%i:%s')"; + } + + $order = "ORDER BY {$orderby} " . strtoupper( sanitize_key( $args['order'] ) ); + + // Check for cache. + $cache_key = WC_Cache_Helper::get_cache_prefix( 'webhooks' ) . 'search_webhooks' . md5( implode( ',', $args ) ); + $ids = wp_cache_get( $cache_key, 'webhook_search_results' ); + + if ( false !== $ids ) { + return $ids; + } + + $query = trim( + "SELECT webhook_id + FROM {$wpdb->prefix}wc_webhooks + WHERE 1=1 + {$status} + {$search} + {$include} + {$exclude} + {$date_created} + {$date_modified} + {$order} + {$limit} + {$offset}" + ); + + $results = $wpdb->get_results( $query ); // WPCS: cache ok, DB call ok, unprepared SQL ok. + + $ids = wp_list_pluck( $results, 'webhook_id' ); + wp_cache_set( $cache_key, $ids, 'webhook_search_results' ); + + return $ids; + } + + /** + * Get total webhook counts by status. + * + * @return array + */ + public function get_count_webhooks_by_status() { + $statuses = array_keys( wc_get_webhook_statuses() ); + $counts = array(); + + foreach ( $statuses as $status ) { + $count = count( + $this->search_webhooks( + array( + 'limit' => -1, + 'status' => $status, + ) + ) + ); + + $counts[ $status ] = $count; + } + + return $counts; + } +} diff --git a/includes/emails/class-wc-email-cancelled-order.php b/includes/emails/class-wc-email-cancelled-order.php index 8dbac9969c3..06df5915cd2 100644 --- a/includes/emails/class-wc-email-cancelled-order.php +++ b/includes/emails/class-wc-email-cancelled-order.php @@ -1,4 +1,9 @@ id = 'cancelled_order'; - $this->title = __( 'Cancelled order', 'woocommerce' ); - $this->description = __( 'Cancelled order emails are sent to chosen recipient(s) when orders have been marked cancelled (if they were previously processing or on-hold).', 'woocommerce' ); - $this->template_html = 'emails/admin-cancelled-order.php'; - $this->template_plain = 'emails/plain/admin-cancelled-order.php'; - - // Triggers for this email - add_action( 'woocommerce_order_status_processing_to_cancelled_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_on-hold_to_cancelled_notification', array( $this, 'trigger' ), 10, 2 ); - - // Call parent constructor - parent::__construct(); - - // Other settings - $this->recipient = $this->get_option( 'recipient', get_option( 'admin_email' ) ); - } - - /** - * Get email subject. + * Cancelled Order Email. * - * @since 3.1.0 - * @return string - */ - public function get_default_subject() { - return __( '[{site_title}] Cancelled order ({order_number})', 'woocommerce' ); - } - - /** - * Get email heading. + * An email sent to the admin when an order is cancelled. * - * @since 3.1.0 - * @return string + * @class WC_Email_Cancelled_Order + * @version 2.2.7 + * @package WooCommerce/Classes/Emails + * @extends WC_Email */ - public function get_default_heading() { - return __( 'Cancelled order', 'woocommerce' ); - } + class WC_Email_Cancelled_Order extends WC_Email { - /** - * Trigger the sending of this email. - * - * @param int $order_id The order ID. - * @param WC_Order $order Order object. - */ - public function trigger( $order_id, $order = false ) { - if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { - $order = wc_get_order( $order_id ); + /** + * Constructor. + */ + public function __construct() { + $this->id = 'cancelled_order'; + $this->title = __( 'Cancelled order', 'woocommerce' ); + $this->description = __( 'Cancelled order emails are sent to chosen recipient(s) when orders have been marked cancelled (if they were previously processing or on-hold).', 'woocommerce' ); + $this->template_html = 'emails/admin-cancelled-order.php'; + $this->template_plain = 'emails/plain/admin-cancelled-order.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', + '{order_billing_full_name}' => '', + ); + + // Triggers for this email. + add_action( 'woocommerce_order_status_processing_to_cancelled_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_on-hold_to_cancelled_notification', array( $this, 'trigger' ), 10, 2 ); + + // Call parent constructor. + parent::__construct(); + + // Other settings. + $this->recipient = $this->get_option( 'recipient', get_option( 'admin_email' ) ); } - if ( is_a( $order, 'WC_Order' ) ) { - $this->object = $order; - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( '[{site_title}]: {order_billing_full_name} has cancelled order #{order_number}', 'woocommerce' ); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'Order Cancelled: #{order_number}', 'woocommerce' ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Trigger the sending of this email. + * + * @param int $order_id The order ID. + * @param WC_Order|false $order Order object. + */ + public function trigger( $order_id, $order = false ) { + $this->setup_locale(); - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => true, - 'plain_text' => false, - 'email' => $this, - ) ); - } + if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { + $order = wc_get_order( $order_id ); + } - /** - * Get content plain. - * - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => true, - 'plain_text' => true, - 'email' => $this, - ) ); - } + if ( is_a( $order, 'WC_Order' ) ) { + $this->object = $order; + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + $this->placeholders['{order_billing_full_name}'] = $this->object->get_formatted_billing_full_name(); + } - /** - * Initialise settings form fields. - */ - public function init_form_fields() { - $this->form_fields = array( - 'enabled' => array( - 'title' => __( 'Enable/Disable', 'woocommerce' ), - 'type' => 'checkbox', - 'label' => __( 'Enable this email notification', 'woocommerce' ), - 'default' => 'yes', - ), - 'recipient' => array( - 'title' => __( 'Recipient(s)', 'woocommerce' ), - 'type' => 'text', - /* translators: %s: admin email */ - 'description' => sprintf( __( 'Enter recipients (comma separated) for this email. Defaults to %s.', 'woocommerce' ), '' . esc_attr( get_option( 'admin_email' ) ) . '' ), - 'placeholder' => '', - 'default' => '', - 'desc_tip' => true, - ), - 'subject' => array( - 'title' => __( 'Subject', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_subject(), - 'default' => '', - ), - 'heading' => array( - 'title' => __( 'Email heading', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_heading(), - 'default' => '', - ), - 'email_type' => array( - 'title' => __( 'Email type', 'woocommerce' ), - 'type' => 'select', - 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), - 'default' => 'html', - 'class' => 'email_type wc-enhanced-select', - 'options' => $this->get_email_type_options(), - 'desc_tip' => true, - ), - ); + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); + } + + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => true, + 'plain_text' => false, + 'email' => $this, + ) + ); + } + + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => true, + 'plain_text' => true, + 'email' => $this, + ) + ); + } + + /** + * Initialise settings form fields. + */ + public function init_form_fields() { + $this->form_fields = array( + 'enabled' => array( + 'title' => __( 'Enable/Disable', 'woocommerce' ), + 'type' => 'checkbox', + 'label' => __( 'Enable this email notification', 'woocommerce' ), + 'default' => 'yes', + ), + 'recipient' => array( + 'title' => __( 'Recipient(s)', 'woocommerce' ), + 'type' => 'text', + /* translators: %s: admin email */ + 'description' => sprintf( __( 'Enter recipients (comma separated) for this email. Defaults to %s.', 'woocommerce' ), '' . esc_attr( get_option( 'admin_email' ) ) . '' ), + 'placeholder' => '', + 'default' => '', + 'desc_tip' => true, + ), + 'subject' => array( + 'title' => __( 'Subject', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_subject(), + 'default' => '', + ), + 'heading' => array( + 'title' => __( 'Email heading', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_heading(), + 'default' => '', + ), + 'email_type' => array( + 'title' => __( 'Email type', 'woocommerce' ), + 'type' => 'select', + 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), + 'default' => 'html', + 'class' => 'email_type wc-enhanced-select', + 'options' => $this->get_email_type_options(), + 'desc_tip' => true, + ), + ); + } } -} endif; diff --git a/includes/emails/class-wc-email-customer-completed-order.php b/includes/emails/class-wc-email-customer-completed-order.php index 68d499750d9..5a515dc51cb 100644 --- a/includes/emails/class-wc-email-customer-completed-order.php +++ b/includes/emails/class-wc-email-customer-completed-order.php @@ -1,169 +1,174 @@ id = 'customer_completed_order'; - $this->customer_email = true; - - $this->title = __( 'Completed order', 'woocommerce' ); - $this->description = __( 'Order complete emails are sent to customers when their orders are marked completed and usually indicate that their orders have been shipped.', 'woocommerce' ); - - $this->template_html = 'emails/customer-completed-order.php'; - $this->template_plain = 'emails/plain/customer-completed-order.php'; - - // Triggers for this email - add_action( 'woocommerce_order_status_completed_notification', array( $this, 'trigger' ), 10, 2 ); - - // Call parent constuctor - parent::__construct(); - } - - /** - * Trigger the sending of this email. + * Customer Completed Order Email. * - * @param int $order_id The order ID. - * @param WC_Order $order Order object. + * Order complete emails are sent to the customer when the order is marked complete and usual indicates that the order has been shipped. + * + * @class WC_Email_Customer_Completed_Order + * @version 2.0.0 + * @package WooCommerce/Classes/Emails + * @extends WC_Email */ - public function trigger( $order_id, $order = false ) { - if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { - $order = wc_get_order( $order_id ); + class WC_Email_Customer_Completed_Order extends WC_Email { + + /** + * Constructor. + */ + public function __construct() { + $this->id = 'customer_completed_order'; + $this->customer_email = true; + $this->title = __( 'Completed order', 'woocommerce' ); + $this->description = __( 'Order complete emails are sent to customers when their orders are marked completed and usually indicate that their orders have been shipped.', 'woocommerce' ); + $this->template_html = 'emails/customer-completed-order.php'; + $this->template_plain = 'emails/plain/customer-completed-order.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', + ); + + // Triggers for this email. + add_action( 'woocommerce_order_status_completed_notification', array( $this, 'trigger' ), 10, 2 ); + + // Call parent constructor. + parent::__construct(); } - if ( is_a( $order, 'WC_Order' ) ) { - $this->object = $order; - $this->recipient = $this->object->get_billing_email(); + /** + * Trigger the sending of this email. + * + * @param int $order_id The order ID. + * @param WC_Order|false $order Order object. + */ + public function trigger( $order_id, $order = false ) { + $this->setup_locale(); - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; + if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { + $order = wc_get_order( $order_id ); + } - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); + if ( is_a( $order, 'WC_Order' ) ) { + $this->object = $order; + $this->recipient = $this->object->get_billing_email(); + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + } + + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( 'Your {site_title} order is now complete', 'woocommerce' ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'Thanks for shopping with us', 'woocommerce' ); + } - /** - * Get email subject. - * - * @since 3.1.0 - * @return string - */ - public function get_default_subject() { - return __( 'Your {site_title} order from {order_date} is complete', 'woocommerce' ); - } + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => false, + 'email' => $this, + ) + ); + } - /** - * Get email heading. - * - * @since 3.1.0 - * @return string - */ - public function get_default_heading() { - return __( 'Your order is complete', 'woocommerce' ); - } + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => true, + 'email' => $this, + ) + ); + } - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => false, - 'email' => $this, - ) ); + /** + * Initialise settings form fields. + */ + public function init_form_fields() { + $this->form_fields = array( + 'enabled' => array( + 'title' => __( 'Enable/Disable', 'woocommerce' ), + 'type' => 'checkbox', + 'label' => __( 'Enable this email notification', 'woocommerce' ), + 'default' => 'yes', + ), + 'subject' => array( + 'title' => __( 'Subject', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_subject(), + 'default' => '', + ), + 'heading' => array( + 'title' => __( 'Email heading', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_heading(), + 'default' => '', + ), + 'email_type' => array( + 'title' => __( 'Email type', 'woocommerce' ), + 'type' => 'select', + 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), + 'default' => 'html', + 'class' => 'email_type wc-enhanced-select', + 'options' => $this->get_email_type_options(), + 'desc_tip' => true, + ), + ); + } } - /** - * Get content plain. - * - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => true, - 'email' => $this, - ) ); - } - - /** - * Initialise settings form fields. - */ - public function init_form_fields() { - $this->form_fields = array( - 'enabled' => array( - 'title' => __( 'Enable/Disable', 'woocommerce' ), - 'type' => 'checkbox', - 'label' => __( 'Enable this email notification', 'woocommerce' ), - 'default' => 'yes', - ), - 'subject' => array( - 'title' => __( 'Subject', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_subject(), - 'default' => '', - ), - 'heading' => array( - 'title' => __( 'Email heading', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_heading(), - 'default' => '', - ), - 'email_type' => array( - 'title' => __( 'Email type', 'woocommerce' ), - 'type' => 'select', - 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), - 'default' => 'html', - 'class' => 'email_type wc-enhanced-select', - 'options' => $this->get_email_type_options(), - 'desc_tip' => true, - ), - ); - } -} - endif; return new WC_Email_Customer_Completed_Order(); diff --git a/includes/emails/class-wc-email-customer-invoice.php b/includes/emails/class-wc-email-customer-invoice.php index d585621bde5..d6659c4f1bf 100644 --- a/includes/emails/class-wc-email-customer-invoice.php +++ b/includes/emails/class-wc-email-customer-invoice.php @@ -1,236 +1,226 @@ id = 'customer_invoice'; + $this->customer_email = true; + $this->title = __( 'Customer invoice / Order details', 'woocommerce' ); + $this->description = __( 'Customer invoice emails can be sent to customers containing their order information and payment links.', 'woocommerce' ); + $this->template_html = 'emails/customer-invoice.php'; + $this->template_plain = 'emails/plain/customer-invoice.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', + ); - $this->id = 'customer_invoice'; - $this->customer_email = true; + // Call parent constructor. + parent::__construct(); - $this->title = __( 'Customer invoice', 'woocommerce' ); - $this->description = __( 'Customer invoice emails can be sent to customers containing their order information and payment links.', 'woocommerce' ); - $this->template_html = 'emails/customer-invoice.php'; - $this->template_plain = 'emails/plain/customer-invoice.php'; - - // Call parent constructor - parent::__construct(); - - $this->manual = true; - } - - /** - * Get email subject. - * - * @since 3.1.0 - * @return string - */ - public function get_default_subject( $paid = false ) { - if ( $paid ) { - return __( 'Your {site_title} order from {order_date}', 'woocommerce' ); - } else { - return __( 'Invoice for order {order_number} from {order_date}', 'woocommerce' ); + $this->manual = true; } - } - /** - * Get email heading. - * - * @since 3.1.0 - * @return string - */ - public function get_default_heading( $paid = false ) { - if ( $paid ) { - return __( 'Order {order_number} details', 'woocommerce' ); - } else { - return __( 'Invoice for order {order_number}', 'woocommerce' ); + /** + * Get email subject. + * + * @param bool $paid Whether the order has been paid or not. + * @since 3.1.0 + * @return string + */ + public function get_default_subject( $paid = false ) { + if ( $paid ) { + return __( 'Invoice for order #{order_number} on {site_title}', 'woocommerce' ); + } else { + return __( 'Your latest {site_title} invoice', 'woocommerce' ); + } } - } - /** - * Get email subject. - * - * @access public - * @return string - */ - public function get_subject() { - if ( $this->object->has_status( array( 'completed', 'processing' ) ) ) { - $subject = $this->get_option( 'subject_paid', $this->get_default_subject( true ) ); - $action = 'woocommerce_email_subject_customer_invoice_paid'; - } else { + /** + * Get email heading. + * + * @param bool $paid Whether the order has been paid or not. + * @since 3.1.0 + * @return string + */ + public function get_default_heading( $paid = false ) { + if ( $paid ) { + return __( 'Invoice for order #{order_number}', 'woocommerce' ); + } else { + return __( 'Your invoice for order #{order_number}', 'woocommerce' ); + } + } + + /** + * Get email subject. + * + * @return string + */ + public function get_subject() { + if ( $this->object->has_status( array( 'completed', 'processing' ) ) ) { + $subject = $this->get_option( 'subject_paid', $this->get_default_subject( true ) ); + + return apply_filters( 'woocommerce_email_subject_customer_invoice_paid', $this->format_string( $subject ), $this->object ); + } + $subject = $this->get_option( 'subject', $this->get_default_subject() ); - $action = 'woocommerce_email_subject_customer_invoice'; + return apply_filters( 'woocommerce_email_subject_customer_invoice', $this->format_string( $subject ), $this->object ); } - return apply_filters( $action, $this->format_string( $subject ), $this->object ); - } - /** - * Get email heading. - * - * @access public - * @return string - */ - public function get_heading() { - if ( $this->object->has_status( wc_get_is_paid_statuses() ) ) { - $heading = $this->get_option( 'heading_paid', $this->get_default_heading( true ) ); - $action = 'woocommerce_email_heading_customer_invoice_paid'; - } else { + /** + * Get email heading. + * + * @return string + */ + public function get_heading() { + if ( $this->object->has_status( wc_get_is_paid_statuses() ) ) { + $heading = $this->get_option( 'heading_paid', $this->get_default_heading( true ) ); + return apply_filters( 'woocommerce_email_heading_customer_invoice_paid', $this->format_string( $heading ), $this->object ); + } + $heading = $this->get_option( 'heading', $this->get_default_heading() ); - $action = 'woocommerce_email_heading_customer_invoice'; - } - return apply_filters( $action, $this->format_string( $heading ), $this->object ); - } - - /** - * Trigger the sending of this email. - * - * @param int $order_id The order ID. - * @param WC_Order $order Order object. - */ - public function trigger( $order_id, $order = false ) { - if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { - $order = wc_get_order( $order_id ); + return apply_filters( 'woocommerce_email_heading_customer_invoice', $this->format_string( $heading ), $this->object ); } - if ( is_a( $order, 'WC_Order' ) ) { - $this->object = $order; - $this->recipient = $this->object->get_billing_email(); + /** + * Trigger the sending of this email. + * + * @param int $order_id The order ID. + * @param WC_Order $order Order object. + */ + public function trigger( $order_id, $order = false ) { + $this->setup_locale(); - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; + if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { + $order = wc_get_order( $order_id ); + } - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); + if ( is_a( $order, 'WC_Order' ) ) { + $this->object = $order; + $this->recipient = $this->object->get_billing_email(); + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + } + + if ( $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); } - if ( ! $this->get_recipient() ) { - return; + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => false, + 'email' => $this, + ) + ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => true, + 'email' => $this, + ) + ); + } - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => false, - 'email' => $this, - ) ); + /** + * Initialise settings form fields. + */ + public function init_form_fields() { + $this->form_fields = array( + 'subject' => array( + 'title' => __( 'Subject', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_subject(), + 'default' => '', + ), + 'heading' => array( + 'title' => __( 'Email heading', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_heading(), + 'default' => '', + ), + 'subject_paid' => array( + 'title' => __( 'Subject (paid)', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_subject( true ), + 'default' => '', + ), + 'heading_paid' => array( + 'title' => __( 'Email heading (paid)', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_heading( true ), + 'default' => '', + ), + 'email_type' => array( + 'title' => __( 'Email type', 'woocommerce' ), + 'type' => 'select', + 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), + 'default' => 'html', + 'class' => 'email_type wc-enhanced-select', + 'options' => $this->get_email_type_options(), + 'desc_tip' => true, + ), + ); + } } - /** - * Get content plain. - * - * @access public - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => true, - 'email' => $this, - ) ); - } - - /** - * Initialise settings form fields. - */ - public function init_form_fields() { - $this->form_fields = array( - 'subject' => array( - 'title' => __( 'Subject', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_subject(), - 'default' => '', - ), - 'heading' => array( - 'title' => __( 'Email heading', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_heading(), - 'default' => '', - ), - 'subject_paid' => array( - 'title' => __( 'Subject (paid)', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_subject( true ), - 'default' => '', - ), - 'heading_paid' => array( - 'title' => __( 'Email heading (paid)', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_heading( true ), - 'default' => '', - ), - 'email_type' => array( - 'title' => __( 'Email type', 'woocommerce' ), - 'type' => 'select', - 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), - 'default' => 'html', - 'class' => 'email_type wc-enhanced-select', - 'options' => $this->get_email_type_options(), - 'desc_tip' => true, - ), - ); - } -} - endif; return new WC_Email_Customer_Invoice(); diff --git a/includes/emails/class-wc-email-customer-new-account.php b/includes/emails/class-wc-email-customer-new-account.php index c9a0ddc25e6..940dca513fe 100644 --- a/includes/emails/class-wc-email-customer-new-account.php +++ b/includes/emails/class-wc-email-customer-new-account.php @@ -1,156 +1,158 @@ id = 'customer_new_account'; - $this->customer_email = true; + /** + * Is the password generated? + * + * @var bool + */ + public $password_generated; - $this->title = __( 'New account', 'woocommerce' ); - $this->description = __( 'Customer "new account" emails are sent to the customer when a customer signs up via checkout or account pages.', 'woocommerce' ); + /** + * Constructor. + */ + public function __construct() { + $this->id = 'customer_new_account'; + $this->customer_email = true; + $this->title = __( 'New account', 'woocommerce' ); + $this->description = __( 'Customer "new account" emails are sent to the customer when a customer signs up via checkout or account pages.', 'woocommerce' ); + $this->template_html = 'emails/customer-new-account.php'; + $this->template_plain = 'emails/plain/customer-new-account.php'; - $this->template_html = 'emails/customer-new-account.php'; - $this->template_plain = 'emails/plain/customer-new-account.php'; - - // Call parent constructor - parent::__construct(); - } - - /** - * Get email subject. - * - * @since 3.1.0 - * @return string - */ - public function get_default_subject() { - return __( 'Your account on {site_title}', 'woocommerce' ); - } - - /** - * Get email heading. - * - * @since 3.1.0 - * @return string - */ - public function get_default_heading() { - return __( 'Welcome to {site_title}', 'woocommerce' ); - } - - /** - * Trigger. - * - * @param int $user_id - * @param string $user_pass - * @param bool $password_generated - */ - public function trigger( $user_id, $user_pass = '', $password_generated = false ) { - - if ( $user_id ) { - $this->object = new WP_User( $user_id ); - - $this->user_pass = $user_pass; - $this->user_login = stripslashes( $this->object->user_login ); - $this->user_email = stripslashes( $this->object->user_email ); - $this->recipient = $this->user_email; - $this->password_generated = $password_generated; + // Call parent constructor. + parent::__construct(); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( 'Your {site_title} account has been created!', 'woocommerce' ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'Welcome to {site_title}', 'woocommerce' ); + } - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'email_heading' => $this->get_heading(), - 'user_login' => $this->user_login, - 'user_pass' => $this->user_pass, - 'blogname' => $this->get_blogname(), - 'password_generated' => $this->password_generated, - 'sent_to_admin' => false, - 'plain_text' => false, - 'email' => $this, - ) ); - } + /** + * Trigger. + * + * @param int $user_id User ID. + * @param string $user_pass User password. + * @param bool $password_generated Whether the password was generated automatically or not. + */ + public function trigger( $user_id, $user_pass = '', $password_generated = false ) { + $this->setup_locale(); - /** - * Get content plain. - * - * @access public - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'email_heading' => $this->get_heading(), - 'user_login' => $this->user_login, - 'user_pass' => $this->user_pass, - 'blogname' => $this->get_blogname(), - 'password_generated' => $this->password_generated, - 'sent_to_admin' => false, - 'plain_text' => true, - 'email' => $this, - ) ); + if ( $user_id ) { + $this->object = new WP_User( $user_id ); + + $this->user_pass = $user_pass; + $this->user_login = stripslashes( $this->object->user_login ); + $this->user_email = stripslashes( $this->object->user_email ); + $this->recipient = $this->user_email; + $this->password_generated = $password_generated; + } + + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); + } + + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'email_heading' => $this->get_heading(), + 'user_login' => $this->user_login, + 'user_pass' => $this->user_pass, + 'blogname' => $this->get_blogname(), + 'password_generated' => $this->password_generated, + 'sent_to_admin' => false, + 'plain_text' => false, + 'email' => $this, + ) + ); + } + + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'email_heading' => $this->get_heading(), + 'user_login' => $this->user_login, + 'user_pass' => $this->user_pass, + 'blogname' => $this->get_blogname(), + 'password_generated' => $this->password_generated, + 'sent_to_admin' => false, + 'plain_text' => true, + 'email' => $this, + ) + ); + } } -} endif; diff --git a/includes/emails/class-wc-email-customer-note.php b/includes/emails/class-wc-email-customer-note.php index 2c9bc939eec..c299ca5bdb9 100644 --- a/includes/emails/class-wc-email-customer-note.php +++ b/includes/emails/class-wc-email-customer-note.php @@ -1,146 +1,153 @@ id = 'customer_note'; - $this->customer_email = true; - - $this->title = __( 'Customer note', 'woocommerce' ); - $this->description = __( 'Customer note emails are sent when you add a note to an order.', 'woocommerce' ); - - $this->template_html = 'emails/customer-note.php'; - $this->template_plain = 'emails/plain/customer-note.php'; - - // Triggers - add_action( 'woocommerce_new_customer_note_notification', array( $this, 'trigger' ) ); - - // Call parent constructor - parent::__construct(); - } - - /** - * Get email subject. + * Customer note emails are sent when you add a note to an order. * - * @since 3.1.0 - * @return string + * @class WC_Email_Customer_Note + * @version 3.5.0 + * @package WooCommerce/Classes/Emails + * @extends WC_Email */ - public function get_default_subject() { - return __( 'Note added to your {site_title} order from {order_date}', 'woocommerce' ); - } + class WC_Email_Customer_Note extends WC_Email { - /** - * Get email heading. - * - * @since 3.1.0 - * @return string - */ - public function get_default_heading() { - return __( 'A note has been added to your order', 'woocommerce' ); - } + /** + * Customer note. + * + * @var string + */ + public $customer_note; - /** - * Trigger. - * - * @param array $args - */ - public function trigger( $args ) { - if ( ! empty( $args ) ) { - $defaults = array( - 'order_id' => '', - 'customer_note' => '', + /** + * Constructor. + */ + public function __construct() { + $this->id = 'customer_note'; + $this->customer_email = true; + $this->title = __( 'Customer note', 'woocommerce' ); + $this->description = __( 'Customer note emails are sent when you add a note to an order.', 'woocommerce' ); + $this->template_html = 'emails/customer-note.php'; + $this->template_plain = 'emails/plain/customer-note.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', ); - $args = wp_parse_args( $args, $defaults ); + // Triggers. + add_action( 'woocommerce_new_customer_note_notification', array( $this, 'trigger' ) ); - extract( $args ); + // Call parent constructor. + parent::__construct(); + } - if ( $order_id && ( $this->object = wc_get_order( $order_id ) ) ) { - $this->recipient = $this->object->get_billing_email(); - $this->customer_note = $customer_note; + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( 'Note added to your {site_title} order from {order_date}', 'woocommerce' ); + } - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'A note has been added to your order', 'woocommerce' ); + } - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); - } else { - return; + /** + * Trigger. + * + * @param array $args Email arguments. + */ + public function trigger( $args ) { + $this->setup_locale(); + + if ( ! empty( $args ) ) { + $defaults = array( + 'order_id' => '', + 'customer_note' => '', + ); + + $args = wp_parse_args( $args, $defaults ); + + $order_id = $args['order_id']; + $customer_note = $args['customer_note']; + + if ( $order_id ) { + $this->object = wc_get_order( $order_id ); + + if ( $this->object ) { + $this->recipient = $this->object->get_billing_email(); + $this->customer_note = $customer_note; + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + } + } } + + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'customer_note' => $this->customer_note, + 'sent_to_admin' => false, + 'plain_text' => false, + 'email' => $this, + ) + ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'customer_note' => $this->customer_note, + 'sent_to_admin' => false, + 'plain_text' => true, + 'email' => $this, + ) + ); + } } - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'customer_note' => $this->customer_note, - 'sent_to_admin' => false, - 'plain_text' => false, - 'email' => $this, - ) ); - } - - /** - * Get content plain. - * - * @access public - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'customer_note' => $this->customer_note, - 'sent_to_admin' => false, - 'plain_text' => true, - 'email' => $this, - ) ); - } -} - endif; return new WC_Email_Customer_Note(); diff --git a/includes/emails/class-wc-email-customer-on-hold-order.php b/includes/emails/class-wc-email-customer-on-hold-order.php index 300e8516c00..70fc5e7c867 100644 --- a/includes/emails/class-wc-email-customer-on-hold-order.php +++ b/includes/emails/class-wc-email-customer-on-hold-order.php @@ -1,127 +1,134 @@ id = 'customer_on_hold_order'; - $this->customer_email = true; - - $this->title = __( 'Order on-hold', 'woocommerce' ); - $this->description = __( 'This is an order notification sent to customers containing order details after an order is placed on-hold.', 'woocommerce' ); - $this->template_html = 'emails/customer-on-hold-order.php'; - $this->template_plain = 'emails/plain/customer-on-hold-order.php'; - - // Triggers for this email - add_action( 'woocommerce_order_status_pending_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_failed_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); - - // Call parent constructor - parent::__construct(); - } - - /** - * Get email subject. + * Customer On-hold Order Email. * - * @since 3.1.0 - * @return string - */ - public function get_default_subject() { - return __( 'Your {site_title} order receipt from {order_date}', 'woocommerce' ); - } - - /** - * Get email heading. + * An email sent to the customer when a new order is on-hold for. * - * @since 3.1.0 - * @return string + * @class WC_Email_Customer_On_Hold_Order + * @version 2.6.0 + * @package WooCommerce/Classes/Emails + * @extends WC_Email */ - public function get_default_heading() { - return __( 'Thank you for your order', 'woocommerce' ); - } + class WC_Email_Customer_On_Hold_Order extends WC_Email { - /** - * Trigger the sending of this email. - * - * @param int $order_id The order ID. - * @param WC_Order $order Order object. - */ - public function trigger( $order_id, $order = false ) { - if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { - $order = wc_get_order( $order_id ); + /** + * Constructor. + */ + public function __construct() { + $this->id = 'customer_on_hold_order'; + $this->customer_email = true; + $this->title = __( 'Order on-hold', 'woocommerce' ); + $this->description = __( 'This is an order notification sent to customers containing order details after an order is placed on-hold.', 'woocommerce' ); + $this->template_html = 'emails/customer-on-hold-order.php'; + $this->template_plain = 'emails/plain/customer-on-hold-order.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', + ); + + // Triggers for this email. + add_action( 'woocommerce_order_status_pending_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_failed_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_cancelled_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); + + // Call parent constructor. + parent::__construct(); } - if ( is_a( $order, 'WC_Order' ) ) { - $this->object = $order; - $this->recipient = $this->object->get_billing_email(); - - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; - - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( 'Your {site_title} order has been received!', 'woocommerce' ); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'Thank you for your order', 'woocommerce' ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Trigger the sending of this email. + * + * @param int $order_id The order ID. + * @param WC_Order|false $order Order object. + */ + public function trigger( $order_id, $order = false ) { + $this->setup_locale(); - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => false, - 'email' => $this, - ) ); - } + if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { + $order = wc_get_order( $order_id ); + } - /** - * Get content plain. - * - * @access public - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => true, - 'email' => $this, - ) ); + if ( is_a( $order, 'WC_Order' ) ) { + $this->object = $order; + $this->recipient = $this->object->get_billing_email(); + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + } + + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); + } + + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => false, + 'email' => $this, + ) + ); + } + + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => true, + 'email' => $this, + ) + ); + } } -} endif; diff --git a/includes/emails/class-wc-email-customer-processing-order.php b/includes/emails/class-wc-email-customer-processing-order.php index 85980d9f1f5..20b6f888c00 100644 --- a/includes/emails/class-wc-email-customer-processing-order.php +++ b/includes/emails/class-wc-email-customer-processing-order.php @@ -1,128 +1,136 @@ id = 'customer_processing_order'; - $this->customer_email = true; - - $this->title = __( 'Processing order', 'woocommerce' ); - $this->description = __( 'This is an order notification sent to customers containing order details after payment.', 'woocommerce' ); - $this->template_html = 'emails/customer-processing-order.php'; - $this->template_plain = 'emails/plain/customer-processing-order.php'; - - // Triggers for this email - add_action( 'woocommerce_order_status_failed_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_on-hold_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_pending_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); - - // Call parent constructor - parent::__construct(); - } - - /** - * Get email subject. + * Customer Processing Order Email. * - * @since 3.1.0 - * @return string - */ - public function get_default_subject() { - return __( 'Your {site_title} order receipt from {order_date}', 'woocommerce' ); - } - - /** - * Get email heading. + * An email sent to the customer when a new order is paid for. * - * @since 3.1.0 - * @return string + * @class WC_Email_Customer_Processing_Order + * @version 3.5.0 + * @package WooCommerce/Classes/Emails + * @extends WC_Email */ - public function get_default_heading() { - return __( 'Thank you for your order', 'woocommerce' ); - } + class WC_Email_Customer_Processing_Order extends WC_Email { - /** - * Trigger the sending of this email. - * - * @param int $order_id The order ID. - * @param WC_Order $order Order object. - */ - public function trigger( $order_id, $order = false ) { - if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { - $order = wc_get_order( $order_id ); + /** + * Constructor. + */ + public function __construct() { + $this->id = 'customer_processing_order'; + $this->customer_email = true; + + $this->title = __( 'Processing order', 'woocommerce' ); + $this->description = __( 'This is an order notification sent to customers containing order details after payment.', 'woocommerce' ); + $this->template_html = 'emails/customer-processing-order.php'; + $this->template_plain = 'emails/plain/customer-processing-order.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', + ); + + // Triggers for this email. + add_action( 'woocommerce_order_status_cancelled_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_failed_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_on-hold_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_pending_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); + + // Call parent constructor. + parent::__construct(); } - if ( is_a( $order, 'WC_Order' ) ) { - $this->object = $order; - $this->recipient = $this->object->get_billing_email(); - - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; - - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( 'Payment received for your order', 'woocommerce' ); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'Thank you for your payment', 'woocommerce' ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Trigger the sending of this email. + * + * @param int $order_id The order ID. + * @param WC_Order|false $order Order object. + */ + public function trigger( $order_id, $order = false ) { + $this->setup_locale(); - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => false, - 'email' => $this, - ) ); - } + if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { + $order = wc_get_order( $order_id ); + } - /** - * Get content plain. - * - * @access public - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => true, - 'email' => $this, - ) ); + if ( is_a( $order, 'WC_Order' ) ) { + $this->object = $order; + $this->recipient = $this->object->get_billing_email(); + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + } + + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); + } + + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => false, + 'email' => $this, + ) + ); + } + + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => true, + 'email' => $this, + ) + ); + } } -} endif; diff --git a/includes/emails/class-wc-email-customer-refunded-order.php b/includes/emails/class-wc-email-customer-refunded-order.php index f52223c8b10..9cff70b7873 100644 --- a/includes/emails/class-wc-email-customer-refunded-order.php +++ b/includes/emails/class-wc-email-customer-refunded-order.php @@ -1,272 +1,281 @@ customer_email = true; - $this->id = 'customer_refunded_order'; - $this->title = __( 'Refunded order', 'woocommerce' ); - $this->description = __( 'Order refunded emails are sent to customers when their orders are refunded.', 'woocommerce' ); - $this->template_html = 'emails/customer-refunded-order.php'; - $this->template_plain = 'emails/plain/customer-refunded-order.php'; + /** + * Refund order. + * + * @var WC_Order|bool + */ + public $refund; - // Triggers for this email - add_action( 'woocommerce_order_fully_refunded_notification', array( $this, 'trigger_full' ), 10, 2 ); - add_action( 'woocommerce_order_partially_refunded_notification', array( $this, 'trigger_partial' ), 10, 2 ); + /** + * Is the order partial refunded? + * + * @var bool + */ + public $partial_refund; - // Call parent constuctor - parent::__construct(); - } + /** + * Constructor. + */ + public function __construct() { + $this->customer_email = true; + $this->id = 'customer_refunded_order'; + $this->title = __( 'Refunded order', 'woocommerce' ); + $this->description = __( 'Order refunded emails are sent to customers when their orders are refunded.', 'woocommerce' ); + $this->template_html = 'emails/customer-refunded-order.php'; + $this->template_plain = 'emails/plain/customer-refunded-order.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', + ); - /** - * Get email subject. - * - * @since 3.1.0 - * @return string - */ - public function get_default_subject( $partial = false ) { - if ( $partial ) { - return __( 'Your {site_title} order from {order_date} has been partially refunded', 'woocommerce' ); - } else { - return __( 'Your {site_title} order from {order_date} has been refunded', 'woocommerce' ); - } - } + // Triggers for this email. + add_action( 'woocommerce_order_fully_refunded_notification', array( $this, 'trigger_full' ), 10, 2 ); + add_action( 'woocommerce_order_partially_refunded_notification', array( $this, 'trigger_partial' ), 10, 2 ); - /** - * Get email heading. - * - * @since 3.1.0 - * @return string - */ - public function get_default_heading( $partial = false ) { - if ( $partial ) { - return __( 'Order {order_number} details', 'woocommerce' ); - } else { - return __( 'Your order has been partially refunded', 'woocommerce' ); - } - } - - /** - * Get email subject. - * - * @access public - * @return string - */ - public function get_subject() { - if ( $this->partial_refund ) { - $subject = $this->get_option( 'subject_partial', $this->get_default_subject( true ) ); - } else { - $subject = $this->get_option( 'subject_full', $this->get_default_heading() ); - } - return apply_filters( 'woocommerce_email_subject_customer_refunded_order', $this->format_string( $subject ), $this->object ); - } - - /** - * Get email heading. - * - * @access public - * @return string - */ - public function get_heading() { - if ( $this->partial_refund ) { - $heading = $this->get_option( 'heading_partial', $this->get_default_heading( true ) ); - } else { - $heading = $this->get_option( 'heading_full', $this->get_default_heading() ); - } - return apply_filters( 'woocommerce_email_heading_customer_refunded_order', $this->format_string( $heading ), $this->object ); - } - - /** - * Set email strings. - * @deprecated 3.1.0 Unused. - */ - public function set_email_strings( $partial_refund = false ) {} - - /** - * Full refund notification. - * - * @param int $order_id - * @param int $refund_id - */ - public function trigger_full( $order_id, $refund_id = null ) { - $this->trigger( $order_id, false, $refund_id ); - } - - /** - * Partial refund notification. - * - * @param int $order_id - * @param int $refund_id - */ - public function trigger_partial( $order_id, $refund_id = null ) { - $this->trigger( $order_id, true, $refund_id ); - } - - /** - * Trigger. - * - * @param int $order_id - * @param bool $partial_refund - * @param int $refund_id - */ - public function trigger( $order_id, $partial_refund = false, $refund_id = null ) { - $this->partial_refund = $partial_refund; - $this->id = $this->partial_refund ? 'customer_partially_refunded_order' : 'customer_refunded_order'; - - if ( $order_id ) { - $this->object = wc_get_order( $order_id ); - $this->recipient = $this->object->get_billing_email(); - - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; - - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); + // Call parent constructor. + parent::__construct(); } - if ( ! empty( $refund_id ) ) { - $this->refund = wc_get_order( $refund_id ); - } else { - $this->refund = false; + /** + * Get email subject. + * + * @param bool $partial Whether it is a partial refund or a full refund. + * @since 3.1.0 + * @return string + */ + public function get_default_subject( $partial = false ) { + if ( $partial ) { + return __( 'Your {site_title} order #{order_number} has been partially refunded', 'woocommerce' ); + } else { + return __( 'Your {site_title} order #{order_number} has been refunded', 'woocommerce' ); + } } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email heading. + * + * @param bool $partial Whether it is a partial refund or a full refund. + * @since 3.1.0 + * @return string + */ + public function get_default_heading( $partial = false ) { + if ( $partial ) { + return __( 'Partial Refund: Order {order_number}', 'woocommerce' ); + } else { + return __( 'Order Refunded: {order_number}', 'woocommerce' ); + } } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Get email subject. + * + * @return string + */ + public function get_subject() { + if ( $this->partial_refund ) { + $subject = $this->get_option( 'subject_partial', $this->get_default_subject( true ) ); + } else { + $subject = $this->get_option( 'subject_full', $this->get_default_subject() ); + } + return apply_filters( 'woocommerce_email_subject_customer_refunded_order', $this->format_string( $subject ), $this->object ); + } - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'refund' => $this->refund, - 'partial_refund' => $this->partial_refund, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => false, - 'email' => $this, - ) ); - } + /** + * Get email heading. + * + * @return string + */ + public function get_heading() { + if ( $this->partial_refund ) { + $heading = $this->get_option( 'heading_partial', $this->get_default_heading( true ) ); + } else { + $heading = $this->get_option( 'heading_full', $this->get_default_heading() ); + } + return apply_filters( 'woocommerce_email_heading_customer_refunded_order', $this->format_string( $heading ), $this->object ); + } - /** - * Get content plain. - * - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'refund' => $this->refund, - 'partial_refund' => $this->partial_refund, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => false, - 'plain_text' => true, - 'email' => $this, - ) ); - } + /** + * Set email strings. + * + * @param bool $partial_refund Whether it is a partial refund or a full refund. + * @deprecated 3.1.0 Unused. + */ + public function set_email_strings( $partial_refund = false ) {} - /** - * Initialise settings form fields. - */ - public function init_form_fields() { - $this->form_fields = array( - 'enabled' => array( - 'title' => __( 'Enable/Disable', 'woocommerce' ), - 'type' => 'checkbox', - 'label' => __( 'Enable this email notification', 'woocommerce' ), - 'default' => 'yes', - ), - 'subject_full' => array( - 'title' => __( 'Full refund subject', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_subject(), - 'default' => '', - ), - 'subject_partial' => array( - 'title' => __( 'Partial refund subject', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_subject( true ), - 'default' => '', - ), - 'heading_full' => array( - 'title' => __( 'Full refund email heading', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_heading(), - 'default' => '', - ), - 'heading_partial' => array( - 'title' => __( 'Partial refund email heading', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_heading( true ), - 'default' => '', - ), - 'email_type' => array( - 'title' => __( 'Email type', 'woocommerce' ), - 'type' => 'select', - 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), - 'default' => 'html', - 'class' => 'email_type wc-enhanced-select', - 'options' => $this->get_email_type_options(), - 'desc_tip' => true, - ), - ); + /** + * Full refund notification. + * + * @param int $order_id Order ID. + * @param int $refund_id Refund ID. + */ + public function trigger_full( $order_id, $refund_id = null ) { + $this->trigger( $order_id, false, $refund_id ); + } + + /** + * Partial refund notification. + * + * @param int $order_id Order ID. + * @param int $refund_id Refund ID. + */ + public function trigger_partial( $order_id, $refund_id = null ) { + $this->trigger( $order_id, true, $refund_id ); + } + + /** + * Trigger. + * + * @param int $order_id Order ID. + * @param bool $partial_refund Whether it is a partial refund or a full refund. + * @param int $refund_id Refund ID. + */ + public function trigger( $order_id, $partial_refund = false, $refund_id = null ) { + $this->setup_locale(); + $this->partial_refund = $partial_refund; + $this->id = $this->partial_refund ? 'customer_partially_refunded_order' : 'customer_refunded_order'; + + if ( $order_id ) { + $this->object = wc_get_order( $order_id ); + $this->recipient = $this->object->get_billing_email(); + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + } + + if ( ! empty( $refund_id ) ) { + $this->refund = wc_get_order( $refund_id ); + } else { + $this->refund = false; + } + + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); + } + + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'refund' => $this->refund, + 'partial_refund' => $this->partial_refund, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => false, + 'email' => $this, + ) + ); + } + + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'refund' => $this->refund, + 'partial_refund' => $this->partial_refund, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => false, + 'plain_text' => true, + 'email' => $this, + ) + ); + } + + /** + * Initialise settings form fields. + */ + public function init_form_fields() { + $this->form_fields = array( + 'enabled' => array( + 'title' => __( 'Enable/Disable', 'woocommerce' ), + 'type' => 'checkbox', + 'label' => __( 'Enable this email notification', 'woocommerce' ), + 'default' => 'yes', + ), + 'subject_full' => array( + 'title' => __( 'Full refund subject', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_subject(), + 'default' => '', + ), + 'subject_partial' => array( + 'title' => __( 'Partial refund subject', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_subject( true ), + 'default' => '', + ), + 'heading_full' => array( + 'title' => __( 'Full refund email heading', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_heading(), + 'default' => '', + ), + 'heading_partial' => array( + 'title' => __( 'Partial refund email heading', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_heading( true ), + 'default' => '', + ), + 'email_type' => array( + 'title' => __( 'Email type', 'woocommerce' ), + 'type' => 'select', + 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), + 'default' => 'html', + 'class' => 'email_type wc-enhanced-select', + 'options' => $this->get_email_type_options(), + 'desc_tip' => true, + ), + ); + } } -} endif; diff --git a/includes/emails/class-wc-email-customer-reset-password.php b/includes/emails/class-wc-email-customer-reset-password.php index d7812f60b52..9bc5d168e8e 100644 --- a/includes/emails/class-wc-email-customer-reset-password.php +++ b/includes/emails/class-wc-email-customer-reset-password.php @@ -1,147 +1,162 @@ id = 'customer_reset_password'; - $this->customer_email = true; + /** + * User email. + * + * @var string + */ + public $user_email; - $this->title = __( 'Reset password', 'woocommerce' ); - $this->description = __( 'Customer "reset password" emails are sent when customers reset their passwords.', 'woocommerce' ); + /** + * Reset key. + * + * @var string + */ + public $reset_key; - $this->template_html = 'emails/customer-reset-password.php'; - $this->template_plain = 'emails/plain/customer-reset-password.php'; + /** + * Constructor. + */ + public function __construct() { - // Trigger - add_action( 'woocommerce_reset_password_notification', array( $this, 'trigger' ), 10, 2 ); + $this->id = 'customer_reset_password'; + $this->customer_email = true; - // Call parent constructor - parent::__construct(); - } + $this->title = __( 'Reset password', 'woocommerce' ); + $this->description = __( 'Customer "reset password" emails are sent when customers reset their passwords.', 'woocommerce' ); - /** - * Get email subject. - * - * @since 3.1.0 - * @return string - */ - public function get_default_subject() { - return __( 'Password reset for {site_title}', 'woocommerce' ); - } + $this->template_html = 'emails/customer-reset-password.php'; + $this->template_plain = 'emails/plain/customer-reset-password.php'; - /** - * Get email heading. - * - * @since 3.1.0 - * @return string - */ - public function get_default_heading() { - return __( 'Password reset instructions', 'woocommerce' ); - } + // Trigger. + add_action( 'woocommerce_reset_password_notification', array( $this, 'trigger' ), 10, 2 ); - /** - * Trigger. - * - * @param string $user_login - * @param string $reset_key - */ - public function trigger( $user_login = '', $reset_key = '' ) { - if ( $user_login && $reset_key ) { - $this->object = get_user_by( 'login', $user_login ); - - $this->user_login = $user_login; - $this->reset_key = $reset_key; - $this->user_email = stripslashes( $this->object->user_email ); - $this->recipient = $this->user_email; + // Call parent constructor. + parent::__construct(); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( 'Password Reset Request for {site_title}', 'woocommerce' ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'Password Reset Request', 'woocommerce' ); + } - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'email_heading' => $this->get_heading(), - 'user_login' => $this->user_login, - 'reset_key' => $this->reset_key, - 'blogname' => $this->get_blogname(), - 'sent_to_admin' => false, - 'plain_text' => false, - 'email' => $this, - ) ); - } + /** + * Trigger. + * + * @param string $user_login User login. + * @param string $reset_key Password reset key. + */ + public function trigger( $user_login = '', $reset_key = '' ) { + $this->setup_locale(); - /** - * Get content plain. - * - * @access public - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'email_heading' => $this->get_heading(), - 'user_login' => $this->user_login, - 'reset_key' => $this->reset_key, - 'blogname' => $this->get_blogname(), - 'sent_to_admin' => false, - 'plain_text' => true, - 'email' => $this, - ) ); + if ( $user_login && $reset_key ) { + $this->object = get_user_by( 'login', $user_login ); + $this->user_id = $this->object->ID; + $this->user_login = $user_login; + $this->reset_key = $reset_key; + $this->user_email = stripslashes( $this->object->user_email ); + $this->recipient = $this->user_email; + } + + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); + } + + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'email_heading' => $this->get_heading(), + 'user_id' => $this->user_id, + 'user_login' => $this->user_login, + 'reset_key' => $this->reset_key, + 'blogname' => $this->get_blogname(), + 'sent_to_admin' => false, + 'plain_text' => false, + 'email' => $this, + ) + ); + } + + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'email_heading' => $this->get_heading(), + 'user_id' => $this->user_id, + 'user_login' => $this->user_login, + 'reset_key' => $this->reset_key, + 'blogname' => $this->get_blogname(), + 'sent_to_admin' => false, + 'plain_text' => true, + 'email' => $this, + ) + ); + } } -} endif; diff --git a/includes/emails/class-wc-email-failed-order.php b/includes/emails/class-wc-email-failed-order.php index 0b0ff5927e5..78e1eba780e 100644 --- a/includes/emails/class-wc-email-failed-order.php +++ b/includes/emails/class-wc-email-failed-order.php @@ -1,4 +1,9 @@ id = 'failed_order'; - $this->title = __( 'Failed order', 'woocommerce' ); - $this->description = __( 'Failed order emails are sent to chosen recipient(s) when orders have been marked failed (if they were previously processing or on-hold).', 'woocommerce' ); - $this->template_html = 'emails/admin-failed-order.php'; - $this->template_plain = 'emails/plain/admin-failed-order.php'; - - // Triggers for this email - add_action( 'woocommerce_order_status_pending_to_failed_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_on-hold_to_failed_notification', array( $this, 'trigger' ), 10, 2 ); - - // Call parent constructor - parent::__construct(); - - // Other settings - $this->recipient = $this->get_option( 'recipient', get_option( 'admin_email' ) ); - } - - /** - * Get email subject. + * Failed Order Email. * - * @since 3.1.0 - * @return string - */ - public function get_default_subject() { - return __( '[{site_title}] Failed order ({order_number})', 'woocommerce' ); - } - - /** - * Get email heading. + * An email sent to the admin when payment fails to go through. * - * @since 3.1.0 - * @return string + * @class WC_Email_Failed_Order + * @version 2.5.0 + * @package WooCommerce/Classes/Emails + * @extends WC_Email */ - public function get_default_heading() { - return __( 'Failed order', 'woocommerce' ); - } + class WC_Email_Failed_Order extends WC_Email { - /** - * Trigger the sending of this email. - * - * @param int $order_id The order ID. - * @param WC_Order $order Order object. - */ - public function trigger( $order_id, $order = false ) { - if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { - $order = wc_get_order( $order_id ); + /** + * Constructor. + */ + public function __construct() { + $this->id = 'failed_order'; + $this->title = __( 'Failed order', 'woocommerce' ); + $this->description = __( 'Failed order emails are sent to chosen recipient(s) when orders have been marked failed (if they were previously processing or on-hold).', 'woocommerce' ); + $this->template_html = 'emails/admin-failed-order.php'; + $this->template_plain = 'emails/plain/admin-failed-order.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', + ); + + // Triggers for this email. + add_action( 'woocommerce_order_status_pending_to_failed_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_on-hold_to_failed_notification', array( $this, 'trigger' ), 10, 2 ); + + // Call parent constructor. + parent::__construct(); + + // Other settings. + $this->recipient = $this->get_option( 'recipient', get_option( 'admin_email' ) ); } - if ( is_a( $order, 'WC_Order' ) ) { - $this->object = $order; - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( '[{site_title}]: Order #{order_number} has failed', 'woocommerce' ); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'Order Failed: #{order_number}', 'woocommerce' ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Trigger the sending of this email. + * + * @param int $order_id The order ID. + * @param WC_Order|false $order Order object. + */ + public function trigger( $order_id, $order = false ) { + $this->setup_locale(); - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => true, - 'plain_text' => false, - 'email' => $this, - ) ); - } + if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { + $order = wc_get_order( $order_id ); + } - /** - * Get content plain. - * - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => true, - 'plain_text' => true, - 'email' => $this, - ) ); - } + if ( is_a( $order, 'WC_Order' ) ) { + $this->object = $order; + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + } - /** - * Initialise settings form fields. - */ - public function init_form_fields() { - $this->form_fields = array( - 'enabled' => array( - 'title' => __( 'Enable/Disable', 'woocommerce' ), - 'type' => 'checkbox', - 'label' => __( 'Enable this email notification', 'woocommerce' ), - 'default' => 'yes', - ), - 'recipient' => array( - 'title' => __( 'Recipient(s)', 'woocommerce' ), - 'type' => 'text', - 'description' => sprintf( __( 'Enter recipients (comma separated) for this email. Defaults to %s.', 'woocommerce' ), '' . esc_attr( get_option( 'admin_email' ) ) . '' ), - 'placeholder' => '', - 'default' => '', - 'desc_tip' => true, - ), - 'subject' => array( - 'title' => __( 'Subject', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_subject(), - 'default' => '', - ), - 'heading' => array( - 'title' => __( 'Email heading', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_heading(), - 'default' => '', - ), - 'email_type' => array( - 'title' => __( 'Email type', 'woocommerce' ), - 'type' => 'select', - 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), - 'default' => 'html', - 'class' => 'email_type wc-enhanced-select', - 'options' => $this->get_email_type_options(), - 'desc_tip' => true, - ), - ); + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); + } + + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => true, + 'plain_text' => false, + 'email' => $this, + ) + ); + } + + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => true, + 'plain_text' => true, + 'email' => $this, + ) + ); + } + + /** + * Initialise settings form fields. + */ + public function init_form_fields() { + $this->form_fields = array( + 'enabled' => array( + 'title' => __( 'Enable/Disable', 'woocommerce' ), + 'type' => 'checkbox', + 'label' => __( 'Enable this email notification', 'woocommerce' ), + 'default' => 'yes', + ), + 'recipient' => array( + 'title' => __( 'Recipient(s)', 'woocommerce' ), + 'type' => 'text', + /* translators: %s: WP admin email */ + 'description' => sprintf( __( 'Enter recipients (comma separated) for this email. Defaults to %s.', 'woocommerce' ), '' . esc_attr( get_option( 'admin_email' ) ) . '' ), + 'placeholder' => '', + 'default' => '', + 'desc_tip' => true, + ), + 'subject' => array( + 'title' => __( 'Subject', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_subject(), + 'default' => '', + ), + 'heading' => array( + 'title' => __( 'Email heading', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_heading(), + 'default' => '', + ), + 'email_type' => array( + 'title' => __( 'Email type', 'woocommerce' ), + 'type' => 'select', + 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), + 'default' => 'html', + 'class' => 'email_type wc-enhanced-select', + 'options' => $this->get_email_type_options(), + 'desc_tip' => true, + ), + ); + } } -} endif; diff --git a/includes/emails/class-wc-email-new-order.php b/includes/emails/class-wc-email-new-order.php index 911c3f4e7a6..952e8030928 100644 --- a/includes/emails/class-wc-email-new-order.php +++ b/includes/emails/class-wc-email-new-order.php @@ -1,4 +1,9 @@ id = 'new_order'; - $this->title = __( 'New order', 'woocommerce' ); - $this->description = __( 'New order emails are sent to chosen recipient(s) when a new order is received.', 'woocommerce' ); - $this->template_html = 'emails/admin-new-order.php'; - $this->template_plain = 'emails/plain/admin-new-order.php'; - - // Triggers for this email - add_action( 'woocommerce_order_status_pending_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_pending_to_completed_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_pending_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_failed_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_failed_to_completed_notification', array( $this, 'trigger' ), 10, 2 ); - add_action( 'woocommerce_order_status_failed_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); - - // Call parent constructor - parent::__construct(); - - // Other settings - $this->recipient = $this->get_option( 'recipient', get_option( 'admin_email' ) ); - } - - /** - * Get email subject. + * New Order Email. * - * @since 3.1.0 - * @return string - */ - public function get_default_subject() { - return __( '[{site_title}] New customer order ({order_number}) - {order_date}', 'woocommerce' ); - } - - /** - * Get email heading. + * An email sent to the admin when a new order is received/paid for. * - * @since 3.1.0 - * @return string + * @class WC_Email_New_Order + * @version 2.0.0 + * @package WooCommerce/Classes/Emails + * @extends WC_Email */ - public function get_default_heading() { - return __( 'New customer order', 'woocommerce' ); - } + class WC_Email_New_Order extends WC_Email { - /** - * Trigger the sending of this email. - * - * @param int $order_id The order ID. - * @param WC_Order $order Order object. - */ - public function trigger( $order_id, $order = false ) { - if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { - $order = wc_get_order( $order_id ); + /** + * Constructor. + */ + public function __construct() { + $this->id = 'new_order'; + $this->title = __( 'New order', 'woocommerce' ); + $this->description = __( 'New order emails are sent to chosen recipient(s) when a new order is received.', 'woocommerce' ); + $this->template_html = 'emails/admin-new-order.php'; + $this->template_plain = 'emails/plain/admin-new-order.php'; + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + '{order_date}' => '', + '{order_number}' => '', + ); + + // Triggers for this email. + add_action( 'woocommerce_order_status_pending_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_pending_to_completed_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_pending_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_failed_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_failed_to_completed_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_failed_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_cancelled_to_processing_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_cancelled_to_completed_notification', array( $this, 'trigger' ), 10, 2 ); + add_action( 'woocommerce_order_status_cancelled_to_on-hold_notification', array( $this, 'trigger' ), 10, 2 ); + + // Call parent constructor. + parent::__construct(); + + // Other settings. + $this->recipient = $this->get_option( 'recipient', get_option( 'admin_email' ) ); } - if ( is_a( $order, 'WC_Order' ) ) { - $this->object = $order; - $this->find['order-date'] = '{order_date}'; - $this->find['order-number'] = '{order_number}'; - $this->replace['order-date'] = wc_format_datetime( $this->object->get_date_created() ); - $this->replace['order-number'] = $this->object->get_order_number(); + /** + * Get email subject. + * + * @since 3.1.0 + * @return string + */ + public function get_default_subject() { + return __( '[{site_title}]: New order #{order_number}', 'woocommerce' ); } - if ( ! $this->is_enabled() || ! $this->get_recipient() ) { - return; + /** + * Get email heading. + * + * @since 3.1.0 + * @return string + */ + public function get_default_heading() { + return __( 'New Order: #{order_number}', 'woocommerce' ); } - $this->setup_locale(); - $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); - $this->restore_locale(); - } + /** + * Trigger the sending of this email. + * + * @param int $order_id The order ID. + * @param WC_Order|false $order Order object. + */ + public function trigger( $order_id, $order = false ) { + $this->setup_locale(); - /** - * Get content html. - * - * @access public - * @return string - */ - public function get_content_html() { - return wc_get_template_html( $this->template_html, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => true, - 'plain_text' => false, - 'email' => $this, - ) ); - } + if ( $order_id && ! is_a( $order, 'WC_Order' ) ) { + $order = wc_get_order( $order_id ); + } - /** - * Get content plain. - * - * @access public - * @return string - */ - public function get_content_plain() { - return wc_get_template_html( $this->template_plain, array( - 'order' => $this->object, - 'email_heading' => $this->get_heading(), - 'sent_to_admin' => true, - 'plain_text' => true, - 'email' => $this, - ) ); - } + if ( is_a( $order, 'WC_Order' ) ) { + $this->object = $order; + $this->placeholders['{order_date}'] = wc_format_datetime( $this->object->get_date_created() ); + $this->placeholders['{order_number}'] = $this->object->get_order_number(); + } - /** - * Initialise settings form fields. - */ - public function init_form_fields() { - $this->form_fields = array( - 'enabled' => array( - 'title' => __( 'Enable/Disable', 'woocommerce' ), - 'type' => 'checkbox', - 'label' => __( 'Enable this email notification', 'woocommerce' ), - 'default' => 'yes', - ), - 'recipient' => array( - 'title' => __( 'Recipient(s)', 'woocommerce' ), - 'type' => 'text', - 'description' => sprintf( __( 'Enter recipients (comma separated) for this email. Defaults to %s.', 'woocommerce' ), '' . esc_attr( get_option( 'admin_email' ) ) . '' ), - 'placeholder' => '', - 'default' => '', - 'desc_tip' => true, - ), - 'subject' => array( - 'title' => __( 'Subject', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_subject(), - 'default' => '', - ), - 'heading' => array( - 'title' => __( 'Email heading', 'woocommerce' ), - 'type' => 'text', - 'desc_tip' => true, - /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), - 'placeholder' => $this->get_default_heading(), - 'default' => '', - ), - 'email_type' => array( - 'title' => __( 'Email type', 'woocommerce' ), - 'type' => 'select', - 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), - 'default' => 'html', - 'class' => 'email_type wc-enhanced-select', - 'options' => $this->get_email_type_options(), - 'desc_tip' => true, - ), - ); + if ( $this->is_enabled() && $this->get_recipient() ) { + $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() ); + } + + $this->restore_locale(); + } + + /** + * Get content html. + * + * @return string + */ + public function get_content_html() { + return wc_get_template_html( + $this->template_html, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => true, + 'plain_text' => false, + 'email' => $this, + ) + ); + } + + /** + * Get content plain. + * + * @return string + */ + public function get_content_plain() { + return wc_get_template_html( + $this->template_plain, array( + 'order' => $this->object, + 'email_heading' => $this->get_heading(), + 'sent_to_admin' => true, + 'plain_text' => true, + 'email' => $this, + ) + ); + } + + /** + * Initialise settings form fields. + */ + public function init_form_fields() { + $this->form_fields = array( + 'enabled' => array( + 'title' => __( 'Enable/Disable', 'woocommerce' ), + 'type' => 'checkbox', + 'label' => __( 'Enable this email notification', 'woocommerce' ), + 'default' => 'yes', + ), + 'recipient' => array( + 'title' => __( 'Recipient(s)', 'woocommerce' ), + 'type' => 'text', + /* translators: %s: WP admin email */ + 'description' => sprintf( __( 'Enter recipients (comma separated) for this email. Defaults to %s.', 'woocommerce' ), '' . esc_attr( get_option( 'admin_email' ) ) . '' ), + 'placeholder' => '', + 'default' => '', + 'desc_tip' => true, + ), + 'subject' => array( + 'title' => __( 'Subject', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_subject(), + 'default' => '', + ), + 'heading' => array( + 'title' => __( 'Email heading', 'woocommerce' ), + 'type' => 'text', + 'desc_tip' => true, + /* translators: %s: list of placeholders */ + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}, {order_date}, {order_number}' ), + 'placeholder' => $this->get_default_heading(), + 'default' => '', + ), + 'email_type' => array( + 'title' => __( 'Email type', 'woocommerce' ), + 'type' => 'select', + 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), + 'default' => 'html', + 'class' => 'email_type wc-enhanced-select', + 'options' => $this->get_email_type_options(), + 'desc_tip' => true, + ), + ); + } } -} endif; diff --git a/includes/emails/class-wc-email.php b/includes/emails/class-wc-email.php index 9de23a39779..ea6588f5a56 100644 --- a/includes/emails/class-wc-email.php +++ b/includes/emails/class-wc-email.php @@ -1,4 +1,9 @@ ', // Greater-than - '<', // Less-than - '&', // Ampersand - '&', // Ampersand - '&', // Ampersand - '(c)', // Copyright - '(tm)', // Trademark - '(R)', // Registered - '--', // mdash - '-', // ndash - '*', // Bullet - '£', // Pound sign - 'EUR', // Euro sign. € ? - '$', // Dollar sign - '', // Unknown/unhandled entities - ' ', // Runs of spaces, post-handling + '', // Non-legal carriage return. + ' ', // Non-breaking space. + '"', // Double quotes. + "'", // Single quotes. + '>', // Greater-than. + '<', // Less-than. + '&', // Ampersand. + '&', // Ampersand. + '(c)', // Copyright. + '(tm)', // Trademark. + '(R)', // Registered. + '--', // mdash. + '-', // ndash. + '*', // Bullet. + '£', // Pound sign. + 'EUR', // Euro sign. € ?. + '$', // Dollar sign. + '', // Unknown/unhandled entities. + ' ', // Runs of spaces, post-handling. ); + /** + * Strings to find/replace in subjects/headings. + * + * @var array + */ + protected $placeholders = array(); + + /** + * Strings to find in subjects/headings. + * + * @deprecated 3.2.0 in favour of placeholders + * @var array + */ + public $find = array(); + + /** + * Strings to replace in subjects/headings. + * + * @deprecated 3.2.0 in favour of placeholders + * @var array + */ + public $replace = array(); + /** * Constructor. */ public function __construct() { - // Init settings + // Find/replace. + if ( empty( $this->placeholders ) ) { + $this->placeholders = array( + '{site_title}' => $this->get_blogname(), + ); + } + + // Init settings. $this->init_form_fields(); $this->init_settings(); - // Save settings hook - add_action( 'woocommerce_update_options_email_' . $this->id, array( $this, 'process_admin_options' ) ); - - // Default template base if not declared in child constructor + // Default template base if not declared in child constructor. if ( is_null( $this->template_base ) ) { $this->template_base = WC()->plugin_path() . '/templates/'; } - // Settings $this->email_type = $this->get_option( 'email_type' ); $this->enabled = $this->get_option( 'enabled' ); - // Find/replace - $this->find['blogname'] = '{blogname}'; - $this->find['site-title'] = '{site_title}'; - $this->replace['blogname'] = $this->get_blogname(); - $this->replace['site-title'] = $this->get_blogname(); - - // For multipart messages add_action( 'phpmailer_init', array( $this, 'handle_multipart' ) ); + add_action( 'woocommerce_update_options_email_' . $this->id, array( $this, 'process_admin_options' ) ); } /** * Handle multipart mail. * - * @param PHPMailer $mailer + * @param PHPMailer $mailer PHPMailer object. * @return PHPMailer */ public function handle_multipart( $mailer ) { if ( $this->sending && 'multipart' === $this->get_email_type() ) { - $mailer->AltBody = wordwrap( preg_replace( $this->plain_search, $this->plain_replace, strip_tags( $this->get_content_plain() ) ) ); + $mailer->AltBody = wordwrap( // phpcs:ignore WordPress.NamingConventions.ValidVariableName.NotSnakeCaseMemberVar + preg_replace( $this->plain_search, $this->plain_replace, strip_tags( $this->get_content_plain() ) ) + ); $this->sending = false; } return $mailer; @@ -242,18 +270,48 @@ class WC_Email extends WC_Settings_API { /** * Format email string. * - * @param mixed $string + * @param mixed $string Text to replace placeholders in. * @return string */ public function format_string( $string ) { - return str_replace( apply_filters( 'woocommerce_email_format_string_find', $this->find, $this ), apply_filters( 'woocommerce_email_format_string_replace', $this->replace, $this ), $string ); + $find = array_keys( $this->placeholders ); + $replace = array_values( $this->placeholders ); + + // If using legacy find replace, add those to our find/replace arrays first. @todo deprecate in 4.0.0. + $find = array_merge( (array) $this->find, $find ); + $replace = array_merge( (array) $this->replace, $replace ); + + // Take care of blogname which is no longer defined as a valid placeholder. + $find[] = '{blogname}'; + $replace[] = $this->get_blogname(); + + // If using the older style filters for find and replace, ensure the array is associative and then pass through filters. @todo deprecate in 4.0.0. + if ( has_filter( 'woocommerce_email_format_string_replace' ) || has_filter( 'woocommerce_email_format_string_find' ) ) { + $legacy_find = $this->find; + $legacy_replace = $this->replace; + + foreach ( $this->placeholders as $find => $replace ) { + $legacy_key = sanitize_title( str_replace( '_', '-', trim( $find, '{}' ) ) ); + $legacy_find[ $legacy_key ] = $find; + $legacy_replace[ $legacy_key ] = $replace; + } + + $string = str_replace( apply_filters( 'woocommerce_email_format_string_find', $legacy_find, $this ), apply_filters( 'woocommerce_email_format_string_replace', $legacy_replace, $this ), $string ); + } + + /** + * Filter for main find/replace. + * + * @since 3.2.0 + */ + return apply_filters( 'woocommerce_email_format_string', str_replace( $find, $replace, $string ), $this ); } /** * Set the locale to the store locale for customer emails to make sure emails are in the store language. */ public function setup_locale() { - if ( $this->is_customer_email() ) { + if ( $this->is_customer_email() && apply_filters( 'woocommerce_email_setup_locale', true ) ) { wc_switch_to_site_locale(); } } @@ -262,7 +320,7 @@ class WC_Email extends WC_Settings_API { * Restore the locale to the default locale. Use after finished with setup_locale. */ public function restore_locale() { - if ( $this->is_customer_email() ) { + if ( $this->is_customer_email() && apply_filters( 'woocommerce_email_restore_locale', true ) ) { wc_restore_locale(); } } @@ -307,6 +365,7 @@ class WC_Email extends WC_Settings_API { /** * Get valid recipients. + * * @return string */ public function get_recipient() { @@ -322,7 +381,7 @@ class WC_Email extends WC_Settings_API { * @return string */ public function get_headers() { - $header = "Content-Type: " . $this->get_content_type() . "\r\n"; + $header = 'Content-Type: ' . $this->get_content_type() . "\r\n"; if ( 'new_order' === $this->id && $this->object && $this->object->get_billing_email() && ( $this->object->get_billing_first_name() || $this->object->get_billing_last_name() ) ) { $header .= 'Reply-to: ' . $this->object->get_billing_first_name() . ' ' . $this->object->get_billing_last_name() . ' <' . $this->object->get_billing_email() . ">\r\n"; @@ -334,14 +393,14 @@ class WC_Email extends WC_Settings_API { /** * Get email attachments. * - * @return string + * @return array */ public function get_attachments() { return apply_filters( 'woocommerce_email_attachments', array(), $this->id, $this->object ); } /** - * get_type function. + * Return email type. * * @return string */ @@ -356,17 +415,18 @@ class WC_Email extends WC_Settings_API { */ public function get_content_type() { switch ( $this->get_email_type() ) { - case 'html' : + case 'html': return 'text/html'; - case 'multipart' : + case 'multipart': return 'multipart/alternative'; - default : + default: return 'text/plain'; } } /** * Return the email's title + * * @return string */ public function get_title() { @@ -375,6 +435,7 @@ class WC_Email extends WC_Settings_API { /** * Return the email's description + * * @return string */ public function get_description() { @@ -384,8 +445,8 @@ class WC_Email extends WC_Settings_API { /** * Proxy to parent's get_option and attempt to localize the result using gettext. * - * @param string $key - * @param mixed $empty_value + * @param string $key Option key. + * @param mixed $empty_value Value to use when option is empty. * @return string */ public function get_option( $key, $empty_value = null ) { @@ -395,6 +456,7 @@ class WC_Email extends WC_Settings_API { /** * Checks if this email is enabled and will be sent. + * * @return bool */ public function is_enabled() { @@ -403,6 +465,7 @@ class WC_Email extends WC_Settings_API { /** * Checks if this email is manually sent + * * @return bool */ public function is_manual() { @@ -411,6 +474,7 @@ class WC_Email extends WC_Settings_API { /** * Checks if this email is customer focussed. + * * @return bool */ public function is_customer_email() { @@ -435,53 +499,75 @@ class WC_Email extends WC_Settings_API { $this->sending = true; if ( 'plain' === $this->get_email_type() ) { - $email_content = preg_replace( $this->plain_search, $this->plain_replace, strip_tags( $this->get_content_plain() ) ); + $email_content = wordwrap( preg_replace( $this->plain_search, $this->plain_replace, strip_tags( $this->get_content_plain() ) ), 70 ); } else { $email_content = $this->get_content_html(); } - return wordwrap( $email_content, 70 ); + return $email_content; } /** * Apply inline styles to dynamic content. * - * @param string|null $content + * We only inline CSS for html emails, and to do so we use Emogrifier library (if supported). + * + * @param string|null $content Content that will receive inline styles. * @return string */ public function style_inline( $content ) { - // make sure we only inline CSS for html emails - if ( in_array( $this->get_content_type(), array( 'text/html', 'multipart/alternative' ) ) && class_exists( 'DOMDocument' ) ) { + if ( in_array( $this->get_content_type(), array( 'text/html', 'multipart/alternative' ), true ) ) { ob_start(); wc_get_template( 'emails/email-styles.php' ); $css = apply_filters( 'woocommerce_email_styles', ob_get_clean() ); - // apply CSS styles inline for picky email clients - try { - $emogrifier = new Emogrifier( $content, $css ); - $content = $emogrifier->emogrify(); - } catch ( Exception $e ) { - $logger = wc_get_logger(); - $logger->error( $e->getMessage(), array( 'source' => 'emogrifier' ) ); + if ( $this->supports_emogrifier() ) { + if ( ! class_exists( 'Emogrifier' ) ) { + include_once dirname( dirname( __FILE__ ) ) . '/libraries/class-emogrifier.php'; + } + try { + $emogrifier = new Emogrifier( $content, $css ); + $content = $emogrifier->emogrify(); + } catch ( Exception $e ) { + $logger = wc_get_logger(); + $logger->error( $e->getMessage(), array( 'source' => 'emogrifier' ) ); + } + } else { + $content = '' . $content; } } return $content; } + /** + * Return if emogrifier library is supported. + * + * @since 3.5.0 + * @return bool + */ + protected function supports_emogrifier() { + return class_exists( 'DOMDocument' ) && version_compare( PHP_VERSION, '5.5', '>=' ); + } + /** * Get the email content in plain text format. + * * @return string */ - public function get_content_plain() { return ''; } + public function get_content_plain() { + return ''; } /** * Get the email content in HTML format. + * * @return string */ - public function get_content_html() { return ''; } + public function get_content_html() { + return ''; } /** * Get the from name for outgoing emails. + * * @return string */ public function get_from_name() { @@ -491,6 +577,7 @@ class WC_Email extends WC_Settings_API { /** * Get the from address for outgoing emails. + * * @return string */ public function get_from_address() { @@ -500,11 +587,12 @@ class WC_Email extends WC_Settings_API { /** * Send an email. - * @param string $to - * @param string $subject - * @param string $message - * @param string $headers - * @param string $attachments + * + * @param string $to Email to. + * @param string $subject Email subject. + * @param string $message Email message. + * @param string $headers Email headers. + * @param array $attachments Email attachments. * @return bool success */ public function send( $to, $subject, $message, $headers, $attachments ) { @@ -526,32 +614,32 @@ class WC_Email extends WC_Settings_API { * Initialise Settings Form Fields - these are generic email options most will use. */ public function init_form_fields() { - $this->form_fields = array( - 'enabled' => array( - 'title' => __( 'Enable/Disable', 'woocommerce' ), - 'type' => 'checkbox', - 'label' => __( 'Enable this email notification', 'woocommerce' ), - 'default' => 'yes', + $this->form_fields = array( + 'enabled' => array( + 'title' => __( 'Enable/Disable', 'woocommerce' ), + 'type' => 'checkbox', + 'label' => __( 'Enable this email notification', 'woocommerce' ), + 'default' => 'yes', ), - 'subject' => array( + 'subject' => array( 'title' => __( 'Subject', 'woocommerce' ), 'type' => 'text', - 'desc_tip' => true, + 'desc_tip' => true, /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}' ), + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '' . implode( ', ', array_keys( $this->placeholders ) ) . '' ), 'placeholder' => $this->get_default_subject(), 'default' => '', ), - 'heading' => array( + 'heading' => array( 'title' => __( 'Email heading', 'woocommerce' ), 'type' => 'text', - 'desc_tip' => true, + 'desc_tip' => true, /* translators: %s: list of placeholders */ - 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}' ), + 'description' => sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '' . implode( ', ', array_keys( $this->placeholders ) ) . '' ), 'placeholder' => $this->get_default_heading(), 'default' => '', ), - 'email_type' => array( + 'email_type' => array( 'title' => __( 'Email type', 'woocommerce' ), 'type' => 'select', 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), @@ -565,6 +653,7 @@ class WC_Email extends WC_Settings_API { /** * Email type options. + * * @return array */ public function get_email_type_options() { @@ -582,12 +671,12 @@ class WC_Email extends WC_Settings_API { * Admin Panel Options Processing. */ public function process_admin_options() { - // Save regular options + // Save regular options. parent::process_admin_options(); $post_data = $this->get_post_data(); - // Save templates + // Save templates. if ( isset( $post_data['template_html_code'] ) ) { $this->save_template( $post_data['template_html_code'], $this->template_html ); } @@ -599,7 +688,7 @@ class WC_Email extends WC_Settings_API { /** * Get template. * - * @param string $type + * @param string $type Template type. Can be either 'template_html' or 'template_plain'. * @return string */ public function get_template( $type ) { @@ -617,16 +706,16 @@ class WC_Email extends WC_Settings_API { * Save the email templates. * * @since 2.4.0 - * @param string $template_code - * @param string $template_path + * @param string $template_code Template code. + * @param string $template_path Template path. */ protected function save_template( $template_code, $template_path ) { if ( current_user_can( 'edit_themes' ) && ! empty( $template_code ) && ! empty( $template_path ) ) { - $saved = false; - $file = get_stylesheet_directory() . '/woocommerce/' . $template_path; - $code = wp_unslash( $template_code ); + $saved = false; + $file = get_stylesheet_directory() . '/' . WC()->template_path() . $template_path; + $code = wp_unslash( $template_code ); - if ( is_writeable( $file ) ) { + if ( is_writeable( $file ) ) { // phpcs:ignore WordPress.VIP.FileSystemWritesDisallow.file_ops_is_writeable $f = fopen( $file, 'w+' ); if ( false !== $f ) { @@ -647,7 +736,7 @@ class WC_Email extends WC_Settings_API { /** * Get the template file in the current theme. * - * @param string $template + * @param string $template Template name. * * @return string */ @@ -658,33 +747,35 @@ class WC_Email extends WC_Settings_API { /** * Move template action. * - * @param string $template_type + * @param string $template_type Template type. */ protected function move_template_action( $template_type ) { - if ( $template = $this->get_template( $template_type ) ) { - if ( ! empty( $template ) ) { + $template = $this->get_template( $template_type ); + if ( ! empty( $template ) ) { + $theme_file = $this->get_theme_template_file( $template ); - $theme_file = $this->get_theme_template_file( $template ); + if ( wp_mkdir_p( dirname( $theme_file ) ) && ! file_exists( $theme_file ) ) { - if ( wp_mkdir_p( dirname( $theme_file ) ) && ! file_exists( $theme_file ) ) { + // Locate template file. + $core_file = $this->template_base . $template; + $template_file = apply_filters( 'woocommerce_locate_core_template', $core_file, $template, $this->template_base, $this->id ); - // Locate template file - $core_file = $this->template_base . $template; - $template_file = apply_filters( 'woocommerce_locate_core_template', $core_file, $template, $this->template_base, $this->id ); + // Copy template file. + copy( $template_file, $theme_file ); - // Copy template file - copy( $template_file, $theme_file ); + /** + * Action hook fired after copying email template file. + * + * @param string $template_type The copied template type + * @param string $email The email object + */ + do_action( 'woocommerce_copy_email_template', $template_type, $this ); - /** - * woocommerce_copy_email_template action hook. - * - * @param string $template_type The copied template type - * @param string $email The email object - */ - do_action( 'woocommerce_copy_email_template', $template_type, $this ); - - echo '

          ' . __( 'Template file copied to theme.', 'woocommerce' ) . '

          '; - } + ?> +
          +

          +
          + get_template( $template_type ) ) { + $template = $this->get_template( $template_type ); + if ( $template ) { if ( ! empty( $template ) ) { - $theme_file = $this->get_theme_template_file( $template ); if ( file_exists( $theme_file ) ) { - unlink( $theme_file ); + unlink( $theme_file ); // phpcs:ignore WordPress.VIP.FileSystemWritesDisallow.file_ops_unlink /** - * woocommerce_delete_email_template action hook. + * Action hook fired after deleting template file. * * @param string $template The deleted template type * @param string $email The email object */ do_action( 'woocommerce_delete_email_template', $template_type, $this ); - - echo '

          ' . __( 'Template file deleted from theme.', 'woocommerce' ) . '

          '; + ?> +
          +

          +
          + template_html ) || ! empty( $this->template_plain ) ) && ( ! empty( $_GET['move_template'] ) || ! empty( $_GET['delete_template'] ) ) - && 'GET' === $_SERVER['REQUEST_METHOD'] + && 'GET' === $_SERVER['REQUEST_METHOD'] // phpcs:ignore WordPress.VIP.ValidatedSanitizedInput.InputNotValidated ) { - if ( empty( $_GET['_wc_email_nonce'] ) || ! wp_verify_nonce( $_GET['_wc_email_nonce'], 'woocommerce_email_template_nonce' ) ) { - wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); + if ( empty( $_GET['_wc_email_nonce'] ) || ! wp_verify_nonce( wc_clean( wp_unslash( $_GET['_wc_email_nonce'] ) ), 'woocommerce_email_template_nonce' ) ) { + wp_die( esc_html__( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); } if ( ! current_user_can( 'edit_themes' ) ) { - wp_die( __( 'Cheatin’ huh?', 'woocommerce' ) ); + wp_die( esc_html__( 'You don’t have permission to do this.', 'woocommerce' ) ); } if ( ! empty( $_GET['move_template'] ) ) { - $this->move_template_action( $_GET['move_template'] ); + $this->move_template_action( wc_clean( wp_unslash( $_GET['move_template'] ) ) ); } if ( ! empty( $_GET['delete_template'] ) ) { - $this->delete_template_action( $_GET['delete_template'] ); + $this->delete_template_action( wc_clean( wp_unslash( $_GET['delete_template'] ) ) ); } } } @@ -760,14 +854,15 @@ class WC_Email extends WC_Settings_API { ?>

          get_title() ); ?>

          - get_description() ) ); ?> + get_description() ) ); // phpcs:ignore WordPress.XSS.EscapeOutput.OutputNotEscaped ?> @@ -775,16 +870,20 @@ class WC_Email extends WC_Settings_API {
          - template_html ) || ! empty( $this->template_plain ) ) ) { ?> + template_html ) || ! empty( $this->template_plain ) ) ) { + ?>
          - __( 'HTML template', 'woocommerce' ), 'template_plain' => __( 'Plain text template', 'woocommerce' ), @@ -802,56 +901,77 @@ class WC_Email extends WC_Settings_API { $template_file = apply_filters( 'woocommerce_locate_core_template', $core_file, $template, $this->template_base, $this->id ); $template_dir = apply_filters( 'woocommerce_template_directory', 'woocommerce', $template ); ?> -
          - +

          - - +

          - - + + + + - ' . trailingslashit( basename( get_stylesheet_directory() ) ) . $template_dir . '/' . $template . '' ); ?> + ' . esc_html( trailingslashit( basename( get_stylesheet_directory() ) ) . $template_dir . '/' . $template ) . '' ); + ?>

          - - - +

          - - - + ' . plugin_basename( $template_file ) . '', '' . trailingslashit( basename( get_stylesheet_directory() ) ) . $template_dir . '/' . $template . '' ); ?> + if ( is_dir( $emails_dir ) ) { + $target_dir = $emails_dir; + } elseif ( is_dir( $templates_dir ) ) { + $target_dir = $templates_dir; + } else { + $target_dir = $theme_dir; + } + + if ( is_writable( $target_dir ) ) : // phpcs:ignore WordPress.VIP.FileSystemWritesDisallow.file_ops_is_writable + ?> + + + + + + ' . esc_html( plugin_basename( $template_file ) ) . '', '' . esc_html( trailingslashit( basename( get_stylesheet_directory() ) ) . $template_dir . '/' . $template ) . '' ); + ?>

          - - - -

          - - - + +

          +
          - +
          + file = trailingslashit( $upload_dir['basedir'] ) . $this->get_filename(); $this->column_names = $this->get_default_column_names(); } + /** + * Get file path to export to. + * + * @return string + */ + protected function get_file_path() { + $upload_dir = wp_upload_dir(); + return trailingslashit( $upload_dir['basedir'] ) . $this->get_filename(); + } + /** * Get the file contents. * @@ -56,11 +56,11 @@ abstract class WC_CSV_Batch_Exporter extends WC_CSV_Exporter { */ public function get_file() { $file = ''; - if ( @file_exists( $this->file ) ) { - $file = @file_get_contents( $this->file ); + if ( @file_exists( $this->get_file_path() ) ) { // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged + $file = @file_get_contents( $this->get_file_path() ); // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged, WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents, WordPress.WP.AlternativeFunctions.file_system_read_file_get_contents } else { - @file_put_contents( $this->file, '' ); - @chmod( $this->file, 0664 ); + @file_put_contents( $this->get_file_path(), '' ); // phpcs:ignore WordPress.VIP.FileSystemWritesDisallow.file_ops_file_put_contents, Generic.PHP.NoSilencedErrors.Discouraged, WordPress.WP.AlternativeFunctions.file_system_read_file_put_contents + @chmod( $this->get_file_path(), 0664 ); // phpcs:ignore WordPress.VIP.FileSystemWritesDisallow.chmod_chmod, WordPress.WP.AlternativeFunctions.file_system_read_file_put_contents, Generic.PHP.NoSilencedErrors.Discouraged } return $file; } @@ -73,7 +73,7 @@ abstract class WC_CSV_Batch_Exporter extends WC_CSV_Exporter { public function export() { $this->send_headers(); $this->send_content( $this->get_file() ); - @unlink( $this->file ); + @unlink( $this->get_file_path() ); // phpcs:ignore WordPress.VIP.FileSystemWritesDisallow.file_ops_unlink, Generic.PHP.NoSilencedErrors.Discouraged die(); } @@ -84,7 +84,7 @@ abstract class WC_CSV_Batch_Exporter extends WC_CSV_Exporter { */ public function generate_file() { if ( 1 === $this->get_page() ) { - @unlink( $this->file ); + @unlink( $this->get_file_path() ); // phpcs:ignore WordPress.VIP.FileSystemWritesDisallow.file_ops_unlink, Generic.PHP.NoSilencedErrors.Discouraged, } $this->prepare_data_to_export(); $this->write_csv_data( $this->get_csv_data() ); @@ -94,7 +94,7 @@ abstract class WC_CSV_Batch_Exporter extends WC_CSV_Exporter { * Write data to the file. * * @since 3.1.0 - * @param string $data + * @param string $data Data. */ protected function write_csv_data( $data ) { $file = $this->get_file(); @@ -105,7 +105,7 @@ abstract class WC_CSV_Batch_Exporter extends WC_CSV_Exporter { } $file .= $data; - @file_put_contents( $this->file, $file ); + @file_put_contents( $this->get_file_path(), $file ); // phpcs:ignore WordPress.VIP.FileSystemWritesDisallow.file_ops_file_put_contents, Generic.PHP.NoSilencedErrors.Discouraged, WordPress.WP.AlternativeFunctions.file_system_read_file_put_contents } /** @@ -122,7 +122,7 @@ abstract class WC_CSV_Batch_Exporter extends WC_CSV_Exporter { * Set page. * * @since 3.1.0 - * @param int $page + * @param int $page Page Nr. */ public function set_page( $page ) { $this->page = absint( $page ); @@ -135,7 +135,7 @@ abstract class WC_CSV_Batch_Exporter extends WC_CSV_Exporter { * @return int */ public function get_total_exported() { - return ( $this->get_page() * $this->get_limit() ) + $this->exported_row_count; + return ( ( $this->get_page() - 1 ) * $this->get_limit() ) + $this->exported_row_count; } /** diff --git a/includes/export/abstract-wc-csv-exporter.php b/includes/export/abstract-wc-csv-exporter.php index 5437224c329..4b867b3daa1 100644 --- a/includes/export/abstract-wc-csv-exporter.php +++ b/includes/export/abstract-wc-csv-exporter.php @@ -2,11 +2,10 @@ /** * Handles CSV export. * - * @author Automattic - * @category Admin * @package WooCommerce/Export * @version 3.1.0 */ + if ( ! defined( 'ABSPATH' ) ) { exit; } @@ -18,42 +17,56 @@ abstract class WC_CSV_Exporter { /** * Type of export used in filter names. + * * @var string */ protected $export_type = ''; + /** + * Filename to export to. + * + * @var string + */ + protected $filename = 'wc-export.csv'; + /** * Batch limit. + * * @var integer */ protected $limit = 50; /** * Number exported. + * * @var integer */ protected $exported_row_count = 0; /** * Raw data to export. + * * @var array */ protected $row_data = array(); /** * Total rows to export. + * * @var integer */ protected $total_rows = 0; /** * Columns ids and names. + * * @var array */ protected $column_names = array(); /** * List of columns to export, or empty for all. + * * @var array */ protected $columns_to_export = array(); @@ -61,7 +74,7 @@ abstract class WC_CSV_Exporter { /** * Prepare data that will be exported. */ - abstract function prepare_data_to_export(); + abstract public function prepare_data_to_export(); /** * Return an array of supported column names and ids. @@ -77,7 +90,7 @@ abstract class WC_CSV_Exporter { * Set column names. * * @since 3.1.0 - * @param array $column_names + * @param array $column_names Column names array. */ public function set_column_names( $column_names ) { $this->column_names = array(); @@ -101,7 +114,7 @@ abstract class WC_CSV_Exporter { * Set columns to export. * * @since 3.1.0 - * @param array $column_names + * @param array $columns Columns array. */ public function set_columns_to_export( $columns ) { $this->columns_to_export = array_map( 'wc_clean', $columns ); @@ -111,7 +124,7 @@ abstract class WC_CSV_Exporter { * See if a column is to be exported or not. * * @since 3.1.0 - * @param string $column_id + * @param string $column_id ID of the column being exported. * @return boolean */ public function is_column_exporting( $column_id ) { @@ -122,7 +135,7 @@ abstract class WC_CSV_Exporter { return true; } - if ( in_array( $column_id, $columns_to_export ) || 'meta' === $column_id ) { + if ( in_array( $column_id, $columns_to_export, true ) || 'meta' === $column_id ) { return true; } @@ -158,39 +171,49 @@ abstract class WC_CSV_Exporter { */ public function send_headers() { if ( function_exists( 'gc_enable' ) ) { - gc_enable(); + gc_enable(); // phpcs:ignore PHPCompatibility.PHP.NewFunctions.gc_enableFound } if ( function_exists( 'apache_setenv' ) ) { - @apache_setenv( 'no-gzip', 1 ); + @apache_setenv( 'no-gzip', 1 ); // @codingStandardsIgnoreLine } - @ini_set( 'zlib.output_compression', 'Off' ); - @ini_set( 'output_buffering', 'Off' ); - @ini_set( 'output_handler', '' ); + @ini_set( 'zlib.output_compression', 'Off' ); // @codingStandardsIgnoreLine + @ini_set( 'output_buffering', 'Off' ); // @codingStandardsIgnoreLine + @ini_set( 'output_handler', '' ); // @codingStandardsIgnoreLine ignore_user_abort( true ); wc_set_time_limit( 0 ); - nocache_headers(); + wc_nocache_headers(); header( 'Content-Type: text/csv; charset=utf-8' ); header( 'Content-Disposition: attachment; filename=' . $this->get_filename() ); header( 'Pragma: no-cache' ); header( 'Expires: 0' ); } + /** + * Set filename to export to. + * + * @param string $filename Filename to export to. + */ + public function set_filename( $filename ) { + $this->filename = sanitize_file_name( str_replace( '.csv', '', $filename ) . '.csv' ); + } + /** * Generate and return a filename. * * @return string */ public function get_filename() { - return sanitize_file_name( 'wc-' . $this->export_type . '-export-' . date_i18n( 'Y-m-d', current_time( 'timestamp' ) ) . '.csv' ); + return sanitize_file_name( apply_filters( "woocommerce_{$this->export_type}_export_get_filename", $this->filename ) ); } /** * Set the export content. * * @since 3.1.0 + * @param string $csv_data All CSV content. */ public function send_content( $csv_data ) { - echo $csv_data; + echo $csv_data; // @codingStandardsIgnoreLine } /** @@ -212,17 +235,17 @@ abstract class WC_CSV_Exporter { protected function export_column_headers() { $columns = $this->get_column_names(); $export_row = array(); - $buffer = fopen( 'php://output', 'w' ); + $buffer = fopen( 'php://output', 'w' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_read_fopen ob_start(); foreach ( $columns as $column_id => $column_name ) { if ( ! $this->is_column_exporting( $column_id ) ) { continue; } - $export_row[] = $column_name; + $export_row[] = $this->format_data( $column_name ); } - fputcsv( $buffer, $export_row ); + $this->fputcsv( $buffer, $export_row ); return ob_get_clean(); } @@ -241,11 +264,11 @@ abstract class WC_CSV_Exporter { * Export rows in CSV format. * * @since 3.1.0 - * @return array + * @return string */ protected function export_rows() { $data = $this->get_data_to_export(); - $buffer = fopen( 'php://output', 'w' ); + $buffer = fopen( 'php://output', 'w' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_read_fopen ob_start(); array_walk( $data, array( $this, 'export_row' ), $buffer ); @@ -257,7 +280,9 @@ abstract class WC_CSV_Exporter { * Export rows to an array ready for the CSV. * * @since 3.1.0 - * @param array $row_data + * @param array $row_data Data to export. + * @param string $key Column being exported. + * @param resource $buffer Output buffer. */ protected function export_row( $row_data, $key, $buffer ) { $columns = $this->get_column_names(); @@ -274,7 +299,8 @@ abstract class WC_CSV_Exporter { } } - fputcsv( $buffer, $export_row ); + $this->fputcsv( $buffer, $export_row ); + ++ $this->exported_row_count; } @@ -285,14 +311,14 @@ abstract class WC_CSV_Exporter { * @return int */ public function get_limit() { - return $this->limit; + return apply_filters( "woocommerce_{$this->export_type}_export_batch_limit", $this->limit, $this ); } /** * Set batch limit. * * @since 3.1.0 - * @param int $limit + * @param int $limit Limit to export. */ public function set_limit( $limit ) { $this->limit = absint( $limit ); @@ -321,14 +347,14 @@ abstract class WC_CSV_Exporter { * @see https://hackerone.com/reports/72785 * * @since 3.1.0 - * @param string $field CSV field to escape + * @param string $data CSV field to escape. * @return string */ public function escape_data( $data ) { $active_content_triggers = array( '=', '+', '-', '@' ); if ( in_array( mb_substr( $data, 0, 1 ), $active_content_triggers, true ) ) { - $data = "'" . $data; + $data = "'" . $data . "'"; } return $data; @@ -338,7 +364,7 @@ abstract class WC_CSV_Exporter { * Format and escape data ready for the CSV file. * * @since 3.1.0 - * @param string $data + * @param string $data Data to format. * @return string */ public function format_data( $data ) { @@ -352,9 +378,14 @@ abstract class WC_CSV_Exporter { $data = $data ? 1 : 0; } - $data = (string) urldecode( $data ); - $encoding = mb_detect_encoding( $data, 'UTF-8, ISO-8859-1', true ); - $data = 'UTF-8' === $encoding ? $data : utf8_encode( $data ); + $use_mb = function_exists( 'mb_convert_encoding' ); + $data = (string) urldecode( $data ); + + if ( $use_mb ) { + $encoding = mb_detect_encoding( $data, 'UTF-8, ISO-8859-1', true ); + $data = 'UTF-8' === $encoding ? $data : utf8_encode( $data ); + } + return $this->escape_data( $data ); } @@ -362,9 +393,9 @@ abstract class WC_CSV_Exporter { * Format term ids to names. * * @since 3.1.0 - * @param array $term_ids - * @param string $taxonomy - * @return array + * @param array $term_ids Term IDs to format. + * @param string $taxonomy Taxonomy name. + * @return string */ public function format_term_ids( $term_ids, $taxonomy ) { $term_ids = wp_parse_id_list( $term_ids ); @@ -413,11 +444,11 @@ abstract class WC_CSV_Exporter { * which contain the separator. * * @since 3.2.0 - * @param array $values + * @param array $values Values to implode. * @return string */ protected function implode_values( $values ) { - $values_to_implode = array(); + $values_to_implode = array(); foreach ( $values as $value ) { $value = (string) is_scalar( $value ) ? $value : ''; @@ -426,4 +457,32 @@ abstract class WC_CSV_Exporter { return implode( ', ', $values_to_implode ); } + + /** + * Write to the CSV file, ensuring escaping works across versions of + * PHP. + * + * PHP 5.5.4 uses '\' as the default escape character. This is not RFC-4180 compliant. + * \0 disables the escape character. + * + * @see https://bugs.php.net/bug.php?id=43225 + * @see https://bugs.php.net/bug.php?id=50686 + * @see https://github.com/woocommerce/woocommerce/issues/19514 + * @since 3.4.0 + * @param resource $buffer Resource we are writing to. + * @param array $export_row Row to export. + */ + protected function fputcsv( $buffer, $export_row ) { + if ( version_compare( PHP_VERSION, '5.5.4', '<' ) ) { + ob_start(); + $temp = fopen( 'php://output', 'w' ); // @codingStandardsIgnoreLine + fputcsv( $temp, $export_row, ",", '"' ); // @codingStandardsIgnoreLine + fclose( $temp ); // @codingStandardsIgnoreLine + $row = ob_get_clean(); + $row = str_replace( '\\"', '\\""', $row ); + fwrite( $buffer, $row ); // @codingStandardsIgnoreLine + } else { + fputcsv( $buffer, $export_row, ",", '"', "\0" ); // @codingStandardsIgnoreLine + } + } } diff --git a/includes/export/class-wc-product-csv-exporter.php b/includes/export/class-wc-product-csv-exporter.php index ab1e4152668..a2229780e2b 100644 --- a/includes/export/class-wc-product-csv-exporter.php +++ b/includes/export/class-wc-product-csv-exporter.php @@ -2,11 +2,10 @@ /** * Handles product CSV export. * - * @author Automattic - * @category Admin * @package WooCommerce/Export * @version 3.1.0 */ + if ( ! defined( 'ABSPATH' ) ) { exit; } @@ -15,7 +14,7 @@ if ( ! defined( 'ABSPATH' ) ) { * Include dependencies. */ if ( ! class_exists( 'WC_CSV_Batch_Exporter', false ) ) { - include_once( WC_ABSPATH . 'includes/export/abstract-wc-csv-batch-exporter.php' ); + include_once WC_ABSPATH . 'includes/export/abstract-wc-csv-batch-exporter.php'; } /** @@ -25,22 +24,32 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { /** * Type of export used in filter names. + * * @var string */ protected $export_type = 'product'; /** * Should meta be exported? + * * @var boolean */ protected $enable_meta_export = false; /** - * Which product types are beign exported. + * Which product types are being exported. + * * @var array */ protected $product_types_to_export = array(); + /** + * Products belonging to what category should be exported. + * + * @var string + */ + protected $product_category_to_export = array(); + /** * Constructor. */ @@ -53,7 +62,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Should meta be exported? * * @since 3.1.0 - * @param bool $enable_meta_export + * @param bool $enable_meta_export Should meta be exported. */ public function enable_meta_export( $enable_meta_export ) { $this->enable_meta_export = (bool) $enable_meta_export; @@ -63,12 +72,23 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Product types to export. * * @since 3.1.0 - * @param array $product_types_to_export + * @param array $product_types_to_export List of types to export. */ public function set_product_types_to_export( $product_types_to_export ) { $this->product_types_to_export = array_map( 'wc_clean', $product_types_to_export ); } + /** + * Product category to export + * + * @since 3.5.0 + * @param string $product_category_to_export Product category slug to export, empty string exports all. + * @return void + */ + public function set_product_category_to_export( $product_category_to_export ) { + $this->product_category_to_export = array_map( 'wc_clean', $product_category_to_export ); + } + /** * Return an array of columns to export. * @@ -92,11 +112,16 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { 'tax_class' => __( 'Tax class', 'woocommerce' ), 'stock_status' => __( 'In stock?', 'woocommerce' ), 'stock' => __( 'Stock', 'woocommerce' ), + 'low_stock_amount' => __( 'Low stock amount', 'woocommerce' ), 'backorders' => __( 'Backorders allowed?', 'woocommerce' ), 'sold_individually' => __( 'Sold individually?', 'woocommerce' ), + /* translators: %s: weight */ 'weight' => sprintf( __( 'Weight (%s)', 'woocommerce' ), get_option( 'woocommerce_weight_unit' ) ), + /* translators: %s: length */ 'length' => sprintf( __( 'Length (%s)', 'woocommerce' ), get_option( 'woocommerce_dimension_unit' ) ), + /* translators: %s: width */ 'width' => sprintf( __( 'Width (%s)', 'woocommerce' ), get_option( 'woocommerce_dimension_unit' ) ), + /* translators: %s: Height */ 'height' => sprintf( __( 'Height (%s)', 'woocommerce' ), get_option( 'woocommerce_dimension_unit' ) ), 'reviews_allowed' => __( 'Allow customer reviews?', 'woocommerce' ), 'purchase_note' => __( 'Purchase note', 'woocommerce' ), @@ -114,6 +139,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { 'cross_sell_ids' => __( 'Cross-sells', 'woocommerce' ), 'product_url' => __( 'External URL', 'woocommerce' ), 'button_text' => __( 'Button text', 'woocommerce' ), + 'menu_order' => __( 'Position', 'woocommerce' ), ) ); } @@ -123,73 +149,141 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * @since 3.1.0 */ public function prepare_data_to_export() { - $columns = $this->get_column_names(); - $products = wc_get_products( array( - 'status' => array( 'private', 'publish' ), + $args = array( + 'status' => array( 'private', 'publish', 'draft', 'future', 'pending' ), 'type' => $this->product_types_to_export, 'limit' => $this->get_limit(), 'page' => $this->get_page(), 'orderby' => array( - 'ID' => 'ASC', + 'ID' => 'ASC', ), 'return' => 'objects', 'paginate' => true, - ) ); + ); - $this->total_rows = $products->total; - $this->row_data = array(); + if ( ! empty( $this->product_category_to_export ) ) { + $args['category'] = $this->product_category_to_export; + } + $products = wc_get_products( apply_filters( "woocommerce_product_export_{$this->export_type}_query_args", $args ) ); + + $this->total_rows = $products->total; + $this->row_data = array(); + $variable_products = array(); foreach ( $products->products as $product ) { - $row = array(); - foreach ( $columns as $column_id => $column_name ) { - $column_id = strstr( $column_id, ':' ) ? current( explode( ':', $column_id ) ) : $column_id; - $value = ''; + // Check if the category is set, this means we need to fetch variations seperately as they are not tied to a category. + if ( ! empty( $args['category'] ) && $product->is_type( 'variable' ) ) { + $variable_products[] = $product->get_id(); + } - // Skip some columns if dynamically handled later or if we're being selective. - if ( in_array( $column_id, array( 'downloads', 'attributes', 'meta' ) ) || ! $this->is_column_exporting( $column_id ) ) { + $this->row_data[] = $this->generate_row_data( $product ); + } + + // If a category was selected we loop through the variations as they are not tied to a category so will be excluded by default. + if ( ! empty( $variable_products ) ) { + foreach ( $variable_products as $parent_id ) { + $products = wc_get_products( array( + 'parent' => $parent_id, + 'type' => array( 'variation' ), + 'return' => 'objects', + 'limit' => -1, + ) ); + + if ( ! $products ) { continue; } - // Filter for 3rd parties. - if ( has_filter( "woocommerce_product_export_{$this->export_type}_column_{$column_id}" ) ) { - $value = apply_filters( "woocommerce_product_export_{$this->export_type}_column_{$column_id}", '', $product, $column_id ); - - // Handle special columns which don't map 1:1 to product data. - } elseif ( is_callable( array( $this, "get_column_value_{$column_id}" ) ) ) { - $value = $this->{"get_column_value_{$column_id}"}( $product ); - - // Default and custom handling. - } elseif ( is_callable( array( $product, "get_{$column_id}" ) ) ) { - $value = $product->{"get_{$column_id}"}( 'edit' ); + foreach ( $products as $product ) { + $this->row_data[] = $this->generate_row_data( $product ); } + } + } + } - $row[ $column_id ] = $value; + /** + * Take a product and generate row data from it for export. + * + * @param WC_Product $product WC_Product object. + * @return array + */ + protected function generate_row_data( $product ) { + $columns = $this->get_column_names(); + $row = array(); + foreach ( $columns as $column_id => $column_name ) { + $column_id = strstr( $column_id, ':' ) ? current( explode( ':', $column_id ) ) : $column_id; + $value = ''; + + // Skip some columns if dynamically handled later or if we're being selective. + if ( in_array( $column_id, array( 'downloads', 'attributes', 'meta' ), true ) || ! $this->is_column_exporting( $column_id ) ) { + continue; } - $this->prepare_downloads_for_export( $product, $row ); - $this->prepare_attributes_for_export( $product, $row ); - $this->prepare_meta_for_export( $product, $row ); + if ( has_filter( "woocommerce_product_export_{$this->export_type}_column_{$column_id}" ) ) { + // Filter for 3rd parties. + $value = apply_filters( "woocommerce_product_export_{$this->export_type}_column_{$column_id}", '', $product, $column_id ); - $this->row_data[] = apply_filters( 'woocommerce_product_export_row_data', $row, $product ); + } elseif ( is_callable( array( $this, "get_column_value_{$column_id}" ) ) ) { + // Handle special columns which don't map 1:1 to product data. + $value = $this->{"get_column_value_{$column_id}"}( $product ); + + } elseif ( is_callable( array( $product, "get_{$column_id}" ) ) ) { + // Default and custom handling. + $value = $product->{"get_{$column_id}"}( 'edit' ); + } + + $row[ $column_id ] = $value; } + + $this->prepare_downloads_for_export( $product, $row ); + $this->prepare_attributes_for_export( $product, $row ); + $this->prepare_meta_for_export( $product, $row ); + return apply_filters( 'woocommerce_product_export_row_data', $row, $product ); } /** * Get published value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return int */ protected function get_column_value_published( $product ) { - return 'publish' === $product->get_status( 'edit' ) ? 1 : 0; + $statuses = array( + 'draft' => -1, + 'private' => 0, + 'publish' => 1, + ); + + $status = $product->get_status( 'edit' ); + + return isset( $statuses[ $status ] ) ? $statuses[ $status ] : -1; + } + + /** + * Get formatted sale price. + * + * @param WC_Product $product Product being exported. + * @return string + */ + protected function get_column_value_sale_price( $product ) { + return wc_format_localized_price( $product->get_sale_price( 'view' ) ); + } + + /** + * Get formatted regular price. + * + * @param WC_Product $product Product being exported. + * @return string + */ + protected function get_column_value_regular_price( $product ) { + return wc_format_localized_price( $product->get_regular_price() ); } /** * Get product_cat value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_category_ids( $product ) { @@ -201,7 +295,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get product_tag value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_tag_ids( $product ) { @@ -213,7 +307,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get product_shipping_class value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_shipping_class_id( $product ) { @@ -225,7 +319,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get images value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_images( $product ) { @@ -233,7 +327,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { $images = array(); foreach ( $image_ids as $image_id ) { - $image = wp_get_attachment_image_src( $image_id, 'full' ); + $image = wp_get_attachment_image_src( $image_id, 'full' ); if ( $image ) { $images[] = $image[0]; @@ -247,7 +341,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Prepare linked products for export. * * @since 3.1.0 - * @param int[] $linked_products + * @param int[] $linked_products Array of linked product ids. * @return string */ protected function prepare_linked_products_for_export( $linked_products ) { @@ -268,7 +362,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get cross_sell_ids value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_cross_sell_ids( $product ) { @@ -279,7 +373,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get upsell_ids value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_upsell_ids( $product ) { @@ -290,7 +384,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get parent_id value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_parent_id( $product ) { @@ -309,7 +403,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get grouped_products value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_grouped_products( $product ) { @@ -318,7 +412,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { } $grouped_products = array(); - $child_ids = $product->get_children( 'edit' ); + $child_ids = $product->get_children( 'edit' ); foreach ( $child_ids as $child_id ) { $child = wc_get_product( $child_id ); if ( ! $child ) { @@ -334,7 +428,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get download_limit value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_download_limit( $product ) { @@ -345,7 +439,7 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get download_expiry value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_download_expiry( $product ) { @@ -356,14 +450,14 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get stock value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_stock( $product ) { $manage_stock = $product->get_manage_stock( 'edit' ); $stock_quantity = $product->get_stock_quantity( 'edit' ); - if ( $product->is_type( 'variation' && 'parent' === $manage_stock ) ) { + if ( $product->is_type( 'variation' ) && 'parent' === $manage_stock ) { return 'parent'; } elseif ( $manage_stock ) { return $stock_quantity; @@ -376,11 +470,16 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get stock status value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_stock_status( $product ) { $status = $product->get_stock_status( 'edit' ); + + if ( 'onbackorder' === $status ) { + return 'backorder'; + } + return 'instock' === $status ? 1 : 0; } @@ -388,25 +487,36 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Get backorders. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_backorders( $product ) { $backorders = $product->get_backorders( 'edit' ); switch ( $backorders ) { - case 'notify' : + case 'notify': return 'notify'; - default : + default: return wc_string_to_bool( $backorders ) ? 1 : 0; } } + /** + * Get low stock amount value. + * + * @param WC_Product $product Product being exported. + * @since 3.5.0 + * @return int|string Empty string if value not set + */ + protected function get_column_value_low_stock_amount( $product ) { + return $product->managing_stock() && $product->get_low_stock_amount( 'edit' ) ? $product->get_low_stock_amount( 'edit' ) : ''; + } + /** * Get type value. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product Product being exported. * @return string */ protected function get_column_value_type( $product ) { @@ -428,8 +538,8 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Export downloads. * * @since 3.1.0 - * @param WC_Product $product - * @param array $row + * @param WC_Product $product Product being exported. + * @param array $row Row being exported. */ protected function prepare_downloads_for_export( $product, &$row ) { if ( $product->is_downloadable() && $this->is_column_exporting( 'downloads' ) ) { @@ -438,10 +548,12 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { if ( $downloads ) { $i = 1; foreach ( $downloads as $download ) { + /* translators: %s: download number */ $this->column_names[ 'downloads:name' . $i ] = sprintf( __( 'Download %d name', 'woocommerce' ), $i ); - $this->column_names[ 'downloads:url' . $i ] = sprintf( __( 'Download %d URL', 'woocommerce' ), $i ); - $row[ 'downloads:name' . $i ] = $download->get_name(); - $row[ 'downloads:url' . $i ] = $download->get_file(); + /* translators: %s: download number */ + $this->column_names[ 'downloads:url' . $i ] = sprintf( __( 'Download %d URL', 'woocommerce' ), $i ); + $row[ 'downloads:name' . $i ] = $download->get_name(); + $row[ 'downloads:url' . $i ] = $download->get_file(); $i++; } } @@ -452,8 +564,8 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Export attributes data. * * @since 3.1.0 - * @param WC_Product $product - * @param array $row + * @param WC_Product $product Product being exported. + * @param array $row Row being exported. */ protected function prepare_attributes_for_export( $product, &$row ) { if ( $this->is_column_exporting( 'attributes' ) ) { @@ -463,9 +575,13 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { if ( count( $attributes ) ) { $i = 1; foreach ( $attributes as $attribute_name => $attribute ) { - $this->column_names[ 'attributes:name' . $i ] = sprintf( __( 'Attribute %d name', 'woocommerce' ), $i ); - $this->column_names[ 'attributes:value' . $i ] = sprintf( __( 'Attribute %d value(s)', 'woocommerce' ), $i ); - $this->column_names[ 'attributes:visible' . $i ] = sprintf( __( 'Attribute %d visible', 'woocommerce' ), $i ); + /* translators: %s: attribute number */ + $this->column_names[ 'attributes:name' . $i ] = sprintf( __( 'Attribute %d name', 'woocommerce' ), $i ); + /* translators: %s: attribute number */ + $this->column_names[ 'attributes:value' . $i ] = sprintf( __( 'Attribute %d value(s)', 'woocommerce' ), $i ); + /* translators: %s: attribute number */ + $this->column_names[ 'attributes:visible' . $i ] = sprintf( __( 'Attribute %d visible', 'woocommerce' ), $i ); + /* translators: %s: attribute number */ $this->column_names[ 'attributes:taxonomy' . $i ] = sprintf( __( 'Attribute %d global', 'woocommerce' ), $i ); if ( is_a( $attribute, 'WC_Product_Attribute' ) ) { @@ -491,8 +607,8 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { $row[ 'attributes:name' . $i ] = wc_attribute_label( $attribute_name, $product ); if ( 0 === strpos( $attribute_name, 'pa_' ) ) { - $option_term = get_term_by( 'slug', $attribute, $attribute_name ); - $row[ 'attributes:value' . $i ] = $option_term && ! is_wp_error( $option_term ) ? $option_term->name : $attribute; + $option_term = get_term_by( 'slug', $attribute, $attribute_name ); // @codingStandardsIgnoreLine. + $row[ 'attributes:value' . $i ] = $option_term && ! is_wp_error( $option_term ) ? str_replace( ',', '\\,', $option_term->name ) : $attribute; $row[ 'attributes:taxonomy' . $i ] = 1; } else { $row[ 'attributes:value' . $i ] = $attribute; @@ -503,12 +619,13 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { } if ( $product->is_type( 'variable' ) && isset( $default_attributes[ sanitize_title( $attribute_name ) ] ) ) { + /* translators: %s: attribute number */ $this->column_names[ 'attributes:default' . $i ] = sprintf( __( 'Attribute %d default', 'woocommerce' ), $i ); $default_value = $default_attributes[ sanitize_title( $attribute_name ) ]; if ( 0 === strpos( $attribute_name, 'pa_' ) ) { - $option_term = get_term_by( 'slug', $default_value, $attribute_name ); - $row[ 'attributes:default' . $i ] = $option_term && ! is_wp_error( $option_term ) ? $option_term->name : $default_value; + $option_term = get_term_by( 'slug', $default_value, $attribute_name ); // @codingStandardsIgnoreLine. + $row[ 'attributes:default' . $i ] = $option_term && ! is_wp_error( $option_term ) ? $option_term->name : $default_value; } else { $row[ 'attributes:default' . $i ] = $default_value; } @@ -523,8 +640,8 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { * Export meta data. * * @since 3.1.0 - * @param WC_Product $product - * @param array $row + * @param WC_Product $product Product being exported. + * @param array $row Row data. */ protected function prepare_meta_for_export( $product, &$row ) { if ( $this->enable_meta_export ) { @@ -535,13 +652,22 @@ class WC_Product_CSV_Exporter extends WC_CSV_Batch_Exporter { $i = 1; foreach ( $meta_data as $meta ) { - if ( ! is_scalar( $meta->value ) || in_array( $meta->key, $meta_keys_to_skip ) ) { + if ( in_array( $meta->key, $meta_keys_to_skip, true ) ) { continue; } - $column_key = 'meta:' . esc_attr( $meta->key ); + + // Allow 3rd parties to process the meta, e.g. to transform non-scalar values to scalar. + $meta_value = apply_filters( 'woocommerce_product_export_meta_value', $meta->value, $meta, $product, $row ); + + if ( ! is_scalar( $meta_value ) ) { + continue; + } + + $column_key = 'meta:' . esc_attr( $meta->key ); + /* translators: %s: meta data name */ $this->column_names[ $column_key ] = sprintf( __( 'Meta: %s', 'woocommerce' ), $meta->key ); - $row[ $column_key ] = $meta->value; - $i++; + $row[ $column_key ] = $meta_value; + $i ++; } } } diff --git a/includes/gateways/bacs/class-wc-gateway-bacs.php b/includes/gateways/bacs/class-wc-gateway-bacs.php index 57df990dce5..fdd4a64af6e 100644 --- a/includes/gateways/bacs/class-wc-gateway-bacs.php +++ b/includes/gateways/bacs/class-wc-gateway-bacs.php @@ -1,7 +1,12 @@ id = 'bacs'; $this->icon = apply_filters( 'woocommerce_bacs_icon', '' ); $this->has_fields = false; - $this->method_title = __( 'BACS', 'woocommerce' ); - $this->method_description = __( 'Allows payments by BACS, more commonly known as direct bank/wire transfer.', 'woocommerce' ); + $this->method_title = __( 'Direct bank transfer', 'woocommerce' ); + $this->method_description = __( 'Take payments in person via BACS. More commonly known as direct bank/wire transfer', 'woocommerce' ); // Load the settings. $this->init_form_fields(); $this->init_settings(); - // Define user set variables + // Define user set variables. $this->title = $this->get_option( 'title' ); $this->description = $this->get_option( 'description' ); $this->instructions = $this->get_option( 'instructions' ); - // BACS account fields shown on the thanks page and in emails - $this->account_details = get_option( 'woocommerce_bacs_accounts', + // BACS account fields shown on the thanks page and in emails. + $this->account_details = get_option( + 'woocommerce_bacs_accounts', array( array( 'account_name' => $this->get_option( 'account_name' ), @@ -54,12 +63,12 @@ class WC_Gateway_BACS extends WC_Payment_Gateway { ) ); - // Actions + // Actions. add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, array( $this, 'process_admin_options' ) ); add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, array( $this, 'save_account_details' ) ); add_action( 'woocommerce_thankyou_bacs', array( $this, 'thankyou_page' ) ); - // Customer Emails + // Customer Emails. add_action( 'woocommerce_email_before_order_table', array( $this, 'email_instructions' ), 10, 3 ); } @@ -69,27 +78,27 @@ class WC_Gateway_BACS extends WC_Payment_Gateway { public function init_form_fields() { $this->form_fields = array( - 'enabled' => array( + 'enabled' => array( 'title' => __( 'Enable/Disable', 'woocommerce' ), 'type' => 'checkbox', 'label' => __( 'Enable bank transfer', 'woocommerce' ), 'default' => 'no', ), - 'title' => array( + 'title' => array( 'title' => __( 'Title', 'woocommerce' ), 'type' => 'text', 'description' => __( 'This controls the title which the user sees during checkout.', 'woocommerce' ), 'default' => __( 'Direct bank transfer', 'woocommerce' ), 'desc_tip' => true, ), - 'description' => array( + 'description' => array( 'title' => __( 'Description', 'woocommerce' ), 'type' => 'textarea', 'description' => __( 'Payment method description that the customer will see on your checkout.', 'woocommerce' ), 'default' => __( 'Make your payment directly into our bank account. Please use your Order ID as the payment reference. Your order will not be shipped until the funds have cleared in our account.', 'woocommerce' ), 'desc_tip' => true, ), - 'instructions' => array( + 'instructions' => array( 'title' => __( 'Instructions', 'woocommerce' ), 'type' => 'textarea', 'description' => __( 'Instructions that will be added to the thank you page and emails.', 'woocommerce' ), @@ -97,7 +106,7 @@ class WC_Gateway_BACS extends WC_Payment_Gateway { 'desc_tip' => true, ), 'account_details' => array( - 'type' => 'account_details', + 'type' => 'account_details', ), ); @@ -112,54 +121,56 @@ class WC_Gateway_BACS extends WC_Payment_Gateway { ob_start(); - $country = WC()->countries->get_base_country(); - $locale = $this->get_country_locale(); + $country = WC()->countries->get_base_country(); + $locale = $this->get_country_locale(); - // Get sortcode label in the $locale array and use appropriate one + // Get sortcode label in the $locale array and use appropriate one. $sortcode = isset( $locale[ $country ]['sortcode']['label'] ) ? $locale[ $country ]['sortcode']['label'] : __( 'Sort code', 'woocommerce' ); ?>
          : - - - - - - - - - - - - - - account_details ) { - foreach ( $this->account_details as $account ) { - $i++; +
          +
           
          + + + + + + + + + + + + + account_details ) { + foreach ( $this->account_details as $account ) { + $i++; - echo ' - - - - - - - - '; + echo ' + + + + + + + + '; + } } - } - ?> - - - - - - -
           
          + ?> + +
          + \n"; /** - * woocommerce_queued_js filter. + * Queued jsfilter. * * @since 2.6.0 * @param string $js JavaScript code. */ - echo apply_filters( 'woocommerce_queued_js', $js ); + echo apply_filters( 'woocommerce_queued_js', $js ); // WPCS: XSS ok. unset( $wc_queued_js ); } @@ -736,10 +826,10 @@ function wc_print_js() { */ function wc_setcookie( $name, $value, $expire = 0, $secure = false ) { if ( ! headers_sent() ) { - setcookie( $name, $value, $expire, COOKIEPATH ? COOKIEPATH : '/', COOKIE_DOMAIN, $secure ); + setcookie( $name, $value, $expire, COOKIEPATH ? COOKIEPATH : '/', COOKIE_DOMAIN, $secure, apply_filters( 'woocommerce_cookie_httponly', false, $name, $value, $expire, $secure ) ); } elseif ( defined( 'WP_DEBUG' ) && WP_DEBUG ) { headers_sent( $file, $line ); - trigger_error( "{$name} cookie cannot be set - headers already sent by {$file} on line {$line}", E_USER_NOTICE ); + trigger_error( "{$name} cookie cannot be set - headers already sent by {$file} on line {$line}", E_USER_NOTICE ); // @codingStandardsIgnoreLine } } @@ -751,7 +841,7 @@ function wc_setcookie( $name, $value, $expire = 0, $secure = false ) { * @return string the URL. */ function get_woocommerce_api_url( $path ) { - $version = defined( 'WC_API_REQUEST_VERSION' ) ? WC_API_REQUEST_VERSION : substr( WC_API::VERSION, 0, 1 ); + $version = defined( 'WC_API_REQUEST_VERSION' ) ? WC_API_REQUEST_VERSION : substr( WC_API::VERSION, 0, 1 ); $url = get_home_url( null, "wc-api/v{$version}/", is_ssl() ? 'https' : 'http' ); @@ -774,19 +864,34 @@ function wc_get_log_file_path( $handle ) { return WC_Log_Handler_File::get_log_file_path( $handle ); } +/** + * Get a log file name. + * + * @since 3.3 + * + * @param string $handle Name. + * @return string The log file name. + */ +function wc_get_log_file_name( $handle ) { + return WC_Log_Handler_File::get_log_file_name( $handle ); +} + /** * Recursively get page children. - * @param int $page_id + * + * @param int $page_id Page ID. * @return int[] */ function wc_get_page_children( $page_id ) { - $page_ids = get_posts( array( - 'post_parent' => $page_id, - 'post_type' => 'page', - 'numberposts' => -1, - 'post_status' => 'any', - 'fields' => 'ids', - ) ); + $page_ids = get_posts( + array( + 'post_parent' => $page_id, + 'post_type' => 'page', + 'numberposts' => -1, // @codingStandardsIgnoreLine + 'post_status' => 'any', + 'fields' => 'ids', + ) + ); if ( ! empty( $page_ids ) ) { foreach ( $page_ids as $page_id ) { @@ -810,14 +915,14 @@ function flush_rewrite_rules_on_shop_page_save() { } // Check if page is edited. - if ( empty( $_GET['post'] ) || empty( $_GET['action'] ) || ( isset( $_GET['action'] ) && 'edit' !== $_GET['action'] ) ) { + if ( empty( $_GET['post'] ) || empty( $_GET['action'] ) || ( isset( $_GET['action'] ) && 'edit' !== $_GET['action'] ) ) { // WPCS: input var ok, CSRF ok. return; } - $post_id = intval( $_GET['post'] ); + $post_id = intval( $_GET['post'] ); // WPCS: input var ok, CSRF ok. $shop_page_id = wc_get_page_id( 'shop' ); - if ( $shop_page_id === $post_id || in_array( $post_id, wc_get_page_children( $shop_page_id ) ) ) { + if ( $shop_page_id === $post_id || in_array( $post_id, wc_get_page_children( $shop_page_id ), true ) ) { do_action( 'woocommerce_flush_rewrite_rules' ); } } @@ -827,7 +932,7 @@ add_action( 'admin_footer', 'flush_rewrite_rules_on_shop_page_save' ); * Various rewrite rule fixes. * * @since 2.2 - * @param array $rules + * @param array $rules Rules. * @return array */ function wc_fix_rewrite_rules( $rules ) { @@ -836,7 +941,7 @@ function wc_fix_rewrite_rules( $rules ) { $permalinks = wc_get_permalink_structure(); // Fix the rewrite rules when the product permalink have %product_cat% flag. - if ( preg_match( '`/(.+)(/%product_cat%)`' , $permalinks['product_rewrite_slug'], $matches ) ) { + if ( preg_match( '`/(.+)(/%product_cat%)`', $permalinks['product_rewrite_slug'], $matches ) ) { foreach ( $rules as $rule => $rewrite ) { if ( preg_match( '`^' . preg_quote( $matches[1], '`' ) . '/\(`', $rule ) && preg_match( '/^(index\.php\?product_cat)(?!(.*product))/', $rewrite ) ) { unset( $rules[ $rule ] ); @@ -845,13 +950,18 @@ function wc_fix_rewrite_rules( $rules ) { } // If the shop page is used as the base, we need to handle shop page subpages to avoid 404s. - if ( $permalinks['use_verbose_page_rules'] && ( $shop_page_id = wc_get_page_id( 'shop' ) ) ) { + if ( ! $permalinks['use_verbose_page_rules'] ) { + return $rules; + } + + $shop_page_id = wc_get_page_id( 'shop' ); + if ( $shop_page_id ) { $page_rewrite_rules = array(); $subpages = wc_get_page_children( $shop_page_id ); - // Subpage rules + // Subpage rules. foreach ( $subpages as $subpage ) { - $uri = get_page_uri( $subpage ); + $uri = get_page_uri( $subpage ); $page_rewrite_rules[ $uri . '/?$' ] = 'index.php?pagename=' . $uri; $wp_generated_rewrite_rules = $wp_rewrite->generate_rewrite_rules( $uri, EP_PAGES, true, true, false, false ); foreach ( $wp_generated_rewrite_rules as $key => $value ) { @@ -860,7 +970,7 @@ function wc_fix_rewrite_rules( $rules ) { $page_rewrite_rules = array_merge( $page_rewrite_rules, $wp_generated_rewrite_rules ); } - // Merge with rules + // Merge with rules. $rules = array_merge( $page_rewrite_rules, $rules ); } @@ -871,17 +981,14 @@ add_filter( 'rewrite_rules_array', 'wc_fix_rewrite_rules' ); /** * Prevent product attachment links from breaking when using complex rewrite structures. * - * @param string $link - * @param id $post_id + * @param string $link Link. + * @param int $post_id Post ID. * @return string */ function wc_fix_product_attachment_link( $link, $post_id ) { - $post = get_post( $post_id ); - if ( 'product' === get_post_type( $post->post_parent ) ) { - $permalinks = wc_get_permalink_structure(); - if ( preg_match( '/\/(.+)(\/%product_cat%)$/', $permalinks['product_rewrite_slug'], $matches ) ) { - $link = home_url( '/?attachment_id=' . $post->ID ); - } + $parent_type = get_post_type( wp_get_post_parent_id( $post_id ) ); + if ( 'product' === $parent_type || 'product_variation' === $parent_type ) { + $link = home_url( '/?attachment_id=' . $post_id ); } return $link; } @@ -890,11 +997,11 @@ add_filter( 'attachment_link', 'wc_fix_product_attachment_link', 10, 2 ); /** * Protect downloads from ms-files.php in multisite. * - * @param mixed $rewrite + * @param string $rewrite rewrite rules. * @return string */ function wc_ms_protect_download_rewite_rules( $rewrite ) { - if ( ! is_multisite() || 'redirect' == get_option( 'woocommerce_file_download_method' ) ) { + if ( ! is_multisite() || 'redirect' === get_option( 'woocommerce_file_download_method' ) ) { return $rewrite; } @@ -909,37 +1016,11 @@ function wc_ms_protect_download_rewite_rules( $rewrite ) { } add_filter( 'mod_rewrite_rules', 'wc_ms_protect_download_rewite_rules' ); -/** - * WooCommerce Core Supported Themes. - * - * @since 2.2 - * @return string[] - */ -function wc_get_core_supported_themes() { - return array( 'twentyseventeen', 'twentysixteen', 'twentyfifteen', 'twentyfourteen', 'twentythirteen', 'twentyeleven', 'twentytwelve', 'twentyten' ); -} - -/** - * Wrapper function to execute the `woocommerce_deliver_webhook_async` cron. - * hook, see WC_Webhook::process(). - * - * @since 2.2 - * @param int $webhook_id webhook ID to deliver. - * @param mixed $arg hook argument. - */ -function wc_deliver_webhook_async( $webhook_id, $arg ) { - - $webhook = new WC_Webhook( $webhook_id ); - - $webhook->deliver( $arg ); -} -add_action( 'woocommerce_deliver_webhook_async', 'wc_deliver_webhook_async', 10, 2 ); - /** * Formats a string in the format COUNTRY:STATE into an array. * * @since 2.3.0 - * @param string $country_string + * @param string $country_string Country string. * @return array */ function wc_format_country_state_string( $country_string ) { @@ -980,10 +1061,10 @@ function wc_get_customer_default_location() { $location = array(); switch ( get_option( 'woocommerce_default_customer_address' ) ) { - case 'geolocation_ajax' : - case 'geolocation' : + case 'geolocation_ajax': + case 'geolocation': // Exclude common bots from geolocation by user agent. - $ua = wc_get_user_agent(); + $ua = strtolower( wc_get_user_agent() ); if ( ! strstr( $ua, 'bot' ) && ! strstr( $ua, 'spider' ) && ! strstr( $ua, 'crawl' ) ) { $location = WC_Geolocation::geolocate_ip( '', true, false ); @@ -993,13 +1074,13 @@ function wc_get_customer_default_location() { if ( empty( $location['country'] ) ) { $location = wc_format_country_state_string( apply_filters( 'woocommerce_customer_default_location', get_option( 'woocommerce_default_country' ) ) ); } - break; - case 'base' : + break; + case 'base': $location = wc_format_country_state_string( apply_filters( 'woocommerce_customer_default_location', get_option( 'woocommerce_default_country' ) ) ); - break; - default : + break; + default: $location = wc_format_country_state_string( apply_filters( 'woocommerce_customer_default_location', '' ) ); - break; + break; } return apply_filters( 'woocommerce_customer_default_location_array', $location ); @@ -1007,11 +1088,12 @@ function wc_get_customer_default_location() { /** * Get user agent string. + * * @since 3.0.0 * @return string */ function wc_get_user_agent() { - return isset( $_SERVER['HTTP_USER_AGENT'] ) ? strtolower( $_SERVER['HTTP_USER_AGENT'] ) : ''; + return isset( $_SERVER['HTTP_USER_AGENT'] ) ? wc_clean( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ) : ''; // @codingStandardsIgnoreLine } // This function can be removed when WP 3.9.2 or greater is required. @@ -1051,18 +1133,18 @@ endif; * @return string */ function wc_rand_hash() { - if ( function_exists( 'openssl_random_pseudo_bytes' ) ) { - return bin2hex( openssl_random_pseudo_bytes( 20 ) ); - } else { + if ( ! function_exists( 'openssl_random_pseudo_bytes' ) ) { return sha1( wp_rand() ); } + + return bin2hex( openssl_random_pseudo_bytes( 20 ) ); // @codingStandardsIgnoreLine } /** * WC API - Hash. * * @since 2.4.0 - * @param string $data + * @param string $data Message to be hashed. * @return string */ function wc_api_hash( $data ) { @@ -1071,8 +1153,9 @@ function wc_api_hash( $data ) { /** * Find all possible combinations of values from the input array and return in a logical order. + * * @since 2.5.0 - * @param array $input + * @param array $input Input. * @return array */ function wc_array_cartesian( $input ) { @@ -1081,30 +1164,29 @@ function wc_array_cartesian( $input ) { $indexes = array(); $index = 0; - // Generate indexes from keys and values so we have a logical sort order + // Generate indexes from keys and values so we have a logical sort order. foreach ( $input as $key => $values ) { foreach ( $values as $value ) { $indexes[ $key ][ $value ] = $index++; } } - // Loop over the 2D array of indexes and generate all combinations + // Loop over the 2D array of indexes and generate all combinations. foreach ( $indexes as $key => $values ) { - // When result is empty, fill with the values of the first looped array + // When result is empty, fill with the values of the first looped array. if ( empty( $results ) ) { foreach ( $values as $value ) { $results[] = array( $key => $value ); } - - // Second and subsequent input sub-array merging. } else { + // Second and subsequent input sub-array merging. foreach ( $results as $result_key => $result ) { foreach ( $values as $value ) { - // If the key is not set, we can set it + // If the key is not set, we can set it. if ( ! isset( $results[ $result_key ][ $key ] ) ) { $results[ $result_key ][ $key ] = $value; - // If the key is set, we can add a new combination to the results array } else { + // If the key is set, we can add a new combination to the results array. $new_combination = $results[ $result_key ]; $new_combination[ $key ] = $value; $results[] = $new_combination; @@ -1114,19 +1196,19 @@ function wc_array_cartesian( $input ) { } } - // Sort the indexes + // Sort the indexes. arsort( $results ); - // Convert indexes back to values + // Convert indexes back to values. foreach ( $results as $result_key => $result ) { $converted_values = array(); - // Sort the values + // Sort the values. arsort( $results[ $result_key ] ); - // Convert the values + // Convert the values. foreach ( $results[ $result_key ] as $key => $value ) { - $converted_values[ $key ] = array_search( $value, $indexes[ $key ] ); + $converted_values[ $key ] = array_search( $value, $indexes[ $key ], true ); } $results[ $result_key ] = $converted_values; @@ -1137,29 +1219,29 @@ function wc_array_cartesian( $input ) { /** * Run a MySQL transaction query, if supported. - * @param string $type start (default), commit, rollback + * * @since 2.5.0 + * @param string $type Types: start (default), commit, rollback. + * @param bool $force use of transactions. */ -function wc_transaction_query( $type = 'start' ) { +function wc_transaction_query( $type = 'start', $force = false ) { global $wpdb; $wpdb->hide_errors(); - if ( ! defined( 'WC_USE_TRANSACTIONS' ) ) { - define( 'WC_USE_TRANSACTIONS', true ); - } + wc_maybe_define_constant( 'WC_USE_TRANSACTIONS', true ); - if ( WC_USE_TRANSACTIONS ) { + if ( WC_USE_TRANSACTIONS || $force ) { switch ( $type ) { - case 'commit' : + case 'commit': $wpdb->query( 'COMMIT' ); break; - case 'rollback' : + case 'rollback': $wpdb->query( 'ROLLBACK' ); break; - default : + default: $wpdb->query( 'START TRANSACTION' ); - break; + break; } } } @@ -1185,7 +1267,7 @@ function wc_get_cart_url() { function wc_get_checkout_url() { $checkout_url = wc_get_page_permalink( 'checkout' ); if ( $checkout_url ) { - // Force SSL if needed + // Force SSL if needed. if ( is_ssl() || 'yes' === get_option( 'woocommerce_force_ssl_checkout' ) ) { $checkout_url = str_replace( 'http:', 'https:', $checkout_url ); } @@ -1210,7 +1292,7 @@ if ( ! function_exists( 'wc_get_shipping_zone' ) ) { * * @since 2.6.0 * @uses WC_Shipping_Zones::get_zone_matching_package - * @param array $package + * @param array $package Shipping package. * @return WC_Shipping_Zone */ function wc_get_shipping_zone( $package ) { @@ -1222,23 +1304,25 @@ if ( ! function_exists( 'wc_get_shipping_zone' ) ) { * Get a nice name for credit card providers. * * @since 2.6.0 - * @param string $type Provider Slug/Type + * @param string $type Provider Slug/Type. * @return string */ function wc_get_credit_card_type_label( $type ) { - // Normalize + // Normalize. $type = strtolower( $type ); $type = str_replace( '-', ' ', $type ); $type = str_replace( '_', ' ', $type ); - $labels = apply_filters( 'woocommerce_credit_card_type_labels', array( - 'mastercard' => __( 'MasterCard', 'woocommerce' ), - 'visa' => __( 'Visa', 'woocommerce' ), - 'discover' => __( 'Discover', 'woocommerce' ), - 'american express' => __( 'American Express', 'woocommerce' ), - 'diners' => __( 'Diners', 'woocommerce' ), - 'jcb' => __( 'JCB', 'woocommerce' ), - ) ); + $labels = apply_filters( + 'woocommerce_credit_card_type_labels', array( + 'mastercard' => __( 'MasterCard', 'woocommerce' ), + 'visa' => __( 'Visa', 'woocommerce' ), + 'discover' => __( 'Discover', 'woocommerce' ), + 'american express' => __( 'American Express', 'woocommerce' ), + 'diners' => __( 'Diners', 'woocommerce' ), + 'jcb' => __( 'JCB', 'woocommerce' ), + ) + ); return apply_filters( 'woocommerce_get_credit_card_type_label', ( array_key_exists( $type, $labels ) ? $labels[ $type ] : ucfirst( $type ) ) ); } @@ -1258,8 +1342,8 @@ function wc_back_link( $label, $url ) { * * @since 2.5.0 * - * @param string $tip Help tip text - * @param bool $allow_html Allow sanitized HTML if true or escape + * @param string $tip Help tip text. + * @param bool $allow_html Allow sanitized HTML if true or escape. * @return string */ function wc_help_tip( $tip, $allow_html = false ) { @@ -1274,9 +1358,10 @@ function wc_help_tip( $tip, $allow_html = false ) { /** * Return a list of potential postcodes for wildcard searching. + * * @since 2.6.0 - * @param string $postcode - * @param string $country to format postcode for matching. + * @param string $postcode Postcode. + * @param string $country Country to format postcode for matching. * @return string[] */ function wc_get_wildcard_postcodes( $postcode, $country = '' ) { @@ -1298,12 +1383,13 @@ function wc_get_wildcard_postcodes( $postcode, $country = '' ) { /** * Used by shipping zones and taxes to compare a given $postcode to stored * postcodes to find matches for numerical ranges, and wildcards. + * * @since 2.6.0 - * @param string $postcode Postcode you want to match against stored postcodes - * @param array $objects Array of postcode objects from Database - * @param string $object_id_key DB column name for the ID. + * @param string $postcode Postcode you want to match against stored postcodes. + * @param array $objects Array of postcode objects from Database. + * @param string $object_id_key DB column name for the ID. * @param string $object_compare_key DB column name for the value. - * @param string $country Country from which this postcode belongs. Allows for formatting. + * @param string $country Country from which this postcode belongs. Allows for formatting. * @return array Array of matching object ID and matching values. */ function wc_postcode_location_matcher( $postcode, $objects, $object_id_key, $object_compare_key, $country = '' ) { @@ -1319,7 +1405,7 @@ function wc_postcode_location_matcher( $postcode, $objects, $object_id_key, $obj if ( strstr( $compare_against, '...' ) ) { $range = array_map( 'trim', explode( '...', $compare_against ) ); - if ( 2 !== sizeof( $range ) ) { + if ( 2 !== count( $range ) ) { continue; } @@ -1335,13 +1421,12 @@ function wc_postcode_location_matcher( $postcode, $objects, $object_id_key, $obj } if ( $compare >= $min && $compare <= $max ) { - $matches[ $object_id ] = isset( $matches[ $object_id ] ) ? $matches[ $object_id ]: array(); + $matches[ $object_id ] = isset( $matches[ $object_id ] ) ? $matches[ $object_id ] : array(); $matches[ $object_id ][] = $compare_against; } - - // Wildcard and standard comparison. - } elseif ( in_array( $compare_against, $wildcard_postcodes ) ) { - $matches[ $object_id ] = isset( $matches[ $object_id ] ) ? $matches[ $object_id ]: array(); + } elseif ( in_array( $compare_against, $wildcard_postcodes, true ) ) { + // Wildcard and standard comparison. + $matches[ $object_id ] = isset( $matches[ $object_id ] ) ? $matches[ $object_id ] : array(); $matches[ $object_id ][] = $compare_against; } } @@ -1385,23 +1470,32 @@ function wc_get_shipping_method_count( $include_legacy = false ) { /** * Wrapper for set_time_limit to see if it is enabled. - * @since 2.6.0 * - * @param int $limit + * @since 2.6.0 + * @param int $limit Time limit. */ function wc_set_time_limit( $limit = 0 ) { - if ( function_exists( 'set_time_limit' ) && false === strpos( ini_get( 'disable_functions' ), 'set_time_limit' ) && ! ini_get( 'safe_mode' ) ) { - @set_time_limit( $limit ); + if ( function_exists( 'set_time_limit' ) && false === strpos( ini_get( 'disable_functions' ), 'set_time_limit' ) && ! ini_get( 'safe_mode' ) ) { // phpcs:ignore PHPCompatibility.PHP.DeprecatedIniDirectives.safe_modeDeprecatedRemoved + @set_time_limit( $limit ); // @codingStandardsIgnoreLine } } +/** + * Wrapper for nocache_headers which also disables page caching. + * + * @since 3.2.4 + */ +function wc_nocache_headers() { + WC_Cache_Helper::set_nocache_constants(); + nocache_headers(); +} + /** * Used to sort products attributes with uasort. + * * @since 2.6.0 - * - * @param array $a - * @param array $b - * + * @param array $a First attribute to compare. + * @param array $b Second attribute to compare. * @return int */ function wc_product_attribute_uasort_comparison( $a, $b ) { @@ -1413,11 +1507,10 @@ function wc_product_attribute_uasort_comparison( $a, $b ) { /** * Used to sort shipping zone methods with uasort. + * * @since 3.0.0 - * - * @param array $a - * @param array $b - * + * @param array $a First shipping zone method to compare. + * @param array $b Second shipping zone method to compare. * @return int */ function wc_shipping_zone_method_order_uasort_comparison( $a, $b ) { @@ -1427,6 +1520,21 @@ function wc_shipping_zone_method_order_uasort_comparison( $a, $b ) { return ( $a->method_order < $b->method_order ) ? -1 : 1; } +/** + * Get rounding mode for internal tax calculations. + * + * @since 3.2.4 + * @return int + */ +function wc_get_tax_rounding_mode() { + $constant = WC_TAX_ROUNDING_MODE; + + if ( 'auto' === $constant ) { + return 'yes' === get_option( 'woocommerce_prices_include_tax', 'no' ) ? 2 : 1; + } + + return intval( $constant ); +} /** * Get rounding precision for internal WC calculations. @@ -1443,6 +1551,71 @@ function wc_get_rounding_precision() { return $precision; } +/** + * Add precision to a number and return a number. + * + * @since 3.2.0 + * @param float $value Number to add precision to. + * @param bool $round If should round after adding precision. + * @return int|float + */ +function wc_add_number_precision( $value, $round = true ) { + $cent_precision = pow( 10, wc_get_price_decimals() ); + $value = $value * $cent_precision; + return $round ? round( $value, wc_get_rounding_precision() - wc_get_price_decimals() ) : $value; +} + +/** + * Remove precision from a number and return a float. + * + * @since 3.2.0 + * @param float $value Number to add precision to. + * @return float + */ +function wc_remove_number_precision( $value ) { + $cent_precision = pow( 10, wc_get_price_decimals() ); + return $value / $cent_precision; +} + +/** + * Add precision to an array of number and return an array of int. + * + * @since 3.2.0 + * @param array $value Number to add precision to. + * @param bool $round Should we round after adding precision?. + * @return int|array + */ +function wc_add_number_precision_deep( $value, $round = true ) { + if ( ! is_array( $value ) ) { + return wc_add_number_precision( $value, $round ); + } + + foreach ( $value as $key => $sub_value ) { + $value[ $key ] = wc_add_number_precision_deep( $sub_value, $round ); + } + + return $value; +} + +/** + * Remove precision from an array of number and return an array of int. + * + * @since 3.2.0 + * @param array $value Number to add precision to. + * @return int|array + */ +function wc_remove_number_precision_deep( $value ) { + if ( ! is_array( $value ) ) { + return wc_remove_number_precision( $value ); + } + + foreach ( $value as $key => $sub_value ) { + $value[ $key ] = wc_remove_number_precision_deep( $sub_value ); + } + + return $value; +} + /** * Get a shared logger instance. * @@ -1457,30 +1630,50 @@ function wc_get_rounding_precision() { */ function wc_get_logger() { static $logger = null; - if ( null === $logger ) { - $class = apply_filters( 'woocommerce_logging_class', 'WC_Logger' ); - $implements = class_implements( $class ); - if ( is_array( $implements ) && in_array( 'WC_Logger_Interface', $implements ) ) { - if ( is_object( $class ) ) { - $logger = $class; - } else { - $logger = new $class; - } - } else { - wc_doing_it_wrong( - __FUNCTION__, - sprintf( - __( 'The class %s provided by woocommerce_logging_class filter must implement WC_Logger_Interface.', 'woocommerce' ), - esc_html( is_object( $class ) ? get_class( $class ) : $class ) - ), - '3.0' - ); - $logger = new WC_Logger(); - } + + $class = apply_filters( 'woocommerce_logging_class', 'WC_Logger' ); + + if ( null !== $logger && is_string( $class ) && is_a( $logger, $class ) ) { + return $logger; } + + $implements = class_implements( $class ); + + if ( is_array( $implements ) && in_array( 'WC_Logger_Interface', $implements, true ) ) { + $logger = is_object( $class ) ? $class : new $class(); + } else { + wc_doing_it_wrong( + __FUNCTION__, + sprintf( + /* translators: 1: class name 2: woocommerce_logging_class 3: WC_Logger_Interface */ + __( 'The class %1$s provided by %2$s filter must implement %3$s.', 'woocommerce' ), + '' . esc_html( is_object( $class ) ? get_class( $class ) : $class ) . '', + 'woocommerce_logging_class', + 'WC_Logger_Interface' + ), + '3.0' + ); + + $logger = is_a( $logger, 'WC_Logger' ) ? $logger : new WC_Logger(); + } + return $logger; } +/** + * Trigger logging cleanup using the logging class. + * + * @since 3.4.0 + */ +function wc_cleanup_logs() { + $logger = wc_get_logger(); + + if ( is_callable( array( $logger, 'clear_expired_logs' ) ) ) { + $logger->clear_expired_logs(); + } +} +add_action( 'woocommerce_cleanup_logs', 'wc_cleanup_logs' ); + /** * Prints human-readable information about a variable. * @@ -1490,16 +1683,28 @@ function wc_get_logger() { * @since 3.0 * * @param mixed $expression The expression to be printed. - * @param bool $return Optional. Default false. Set to true to return the human-readable string. + * @param bool $return Optional. Default false. Set to true to return the human-readable string. * @return string|bool False if expression could not be printed. True if the expression was printed. * If $return is true, a string representation will be returned. */ function wc_print_r( $expression, $return = false ) { $alternatives = array( - array( 'func' => 'print_r', 'args' => array( $expression, true ) ), - array( 'func' => 'var_export', 'args' => array( $expression, true ) ), - array( 'func' => 'json_encode', 'args' => array( $expression ) ), - array( 'func' => 'serialize', 'args' => array( $expression ) ), + array( + 'func' => 'print_r', + 'args' => array( $expression, true ), + ), + array( + 'func' => 'var_export', + 'args' => array( $expression, true ), + ), + array( + 'func' => 'json_encode', + 'args' => array( $expression ), + ), + array( + 'func' => 'serialize', + 'args' => array( $expression ), + ), ); $alternatives = apply_filters( 'woocommerce_print_r_alternatives', $alternatives, $expression ); @@ -1509,10 +1714,10 @@ function wc_print_r( $expression, $return = false ) { $res = call_user_func_array( $alternative['func'], $alternative['args'] ); if ( $return ) { return $res; - } else { - echo $res; - return true; } + + echo $res; // WPCS: XSS ok. + return true; } } @@ -1523,13 +1728,12 @@ function wc_print_r( $expression, $return = false ) { * Registers the default log handler. * * @since 3.0 - * @param array $handlers + * @param array $handlers Handlers. * @return array */ function wc_register_default_log_handler( $handlers ) { - if ( defined( 'WC_LOG_HANDLER' ) && class_exists( WC_LOG_HANDLER ) ) { - $handler_class = WC_LOG_HANDLER; + $handler_class = WC_LOG_HANDLER; $default_handler = new $handler_class(); } else { $default_handler = new WC_Log_Handler_File(); @@ -1541,34 +1745,18 @@ function wc_register_default_log_handler( $handlers ) { } add_filter( 'woocommerce_register_log_handlers', 'wc_register_default_log_handler' ); -/** - * Store user agents. Used for tracker. - * @since 3.0.0 - * - * @param string $user_login - * @param int|object $user - */ -function wc_maybe_store_user_agent( $user_login, $user ) { - if ( 'yes' === get_option( 'woocommerce_allow_tracking', 'no' ) && user_can( $user, 'manage_woocommerce' ) ) { - $admin_user_agents = array_filter( (array) get_option( 'woocommerce_tracker_ua', array() ) ); - $admin_user_agents[] = wc_get_user_agent(); - update_option( 'woocommerce_tracker_ua', array_unique( $admin_user_agents ) ); - } -} -add_action( 'wp_login', 'wc_maybe_store_user_agent', 10, 2 ); - /** * Based on wp_list_pluck, this calls a method instead of returning a property. * * @since 3.0.0 - * @param array $list List of objects or arrays - * @param int|string $callback_or_field Callback method from the object to place instead of the entire object - * @param int|string $index_key Optional. Field from the object to use as keys for the new array. - * Default null. + * @param array $list List of objects or arrays. + * @param int|string $callback_or_field Callback method from the object to place instead of the entire object. + * @param int|string $index_key Optional. Field from the object to use as keys for the new array. + * Default null. * @return array Array of values. */ function wc_list_pluck( $list, $callback_or_field, $index_key = null ) { - // Use wp_list_pluck if this isn't a callback + // Use wp_list_pluck if this isn't a callback. $first_el = current( $list ); if ( ! is_object( $first_el ) || ! is_callable( array( $first_el, $callback_or_field ) ) ) { return wp_list_pluck( $list, $callback_or_field, $index_key ); @@ -1590,7 +1778,10 @@ function wc_list_pluck( $list, $callback_or_field, $index_key = null ) { */ $newlist = array(); foreach ( $list as $value ) { - if ( isset( $value->$index_key ) ) { + // Get index. @since 3.2.0 this supports a callback. + if ( is_callable( array( $value, $index_key ) ) ) { + $newlist[ $value->{$index_key}() ] = $value->{$callback_or_field}(); + } elseif ( isset( $value->$index_key ) ) { $newlist[ $value->$index_key ] = $value->{$callback_or_field}(); } else { $newlist[] = $value->{$callback_or_field}(); @@ -1600,33 +1791,38 @@ function wc_list_pluck( $list, $callback_or_field, $index_key = null ) { } /** - * Get permalink settings for WooCommerce independent of the user locale. + * Get permalink settings for things like products and taxonomies. + * + * As of 3.3.0, the permalink settings are stored to the option instead of + * being blank and inheritting from the locale. This speeds up page loading + * times by negating the need to switch locales on each page load. + * + * This is more inline with WP core behavior which does not localize slugs. * * @since 3.0.0 * @return array */ function wc_get_permalink_structure() { - if ( did_action( 'admin_init' ) ) { - wc_switch_to_site_locale(); + $saved_permalinks = (array) get_option( 'woocommerce_permalinks', array() ); + $permalinks = wp_parse_args( + array_filter( $saved_permalinks ), array( + 'product_base' => _x( 'product', 'slug', 'woocommerce' ), + 'category_base' => _x( 'product-category', 'slug', 'woocommerce' ), + 'tag_base' => _x( 'product-tag', 'slug', 'woocommerce' ), + 'attribute_base' => '', + 'use_verbose_page_rules' => false, + ) + ); + + if ( $saved_permalinks !== $permalinks ) { + update_option( 'woocommerce_permalinks', $permalinks ); } - $permalinks = wp_parse_args( (array) get_option( 'woocommerce_permalinks', array() ), array( - 'product_base' => '', - 'category_base' => '', - 'tag_base' => '', - 'attribute_base' => '', - 'use_verbose_page_rules' => false, - ) ); + $permalinks['product_rewrite_slug'] = untrailingslashit( $permalinks['product_base'] ); + $permalinks['category_rewrite_slug'] = untrailingslashit( $permalinks['category_base'] ); + $permalinks['tag_rewrite_slug'] = untrailingslashit( $permalinks['tag_base'] ); + $permalinks['attribute_rewrite_slug'] = untrailingslashit( $permalinks['attribute_base'] ); - // Ensure rewrite slugs are set. - $permalinks['product_rewrite_slug'] = untrailingslashit( empty( $permalinks['product_base'] ) ? _x( 'product', 'slug', 'woocommerce' ) : $permalinks['product_base'] ); - $permalinks['category_rewrite_slug'] = untrailingslashit( empty( $permalinks['category_base'] ) ? _x( 'product-category', 'slug', 'woocommerce' ) : $permalinks['category_base'] ); - $permalinks['tag_rewrite_slug'] = untrailingslashit( empty( $permalinks['tag_base'] ) ? _x( 'product-tag', 'slug', 'woocommerce' ) : $permalinks['tag_base'] ); - $permalinks['attribute_rewrite_slug'] = untrailingslashit( empty( $permalinks['attribute_base'] ) ? '' : $permalinks['attribute_base'] ); - - if ( did_action( 'admin_init' ) ) { - wc_restore_locale(); - } return $permalinks; } @@ -1678,17 +1874,265 @@ function wc_restore_locale() { function wc_make_phone_clickable( $phone ) { $number = trim( preg_replace( '/[^\d|\+]/', '', $phone ) ); - return '' . esc_html( $phone ) . ''; + return $number ? '' . esc_html( $phone ) . '' : ''; } /** * Get an item of post data if set, otherwise return a default value. * * @since 3.0.9 - * @param string $key - * @param string $default - * @return mixed value sanitized by wc_clean + * @param string $key Meta key. + * @param string $default Default value. + * @return mixed Value sanitized by wc_clean. */ function wc_get_post_data_by_key( $key, $default = '' ) { - return wc_clean( isset( $_POST[ $key ] ) ? $_POST[ $key ] : $default ); + return wc_clean( wp_unslash( wc_get_var( $_POST[ $key ], $default ) ) ); // @codingStandardsIgnoreLine +} + +/** + * Get data if set, otherwise return a default value or null. Prevents notices when data is not set. + * + * @since 3.2.0 + * @param mixed $var Variable. + * @param string $default Default value. + * @return mixed + */ +function wc_get_var( &$var, $default = null ) { + return isset( $var ) ? $var : $default; +} + +/** + * Read in WooCommerce headers when reading plugin headers. + * + * @since 3.2.0 + * @param array $headers Headers. + * @return array + */ +function wc_enable_wc_plugin_headers( $headers ) { + if ( ! class_exists( 'WC_Plugin_Updates' ) ) { + include_once dirname( __FILE__ ) . '/admin/plugin-updates/class-wc-plugin-updates.php'; + } + + $headers['WCRequires'] = WC_Plugin_Updates::VERSION_REQUIRED_HEADER; + $headers['WCTested'] = WC_Plugin_Updates::VERSION_TESTED_HEADER; + return $headers; +} +add_filter( 'extra_plugin_headers', 'wc_enable_wc_plugin_headers' ); + +/** + * Prevent auto-updating the WooCommerce plugin on major releases if there are untested extensions active. + * + * @since 3.2.0 + * @param bool $should_update If should update. + * @param object $plugin Plugin data. + * @return bool + */ +function wc_prevent_dangerous_auto_updates( $should_update, $plugin ) { + if ( ! isset( $plugin->plugin, $plugin->new_version ) ) { + return $should_update; + } + + if ( 'woocommerce/woocommerce.php' !== $plugin->plugin ) { + return $should_update; + } + + if ( ! class_exists( 'WC_Plugin_Updates' ) ) { + include_once dirname( __FILE__ ) . '/admin/plugin-updates/class-wc-plugin-updates.php'; + } + + $new_version = wc_clean( $plugin->new_version ); + $plugin_updates = new WC_Plugin_Updates(); + $untested_plugins = $plugin_updates->get_untested_plugins( $new_version, 'major' ); + if ( ! empty( $untested_plugins ) ) { + return false; + } + + return $should_update; +} +add_filter( 'auto_update_plugin', 'wc_prevent_dangerous_auto_updates', 99, 2 ); + +/** + * Delete expired transients. + * + * Deletes all expired transients. The multi-table delete syntax is used. + * to delete the transient record from table a, and the corresponding. + * transient_timeout record from table b. + * + * Based on code inside core's upgrade_network() function. + * + * @since 3.2.0 + * @return int Number of transients that were cleared. + */ +function wc_delete_expired_transients() { + global $wpdb; + + $sql = "DELETE a, b FROM $wpdb->options a, $wpdb->options b + WHERE a.option_name LIKE %s + AND a.option_name NOT LIKE %s + AND b.option_name = CONCAT( '_transient_timeout_', SUBSTRING( a.option_name, 12 ) ) + AND b.option_value < %d"; + $rows = $wpdb->query( $wpdb->prepare( $sql, $wpdb->esc_like( '_transient_' ) . '%', $wpdb->esc_like( '_transient_timeout_' ) . '%', time() ) ); // WPCS: unprepared SQL ok. + + $sql = "DELETE a, b FROM $wpdb->options a, $wpdb->options b + WHERE a.option_name LIKE %s + AND a.option_name NOT LIKE %s + AND b.option_name = CONCAT( '_site_transient_timeout_', SUBSTRING( a.option_name, 17 ) ) + AND b.option_value < %d"; + $rows2 = $wpdb->query( $wpdb->prepare( $sql, $wpdb->esc_like( '_site_transient_' ) . '%', $wpdb->esc_like( '_site_transient_timeout_' ) . '%', time() ) ); // WPCS: unprepared SQL ok. + + return absint( $rows + $rows2 ); +} +add_action( 'woocommerce_installed', 'wc_delete_expired_transients' ); + +/** + * Make a URL relative, if possible. + * + * @since 3.2.0 + * @param string $url URL to make relative. + * @return string + */ +function wc_get_relative_url( $url ) { + return wc_is_external_resource( $url ) ? $url : str_replace( array( 'http://', 'https://' ), '//', $url ); +} + +/** + * See if a resource is remote. + * + * @since 3.2.0 + * @param string $url URL to check. + * @return bool + */ +function wc_is_external_resource( $url ) { + $wp_base = str_replace( array( 'http://', 'https://' ), '//', get_home_url( null, '/', 'http' ) ); + + return strstr( $url, '://' ) && ! strstr( $url, $wp_base ); +} + +/** + * See if theme/s is activate or not. + * + * @since 3.3.0 + * @param string|array $theme Theme name or array of theme names to check. + * @return boolean + */ +function wc_is_active_theme( $theme ) { + return is_array( $theme ) ? in_array( get_template(), $theme, true ) : get_template() === $theme; +} + +/** + * Cleans up session data - cron callback. + * + * @since 3.3.0 + */ +function wc_cleanup_session_data() { + $session_class = apply_filters( 'woocommerce_session_handler', 'WC_Session_Handler' ); + $session = new $session_class(); + + if ( is_callable( array( $session, 'cleanup_sessions' ) ) ) { + $session->cleanup_sessions(); + } +} +add_action( 'woocommerce_cleanup_sessions', 'wc_cleanup_session_data' ); + +/** + * Convert a decimal (e.g. 3.5) to a fraction (e.g. 7/2). + * From: https://www.designedbyaturtle.co.uk/2015/converting-a-decimal-to-a-fraction-in-php/ + * + * @param float $decimal the decimal number. + * @return array|bool a 1/2 would be [1, 2] array (this can be imploded with '/' to form a string). + */ +function wc_decimal_to_fraction( $decimal ) { + if ( 0 > $decimal || ! is_numeric( $decimal ) ) { + // Negative digits need to be passed in as positive numbers and prefixed as negative once the response is imploded. + return false; + } + + if ( 0 === $decimal ) { + return array( 0, 1 ); + } + + $tolerance = 1.e-4; + $numerator = 1; + $h2 = 0; + $denominator = 0; + $k2 = 1; + $b = 1 / $decimal; + + do { + $b = 1 / $b; + $a = floor( $b ); + $aux = $numerator; + $numerator = $a * $numerator + $h2; + $h2 = $aux; + $aux = $denominator; + $denominator = $a * $denominator + $k2; + $k2 = $aux; + $b = $b - $a; + } while ( abs( $decimal - $numerator / $denominator ) > $decimal * $tolerance ); + + return array( $numerator, $denominator ); +} + +/** + * Round discount. + * + * @param double $value Amount to round. + * @param int $precision DP to round. + * @return float + */ +function wc_round_discount( $value, $precision ) { + if ( version_compare( PHP_VERSION, '5.3.0', '>=' ) ) { + return round( $value, $precision, WC_DISCOUNT_ROUNDING_MODE ); // phpcs:ignore PHPCompatibility.PHP.NewFunctionParameters.round_modeFound + } + + if ( 2 === WC_DISCOUNT_ROUNDING_MODE ) { + return wc_legacy_round_half_down( $value, $precision ); + } + + return round( $value, $precision ); +} + +/** + * Return the html selected attribute if stringified $value is found in array of stringified $options + * or if stringified $value is the same as scalar stringified $options. + * + * @param string|int $value Value to find within options. + * @param string|int|array $options Options to go through when looking for value. + * @return string + */ +function wc_selected( $value, $options ) { + if ( is_array( $options ) ) { + $options = array_map( 'strval', $options ); + return selected( in_array( (string) $value, $options, true ), true, false ); + } + + return selected( $value, $options, false ); +} + +/** + * Retrieves the MySQL server version. Based on $wpdb. + * + * @since 3.4.1 + * @return array Vesion information. + */ +function wc_get_server_database_version() { + global $wpdb; + + if ( empty( $wpdb->is_mysql ) ) { + return array( + 'string' => '', + 'number' => '', + ); + } + + if ( $wpdb->use_mysqli ) { + $server_info = mysqli_get_server_info( $wpdb->dbh ); // @codingStandardsIgnoreLine. + } else { + $server_info = mysql_get_server_info( $wpdb->dbh ); // @codingStandardsIgnoreLine. + } + + return array( + 'string' => $server_info, + 'number' => preg_replace( '/([^\d.]+).*/', '', $server_info ), + ); } diff --git a/includes/wc-coupon-functions.php b/includes/wc-coupon-functions.php index 8effeb08cc0..b2e9950b5cd 100644 --- a/includes/wc-coupon-functions.php +++ b/includes/wc-coupon-functions.php @@ -1,36 +1,34 @@ __( 'Percentage discount', 'woocommerce' ), - 'fixed_cart' => __( 'Fixed cart discount', 'woocommerce' ), - 'fixed_product' => __( 'Fixed product discount', 'woocommerce' ), - ) ); + return (array) apply_filters( + 'woocommerce_coupon_discount_types', array( + 'percent' => __( 'Percentage discount', 'woocommerce' ), + 'fixed_cart' => __( 'Fixed cart discount', 'woocommerce' ), + 'fixed_product' => __( 'Fixed product discount', 'woocommerce' ), + ) + ); } /** * Get a coupon type's name. * - * @param string $type (default: '') + * @param string $type Coupon type. * @return string */ function wc_get_coupon_type( $type = '' ) { @@ -86,8 +84,8 @@ function wc_get_coupon_code_by_id( $id ) { * Get coupon code by ID. * * @since 3.0.0 - * @param string $code - * @param int $exclude Used to exclude an ID from the check if you're checking existence. + * @param string $code Coupon code. + * @param int $exclude Used to exclude an ID from the check if you're checking existence. * @return int */ function wc_get_coupon_id_by_code( $code, $exclude = 0 ) { diff --git a/includes/wc-deprecated-functions.php b/includes/wc-deprecated-functions.php index e4c9744f835..18ce91b1be2 100644 --- a/includes/wc-deprecated-functions.php +++ b/includes/wc-deprecated-functions.php @@ -4,10 +4,10 @@ * * Where functions come to die. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.1.0 + * @author Automattic + * @category Core + * @package WooCommerce\Functions + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { @@ -17,28 +17,32 @@ if ( ! defined( 'ABSPATH' ) ) { /** * Runs a deprecated action with notice only if used. * - * @since 3.0.0 - * @param string $action - * @param array $args - * @param string $deprecated_in - * @param string $replacement + * @since 3.0.0 + * @param string $tag The name of the action hook. + * @param array $args Array of additional function arguments to be passed to do_action(). + * @param string $version The version of WooCommerce that deprecated the hook. + * @param string $replacement The hook that should have been used. + * @param string $message A message regarding the change. */ -function wc_do_deprecated_action( $action, $args, $deprecated_in, $replacement ) { - if ( has_action( $action ) ) { - wc_deprecated_function( 'Action: ' . $action, $deprecated_in, $replacement ); - do_action_ref_array( $action, $args ); +function wc_do_deprecated_action( $tag, $args, $version, $replacement = null, $message = null ) { + if ( ! has_action( $tag ) ) { + return; } + + wc_deprecated_hook( $tag, $version, $replacement, $message ); + do_action_ref_array( $tag, $args ); } /** * Wrapper for deprecated functions so we can apply some extra logic. * - * @since 3.0.0 - * @param string $function - * @param string $version - * @param string $replacement + * @since 3.0.0 + * @param string $function Function used. + * @param string $version Version the message was added in. + * @param string $replacement Replacement for the called function. */ function wc_deprecated_function( $function, $version, $replacement = null ) { + // @codingStandardsIgnoreStart if ( is_ajax() ) { do_action( 'deprecated_function_run', $function, $replacement, $version ); $log_string = "The {$function} function is deprecated since version {$version}."; @@ -47,18 +51,62 @@ function wc_deprecated_function( $function, $version, $replacement = null ) { } else { _deprecated_function( $function, $version, $replacement ); } + // @codingStandardsIgnoreEnd } +/** + * Wrapper for deprecated hook so we can apply some extra logic. + * + * @since 3.3.0 + * @param string $hook The hook that was used. + * @param string $version The version of WordPress that deprecated the hook. + * @param string $replacement The hook that should have been used. + * @param string $message A message regarding the change. + */ +function wc_deprecated_hook( $hook, $version, $replacement = null, $message = null ) { + // @codingStandardsIgnoreStart + if ( is_ajax() ) { + do_action( 'deprecated_hook_run', $hook, $replacement, $version, $message ); + + $message = empty( $message ) ? '' : ' ' . $message; + $log_string = "{$hook} is deprecated since version {$version}"; + $log_string .= $replacement ? "! Use {$replacement} instead." : ' with no alternative available.'; + + error_log( $log_string . $message ); + } else { + _deprecated_hook( $hook, $version, $replacement, $message ); + } + // @codingStandardsIgnoreEnd +} + +/** + * When catching an exception, this allows us to log it if unexpected. + * + * @since 3.3.0 + * @param Exception $exception_object The exception object. + * @param string $function The function which threw exception. + * @param array $args The args passed to the function. + */ +function wc_caught_exception( $exception_object, $function = '', $args = array() ) { + // @codingStandardsIgnoreStart + $message = $exception_object->getMessage(); + $message .= '. Args: ' . print_r( $args, true ) . '.'; + + do_action( 'woocommerce_caught_exception', $exception_object, $function, $args ); + error_log( "Exception caught in {$function}. {$message}." ); + // @codingStandardsIgnoreEnd +} /** * Wrapper for wc_doing_it_wrong. * * @since 3.0.0 - * @param string $function - * @param string $version - * @param string $replacement + * @param string $function Function used. + * @param string $message Message to log. + * @param string $version Version the message was added in. */ function wc_doing_it_wrong( $function, $message, $version ) { + // @codingStandardsIgnoreStart $message .= ' Backtrace: ' . wp_debug_backtrace_summary(); if ( is_ajax() ) { @@ -67,6 +115,7 @@ function wc_doing_it_wrong( $function, $message, $version ) { } else { _doing_it_wrong( $function, $message, $version ); } + // @codingStandardsIgnoreEnd } /** @@ -788,7 +837,7 @@ function woocommerce_placeholder_img_src() { /** * @deprecated 3.0 */ -function woocommerce_placeholder_img( $size = 'shop_thumbnail' ) { +function woocommerce_placeholder_img( $size = 'woocommerce_thumbnail' ) { wc_deprecated_function( __FUNCTION__, '3.0', 'wc_placeholder_img' ); return wc_placeholder_img( $size ); } @@ -951,3 +1000,15 @@ function wc_get_customer_avatar_url( $email ) { return get_avatar_url( $email ); } + +/** + * WooCommerce Core Supported Themes. + * + * @deprecated 3.3.0 + * @since 2.2 + * @return string[] + */ +function wc_get_core_supported_themes() { + wc_deprecated_function( 'wc_get_core_supported_themes()', '3.3' ); + return array( 'twentyseventeen', 'twentysixteen', 'twentyfifteen', 'twentyfourteen', 'twentythirteen', 'twentyeleven', 'twentytwelve', 'twentyten' ); +} diff --git a/includes/wc-formatting-functions.php b/includes/wc-formatting-functions.php index 023eb96c2fa..0c8d439b70a 100644 --- a/includes/wc-formatting-functions.php +++ b/includes/wc-formatting-functions.php @@ -4,20 +4,17 @@ * * Functions for formatting data. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.1.0 + * @package WooCommerce/Functions + * @version 2.1.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; /** - * Converts a string (e.g. yes or no) to a bool. + * Converts a string (e.g. 'yes' or 'no') to a bool. + * * @since 3.0.0 - * @param string $string + * @param string $string String to convert. * @return bool */ function wc_string_to_bool( $string ) { @@ -25,10 +22,11 @@ function wc_string_to_bool( $string ) { } /** - * Converts a bool to a string. + * Converts a bool to a 'yes' or 'no'. + * * @since 3.0.0 - * @param bool $bool - * @return string yes or no + * @param bool $bool String to convert. + * @return string */ function wc_bool_to_string( $bool ) { if ( ! is_bool( $bool ) ) { @@ -39,9 +37,10 @@ function wc_bool_to_string( $bool ) { /** * Explode a string into an array by $delimiter and remove empty values. + * * @since 3.0.0 - * @param string $string - * @param string $delimiter + * @param string $string String to convert. + * @param string $delimiter Delimiter, defaults to ','. * @return array */ function wc_string_to_array( $string, $delimiter = ',' ) { @@ -50,10 +49,9 @@ function wc_string_to_array( $string, $delimiter = ',' ) { /** * Sanitize taxonomy names. Slug format (no spaces, lowercase). + * Urldecode is used to reverse munging of UTF8 characters. * - * urldecode is used to reverse munging of UTF8 characters. - * - * @param mixed $taxonomy + * @param string $taxonomy Taxonomy name. * @return string */ function wc_sanitize_taxonomy_name( $taxonomy ) { @@ -66,7 +64,7 @@ function wc_sanitize_taxonomy_name( $taxonomy ) { * Cannot use wc_clean because it sometimes strips % chars and breaks the user's setting. * * @since 2.6.0 - * @param string $value + * @param string $value Permalink. * @return string */ function wc_sanitize_permalink( $value ) { @@ -78,7 +76,7 @@ function wc_sanitize_permalink( $value ) { $value = ''; } - $value = esc_url_raw( $value ); + $value = esc_url_raw( trim( $value ) ); $value = str_replace( 'http://', '', $value ); return untrailingslashit( $value ); } @@ -86,11 +84,11 @@ function wc_sanitize_permalink( $value ) { /** * Gets the filename part of a download URL. * - * @param string $file_url + * @param string $file_url File URL. * @return string */ function wc_get_filename_from_url( $file_url ) { - $parts = parse_url( $file_url ); + $parts = wp_parse_url( $file_url ); if ( isset( $parts['path'] ) ) { return basename( $parts['path'] ); } @@ -100,12 +98,15 @@ function wc_get_filename_from_url( $file_url ) { * Normalise dimensions, unify to cm then convert to wanted unit value. * * Usage: - * wc_get_dimension(55, 'in'); - * wc_get_dimension(55, 'in', 'm'); + * wc_get_dimension( 55, 'in' ); + * wc_get_dimension( 55, 'in', 'm' ); * - * @param int|float $dimension - * @param string $to_unit 'in', 'm', 'cm', 'm' - * @param string $from_unit (optional) 'in', 'm', 'cm', 'm' + * @param int|float $dimension Dimension. + * @param string $to_unit Unit to convert to. + * Options: 'in', 'm', 'cm', 'm'. + * @param string $from_unit Unit to convert from. + * Defaults to ''. + * Options: 'in', 'm', 'cm', 'm'. * @return float */ function wc_get_dimension( $dimension, $to_unit, $from_unit = '' ) { @@ -118,32 +119,32 @@ function wc_get_dimension( $dimension, $to_unit, $from_unit = '' ) { // Unify all units to cm first. if ( $from_unit !== $to_unit ) { switch ( $from_unit ) { - case 'in' : + case 'in': $dimension *= 2.54; break; - case 'm' : + case 'm': $dimension *= 100; break; - case 'mm' : + case 'mm': $dimension *= 0.1; break; - case 'yd' : + case 'yd': $dimension *= 91.44; break; } // Output desired unit. switch ( $to_unit ) { - case 'in' : + case 'in': $dimension *= 0.3937; break; - case 'm' : + case 'm': $dimension *= 0.01; break; - case 'mm' : + case 'mm': $dimension *= 10; break; - case 'yd' : + case 'yd': $dimension *= 0.010936133; break; } @@ -159,9 +160,12 @@ function wc_get_dimension( $dimension, $to_unit, $from_unit = '' ) { * wc_get_weight(55, 'kg'); * wc_get_weight(55, 'kg', 'lbs'); * - * @param int|float $weight - * @param string $to_unit 'g', 'kg', 'lbs', 'oz' - * @param string $from_unit (optional) 'g', 'kg', 'lbs', 'oz' + * @param int|float $weight Weight. + * @param string $to_unit Unit to convert to. + * Options: 'g', 'kg', 'lbs', 'oz'. + * @param string $from_unit Unit to convert from. + * Defaults to ''. + * Options: 'g', 'kg', 'lbs', 'oz'. * @return float */ function wc_get_weight( $weight, $to_unit, $from_unit = '' ) { @@ -175,26 +179,26 @@ function wc_get_weight( $weight, $to_unit, $from_unit = '' ) { // Unify all units to kg first. if ( $from_unit !== $to_unit ) { switch ( $from_unit ) { - case 'g' : + case 'g': $weight *= 0.001; break; - case 'lbs' : + case 'lbs': $weight *= 0.453592; break; - case 'oz' : + case 'oz': $weight *= 0.0283495; break; } // Output desired unit. switch ( $to_unit ) { - case 'g' : + case 'g': $weight *= 1000; break; - case 'lbs' : + case 'lbs': $weight *= 2.20462; break; - case 'oz' : + case 'oz': $weight *= 35.274; break; } @@ -206,7 +210,7 @@ function wc_get_weight( $weight, $to_unit, $from_unit = '' ) { /** * Trim trailing zeros off prices. * - * @param mixed $price + * @param string|float|int $price Price. * @return string */ function wc_trim_zeros( $price ) { @@ -216,26 +220,52 @@ function wc_trim_zeros( $price ) { /** * Round a tax amount. * - * @param mixed $tax - * @return double + * @param double $value Amount to round. + * @param int $precision DP to round. Defaults to wc_get_price_decimals. + * @return float */ -function wc_round_tax_total( $tax ) { - $dp = wc_get_price_decimals(); +function wc_round_tax_total( $value, $precision = null ) { + $precision = is_null( $precision ) ? wc_get_price_decimals() : intval( $precision ); - // @codeCoverageIgnoreStart - if ( version_compare( phpversion(), '5.3', '<' ) ) { - $rounded_tax = round( $tax, $dp ); + if ( version_compare( PHP_VERSION, '5.3.0', '>=' ) ) { + $rounded_tax = round( $value, $precision, wc_get_tax_rounding_mode() ); // phpcs:ignore PHPCompatibility.PHP.NewFunctionParameters.round_modeFound + } elseif ( 2 === wc_get_tax_rounding_mode() ) { + $rounded_tax = wc_legacy_round_half_down( $value, $precision ); } else { - // @codeCoverageIgnoreEnd - $rounded_tax = round( $tax, $dp, WC_TAX_ROUNDING_MODE ); + $rounded_tax = round( $value, $precision ); } - return apply_filters( 'wc_round_tax_total', $rounded_tax, $tax, $dp, WC_TAX_ROUNDING_MODE ); + + return apply_filters( 'wc_round_tax_total', $rounded_tax, $value, $precision, WC_TAX_ROUNDING_MODE ); +} + +/** + * Round half down in PHP 5.2. + * + * @since 3.2.6 + * @param float $value Value to round. + * @param int $precision Precision to round down to. + * @return float + */ +function wc_legacy_round_half_down( $value, $precision ) { + $value = wc_float_to_string( $value ); + + if ( false !== strstr( $value, '.' ) ) { + $value = explode( '.', $value ); + + if ( strlen( $value[1] ) > $precision && substr( $value[1], -1 ) === '5' ) { + $value[1] = substr( $value[1], 0, -1 ) . '4'; + } + + $value = implode( '.', $value ); + } + + return round( floatval( $value ), $precision ); } /** * Make a refund total negative. * - * @param float $amount + * @param float $amount Refunded amount. * * @return float */ @@ -250,9 +280,9 @@ function wc_format_refund_total( $amount ) { * * This function does not remove thousands - this should be done before passing a value to the function. * - * @param float|string $number Expects either a float or a string with a decimal separator only (no thousands) - * @param mixed $dp number of decimal points to use, blank to use woocommerce_price_num_decimals, or false to avoid all rounding. - * @param bool $trim_zeros from end of string + * @param float|string $number Expects either a float or a string with a decimal separator only (no thousands). + * @param mixed $dp number Number of decimal points to use, blank to use woocommerce_price_num_decimals, or false to avoid all rounding. + * @param bool $trim_zeros From end of string. * @return string */ function wc_format_decimal( $number, $dp = false, $trim_zeros = false ) { @@ -266,12 +296,13 @@ function wc_format_decimal( $number, $dp = false, $trim_zeros = false ) { } if ( false !== $dp ) { - $dp = intval( '' == $dp ? wc_get_price_decimals() : $dp ); + $dp = intval( '' === $dp ? wc_get_price_decimals() : $dp ); $number = number_format( floatval( $number ), $dp, '.', '' ); - - // DP is false - don't use number format, just return a string in our format } elseif ( is_float( $number ) ) { - $number = wc_clean( str_replace( $decimals, '.', strval( $number ) ) ); + // DP is false - don't use number format, just return a string using whatever is given. Remove scientific notation using sprintf. + $number = str_replace( $decimals, '.', sprintf( '%.' . wc_get_rounding_precision() . 'f', $number ) ); + // We already had a float, so trailing zeros are not needed. + $trim_zeros = true; } if ( $trim_zeros && strstr( $number, '.' ) ) { @@ -283,7 +314,8 @@ function wc_format_decimal( $number, $dp = false, $trim_zeros = false ) { /** * Convert a float to a string without locale formatting which PHP adds when changing floats to strings. - * @param float $float + * + * @param float $float Float value to format. * @return string */ function wc_float_to_string( $float ) { @@ -300,7 +332,8 @@ function wc_float_to_string( $float ) { /** * Format a price with WC Currency Locale settings. - * @param string $value + * + * @param string $value Price to localize. * @return string */ function wc_format_localized_price( $value ) { @@ -309,7 +342,8 @@ function wc_format_localized_price( $value ) { /** * Format a decimal with PHP Locale settings. - * @param string $value + * + * @param string $value Decimal to localize. * @return string */ function wc_format_localized_decimal( $value ) { @@ -321,7 +355,7 @@ function wc_format_localized_decimal( $value ) { * Format a coupon code. * * @since 3.0.0 - * @param string $value + * @param string $value Coupon code to format. * @return string */ function wc_format_coupon_code( $value ) { @@ -331,7 +365,8 @@ function wc_format_coupon_code( $value ) { /** * Clean variables using sanitize_text_field. Arrays are cleaned recursively. * Non-scalar values are ignored. - * @param string|array $var + * + * @param string|array $var Data to sanitize. * @return string|array */ function wc_clean( $var ) { @@ -342,10 +377,25 @@ function wc_clean( $var ) { } } +/** + * wp_check_invalid_utf8 with recursive array support. + * + * @param string|array $var Data to sanitize. + * @return string|array + */ +function wc_check_invalid_utf8( $var ) { + if ( is_array( $var ) ) { + return array_map( 'wc_check_invalid_utf8', $var ); + } else { + return wp_check_invalid_utf8( $var ); + } +} + /** * Run wc_clean over posted textarea but maintain line breaks. + * * @since 3.0.0 - * @param string $var + * @param string $var Data to sanitize. * @return string */ function wc_sanitize_textarea( $var ) { @@ -355,29 +405,33 @@ function wc_sanitize_textarea( $var ) { /** * Sanitize a string destined to be a tooltip. * - * @since 2.3.10 Tooltips are encoded with htmlspecialchars to prevent XSS. Should not be used in conjunction with esc_attr() - * @param string $var + * @since 2.3.10 Tooltips are encoded with htmlspecialchars to prevent XSS. Should not be used in conjunction with esc_attr() + * @param string $var Data to sanitize. * @return string */ function wc_sanitize_tooltip( $var ) { - return htmlspecialchars( wp_kses( html_entity_decode( $var ), array( - 'br' => array(), - 'em' => array(), - 'strong' => array(), - 'small' => array(), - 'span' => array(), - 'ul' => array(), - 'li' => array(), - 'ol' => array(), - 'p' => array(), - ) ) ); + return htmlspecialchars( + wp_kses( + html_entity_decode( $var ), array( + 'br' => array(), + 'em' => array(), + 'strong' => array(), + 'small' => array(), + 'span' => array(), + 'ul' => array(), + 'li' => array(), + 'ol' => array(), + 'p' => array(), + ) + ) + ); } /** * Merge two arrays. * - * @param array $a1 - * @param array $a2 + * @param array $a1 First array to merge. + * @param array $a2 Second array to merge. * @return array */ function wc_array_overlay( $a1, $a2 ) { @@ -396,7 +450,8 @@ function wc_array_overlay( $a1, $a2 ) { /** * Formats a stock amount by running it through a filter. - * @param int|float $amount + * + * @param int|float $amount Stock amount. * @return int|float */ function wc_stock_amount( $amount ) { @@ -410,21 +465,21 @@ function wc_stock_amount( $amount ) { */ function get_woocommerce_price_format() { $currency_pos = get_option( 'woocommerce_currency_pos' ); - $format = '%1$s%2$s'; + $format = '%1$s%2$s'; switch ( $currency_pos ) { - case 'left' : + case 'left': $format = '%1$s%2$s'; - break; - case 'right' : + break; + case 'right': $format = '%2$s%1$s'; - break; - case 'left_space' : + break; + case 'left_space': $format = '%1$s %2$s'; - break; - case 'right_space' : + break; + case 'right_space': $format = '%2$s %1$s'; - break; + break; } return apply_filters( 'woocommerce_price_format', $format, $currency_pos ); @@ -432,16 +487,17 @@ function get_woocommerce_price_format() { /** * Return the thousand separator for prices. + * * @since 2.3 * @return string */ function wc_get_price_thousand_separator() { - $separator = apply_filters( 'wc_get_price_thousand_separator', get_option( 'woocommerce_price_thousand_sep' ) ); - return stripslashes( $separator ); + return stripslashes( apply_filters( 'wc_get_price_thousand_separator', get_option( 'woocommerce_price_thousand_sep' ) ) ); } /** * Return the decimal separator for prices. + * * @since 2.3 * @return string */ @@ -452,71 +508,107 @@ function wc_get_price_decimal_separator() { /** * Return the number of decimals after the decimal point. + * * @since 2.3 * @return int */ function wc_get_price_decimals() { - $decimals = apply_filters( 'wc_get_price_decimals', get_option( 'woocommerce_price_num_decimals', 2 ) ); - return absint( $decimals ); + return absint( apply_filters( 'wc_get_price_decimals', get_option( 'woocommerce_price_num_decimals', 2 ) ) ); } /** * Format the price with a currency symbol. * - * @param float $price - * @param array $args (default: array()) + * @param float $price Raw price. + * @param array $args Arguments to format a price { + * Array of arguments. + * Defaults to empty array. + * + * @type bool $ex_tax_label Adds exclude tax label. + * Defaults to false. + * @type string $currency Currency code. + * Defaults to empty string (Use the result from get_woocommerce_currency()). + * @type string $decimal_separator Decimal separator. + * Defaults the result of wc_get_price_decimal_separator(). + * @type string $thousand_separator Thousand separator. + * Defaults the result of wc_get_price_thousand_separator(). + * @type string $decimals Number of decimals. + * Defaults the result of wc_get_price_decimals(). + * @type string $price_format Price format depending on the currency position. + * Defaults the result of get_woocommerce_price_format(). + * } * @return string */ function wc_price( $price, $args = array() ) { - extract( apply_filters( 'wc_price_args', wp_parse_args( $args, array( - 'ex_tax_label' => false, - 'currency' => '', - 'decimal_separator' => wc_get_price_decimal_separator(), - 'thousand_separator' => wc_get_price_thousand_separator(), - 'decimals' => wc_get_price_decimals(), - 'price_format' => get_woocommerce_price_format(), - ) ) ) ); + $args = apply_filters( + 'wc_price_args', wp_parse_args( + $args, array( + 'ex_tax_label' => false, + 'currency' => '', + 'decimal_separator' => wc_get_price_decimal_separator(), + 'thousand_separator' => wc_get_price_thousand_separator(), + 'decimals' => wc_get_price_decimals(), + 'price_format' => get_woocommerce_price_format(), + ) + ) + ); - $negative = $price < 0; - $price = apply_filters( 'raw_woocommerce_price', floatval( $negative ? $price * -1 : $price ) ); - $price = apply_filters( 'formatted_woocommerce_price', number_format( $price, $decimals, $decimal_separator, $thousand_separator ), $price, $decimals, $decimal_separator, $thousand_separator ); + $unformatted_price = $price; + $negative = $price < 0; + $price = apply_filters( 'raw_woocommerce_price', floatval( $negative ? $price * -1 : $price ) ); + $price = apply_filters( 'formatted_woocommerce_price', number_format( $price, $args['decimals'], $args['decimal_separator'], $args['thousand_separator'] ), $price, $args['decimals'], $args['decimal_separator'], $args['thousand_separator'] ); - if ( apply_filters( 'woocommerce_price_trim_zeros', false ) && $decimals > 0 ) { + if ( apply_filters( 'woocommerce_price_trim_zeros', false ) && $args['decimals'] > 0 ) { $price = wc_trim_zeros( $price ); } - $formatted_price = ( $negative ? '-' : '' ) . sprintf( $price_format, '' . get_woocommerce_currency_symbol( $currency ) . '', $price ); + $formatted_price = ( $negative ? '-' : '' ) . sprintf( $args['price_format'], '' . get_woocommerce_currency_symbol( $args['currency'] ) . '', $price ); $return = '' . $formatted_price . ''; - if ( $ex_tax_label && wc_tax_enabled() ) { + if ( $args['ex_tax_label'] && wc_tax_enabled() ) { $return .= ' ' . WC()->countries->ex_tax_or_vat() . ''; } - return apply_filters( 'wc_price', $return, $price, $args ); + /** + * Filters the string of price markup. + * + * @param string $return Price HTML markup. + * @param string $price Formatted price. + * @param array $args Pass on the args. + * @param float $unformatted_price Price as float to allow plugins custom formatting. Since 3.2.0. + */ + return apply_filters( 'wc_price', $return, $price, $args, $unformatted_price ); } /** - * let_to_num function. + * Notation to numbers. * * This function transforms the php.ini notation for numbers (like '2M') to an integer. * - * @param $size + * @param string $size Size value. * @return int */ function wc_let_to_num( $size ) { - $l = substr( $size, -1 ); - $ret = substr( $size, 0, -1 ); + $l = substr( $size, -1 ); + $ret = substr( $size, 0, -1 ); + $byte = 1024; + switch ( strtoupper( $l ) ) { case 'P': $ret *= 1024; + // No break. case 'T': $ret *= 1024; + // No break. case 'G': $ret *= 1024; + // No break. case 'M': $ret *= 1024; + // No break. case 'K': $ret *= 1024; + // No break. } return $ret; } @@ -545,10 +637,8 @@ function wc_time_format() { * Based on wcs_strtotime_dark_knight() from WC Subscriptions by Prospress. * * @since 3.0.0 - * - * @param string $time_string - * @param int|null $from_timestamp - * + * @param string $time_string Time string. + * @param int|null $from_timestamp Timestamp to convert from. * @return int */ function wc_string_to_timestamp( $time_string, $from_timestamp = null ) { @@ -573,7 +663,7 @@ function wc_string_to_timestamp( $time_string, $from_timestamp = null ) { * Convert a date string to a WC_DateTime. * * @since 3.1.0 - * @param string $time_string + * @param string $time_string Time string. * @return WC_DateTime */ function wc_string_to_datetime( $time_string ) { @@ -584,7 +674,7 @@ function wc_string_to_datetime( $time_string ) { } else { $timestamp = wc_string_to_timestamp( get_gmt_from_date( gmdate( 'Y-m-d H:i:s', wc_string_to_timestamp( $time_string ) ) ) ); } - $datetime = new WC_DateTime( "@{$timestamp}", new DateTimeZone( 'UTC' ) ); + $datetime = new WC_DateTime( "@{$timestamp}", new DateTimeZone( 'UTC' ) ); // Set local timezone or offset. if ( get_option( 'timezone_string' ) ) { @@ -606,26 +696,28 @@ function wc_string_to_datetime( $time_string ) { * @return string PHP timezone string for the site */ function wc_timezone_string() { - - // if site timezone string exists, return it - if ( $timezone = get_option( 'timezone_string' ) ) { + // If site timezone string exists, return it. + $timezone = get_option( 'timezone_string' ); + if ( $timezone ) { return $timezone; } - // get UTC offset, if it isn't set then return UTC - if ( 0 === ( $utc_offset = intval( get_option( 'gmt_offset', 0 ) ) ) ) { + // Get UTC offset, if it isn't set then return UTC. + $utc_offset = intval( get_option( 'gmt_offset', 0 ) ); + if ( 0 === $utc_offset ) { return 'UTC'; } - // adjust UTC offset from hours to seconds + // Adjust UTC offset from hours to seconds. $utc_offset *= 3600; - // attempt to guess the timezone string from the UTC offset - if ( $timezone = timezone_name_from_abbr( '', $utc_offset ) ) { + // Attempt to guess the timezone string from the UTC offset. + $timezone = timezone_name_from_abbr( '', $utc_offset ); + if ( $timezone ) { return $timezone; } - // last try, guess timezone string manually + // Last try, guess timezone string manually. foreach ( timezone_abbreviations_list() as $abbr ) { foreach ( $abbr as $city ) { if ( (bool) date( 'I' ) === (bool) $city['dst'] && $city['timezone_id'] && intval( $city['offset'] ) === $utc_offset ) { @@ -634,7 +726,7 @@ function wc_timezone_string() { } } - // fallback to UTC + // Fallback to UTC. return 'UTC'; } @@ -645,7 +737,9 @@ function wc_timezone_string() { * @return float */ function wc_timezone_offset() { - if ( $timezone = get_option( 'timezone_string' ) ) { + $timezone = get_option( 'timezone_string' ); + + if ( $timezone ) { $timezone_object = new DateTimeZone( $timezone ); return $timezone_object->getOffset( new DateTime( 'now' ) ); } else { @@ -657,7 +751,7 @@ function wc_timezone_offset() { * Callback which can flatten post meta (gets the first value if it's an array). * * @since 3.0.0 - * @param array $value + * @param array $value Value to flatten. * @return mixed */ function wc_flatten_meta_callback( $value ) { @@ -667,15 +761,15 @@ function wc_flatten_meta_callback( $value ) { if ( ! function_exists( 'wc_rgb_from_hex' ) ) { /** - * Hex darker/lighter/contrast functions for colors. + * Convert RGB to HEX. * - * @param mixed $color + * @param mixed $color Color. * * @return array */ function wc_rgb_from_hex( $color ) { $color = str_replace( '#', '', $color ); - // Convert shorthand colors to full format, e.g. "FFF" -> "FFFFFF" + // Convert shorthand colors to full format, e.g. "FFF" -> "FFFFFF". $color = preg_replace( '~^(.)(.)(.)$~', '$1$1$2$2$3$3', $color ); $rgb = array(); @@ -690,10 +784,11 @@ if ( ! function_exists( 'wc_rgb_from_hex' ) ) { if ( ! function_exists( 'wc_hex_darker' ) ) { /** - * Hex darker/lighter/contrast functions for colors. + * Make HEX color darker. * - * @param mixed $color - * @param int $factor (default: 30) + * @param mixed $color Color. + * @param int $factor Darker factor. + * Defaults to 30. * @return string */ function wc_hex_darker( $color, $factor = 30 ) { @@ -707,7 +802,7 @@ if ( ! function_exists( 'wc_hex_darker' ) ) { $new_hex_component = dechex( $new_decimal ); if ( strlen( $new_hex_component ) < 2 ) { - $new_hex_component = "0" . $new_hex_component; + $new_hex_component = '0' . $new_hex_component; } $color .= $new_hex_component; } @@ -719,10 +814,11 @@ if ( ! function_exists( 'wc_hex_darker' ) ) { if ( ! function_exists( 'wc_hex_lighter' ) ) { /** - * Hex darker/lighter/contrast functions for colors. + * Make HEX color lighter. * - * @param mixed $color - * @param int $factor (default: 30) + * @param mixed $color Color. + * @param int $factor Lighter factor. + * Defaults to 30. * @return string */ function wc_hex_lighter( $color, $factor = 30 ) { @@ -737,7 +833,7 @@ if ( ! function_exists( 'wc_hex_lighter' ) ) { $new_hex_component = dechex( $new_decimal ); if ( strlen( $new_hex_component ) < 2 ) { - $new_hex_component = "0" . $new_hex_component; + $new_hex_component = '0' . $new_hex_component; } $color .= $new_hex_component; } @@ -746,18 +842,15 @@ if ( ! function_exists( 'wc_hex_lighter' ) ) { } } -if ( ! function_exists( 'wc_light_or_dark' ) ) { +if ( ! function_exists( 'wc_is_light' ) ) { /** - * Detect if we should use a light or dark color on a background color. + * Determine whether a hex color is light. * - * @param mixed $color - * @param string $dark (default: '#000000') - * @param string $light (default: '#FFFFFF') - * @return string + * @param mixed $color Color. + * @return bool True if a light color. */ - function wc_light_or_dark( $color, $dark = '#000000', $light = '#FFFFFF' ) { - + function wc_hex_is_light( $color ) { $hex = str_replace( '#', '', $color ); $c_r = hexdec( substr( $hex, 0, 2 ) ); @@ -766,7 +859,24 @@ if ( ! function_exists( 'wc_light_or_dark' ) ) { $brightness = ( ( $c_r * 299 ) + ( $c_g * 587 ) + ( $c_b * 114 ) ) / 1000; - return $brightness > 155 ? $dark : $light; + return $brightness > 155; + } +} + +if ( ! function_exists( 'wc_light_or_dark' ) ) { + + /** + * Detect if we should use a light or dark color on a background color. + * + * @param mixed $color Color. + * @param string $dark Darkest reference. + * Defaults to '#000000'. + * @param string $light Lightest reference. + * Defaults to '#FFFFFF'. + * @return string + */ + function wc_light_or_dark( $color, $dark = '#000000', $light = '#FFFFFF' ) { + return wc_hex_is_light( $color ) ? $dark : $light; } } @@ -775,14 +885,13 @@ if ( ! function_exists( 'wc_format_hex' ) ) { /** * Format string as hex. * - * @param string $hex - * @return string + * @param string $hex HEX color. + * @return string|null */ function wc_format_hex( $hex ) { - $hex = trim( str_replace( '#', '', $hex ) ); - if ( strlen( $hex ) == 3 ) { + if ( strlen( $hex ) === 3 ) { $hex = $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2]; } @@ -793,29 +902,32 @@ if ( ! function_exists( 'wc_format_hex' ) ) { /** * Format the postcode according to the country and length of the postcode. * - * @param string $postcode - * @param string $country - * @return string Formatted postcode. + * @param string $postcode Unformatted postcode. + * @param string $country Base country. + * @return string */ function wc_format_postcode( $postcode, $country ) { $postcode = wc_normalize_postcode( $postcode ); switch ( $country ) { - case 'CA' : - case 'GB' : + case 'CA': + case 'GB': $postcode = trim( substr_replace( $postcode, ' ', -3, 0 ) ); break; - case 'BR' : - case 'PL' : + case 'IE': + $postcode = trim( substr_replace( $postcode, ' ', 3, 0 ) ); + break; + case 'BR': + case 'PL': $postcode = substr_replace( $postcode, '-', -3, 0 ); break; - case 'JP' : + case 'JP': $postcode = substr_replace( $postcode, '-', 3, 0 ); break; - case 'PT' : + case 'PT': $postcode = substr_replace( $postcode, '-', 4, 0 ); break; - case 'US' : + case 'US': $postcode = rtrim( substr_replace( $postcode, '-', 5, 0 ), '-' ); break; } @@ -829,40 +941,43 @@ function wc_format_postcode( $postcode, $country ) { * Remove spaces and convert characters to uppercase. * * @since 2.6.0 - * @param string $postcode - * @return string Sanitized postcode. + * @param string $postcode Postcode. + * @return string */ function wc_normalize_postcode( $postcode ) { return preg_replace( '/[\s\-]/', '', trim( wc_strtoupper( $postcode ) ) ); } +/** + * Format phone numbers. + * + * @param string $phone Phone number. + * @return string + */ +function wc_format_phone_number( $phone ) { + if ( ! WC_Validation::is_phone( $phone ) ) { + return ''; + } + return preg_replace( '/[^0-9\+\-\s]/', '-', preg_replace( '/[\x00-\x1F\x7F-\xFF]/', '', $phone ) ); +} + /** * Wrapper for mb_strtoupper which see's if supported first. * * @since 3.1.0 - * @param string $string + * @param string $string String to format. * @return string */ function wc_strtoupper( $string ) { return function_exists( 'mb_strtoupper' ) ? mb_strtoupper( $string ) : strtoupper( $string ); } -/** - * format_phone function. - * - * @param mixed $tel - * @return string - */ -function wc_format_phone_number( $tel ) { - return str_replace( '.', '-', $tel ); -} - /** * Make a string lowercase. * Try to use mb_strtolower() when available. * * @since 2.3 - * @param string $string + * @param string $string String to format. * @return string */ function wc_strtolower( $string ) { @@ -871,9 +986,12 @@ function wc_strtolower( $string ) { /** * Trim a string and append a suffix. - * @param string $string - * @param integer $chars - * @param string $suffix + * + * @param string $string String to trim. + * @param integer $chars Amount of characters. + * Defaults to 200. + * @param string $suffix Suffix. + * Defaults to '...'. * @return string */ function wc_trim_string( $string, $chars = 200, $suffix = '...' ) { @@ -891,7 +1009,7 @@ function wc_trim_string( $string, $chars = 200, $suffix = '...' ) { * Format content to display shortcodes. * * @since 2.3.0 - * @param string $raw_string + * @param string $raw_string Raw string. * @return string */ function wc_format_content( $raw_string ) { @@ -902,16 +1020,23 @@ function wc_format_content( $raw_string ) { * Format product short description. * Adds support for Jetpack Markdown. * + * @codeCoverageIgnore * @since 2.4.0 - * @param string $content + * @param string $content Product short description. * @return string */ function wc_format_product_short_description( $content ) { - // Add support for Jetpack Markdown + // Add support for Jetpack Markdown. if ( class_exists( 'WPCom_Markdown' ) ) { $markdown = WPCom_Markdown::get_instance(); - return wpautop( $markdown->transform( $content, array( 'unslash' => false ) ) ); + return wpautop( + $markdown->transform( + $content, array( + 'unslash' => false, + ) + ) + ); } return $content; @@ -919,9 +1044,11 @@ function wc_format_product_short_description( $content ) { /** * Formats curency symbols when saved in settings. - * @param string $value - * @param array $option - * @param string $raw_value + * + * @codeCoverageIgnore + * @param string $value Option value. + * @param array $option Option name. + * @param string $raw_value Raw value. * @return string */ function wc_format_option_price_separators( $value, $option, $raw_value ) { @@ -932,9 +1059,11 @@ add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_price_thousa /** * Formats decimals when saved in settings. - * @param string $value - * @param array $option - * @param string $raw_value + * + * @codeCoverageIgnore + * @param string $value Option value. + * @param array $option Option name. + * @param string $raw_value Raw value. * @return string */ function wc_format_option_price_num_decimals( $value, $option, $raw_value ) { @@ -944,13 +1073,15 @@ add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_price_num_de /** * Formats hold stock option and sets cron event up. - * @param string $value - * @param array $option - * @param string $raw_value + * + * @codeCoverageIgnore + * @param string $value Option value. + * @param array $option Option name. + * @param string $raw_value Raw value. * @return string */ function wc_format_option_hold_stock_minutes( $value, $option, $raw_value ) { - $value = ! empty( $raw_value ) ? absint( $raw_value ) : ''; // Allow > 0 or set to '' + $value = ! empty( $raw_value ) ? absint( $raw_value ) : ''; // Allow > 0 or set to ''. wp_clear_scheduled_hook( 'woocommerce_cancel_unpaid_orders' ); @@ -966,7 +1097,7 @@ add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_hold_stock_m * Sanitize terms from an attribute text based. * * @since 2.4.5 - * @param string $term + * @param string $term Term value. * @return string */ function wc_sanitize_term_text_based( $term ) { @@ -981,7 +1112,7 @@ if ( ! function_exists( 'wc_make_numeric_postcode' ) ) { * E.g. PE30 becomes 16050300 (P = 16, E = 05, 3 = 03, 0 = 00) * * @since 2.6.0 - * @param string $postcode Regular postcode + * @param string $postcode Regular postcode. * @return string */ function wc_make_numeric_postcode( $postcode ) { @@ -1017,14 +1148,16 @@ function wc_format_stock_for_display( $product ) { $stock_amount = $product->get_stock_quantity(); switch ( get_option( 'woocommerce_stock_format' ) ) { - case 'low_amount' : + case 'low_amount': if ( $stock_amount <= get_option( 'woocommerce_notify_low_stock_amount' ) ) { + /* translators: %s: stock amount */ $display = sprintf( __( 'Only %s left in stock', 'woocommerce' ), wc_format_stock_quantity_for_display( $stock_amount, $product ) ); } - break; - case '' : + break; + case '': + /* translators: %s: stock amount */ $display = sprintf( __( '%s in stock', 'woocommerce' ), wc_format_stock_quantity_for_display( $stock_amount, $product ) ); - break; + break; } if ( $product->backorders_allowed() && $product->backorders_require_notification() ) { @@ -1038,8 +1171,8 @@ function wc_format_stock_for_display( $product ) { * Format the stock quantity ready for display. * * @since 3.0.0 - * @param int $stock_quantity - * @param WC_Product $product so that we can pass through the filters. + * @param int $stock_quantity Stock quantity. + * @param WC_Product $product Product instance so that we can pass through the filters. * @return string */ function wc_format_stock_quantity_for_display( $stock_quantity, $product ) { @@ -1048,9 +1181,10 @@ function wc_format_stock_quantity_for_display( $stock_quantity, $product ) { /** * Format a sale price for display. + * * @since 3.0.0 - * @param string $regular_price - * @param string $sale_price + * @param string $regular_price Regular price. + * @param string $sale_price Sale price. * @return string */ function wc_format_sale_price( $regular_price, $sale_price ) { @@ -1060,11 +1194,13 @@ function wc_format_sale_price( $regular_price, $sale_price ) { /** * Format a price range for display. - * @param string $from - * @param string $to + * + * @param string $from Price from. + * @param string $to Price to. * @return string */ function wc_format_price_range( $from, $to ) { + /* translators: 1: price from 2: price to */ $price = sprintf( _x( '%1$s – %2$s', 'Price range: from-to', 'woocommerce' ), is_numeric( $from ) ? wc_price( $from ) : $from, is_numeric( $to ) ? wc_price( $to ) : $to ); return apply_filters( 'woocommerce_format_price_range', $price, $from, $to ); } @@ -1111,8 +1247,9 @@ function wc_format_dimensions( $dimensions ) { * Format a date for output. * * @since 3.0.0 - * @param WC_DateTime $date - * @param string $format Defaults to the wc_date_format function if not set. + * @param WC_DateTime $date Instance of WC_DateTime. + * @param string $format Data format. + * Defaults to the wc_date_format function if not set. * @return string */ function wc_format_datetime( $date, $format = '' ) { @@ -1129,7 +1266,7 @@ function wc_format_datetime( $date, $format = '' ) { * Process oEmbeds. * * @since 3.1.0 - * @param string $content + * @param string $content Content. * @return string */ function wc_do_oembeds( $content ) { @@ -1139,3 +1276,144 @@ function wc_do_oembeds( $content ) { return $content; } + +/** + * Get part of a string before :. + * + * Used for example in shipping methods ids where they take the format + * method_id:instance_id + * + * @since 3.2.0 + * @param string $string String to extract. + * @return string + */ +function wc_get_string_before_colon( $string ) { + return trim( current( explode( ':', (string) $string ) ) ); +} + +/** + * Array merge and sum function. + * + * Source: https://gist.github.com/Nickology/f700e319cbafab5eaedc + * + * @since 3.2.0 + * @return array + */ +function wc_array_merge_recursive_numeric() { + $arrays = func_get_args(); + + // If there's only one array, it's already merged. + if ( 1 === count( $arrays ) ) { + return $arrays[0]; + } + + // Remove any items in $arrays that are NOT arrays. + foreach ( $arrays as $key => $array ) { + if ( ! is_array( $array ) ) { + unset( $arrays[ $key ] ); + } + } + + // We start by setting the first array as our final array. + // We will merge all other arrays with this one. + $final = array_shift( $arrays ); + + foreach ( $arrays as $b ) { + foreach ( $final as $key => $value ) { + // If $key does not exist in $b, then it is unique and can be safely merged. + if ( ! isset( $b[ $key ] ) ) { + $final[ $key ] = $value; + } else { + // If $key is present in $b, then we need to merge and sum numeric values in both. + if ( is_numeric( $value ) && is_numeric( $b[ $key ] ) ) { + // If both values for these keys are numeric, we sum them. + $final[ $key ] = $value + $b[ $key ]; + } elseif ( is_array( $value ) && is_array( $b[ $key ] ) ) { + // If both values are arrays, we recursively call ourself. + $final[ $key ] = wc_array_merge_recursive_numeric( $value, $b[ $key ] ); + } else { + // If both keys exist but differ in type, then we cannot merge them. + // In this scenario, we will $b's value for $key is used. + $final[ $key ] = $b[ $key ]; + } + } + } + + // Finally, we need to merge any keys that exist only in $b. + foreach ( $b as $key => $value ) { + if ( ! isset( $final[ $key ] ) ) { + $final[ $key ] = $value; + } + } + } + + return $final; +} + +/** + * Implode and escape HTML attributes for output. + * + * @since 3.3.0 + * @param array $raw_attributes Attribute name value pairs. + * @return string + */ +function wc_implode_html_attributes( $raw_attributes ) { + $attributes = array(); + foreach ( $raw_attributes as $name => $value ) { + $attributes[] = esc_attr( $name ) . '="' . esc_attr( $value ) . '"'; + } + return implode( ' ', $attributes ); +} + +/** + * Parse a relative date option from the settings API into a standard format. + * + * @since 3.4.0 + * @param mixed $raw_value Value stored in DB. + * @return array Nicely formatted array with number and unit values. + */ +function wc_parse_relative_date_option( $raw_value ) { + $periods = array( + 'days' => __( 'Day(s)', 'woocommerce' ), + 'weeks' => __( 'Week(s)', 'woocommerce' ), + 'months' => __( 'Month(s)', 'woocommerce' ), + 'years' => __( 'Year(s)', 'woocommerce' ), + ); + + $value = wp_parse_args( (array) $raw_value, array( + 'number' => '', + 'unit' => 'days', + ) ); + + $value['number'] = ! empty( $value['number'] ) ? absint( $value['number'] ) : ''; + + if ( ! in_array( $value['unit'], array_keys( $periods ), true ) ) { + $value['unit'] = 'days'; + } + + return $value; +} + +/** + * Format the endpoint slug, strip out anything not allowed in a url. + * + * @since 3.5.0 + * @param string $raw_value The raw value. + * @return string + */ +function wc_sanitize_endpoint_slug( $raw_value ) { + return sanitize_title( $raw_value ); +} +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_checkout_pay_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_checkout_order_received_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_add_payment_method_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_delete_payment_method_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_set_default_payment_method_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_orders_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_view_order_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_downloads_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_edit_account_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_edit_address_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_payment_methods_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_myaccount_lost_password_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); +add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_logout_endpoint', 'wc_sanitize_endpoint_slug', 10, 1 ); diff --git a/includes/wc-notice-functions.php b/includes/wc-notice-functions.php index 61f01704591..db293034281 100644 --- a/includes/wc-notice-functions.php +++ b/includes/wc-notice-functions.php @@ -4,22 +4,20 @@ * * Functions for error/message handling and display. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.1.0 + * @package WooCommerce/Functions + * @version 2.1.0 */ if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly + 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 The name of the notice type - either error, success or notice. [optional] + * @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 = '' ) { @@ -33,12 +31,12 @@ function wc_notice_count( $notice_type = '' ) { if ( isset( $all_notices[ $notice_type ] ) ) { - $notice_count = absint( sizeof( $all_notices[ $notice_type ] ) ); + $notice_count = count( $all_notices[ $notice_type ] ); } elseif ( empty( $notice_type ) ) { foreach ( $all_notices as $notices ) { - $notice_count += absint( sizeof( $all_notices ) ); + $notice_count += count( $notices ); } } @@ -48,9 +46,9 @@ function wc_notice_count( $notice_type = '' ) { /** * 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 The singular name of the notice type - either error, success or notice. [optional] + * @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' ) { @@ -61,7 +59,7 @@ function wc_has_notice( $message, $notice_type = 'success' ) { $notices = WC()->session->get( 'wc_notices', array() ); $notices = isset( $notices[ $notice_type ] ) ? $notices[ $notice_type ] : array(); - return array_search( $message, $notices ) !== false; + return array_search( $message, $notices, true ) !== false; } /** @@ -69,7 +67,7 @@ function wc_has_notice( $message, $notice_type = 'success' ) { * * @since 2.1 * @param string $message The text to display in the notice. - * @param string $notice_type The singular name of the notice type - either error, success or notice. [optional] + * @param string $notice_type Optional. The name of the notice type - either error, success or notice. */ function wc_add_notice( $message, $notice_type = 'success' ) { if ( ! did_action( 'woocommerce_init' ) ) { @@ -79,7 +77,7 @@ function wc_add_notice( $message, $notice_type = 'success' ) { $notices = WC()->session->get( 'wc_notices', array() ); - // Backward compatibility + // Backward compatibility. if ( 'success' === $notice_type ) { $message = apply_filters( 'woocommerce_add_message', $message ); } @@ -91,9 +89,9 @@ function wc_add_notice( $message, $notice_type = 'success' ) { /** * Set all notices at once. - * @since 2.6.0 * - * @param mixed $notices + * @since 2.6.0 + * @param mixed $notices Array of notices. */ function wc_set_notices( $notices ) { if ( ! did_action( 'woocommerce_init' ) ) { @@ -121,8 +119,10 @@ function wc_clear_notices() { * 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() { +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; @@ -131,6 +131,9 @@ function wc_print_notices() { $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 ) { wc_get_template( "notices/{$notice_type}.php", array( @@ -140,17 +143,22 @@ function wc_print_notices() { } wc_clear_notices(); + + $notices = wc_kses_notice( ob_get_clean() ); + + if ( $return ) { + return $notices; + } + + echo $notices; // WPCS: XSS ok. } -add_action( 'woocommerce_shortcode_before_product_cat_loop', 'wc_print_notices', 10 ); -add_action( 'woocommerce_before_shop_loop', 'wc_print_notices', 10 ); -add_action( 'woocommerce_before_single_product', 'wc_print_notices', 10 ); /** * Print a single notice immediately. * * @since 2.1 * @param string $message The text to display in the notice. - * @param string $notice_type The singular name of the notice type - either error, success or notice. [optional] + * @param string $notice_type Optional. The singular name of the notice type - either error, success or notice. */ function wc_print_notice( $message, $notice_type = 'success' ) { if ( 'success' === $notice_type ) { @@ -165,8 +173,8 @@ function wc_print_notice( $message, $notice_type = 'success' ) { /** * Returns all queued notices, optionally filtered by a notice type. * - * @since 2.1 - * @param string $notice_type The singular name of the notice type - either error, success or notice. [optional] + * @since 2.1 + * @param string $notice_type Optional. The singular name of the notice type - either error, success or notice. * @return array|mixed */ function wc_get_notices( $notice_type = '' ) { @@ -190,7 +198,8 @@ function wc_get_notices( $notice_type = '' ) { /** * Add notices for WP Errors. - * @param WP_Error $errors + * + * @param WP_Error $errors Errors. */ function wc_add_wp_error_notices( $errors ) { if ( is_wp_error( $errors ) && $errors->get_error_messages() ) { @@ -199,3 +208,23 @@ function wc_add_wp_error_notices( $errors ) { } } } + +/** + * Filters out the same tags as wp_kses_post, but allows tabindex for element. + * + * @since 3.5.0 + * @param string $message Content to filter through kses. + * @return string + */ +function wc_kses_notice( $message ) { + return wp_kses( $message, + array_replace_recursive( // phpcs:ignore PHPCompatibility.PHP.NewFunctions.array_replace_recursiveFound + wp_kses_allowed_html( 'post' ), + array( + 'a' => array( + 'tabindex' => true, + ), + ) + ) + ); +} diff --git a/includes/wc-order-functions.php b/includes/wc-order-functions.php index 2f0b692cf59..75ae8c08d3a 100644 --- a/includes/wc-order-functions.php +++ b/includes/wc-order-functions.php @@ -4,13 +4,11 @@ * * Functions for order specific things. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions + * @package WooCommerce/Functions + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; /** * Standard way of retrieving orders based on certain parameters. @@ -21,8 +19,8 @@ if ( ! defined( 'ABSPATH' ) ) { * Args and usage: https://github.com/woocommerce/woocommerce/wiki/wc_get_orders-and-WC_Order_Query * * @since 2.6.0 - * @param array $args Array of args (above) - * @return array|stdClass Number of pages and an array of order objects if + * @param array $args Array of args (above). + * @return WC_Order[]|stdClass Number of pages and an array of order objects if * paginate is true, or just an array of values. */ function wc_get_orders( $args ) { @@ -75,7 +73,7 @@ function wc_get_orders( $args ) { * * @param mixed $the_order Post object or post ID of the order. * - * @return bool|WC_Order|WC_Refund + * @return bool|WC_Order|WC_Order_Refund */ function wc_get_order( $the_order = false ) { if ( ! did_action( 'woocommerce_after_register_post_type' ) ) { @@ -107,7 +105,8 @@ function wc_get_order_statuses() { /** * See if a string is an order status. - * @param string $maybe_status Status, including any wc- prefix + * + * @param string $maybe_status Status, including any wc- prefix. * @return bool */ function wc_is_order_status( $maybe_status ) { @@ -117,6 +116,7 @@ function wc_is_order_status( $maybe_status ) { /** * Get list of statuses which are consider 'paid'. + * * @since 3.0.0 * @return array */ @@ -128,7 +128,7 @@ function wc_get_is_paid_statuses() { * Get the nice name for an order status. * * @since 2.2 - * @param string $status + * @param string $status Status. * @return string */ function wc_get_order_status_name( $status ) { @@ -141,8 +141,8 @@ function wc_get_order_status_name( $status ) { /** * Finds an Order ID based on an order key. * - * @param string $order_key An order key has generated by - * @return int The ID of an order, or 0 if the order could not be found + * @param string $order_key An order key has generated by. + * @return int The ID of an order, or 0 if the order could not be found. */ function wc_get_order_id_by_order_key( $order_key ) { $data_store = WC_Data_Store::load( 'order' ); @@ -152,12 +152,10 @@ function wc_get_order_id_by_order_key( $order_key ) { /** * Get all registered order types. * - * $for optionally define what you are getting order types for so only relevant types are returned. - * - * e.g. for 'order-meta-boxes', 'order-count' - * * @since 2.2 - * @param string $for + * @param string $for Optionally define what you are getting order types for so + * only relevant types are returned. + * e.g. for 'order-meta-boxes', 'order-count'. * @return array */ function wc_get_order_types( $for = '' ) { @@ -170,51 +168,51 @@ function wc_get_order_types( $for = '' ) { $order_types = array(); switch ( $for ) { - case 'order-count' : + case 'order-count': foreach ( $wc_order_types as $type => $args ) { if ( ! $args['exclude_from_order_count'] ) { $order_types[] = $type; } } - break; - case 'order-meta-boxes' : + break; + case 'order-meta-boxes': foreach ( $wc_order_types as $type => $args ) { if ( $args['add_order_meta_boxes'] ) { $order_types[] = $type; } } - break; - case 'view-orders' : + break; + case 'view-orders': foreach ( $wc_order_types as $type => $args ) { if ( ! $args['exclude_from_order_views'] ) { $order_types[] = $type; } } - break; - case 'reports' : + break; + case 'reports': foreach ( $wc_order_types as $type => $args ) { if ( ! $args['exclude_from_order_reports'] ) { $order_types[] = $type; } } - break; - case 'sales-reports' : + break; + case 'sales-reports': foreach ( $wc_order_types as $type => $args ) { if ( ! $args['exclude_from_order_sales_reports'] ) { $order_types[] = $type; } } - break; - case 'order-webhooks' : + break; + case 'order-webhooks': foreach ( $wc_order_types as $type => $args ) { if ( ! $args['exclude_from_order_webhooks'] ) { $order_types[] = $type; } } - break; - default : + break; + default: $order_types = array_keys( $wc_order_types ); - break; + break; } return apply_filters( 'wc_order_types', $order_types, $for ); @@ -222,17 +220,18 @@ function wc_get_order_types( $for = '' ) { /** * Get an order type by post type name. - * @param string post type name - * @return bool|array of datails about the order type + * + * @param string $type Post type name. + * @return bool|array Details about the order type. */ function wc_get_order_type( $type ) { global $wc_order_types; if ( isset( $wc_order_types[ $type ] ) ) { return $wc_order_types[ $type ]; - } else { - return false; } + + return false; } /** @@ -253,8 +252,8 @@ function wc_get_order_type( $type ) { * * @since 2.2 * @see register_post_type for $args used in that function - * @param string $type Post type. (max. 20 characters, can not contain capital letters or spaces) - * @param array $args An array of arguments. + * @param string $type Post type. (max. 20 characters, can not contain capital letters or spaces). + * @param array $args An array of arguments. * @return bool Success or failure */ function wc_register_order_type( $type, $args = array() ) { @@ -268,12 +267,12 @@ function wc_register_order_type( $type, $args = array() ) { $wc_order_types = array(); } - // Register as a post type + // Register as a post type. if ( is_wp_error( register_post_type( $type, $args ) ) ) { return false; } - // Register for WC usage + // Register for WC usage. $order_type_args = array( 'exclude_from_orders_screen' => false, 'add_order_meta_boxes' => true, @@ -305,7 +304,7 @@ function wc_processing_order_count() { /** * Return the orders count of a specific order status. * - * @param string $status + * @param string $status Status. * @return int */ function wc_orders_count( $status ) { @@ -313,11 +312,11 @@ function wc_orders_count( $status ) { $status = 'wc-' . $status; $order_statuses = array_keys( wc_get_order_statuses() ); - if ( ! in_array( $status, $order_statuses ) ) { + if ( ! in_array( $status, $order_statuses, true ) ) { return 0; } - $cache_key = WC_Cache_Helper::get_cache_prefix( 'orders' ) . $status; + $cache_key = WC_Cache_Helper::get_cache_prefix( 'orders' ) . $status; $cached_count = wp_cache_get( $cache_key, 'counts' ); if ( false !== $cached_count ) { @@ -339,11 +338,11 @@ function wc_orders_count( $status ) { /** * Grant downloadable product access to the file identified by $download_id. * - * @param string $download_id file identifier - * @param int|WC_Product $product - * @param WC_Order $order the order - * @param int $qty purchased - * @return int|bool insert id or false on failure + * @param string $download_id File identifier. + * @param int|WC_Product $product Product instance or ID. + * @param WC_Order $order Order data. + * @param int $qty Quantity purchased. + * @return int|bool insert id or false on failure. */ function wc_downloadable_file_permission( $download_id, $product, $order, $qty = 1 ) { if ( is_numeric( $product ) ) { @@ -367,14 +366,16 @@ function wc_downloadable_file_permission( $download_id, $product, $order, $qty = $download->set_access_expires( strtotime( $from_date . ' + ' . $expiry . ' DAY' ) ); } + $download = apply_filters( 'woocommerce_downloadable_file_permission', $download, $product, $order, $qty ); + return $download->save(); } /** * Order Status completed - give downloadable product access to customer. * - * @param int $order_id - * @param bool $force + * @param int $order_id Order ID. + * @param bool $force Force downloadable permissions. */ function wc_downloadable_product_permissions( $order_id, $force = false ) { $order = wc_get_order( $order_id ); @@ -387,7 +388,7 @@ function wc_downloadable_product_permissions( $order_id, $force = false ) { return; } - if ( sizeof( $order->get_items() ) > 0 ) { + if ( count( $order->get_items() ) > 0 ) { foreach ( $order->get_items() as $item ) { $product = $item->get_product(); @@ -410,7 +411,7 @@ add_action( 'woocommerce_order_status_processing', 'wc_downloadable_product_perm /** * Clear all transients cache for order data. * - * @param int|WC_Order $order + * @param int|WC_Order $order Order instance or ID. */ function wc_delete_shop_order_transients( $order = 0 ) { if ( is_numeric( $order ) ) { @@ -418,7 +419,7 @@ function wc_delete_shop_order_transients( $order = 0 ) { } $reports = WC_Admin_Reports::get_reports(); $transients_to_clear = array( - 'wc_admin_report' + 'wc_admin_report', ); foreach ( $reports as $report_group ) { @@ -431,7 +432,7 @@ function wc_delete_shop_order_transients( $order = 0 ) { delete_transient( $transient ); } - // Clear money spent for user associated with order + // Clear money spent for user associated with order. if ( is_a( $order, 'WC_Order' ) ) { $order_id = $order->get_id(); delete_user_meta( $order->get_customer_id(), '_money_spent' ); @@ -440,10 +441,10 @@ function wc_delete_shop_order_transients( $order = 0 ) { $order_id = 0; } - // Increments the transient version to invalidate cache + // Increments the transient version to invalidate cache. WC_Cache_Helper::get_transient_version( 'orders', true ); - // Do the same for regular cache + // Do the same for regular cache. WC_Cache_Helper::incr_cache_prefix( 'orders' ); do_action( 'woocommerce_delete_shop_order_transients', $order_id ); @@ -451,6 +452,7 @@ function wc_delete_shop_order_transients( $order = 0 ) { /** * See if we only ship to billing addresses. + * * @return bool */ function wc_ship_to_billing_address_only() { @@ -463,7 +465,8 @@ function wc_ship_to_billing_address_only() { * Returns a new refund object on success which can then be used to add additional data. * * @since 2.2 - * @param array $args + * @throws Exception Throws exceptions when fail to create, but returns WP_Error instead. + * @param array $args New refund arguments. * @return WC_Order_Refund|WP_Error */ function wc_create_refund( $args = array() ) { @@ -478,9 +481,10 @@ function wc_create_refund( $args = array() ) { ); try { - $args = wp_parse_args( $args, $default_args ); + $args = wp_parse_args( $args, $default_args ); + $order = wc_get_order( $args['order_id'] ); - if ( ! $order = wc_get_order( $args['order_id'] ) ) { + if ( ! $order ) { throw new Exception( __( 'Invalid order ID.', 'woocommerce' ) ); } @@ -502,8 +506,8 @@ function wc_create_refund( $args = array() ) { $refund->set_reason( $args['reason'] ); } - // Negative line items - if ( sizeof( $args['line_items'] ) > 0 ) { + // Negative line items. + if ( count( $args['line_items'] ) > 0 ) { $items = $order->get_items( array( 'line_item', 'fee', 'shipping' ) ); foreach ( $items as $item_id => $item ) { @@ -524,7 +528,12 @@ function wc_create_refund( $args = array() ) { $refunded_item->set_id( 0 ); $refunded_item->add_meta_data( '_refunded_item_id', $item_id, true ); $refunded_item->set_total( wc_format_refund_total( $refund_total ) ); - $refunded_item->set_taxes( array( 'total' => array_map( 'wc_format_refund_total', $refund_tax ), 'subtotal' => array_map( 'wc_format_refund_total', $refund_tax ) ) ); + $refunded_item->set_taxes( + array( + 'total' => array_map( 'wc_format_refund_total', $refund_tax ), + 'subtotal' => array_map( 'wc_format_refund_total', $refund_tax ), + ) + ); if ( is_callable( array( $refunded_item, 'set_subtotal' ) ) ) { $refunded_item->set_subtotal( wc_format_refund_total( $refund_total ) ); @@ -544,13 +553,14 @@ function wc_create_refund( $args = array() ) { $refund->set_total( $args['amount'] * -1 ); // this should remain after update_taxes(), as this will save the order, and write the current date to the db - // so we must wait until the order is persisted to set the date + // so we must wait until the order is persisted to set the date. if ( isset( $args['date_created'] ) ) { $refund->set_date_created( $args['date_created'] ); } /** * Action hook to adjust refund before save. + * * @since 3.0.0 */ do_action( 'woocommerce_create_refund', $refund, $args ); @@ -563,13 +573,16 @@ function wc_create_refund( $args = array() ) { $refund->delete(); return $result; } + + $refund->set_refunded_payment( true ); + $refund->save(); } if ( $args['restock_items'] ) { wc_restock_refunded_items( $order, $args['line_items'] ); } - // Trigger notification emails + // Trigger notification emails. if ( ( $remaining_refund_amount - $args['amount'] ) > 0 || ( $order->has_free_item() && ( $remaining_refund_items - $refund_item_count ) > 0 ) ) { do_action( 'woocommerce_order_partially_refunded', $order->get_id(), $refund->get_id() ); } else { @@ -587,6 +600,9 @@ function wc_create_refund( $args = array() ) { do_action( 'woocommerce_order_refunded', $order->get_id(), $refund->get_id() ); } catch ( Exception $e ) { + if ( isset( $refund ) && is_a( $refund, 'WC_Order_Refund' ) ) { + wp_delete_post( $refund->get_id(), true ); + } return new WP_Error( 'error', $e->getMessage() ); } @@ -597,9 +613,10 @@ function wc_create_refund( $args = array() ) { * Try to refund the payment for an order via the gateway. * * @since 3.0.0 - * @param WC_Order $order - * @param string $amount - * @param string $reason + * @throws Exception Throws exceptions when fail to refund, but returns WP_Error instead. + * @param WC_Order $order Order instance. + * @param string $amount Amount to refund. + * @param string $reason Refund reason. * @return bool|WP_Error */ function wc_refund_payment( $order, $amount, $reason = '' ) { @@ -641,9 +658,9 @@ function wc_refund_payment( $order, $amount, $reason = '' ) { /** * Restock items during refund. * - * @since 3.0.0 - * @param WC_Order $order - * @param array $refunded_line_items + * @since 3.0.0 + * @param WC_Order $order Order instance. + * @param array $refunded_line_items Refunded items list. */ function wc_restock_refunded_items( $order, $refunded_line_items ) { $line_items = $order->get_items(); @@ -658,6 +675,7 @@ function wc_restock_refunded_items( $order, $refunded_line_items ) { $old_stock = $product->get_stock_quantity(); $new_stock = wc_update_product_stock( $product, $refunded_line_items[ $item_id ]['qty'], 'increase' ); + /* translators: 1: product ID 2: old stock level 3: new stock level */ $order->add_order_note( sprintf( __( 'Item #%1$s stock increased from %2$s to %3$s.', 'woocommerce' ), $product->get_id(), $old_stock, $new_stock ) ); do_action( 'woocommerce_restock_refunded_item', $product->get_id(), $old_stock, $new_stock, $order, $product ); @@ -669,7 +687,7 @@ function wc_restock_refunded_items( $order, $refunded_line_items ) { * Get tax class by tax id. * * @since 2.2 - * @param int $tax_id + * @param int $tax_id Tax ID. * @return string */ function wc_get_tax_class_by_tax_id( $tax_id ) { @@ -681,7 +699,7 @@ function wc_get_tax_class_by_tax_id( $tax_id ) { * Get payment gateway class by order data. * * @since 2.2 - * @param int|WC_Order $order + * @param int|WC_Order $order Order instance. * @return WC_Payment_Gateway|bool */ function wc_get_payment_gateway_by_order( $order ) { @@ -705,23 +723,25 @@ function wc_get_payment_gateway_by_order( $order ) { * This is manual; no gateway refund will be performed. * * @since 2.4 - * @param int $order_id + * @param int $order_id Order ID. */ function wc_order_fully_refunded( $order_id ) { - $order = wc_get_order( $order_id ); - $max_refund = wc_format_decimal( $order->get_total() - $order->get_total_refunded() ); + $order = wc_get_order( $order_id ); + $max_refund = wc_format_decimal( $order->get_total() - $order->get_total_refunded() ); if ( ! $max_refund ) { return; } - // Create the refund object - wc_create_refund( array( - 'amount' => $max_refund, - 'reason' => __( 'Order fully refunded', 'woocommerce' ), - 'order_id' => $order_id, - 'line_items' => array(), - ) ); + // Create the refund object. + wc_create_refund( + array( + 'amount' => $max_refund, + 'reason' => __( 'Order fully refunded', 'woocommerce' ), + 'order_id' => $order_id, + 'line_items' => array(), + ) + ); } add_action( 'woocommerce_order_status_refunded', 'wc_order_fully_refunded' ); @@ -741,7 +761,7 @@ function wc_order_search( $term ) { * Update total sales amount for each product within a paid order. * * @since 3.0.0 - * @param int $order_id + * @param int $order_id Order ID. */ function wc_update_total_sales_counts( $order_id ) { $order = wc_get_order( $order_id ); @@ -750,9 +770,11 @@ function wc_update_total_sales_counts( $order_id ) { return; } - if ( sizeof( $order->get_items() ) > 0 ) { + if ( count( $order->get_items() ) > 0 ) { foreach ( $order->get_items() as $item ) { - if ( $product_id = $item->get_product_id() ) { + $product_id = $item->get_product_id(); + + if ( $product_id ) { $data_store = WC_Data_Store::load( 'product' ); $data_store->update_product_sales( $product_id, absint( $item['qty'] ), 'increase' ); } @@ -776,10 +798,12 @@ add_action( 'woocommerce_order_status_on-hold', 'wc_update_total_sales_counts' ) * Update used coupon amount for each coupon within an order. * * @since 3.0.0 - * @param int $order_id + * @param int $order_id Order ID. */ function wc_update_coupon_usage_counts( $order_id ) { - if ( ! $order = wc_get_order( $order_id ) ) { + $order = wc_get_order( $order_id ); + + if ( ! $order ) { return; } @@ -795,25 +819,26 @@ function wc_update_coupon_usage_counts( $order_id ) { return; } - if ( sizeof( $order->get_used_coupons() ) > 0 ) { + if ( count( $order->get_used_coupons() ) > 0 ) { foreach ( $order->get_used_coupons() as $code ) { if ( ! $code ) { continue; } - $coupon = new WC_Coupon( $code ); + $coupon = new WC_Coupon( $code ); + $used_by = $order->get_user_id(); - if ( ! $used_by = $order->get_user_id() ) { + if ( ! $used_by ) { $used_by = $order->get_billing_email(); } switch ( $action ) { - case 'reduce' : + case 'reduce': $coupon->decrease_usage_count( $used_by ); - break; - case 'increase' : + break; + case 'increase': $coupon->increase_usage_count( $used_by ); - break; + break; } } } @@ -858,7 +883,7 @@ add_action( 'woocommerce_cancel_unpaid_orders', 'wc_cancel_unpaid_orders' ); * This function will fix this. * * @since 3.1.0 - * @param int $order_id + * @param int $order_id Order ID. */ function wc_sanitize_order_id( $order_id ) { return filter_var( $order_id, FILTER_SANITIZE_NUMBER_INT ); @@ -881,13 +906,15 @@ function wc_get_order_note( $data ) { return null; } - return (object) apply_filters( 'woocommerce_get_order_note', array( - 'id' => (int) $data->comment_ID, - 'date_created' => wc_string_to_datetime( $data->comment_date ), - 'note' => $data->comment_content, - 'customer_note' => (bool) get_comment_meta( $data->comment_ID, 'is_customer_note', true ), - 'added_by' => __( 'WooCommerce', 'woocommerce' ) === $data->comment_author ? 'system' : $data->comment_author, - ), $data ); + return (object) apply_filters( + 'woocommerce_get_order_note', array( + 'id' => (int) $data->comment_ID, + 'date_created' => wc_string_to_datetime( $data->comment_date ), + 'content' => $data->comment_content, + 'customer_note' => (bool) get_comment_meta( $data->comment_ID, 'is_customer_note', true ), + 'added_by' => __( 'WooCommerce', 'woocommerce' ) === $data->comment_author ? 'system' : $data->comment_author, + ), $data + ); } /** @@ -943,7 +970,7 @@ function wc_get_order_notes( $args ) { // Set WooCommerce order type. if ( isset( $args['type'] ) && 'customer' === $args['type'] ) { - $args['meta_query'] = array( + $args['meta_query'] = array( // WPCS: slow query ok. array( 'key' => 'is_customer_note', 'value' => 1, @@ -951,7 +978,7 @@ function wc_get_order_notes( $args ) { ), ); } elseif ( isset( $args['type'] ) && 'internal' === $args['type'] ) { - $args['meta_query'] = array( + $args['meta_query'] = array( // WPCS: slow query ok. array( 'key' => 'is_customer_note', 'compare' => 'NOT EXISTS', @@ -965,7 +992,7 @@ function wc_get_order_notes( $args ) { // Always approved. $args['status'] = 'approve'; - // Does not support 'count' or 'fields'; + // Does not support 'count' or 'fields'. unset( $args['count'], $args['fields'] ); remove_filter( 'comments_clauses', array( 'WC_Comments', 'exclude_order_comments' ), 10, 1 ); @@ -983,8 +1010,8 @@ function wc_get_order_notes( $args ) { * @since 3.2.0 * @param int $order_id Order ID. * @param string $note Note to add. - * @param bool $is_customer_note Is this a note for the customer? - * @param bool $added_by_user Was the note added by a user? + * @param bool $is_customer_note If is a costumer note. + * @param bool $added_by_user If note is create by an user. * @return int|WP_Error Integer when created or WP_Error when found an error. */ function wc_create_order_note( $order_id, $note, $is_customer_note = false, $added_by_user = false ) { diff --git a/includes/wc-order-item-functions.php b/includes/wc-order-item-functions.php index cb4a416614a..9c4a4bef44a 100644 --- a/includes/wc-order-item-functions.php +++ b/includes/wc-order-item-functions.php @@ -4,20 +4,20 @@ * * Functions for order specific things. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions + * @package WooCommerce/Functions + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; /** * Add a item to an order (for example a line item). * - * @param int $order_id - * @param array $item_array - * @return int|bool Item ID or false + * @param int $order_id Order ID. + * @param array $item_array Items list. + * + * @throws Exception When `WC_Data_Store::load` validation fails. + * @return int|bool Item ID or false */ function wc_add_order_item( $order_id, $item_array ) { $order_id = absint( $order_id ); @@ -45,9 +45,11 @@ function wc_add_order_item( $order_id, $item_array ) { * Update an item for an order. * * @since 2.2 - * @param int $item_id - * @param array $args either `order_item_type` or `order_item_name` - * @return bool true if successfully updated, false otherwise + * @param int $item_id Item ID. + * @param array $args Either `order_item_type` or `order_item_name`. + * + * @throws Exception When `WC_Data_Store::load` validation fails. + * @return bool True if successfully updated, false otherwise. */ function wc_update_order_item( $item_id, $args ) { $data_store = WC_Data_Store::load( 'order-item' ); @@ -65,13 +67,15 @@ function wc_update_order_item( $item_id, $args ) { /** * Delete an item from the order it belongs to based on item id. * - * @access public - * @param int $item_id + * @param int $item_id Item ID. + * + * @throws Exception When `WC_Data_Store::load` validation fails. * @return bool */ function wc_delete_order_item( $item_id ) { + $item_id = absint( $item_id ); - if ( ! $item_id = absint( $item_id ) ) { + if ( ! $item_id ) { return false; } @@ -89,11 +93,12 @@ function wc_delete_order_item( $item_id ) { /** * WooCommerce Order Item Meta API - Update term meta. * - * @access public - * @param mixed $item_id - * @param mixed $meta_key - * @param mixed $meta_value - * @param string $prev_value (default: '') + * @param int $item_id Item ID. + * @param string $meta_key Meta key. + * @param string $meta_value Meta value. + * @param string $prev_value Previous value (default: ''). + * + * @throws Exception When `WC_Data_Store::load` validation fails. * @return bool */ function wc_update_order_item_meta( $item_id, $meta_key, $meta_value, $prev_value = '' ) { @@ -108,16 +113,19 @@ function wc_update_order_item_meta( $item_id, $meta_key, $meta_value, $prev_valu /** * WooCommerce Order Item Meta API - Add term meta. * - * @access public - * @param mixed $item_id - * @param mixed $meta_key - * @param mixed $meta_value - * @param bool $unique (default: false) - * @return int New row ID or 0 + * @param int $item_id Item ID. + * @param string $meta_key Meta key. + * @param string $meta_value Meta value. + * @param bool $unique If meta data should be unique (default: false). + * + * @throws Exception When `WC_Data_Store::load` validation fails. + * @return int New row ID or 0. */ function wc_add_order_item_meta( $item_id, $meta_key, $meta_value, $unique = false ) { $data_store = WC_Data_Store::load( 'order-item' ); - if ( $meta_id = $data_store->add_metadata( $item_id, $meta_key, $meta_value, $unique ) ) { + $meta_id = $data_store->add_metadata( $item_id, $meta_key, $meta_value, $unique ); + + if ( $meta_id ) { WC_Cache_Helper::incr_cache_prefix( 'object_' . $item_id ); // Invalidate cache. return $meta_id; } @@ -127,11 +135,12 @@ function wc_add_order_item_meta( $item_id, $meta_key, $meta_value, $unique = fal /** * WooCommerce Order Item Meta API - Delete term meta. * - * @access public - * @param mixed $item_id - * @param mixed $meta_key - * @param string $meta_value (default: '') - * @param bool $delete_all (default: false) + * @param int $item_id Item ID. + * @param string $meta_key Meta key. + * @param string $meta_value Meta value (default: ''). + * @param bool $delete_all Delete all meta data, defaults to `false`. + * + * @throws Exception When `WC_Data_Store::load` validation fails. * @return bool */ function wc_delete_order_item_meta( $item_id, $meta_key, $meta_value = '', $delete_all = false ) { @@ -146,10 +155,11 @@ function wc_delete_order_item_meta( $item_id, $meta_key, $meta_value = '', $dele /** * WooCommerce Order Item Meta API - Get term meta. * - * @access public - * @param mixed $item_id - * @param mixed $key - * @param bool $single (default: true) + * @param int $item_id Item ID. + * @param string $key Meta key. + * @param bool $single Whether to return a single value. (default: true). + * + * @throws Exception When `WC_Data_Store::load` validation fails. * @return mixed */ function wc_get_order_item_meta( $item_id, $key, $single = true ) { @@ -160,7 +170,9 @@ function wc_get_order_item_meta( $item_id, $key, $single = true ) { /** * Get order ID by order item ID. * - * @param int $item_id + * @param int $item_id Item ID. + * + * @throws Exception When `WC_Data_Store::load` validation fails. * @return int */ function wc_get_order_id_by_order_item_id( $item_id ) { diff --git a/includes/wc-page-functions.php b/includes/wc-page-functions.php index 4a8109eb201..1b6c8220cd3 100644 --- a/includes/wc-page-functions.php +++ b/includes/wc-page-functions.php @@ -4,30 +4,25 @@ * * Functions related to pages and menus. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions + * @package WooCommerce\Functions * @version 2.6.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; /** * Replace a page title with the endpoint title. - * @param string $title + * + * @param string $title Post title. * @return string */ function wc_page_endpoint_title( $title ) { global $wp_query; if ( ! is_null( $wp_query ) && ! is_admin() && is_main_query() && in_the_loop() && is_page() && is_wc_endpoint_url() ) { - $endpoint = WC()->query->get_current_endpoint(); - - if ( $endpoint_title = WC()->query->get_endpoint_title( $endpoint ) ) { - $title = $endpoint_title; - } + $endpoint = WC()->query->get_current_endpoint(); + $endpoint_title = WC()->query->get_endpoint_title( $endpoint ); + $title = $endpoint_title ? $endpoint_title : $title; remove_filter( 'the_title', 'wc_page_endpoint_title' ); } @@ -40,12 +35,11 @@ add_filter( 'the_title', 'wc_page_endpoint_title' ); /** * Retrieve page ids - used for myaccount, edit_address, shop, cart, checkout, pay, view_order, terms. returns -1 if no page is found. * - * @param string $page + * @param string $page Page slug. * @return int */ function wc_get_page_id( $page ) { - - if ( 'pay' == $page || 'thanks' == $page ) { + if ( 'pay' === $page || 'thanks' === $page ) { wc_deprecated_argument( __FUNCTION__, '2.1', 'The "pay" and "thanks" pages are no-longer used - an endpoint is added to the checkout instead. To get a valid link use the WC_Order::get_checkout_payment_url() or WC_Order::get_checkout_order_received_url() methods instead.' ); $page = 'checkout'; @@ -64,12 +58,18 @@ function wc_get_page_id( $page ) { /** * Retrieve page permalink. * - * @param string $page + * @param string $page page slug. + * @param string|bool $fallback Fallback URL if page is not set. Defaults to home URL. @since 3.4.0. * @return string */ -function wc_get_page_permalink( $page ) { +function wc_get_page_permalink( $page, $fallback = null ) { $page_id = wc_get_page_id( $page ); - $permalink = 0 < $page_id ? get_permalink( $page_id ) : get_home_url(); + $permalink = 0 < $page_id ? get_permalink( $page_id ) : ''; + + if ( ! $permalink ) { + $permalink = is_null( $fallback ) ? get_home_url() : $fallback; + } + return apply_filters( 'woocommerce_get_' . $page . '_page_permalink', $permalink ); } @@ -78,9 +78,9 @@ function wc_get_page_permalink( $page ) { * * Gets the URL for an endpoint, which varies depending on permalink settings. * - * @param string $endpoint - * @param string $value - * @param string $permalink + * @param string $endpoint Endpoint slug. + * @param string $value Query param value. + * @param string $permalink Permalink. * * @return string */ @@ -89,18 +89,25 @@ function wc_get_endpoint_url( $endpoint, $value = '', $permalink = '' ) { $permalink = get_permalink(); } - // Map endpoint to options - $endpoint = ! empty( WC()->query->query_vars[ $endpoint ] ) ? WC()->query->query_vars[ $endpoint ] : $endpoint; - $value = ( get_option( 'woocommerce_myaccount_edit_address_endpoint', 'edit-address' ) === $endpoint ) ? wc_edit_address_i18n( $value ) : $value; + // Map endpoint to options. + $query_vars = WC()->query->get_query_vars(); + $endpoint = ! empty( $query_vars[ $endpoint ] ) ? $query_vars[ $endpoint ] : $endpoint; + $value = ( get_option( 'woocommerce_myaccount_edit_address_endpoint', 'edit-address' ) === $endpoint ) ? wc_edit_address_i18n( $value ) : $value; if ( get_option( 'permalink_structure' ) ) { if ( strstr( $permalink, '?' ) ) { - $query_string = '?' . parse_url( $permalink, PHP_URL_QUERY ); + $query_string = '?' . wp_parse_url( $permalink, PHP_URL_QUERY ); $permalink = current( explode( '?', $permalink ) ); } else { $query_string = ''; } - $url = trailingslashit( $permalink ) . $endpoint . '/' . $value . $query_string; + $url = trailingslashit( $permalink ) . trailingslashit( $endpoint ); + + if ( $value ) { + $url .= trailingslashit( $value ); + } + + $url .= $query_string; } else { $url = add_query_arg( $endpoint, $value, $permalink ); } @@ -111,17 +118,21 @@ function wc_get_endpoint_url( $endpoint, $value = '', $permalink = '' ) { /** * Hide menu items conditionally. * - * @param array $items + * @param array $items Navigation items. * @return array */ function wc_nav_menu_items( $items ) { if ( ! is_user_logged_in() ) { $customer_logout = get_option( 'woocommerce_logout_endpoint', 'customer-logout' ); - if ( ! empty( $customer_logout ) ) { + if ( ! empty( $customer_logout ) && ! empty( $items ) && is_array( $items ) ) { foreach ( $items as $key => $item ) { - $path = parse_url( $item->url, PHP_URL_PATH ); - $query = parse_url( $item->url, PHP_URL_QUERY ); + if ( empty( $item->url ) ) { + continue; + } + $path = wp_parse_url( $item->url, PHP_URL_PATH ); + $query = wp_parse_url( $item->url, PHP_URL_QUERY ); + if ( strstr( $path, $customer_logout ) || strstr( $query, $customer_logout ) ) { unset( $items[ $key ] ); } @@ -137,47 +148,46 @@ add_filter( 'wp_nav_menu_objects', 'wc_nav_menu_items', 10 ); /** * Fix active class in nav for shop page. * - * @param array $menu_items + * @param array $menu_items Menu items. * @return array */ function wc_nav_menu_item_classes( $menu_items ) { - if ( ! is_woocommerce() ) { return $menu_items; } - $shop_page = (int) wc_get_page_id( 'shop' ); + $shop_page = wc_get_page_id( 'shop' ); $page_for_posts = (int) get_option( 'page_for_posts' ); - foreach ( (array) $menu_items as $key => $menu_item ) { + if ( ! empty( $menu_items ) && is_array( $menu_items ) ) { + foreach ( $menu_items as $key => $menu_item ) { + $classes = (array) $menu_item->classes; + $menu_id = (int) $menu_item->object_id; - $classes = (array) $menu_item->classes; + // Unset active class for blog page. + if ( $page_for_posts === $menu_id ) { + $menu_items[ $key ]->current = false; - // Unset active class for blog page - if ( $page_for_posts == $menu_item->object_id ) { - $menu_items[ $key ]->current = false; + if ( in_array( 'current_page_parent', $classes, true ) ) { + unset( $classes[ array_search( 'current_page_parent', $classes, true ) ] ); + } - if ( in_array( 'current_page_parent', $classes ) ) { - unset( $classes[ array_search( 'current_page_parent', $classes ) ] ); + if ( in_array( 'current-menu-item', $classes, true ) ) { + unset( $classes[ array_search( 'current-menu-item', $classes, true ) ] ); + } + } elseif ( is_shop() && $shop_page === $menu_id && 'page' === $menu_item->object ) { + // Set active state if this is the shop page link. + $menu_items[ $key ]->current = true; + $classes[] = 'current-menu-item'; + $classes[] = 'current_page_item'; + + } elseif ( is_singular( 'product' ) && $shop_page === $menu_id ) { + // Set parent state if this is a product page. + $classes[] = 'current_page_parent'; } - if ( in_array( 'current-menu-item', $classes ) ) { - unset( $classes[ array_search( 'current-menu-item', $classes ) ] ); - } - - // Set active state if this is the shop page link - } elseif ( is_shop() && $shop_page == $menu_item->object_id && 'page' === $menu_item->object ) { - $menu_items[ $key ]->current = true; - $classes[] = 'current-menu-item'; - $classes[] = 'current_page_item'; - - // Set parent state if this is a product page - } elseif ( is_singular( 'product' ) && $shop_page == $menu_item->object_id ) { - $classes[] = 'current_page_parent'; + $menu_items[ $key ]->classes = array_unique( $classes ); } - - $menu_items[ $key ]->classes = array_unique( $classes ); - } return $menu_items; @@ -188,28 +198,27 @@ add_filter( 'wp_nav_menu_objects', 'wc_nav_menu_item_classes', 2 ); /** * Fix active class in wp_list_pages for shop page. * - * https://github.com/woocommerce/woocommerce/issues/177. + * See details in https://github.com/woocommerce/woocommerce/issues/177. * - * @author Jessor, Peter Sterling - * @param string $pages + * @param string $pages Pages list. * @return string */ function wc_list_pages( $pages ) { - if ( is_woocommerce() ) { - // Remove current_page_parent class from any item. - $pages = str_replace( 'current_page_parent', '', $pages ); - // Find shop_page_id through woocommerce options. - $shop_page = 'page-item-' . wc_get_page_id( 'shop' ); - - if ( is_shop() ) { - // Add current_page_item class to shop page. - $pages = str_replace( $shop_page, $shop_page . ' current_page_item', $pages ); - } else { - // Add current_page_parent class to shop page. - $pages = str_replace( $shop_page, $shop_page . ' current_page_parent', $pages ); - } + if ( ! is_woocommerce() ) { + return $pages; } - return $pages; + // Remove current_page_parent class from any item. + $pages = str_replace( 'current_page_parent', '', $pages ); + // Find shop_page_id through woocommerce options. + $shop_page = 'page-item-' . wc_get_page_id( 'shop' ); + + if ( is_shop() ) { + // Add current_page_item class to shop page. + return str_replace( $shop_page, $shop_page . ' current_page_item', $pages ); + } + + // Add current_page_parent class to shop page. + return str_replace( $shop_page, $shop_page . ' current_page_parent', $pages ); } add_filter( 'wp_list_pages', 'wc_list_pages' ); diff --git a/includes/wc-product-functions.php b/includes/wc-product-functions.php index 3858aeb1200..edede570e02 100644 --- a/includes/wc-product-functions.php +++ b/includes/wc-product-functions.php @@ -1,75 +1,29 @@ array of data (return value above), - * 'total' => total number of products matching the query - * 'max_num_pages' => max number of pages found + * Args and usage: https://github.com/woocommerce/woocommerce/wiki/wc_get_products-and-WC_Product_Query * * @since 3.0.0 - * @param array $args Array of args (above) + * @param array $args Array of args (above). * @return array|stdClass Number of pages and an array of product objects if * paginate is true, or just an array of values. */ function wc_get_products( $args ) { - $args = wp_parse_args( $args, array( - 'status' => array( 'draft', 'pending', 'private', 'publish' ), - 'type' => array_merge( array_keys( wc_get_product_types() ) ), - 'parent' => null, - 'sku' => '', - 'category' => array(), - 'tag' => array(), - 'limit' => get_option( 'posts_per_page' ), - 'offset' => null, - 'page' => 1, - 'include' => array(), - 'exclude' => array(), - 'orderby' => 'date', - 'order' => 'DESC', - 'return' => 'objects', - 'paginate' => false, - 'shipping_class' => array(), - ) ); - // Handle some BW compatibility arg names where wp_query args differ in naming. $map_legacy = array( 'numberposts' => 'limit', @@ -85,7 +39,8 @@ function wc_get_products( $args ) { } } - return WC_Data_Store::load( 'product' )->get_products( $args ); + $query = new WC_Product_Query( $args ); + return $query->get_products(); } /** @@ -99,7 +54,8 @@ function wc_get_products( $args ) { */ function wc_get_product( $the_product = false, $deprecated = array() ) { if ( ! did_action( 'woocommerce_init' ) ) { - wc_doing_it_wrong( __FUNCTION__, __( 'wc_get_product should not be called before the woocommerce_init action.', 'woocommerce' ), '2.5' ); + /* translators: 1: wc_get_product 2: woocommerce_init */ + wc_doing_it_wrong( __FUNCTION__, sprintf( __( '%1$s should not be called before the %2$s action.', 'woocommerce' ), 'wc_get_product', 'woocommerce_init' ), '2.5' ); return false; } if ( ! empty( $deprecated ) ) { @@ -110,6 +66,7 @@ function wc_get_product( $the_product = false, $deprecated = array() ) { /** * Returns whether or not SKUS are enabled. + * * @return bool */ function wc_product_sku_enabled() { @@ -118,6 +75,7 @@ function wc_product_sku_enabled() { /** * Returns whether or not product weights are enabled. + * * @return bool */ function wc_product_weight_enabled() { @@ -126,6 +84,7 @@ function wc_product_weight_enabled() { /** * Returns whether or not product dimensions (HxWxD) are enabled. + * * @return bool */ function wc_product_dimensions_enabled() { @@ -135,18 +94,19 @@ function wc_product_dimensions_enabled() { /** * Clear all transients cache for product data. * - * @param int $post_id (default: 0) + * @param int $post_id (default: 0). */ function wc_delete_product_transients( $post_id = 0 ) { - // Core transients + // Core transients. $transients_to_clear = array( 'wc_products_onsale', 'wc_featured_products', 'wc_outofstock_count', 'wc_low_stock_count', + 'wc_count_comments', ); - // Transient names that include an ID + // Transient names that include an ID. $post_transient_names = array( 'wc_product_children_', 'wc_var_prices_', @@ -163,17 +123,26 @@ function wc_delete_product_transients( $post_id = 0 ) { // Does this product have a parent? $product = wc_get_product( $post_id ); - if ( $product && $product->get_parent_id() > 0 ) { - wc_delete_product_transients( $product->get_parent_id() ); + if ( $product ) { + if ( $product->get_parent_id() > 0 ) { + wc_delete_product_transients( $product->get_parent_id() ); + } + + if ( 'variable' === $product->get_type() ) { + wp_cache_delete( + WC_Cache_Helper::get_cache_prefix( 'products' ) . 'product_variation_attributes_' . $product->get_id(), + 'products' + ); + } } } - // Delete transients + // Delete transients. foreach ( $transients_to_clear as $transient ) { delete_transient( $transient ); } - // Increments the transient version to invalidate cache + // Increments the transient version to invalidate cache. WC_Cache_Helper::get_transient_version( 'product', true ); do_action( 'woocommerce_delete_product_transients', $post_id ); @@ -186,10 +155,10 @@ function wc_delete_product_transients( $post_id = 0 ) { * @return array */ function wc_get_product_ids_on_sale() { - // Load from cache + // Load from cache. $product_ids_on_sale = get_transient( 'wc_products_onsale' ); - // Valid cache found + // Valid cache found. if ( false !== $product_ids_on_sale ) { return $product_ids_on_sale; } @@ -210,10 +179,10 @@ function wc_get_product_ids_on_sale() { * @return array */ function wc_get_featured_product_ids() { - // Load from cache + // Load from cache. $featured_product_ids = get_transient( 'wc_featured_products' ); - // Valid cache found + // Valid cache found. if ( false !== $featured_product_ids ) { return $featured_product_ids; } @@ -233,7 +202,7 @@ function wc_get_featured_product_ids() { * Filter to allow product_cat in the permalinks for products. * * @param string $permalink The existing permalink URL. - * @param WP_Post $post + * @param WP_Post $post WP_Post object. * @return string */ function wc_product_post_type_link( $permalink, $post ) { @@ -268,7 +237,7 @@ function wc_product_post_type_link( $permalink, $post ) { } } } else { - // If no terms are assigned to this post, use a string instead (can't leave the placeholder there) + // If no terms are assigned to this post, use a string instead (can't leave the placeholder there). $product_cat = _x( 'uncategorized', 'slug', 'woocommerce' ); } @@ -306,26 +275,38 @@ add_filter( 'post_type_link', 'wc_product_post_type_link', 10, 2 ); /** * Get the placeholder image URL for products etc. * - * @access public + * @param string $size Image size. * @return string */ -function wc_placeholder_img_src() { - return apply_filters( 'woocommerce_placeholder_img_src', WC()->plugin_url() . '/assets/images/placeholder.png' ); +function wc_placeholder_img_src( $size = 'woocommerce_thumbnail' ) { + $src = WC()->plugin_url() . '/assets/images/placeholder.png'; + $placeholder_image = get_option( 'woocommerce_placeholder_image', 0 ); + + if ( ! empty( $placeholder_image ) ) { + if ( is_numeric( $placeholder_image ) ) { + $image = wp_get_attachment_image_src( $placeholder_image, $size ); + + if ( ! empty( $image[0] ) ) { + $src = $image[0]; + } + } else { + $src = $placeholder_image; + } + } + + return apply_filters( 'woocommerce_placeholder_img_src', $src ); } /** * Get the placeholder image. * - * @access public - * - * @param string $size - * + * @param string $size Image size. * @return string */ -function wc_placeholder_img( $size = 'shop_thumbnail' ) { +function wc_placeholder_img( $size = 'woocommerce_thumbnail' ) { $dimensions = wc_get_image_size( $size ); - return apply_filters( 'woocommerce_placeholder_img', '' . esc_attr__( 'Placeholder', 'woocommerce' ) . '', $size, $dimensions ); + return apply_filters( 'woocommerce_placeholder_img', '' . esc_attr__( 'Placeholder', 'woocommerce' ) . '', $size, $dimensions ); } /** @@ -333,19 +314,22 @@ function wc_placeholder_img( $size = 'shop_thumbnail' ) { * * Gets a formatted version of variation data or item meta. * - * @param array|WC_Product_Variation $variation - * @param bool $flat (default: false) - * @param bool $include_names include attribute names/labels + * @param array|WC_Product_Variation $variation Variation object. + * @param bool $flat Should this be a flat list or HTML list? (default: false). + * @param bool $include_names include attribute names/labels in the list. + * @param bool $skip_attributes_in_name Do not list attributes already part of the variation name. * @return string */ -function wc_get_formatted_variation( $variation, $flat = false, $include_names = true ) { +function wc_get_formatted_variation( $variation, $flat = false, $include_names = true, $skip_attributes_in_name = false ) { $return = ''; if ( is_a( $variation, 'WC_Product_Variation' ) ) { $variation_attributes = $variation->get_attributes(); $product = $variation; + $variation_name = $variation->get_name(); } else { - $product = false; + $product = false; + $variation_name = ''; // Remove attribute_ prefix from names. $variation_attributes = array(); if ( is_array( $variation ) ) { @@ -366,11 +350,7 @@ function wc_get_formatted_variation( $variation, $flat = false, $include_names = $variation_list = array(); foreach ( $variation_attributes as $name => $value ) { - if ( ! $value ) { - continue; - } - - // If this is a term slug, get the term's nice name + // If this is a term slug, get the term's nice name. if ( taxonomy_exists( $name ) ) { $term = get_term_by( 'slug', $value, $name ); if ( ! is_wp_error( $term ) && ! empty( $term->name ) ) { @@ -378,6 +358,11 @@ function wc_get_formatted_variation( $variation, $flat = false, $include_names = } } + // Do not list attributes already part of the variation name. + if ( '' === $value || ( $skip_attributes_in_name && wc_is_attribute_in_product_name( $value, $variation_name ) ) ) { + continue; + } + if ( $include_names ) { if ( $flat ) { $variation_list[] = wc_attribute_label( $name, $product ) . ': ' . rawurldecode( $value ); @@ -412,11 +397,14 @@ function wc_get_formatted_variation( $variation, $flat = false, $include_names = function wc_scheduled_sales() { $data_store = WC_Data_Store::load( 'product' ); - // Sales which are due to start + // Sales which are due to start. $product_ids = $data_store->get_starting_sales(); if ( $product_ids ) { + do_action( 'wc_before_products_starting_sales', $product_ids ); foreach ( $product_ids as $product_id ) { - if ( $product = wc_get_product( $product_id ) ) { + $product = wc_get_product( $product_id ); + + if ( $product ) { $sale_price = $product->get_sale_price(); if ( $sale_price ) { @@ -430,15 +418,19 @@ function wc_scheduled_sales() { $product->save(); } } + do_action( 'wc_after_products_starting_sales', $product_ids ); delete_transient( 'wc_products_onsale' ); } - // Sales which are due to end + // Sales which are due to end. $product_ids = $data_store->get_ending_sales(); if ( $product_ids ) { + do_action( 'wc_before_products_ending_sales', $product_ids ); foreach ( $product_ids as $product_id ) { - if ( $product = wc_get_product( $product_id ) ) { + $product = wc_get_product( $product_id ); + + if ( $product ) { $regular_price = $product->get_regular_price(); $product->set_price( $regular_price ); $product->set_sale_price( '' ); @@ -447,6 +439,7 @@ function wc_scheduled_sales() { $product->save(); } } + do_action( 'wc_after_products_ending_sales', $product_ids ); WC_Cache_Helper::get_transient_version( 'product', true ); delete_transient( 'wc_products_onsale' ); @@ -457,13 +450,16 @@ add_action( 'woocommerce_scheduled_sales', 'wc_scheduled_sales' ); /** * Get attachment image attributes. * - * @access public - * @param array $attr + * @param array $attr Image attributes. * @return array */ function wc_get_attachment_image_attributes( $attr ) { - if ( strstr( $attr['src'][0], 'woocommerce_uploads/' ) ) { - $attr['src'][0] = wc_placeholder_img_src(); + if ( isset( $attr['src'] ) && strstr( $attr['src'], 'woocommerce_uploads/' ) ) { + $attr['src'] = wc_placeholder_img_src(); + + if ( isset( $attr['srcset'] ) ) { + $attr['srcset'] = ''; + } } return $attr; } @@ -473,8 +469,7 @@ add_filter( 'wp_get_attachment_image_attributes', 'wc_get_attachment_image_attri /** * Prepare attachment for JavaScript. * - * @access public - * @param array $response + * @param array $response JS version of a attachment post object. * @return array */ function wc_prepare_attachment_for_js( $response ) { @@ -502,21 +497,26 @@ function wc_track_product_view() { global $post; - if ( empty( $_COOKIE['woocommerce_recently_viewed'] ) ) { + if ( empty( $_COOKIE['woocommerce_recently_viewed'] ) ) { // @codingStandardsIgnoreLine. $viewed_products = array(); } else { - $viewed_products = (array) explode( '|', $_COOKIE['woocommerce_recently_viewed'] ); + $viewed_products = wp_parse_id_list( (array) explode( '|', wp_unslash( $_COOKIE['woocommerce_recently_viewed'] ) ) ); // @codingStandardsIgnoreLine. } - if ( ! in_array( $post->ID, $viewed_products ) ) { - $viewed_products[] = $post->ID; + // Unset if already in viewed products list. + $keys = array_flip( $viewed_products ); + + if ( isset( $keys[ $post->ID ] ) ) { + unset( $viewed_products[ $keys[ $post->ID ] ] ); } - if ( sizeof( $viewed_products ) > 15 ) { + $viewed_products[] = $post->ID; + + if ( count( $viewed_products ) > 15 ) { array_shift( $viewed_products ); } - // Store for session only + // Store for session only. wc_setcookie( 'woocommerce_recently_viewed', implode( '|', $viewed_products ) ); } @@ -529,20 +529,22 @@ add_action( 'template_redirect', 'wc_track_product_view', 20 ); * @return array */ function wc_get_product_types() { - return (array) apply_filters( 'product_type_selector', array( - 'simple' => __( 'Simple product', 'woocommerce' ), - 'grouped' => __( 'Grouped product', 'woocommerce' ), - 'external' => __( 'External/Affiliate product', 'woocommerce' ), - 'variable' => __( 'Variable product', 'woocommerce' ), - ) ); + return (array) apply_filters( + 'product_type_selector', array( + 'simple' => __( 'Simple product', 'woocommerce' ), + 'grouped' => __( 'Grouped product', 'woocommerce' ), + 'external' => __( 'External/Affiliate product', 'woocommerce' ), + 'variable' => __( 'Variable product', 'woocommerce' ), + ) + ); } /** * Check if product sku is unique. * * @since 2.2 - * @param int $product_id - * @param string $sku + * @param int $product_id Product ID. + * @param string $sku Product SKU. * @return bool */ function wc_product_has_unique_sku( $product_id, $sku ) { @@ -551,21 +553,22 @@ function wc_product_has_unique_sku( $product_id, $sku ) { if ( apply_filters( 'wc_product_has_unique_sku', $sku_found, $product_id, $sku ) ) { return false; - } else { - return true; } + + return true; } /** * Force a unique SKU. * * @since 3.0.0 - * @param integer $product_id + * @param integer $product_id Product ID. */ function wc_product_force_unique_sku( $product_id ) { - $product = wc_get_product( $product_id ); + $product = wc_get_product( $product_id ); + $current_sku = $product ? $product->get_sku( 'edit' ) : ''; - if ( $product && ( $current_sku = $product->get_sku( 'edit' ) ) ) { + if ( $current_sku ) { try { $new_sku = wc_product_generate_unique_sku( $product_id, $current_sku ); @@ -573,7 +576,7 @@ function wc_product_force_unique_sku( $product_id ) { $product->set_sku( $new_sku ); $product->save(); } - } catch ( Exception $e ) {} + } catch ( Exception $e ) {} // @codingStandardsIgnoreLine. } } @@ -581,9 +584,9 @@ function wc_product_force_unique_sku( $product_id ) { * Recursively appends a suffix until a unique SKU is found. * * @since 3.0.0 - * @param integer $product_id - * @param string $sku - * @param integer $index + * @param integer $product_id Product ID. + * @param string $sku Product SKU. + * @param integer $index An optional index that can be added to the product SKU. * @return string */ function wc_product_generate_unique_sku( $product_id, $sku, $index = 0 ) { @@ -600,46 +603,44 @@ function wc_product_generate_unique_sku( $product_id, $sku, $index = 0 ) { * Get product ID by SKU. * * @since 2.3.0 - * @param string $sku + * @param string $sku Product SKU. * @return int */ function wc_get_product_id_by_sku( $sku ) { $data_store = WC_Data_Store::load( 'product' ); - $product_id = $data_store->get_product_id_by_sku( $sku ); - - return ( $product_id ) ? intval( $product_id ) : 0; + return $data_store->get_product_id_by_sku( $sku ); } /** * Get attibutes/data for an individual variation from the database and maintain it's integrity. - * @param revisit? + * * @since 2.4.0 - * @param int $variation_id + * @param int $variation_id Variation ID. * @return array */ function wc_get_product_variation_attributes( $variation_id ) { - // Build variation data from meta + // Build variation data from meta. $all_meta = get_post_meta( $variation_id ); $parent_id = wp_get_post_parent_id( $variation_id ); $parent_attributes = array_filter( (array) get_post_meta( $parent_id, '_product_attributes', true ) ); $found_parent_attributes = array(); $variation_attributes = array(); - // Compare to parent variable product attributes and ensure they match + // Compare to parent variable product attributes and ensure they match. foreach ( $parent_attributes as $attribute_name => $options ) { if ( ! empty( $options['is_variation'] ) ) { $attribute = 'attribute_' . sanitize_title( $attribute_name ); $found_parent_attributes[] = $attribute; if ( ! array_key_exists( $attribute, $variation_attributes ) ) { - $variation_attributes[ $attribute ] = ''; // Add it - 'any' will be asumed + $variation_attributes[ $attribute ] = ''; // Add it - 'any' will be asumed. } } } - // Get the variation attributes from meta + // Get the variation attributes from meta. foreach ( $all_meta as $name => $value ) { - // Only look at valid attribute meta, and also compare variation level attributes and remove any which do not exist at parent level - if ( 0 !== strpos( $name, 'attribute_' ) || ! in_array( $name, $found_parent_attributes ) ) { + // Only look at valid attribute meta, and also compare variation level attributes and remove any which do not exist at parent level. + if ( 0 !== strpos( $name, 'attribute_' ) || ! in_array( $name, $found_parent_attributes, true ) ) { unset( $variation_attributes[ $name ] ); continue; } @@ -671,8 +672,9 @@ function wc_get_product_variation_attributes( $variation_id ) { /** * Get all product cats for a product by ID, including hierarchy + * * @since 2.5.0 - * @param int $product_id + * @param int $product_id Product ID. * @return array */ function wc_get_product_cat_ids( $product_id ) { @@ -687,15 +689,16 @@ function wc_get_product_cat_ids( $product_id ) { /** * Gets data about an attachment, such as alt text and captions. + * * @since 2.6.0 * - * @param int $attachment_id - * @param object $product + * @param int|null $attachment_id Attachment ID. + * @param WC_Product|bool $product WC_Product object. * * @return array */ function wc_get_product_attachment_props( $attachment_id = null, $product = false ) { - $props = array( + $props = array( 'title' => '', 'caption' => '', 'url' => '', @@ -704,36 +707,53 @@ function wc_get_product_attachment_props( $attachment_id = null, $product = fals 'srcset' => false, 'sizes' => false, ); - if ( $attachment = get_post( $attachment_id ) ) { - $props['title'] = trim( strip_tags( $attachment->post_title ) ); - $props['caption'] = trim( strip_tags( $attachment->post_excerpt ) ); + $attachment = get_post( $attachment_id ); + + if ( $attachment ) { + $props['title'] = wp_strip_all_tags( $attachment->post_title ); + $props['caption'] = wp_strip_all_tags( $attachment->post_excerpt ); $props['url'] = wp_get_attachment_url( $attachment_id ); - $props['alt'] = trim( strip_tags( get_post_meta( $attachment_id, '_wp_attachment_image_alt', true ) ) ); + + // Alt text. + $alt_text = array( wp_strip_all_tags( get_post_meta( $attachment_id, '_wp_attachment_image_alt', true ) ), $props['caption'], wp_strip_all_tags( $attachment->post_title ) ); + + if ( $product && $product instanceof WC_Product ) { + $alt_text[] = wp_strip_all_tags( get_the_title( $product->get_id() ) ); + } + + $alt_text = array_filter( $alt_text ); + $props['alt'] = isset( $alt_text[0] ) ? $alt_text[0] : ''; // Large version. - $src = wp_get_attachment_image_src( $attachment_id, 'full' ); + $full_size = apply_filters( 'woocommerce_gallery_full_size', apply_filters( 'woocommerce_product_thumbnails_large_size', 'full' ) ); + $src = wp_get_attachment_image_src( $attachment_id, $full_size ); $props['full_src'] = $src[0]; $props['full_src_w'] = $src[1]; $props['full_src_h'] = $src[2]; + // Gallery thumbnail. + $gallery_thumbnail = wc_get_image_size( 'gallery_thumbnail' ); + $gallery_thumbnail_size = apply_filters( 'woocommerce_gallery_thumbnail_size', array( $gallery_thumbnail['width'], $gallery_thumbnail['height'] ) ); + $src = wp_get_attachment_image_src( $attachment_id, $gallery_thumbnail_size ); + $props['gallery_thumbnail_src'] = $src[0]; + $props['gallery_thumbnail_src_w'] = $src[1]; + $props['gallery_thumbnail_src_h'] = $src[2]; + // Thumbnail version. - $src = wp_get_attachment_image_src( $attachment_id, 'shop_thumbnail' ); + $thumbnail_size = apply_filters( 'woocommerce_thumbnail_size', 'woocommerce_thumbnail' ); + $src = wp_get_attachment_image_src( $attachment_id, $thumbnail_size ); $props['thumb_src'] = $src[0]; $props['thumb_src_w'] = $src[1]; $props['thumb_src_h'] = $src[2]; // Image source. - $src = wp_get_attachment_image_src( $attachment_id, 'shop_single' ); + $image_size = apply_filters( 'woocommerce_gallery_image_size', 'woocommerce_single' ); + $src = wp_get_attachment_image_src( $attachment_id, $image_size ); $props['src'] = $src[0]; $props['src_w'] = $src[1]; $props['src_h'] = $src[2]; - $props['srcset'] = function_exists( 'wp_get_attachment_image_srcset' ) ? wp_get_attachment_image_srcset( $attachment_id, 'shop_single' ) : false; - $props['sizes'] = function_exists( 'wp_get_attachment_image_sizes' ) ? wp_get_attachment_image_sizes( $attachment_id, 'shop_single' ) : false; - - // Alt text fallbacks - $props['alt'] = empty( $props['alt'] ) ? $props['caption'] : $props['alt']; - $props['alt'] = empty( $props['alt'] ) ? trim( strip_tags( $attachment->post_title ) ) : $props['alt']; - $props['alt'] = empty( $props['alt'] ) && $product ? trim( strip_tags( get_the_title( $product->ID ) ) ) : $props['alt']; + $props['srcset'] = function_exists( 'wp_get_attachment_image_srcset' ) ? wp_get_attachment_image_srcset( $attachment_id, $image_size ) : false; + $props['sizes'] = function_exists( 'wp_get_attachment_image_sizes' ) ? wp_get_attachment_image_sizes( $attachment_id, $image_size ) : false; } return $props; } @@ -745,12 +765,14 @@ function wc_get_product_attachment_props( $attachment_id = null, $product = fals * @return array */ function wc_get_product_visibility_options() { - return apply_filters( 'woocommerce_product_visibility_options', array( - 'visible' => __( 'Shop and search results', 'woocommerce' ), - 'catalog' => __( 'Shop only', 'woocommerce' ), - 'search' => __( 'Search results only', 'woocommerce' ), - 'hidden' => __( 'Hidden', 'woocommerce' ), - ) ); + return apply_filters( + 'woocommerce_product_visibility_options', array( + 'visible' => __( 'Shop and search results', 'woocommerce' ), + 'catalog' => __( 'Shop only', 'woocommerce' ), + 'search' => __( 'Search results only', 'woocommerce' ), + 'hidden' => __( 'Hidden', 'woocommerce' ), + ) + ); } /** @@ -766,27 +788,31 @@ function wc_get_min_max_price_meta_query( $args ) { /** * Adjust if the store taxes are not displayed how they are stored. - * Max is left alone because the filter was already increased. * Kicks in when prices excluding tax are displayed including tax. */ if ( wc_tax_enabled() && 'incl' === get_option( 'woocommerce_tax_display_shop' ) && ! wc_prices_include_tax() ) { $tax_classes = array_merge( array( '' ), WC_Tax::get_tax_classes() ); $class_min = $min; + $class_max = $max; foreach ( $tax_classes as $tax_class ) { - if ( $tax_rates = WC_Tax::get_rates( $tax_class ) ) { - $class_min = $min - WC_Tax::get_tax_total( WC_Tax::calc_exclusive_tax( $min, $tax_rates ) ); + $tax_rates = WC_Tax::get_rates( $tax_class ); + + if ( $tax_rates ) { + $class_min = $min + WC_Tax::get_tax_total( WC_Tax::calc_exclusive_tax( $min, $tax_rates ) ); + $class_max = $max - WC_Tax::get_tax_total( WC_Tax::calc_exclusive_tax( $max, $tax_rates ) ); } } $min = $class_min; + $max = $class_max; } return array( 'key' => '_price', 'value' => array( $min, $max ), 'compare' => 'BETWEEN', - 'type' => 'NUMERIC', + 'type' => 'DECIMAL(10,' . wc_get_price_decimals() . ')', ); } @@ -817,8 +843,9 @@ function wc_get_product_tax_class_options() { */ function wc_get_product_stock_status_options() { return array( - 'instock' => __( 'In stock', 'woocommerce' ), - 'outofstock' => __( 'Out of stock', 'woocommerce' ), + 'instock' => __( 'In stock', 'woocommerce' ), + 'outofstock' => __( 'Out of stock', 'woocommerce' ), + 'onbackorder' => __( 'On backorder', 'woocommerce' ), ); } @@ -846,14 +873,24 @@ function wc_get_product_backorder_options() { * @return array */ function wc_get_related_products( $product_id, $limit = 5, $exclude_ids = array() ) { + $product_id = absint( $product_id ); + $limit = $limit >= -1 ? $limit : 5; $exclude_ids = array_merge( array( 0, $product_id ), $exclude_ids ); $transient_name = 'wc_related_' . $product_id; - $related_posts = get_transient( $transient_name ); - $limit = $limit > 0 ? $limit : 5; + $query_args = http_build_query( + array( + 'limit' => $limit, + 'exclude_ids' => $exclude_ids, + ) + ); + + $transient = get_transient( $transient_name ); + $related_posts = $transient && isset( $transient[ $query_args ] ) ? $transient[ $query_args ] : false; // We want to query related posts if they are not cached, or we don't have enough. if ( false === $related_posts || count( $related_posts ) < $limit ) { + $cats_array = apply_filters( 'woocommerce_product_related_posts_relate_by_category', true, $product_id ) ? apply_filters( 'woocommerce_get_related_product_cat_terms', wc_get_product_term_ids( $product_id, 'product_cat' ), $product_id ) : array(); $tags_array = apply_filters( 'woocommerce_product_related_posts_relate_by_tag', true, $product_id ) ? apply_filters( 'woocommerce_get_related_product_tag_terms', wc_get_product_term_ids( $product_id, 'product_tag' ), $product_id ) : array(); @@ -865,9 +902,22 @@ function wc_get_related_products( $product_id, $limit = 5, $exclude_ids = array( $related_posts = $data_store->get_related_products( $cats_array, $tags_array, $exclude_ids, $limit + 10, $product_id ); } - set_transient( $transient_name, $related_posts, DAY_IN_SECONDS ); + if ( $transient ) { + $transient[ $query_args ] = $related_posts; + } else { + $transient = array( $query_args => $related_posts ); + } + + set_transient( $transient_name, $transient, DAY_IN_SECONDS ); } + $related_posts = apply_filters( + 'woocommerce_related_products', $related_posts, $product_id, array( + 'limit' => $limit, + 'excluded_ids' => $exclude_ids, + ) + ); + shuffle( $related_posts ); return array_slice( $related_posts, 0, $limit ); @@ -888,16 +938,19 @@ function wc_get_product_term_ids( $product_id, $taxonomy ) { /** * For a given product, and optionally price/qty, work out the price with tax included, based on store settings. + * * @since 3.0.0 - * @param WC_Product $product - * @param array $args + * @param WC_Product $product WC_Product object. + * @param array $args Optional arguments to pass product quantity and price. * @return float */ function wc_get_price_including_tax( $product, $args = array() ) { - $args = wp_parse_args( $args, array( - 'qty' => '', - 'price' => '', - ) ); + $args = wp_parse_args( + $args, array( + 'qty' => '', + 'price' => '', + ) + ); $price = '' !== $args['price'] ? max( 0.0, (float) $args['price'] ) : $product->get_price(); $qty = '' !== $args['qty'] ? max( 0.0, (float) $args['qty'] ) : 1; @@ -925,12 +978,12 @@ function wc_get_price_including_tax( $product, $args = array() ) { * If the customer is excempt from VAT, remove the taxes here. * Either remove the base or the user taxes depending on woocommerce_adjust_non_base_location_prices setting. */ - if ( ! empty( WC()->customer ) && WC()->customer->get_is_vat_exempt() ) { + if ( ! empty( WC()->customer ) && WC()->customer->get_is_vat_exempt() ) { // @codingStandardsIgnoreLine. $remove_taxes = apply_filters( 'woocommerce_adjust_non_base_location_prices', true ) ? WC_Tax::calc_tax( $line_price, $base_tax_rates, true ) : WC_Tax::calc_tax( $line_price, $tax_rates, true ); $remove_tax = array_sum( $remove_taxes ); $return_price = round( $line_price - $remove_tax, wc_get_price_decimals() ); - /** + /** * The woocommerce_adjust_non_base_location_prices filter can stop base taxes being taken off when dealing with out of base locations. * e.g. If a product costs 10 including tax, all users will pay 10 regardless of location and taxes. * This feature is experimental @since 2.4.7 and may change in the future. Use at your risk. @@ -938,7 +991,7 @@ function wc_get_price_including_tax( $product, $args = array() ) { } elseif ( $tax_rates !== $base_tax_rates && apply_filters( 'woocommerce_adjust_non_base_location_prices', true ) ) { $base_taxes = WC_Tax::calc_tax( $line_price, $base_tax_rates, true ); $modded_taxes = WC_Tax::calc_tax( $line_price - array_sum( $base_taxes ), $tax_rates, false ); - $return_price = round( $line_price - array_sum( $base_taxes ) + array_sum( $modded_taxes ), wc_get_price_decimals() ); + $return_price = round( $line_price - array_sum( $base_taxes ) + wc_round_tax_total( array_sum( $modded_taxes ), wc_get_price_decimals() ), wc_get_price_decimals() ); } } } @@ -947,16 +1000,19 @@ function wc_get_price_including_tax( $product, $args = array() ) { /** * For a given product, and optionally price/qty, work out the price with tax excluded, based on store settings. + * * @since 3.0.0 - * @param WC_Product $product - * @param array $args + * @param WC_Product $product WC_Product object. + * @param array $args Optional arguments to pass product quantity and price. * @return float */ function wc_get_price_excluding_tax( $product, $args = array() ) { - $args = wp_parse_args( $args, array( - 'qty' => '', - 'price' => '', - ) ); + $args = wp_parse_args( + $args, array( + 'qty' => '', + 'price' => '', + ) + ); $price = '' !== $args['price'] ? max( 0.0, (float) $args['price'] ) : $product->get_price(); $qty = '' !== $args['qty'] ? max( 0.0, (float) $args['qty'] ) : 1; @@ -967,40 +1023,58 @@ function wc_get_price_excluding_tax( $product, $args = array() ) { return 0.0; } + $line_price = $price * $qty; + if ( $product->is_taxable() && wc_prices_include_tax() ) { - $tax_rates = WC_Tax::get_base_tax_rates( $product->get_tax_class( 'unfiltered' ) ); - $taxes = WC_Tax::calc_tax( $price * $qty, $tax_rates, true ); - $price = WC_Tax::round( $price * $qty - array_sum( $taxes ) ); + $tax_rates = WC_Tax::get_rates( $product->get_tax_class() ); + $base_tax_rates = WC_Tax::get_base_tax_rates( $product->get_tax_class( 'unfiltered' ) ); + $remove_taxes = apply_filters( 'woocommerce_adjust_non_base_location_prices', true ) ? WC_Tax::calc_tax( $line_price, $base_tax_rates, true ) : WC_Tax::calc_tax( $line_price, $tax_rates, true ); + $return_price = $line_price - array_sum( $remove_taxes ); } else { - $price = $price * $qty; + $return_price = $line_price; } - return apply_filters( 'woocommerce_get_price_excluding_tax', $price, $qty, $product ); + return apply_filters( 'woocommerce_get_price_excluding_tax', $return_price, $qty, $product ); } /** * Returns the price including or excluding tax, based on the 'woocommerce_tax_display_shop' setting. + * * @since 3.0.0 - * @param WC_Product $product - * @param array $args + * @param WC_Product $product WC_Product object. + * @param array $args Optional arguments to pass product quantity and price. * @return float */ function wc_get_price_to_display( $product, $args = array() ) { - $args = wp_parse_args( $args, array( - 'qty' => 1, - 'price' => $product->get_price(), - ) ); + $args = wp_parse_args( + $args, array( + 'qty' => 1, + 'price' => $product->get_price(), + ) + ); $price = $args['price']; $qty = $args['qty']; - return 'incl' === get_option( 'woocommerce_tax_display_shop' ) ? wc_get_price_including_tax( $product, array( 'qty' => $qty, 'price' => $price ) ) : wc_get_price_excluding_tax( $product, array( 'qty' => $qty, 'price' => $price ) ); + return 'incl' === get_option( 'woocommerce_tax_display_shop' ) ? + wc_get_price_including_tax( + $product, array( + 'qty' => $qty, + 'price' => $price, + ) + ) : + wc_get_price_excluding_tax( + $product, array( + 'qty' => $qty, + 'price' => $price, + ) + ); } /** * Returns the product categories in a list. * - * @param int $product_id + * @param int $product_id Product ID. * @param string $sep (default: ', '). * @param string $before (default: ''). * @param string $after (default: ''). @@ -1013,7 +1087,7 @@ function wc_get_product_category_list( $product_id, $sep = ', ', $before = '', $ /** * Returns the product tags in a list. * - * @param int $product_id + * @param int $product_id Product ID. * @param string $sep (default: ', '). * @param string $before (default: ''). * @param string $after (default: ''). @@ -1025,8 +1099,9 @@ function wc_get_product_tag_list( $product_id, $sep = ', ', $before = '', $after /** * Callback for array filter to get visible only. + * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product WC_Product object. * @return bool */ function wc_products_array_filter_visible( $product ) { @@ -1037,7 +1112,7 @@ function wc_products_array_filter_visible( $product ) { * Callback for array filter to get visible grouped products only. * * @since 3.1.0 - * @param WC_Product $product + * @param WC_Product $product WC_Product object. * @return bool */ function wc_products_array_filter_visible_grouped( $product ) { @@ -1048,20 +1123,32 @@ function wc_products_array_filter_visible_grouped( $product ) { * Callback for array filter to get products the user can edit only. * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product WC_Product object. * @return bool */ function wc_products_array_filter_editable( $product ) { return $product && is_a( $product, 'WC_Product' ) && current_user_can( 'edit_product', $product->get_id() ); } +/** + * Callback for array filter to get products the user can view only. + * + * @since 3.4.0 + * @param WC_Product $product WC_Product object. + * @return bool + */ +function wc_products_array_filter_readable( $product ) { + return $product && is_a( $product, 'WC_Product' ) && current_user_can( 'read_product', $product->get_id() ); +} + /** * Sort an array of products by a value. + * * @since 3.0.0 * - * @param array $products - * @param string $orderby - * @param string $order + * @param array $products List of products to be ordered. + * @param string $orderby Optional order criteria. + * @param string $order Ascending or descending order. * * @return array */ @@ -1069,15 +1156,15 @@ function wc_products_array_orderby( $products, $orderby = 'date', $order = 'desc $orderby = strtolower( $orderby ); $order = strtolower( $order ); switch ( $orderby ) { - case 'title' : - case 'id' : - case 'date' : - case 'modified' : - case 'menu_order' : - case 'price' : + case 'title': + case 'id': + case 'date': + case 'modified': + case 'menu_order': + case 'price': usort( $products, 'wc_products_array_orderby_' . $orderby ); break; - default : + default: shuffle( $products ); break; } @@ -1089,9 +1176,10 @@ function wc_products_array_orderby( $products, $orderby = 'date', $order = 'desc /** * Sort by title. + * * @since 3.0.0 - * @param WC_Product object $a - * @param WC_Product object $b + * @param WC_Product $a First WC_Product object. + * @param WC_Product $b Second WC_Product object. * @return int */ function wc_products_array_orderby_title( $a, $b ) { @@ -1100,9 +1188,10 @@ function wc_products_array_orderby_title( $a, $b ) { /** * Sort by id. + * * @since 3.0.0 - * @param WC_Product object $a - * @param WC_Product object $b + * @param WC_Product $a First WC_Product object. + * @param WC_Product $b Second WC_Product object. * @return int */ function wc_products_array_orderby_id( $a, $b ) { @@ -1114,9 +1203,10 @@ function wc_products_array_orderby_id( $a, $b ) { /** * Sort by date. + * * @since 3.0.0 - * @param WC_Product object $a - * @param WC_Product object $b + * @param WC_Product $a First WC_Product object. + * @param WC_Product $b Second WC_Product object. * @return int */ function wc_products_array_orderby_date( $a, $b ) { @@ -1128,9 +1218,10 @@ function wc_products_array_orderby_date( $a, $b ) { /** * Sort by modified. + * * @since 3.0.0 - * @param WC_Product object $a - * @param WC_Product object $b + * @param WC_Product $a First WC_Product object. + * @param WC_Product $b Second WC_Product object. * @return int */ function wc_products_array_orderby_modified( $a, $b ) { @@ -1142,9 +1233,10 @@ function wc_products_array_orderby_modified( $a, $b ) { /** * Sort by menu order. + * * @since 3.0.0 - * @param WC_Product object $a - * @param WC_Product object $b + * @param WC_Product $a First WC_Product object. + * @param WC_Product $b Second WC_Product object. * @return int */ function wc_products_array_orderby_menu_order( $a, $b ) { @@ -1156,9 +1248,10 @@ function wc_products_array_orderby_menu_order( $a, $b ) { /** * Sort by price low to high. + * * @since 3.0.0 - * @param WC_Product object $a - * @param WC_Product object $b + * @param WC_Product $a First WC_Product object. + * @param WC_Product $b Second WC_Product object. * @return int */ function wc_products_array_orderby_price( $a, $b ) { @@ -1171,7 +1264,7 @@ function wc_products_array_orderby_price( $a, $b ) { /** * Queue a product for syncing at the end of the request. * - * @param int $product_id + * @param int $product_id Product ID. */ function wc_deferred_product_sync( $product_id ) { global $wc_deferred_product_sync; diff --git a/includes/wc-rest-functions.php b/includes/wc-rest-functions.php index d520be122c1..cf2b864483e 100644 --- a/includes/wc-rest-functions.php +++ b/includes/wc-rest-functions.php @@ -4,15 +4,11 @@ * * Functions for REST specific things. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.6.0 + * @package WooCommerce/Functions + * @version 2.6.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; /** * Parses and formats a date for ISO8601/RFC3339. @@ -21,8 +17,8 @@ if ( ! defined( 'ABSPATH' ) ) { * See https://developer.wordpress.org/reference/functions/mysql_to_rfc3339/ * * @since 2.6.0 - * @param string|null|WC_DateTime $date - * @param bool Send false to get local/offset time. + * @param string|null|WC_DateTime $date Date. + * @param bool $utc Send false to get local/offset time. * @return string|null ISO8601/RFC3339 formatted datetime. */ function wc_rest_prepare_date_response( $date, $utc = true ) { @@ -44,33 +40,37 @@ function wc_rest_prepare_date_response( $date, $utc = true ) { /** * Returns image mime types users are allowed to upload via the API. + * * @since 2.6.4 * @return array */ function wc_rest_allowed_image_mime_types() { - return apply_filters( 'woocommerce_rest_allowed_image_mime_types', array( - 'jpg|jpeg|jpe' => 'image/jpeg', - 'gif' => 'image/gif', - 'png' => 'image/png', - 'bmp' => 'image/bmp', - 'tiff|tif' => 'image/tiff', - 'ico' => 'image/x-icon', - ) ); + return apply_filters( + 'woocommerce_rest_allowed_image_mime_types', array( + 'jpg|jpeg|jpe' => 'image/jpeg', + 'gif' => 'image/gif', + 'png' => 'image/png', + 'bmp' => 'image/bmp', + 'tiff|tif' => 'image/tiff', + 'ico' => 'image/x-icon', + ) + ); } /** * Upload image from URL. * * @since 2.6.0 - * @param string $image_url + * @param string $image_url Image URL. * @return array|WP_Error Attachment data or error message. */ function wc_rest_upload_image_from_url( $image_url ) { $file_name = basename( current( explode( '?', $image_url ) ) ); - $parsed_url = @parse_url( $image_url ); + $parsed_url = wp_parse_url( $image_url ); // Check parsed URL. if ( ! $parsed_url || ! is_array( $parsed_url ) ) { + /* translators: %s: image URL */ return new WP_Error( 'woocommerce_rest_invalid_image_url', sprintf( __( 'Invalid URL %s.', 'woocommerce' ), $image_url ), array( 'status' => 400 ) ); } @@ -78,13 +78,21 @@ function wc_rest_upload_image_from_url( $image_url ) { $image_url = esc_url_raw( $image_url ); // Get the file. - $response = wp_safe_remote_get( $image_url, array( - 'timeout' => 10, - ) ); + $response = wp_safe_remote_get( + $image_url, array( + 'timeout' => 10, + ) + ); if ( is_wp_error( $response ) ) { - return new WP_Error( 'woocommerce_rest_invalid_remote_image_url', sprintf( __( 'Error getting remote image %s.', 'woocommerce' ), $image_url ) . ' ' . sprintf( __( 'Error: %s.', 'woocommerce' ), $response->get_error_message() ), array( 'status' => 400 ) ); + return new WP_Error( 'woocommerce_rest_invalid_remote_image_url', + /* translators: %s: image URL */ + sprintf( __( 'Error getting remote image %s.', 'woocommerce' ), $image_url ) . ' ' + /* translators: %s: error message */ + . sprintf( __( 'Error: %s.', 'woocommerce' ), $response->get_error_message() ), array( 'status' => 400 ) + ); } elseif ( 200 !== wp_remote_retrieve_response_code( $response ) ) { + /* translators: %s: image URL */ return new WP_Error( 'woocommerce_rest_invalid_remote_image_url', sprintf( __( 'Error getting remote image %s.', 'woocommerce' ), $image_url ), array( 'status' => 400 ) ); } @@ -94,7 +102,8 @@ function wc_rest_upload_image_from_url( $image_url ) { if ( ! $wp_filetype['type'] ) { $headers = wp_remote_retrieve_headers( $response ); if ( isset( $headers['content-disposition'] ) && strstr( $headers['content-disposition'], 'filename=' ) ) { - $disposition = end( explode( 'filename=', $headers['content-disposition'] ) ); + $content = explode( 'filename=', $headers['content-disposition'] ); + $disposition = end( $content ); $disposition = sanitize_file_name( $disposition ); $file_name = $disposition; } elseif ( isset( $headers['content-type'] ) && strstr( $headers['content-type'], 'image/' ) ) { @@ -102,7 +111,7 @@ function wc_rest_upload_image_from_url( $image_url ) { } unset( $headers ); - // Recheck filetype + // Recheck filetype. $wp_filetype = wp_check_filetype( $file_name, wc_rest_allowed_image_mime_types() ); if ( ! $wp_filetype['type'] ) { @@ -120,8 +129,8 @@ function wc_rest_upload_image_from_url( $image_url ) { // Get filesize. $filesize = filesize( $upload['file'] ); - if ( 0 == $filesize ) { - @unlink( $upload['file'] ); + if ( ! $filesize ) { + @unlink( $upload['file'] ); // @codingStandardsIgnoreLine unset( $upload ); return new WP_Error( 'woocommerce_rest_image_upload_file_error', __( 'Zero size file downloaded.', 'woocommerce' ), array( 'status' => 400 ) ); @@ -137,7 +146,7 @@ function wc_rest_upload_image_from_url( $image_url ) { * * @since 2.6.0 * @param array $upload Upload information from wp_upload_bits. - * @param int $id Post ID. Default to 0. + * @param int $id Post ID. Default to 0. * @return int Attachment ID */ function wc_rest_set_uploaded_image_as_attachment( $upload, $id = 0 ) { @@ -146,10 +155,11 @@ function wc_rest_set_uploaded_image_as_attachment( $upload, $id = 0 ) { $content = ''; if ( ! function_exists( 'wp_generate_attachment_metadata' ) ) { - include_once( ABSPATH . 'wp-admin/includes/image.php' ); + include_once ABSPATH . 'wp-admin/includes/image.php'; } - if ( $image_meta = wp_read_image_metadata( $upload['file'] ) ) { + $image_meta = wp_read_image_metadata( $upload['file'] ); + if ( $image_meta ) { if ( trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) { $title = wc_clean( $image_meta['title'] ); } @@ -162,7 +172,7 @@ function wc_rest_set_uploaded_image_as_attachment( $upload, $id = 0 ) { 'post_mime_type' => $info['type'], 'guid' => $upload['url'], 'post_parent' => $id, - 'post_title' => $title, + 'post_title' => $title ? $title : basename( $upload['file'] ), 'post_content' => $content, ); @@ -178,9 +188,9 @@ function wc_rest_set_uploaded_image_as_attachment( $upload, $id = 0 ) { * Validate reports request arguments. * * @since 2.6.0 - * @param mixed $value - * @param WP_REST_Request $request - * @param string $param + * @param mixed $value Value to valdate. + * @param WP_REST_Request $request Request instance. + * @param string $param Param to validate. * @return WP_Error|boolean */ function wc_rest_validate_reports_request_arg( $value, $request, $param ) { @@ -192,6 +202,7 @@ function wc_rest_validate_reports_request_arg( $value, $request, $param ) { $args = $attributes['args'][ $param ]; if ( 'string' === $args['type'] && ! is_string( $value ) ) { + /* translators: 1: param 2: type */ return new WP_Error( 'woocommerce_rest_invalid_param', sprintf( __( '%1$s is not of type %2$s', 'woocommerce' ), $param, 'string' ) ); } @@ -217,9 +228,9 @@ function wc_rest_validate_reports_request_arg( $value, $request, $param ) { function wc_rest_urlencode_rfc3986( $value ) { if ( is_array( $value ) ) { return array_map( 'wc_rest_urlencode_rfc3986', $value ); - } else { - return str_replace( array( '+', '%7E' ), array( ' ', '~' ), rawurlencode( $value ) ); } + + return str_replace( array( '+', '%7E' ), array( ' ', '~' ), rawurlencode( $value ) ); } /** @@ -243,9 +254,9 @@ function wc_rest_check_post_permissions( $post_type, $context = 'read', $object_ if ( 'revision' === $post_type ) { $permission = false; } else { - $cap = $contexts[ $context ]; + $cap = $contexts[ $context ]; $post_type_object = get_post_type_object( $post_type ); - $permission = current_user_can( $post_type_object->cap->$cap, $object_id ); + $permission = current_user_can( $post_type_object->cap->$cap, $object_id ); } return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, $object_id, $post_type ); @@ -291,9 +302,9 @@ function wc_rest_check_product_term_permissions( $taxonomy, $context = 'read', $ 'batch' => 'edit_terms', ); - $cap = $contexts[ $context ]; + $cap = $contexts[ $context ]; $taxonomy_object = get_taxonomy( $taxonomy ); - $permission = current_user_can( $taxonomy_object->cap->$cap, $object_id ); + $permission = current_user_can( $taxonomy_object->cap->$cap, $object_id ); return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, $object_id, $taxonomy ); } @@ -314,9 +325,35 @@ function wc_rest_check_manager_permissions( $object, $context = 'read' ) { 'attributes' => 'manage_product_terms', 'shipping_methods' => 'manage_woocommerce', 'payment_gateways' => 'manage_woocommerce', + 'webhooks' => 'manage_woocommerce', ); $permission = current_user_can( $objects[ $object ] ); return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, 0, $object ); } + +/** + * Check product reviews permissions on REST API. + * + * @since 3.5.0 + * @param string $context Request context. + * @param string $object_id Object ID. + * @return bool + */ +function wc_rest_check_product_reviews_permissions( $context = 'read', $object_id = 0 ) { + $permission = false; + $contexts = array( + 'read' => 'moderate_comments', + 'create' => 'moderate_comments', + 'edit' => 'moderate_comments', + 'delete' => 'moderate_comments', + 'batch' => 'moderate_comments', + ); + + if ( isset( $contexts[ $context ] ) ) { + $permission = current_user_can( $contexts[ $context ] ); + } + + return apply_filters( 'woocommerce_rest_check_permissions', $permission, $context, $object_id, 'product_review' ); +} diff --git a/includes/wc-stock-functions.php b/includes/wc-stock-functions.php index 14e08a8fb68..dbb2b048bb3 100644 --- a/includes/wc-stock-functions.php +++ b/includes/wc-stock-functions.php @@ -4,14 +4,11 @@ * * Functions used to manage product stock levels. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions + * @package WooCommerce/Functions + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; /** * Update a product's stock amount. @@ -20,16 +17,19 @@ if ( ! defined( 'ABSPATH' ) ) { * * @since 3.0.0 this supports set, increase and decrease. * - * @param int|WC_Product $product - * @param int|null $stock_quantity - * @param string $operation set, increase and decrease. + * @param int|WC_Product $product Product ID or product instance. + * @param int|null $stock_quantity Stock quantity. + * @param string $operation Type of opertion, allows 'set', 'increase' and 'decrease'. * * @return bool|int|null */ function wc_update_product_stock( $product, $stock_quantity = null, $operation = 'set' ) { - if ( ! $product = wc_get_product( $product ) ) { + $product = wc_get_product( $product ); + + if ( ! $product ) { return false; } + if ( ! is_null( $stock_quantity ) && $product->managing_stock() ) { // Some products (variations) can have their stock managed by their parent. Get the correct ID to reduce here. $product_id_with_stock = $product->get_stock_managed_by_id(); @@ -43,9 +43,14 @@ function wc_update_product_stock( $product, $stock_quantity = null, $operation = // Re-read product data after updating stock, then have stock status calculated and saved. $product_with_stock = wc_get_product( $product_id_with_stock ); $product_with_stock->set_stock_status(); + $product_with_stock->set_date_modified( current_time( 'timestamp', true ) ); $product_with_stock->save(); - do_action( $product_with_stock->is_type( 'variation' ) ? 'woocommerce_variation_set_stock' : 'woocommerce_product_set_stock', $product_with_stock ); + if ( $product_with_stock->is_type( 'variation' ) ) { + do_action( 'woocommerce_variation_set_stock', $product_with_stock ); + } else { + do_action( 'woocommerce_product_set_stock', $product_with_stock ); + } return $product_with_stock->get_stock_quantity(); } @@ -55,8 +60,8 @@ function wc_update_product_stock( $product, $stock_quantity = null, $operation = /** * Update a product's stock status. * - * @param int $product_id - * @param int $status + * @param int $product_id Product ID. + * @param int $status Status. */ function wc_update_product_stock_status( $product_id, $status ) { $product = wc_get_product( $product_id ); @@ -68,21 +73,69 @@ function wc_update_product_stock_status( $product_id, $status ) { /** * When a payment is complete, we can reduce stock levels for items within an order. + * * @since 3.0.0 - * @param int $order_id + * @param int $order_id Order ID. */ function wc_maybe_reduce_stock_levels( $order_id ) { $order = wc_get_order( $order_id ); - if ( apply_filters( 'woocommerce_payment_complete_reduce_order_stock', $order && ! $order->get_data_store()->get_stock_reduced( $order_id ), $order_id ) ) { - wc_reduce_stock_levels( $order ); + + if ( ! $order ) { + return; } + + $stock_reduced = $order->get_data_store()->get_stock_reduced( $order_id ); + $trigger_reduce = apply_filters( 'woocommerce_payment_complete_reduce_order_stock', ! $stock_reduced, $order_id ); + + // Only continue if we're reducing stock. + if ( ! $trigger_reduce ) { + return; + } + + wc_reduce_stock_levels( $order ); + + // Ensure stock is marked as "reduced" in case payment complete or other stock actions are called. + $order->get_data_store()->set_stock_reduced( $order_id, true ); } add_action( 'woocommerce_payment_complete', 'wc_maybe_reduce_stock_levels' ); +add_action( 'woocommerce_order_status_completed', 'wc_maybe_reduce_stock_levels' ); +add_action( 'woocommerce_order_status_processing', 'wc_maybe_reduce_stock_levels' ); +add_action( 'woocommerce_order_status_on-hold', 'wc_maybe_reduce_stock_levels' ); /** - * Reduce stock levels for items within an order. + * When a payment is cancelled, restore stock. + * * @since 3.0.0 - * @param int|WC_Order $order_id + * @param int $order_id Order ID. + */ +function wc_maybe_increase_stock_levels( $order_id ) { + $order = wc_get_order( $order_id ); + + if ( ! $order ) { + return; + } + + $stock_reduced = $order->get_data_store()->get_stock_reduced( $order_id ); + $trigger_reduce = (bool) $stock_reduced; + + // Only continue if we're reducing stock. + if ( ! $trigger_reduce ) { + return; + } + + wc_increase_stock_levels( $order ); + + // Ensure stock is marked as "reduced" in case payment complete or other stock actions are called. + $order->get_data_store()->set_stock_reduced( $order_id, false ); +} +add_action( 'woocommerce_order_status_cancelled', 'wc_maybe_increase_stock_levels' ); +add_action( 'woocommerce_order_status_pending', 'wc_maybe_increase_stock_levels' ); + +/** + * Reduce stock levels for items within an order, if stock has not already been reduced for the items. + * + * @since 3.0.0 + * @param int|WC_Order $order_id Order ID or order instance. */ function wc_reduce_stock_levels( $order_id ) { if ( is_a( $order_id, 'WC_Order' ) ) { @@ -91,36 +144,192 @@ function wc_reduce_stock_levels( $order_id ) { } else { $order = wc_get_order( $order_id ); } - if ( 'yes' === get_option( 'woocommerce_manage_stock' ) && $order && apply_filters( 'woocommerce_can_reduce_order_stock', true, $order ) && sizeof( $order->get_items() ) > 0 ) { - foreach ( $order->get_items() as $item ) { - if ( $item->is_type( 'line_item' ) && ( $product = $item->get_product() ) && $product->managing_stock() ) { - $qty = apply_filters( 'woocommerce_order_item_quantity', $item->get_quantity(), $order, $item ); - $item_name = $product->get_formatted_name(); - $new_stock = wc_update_product_stock( $product, $qty, 'decrease' ); + // We need an order, and a store with stock management to continue. + if ( ! $order || 'yes' !== get_option( 'woocommerce_manage_stock' ) || ! apply_filters( 'woocommerce_can_reduce_order_stock', true, $order ) ) { + return; + } - if ( ! is_wp_error( $new_stock ) ) { - /* translators: 1: item name 2: old stock quantity 3: new stock quantity */ - $order->add_order_note( sprintf( __( '%1$s stock reduced from %2$s to %3$s.', 'woocommerce' ), $item_name, $new_stock + $qty, $new_stock ) ); + $changes = array(); - // Get the latest product data. - $product = wc_get_product( $product->get_id() ); - - if ( '' !== get_option( 'woocommerce_notify_no_stock_amount' ) && $new_stock <= get_option( 'woocommerce_notify_no_stock_amount' ) ) { - do_action( 'woocommerce_no_stock', $product ); - } elseif ( '' !== get_option( 'woocommerce_notify_low_stock_amount' ) && $new_stock <= get_option( 'woocommerce_notify_low_stock_amount' ) ) { - do_action( 'woocommerce_low_stock', $product ); - } - - if ( $new_stock < 0 ) { - do_action( 'woocommerce_product_on_backorder', array( 'product' => $product, 'order_id' => $order_id, 'quantity' => $qty ) ); - } - } - } + // Loop over all items. + foreach ( $order->get_items() as $item ) { + if ( ! $item->is_type( 'line_item' ) ) { + continue; } - // ensure stock is marked as "reduced" in case payment complete or other stock actions are called - $order->get_data_store()->set_stock_reduced( $order_id, true ); + // Only reduce stock once for each item. + $product = $item->get_product(); + $item_stock_reduced = $item->get_meta( '_reduced_stock', true ); - do_action( 'woocommerce_reduce_order_stock', $order ); + if ( $item_stock_reduced || ! $product || ! $product->managing_stock() ) { + continue; + } + + $qty = apply_filters( 'woocommerce_order_item_quantity', $item->get_quantity(), $order, $item ); + $item_name = $product->get_formatted_name(); + $new_stock = wc_update_product_stock( $product, $qty, 'decrease' ); + + if ( is_wp_error( $new_stock ) ) { + /* translators: %s item name. */ + $order->add_order_note( sprintf( __( 'Unable to reduce stock for item %s.', 'woocommerce' ), $item_name ) ); + continue; + } + + $item->add_meta_data( '_reduced_stock', $qty, true ); + $item->save(); + + $changes[] = array( + 'product' => $product, + 'from' => $new_stock + $qty, + 'to' => $new_stock, + ); } + + wc_trigger_stock_change_notifications( $order, $changes ); + + do_action( 'woocommerce_reduce_order_stock', $order ); } + +/** + * After stock change events, triggers emails and adds order notes. + * + * @since 3.5.0 + * @param WC_Order $order order object. + * @param array $changes Array of changes. + */ +function wc_trigger_stock_change_notifications( $order, $changes ) { + if ( empty( $changes ) ) { + return; + } + + $order_notes = array(); + $no_stock_amount = absint( get_option( 'woocommerce_notify_no_stock_amount', 0 ) ); + + foreach ( $changes as $change ) { + $order_notes[] = $change['product']->get_formatted_name() . ' ' . $change['from'] . '→' . $change['to']; + $low_stock_amount = absint( wc_get_low_stock_amount( wc_get_product( $change['product']->get_id() ) ) ); + if ( $change['to'] <= $no_stock_amount ) { + do_action( 'woocommerce_no_stock', wc_get_product( $change['product']->get_id() ) ); + } elseif ( $change['to'] <= $low_stock_amount ) { + do_action( 'woocommerce_low_stock', wc_get_product( $change['product']->get_id() ) ); + } + + if ( $change['to'] < 0 ) { + do_action( + 'woocommerce_product_on_backorder', array( + 'product' => wc_get_product( $change['product']->get_id() ), + 'order_id' => $order->get_id(), + 'quantity' => abs( $change['from'] - $change['to'] ), + ) + ); + } + } + + $order->add_order_note( __( 'Stock levels reduced:', 'woocommerce' ) . ' ' . implode( ', ', $order_notes ) ); +} + +/** + * Increase stock levels for items within an order. + * + * @since 3.0.0 + * @param int|WC_Order $order_id Order ID or order instance. + */ +function wc_increase_stock_levels( $order_id ) { + if ( is_a( $order_id, 'WC_Order' ) ) { + $order = $order_id; + $order_id = $order->get_id(); + } else { + $order = wc_get_order( $order_id ); + } + + // We need an order, and a store with stock management to continue. + if ( ! $order || 'yes' !== get_option( 'woocommerce_manage_stock' ) || ! apply_filters( 'woocommerce_can_restore_order_stock', true, $order ) ) { + return; + } + + // Loop over all items. + foreach ( $order->get_items() as $item ) { + if ( ! $item->is_type( 'line_item' ) ) { + continue; + } + + // Only reduce stock once for each item. + $product = $item->get_product(); + $item_stock_reduced = $item->get_meta( '_reduced_stock', true ); + + if ( ! $item_stock_reduced || ! $product || ! $product->managing_stock() ) { + continue; + } + + $item_name = $product->get_formatted_name(); + $new_stock = wc_update_product_stock( $product, $item_stock_reduced, 'increase' ); + + if ( is_wp_error( $new_stock ) ) { + /* translators: %s item name. */ + $order->add_order_note( sprintf( __( 'Unable to restore stock for item %s.', 'woocommerce' ), $item_name ) ); + continue; + } + + $item->delete_meta_data( '_reduced_stock' ); + $item->save(); + + $changes[] = $item_name . ' ' . ( $new_stock - $item_stock_reduced ) . '→' . $new_stock; + } + + if ( $changes ) { + $order->add_order_note( __( 'Stock levels increased:', 'woocommerce' ) . ' ' . implode( ', ', $changes ) ); + } + + do_action( 'woocommerce_restore_order_stock', $order ); +} + +/** + * See how much stock is being held in pending orders. + * + * @since 3.5.0 + * @param WC_Product $product Product to check. + * @param integer $exclude_order_id Order ID to exclude. + * @return int + */ +function wc_get_held_stock_quantity( $product, $exclude_order_id = 0 ) { + global $wpdb; + + return $wpdb->get_var( + $wpdb->prepare( + " + SELECT SUM( order_item_meta.meta_value ) AS held_qty + FROM {$wpdb->posts} AS posts + LEFT JOIN {$wpdb->prefix}woocommerce_order_items as order_items ON posts.ID = order_items.order_id + LEFT JOIN {$wpdb->prefix}woocommerce_order_itemmeta as order_item_meta ON order_items.order_item_id = order_item_meta.order_item_id + LEFT JOIN {$wpdb->prefix}woocommerce_order_itemmeta as order_item_meta2 ON order_items.order_item_id = order_item_meta2.order_item_id + WHERE order_item_meta.meta_key = '_qty' + AND order_item_meta2.meta_key = %s + AND order_item_meta2.meta_value = %d + AND posts.post_type IN ( '" . implode( "','", wc_get_order_types() ) . "' ) + AND posts.post_status = 'wc-pending' + AND posts.ID != %d;", + 'variation' === get_post_type( $product->get_stock_managed_by_id() ) ? '_variation_id' : '_product_id', + $product->get_stock_managed_by_id(), + $exclude_order_id + ) + ); // WPCS: unprepared SQL ok. +} + +/** + * Return low stock amount to determine if notification needs to be sent + * + * @param WC_Product $product + * @since 3.5.0 + * @return int + */ +function wc_get_low_stock_amount( WC_Product $product ) { + if ( $product->is_type( 'variation' ) ) { + $product = wc_get_product( $product->get_parent_id() ); + } + $low_stock_amount = $product->get_low_stock_amount(); + if ( '' === $low_stock_amount ) { + $low_stock_amount = get_option( 'woocommerce_notify_low_stock_amount', 2 ); + } + + return $low_stock_amount; +} \ No newline at end of file diff --git a/includes/wc-template-functions.php b/includes/wc-template-functions.php index 997c811f9fc..ad0066fde0d 100644 --- a/includes/wc-template-functions.php +++ b/includes/wc-template-functions.php @@ -4,15 +4,11 @@ * * Functions for the templating system. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions + * @package WooCommerce\Functions * @version 2.5.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; /** * Handle redirects before content is output - hooked into template_redirect so is_page works. @@ -20,33 +16,33 @@ if ( ! defined( 'ABSPATH' ) ) { function wc_template_redirect() { global $wp_query, $wp; - if ( ! empty( $_GET['page_id'] ) && '' === get_option( 'permalink_structure' ) && wc_get_page_id( 'shop' ) == $_GET['page_id'] ) { + if ( ! empty( $_GET['page_id'] ) && '' === get_option( 'permalink_structure' ) && wc_get_page_id( 'shop' ) === absint( $_GET['page_id'] ) && get_post_type_archive_link( 'product' ) ) { // WPCS: input var ok, CSRF ok. - // When default permalinks are enabled, redirect shop page to post type archive url + // When default permalinks are enabled, redirect shop page to post type archive url. wp_safe_redirect( get_post_type_archive_link( 'product' ) ); exit; - } elseif ( is_page( wc_get_page_id( 'checkout' ) ) && wc_get_page_id( 'checkout' ) !== wc_get_page_id( 'cart' ) && WC()->cart->is_empty() && empty( $wp->query_vars['order-pay'] ) && ! isset( $wp->query_vars['order-received'] ) ) { + } elseif ( is_page( wc_get_page_id( 'checkout' ) ) && wc_get_page_id( 'checkout' ) !== wc_get_page_id( 'cart' ) && WC()->cart->is_empty() && empty( $wp->query_vars['order-pay'] ) && ! isset( $wp->query_vars['order-received'] ) && ! is_customize_preview() && apply_filters( 'woocommerce_checkout_redirect_empty_cart', true ) ) { - // When on the checkout with an empty cart, redirect to cart page + // When on the checkout with an empty cart, redirect to cart page. wc_add_notice( __( 'Checkout is not available whilst your cart is empty.', 'woocommerce' ), 'notice' ); - wp_redirect( wc_get_page_permalink( 'cart' ) ); + wp_safe_redirect( wc_get_page_permalink( 'cart' ) ); exit; - } elseif ( isset( $wp->query_vars['customer-logout'] ) && ! empty( $_REQUEST['_wpnonce'] ) && wp_verify_nonce( $_REQUEST['_wpnonce'], 'customer-logout' ) ) { + } elseif ( isset( $wp->query_vars['customer-logout'] ) && ! empty( $_REQUEST['_wpnonce'] ) && wp_verify_nonce( sanitize_key( $_REQUEST['_wpnonce'] ), 'customer-logout' ) ) { // WPCS: input var ok, CSRF ok. - // Logout - wp_redirect( str_replace( '&', '&', wp_logout_url( wc_get_page_permalink( 'myaccount' ) ) ) ); + // Logout. + wp_safe_redirect( str_replace( '&', '&', wp_logout_url( wc_get_page_permalink( 'myaccount' ) ) ) ); exit; } elseif ( isset( $wp->query_vars['customer-logout'] ) && 'true' === $wp->query_vars['customer-logout'] ) { // Redirect to the correct logout endpoint. - wp_redirect( esc_url_raw( wc_get_account_endpoint_url( 'customer-logout' ) ) ); + wp_safe_redirect( esc_url_raw( wc_get_account_endpoint_url( 'customer-logout' ) ) ); exit; } elseif ( is_search() && is_post_type_archive( 'product' ) && apply_filters( 'woocommerce_redirect_single_search_result', true ) && 1 === absint( $wp_query->found_posts ) ) { - // Redirect to the product page if we have a single product + // Redirect to the product page if we have a single product. $product = wc_get_product( $wp_query->post ); if ( $product && $product->is_visible() ) { @@ -55,16 +51,16 @@ function wc_template_redirect() { } } elseif ( is_add_payment_method_page() ) { - // Ensure payment gateways are loaded early + // Ensure payment gateways are loaded early. WC()->payment_gateways(); } elseif ( is_checkout() ) { // Checkout pages handling - // Buffer the checkout page + // Buffer the checkout page. ob_start(); - // Ensure gateways and shipping methods are loaded early + // Ensure gateways and shipping methods are loaded early. WC()->payment_gateways(); WC()->shipping(); @@ -93,8 +89,8 @@ add_action( 'template_redirect', 'wc_send_frame_options_header' ); * @since 2.5.3 */ function wc_prevent_endpoint_indexing() { - if ( is_wc_endpoint_url() || isset( $_GET['download_file'] ) ) { - @header( 'X-Robots-Tag: noindex' ); + if ( is_wc_endpoint_url() || isset( $_GET['download_file'] ) ) { // WPCS: input var ok, CSRF ok. + @header( 'X-Robots-Tag: noindex' ); // @codingStandardsIgnoreLine } } add_action( 'template_redirect', 'wc_prevent_endpoint_indexing' ); @@ -126,7 +122,7 @@ add_action( 'wp_head', 'wc_gallery_noscript' ); /** * When the_post is called, put product data into a global. * - * @param mixed $post + * @param mixed $post Post Object. * @return WC_Product */ function wc_setup_product_data( $post ) { @@ -136,7 +132,7 @@ function wc_setup_product_data( $post ) { $post = get_post( $post ); } - if ( empty( $post->post_type ) || ! in_array( $post->post_type, array( 'product', 'product_variation' ) ) ) { + if ( empty( $post->post_type ) || ! in_array( $post->post_type, array( 'product', 'product_variation' ), true ) ) { return; } @@ -146,62 +142,103 @@ function wc_setup_product_data( $post ) { } add_action( 'the_post', 'wc_setup_product_data' ); -if ( ! function_exists( 'woocommerce_reset_loop' ) ) { +/** + * Sets up the woocommerce_loop global from the passed args or from the main query. + * + * @since 3.3.0 + * @param array $args Args to pass into the global. + */ +function wc_setup_loop( $args = array() ) { + $default_args = array( + 'loop' => 0, + 'columns' => wc_get_default_products_per_row(), + 'name' => '', + 'is_shortcode' => false, + 'is_paginated' => true, + 'is_search' => false, + 'is_filtered' => false, + 'total' => 0, + 'total_pages' => 0, + 'per_page' => 0, + 'current_page' => 1, + ); - /** - * Reset the loop's index and columns when we're done outputting a product loop. - * @subpackage Loop - */ - function woocommerce_reset_loop() { - $GLOBALS['woocommerce_loop'] = array( - 'loop' => '', - 'columns' => '', - 'name' => '', - ); + // If this is a main WC query, use global args as defaults. + if ( $GLOBALS['wp_query']->get( 'wc_query' ) ) { + $default_args = array_merge( $default_args, array( + 'is_search' => $GLOBALS['wp_query']->is_search(), + 'is_filtered' => is_filtered(), + 'total' => $GLOBALS['wp_query']->found_posts, + 'total_pages' => $GLOBALS['wp_query']->max_num_pages, + 'per_page' => $GLOBALS['wp_query']->get( 'posts_per_page' ), + 'current_page' => max( 1, $GLOBALS['wp_query']->get( 'paged', 1 ) ), + ) ); } + + // Merge any existing values. + if ( isset( $GLOBALS['woocommerce_loop'] ) ) { + $default_args = array_merge( $default_args, $GLOBALS['woocommerce_loop'] ); + } + + $GLOBALS['woocommerce_loop'] = wp_parse_args( $args, $default_args ); } -add_filter( 'loop_end', 'woocommerce_reset_loop' ); +add_action( 'woocommerce_before_shop_loop', 'wc_setup_loop' ); /** - * Products RSS Feed. - * @deprecated 2.6 - * @access public + * Resets the woocommerce_loop global. + * + * @since 3.3.0 */ -function wc_products_rss_feed() { - // Product RSS - if ( is_post_type_archive( 'product' ) || is_singular( 'product' ) ) { +function wc_reset_loop() { + unset( $GLOBALS['woocommerce_loop'] ); +} +add_action( 'woocommerce_after_shop_loop', 'woocommerce_reset_loop', 999 ); - $feed = get_post_type_archive_feed_link( 'product' ); +/** + * Gets a property from the woocommerce_loop global. + * + * @since 3.3.0 + * @param string $prop Prop to get. + * @param string $default Default if the prop does not exist. + * @return mixed + */ +function wc_get_loop_prop( $prop, $default = '' ) { + wc_setup_loop(); // Ensure shop loop is setup. - echo ''; + return isset( $GLOBALS['woocommerce_loop'], $GLOBALS['woocommerce_loop'][ $prop ] ) ? $GLOBALS['woocommerce_loop'][ $prop ] : $default; +} - } elseif ( is_tax( 'product_cat' ) ) { - - $term = get_term_by( 'slug', esc_attr( get_query_var( 'product_cat' ) ), 'product_cat' ); - - if ( $term ) { - $feed = add_query_arg( 'product_cat', $term->slug, get_post_type_archive_feed_link( 'product' ) ); - echo ''; - } - } elseif ( is_tax( 'product_tag' ) ) { - - $term = get_term_by( 'slug', esc_attr( get_query_var( 'product_tag' ) ), 'product_tag' ); - - if ( $term ) { - $feed = add_query_arg( 'product_tag', $term->slug, get_post_type_archive_feed_link( 'product' ) ); - echo ''; - } +/** + * Sets a property in the woocommerce_loop global. + * + * @since 3.3.0 + * @param string $prop Prop to set. + * @param string $value Value to set. + */ +function wc_set_loop_prop( $prop, $value = '' ) { + if ( ! isset( $GLOBALS['woocommerce_loop'] ) ) { + wc_setup_loop(); } + $GLOBALS['woocommerce_loop'][ $prop ] = $value; +} + +/** + * Should the WooCommerce loop be displayed? + * + * This will return true if we have posts (products) or if we have subcats to display. + * + * @since 3.4.0 + * @return bool + */ +function woocommerce_product_loop() { + return have_posts() || 'products' !== woocommerce_get_loop_display_mode(); } /** * Output generator tag to aid debugging. * - * @access public - * - * @param string $gen - * @param string $type - * + * @param string $gen Generator. + * @param string $type Type. * @return string */ function wc_generator_tag( $gen, $type ) { @@ -219,7 +256,7 @@ function wc_generator_tag( $gen, $type ) { /** * Add body classes for WC pages. * - * @param array $classes + * @param array $classes Body Classes. * @return array */ function wc_body_class( $classes ) { @@ -251,54 +288,148 @@ function wc_body_class( $classes ) { $classes[] = 'woocommerce-demo-store'; } - foreach ( WC()->query->query_vars as $key => $value ) { + foreach ( WC()->query->get_query_vars() as $key => $value ) { if ( is_wc_endpoint_url( $key ) ) { $classes[] = 'woocommerce-' . sanitize_html_class( $key ); } } + $classes[] = 'woocommerce-no-js'; + + add_action( 'wp_footer', 'wc_no_js' ); + return array_unique( $classes ); } +/** + * NO JS handling. + * + * @since 3.4.0 + */ +function wc_no_js() { + ?> + + $max_columns ) { + $columns = $max_columns; + update_option( 'woocommerce_catalog_columns', $columns ); + } + + if ( has_filter( 'loop_shop_columns' ) ) { // Legacy filter handling. + $columns = apply_filters( 'loop_shop_columns', $columns ); + } + + $columns = absint( $columns ); + + return max( 1, $columns ); +} + +/** + * Get the default rows setting - this is how many product rows will be shown in loops. + * + * @since 3.3.0 + * @return int + */ +function wc_get_default_product_rows_per_page() { + $rows = absint( get_option( 'woocommerce_catalog_rows', 4 ) ); + $product_grid = wc_get_theme_support( 'product_grid' ); + $min_rows = isset( $product_grid['min_rows'] ) ? absint( $product_grid['min_rows'] ) : 0; + $max_rows = isset( $product_grid['max_rows'] ) ? absint( $product_grid['max_rows'] ) : 0; + + if ( $min_rows && $rows < $min_rows ) { + $rows = $min_rows; + update_option( 'woocommerce_catalog_rows', $rows ); + } elseif ( $max_rows && $rows > $max_rows ) { + $rows = $max_rows; + update_option( 'woocommerce_catalog_rows', $rows ); + } + + return $rows; +} + +/** + * Reset the product grid settings when a new theme is activated. + * + * @since 3.3.0 + */ +function wc_reset_product_grid_settings() { + $product_grid = wc_get_theme_support( 'product_grid' ); + + if ( ! empty( $product_grid['default_rows'] ) ) { + update_option( 'woocommerce_catalog_rows', absint( $product_grid['default_rows'] ) ); + } + + if ( ! empty( $product_grid['default_columns'] ) ) { + update_option( 'woocommerce_catalog_columns', absint( $product_grid['default_columns'] ) ); + } +} +add_action( 'after_switch_theme', 'wc_reset_product_grid_settings' ); + +/** + * Get classname for woocommerce loops. + * * @since 2.6.0 * @return string */ function wc_get_loop_class() { - global $woocommerce_loop; + $loop_index = wc_get_loop_prop( 'loop', 0 ); + $columns = absint( max( 1, wc_get_loop_prop( 'columns', wc_get_default_products_per_row() ) ) ); - $woocommerce_loop['loop'] = ! empty( $woocommerce_loop['loop'] ) ? $woocommerce_loop['loop'] + 1 : 1; - $woocommerce_loop['columns'] = max( 1, ! empty( $woocommerce_loop['columns'] ) ? $woocommerce_loop['columns'] : apply_filters( 'loop_shop_columns', 4 ) ); + $loop_index ++; + wc_set_loop_prop( 'loop', $loop_index ); - if ( 0 === ( $woocommerce_loop['loop'] - 1 ) % $woocommerce_loop['columns'] || 1 === $woocommerce_loop['columns'] ) { + if ( 0 === ( $loop_index - 1 ) % $columns || 1 === $columns ) { return 'first'; - } elseif ( 0 === $woocommerce_loop['loop'] % $woocommerce_loop['columns'] ) { - return 'last'; - } else { - return ''; } + + if ( 0 === $loop_index % $columns ) { + return 'last'; + } + + return ''; } + /** * Get the classes for the product cat div. * * @since 2.4.0 * * @param string|array $class One or more classes to add to the class list. - * @param object $category object Optional. + * @param object $category object Optional. * * @return array */ @@ -316,13 +447,13 @@ function wc_get_product_cat_class( $class = '', $category = null ) { * Adds extra post classes for products. * * @since 2.1.0 - * @param array $classes - * @param string|array $class - * @param int $post_id + * @param array $classes Current classes. + * @param string|array $class Additional class. + * @param int $post_id Post ID. * @return array */ -function wc_product_post_class( $classes, $class = '', $post_id = '' ) { - if ( ! $post_id || ! in_array( get_post_type( $post_id ), array( 'product', 'product_variation' ) ) ) { +function wc_product_post_class( $classes, $class = '', $post_id = 0 ) { + if ( ! $post_id || ! in_array( get_post_type( $post_id ), array( 'product', 'product_variation' ), true ) ) { return $classes; } @@ -358,19 +489,17 @@ function wc_product_post_class( $classes, $class = '', $post_id = '' ) { $classes[] = 'purchasable'; } if ( $product->get_type() ) { - $classes[] = "product-type-" . $product->get_type(); + $classes[] = 'product-type-' . $product->get_type(); } if ( $product->is_type( 'variable' ) ) { if ( ! $product->get_default_attributes() ) { $classes[] = 'has-default-attributes'; } - if ( $product->has_child() ) { - $classes[] = 'has-children'; - } } } - if ( false !== ( $key = array_search( 'hentry', $classes ) ) ) { + $key = array_search( 'hentry', $classes, true ); + if ( false !== $key ) { unset( $classes[ $key ] ); } @@ -378,18 +507,167 @@ function wc_product_post_class( $classes, $class = '', $post_id = '' ) { } /** - * Outputs hidden form inputs for each query string variable. - * @since 3.0.0 + * Get product taxonomy HTML classes. * - * @param array $values Name value pairs. - * @param array $exclude Keys to exclude. - * @param string $current_key Current key we are outputting. - * @param bool $return + * @since 3.4.0 + * @param array $term_ids Array of terms IDs or objects. + * @param string $taxonomy Taxonomy. + * @return array + */ +function wc_get_product_taxonomy_class( $term_ids, $taxonomy ) { + $classes = array(); + + foreach ( $term_ids as $term_id ) { + $term = get_term( $term_id, $taxonomy ); + + if ( empty( $term->slug ) ) { + continue; + } + + $term_class = sanitize_html_class( $term->slug, $term->term_id ); + if ( is_numeric( $term_class ) || ! trim( $term_class, '-' ) ) { + $term_class = $term->term_id; + } + + // 'post_tag' uses the 'tag' prefix for backward compatibility. + if ( 'post_tag' === $taxonomy ) { + $classes[] = 'tag-' . $term_class; + } else { + $classes[] = sanitize_html_class( $taxonomy . '-' . $term_class, $taxonomy . '-' . $term->term_id ); + } + } + + return $classes; +} + +/** + * Retrieves the classes for the post div as an array. + * + * This method is clone from WordPress's get_post_class(), allowing removing taxonomies. + * + * @since 3.4.0 + * @param string|array $class One or more classes to add to the class list. + * @param int|WP_Post|WC_Product $product_id Product ID or product object. + * @return array + */ +function wc_get_product_class( $class = '', $product_id = null ) { + if ( is_a( $product_id, 'WC_Product' ) ) { + $product = $product_id; + $product_id = $product_id->get_id(); + $post = get_post( $product_id ); + } else { + $post = get_post( $product_id ); + $product = wc_get_product( $post->ID ); + } + + $classes = array(); + + if ( $class ) { + if ( ! is_array( $class ) ) { + $class = preg_split( '#\s+#', $class ); + } + $classes = array_map( 'esc_attr', $class ); + } else { + // Ensure that we always coerce class to being an array. + $class = array(); + } + + if ( ! $post || ! $product ) { + return $classes; + } + + $classes[] = 'post-' . $post->ID; + if ( ! is_admin() ) { + $classes[] = $post->post_type; + } + $classes[] = 'type-' . $post->post_type; + $classes[] = 'status-' . $post->post_status; + + // Post format. + if ( post_type_supports( $post->post_type, 'post-formats' ) ) { + $post_format = get_post_format( $post->ID ); + + if ( $post_format && ! is_wp_error( $post_format ) ) { + $classes[] = 'format-' . sanitize_html_class( $post_format ); + } else { + $classes[] = 'format-standard'; + } + } + + // Post requires password. + $post_password_required = post_password_required( $post->ID ); + if ( $post_password_required ) { + $classes[] = 'post-password-required'; + } elseif ( ! empty( $post->post_password ) ) { + $classes[] = 'post-password-protected'; + } + + // Post thumbnails. + if ( current_theme_supports( 'post-thumbnails' ) && $product->get_image_id() && ! is_attachment( $post ) && ! $post_password_required ) { + $classes[] = 'has-post-thumbnail'; + } + + // Sticky for Sticky Posts. + if ( is_sticky( $post->ID ) ) { + if ( is_home() && ! is_paged() ) { + $classes[] = 'sticky'; + } elseif ( is_admin() ) { + $classes[] = 'status-sticky'; + } + } + + // Hentry for hAtom compliance. + $classes[] = 'hentry'; + + // Include attributes and any extra taxonomy. + if ( apply_filters( 'woocommerce_get_product_class_include_taxonomies', false ) ) { + $taxonomies = get_taxonomies( array( 'public' => true ) ); + foreach ( (array) $taxonomies as $taxonomy ) { + if ( is_object_in_taxonomy( $post->post_type, $taxonomy ) && ! in_array( $taxonomy, array( 'product_cat', 'product_tag' ), true ) ) { + $classes = array_merge( $classes, wc_get_product_taxonomy_class( (array) get_the_terms( $post->ID, $taxonomy ), $taxonomy ) ); + } + } + } + // Categories. + $classes = array_merge( $classes, wc_get_product_taxonomy_class( $product->get_category_ids(), 'product_cat' ) ); + + // Tags. + $classes = array_merge( $classes, wc_get_product_taxonomy_class( $product->get_tag_ids(), 'product_tag' ) ); + + return array_filter( array_unique( apply_filters( 'post_class', $classes, $class, $post->ID ) ) ); +} + +/** + * Display the classes for the product div. + * + * @since 3.4.0 + * @param string|array $class One or more classes to add to the class list. + * @param int|WP_Post|WC_Product $product_id Product ID or product object. + */ +function wc_product_class( $class = '', $product_id = null ) { + echo 'class="' . esc_attr( join( ' ', wc_get_product_class( $class, $product_id ) ) ) . '"'; +} + +/** + * Outputs hidden form inputs for each query string variable. + * + * @since 3.0.0 + * @param string|array $values Name value pairs, or a URL to parse. + * @param array $exclude Keys to exclude. + * @param string $current_key Current key we are outputting. + * @param bool $return Whether to return. * @return string */ function wc_query_string_form_fields( $values = null, $exclude = array(), $current_key = '', $return = false ) { if ( is_null( $values ) ) { - $values = $_GET; + $values = $_GET; // WPCS: input var ok, CSRF ok. + } elseif ( is_string( $values ) ) { + $url_parts = wp_parse_url( $values ); + $values = array(); + + if ( ! empty( $url_parts['query'] ) ) { + parse_str( $url_parts['query'], $values ); + } } $html = ''; @@ -403,18 +681,181 @@ function wc_query_string_form_fields( $values = null, $exclude = array(), $curre if ( is_array( $value ) ) { $html .= wc_query_string_form_fields( $value, $exclude, $key, true ); } else { - $html .= ''; + $html .= ''; } } if ( $return ) { return $html; - } else { - echo $html; + } + + echo $html; // WPCS: XSS ok. +} + +/** + * Get the terms and conditons page ID. + * + * @since 3.4.0 + * @return int + */ +function wc_terms_and_conditions_page_id() { + $page_id = wc_get_page_id( 'terms' ); + return apply_filters( 'woocommerce_terms_and_conditions_page_id', 0 < $page_id ? absint( $page_id ) : 0 ); +} + +/** + * Get the privacy policy page ID. + * + * @since 3.4.0 + * @return int + */ +function wc_privacy_policy_page_id() { + $page_id = get_option( 'wp_page_for_privacy_policy', 0 ); + return apply_filters( 'woocommerce_privacy_policy_page_id', 0 < $page_id ? absint( $page_id ) : 0 ); +} + +/** + * See if the checkbox is enabled or not based on the existance of the terms page and checkbox text. + * + * @since 3.4.0 + * @return bool + */ +function wc_terms_and_conditions_checkbox_enabled() { + $page_id = wc_terms_and_conditions_page_id(); + $page = $page_id ? get_post( $page_id ) : false; + return $page && wc_get_terms_and_conditions_checkbox_text(); +} + +/** + * Get the terms and conditons checkbox text, if set. + * + * @since 3.4.0 + * @return string + */ +function wc_get_terms_and_conditions_checkbox_text() { + /* translators: %s terms and conditions page name and link */ + return trim( apply_filters( 'woocommerce_get_terms_and_conditions_checkbox_text', get_option( 'woocommerce_checkout_terms_and_conditions_checkbox_text', sprintf( __( 'I have read and agree to the website %s', 'woocommerce' ), '[terms]' ) ) ) ); +} + +/** + * Get the privacy policy text, if set. + * + * @since 3.4.0 + * @param string $type Type of policy to load. Valid values include registration and checkout. + * @return string + */ +function wc_get_privacy_policy_text( $type = '' ) { + $text = ''; + + switch ( $type ) { + case 'checkout': + /* translators: %s privacy policy page name and link */ + $text = get_option( 'woocommerce_checkout_privacy_policy_text', sprintf( __( 'Your personal data will be used to process your order, support your experience throughout this website, and for other purposes described in our %s.', 'woocommerce' ), '[privacy_policy]' ) ); + break; + case 'registration': + /* translators: %s privacy policy page name and link */ + $text = get_option( 'woocommerce_registration_privacy_policy_text', sprintf( __( 'Your personal data will be used to support your experience throughout this website, to manage access to your account, and for other purposes described in our %s.', 'woocommerce' ), '[privacy_policy]' ) ); + break; + } + + return trim( apply_filters( 'woocommerce_get_privacy_policy_text', $text, $type ) ); +} + +/** + * Output t&c checkbox text. + * + * @since 3.4.0 + */ +function wc_terms_and_conditions_checkbox_text() { + $text = wc_get_terms_and_conditions_checkbox_text(); + + if ( ! $text ) { + return; + } + + echo wp_kses_post( wc_replace_policy_page_link_placeholders( $text ) ); +} + +/** + * Output t&c page's content (if set). The page can be set from checkout settings. + * + * @since 3.4.0 + */ +function wc_terms_and_conditions_page_content() { + $terms_page_id = wc_terms_and_conditions_page_id(); + + if ( ! $terms_page_id ) { + return; + } + + $page = get_post( $terms_page_id ); + + if ( $page && 'publish' === $page->post_status && $page->post_content && ! has_shortcode( $page->post_content, 'woocommerce_checkout' ) ) { + echo ''; } } -/** Template pages ********************************************************/ +/** + * Render privacy policy text on the checkout. + * + * @since 3.4.0 + */ +function wc_checkout_privacy_policy_text() { + echo '
          '; + wc_privacy_policy_text( 'checkout' ); + echo '
          '; +} + +/** + * Render privacy policy text on the register forms. + * + * @since 3.4.0 + */ +function wc_registration_privacy_policy_text() { + echo '
          '; + wc_privacy_policy_text( 'registration' ); + echo '
          '; +} + +/** + * Output privacy policy text. This is custom text which can be added via the customizer/privacy settings section. + * + * Loads the relevant policy for the current page unless a specific policy text is required. + * + * @since 3.4.0 + * @param string $type Type of policy to load. Valid values include registration and checkout. + */ +function wc_privacy_policy_text( $type = 'checkout' ) { + if ( ! wc_privacy_policy_page_id() ) { + return; + } + echo wp_kses_post( wpautop( wc_replace_policy_page_link_placeholders( wc_get_privacy_policy_text( $type ) ) ) ); +} + +/** + * Replaces placeholders with links to WooCommerce policy pages. + * + * @since 3.4.0 + * @param string $text Text to find/replace within. + * @return string + */ +function wc_replace_policy_page_link_placeholders( $text ) { + $privacy_page_id = wc_privacy_policy_page_id(); + $terms_page_id = wc_terms_and_conditions_page_id(); + $privacy_link = $privacy_page_id ? '          ' . __( 'privacy policy', 'woocommerce' ) . '' : __( 'privacy policy', 'woocommerce' ); + $terms_link = $terms_page_id ? '' . __( 'terms and conditions', 'woocommerce' ) . '' : __( 'terms and conditions', 'woocommerce' ); + + $find_replace = array( + '[terms]' => $terms_link, + '[privacy_policy]' => $privacy_link, + ); + + return str_replace( array_keys( $find_replace ), array_values( $find_replace ), $text ); +} + +/** + * Template pages + */ if ( ! function_exists( 'woocommerce_content' ) ) { @@ -424,19 +865,18 @@ if ( ! function_exists( 'woocommerce_content' ) ) { * This function is only used in the optional 'woocommerce.php' template. * which people can add to their themes to add basic woocommerce support. * without hooks or modifying core templates. - * */ function woocommerce_content() { if ( is_singular( 'product' ) ) { - while ( have_posts() ) : the_post(); - + while ( have_posts() ) : + the_post(); wc_get_template_part( 'content', 'single-product' ); - endwhile; - } else { ?> + } else { + ?> @@ -446,41 +886,42 @@ if ( ! function_exists( 'woocommerce_content' ) ) { - + - - - - + + + - - + + - woocommerce_product_loop_start( false ), 'after' => woocommerce_product_loop_end( false ) ) ) ) : ?> + - ' . wp_kses_post( $notice ) . ' ' . esc_html__( 'Dismiss', 'woocommerce' ) . '

          ', $notice ); + echo apply_filters( 'woocommerce_demo_store', '

          ' . wp_kses_post( $notice ) . ' ' . esc_html__( 'Dismiss', 'woocommerce' ) . '

          ', $notice ); // WPCS: XSS ok. } } -/** Loop ******************************************************************/ +/** + * Loop + */ if ( ! function_exists( 'woocommerce_page_title' ) ) { /** - * woocommerce_page_title function. + * Page Title function. * - * @param bool $echo + * @param bool $echo Should echo title. * @return string */ function woocommerce_page_title( $echo = true ) { if ( is_search() ) { + /* translators: %s: search query */ $page_title = sprintf( __( 'Search results: “%s”', 'woocommerce' ), get_search_query() ); if ( get_query_var( 'paged' ) ) { + /* translators: %s: page number */ $page_title .= sprintf( __( ' – Page %s', 'woocommerce' ), get_query_var( 'paged' ) ); } } elseif ( is_tax() ) { - $page_title = single_term_title( "", false ); + $page_title = single_term_title( '', false ); } else { @@ -561,7 +1003,7 @@ if ( ! function_exists( 'woocommerce_page_title' ) ) { $page_title = apply_filters( 'woocommerce_page_title', $page_title ); if ( $echo ) { - echo $page_title; + echo $page_title; // WPCS: XSS ok. } else { return $page_title; } @@ -573,26 +1015,32 @@ if ( ! function_exists( 'woocommerce_product_loop_start' ) ) { /** * Output the start of a product loop. By default this is a UL. * - * @param bool $echo + * @param bool $echo Should echo?. * @return string */ function woocommerce_product_loop_start( $echo = true ) { ob_start(); - $GLOBALS['woocommerce_loop']['loop'] = 0; + + wc_set_loop_prop( 'loop', 0 ); + wc_get_template( 'loop/loop-start.php' ); + + $loop_start = apply_filters( 'woocommerce_product_loop_start', ob_get_clean() ); + if ( $echo ) { - echo ob_get_clean(); + echo $loop_start; // WPCS: XSS ok. } else { - return ob_get_clean(); + return $loop_start; } } } + if ( ! function_exists( 'woocommerce_product_loop_end' ) ) { /** * Output the end of a product loop. By default this is a UL. * - * @param bool $echo + * @param bool $echo Should echo?. * @return string */ function woocommerce_product_loop_end( $echo = true ) { @@ -600,10 +1048,12 @@ if ( ! function_exists( 'woocommerce_product_loop_end' ) ) { wc_get_template( 'loop/loop-end.php' ); + $loop_end = apply_filters( 'woocommerce_product_loop_end', ob_get_clean() ); + if ( $echo ) { - echo ob_get_clean(); + echo $loop_end; // WPCS: XSS ok. } else { - return ob_get_clean(); + return $loop_end; } } } @@ -621,61 +1071,76 @@ if ( ! function_exists( 'woocommerce_template_loop_category_title' ) ) { /** * Show the subcategory title in the product loop. * - * @param object $category + * @param object $category Category object. */ function woocommerce_template_loop_category_title( $category ) { ?>

          name; + echo esc_html( $category->name ); - if ( $category->count > 0 ) { - echo apply_filters( 'woocommerce_subcategory_count_html', ' (' . $category->count . ')', $category ); - } + if ( $category->count > 0 ) { + echo apply_filters( 'woocommerce_subcategory_count_html', ' (' . esc_html( $category->count ) . ')', $category ); // WPCS: XSS ok. + } ?>

          '; -} -/** - * Insert the opening anchor tag for products in the loop. - */ -function woocommerce_template_loop_product_link_close() { - echo ''; + +if ( ! function_exists( 'woocommerce_template_loop_product_link_open' ) ) { + /** + * Insert the opening anchor tag for products in the loop. + */ + function woocommerce_template_loop_product_link_open() { + global $product; + + $link = apply_filters( 'woocommerce_loop_product_link', get_the_permalink(), $product ); + + echo ''; + } } -/** - * Insert the opening anchor tag for categories in the loop. - * - * @param int|object|string $category - */ -function woocommerce_template_loop_category_link_open( $category ) { - echo ''; +if ( ! function_exists( 'woocommerce_template_loop_product_link_close' ) ) { + /** + * Insert the opening anchor tag for products in the loop. + */ + function woocommerce_template_loop_product_link_close() { + echo ''; + } } -/** - * Insert the closing anchor tag for categories in the loop. - */ -function woocommerce_template_loop_category_link_close() { - echo ''; + +if ( ! function_exists( 'woocommerce_template_loop_category_link_open' ) ) { + /** + * Insert the opening anchor tag for categories in the loop. + * + * @param int|object|string $category Category ID, Object or String. + */ + function woocommerce_template_loop_category_link_open( $category ) { + echo ''; + } } + +if ( ! function_exists( 'woocommerce_template_loop_category_link_close' ) ) { + /** + * Insert the closing anchor tag for categories in the loop. + */ + function woocommerce_template_loop_category_link_close() { + echo ''; + } +} + if ( ! function_exists( 'woocommerce_taxonomy_archive_description' ) ) { /** * Show an archive description on taxonomy archives. - * - * @subpackage Archives */ function woocommerce_taxonomy_archive_description() { if ( is_product_taxonomy() && 0 === absint( get_query_var( 'paged' ) ) ) { - $description = wc_format_content( term_description() ); - if ( $description ) { - echo '
          ' . $description . '
          '; + $term = get_queried_object(); + + if ( $term && ! empty( $term->description ) ) { + echo '
          ' . wc_format_content( $term->description ) . '
          '; // WPCS: XSS ok. } } } @@ -684,21 +1149,19 @@ if ( ! function_exists( 'woocommerce_product_archive_description' ) ) { /** * Show a shop page description on product archives. - * - * @subpackage Archives */ function woocommerce_product_archive_description() { - // Don't display the description on search results page + // Don't display the description on search results page. if ( is_search() ) { return; } - if ( is_post_type_archive( 'product' ) && 0 === absint( get_query_var( 'paged' ) ) ) { - $shop_page = get_post( wc_get_page_id( 'shop' ) ); + if ( is_post_type_archive( 'product' ) && in_array( absint( get_query_var( 'paged' ) ), array( 0, 1 ), true ) ) { + $shop_page = get_post( wc_get_page_id( 'shop' ) ); if ( $shop_page ) { $description = wc_format_content( $shop_page->post_content ); if ( $description ) { - echo '
          ' . $description . '
          '; + echo '
          ' . $description . '
          '; // WPCS: XSS ok. } } } @@ -710,47 +1173,52 @@ if ( ! function_exists( 'woocommerce_template_loop_add_to_cart' ) ) { /** * Get the add to cart template for the loop. * - * @subpackage Loop - * - * @param array $args + * @param array $args Arguments. */ function woocommerce_template_loop_add_to_cart( $args = array() ) { global $product; if ( $product ) { $defaults = array( - 'quantity' => 1, - 'class' => implode( ' ', array_filter( array( - 'button', - 'product_type_' . $product->get_type(), - $product->is_purchasable() && $product->is_in_stock() ? 'add_to_cart_button' : '', - $product->supports( 'ajax_add_to_cart' ) ? 'ajax_add_to_cart' : '', + 'quantity' => 1, + 'class' => implode( ' ', array_filter( array( + 'button', + 'product_type_' . $product->get_type(), + $product->is_purchasable() && $product->is_in_stock() ? 'add_to_cart_button' : '', + $product->supports( 'ajax_add_to_cart' ) && $product->is_purchasable() && $product->is_in_stock() ? 'ajax_add_to_cart' : '', ) ) ), + 'attributes' => array( + 'data-product_id' => $product->get_id(), + 'data-product_sku' => $product->get_sku(), + 'aria-label' => $product->add_to_cart_description(), + 'rel' => 'nofollow', + ), ); $args = apply_filters( 'woocommerce_loop_add_to_cart_args', wp_parse_args( $args, $defaults ), $product ); + if ( isset( $args['attributes']['aria-label'] ) ) { + $args['attributes']['aria-label'] = strip_tags( $args['attributes']['aria-label'] ); + } + wc_get_template( 'loop/add-to-cart.php', $args ); } } } + if ( ! function_exists( 'woocommerce_template_loop_product_thumbnail' ) ) { /** * Get the product thumbnail for the loop. - * - * @subpackage Loop */ function woocommerce_template_loop_product_thumbnail() { - echo woocommerce_get_product_thumbnail(); + echo woocommerce_get_product_thumbnail(); // WPCS: XSS ok. } } if ( ! function_exists( 'woocommerce_template_loop_price' ) ) { /** * Get the product price for the loop. - * - * @subpackage Loop */ function woocommerce_template_loop_price() { wc_get_template( 'loop/price.php' ); @@ -760,8 +1228,6 @@ if ( ! function_exists( 'woocommerce_template_loop_rating' ) ) { /** * Display the average rating in the loop. - * - * @subpackage Loop */ function woocommerce_template_loop_rating() { wc_get_template( 'loop/rating.php' ); @@ -771,8 +1237,6 @@ if ( ! function_exists( 'woocommerce_show_product_loop_sale_flash' ) ) { /** * Get the sale flash for the loop. - * - * @subpackage Loop */ function woocommerce_show_product_loop_sale_flash() { wc_get_template( 'loop/sale-flash.php' ); @@ -784,13 +1248,12 @@ if ( ! function_exists( 'woocommerce_get_product_thumbnail' ) ) { /** * Get the product thumbnail, or the placeholder if not set. * - * @subpackage Loop - * @param string $size (default: 'shop_catalog') - * @param int $deprecated1 Deprecated since WooCommerce 2.0 (default: 0) - * @param int $deprecated2 Deprecated since WooCommerce 2.0 (default: 0) + * @param string $size (default: 'woocommerce_thumbnail'). + * @param int $deprecated1 Deprecated since WooCommerce 2.0 (default: 0). + * @param int $deprecated2 Deprecated since WooCommerce 2.0 (default: 0). * @return string */ - function woocommerce_get_product_thumbnail( $size = 'shop_catalog', $deprecated1 = 0, $deprecated2 = 0 ) { + function woocommerce_get_product_thumbnail( $size = 'woocommerce_thumbnail', $deprecated1 = 0, $deprecated2 = 0 ) { global $product; $image_size = apply_filters( 'single_product_archive_thumbnail_size', $size ); @@ -803,11 +1266,18 @@ if ( ! function_exists( 'woocommerce_result_count' ) ) { /** * Output the result count text (Showing x - x of x results). - * - * @subpackage Loop */ function woocommerce_result_count() { - wc_get_template( 'loop/result-count.php' ); + if ( ! wc_get_loop_prop( 'is_paginated' ) || ! woocommerce_products_will_display() ) { + return; + } + $args = array( + 'total' => wc_get_loop_prop( 'total' ), + 'per_page' => wc_get_loop_prop( 'per_page' ), + 'current' => wc_get_loop_prop( 'current_page' ), + ); + + wc_get_template( 'loop/result-count.php', $args ); } } @@ -815,27 +1285,30 @@ if ( ! function_exists( 'woocommerce_catalog_ordering' ) ) { /** * Output the product sorting options. - * - * @subpackage Loop */ function woocommerce_catalog_ordering() { - global $wp_query; - - if ( 1 === (int) $wp_query->found_posts || ! woocommerce_products_will_display() || $wp_query->is_search() ) { + if ( ! wc_get_loop_prop( 'is_paginated' ) || ! woocommerce_products_will_display() ) { return; } - - $orderby = isset( $_GET['orderby'] ) ? wc_clean( $_GET['orderby'] ) : apply_filters( 'woocommerce_default_catalog_orderby', get_option( 'woocommerce_default_catalog_orderby' ) ); $show_default_orderby = 'menu_order' === apply_filters( 'woocommerce_default_catalog_orderby', get_option( 'woocommerce_default_catalog_orderby' ) ); $catalog_orderby_options = apply_filters( 'woocommerce_catalog_orderby', array( 'menu_order' => __( 'Default sorting', 'woocommerce' ), 'popularity' => __( 'Sort by popularity', 'woocommerce' ), 'rating' => __( 'Sort by average rating', 'woocommerce' ), - 'date' => __( 'Sort by newness', 'woocommerce' ), + 'date' => __( 'Sort by latest', 'woocommerce' ), 'price' => __( 'Sort by price: low to high', 'woocommerce' ), 'price-desc' => __( 'Sort by price: high to low', 'woocommerce' ), ) ); + $default_orderby = wc_get_loop_prop( 'is_search' ) ? 'relevance' : apply_filters( 'woocommerce_default_catalog_orderby', get_option( 'woocommerce_default_catalog_orderby', '' ) ); + $orderby = isset( $_GET['orderby'] ) ? wc_clean( wp_unslash( $_GET['orderby'] ) ) : $default_orderby; // WPCS: sanitization ok, input var ok, CSRF ok. + + if ( wc_get_loop_prop( 'is_search' ) ) { + $catalog_orderby_options = array_merge( array( 'relevance' => __( 'Relevance', 'woocommerce' ) ), $catalog_orderby_options ); + + unset( $catalog_orderby_options['menu_order'] ); + } + if ( ! $show_default_orderby ) { unset( $catalog_orderby_options['menu_order'] ); } @@ -844,7 +1317,15 @@ if ( ! function_exists( 'woocommerce_catalog_ordering' ) ) { unset( $catalog_orderby_options['rating'] ); } - wc_get_template( 'loop/orderby.php', array( 'catalog_orderby_options' => $catalog_orderby_options, 'orderby' => $orderby, 'show_default_orderby' => $show_default_orderby ) ); + if ( ! array_key_exists( $orderby, $catalog_orderby_options ) ) { + $orderby = current( array_keys( $catalog_orderby_options ) ); + } + + wc_get_template( 'loop/orderby.php', array( + 'catalog_orderby_options' => $catalog_orderby_options, + 'orderby' => $orderby, + 'show_default_orderby' => $show_default_orderby, + ) ); } } @@ -852,22 +1333,36 @@ if ( ! function_exists( 'woocommerce_pagination' ) ) { /** * Output the pagination. - * - * @subpackage Loop */ function woocommerce_pagination() { - wc_get_template( 'loop/pagination.php' ); + if ( ! wc_get_loop_prop( 'is_paginated' ) || ! woocommerce_products_will_display() ) { + return; + } + + $args = array( + 'total' => wc_get_loop_prop( 'total_pages' ), + 'current' => wc_get_loop_prop( 'current_page' ), + 'base' => esc_url_raw( add_query_arg( 'product-page', '%#%', false ) ), + 'format' => '?product-page=%#%', + ); + + if ( ! wc_get_loop_prop( 'is_shortcode' ) ) { + $args['format'] = ''; + $args['base'] = esc_url_raw( str_replace( 999999999, '%#%', remove_query_arg( 'add-to-cart', get_pagenum_link( 999999999, false ) ) ) ); + } + + wc_get_template( 'loop/pagination.php', $args ); } } -/** Single Product ********************************************************/ +/** + * Single Product + */ if ( ! function_exists( 'woocommerce_show_product_images' ) ) { /** * Output the product image before the single product summary. - * - * @subpackage Product */ function woocommerce_show_product_images() { wc_get_template( 'single-product/product-image.php' ); @@ -877,19 +1372,47 @@ if ( ! function_exists( 'woocommerce_show_product_thumbnails' ) ) { /** * Output the product thumbnails. - * - * @subpackage Product */ function woocommerce_show_product_thumbnails() { wc_get_template( 'single-product/product-thumbnails.php' ); } } + +/** + * Get HTML for a gallery image. + * + * Woocommerce_gallery_thumbnail_size, woocommerce_gallery_image_size and woocommerce_gallery_full_size accept name based image sizes, or an array of width/height values. + * + * @since 3.3.2 + * @param int $attachment_id Attachment ID. + * @param bool $main_image Is this the main image or a thumbnail?. + * @return string + */ +function wc_get_gallery_image_html( $attachment_id, $main_image = false ) { + $flexslider = (bool) apply_filters( 'woocommerce_single_product_flexslider_enabled', get_theme_support( 'wc-product-gallery-slider' ) ); + $gallery_thumbnail = wc_get_image_size( 'gallery_thumbnail' ); + $thumbnail_size = apply_filters( 'woocommerce_gallery_thumbnail_size', array( $gallery_thumbnail['width'], $gallery_thumbnail['height'] ) ); + $image_size = apply_filters( 'woocommerce_gallery_image_size', $flexslider || $main_image ? 'woocommerce_single' : $thumbnail_size ); + $full_size = apply_filters( 'woocommerce_gallery_full_size', apply_filters( 'woocommerce_product_thumbnails_large_size', 'full' ) ); + $thumbnail_src = wp_get_attachment_image_src( $attachment_id, $thumbnail_size ); + $full_src = wp_get_attachment_image_src( $attachment_id, $full_size ); + $image = wp_get_attachment_image( $attachment_id, $image_size, false, array( + 'title' => get_post_field( 'post_title', $attachment_id ), + 'data-caption' => get_post_field( 'post_excerpt', $attachment_id ), + 'data-src' => $full_src[0], + 'data-large_image' => $full_src[0], + 'data-large_image_width' => $full_src[1], + 'data-large_image_height' => $full_src[2], + 'class' => $main_image ? 'wp-post-image' : '', + ) ); + + return '
          ' . $image . '
          '; +} + if ( ! function_exists( 'woocommerce_output_product_data_tabs' ) ) { /** * Output the product tabs. - * - * @subpackage Product/Tabs */ function woocommerce_output_product_data_tabs() { wc_get_template( 'single-product/tabs/tabs.php' ); @@ -899,8 +1422,6 @@ if ( ! function_exists( 'woocommerce_template_single_title' ) ) { /** * Output the product title. - * - * @subpackage Product */ function woocommerce_template_single_title() { wc_get_template( 'single-product/title.php' ); @@ -910,8 +1431,6 @@ if ( ! function_exists( 'woocommerce_template_single_rating' ) ) { /** * Output the product rating. - * - * @subpackage Product */ function woocommerce_template_single_rating() { if ( post_type_supports( 'product', 'comments' ) ) { @@ -923,8 +1442,6 @@ if ( ! function_exists( 'woocommerce_template_single_price' ) ) { /** * Output the product price. - * - * @subpackage Product */ function woocommerce_template_single_price() { wc_get_template( 'single-product/price.php' ); @@ -934,8 +1451,6 @@ if ( ! function_exists( 'woocommerce_template_single_excerpt' ) ) { /** * Output the product short description (excerpt). - * - * @subpackage Product */ function woocommerce_template_single_excerpt() { wc_get_template( 'single-product/short-description.php' ); @@ -945,8 +1460,6 @@ if ( ! function_exists( 'woocommerce_template_single_meta' ) ) { /** * Output the product meta. - * - * @subpackage Product */ function woocommerce_template_single_meta() { wc_get_template( 'single-product/meta.php' ); @@ -956,8 +1469,6 @@ if ( ! function_exists( 'woocommerce_template_single_sharing' ) ) { /** * Output the product sharing. - * - * @subpackage Product */ function woocommerce_template_single_sharing() { wc_get_template( 'single-product/share.php' ); @@ -967,8 +1478,6 @@ if ( ! function_exists( 'woocommerce_show_product_sale_flash' ) ) { /** * Output the product sale flash. - * - * @subpackage Product */ function woocommerce_show_product_sale_flash() { wc_get_template( 'single-product/sale-flash.php' ); @@ -979,8 +1488,6 @@ if ( ! function_exists( 'woocommerce_template_single_add_to_cart' ) ) { /** * Trigger the single product add to cart action. - * - * @subpackage Product */ function woocommerce_template_single_add_to_cart() { global $product; @@ -991,8 +1498,6 @@ if ( ! function_exists( 'woocommerce_simple_add_to_cart' ) ) { /** * Output the simple product add to cart area. - * - * @subpackage Product */ function woocommerce_simple_add_to_cart() { wc_get_template( 'single-product/add-to-cart/simple.php' ); @@ -1002,8 +1507,6 @@ if ( ! function_exists( 'woocommerce_grouped_add_to_cart' ) ) { /** * Output the grouped product add to cart area. - * - * @subpackage Product */ function woocommerce_grouped_add_to_cart() { global $product; @@ -1011,8 +1514,6 @@ if ( ! function_exists( 'woocommerce_grouped_add_to_cart' ) ) { $products = array_filter( array_map( 'wc_get_product', $product->get_children() ), 'wc_products_array_filter_visible_grouped' ); if ( $products ) { - usort( $products, 'wc_products_array_orderby_menu_order' ); - wc_get_template( 'single-product/add-to-cart/grouped.php', array( 'grouped_product' => $product, 'grouped_products' => $products, @@ -1025,19 +1526,17 @@ if ( ! function_exists( 'woocommerce_variable_add_to_cart' ) ) { /** * Output the variable product add to cart area. - * - * @subpackage Product */ function woocommerce_variable_add_to_cart() { global $product; - // Enqueue variation scripts + // Enqueue variation scripts. wp_enqueue_script( 'wc-add-to-cart-variation' ); // Get Available variations? - $get_variations = sizeof( $product->get_children() ) <= apply_filters( 'woocommerce_ajax_variation_threshold', 30, $product ); + $get_variations = count( $product->get_children() ) <= apply_filters( 'woocommerce_ajax_variation_threshold', 30, $product ); - // Load the template + // Load the template. wc_get_template( 'single-product/add-to-cart/variable.php', array( 'available_variations' => $get_variations ? $product->get_available_variations() : false, 'attributes' => $product->get_variation_attributes(), @@ -1049,8 +1548,6 @@ if ( ! function_exists( 'woocommerce_external_add_to_cart' ) ) { /** * Output the external product add to cart area. - * - * @subpackage Product */ function woocommerce_external_add_to_cart() { global $product; @@ -1071,9 +1568,9 @@ if ( ! function_exists( 'woocommerce_quantity_input' ) ) { /** * Output the quantity input for add to cart forms. * - * @param array $args Args for the input - * @param WC_Product|null $product - * @param boolean $echo Whether to return or echo|string + * @param array $args Args for the input. + * @param WC_Product|null $product Product. + * @param boolean $echo Whether to return or echo|string. * * @return string */ @@ -1083,6 +1580,7 @@ if ( ! function_exists( 'woocommerce_quantity_input' ) ) { } $defaults = array( + 'input_id' => uniqid( 'quantity_' ), 'input_name' => 'quantity', 'input_value' => '1', 'max_value' => apply_filters( 'woocommerce_quantity_input_max', -1, $product ), @@ -1108,7 +1606,7 @@ if ( ! function_exists( 'woocommerce_quantity_input' ) ) { wc_get_template( 'global/quantity-input.php', $args ); if ( $echo ) { - echo ob_get_clean(); + echo ob_get_clean(); // WPCS: XSS ok. } else { return ob_get_clean(); } @@ -1119,8 +1617,6 @@ if ( ! function_exists( 'woocommerce_product_description_tab' ) ) { /** * Output the description tab content. - * - * @subpackage Product/Tabs */ function woocommerce_product_description_tab() { wc_get_template( 'single-product/tabs/description.php' ); @@ -1130,37 +1626,23 @@ if ( ! function_exists( 'woocommerce_product_additional_information_tab' ) ) { /** * Output the attributes tab content. - * - * @subpackage Product/Tabs */ function woocommerce_product_additional_information_tab() { wc_get_template( 'single-product/tabs/additional-information.php' ); } } -if ( ! function_exists( 'woocommerce_product_reviews_tab' ) ) { - - /** - * Output the reviews tab content. - * @deprecated 2.4.0 Unused - * @subpackage Product/Tabs - */ - function woocommerce_product_reviews_tab() { - wc_deprecated_function( 'woocommerce_product_reviews_tab', '2.4' ); - } -} - if ( ! function_exists( 'woocommerce_default_product_tabs' ) ) { /** * Add default product tabs to product pages. * - * @param array $tabs + * @param array $tabs Array of tabs. * @return array */ function woocommerce_default_product_tabs( $tabs = array() ) { global $product, $post; - // Description tab - shows product content + // Description tab - shows product content. if ( $post->post_content ) { $tabs['description'] = array( 'title' => __( 'Description', 'woocommerce' ), @@ -1169,7 +1651,7 @@ if ( ! function_exists( 'woocommerce_default_product_tabs' ) ) { ); } - // Additional information tab - shows attributes + // Additional information tab - shows attributes. if ( $product && ( $product->has_attributes() || apply_filters( 'wc_product_enable_dimensions_display', $product->has_weight() || $product->has_dimensions() ) ) ) { $tabs['additional_information'] = array( 'title' => __( 'Additional information', 'woocommerce' ), @@ -1178,9 +1660,10 @@ if ( ! function_exists( 'woocommerce_default_product_tabs' ) ) { ); } - // Reviews tab - shows comments + // Reviews tab - shows comments. if ( comments_open() ) { $tabs['reviews'] = array( + /* translators: %s: reviews count */ 'title' => sprintf( __( 'Reviews (%d)', 'woocommerce' ), $product->get_review_count() ), 'priority' => 30, 'callback' => 'comments_template', @@ -1196,21 +1679,28 @@ if ( ! function_exists( 'woocommerce_sort_product_tabs' ) ) { /** * Sort tabs by priority. * - * @param array $tabs + * @param array $tabs Array of tabs. * @return array */ function woocommerce_sort_product_tabs( $tabs = array() ) { - // Make sure the $tabs parameter is an array + // Make sure the $tabs parameter is an array. if ( ! is_array( $tabs ) ) { - trigger_error( "Function woocommerce_sort_product_tabs() expects an array as the first parameter. Defaulting to empty array." ); + trigger_error( 'Function woocommerce_sort_product_tabs() expects an array as the first parameter. Defaulting to empty array.' ); // @codingStandardsIgnoreLine $tabs = array(); } - // Re-order tabs by priority + // Re-order tabs by priority. if ( ! function_exists( '_sort_priority_callback' ) ) { + /** + * Sort Priority Callback Function + * + * @param array $a Comparison A. + * @param array $b Comparison B. + * @return bool + */ function _sort_priority_callback( $a, $b ) { - if ( $a['priority'] === $b['priority'] ) { + if ( ! isset( $a['priority'], $b['priority'] ) || $a['priority'] === $b['priority'] ) { return 0; } return ( $a['priority'] < $b['priority'] ) ? -1 : 1; @@ -1228,14 +1718,17 @@ if ( ! function_exists( 'woocommerce_comments' ) ) { /** * Output the Review comments template. * - * @subpackage Product - * @param WP_Comment $comment - * @param array $args - * @param int $depth + * @param WP_Comment $comment Comment object. + * @param array $args Arguments. + * @param int $depth Depth. */ function woocommerce_comments( $comment, $args, $depth ) { - $GLOBALS['comment'] = $comment; - wc_get_template( 'single-product/review.php', array( 'comment' => $comment, 'args' => $args, 'depth' => $depth ) ); + $GLOBALS['comment'] = $comment; // WPCS: override ok. + wc_get_template( 'single-product/review.php', array( + 'comment' => $comment, + 'args' => $args, + 'depth' => $depth, + ) ); } } @@ -1291,15 +1784,13 @@ if ( ! function_exists( 'woocommerce_output_related_products' ) ) { /** * Output the related products. - * - * @subpackage Product */ function woocommerce_output_related_products() { $args = array( - 'posts_per_page' => 4, - 'columns' => 4, - 'orderby' => 'rand', + 'posts_per_page' => 4, + 'columns' => 4, + 'orderby' => 'rand', // @codingStandardsIgnoreLine. ); woocommerce_related_products( apply_filters( 'woocommerce_output_related_products_args', $args ) ); @@ -1311,10 +1802,10 @@ if ( ! function_exists( 'woocommerce_related_products' ) ) { /** * Output the related products. * - * @param array Provided arguments + * @param array $args Provided arguments. */ function woocommerce_related_products( $args = array() ) { - global $product, $woocommerce_loop; + global $product; if ( ! $product ) { return; @@ -1323,21 +1814,21 @@ if ( ! function_exists( 'woocommerce_related_products' ) ) { $defaults = array( 'posts_per_page' => 2, 'columns' => 2, - 'orderby' => 'rand', + 'orderby' => 'rand', // @codingStandardsIgnoreLine. 'order' => 'desc', ); $args = wp_parse_args( $args, $defaults ); - // Get visble related products then sort them at random. + // Get visible related products then sort them at random. $args['related_products'] = array_filter( array_map( 'wc_get_product', wc_get_related_products( $product->get_id(), $args['posts_per_page'], $product->get_upsell_ids() ) ), 'wc_products_array_filter_visible' ); // Handle orderby. $args['related_products'] = wc_products_array_orderby( $args['related_products'], $args['orderby'], $args['order'] ); // Set global loop values. - $woocommerce_loop['name'] = 'related'; - $woocommerce_loop['columns'] = apply_filters( 'woocommerce_related_products_columns', $args['columns'] ); + wc_set_loop_prop( 'name', 'related' ); + wc_set_loop_prop( 'columns', apply_filters( 'woocommerce_related_products_columns', $args['columns'] ) ); wc_get_template( 'single-product/related.php', $args ); } @@ -1348,13 +1839,13 @@ if ( ! function_exists( 'woocommerce_upsell_display' ) ) { /** * Output product up sells. * - * @param int $limit (default: -1) - * @param int $columns (default: 4) + * @param int $limit (default: -1). + * @param int $columns (default: 4). * @param string $orderby Supported values - rand, title, ID, date, modified, menu_order, price. * @param string $order Sort direction. */ function woocommerce_upsell_display( $limit = '-1', $columns = 4, $orderby = 'rand', $order = 'desc' ) { - global $product, $woocommerce_loop; + global $product; if ( ! $product ) { return; @@ -1366,17 +1857,18 @@ if ( ! function_exists( 'woocommerce_upsell_display' ) ) { 'orderby' => $orderby, 'columns' => $columns, ) ); - $woocommerce_loop['name'] = 'up-sells'; - $woocommerce_loop['columns'] = apply_filters( 'woocommerce_upsells_columns', isset( $args['columns'] ) ? $args['columns'] : $columns ); - $orderby = apply_filters( 'woocommerce_upsells_orderby', isset( $args['orderby'] ) ? $args['orderby'] : $orderby ); - $limit = apply_filters( 'woocommerce_upsells_total', isset( $args['posts_per_page'] ) ? $args['posts_per_page'] : $limit ); + wc_set_loop_prop( 'name', 'up-sells' ); + wc_set_loop_prop( 'columns', apply_filters( 'woocommerce_upsells_columns', isset( $args['columns'] ) ? $args['columns'] : $columns ) ); - // Get visble upsells then sort them at random, then limit result set. + $orderby = apply_filters( 'woocommerce_upsells_orderby', isset( $args['orderby'] ) ? $args['orderby'] : $orderby ); + $limit = apply_filters( 'woocommerce_upsells_total', isset( $args['posts_per_page'] ) ? $args['posts_per_page'] : $limit ); + + // Get visible upsells then sort them at random, then limit result set. $upsells = wc_products_array_orderby( array_filter( array_map( 'wc_get_product', $product->get_upsell_ids() ), 'wc_products_array_filter_visible' ), $orderby, $order ); $upsells = $limit > 0 ? array_slice( $upsells, 0, $limit ) : $upsells; wc_get_template( 'single-product/up-sells.php', array( - 'upsells' => $upsells, + 'upsells' => $upsells, // Not used now, but used in previous version of up-sells.php. 'posts_per_page' => $limit, @@ -1386,17 +1878,23 @@ if ( ! function_exists( 'woocommerce_upsell_display' ) ) { } } -/** Cart ******************************************************************/ +/** Cart */ if ( ! function_exists( 'woocommerce_shipping_calculator' ) ) { /** * Output the cart shipping calculator. * - * @subpackage Cart + * @param string $button_text Text for the shipping calculation toggle. */ - function woocommerce_shipping_calculator() { - wc_get_template( 'cart/shipping-calculator.php' ); + function woocommerce_shipping_calculator( $button_text = '' ) { + if ( 'no' === get_option( 'woocommerce_enable_shipping_calc' ) || ! WC()->cart->needs_shipping() ) { + return; + } + wp_enqueue_script( 'wc-country-select' ); + wc_get_template( 'cart/shipping-calculator.php', array( + 'button_text' => $button_text, + ) ); } } @@ -1404,8 +1902,6 @@ if ( ! function_exists( 'woocommerce_cart_totals' ) ) { /** * Output the cart totals. - * - * @subpackage Cart */ function woocommerce_cart_totals() { if ( is_checkout() ) { @@ -1420,24 +1916,24 @@ if ( ! function_exists( 'woocommerce_cross_sell_display' ) ) { /** * Output the cart cross-sells. * - * @param int $limit (default: 2) - * @param int $columns (default: 2) - * @param string $orderby (default: 'rand') - * @param string $order (default: 'desc') + * @param int $limit (default: 2). + * @param int $columns (default: 2). + * @param string $orderby (default: 'rand'). + * @param string $order (default: 'desc'). */ function woocommerce_cross_sell_display( $limit = 2, $columns = 2, $orderby = 'rand', $order = 'desc' ) { - global $woocommerce_loop; - if ( is_checkout() ) { return; } // Get visible cross sells then sort them at random. - $cross_sells = array_filter( array_map( 'wc_get_product', WC()->cart->get_cross_sells() ), 'wc_products_array_filter_visible' ); - $woocommerce_loop['name'] = 'cross-sells'; - $woocommerce_loop['columns'] = apply_filters( 'woocommerce_cross_sells_columns', $columns ); + $cross_sells = array_filter( array_map( 'wc_get_product', WC()->cart->get_cross_sells() ), 'wc_products_array_filter_visible' ); + + wc_set_loop_prop( 'name', 'cross-sells' ); + wc_set_loop_prop( 'columns', apply_filters( 'woocommerce_cross_sells_columns', $columns ) ); // Handle orderby and limit results. $orderby = apply_filters( 'woocommerce_cross_sells_orderby', $orderby ); + $order = apply_filters( 'woocommerce_cross_sells_order', $order ); $cross_sells = wc_products_array_orderby( $cross_sells, $orderby, $order ); $limit = apply_filters( 'woocommerce_cross_sells_total', $limit ); $cross_sells = $limit > 0 ? array_slice( $cross_sells, 0, $limit ) : $cross_sells; @@ -1457,8 +1953,6 @@ if ( ! function_exists( 'woocommerce_button_proceed_to_checkout' ) ) { /** * Output the proceed to checkout button. - * - * @subpackage Cart */ function woocommerce_button_proceed_to_checkout() { wc_get_template( 'cart/proceed-to-checkout-button.php' ); @@ -1469,8 +1963,6 @@ if ( ! function_exists( 'woocommerce_widget_shopping_cart_button_view_cart' ) ) /** * Output the view cart button. - * - * @subpackage Cart */ function woocommerce_widget_shopping_cart_button_view_cart() { echo '' . esc_html__( 'View cart', 'woocommerce' ) . ''; @@ -1481,22 +1973,20 @@ if ( ! function_exists( 'woocommerce_widget_shopping_cart_proceed_to_checkout' ) /** * Output the proceed to checkout button. - * - * @subpackage Cart */ function woocommerce_widget_shopping_cart_proceed_to_checkout() { echo '' . esc_html__( 'Checkout', 'woocommerce' ) . ''; } } -/** Mini-Cart *************************************************************/ +/** Mini-Cart */ if ( ! function_exists( 'woocommerce_mini_cart' ) ) { /** * Output the Mini-cart - used by cart widget. * - * @param array $args + * @param array $args Arguments. */ function woocommerce_mini_cart( $args = array() ) { @@ -1510,15 +2000,14 @@ if ( ! function_exists( 'woocommerce_mini_cart' ) ) { } } -/** Login *****************************************************************/ +/** Login */ if ( ! function_exists( 'woocommerce_login_form' ) ) { /** * Output the WooCommerce Login Form. * - * @subpackage Forms - * @param array $args + * @param array $args Arguments. */ function woocommerce_login_form( $args = array() ) { @@ -1538,11 +2027,11 @@ if ( ! function_exists( 'woocommerce_checkout_login_form' ) ) { /** * Output the WooCommerce Checkout Login Form. - * - * @subpackage Checkout */ function woocommerce_checkout_login_form() { - wc_get_template( 'checkout/form-login.php', array( 'checkout' => WC()->checkout() ) ); + wc_get_template( 'checkout/form-login.php', array( + 'checkout' => WC()->checkout(), + ) ); } } @@ -1551,7 +2040,7 @@ if ( ! function_exists( 'woocommerce_breadcrumb' ) ) { /** * Output the WooCommerce Breadcrumb. * - * @param array $args + * @param array $args Arguments. */ function woocommerce_breadcrumb( $args = array() ) { $args = wp_parse_args( $args, apply_filters( 'woocommerce_breadcrumb_defaults', array( @@ -1572,6 +2061,8 @@ if ( ! function_exists( 'woocommerce_breadcrumb' ) ) { $args['breadcrumb'] = $breadcrumbs->generate(); /** + * WooCommerce Breadcrumb hook + * * @hooked WC_Structured_Data::generate_breadcrumblist_data() - 10 */ do_action( 'woocommerce_breadcrumb', $breadcrumbs, $args ); @@ -1585,12 +2076,12 @@ if ( ! function_exists( 'woocommerce_order_review' ) ) { /** * Output the Order review table for the checkout. * - * @subpackage Checkout - * - * @param $deprecated + * @param bool $deprecated Deprecated param. */ function woocommerce_order_review( $deprecated = false ) { - wc_get_template( 'checkout/review-order.php', array( 'checkout' => WC()->checkout() ) ); + wc_get_template( 'checkout/review-order.php', array( + 'checkout' => WC()->checkout(), + ) ); } } @@ -1598,8 +2089,6 @@ if ( ! function_exists( 'woocommerce_checkout_payment' ) ) { /** * Output the Payment Methods on the checkout. - * - * @subpackage Checkout */ function woocommerce_checkout_payment() { if ( WC()->cart->needs_payment() ) { @@ -1621,11 +2110,11 @@ if ( ! function_exists( 'woocommerce_checkout_coupon_form' ) ) { /** * Output the Coupon form for the checkout. - * - * @subpackage Checkout */ function woocommerce_checkout_coupon_form() { - wc_get_template( 'checkout/form-coupon.php', array( 'checkout' => WC()->checkout() ) ); + wc_get_template( 'checkout/form-coupon.php', array( + 'checkout' => WC()->checkout(), + ) ); } } @@ -1633,92 +2122,117 @@ if ( ! function_exists( 'woocommerce_products_will_display' ) ) { /** * Check if we will be showing products or not (and not sub-categories only). - * @subpackage Loop + * * @return bool */ function woocommerce_products_will_display() { - global $wpdb; + $display_type = woocommerce_get_loop_display_mode(); + + return 0 < wc_get_loop_prop( 'total', 0 ) && 'subcategories' !== $display_type; + } +} + +if ( ! function_exists( 'woocommerce_get_loop_display_mode' ) ) { + + /** + * See what is going to display in the loop. + * + * @since 3.3.0 + * @return string Either products, subcategories, or both, based on current page. + */ + function woocommerce_get_loop_display_mode() { + // Only return products when filtering things. + if ( 1 < wc_get_loop_prop( 'current_page' ) || wc_get_loop_prop( 'is_search' ) || wc_get_loop_prop( 'is_filtered' ) ) { + return 'products'; + } + + $parent_id = 0; + $display_type = ''; if ( is_shop() ) { - return 'subcategories' !== get_option( 'woocommerce_shop_page_display' ) || is_search(); + $display_type = get_option( 'woocommerce_shop_page_display', '' ); + } elseif ( is_product_category() ) { + $parent_id = get_queried_object_id(); + $display_type = get_woocommerce_term_meta( $parent_id, 'display_type', true ); + $display_type = '' === $display_type ? get_option( 'woocommerce_category_archive_display', '' ) : $display_type; } - if ( ! is_product_taxonomy() ) { - return false; + // Ensure valid value. + if ( '' === $display_type || ! in_array( $display_type, array( 'products', 'subcategories', 'both' ), true ) ) { + $display_type = 'products'; } - if ( is_search() || is_filtered() || is_paged() ) { - return true; - } + // If we're showing categories, ensure we actually have something to show. + if ( in_array( $display_type, array( 'subcategories', 'both' ), true ) ) { + $subcategories = woocommerce_get_product_subcategories( $parent_id ); - $term = get_queried_object(); - - if ( is_product_category() ) { - switch ( get_woocommerce_term_meta( $term->term_id, 'display_type', true ) ) { - case 'subcategories' : - // Nothing - we want to continue to see if there are products/subcats - break; - case 'products' : - case 'both' : - return true; - break; - default : - // Default - no setting - if ( get_option( 'woocommerce_category_archive_display' ) != 'subcategories' ) { - return true; - } - break; + if ( empty( $subcategories ) ) { + $display_type = 'products'; } } - // Begin subcategory logic - if ( empty( $term->term_id ) || empty( $term->taxonomy ) ) { - return true; + return $display_type; + } +} + +if ( ! function_exists( 'woocommerce_maybe_show_product_subcategories' ) ) { + + /** + * Maybe display categories before, or instead of, a product loop. + * + * @since 3.3.0 + * @param string $loop_html HTML. + * @return string + */ + function woocommerce_maybe_show_product_subcategories( $loop_html = '' ) { + if ( wc_get_loop_prop( 'is_shortcode' ) && ! WC_Template_Loader::in_content_filter() ) { + return $loop_html; } - $transient_name = 'wc_products_will_display_' . $term->term_id . '_' . WC_Cache_Helper::get_transient_version( 'product_query' ); + $display_type = woocommerce_get_loop_display_mode(); - if ( false === ( $products_will_display = get_transient( $transient_name ) ) ) { - $has_children = $wpdb->get_col( $wpdb->prepare( "SELECT term_id FROM {$wpdb->term_taxonomy} WHERE parent = %d AND taxonomy = %s", $term->term_id, $term->taxonomy ) ); + // If displaying categories, append to the loop. + if ( 'subcategories' === $display_type || 'both' === $display_type ) { + ob_start(); + woocommerce_output_product_categories( array( + 'parent_id' => is_product_category() ? get_queried_object_id() : 0, + ) ); + $loop_html .= ob_get_clean(); - if ( $has_children ) { - // Check terms have products inside - parents first. If products are found inside, subcats will be shown instead of products so we can return false. - if ( sizeof( get_objects_in_term( $has_children, $term->taxonomy ) ) > 0 ) { - $products_will_display = false; - } else { - // If we get here, the parents were empty so we're forced to check children - foreach ( $has_children as $term_id ) { - $children = get_term_children( $term_id, $term->taxonomy ); + if ( 'subcategories' === $display_type ) { + wc_set_loop_prop( 'total', 0 ); - if ( sizeof( get_objects_in_term( $children, $term->taxonomy ) ) > 0 ) { - $products_will_display = false; - break; - } - } + // This removes pagination and products from display for themes not using wc_get_loop_prop in their product loops. @todo Remove in future major version. + global $wp_query; + + if ( $wp_query->is_main_query() ) { + $wp_query->post_count = 0; + $wp_query->max_num_pages = 0; } - } else { - $products_will_display = true; } } - set_transient( $transient_name, $products_will_display, DAY_IN_SECONDS * 30 ); - - return $products_will_display; + return $loop_html; } } if ( ! function_exists( 'woocommerce_product_subcategories' ) ) { - /** - * Display product sub categories as thumbnails. + * This is a legacy function which used to check if we needed to display subcats and then output them. It was called by templates. * - * @subpackage Loop - * @param array $args + * From 3.3 onwards this is all handled via hooks and the woocommerce_maybe_show_product_subcategories function. + * + * Since some templates have not updated compatibility, to avoid showing incorrect categories this function has been deprecated and will + * return nothing. Replace usage with woocommerce_output_product_categories to render the category list manually. + * + * This is a legacy function which also checks if things should display. + * Themes no longer need to call these functions. It's all done via hooks. + * + * @deprecated 3.3.1 @todo Add a notice in a future version. + * @param array $args Arguments. * @return null|boolean */ function woocommerce_product_subcategories( $args = array() ) { - global $wp_query; - $defaults = array( 'before' => '', 'after' => '', @@ -1727,92 +2241,101 @@ if ( ! function_exists( 'woocommerce_product_subcategories' ) ) { $args = wp_parse_args( $args, $defaults ); - extract( $args ); + if ( $args['force_display'] ) { + // We can still render if display is forced. + woocommerce_output_product_categories( array( + 'before' => $args['before'], + 'after' => $args['after'], + 'parent_id' => is_product_category() ? get_queried_object_id() : 0, + ) ); + return true; + } else { + // Output nothing. woocommerce_maybe_show_product_subcategories will handle the output of cats. + $display_type = woocommerce_get_loop_display_mode(); - // Main query only - if ( ! is_main_query() && ! $force_display ) { - return; - } + if ( 'subcategories' === $display_type ) { + // This removes pagination and products from display for themes not using wc_get_loop_prop in their product loops. @todo Remove in future major version. + global $wp_query; - // Don't show when filtering, searching or when on page > 1 and ensure we're on a product archive - if ( is_search() || is_filtered() || is_paged() || ( ! is_product_category() && ! is_shop() ) ) { - return; - } - - // Check categories are enabled - if ( is_shop() && '' === get_option( 'woocommerce_shop_page_display' ) ) { - return; - } - - // Find the category + category parent, if applicable - $term = get_queried_object(); - $parent_id = empty( $term->term_id ) ? 0 : $term->term_id; - - if ( is_product_category() ) { - $display_type = get_woocommerce_term_meta( $term->term_id, 'display_type', true ); - - switch ( $display_type ) { - case 'products' : - return; - break; - case '' : - if ( '' === get_option( 'woocommerce_category_archive_display' ) ) { - return; - } - break; + if ( $wp_query->is_main_query() ) { + $wp_query->post_count = 0; + $wp_query->max_num_pages = 0; + } } + + return 'subcategories' === $display_type || 'both' === $display_type; + } + } +} + +if ( ! function_exists( 'woocommerce_output_product_categories' ) ) { + /** + * Display product sub categories as thumbnails. + * + * This is a replacement for woocommerce_product_subcategories which also does some logic + * based on the loop. This function however just outputs when called. + * + * @since 3.3.1 + * @param array $args Arguments. + * @return boolean + */ + function woocommerce_output_product_categories( $args = array() ) { + $args = wp_parse_args( $args, array( + 'before' => apply_filters( 'woocommerce_before_output_product_categories', '' ), + 'after' => apply_filters( 'woocommerce_after_output_product_categories', '' ), + 'parent_id' => 0, + ) ); + + $product_categories = woocommerce_get_product_subcategories( $args['parent_id'] ); + + if ( ! $product_categories ) { + return false; } - // NOTE: using child_of instead of parent - this is not ideal but due to a WP bug ( https://core.trac.wordpress.org/ticket/15626 ) pad_counts won't work - $product_categories = get_categories( apply_filters( 'woocommerce_product_subcategories_args', array( - 'parent' => $parent_id, - 'menu_order' => 'ASC', - 'hide_empty' => 0, - 'hierarchical' => 1, - 'taxonomy' => 'product_cat', - 'pad_counts' => 1, - ) ) ); + echo $args['before']; // WPCS: XSS ok. + + foreach ( $product_categories as $category ) { + wc_get_template( 'content-product_cat.php', array( + 'category' => $category, + ) ); + } + + echo $args['after']; // WPCS: XSS ok. + + return true; + } +} + +if ( ! function_exists( 'woocommerce_get_product_subcategories' ) ) { + /** + * Get (and cache) product subcategories. + * + * @param int $parent_id Get subcategories of this ID. + * @return array + */ + function woocommerce_get_product_subcategories( $parent_id = 0 ) { + $parent_id = absint( $parent_id ); + $product_categories = wp_cache_get( 'product-category-hierarchy-' . $parent_id, 'product_cat' ); + + if ( false === $product_categories ) { + // NOTE: using child_of instead of parent - this is not ideal but due to a WP bug ( https://core.trac.wordpress.org/ticket/15626 ) pad_counts won't work. + $product_categories = get_categories( apply_filters( 'woocommerce_product_subcategories_args', array( + 'parent' => $parent_id, + 'menu_order' => 'ASC', + 'hide_empty' => 0, + 'hierarchical' => 1, + 'taxonomy' => 'product_cat', + 'pad_counts' => 1, + ) ) ); + + wp_cache_set( 'product-category-hierarchy-' . $parent_id, $product_categories, 'product_cat' ); + } if ( apply_filters( 'woocommerce_product_subcategories_hide_empty', true ) ) { $product_categories = wp_list_filter( $product_categories, array( 'count' => 0 ), 'NOT' ); } - if ( $product_categories ) { - echo $before; - - foreach ( $product_categories as $category ) { - wc_get_template( 'content-product_cat.php', array( - 'category' => $category, - ) ); - } - - // If we are hiding products disable the loop and pagination - if ( is_product_category() ) { - $display_type = get_woocommerce_term_meta( $term->term_id, 'display_type', true ); - - switch ( $display_type ) { - case 'subcategories' : - $wp_query->post_count = 0; - $wp_query->max_num_pages = 0; - break; - case '' : - if ( 'subcategories' === get_option( 'woocommerce_category_archive_display' ) ) { - $wp_query->post_count = 0; - $wp_query->max_num_pages = 0; - } - break; - } - } - - if ( is_shop() && 'subcategories' === get_option( 'woocommerce_shop_page_display' ) ) { - $wp_query->post_count = 0; - $wp_query->max_num_pages = 0; - } - - echo $after; - - return true; - } + return $product_categories; } } @@ -1821,13 +2344,12 @@ if ( ! function_exists( 'woocommerce_subcategory_thumbnail' ) ) { /** * Show subcategory thumbnails. * - * @param mixed $category - * @subpackage Loop + * @param mixed $category Category. */ function woocommerce_subcategory_thumbnail( $category ) { - $small_thumbnail_size = apply_filters( 'subcategory_archive_thumbnail_size', 'shop_catalog' ); - $dimensions = wc_get_image_size( $small_thumbnail_size ); - $thumbnail_id = get_woocommerce_term_meta( $category->term_id, 'thumbnail_id', true ); + $small_thumbnail_size = apply_filters( 'subcategory_archive_thumbnail_size', 'woocommerce_thumbnail' ); + $dimensions = wc_get_image_size( $small_thumbnail_size ); + $thumbnail_id = get_woocommerce_term_meta( $category->term_id, 'thumbnail_id', true ); if ( $thumbnail_id ) { $image = wp_get_attachment_image_src( $thumbnail_id, $small_thumbnail_size ); @@ -1836,15 +2358,16 @@ if ( ! function_exists( 'woocommerce_subcategory_thumbnail' ) ) { $image_sizes = function_exists( 'wp_get_attachment_image_sizes' ) ? wp_get_attachment_image_sizes( $thumbnail_id, $small_thumbnail_size ) : false; } else { $image = wc_placeholder_img_src(); - $image_srcset = $image_sizes = false; + $image_srcset = false; + $image_sizes = false; } if ( $image ) { - // Prevent esc_url from breaking spaces in urls for image embeds - // Ref: https://core.trac.wordpress.org/ticket/23605 + // Prevent esc_url from breaking spaces in urls for image embeds. + // Ref: https://core.trac.wordpress.org/ticket/23605. $image = str_replace( ' ', '%20', $image ); - // Add responsive image markup if available + // Add responsive image markup if available. if ( $image_srcset && $image_sizes ) { echo '' . esc_attr( $category->name ) . ''; } else { @@ -1859,8 +2382,7 @@ if ( ! function_exists( 'woocommerce_order_details_table' ) ) { /** * Displays order details in a table. * - * @param mixed $order_id - * @subpackage Orders + * @param mixed $order_id Order ID. */ function woocommerce_order_details_table( $order_id ) { if ( ! $order_id ) { @@ -1879,7 +2401,7 @@ if ( ! function_exists( 'woocommerce_order_downloads_table' ) ) { * Displays order downloads in a table. * * @since 3.2.0 - * @param array $downloads + * @param array $downloads Downloads. */ function woocommerce_order_downloads_table( $downloads ) { if ( ! $downloads ) { @@ -1896,33 +2418,30 @@ if ( ! function_exists( 'woocommerce_order_again_button' ) ) { /** * Display an 'order again' button on the view order page. * - * @param object $order - * @subpackage Orders + * @param object $order Order. */ function woocommerce_order_again_button( $order ) { - if ( ! $order || ! $order->has_status( 'completed' ) || ! is_user_logged_in() ) { + if ( ! $order || ! $order->has_status( apply_filters( 'woocommerce_valid_order_statuses_for_order_again', array( 'completed' ) ) ) || ! is_user_logged_in() ) { return; } wc_get_template( 'order/order-again.php', array( - 'order' => $order, + 'order' => $order, + 'order_again_url' => wp_nonce_url( add_query_arg( 'order_again', $order->get_id(), wc_get_cart_url() ), 'woocommerce-order_again' ), ) ); } } -/** Forms ****************************************************************/ +/** Forms */ if ( ! function_exists( 'woocommerce_form_field' ) ) { /** * Outputs a checkout/address form field. * - * @subpackage Forms - * - * @param string $key - * @param mixed $args - * @param string $value (default: null) - * + * @param string $key Key. + * @param mixed $args Arguments. + * @param string $value (default: null). * @return string */ function woocommerce_form_field( $key, $args, $value = null ) { @@ -1952,9 +2471,9 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { if ( $args['required'] ) { $args['class'][] = 'validate-required'; - $required = ' *'; + $required = ' *'; } else { - $required = ''; + $required = ' (' . esc_html__( 'optional', 'woocommerce' ) . ')'; } if ( is_string( $args['label_class'] ) ) { @@ -1965,9 +2484,9 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { $value = $args['default']; } - // Custom attribute handling + // Custom attribute handling. $custom_attributes = array(); - $args['custom_attributes'] = array_filter( (array) $args['custom_attributes'] ); + $args['custom_attributes'] = array_filter( (array) $args['custom_attributes'], 'strlen' ); if ( $args['maxlength'] ) { $args['custom_attributes']['maxlength'] = absint( $args['maxlength'] ); @@ -1981,6 +2500,10 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { $args['custom_attributes']['autofocus'] = 'autofocus'; } + if ( $args['description'] ) { + $args['custom_attributes']['aria-describedby'] = $args['id'] . '-description'; + } + if ( ! empty( $args['custom_attributes'] ) && is_array( $args['custom_attributes'] ) ) { foreach ( $args['custom_attributes'] as $attribute => $attribute_value ) { $custom_attributes[] = esc_attr( $attribute ) . '="' . esc_attr( $attribute_value ) . '"'; @@ -1999,19 +2522,18 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { $field_container = '

          %3$s

          '; switch ( $args['type'] ) { - case 'country' : - + case 'country': $countries = 'shipping_country' === $key ? WC()->countries->get_shipping_countries() : WC()->countries->get_allowed_countries(); - if ( 1 === sizeof( $countries ) ) { + if ( 1 === count( $countries ) ) { $field .= '' . current( array_values( $countries ) ) . ''; - $field .= ''; + $field .= ''; } else { - $field = ''; foreach ( $countries as $ckey => $cvalue ) { $field .= ''; @@ -2019,12 +2541,12 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { $field .= ''; - $field .= ''; + $field .= ''; } break; - case 'state' : + case 'state': /* Get country this state field is representing */ $for_country = isset( $args['country'] ) ? $args['country'] : WC()->checkout->get_value( 'billing_state' === $key ? 'billing_country' : 'shipping_country' ); $states = WC()->countries->get_states( $for_country ); @@ -2033,7 +2555,7 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { $field_container = ''; - $field .= ''; + $field .= ''; } elseif ( ! is_null( $for_country ) && is_array( $states ) ) { @@ -2053,35 +2575,38 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { } break; - case 'textarea' : - + case 'textarea': $field .= ''; break; - case 'checkbox' : - + case 'checkbox': $field = ''; + ' . $args['label'] . $required . ''; break; - case 'password' : - case 'text' : - case 'email' : - case 'tel' : - case 'number' : - + case 'text': + case 'password': + case 'datetime': + case 'datetime-local': + case 'date': + case 'month': + case 'time': + case 'week': + case 'number': + case 'email': + case 'url': + case 'tel': $field .= ''; break; - case 'select' : - - $options = $field = ''; + case 'select': + $field = ''; + $options = ''; if ( ! empty( $args['options'] ) ) { foreach ( $args['options'] as $option_key => $option_text ) { if ( '' === $option_key ) { - // If we have a blank option, select2 needs a placeholder + // If we have a blank option, select2 needs a placeholder. if ( empty( $args['placeholder'] ) ) { $args['placeholder'] = $option_text ? $option_text : __( 'Choose an option', 'woocommerce' ); } @@ -2096,13 +2621,12 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { } break; - case 'radio' : - + case 'radio': $label_id = current( array_keys( $args['options'] ) ); if ( ! empty( $args['options'] ) ) { foreach ( $args['options'] as $option_key => $option_text ) { - $field .= ''; + $field .= ''; $field .= ''; } } @@ -2113,27 +2637,39 @@ if ( ! function_exists( 'woocommerce_form_field' ) ) { if ( ! empty( $field ) ) { $field_html = ''; - if ( $args['label'] && 'checkbox' != $args['type'] ) { + if ( $args['label'] && 'checkbox' !== $args['type'] ) { $field_html .= ''; } - $field_html .= $field; + $field_html .= '' . $field; if ( $args['description'] ) { - $field_html .= '' . esc_html( $args['description'] ) . ''; + $field_html .= ''; } + $field_html .= ''; + $container_class = esc_attr( implode( ' ', $args['class'] ) ); $container_id = esc_attr( $args['id'] ) . '_field'; $field = sprintf( $field_container, $container_class, $container_id, $field_html ); } + /** + * Filter by type. + */ $field = apply_filters( 'woocommerce_form_field_' . $args['type'], $field, $key, $args, $value ); + /** + * General filter on form fields. + * + * @since 3.4.0 + */ + $field = apply_filters( 'woocommerce_form_field', $field, $key, $args, $value ); + if ( $args['return'] ) { return $field; } else { - echo $field; + echo $field; // WPCS: XSS ok. } } } @@ -2149,11 +2685,10 @@ if ( ! function_exists( 'get_product_search_form' ) ) { * * The default searchform uses html5. * - * @subpackage Forms - * @param bool $echo (default: true) + * @param bool $echo (default: true). * @return string */ - function get_product_search_form( $echo = true ) { + function get_product_search_form( $echo = true ) { global $product_search_form_index; ob_start(); @@ -2170,11 +2705,11 @@ if ( ! function_exists( 'get_product_search_form' ) ) { $form = apply_filters( 'get_product_search_form', ob_get_clean() ); - if ( $echo ) { - echo $form; - } else { + if ( ! $echo ) { return $form; } + + echo $form; // WPCS: XSS ok. } } @@ -2223,7 +2758,7 @@ if ( ! function_exists( 'wc_dropdown_variation_attribute_options' ) ) { /** * Output a list of variation attributes for use in the cart forms. * - * @param array $args + * @param array $args Arguments. * @since 2.4.0 */ function wc_dropdown_variation_attribute_options( $args = array() ) { @@ -2231,20 +2766,26 @@ if ( ! function_exists( 'wc_dropdown_variation_attribute_options' ) ) { 'options' => false, 'attribute' => false, 'product' => false, - 'selected' => false, + 'selected' => false, 'name' => '', 'id' => '', 'class' => '', 'show_option_none' => __( 'Choose an option', 'woocommerce' ), ) ); + // Get selected value. + if ( false === $args['selected'] && $args['attribute'] && $args['product'] instanceof WC_Product ) { + $selected_key = 'attribute_' . sanitize_title( $args['attribute'] ); + $args['selected'] = isset( $_REQUEST[ $selected_key ] ) ? wc_clean( wp_unslash( $_REQUEST[ $selected_key ] ) ) : $args['product']->get_variation_default_attribute( $args['attribute'] ); // WPCS: input var ok, CSRF ok, sanitization ok. + } + $options = $args['options']; $product = $args['product']; $attribute = $args['attribute']; $name = $args['name'] ? $args['name'] : 'attribute_' . sanitize_title( $attribute ); $id = $args['id'] ? $args['id'] : sanitize_title( $attribute ); $class = $args['class']; - $show_option_none = $args['show_option_none'] ? true : false; + $show_option_none = (bool) $args['show_option_none']; $show_option_none_text = $args['show_option_none'] ? $args['show_option_none'] : __( 'Choose an option', 'woocommerce' ); // We'll do our best to hide the placeholder, but we'll need to show something when resetting options. if ( empty( $options ) && ! empty( $product ) && ! empty( $attribute ) ) { @@ -2252,16 +2793,18 @@ if ( ! function_exists( 'wc_dropdown_variation_attribute_options' ) ) { $options = $attributes[ $attribute ]; } - $html = ''; $html .= ''; if ( ! empty( $options ) ) { if ( $product && taxonomy_exists( $attribute ) ) { // Get terms if this is a taxonomy - ordered. We need the names too. - $terms = wc_get_product_terms( $product->get_id(), $attribute, array( 'fields' => 'all' ) ); + $terms = wc_get_product_terms( $product->get_id(), $attribute, array( + 'fields' => 'all', + ) ); foreach ( $terms as $term ) { - if ( in_array( $term->slug, $options ) ) { + if ( in_array( $term->slug, $options, true ) ) { $html .= ''; } } @@ -2269,14 +2812,14 @@ if ( ! function_exists( 'wc_dropdown_variation_attribute_options' ) ) { foreach ( $options as $option ) { // This handles < 2.4.0 bw compatibility where text attributes were not sanitized. $selected = sanitize_title( $args['selected'] ) === $args['selected'] ? selected( $args['selected'], sanitize_title( $option ), false ) : selected( $args['selected'], $option, false ); - $html .= ''; + $html .= ''; } } } $html .= ''; - echo apply_filters( 'woocommerce_dropdown_variation_attribute_options_html', $html, $args ); + echo apply_filters( 'woocommerce_dropdown_variation_attribute_options_html', $html, $args ); // WPCS: XSS ok. } } @@ -2288,15 +2831,17 @@ if ( ! function_exists( 'woocommerce_account_content' ) ) { function woocommerce_account_content() { global $wp; - foreach ( $wp->query_vars as $key => $value ) { - // Ignore pagename param. - if ( 'pagename' === $key ) { - continue; - } + if ( ! empty( $wp->query_vars ) ) { + foreach ( $wp->query_vars as $key => $value ) { + // Ignore pagename param. + if ( 'pagename' === $key ) { + continue; + } - if ( has_action( 'woocommerce_account_' . $key . '_endpoint' ) ) { - do_action( 'woocommerce_account_' . $key . '_endpoint', $value ); - return; + if ( has_action( 'woocommerce_account_' . $key . '_endpoint' ) ) { + do_action( 'woocommerce_account_' . $key . '_endpoint', $value ); + return; + } } } @@ -2326,14 +2871,18 @@ if ( ! function_exists( 'woocommerce_account_orders' ) ) { */ function woocommerce_account_orders( $current_page ) { $current_page = empty( $current_page ) ? 1 : absint( $current_page ); - $customer_orders = wc_get_orders( apply_filters( 'woocommerce_my_account_my_orders_query', array( 'customer' => get_current_user_id(), 'page' => $current_page, 'paginate' => true ) ) ); + $customer_orders = wc_get_orders( apply_filters( 'woocommerce_my_account_my_orders_query', array( + 'customer' => get_current_user_id(), + 'page' => $current_page, + 'paginate' => true, + ) ) ); wc_get_template( 'myaccount/orders.php', array( - 'current_page' => absint( $current_page ), + 'current_page' => absint( $current_page ), 'customer_orders' => $customer_orders, - 'has_orders' => 0 < $customer_orders->total, + 'has_orders' => 0 < $customer_orders->total, ) ); } @@ -2408,7 +2957,7 @@ if ( ! function_exists( 'woocommerce_account_edit_account' ) ) { if ( ! function_exists( 'wc_no_products_found' ) ) { /** - * Show no products found message. + * Handles the loop when no products were found/no product exist. */ function wc_no_products_found() { wc_get_template( 'loop/no-products-found.php' ); @@ -2420,8 +2969,8 @@ if ( ! function_exists( 'wc_get_email_order_items' ) ) { /** * Get HTML for the order items to be shown in emails. * - * @param WC_Order $order - * @param array $args + * @param WC_Order $order Order object. + * @param array $args Arguments. * * @since 3.0.0 * @return string @@ -2459,9 +3008,10 @@ if ( ! function_exists( 'wc_get_email_order_items' ) ) { if ( ! function_exists( 'wc_display_item_meta' ) ) { /** * Display item meta data. + * * @since 3.0.0 - * @param WC_Item $item - * @param array $args + * @param WC_Order_Item $item Order Item. + * @param array $args Arguments. * @return string|void */ function wc_display_item_meta( $item, $args = array() ) { @@ -2469,15 +3019,17 @@ if ( ! function_exists( 'wc_display_item_meta' ) ) { $html = ''; $args = wp_parse_args( $args, array( 'before' => '
          • ', - 'after' => '
          ', - 'separator' => '
        • ', - 'echo' => true, - 'autop' => false, + 'after' => '
          • ', + 'separator' => '
        • ', + 'echo' => true, + 'autop' => false, + 'label_before' => '', + 'label_after' => ': ', ) ); foreach ( $item->get_formatted_meta_data() as $meta_id => $meta ) { - $value = $args['autop'] ? wp_kses_post( $meta->display_value ) : wp_kses_post( make_clickable( trim( $meta->display_value ) ) ); - $strings[] = '' . wp_kses_post( $meta->display_key ) . ': ' . $value; + $value = $args['autop'] ? wp_kses_post( $meta->display_value ) : wp_kses_post( make_clickable( trim( $meta->display_value ) ) ); + $strings[] = $args['label_before'] . wp_kses_post( $meta->display_key ) . $args['label_after'] . $value; } if ( $strings ) { @@ -2487,7 +3039,7 @@ if ( ! function_exists( 'wc_display_item_meta' ) ) { $html = apply_filters( 'woocommerce_display_item_meta', $html, $item, $args ); if ( $args['echo'] ) { - echo $html; + echo $html; // WPCS: XSS ok. } else { return $html; } @@ -2497,9 +3049,10 @@ if ( ! function_exists( 'wc_display_item_meta' ) ) { if ( ! function_exists( 'wc_display_item_downloads' ) ) { /** * Display item download links. + * * @since 3.0.0 - * @param WC_Item $item - * @param array $args + * @param WC_Order_Item $item Order Item. + * @param array $args Arguments. * @return string|void */ function wc_display_item_downloads( $item, $args = array() ) { @@ -2513,7 +3066,9 @@ if ( ! function_exists( 'wc_display_item_downloads' ) ) { 'show_url' => false, ) ); - if ( is_object( $item ) && $item->is_type( 'line_item' ) && ( $downloads = $item->get_item_downloads() ) ) { + $downloads = is_object( $item ) && $item->is_type( 'line_item' ) ? $item->get_item_downloads() : array(); + + if ( $downloads ) { $i = 0; foreach ( $downloads as $file ) { $i ++; @@ -2521,7 +3076,8 @@ if ( ! function_exists( 'wc_display_item_downloads' ) ) { if ( $args['show_url'] ) { $strings[] = '' . esc_html( $file['name'] ) . ': ' . esc_html( $file['download_url'] ); } else { - $prefix = sizeof( $downloads ) > 1 ? sprintf( __( 'Download %d', 'woocommerce' ), $i ) : __( 'Download', 'woocommerce' ); + /* translators: %d: downloads count */ + $prefix = count( $downloads ) > 1 ? sprintf( __( 'Download %d', 'woocommerce' ), $i ) : __( 'Download', 'woocommerce' ); $strings[] = '' . $prefix . ': ' . esc_html( $file['name'] ) . ''; } } @@ -2534,7 +3090,7 @@ if ( ! function_exists( 'wc_display_item_downloads' ) ) { $html = apply_filters( 'woocommerce_display_item_downloads', $html, $item, $args ); if ( $args['echo'] ) { - echo $html; + echo $html; // WPCS: XSS ok. } else { return $html; } @@ -2545,7 +3101,6 @@ if ( ! function_exists( 'woocommerce_photoswipe' ) ) { /** * Get the shop sidebar template. - * */ function woocommerce_photoswipe() { if ( current_theme_supports( 'wc-product-gallery-lightbox' ) ) { @@ -2556,8 +3111,9 @@ if ( ! function_exists( 'woocommerce_photoswipe' ) ) { /** * Outputs a list of product attributes for a product. + * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product Product Object. */ function wc_display_product_attributes( $product ) { wc_get_template( 'single-product/product-attributes.php', array( @@ -2569,13 +3125,13 @@ function wc_display_product_attributes( $product ) { /** * Get HTML to show product stock. + * * @since 3.0.0 - * @param WC_Product $product + * @param WC_Product $product Product Object. * @return string */ function wc_get_stock_html( $product ) { - - $html = ''; + $html = ''; $availability = $product->get_availability(); if ( ! empty( $availability['availability'] ) ) { @@ -2607,14 +3163,7 @@ function wc_get_stock_html( $product ) { * @return string */ function wc_get_rating_html( $rating, $count = 0 ) { - if ( 0 < $rating ) { - $html = '
          '; - $html .= wc_get_star_rating_html( $rating, $count ); - $html .= '
          '; - } else { - $html = ''; - } - + $html = 0 < $rating ? '
          ' . wc_get_star_rating_html( $rating, $count ) . '
          ' : ''; return apply_filters( 'woocommerce_product_get_rating_html', $html, $rating, $count ); } @@ -2657,19 +3206,18 @@ function wc_get_price_html_from_text() { * * @since 2.6.9 * - * @param string $redirect + * @param string $redirect Redirect URL. * * @return string */ function wc_logout_url( $redirect = '' ) { - $logout_endpoint = get_option( 'woocommerce_logout_endpoint' ); - $redirect = $redirect ? $redirect : wc_get_page_permalink( 'myaccount' ); + $redirect = $redirect ? $redirect : wc_get_page_permalink( 'myaccount' ); - if ( $logout_endpoint ) { + if ( get_option( 'woocommerce_logout_endpoint' ) ) { return wp_nonce_url( wc_get_endpoint_url( 'customer-logout', '', $redirect ), 'customer-logout' ); - } else { - return wp_logout_url( $redirect ); } + + return wp_logout_url( $redirect ); } /** @@ -2678,7 +3226,7 @@ function wc_logout_url( $redirect = '' ) { * @since 3.1.0 */ function wc_empty_cart_message() { - echo '

          ' . apply_filters( 'wc_empty_cart_message', __( 'Your cart is currently empty.', 'woocommerce' ) ) . '

          '; + echo '

          ' . wp_kses_post( apply_filters( 'wc_empty_cart_message', __( 'Your cart is currently empty.', 'woocommerce' ) ) ) . '

          '; } /** @@ -2692,3 +3240,159 @@ function wc_page_noindex() { } } add_action( 'wp_head', 'wc_page_noindex' ); + +/** + * Get a slug identifying the current theme. + * + * @since 3.3.0 + * @return string + */ +function wc_get_theme_slug_for_templates() { + return apply_filters( 'woocommerce_theme_slug_for_templates', get_option( 'template' ) ); +} + +/** + * Gets and formats a list of cart item data + variations for display on the frontend. + * + * @since 3.3.0 + * @param array $cart_item Cart item object. + * @param bool $flat Should the data be returned flat or in a list. + * @return string + */ +function wc_get_formatted_cart_item_data( $cart_item, $flat = false ) { + $item_data = array(); + + // Variation values are shown only if they are not found in the title as of 3.0. + // This is because variation titles display the attributes. + if ( $cart_item['data']->is_type( 'variation' ) && is_array( $cart_item['variation'] ) ) { + foreach ( $cart_item['variation'] as $name => $value ) { + $taxonomy = wc_attribute_taxonomy_name( str_replace( 'attribute_pa_', '', urldecode( $name ) ) ); + + if ( taxonomy_exists( $taxonomy ) ) { + // If this is a term slug, get the term's nice name. + $term = get_term_by( 'slug', $value, $taxonomy ); + if ( ! is_wp_error( $term ) && $term && $term->name ) { + $value = $term->name; + } + $label = wc_attribute_label( $taxonomy ); + } else { + // If this is a custom option slug, get the options name. + $value = apply_filters( 'woocommerce_variation_option_name', $value ); + $label = wc_attribute_label( str_replace( 'attribute_', '', $name ), $cart_item['data'] ); + } + + // Check the nicename against the title. + if ( '' === $value || wc_is_attribute_in_product_name( $value, $cart_item['data']->get_name() ) ) { + continue; + } + + $item_data[] = array( + 'key' => $label, + 'value' => $value, + ); + } + } + + // Filter item data to allow 3rd parties to add more to the array. + $item_data = apply_filters( 'woocommerce_get_item_data', $item_data, $cart_item ); + + // Format item data ready to display. + foreach ( $item_data as $key => $data ) { + // Set hidden to true to not display meta on cart. + if ( ! empty( $data['hidden'] ) ) { + unset( $item_data[ $key ] ); + continue; + } + $item_data[ $key ]['key'] = ! empty( $data['key'] ) ? $data['key'] : $data['name']; + $item_data[ $key ]['display'] = ! empty( $data['display'] ) ? $data['display'] : $data['value']; + } + + // Output flat or in list format. + if ( count( $item_data ) > 0 ) { + ob_start(); + + if ( $flat ) { + foreach ( $item_data as $data ) { + echo esc_html( $data['key'] ) . ': ' . wp_kses_post( $data['display'] ) . "\n"; + } + } else { + wc_get_template( 'cart/cart-item-data.php', array( 'item_data' => $item_data ) ); + } + + return ob_get_clean(); + } + + return ''; +} + +/** + * Gets the url to remove an item from the cart. + * + * @since 3.3.0 + * @param string $cart_item_key contains the id of the cart item. + * @return string url to page + */ +function wc_get_cart_remove_url( $cart_item_key ) { + $cart_page_url = wc_get_page_permalink( 'cart' ); + return apply_filters( 'woocommerce_get_remove_url', $cart_page_url ? wp_nonce_url( add_query_arg( 'remove_item', $cart_item_key, $cart_page_url ), 'woocommerce-cart' ) : '' ); +} + +/** + * Gets the url to re-add an item into the cart. + * + * @since 3.3.0 + * @param string $cart_item_key Cart item key to undo. + * @return string url to page + */ +function wc_get_cart_undo_url( $cart_item_key ) { + $cart_page_url = wc_get_page_permalink( 'cart' ); + + $query_args = array( + 'undo_item' => $cart_item_key, + ); + + return apply_filters( 'woocommerce_get_undo_url', $cart_page_url ? wp_nonce_url( add_query_arg( $query_args, $cart_page_url ), 'woocommerce-cart' ) : '', $cart_item_key ); +} + +/** + * Outputs all queued notices on WC pages. + * + * @since 3.5.0 + */ +function woocommerce_output_all_notices() { + echo '
          '; + wc_print_notices(); + echo '
          '; +} + +/** + * Products RSS Feed. + * + * @deprecated 2.6 + */ +function wc_products_rss_feed() { + wc_deprecated_function( 'wc_products_rss_feed', '2.6' ); +} + +if ( ! function_exists( 'woocommerce_reset_loop' ) ) { + + /** + * Reset the loop's index and columns when we're done outputting a product loop. + * + * @deprecated 3.3 + */ + function woocommerce_reset_loop() { + wc_reset_loop(); + } +} + +if ( ! function_exists( 'woocommerce_product_reviews_tab' ) ) { + /** + * Output the reviews tab content. + * + * @deprecated 2.4.0 Unused. + */ + function woocommerce_product_reviews_tab() { + wc_deprecated_function( 'woocommerce_product_reviews_tab', '2.4' ); + } +} diff --git a/includes/wc-template-hooks.php b/includes/wc-template-hooks.php index cb73b62af7c..a606bce240c 100644 --- a/includes/wc-template-hooks.php +++ b/includes/wc-template-hooks.php @@ -4,15 +4,11 @@ * * Action/filter hooks used for WooCommerce functions/templates. * - * @author WooThemes - * @category Core - * @package WooCommerce/Templates - * @version 2.1.0 + * @package WooCommerce/Templates + * @version 2.1.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; add_filter( 'body_class', 'wc_body_class' ); add_filter( 'post_class', 'wc_product_post_class', 20, 3 ); @@ -20,10 +16,10 @@ add_filter( 'post_class', 'wc_product_post_class', 20, 3 ); /** * WP Header. * - * @see wc_generator_tag() + * @see wc_generator_tag() */ -add_action( 'get_the_generator_html', 'wc_generator_tag', 10, 2 ); -add_action( 'get_the_generator_xhtml', 'wc_generator_tag', 10, 2 ); +add_filter( 'get_the_generator_html', 'wc_generator_tag', 10, 2 ); +add_filter( 'get_the_generator_xhtml', 'wc_generator_tag', 10, 2 ); /** * Content Wrappers. @@ -66,6 +62,11 @@ add_action( 'woocommerce_sidebar', 'woocommerce_get_sidebar', 10 ); add_action( 'woocommerce_archive_description', 'woocommerce_taxonomy_archive_description', 10 ); add_action( 'woocommerce_archive_description', 'woocommerce_product_archive_description', 10 ); +/** + * Product loop start. + */ +add_filter( 'woocommerce_product_loop_start', 'woocommerce_maybe_show_product_subcategories' ); + /** * Products Loop. * @@ -211,6 +212,8 @@ add_action( 'woocommerce_before_checkout_form', 'woocommerce_checkout_login_form add_action( 'woocommerce_before_checkout_form', 'woocommerce_checkout_coupon_form', 10 ); add_action( 'woocommerce_checkout_order_review', 'woocommerce_order_review', 10 ); add_action( 'woocommerce_checkout_order_review', 'woocommerce_checkout_payment', 20 ); +add_action( 'woocommerce_checkout_terms_and_conditions', 'wc_checkout_privacy_policy_text', 20 ); +add_action( 'woocommerce_checkout_terms_and_conditions', 'wc_terms_and_conditions_page_content', 30 ); /** * Cart widget @@ -284,3 +287,16 @@ add_action( 'woocommerce_account_edit-address_endpoint', 'woocommerce_account_ed add_action( 'woocommerce_account_payment-methods_endpoint', 'woocommerce_account_payment_methods' ); add_action( 'woocommerce_account_add-payment-method_endpoint', 'woocommerce_account_add_payment_method' ); add_action( 'woocommerce_account_edit-account_endpoint', 'woocommerce_account_edit_account' ); +add_action( 'woocommerce_register_form', 'wc_registration_privacy_policy_text', 20 ); + +/** + * Notices. + */ +add_action( 'woocommerce_cart_is_empty', 'woocommerce_output_all_notices', 5 ); +add_action( 'woocommerce_shortcode_before_product_cat_loop', 'woocommerce_output_all_notices', 10 ); +add_action( 'woocommerce_before_shop_loop', 'woocommerce_output_all_notices', 10 ); +add_action( 'woocommerce_before_single_product', 'woocommerce_output_all_notices', 10 ); +add_action( 'woocommerce_before_cart', 'woocommerce_output_all_notices', 10 ); +add_action( 'woocommerce_before_checkout_form', 'woocommerce_output_all_notices', 10 ); +add_action( 'woocommerce_account_content', 'woocommerce_output_all_notices', 10 ); +add_action( 'woocommerce_before_customer_login_form', 'woocommerce_output_all_notices', 10 ); diff --git a/includes/wc-term-functions.php b/includes/wc-term-functions.php index 461c6342fae..f51640cf817 100644 --- a/includes/wc-term-functions.php +++ b/includes/wc-term-functions.php @@ -4,15 +4,11 @@ * * Functions for handling terms/term meta. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.1.0 + * @package WooCommerce/Functions + * @version 2.1.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; /** * Helper to get cached object terms and filter by field using wp_list_pluck(). @@ -29,15 +25,11 @@ function wc_get_object_terms( $object_id, $taxonomy, $field = null, $index_key = // Test if terms exists. get_the_terms() return false when it finds no terms. $terms = get_the_terms( $object_id, $taxonomy ); - if ( $terms && ! is_wp_error( $terms ) ) { - if ( ! is_null( $field ) ) { - $terms = wp_list_pluck( $terms, $field, $index_key ); - } - } else { - $terms = array(); + if ( ! $terms || is_wp_error( $terms ) ) { + return array(); } - return $terms; + return is_null( $field ) ? $terms : wp_list_pluck( $terms, $field, $index_key ); } /** @@ -51,18 +43,17 @@ function wc_get_object_terms( $object_id, $taxonomy, $field = null, $index_key = * @return array */ function _wc_get_cached_product_terms( $product_id, $taxonomy, $args = array() ) { - $cache_key = 'wc_' . $taxonomy . md5( json_encode( $args ) ); - $terms = wp_cache_get( $product_id, $cache_key ); + $cache_key = 'wc_' . $taxonomy . md5( wp_json_encode( $args ) ); + $cache_group = WC_Cache_Helper::get_cache_prefix( 'product_' . $product_id ) . $product_id; + $terms = wp_cache_get( $cache_key, $cache_group ); if ( false !== $terms ) { return $terms; } - // @codingStandardsIgnoreStart $terms = wp_get_post_terms( $product_id, $taxonomy, $args ); - // @codingStandardsIgnoreEnd - wp_cache_add( $product_id, $terms, $cache_key ); + wp_cache_add( $cache_key, $terms, $cache_group ); return $terms; } @@ -88,7 +79,7 @@ function wc_get_product_terms( $product_id, $taxonomy, $args = array() ) { } // Support ordering by parent. - if ( ! empty( $args['orderby'] ) && in_array( $args['orderby'], array( 'name_num', 'parent' ) ) ) { + if ( ! empty( $args['orderby'] ) && in_array( $args['orderby'], array( 'name_num', 'parent' ), true ) ) { $fields = isset( $args['fields'] ) ? $args['fields'] : 'all'; $orderby = $args['orderby']; @@ -99,22 +90,22 @@ function wc_get_product_terms( $product_id, $taxonomy, $args = array() ) { $terms = _wc_get_cached_product_terms( $product_id, $taxonomy, $args ); switch ( $orderby ) { - case 'name_num' : + case 'name_num': usort( $terms, '_wc_get_product_terms_name_num_usort_callback' ); - break; - case 'parent' : + break; + case 'parent': usort( $terms, '_wc_get_product_terms_parent_usort_callback' ); - break; + break; } switch ( $fields ) { - case 'names' : + case 'names': $terms = wp_list_pluck( $terms, 'name' ); break; - case 'ids' : + case 'ids': $terms = wp_list_pluck( $terms, 'term_id' ); break; - case 'slugs' : + case 'slugs': $terms = wp_list_pluck( $terms, 'slug' ); break; } @@ -134,20 +125,21 @@ function wc_get_product_terms( $product_id, $taxonomy, $args = array() ) { $args['fields'] = isset( $args['fields'] ) ? $args['fields'] : 'names'; // Ensure slugs is valid for get_terms - slugs isn't supported. - $args['fields'] = ( 'slugs' === $args['fields'] ) ? 'id=>slug' : $args['fields']; - $terms = get_terms( $taxonomy, $args ); + $args['fields'] = ( 'slugs' === $args['fields'] ) ? 'id=>slug' : $args['fields']; + $terms = get_terms( $taxonomy, $args ); } } else { $terms = _wc_get_cached_product_terms( $product_id, $taxonomy, $args ); } - return apply_filters( 'woocommerce_get_product_terms' , $terms, $product_id, $taxonomy, $args ); + return apply_filters( 'woocommerce_get_product_terms', $terms, $product_id, $taxonomy, $args ); } /** * Sort by name (numeric). - * @param WP_POST object $a - * @param WP_POST object $b + * + * @param WP_Post $a First item to compare. + * @param WP_Post $b Second item to compare. * @return int */ function _wc_get_product_terms_name_num_usort_callback( $a, $b ) { @@ -163,8 +155,9 @@ function _wc_get_product_terms_name_num_usort_callback( $a, $b ) { /** * Sort by parent. - * @param WP_POST object $a - * @param WP_POST object $b + * + * @param WP_Post $a First item to compare. + * @param WP_Post $b Second item to compare. * @return int */ function _wc_get_product_terms_parent_usort_callback( $a, $b ) { @@ -177,67 +170,42 @@ function _wc_get_product_terms_parent_usort_callback( $a, $b ) { /** * WooCommerce Dropdown categories. * - * Stuck with this until a fix for https://core.trac.wordpress.org/ticket/13258. - * We use a custom walker, just like WordPress does. - * - * @param array $args - * @param int $deprecated_hierarchical - * @param int $deprecated_show_uncategorized (default: 1) - * @param string $deprecated_orderby - * - * @return string + * @param array $args Args to control display of dropdown. */ -function wc_product_dropdown_categories( $args = array(), $deprecated_hierarchical = 1, $deprecated_show_uncategorized = 1, $deprecated_orderby = '' ) { +function wc_product_dropdown_categories( $args = array() ) { global $wp_query; - if ( ! is_array( $args ) ) { - wc_deprecated_argument( 'wc_product_dropdown_categories()', '2.1', 'show_counts, hierarchical, show_uncategorized and orderby arguments are invalid - pass a single array of values instead.' ); - - $args['show_count'] = $args; - $args['hierarchical'] = $deprecated_hierarchical; - $args['show_uncategorized'] = $deprecated_show_uncategorized; - $args['orderby'] = $deprecated_orderby; - } - - $current_product_cat = isset( $wp_query->query_vars['product_cat'] ) ? $wp_query->query_vars['product_cat'] : ''; - $defaults = array( - 'pad_counts' => 1, - 'show_count' => 1, - 'hierarchical' => 1, - 'hide_empty' => 1, - 'show_uncategorized' => 1, - 'orderby' => 'name', - 'selected' => $current_product_cat, - 'menu_order' => false, - 'option_select_text' => __( 'Select a category', 'woocommerce' ), + $args = wp_parse_args( + $args, array( + 'pad_counts' => 1, + 'show_count' => 1, + 'hierarchical' => 1, + 'hide_empty' => 1, + 'show_uncategorized' => 1, + 'orderby' => 'name', + 'selected' => isset( $wp_query->query_vars['product_cat'] ) ? $wp_query->query_vars['product_cat'] : '', + 'menu_order' => false, + 'show_option_none' => __( 'Select a category', 'woocommerce' ), + 'option_none_value' => '', + 'value_field' => 'slug', + 'taxonomy' => 'product_cat', + 'name' => 'product_cat', + 'class' => 'dropdown_product_cat', + ) ); - $args = wp_parse_args( $args, $defaults ); - if ( 'order' === $args['orderby'] ) { $args['menu_order'] = 'asc'; $args['orderby'] = 'name'; } - $terms = get_terms( 'product_cat', apply_filters( 'wc_product_dropdown_categories_get_terms_args', $args ) ); - - if ( empty( $terms ) ) { - return; - } - - $output = ""; - - echo $output; + wp_dropdown_categories( $args ); } /** - * Walk the Product Categories. + * Custom walker for Product Categories. + * + * Previously used by wc_product_dropdown_categories, but wp_dropdown_categories has been fixed in core. * * @return mixed */ @@ -245,12 +213,12 @@ function wc_walk_category_dropdown_tree() { $args = func_get_args(); if ( ! class_exists( 'WC_Product_Cat_Dropdown_Walker', false ) ) { - include_once( WC()->plugin_path() . '/includes/walkers/class-product-cat-dropdown-walker.php' ); + include_once WC()->plugin_path() . '/includes/walkers/class-wc-product-cat-dropdown-walker.php'; } - // the user's options are the third parameter + // The user's options are the third parameter. if ( empty( $args[2]['walker'] ) || ! is_a( $args[2]['walker'], 'Walker' ) ) { - $walker = new WC_Product_Cat_Dropdown_Walker; + $walker = new WC_Product_Cat_Dropdown_Walker(); } else { $walker = $args[2]['walker']; } @@ -260,10 +228,11 @@ function wc_walk_category_dropdown_tree() { /** * When a term is split, ensure meta data maintained. - * @param int $old_term_id - * @param int $new_term_id - * @param string $term_taxonomy_id - * @param string $taxonomy + * + * @param int $old_term_id Old term ID. + * @param int $new_term_id New term ID. + * @param string $term_taxonomy_id Term taxonomy ID. + * @param string $taxonomy Taxonomy. */ function wc_taxonomy_metadata_update_content_for_split_terms( $old_term_id, $new_term_id, $term_taxonomy_id, $taxonomy ) { global $wpdb; @@ -272,15 +241,15 @@ function wc_taxonomy_metadata_update_content_for_split_terms( $old_term_id, $new if ( 'product_cat' === $taxonomy || taxonomy_is_product_attribute( $taxonomy ) ) { $old_meta_data = $wpdb->get_results( $wpdb->prepare( "SELECT meta_key, meta_value FROM {$wpdb->prefix}woocommerce_termmeta WHERE woocommerce_term_id = %d;", $old_term_id ) ); - // Copy across to split term + // Copy across to split term. if ( $old_meta_data ) { foreach ( $old_meta_data as $meta_data ) { $wpdb->insert( "{$wpdb->prefix}woocommerce_termmeta", array( 'woocommerce_term_id' => $new_term_id, - 'meta_key' => $meta_data->meta_key, - 'meta_value' => $meta_data->meta_value, + 'meta_key' => $meta_data->meta_key, // WPCS: slow query ok. + 'meta_value' => $meta_data->meta_value, // WPCS: slow query ok. ) ); } @@ -291,13 +260,13 @@ function wc_taxonomy_metadata_update_content_for_split_terms( $old_term_id, $new add_action( 'split_shared_term', 'wc_taxonomy_metadata_update_content_for_split_terms', 10, 4 ); /** - * Migrate data from WC term meta to WP term meta + * Migrate data from WC term meta to WP term meta. * * When the database is updated to support term meta, migrate WC term meta data across. * We do this when the new version is >= 34370, and the old version is < 34370 (34370 is when term meta table was added). * - * @param string $wp_db_version The new $wp_db_version. - * @param string $wp_current_db_version The old (current) $wp_db_version. + * @param string $wp_db_version The new $wp_db_version. + * @param string $wp_current_db_version The old (current) $wp_db_version. */ function wc_taxonomy_metadata_migrate_data( $wp_db_version, $wp_current_db_version ) { if ( $wp_db_version >= 34370 && $wp_current_db_version < 34370 ) { @@ -310,15 +279,15 @@ function wc_taxonomy_metadata_migrate_data( $wp_db_version, $wp_current_db_versi add_action( 'wp_upgrade', 'wc_taxonomy_metadata_migrate_data', 10, 2 ); /** - * WooCommerce Term Meta API + * WooCommerce Term Meta API. * * WC tables for storing term meta are @deprecated from WordPress 4.4 since 4.4 has its own table. * This function serves as a wrapper, using the new table if present, or falling back to the WC table. * - * @param mixed $term_id - * @param string $meta_key - * @param mixed $meta_value - * @param string $prev_value (default: '') + * @param int $term_id Term ID. + * @param string $meta_key Meta key. + * @param mixed $meta_value Meta value. + * @param string $prev_value Previous value. (default: ''). * @return bool */ function update_woocommerce_term_meta( $term_id, $meta_key, $meta_value, $prev_value = '' ) { @@ -326,15 +295,15 @@ function update_woocommerce_term_meta( $term_id, $meta_key, $meta_value, $prev_v } /** - * WooCommerce Term Meta API + * WooCommerce Term Meta API. * * WC tables for storing term meta are @deprecated from WordPress 4.4 since 4.4 has its own table. * This function serves as a wrapper, using the new table if present, or falling back to the WC table. * - * @param mixed $term_id - * @param mixed $meta_key - * @param mixed $meta_value - * @param bool $unique (default: false) + * @param int $term_id Term ID. + * @param string $meta_key Meta key. + * @param mixed $meta_value Meta value. + * @param bool $unique Make meta key unique. (default: false). * @return bool */ function add_woocommerce_term_meta( $term_id, $meta_key, $meta_value, $unique = false ) { @@ -347,10 +316,10 @@ function add_woocommerce_term_meta( $term_id, $meta_key, $meta_value, $unique = * WC tables for storing term meta are @deprecated from WordPress 4.4 since 4.4 has its own table. * This function serves as a wrapper, using the new table if present, or falling back to the WC table. * - * @param mixed $term_id - * @param string $meta_key - * @param string $meta_value (default: '') - * @param bool $deprecated (default: false) + * @param int $term_id Term ID. + * @param string $meta_key Meta key. + * @param string $meta_value Meta value (default: ''). + * @param bool $deprecated Deprecated param (default: false). * @return bool */ function delete_woocommerce_term_meta( $term_id, $meta_key, $meta_value = '', $deprecated = false ) { @@ -363,9 +332,9 @@ function delete_woocommerce_term_meta( $term_id, $meta_key, $meta_value = '', $d * WC tables for storing term meta are @deprecated from WordPress 4.4 since 4.4 has its own table. * This function serves as a wrapper, using the new table if present, or falling back to the WC table. * - * @param mixed $term_id - * @param string $key - * @param bool $single (default: true) + * @param int $term_id Term ID. + * @param string $key Meta key. + * @param bool $single Whether to return a single value. (default: true). * @return mixed */ function get_woocommerce_term_meta( $term_id, $key, $single = true ) { @@ -373,13 +342,13 @@ function get_woocommerce_term_meta( $term_id, $key, $single = true ) { } /** - * Move a term before the a given element of its hierarchy level. + * Move a term before the a given element of its hierarchy level. * - * @param int $the_term - * @param int $next_id the id of the next sibling element in save hierarchy level - * @param string $taxonomy - * @param int $index (default: 0) - * @param mixed $terms (default: null) + * @param int $the_term Term ID. + * @param int $next_id The id of the next sibling element in save hierarchy level. + * @param string $taxonomy Taxnomy. + * @param int $index Term index (default: 0). + * @param mixed $terms List of terms. (default: null). * @return int */ function wc_reorder_terms( $the_term, $next_id, $taxonomy, $index = 0, $terms = null ) { @@ -390,39 +359,40 @@ function wc_reorder_terms( $the_term, $next_id, $taxonomy, $index = 0, $terms = return $index; } - $id = $the_term->term_id; + $id = intval( $the_term->term_id ); - $term_in_level = false; // flag: is our term to order in this level of terms + $term_in_level = false; // Flag: is our term to order in this level of terms. foreach ( $terms as $term ) { + $term_id = intval( $term->term_id ); - if ( $term->term_id == $id ) { // our term to order, we skip + if ( $term_id === $id ) { // Our term to order, we skip. $term_in_level = true; - continue; // our term to order, we skip + continue; // Our term to order, we skip. } - // the nextid of our term to order, lets move our term here - if ( null !== $next_id && $term->term_id == $next_id ) { + // the nextid of our term to order, lets move our term here. + if ( null !== $next_id && $term_id === $next_id ) { $index++; $index = wc_set_term_order( $id, $index, $taxonomy, true ); } - // set order + // Set order. $index++; - $index = wc_set_term_order( $term->term_id, $index, $taxonomy ); + $index = wc_set_term_order( $term_id, $index, $taxonomy ); /** * After a term has had it's order set. */ do_action( 'woocommerce_after_set_term_order', $term, $index, $taxonomy ); - // if that term has children we walk through them - $children = get_terms( $taxonomy, "parent={$term->term_id}&menu_order=ASC&hide_empty=0" ); + // If that term has children we walk through them. + $children = get_terms( $taxonomy, "parent={$term_id}&menu_order=ASC&hide_empty=0" ); if ( ! empty( $children ) ) { $index = wc_reorder_terms( $the_term, $next_id, $taxonomy, $index, $children ); } } - // no nextid meaning our term is in last position + // No nextid meaning our term is in last position. if ( $term_in_level && null === $next_id ) { $index = wc_set_term_order( $id, $index + 1, $taxonomy, true ); } @@ -433,18 +403,18 @@ function wc_reorder_terms( $the_term, $next_id, $taxonomy, $index = 0, $terms = /** * Set the sort order of a term. * - * @param int $term_id - * @param int $index - * @param string $taxonomy - * @param bool $recursive (default: false) + * @param int $term_id Term ID. + * @param int $index Index. + * @param string $taxonomy Taxonomy. + * @param bool $recursive Recursive (default: false). * @return int */ function wc_set_term_order( $term_id, $index, $taxonomy, $recursive = false ) { - $term_id = (int) $term_id; - $index = (int) $index; + $term_id = (int) $term_id; + $index = (int) $index; - // Meta name + // Meta name. if ( taxonomy_is_product_attribute( $taxonomy ) ) { $meta_name = 'order_' . esc_attr( $taxonomy ); } else { @@ -477,9 +447,9 @@ function wc_set_term_order( $term_id, $index, $taxonomy, $recursive = false ) { * * To disable it, set it ot false (or 0). * - * @param array $clauses - * @param array $taxonomies - * @param array $args + * @param array $clauses Clauses. + * @param array $taxonomies Taxonomies. + * @param array $args Arguments. * @return array */ function wc_terms_clauses( $clauses, $taxonomies, $args ) { @@ -496,11 +466,11 @@ function wc_terms_clauses( $clauses, $taxonomies, $args ) { } // No sorting in admin when sorting by a column. - if ( is_admin() && isset( $_GET['orderby'] ) ) { + if ( is_admin() && isset( $_GET['orderby'] ) ) { // WPCS: input var ok, CSRF ok. return $clauses; } - // No need to filter counts + // No need to filter counts. if ( strpos( 'COUNT(*)', $clauses['fields'] ) !== false ) { return $clauses; } @@ -509,7 +479,13 @@ function wc_terms_clauses( $clauses, $taxonomies, $args ) { $found = false; foreach ( (array) $taxonomies as $taxonomy ) { - if ( taxonomy_is_product_attribute( $taxonomy ) || in_array( $taxonomy, apply_filters( 'woocommerce_sortable_taxonomies', array( 'product_cat' ) ) ) ) { + if ( taxonomy_is_product_attribute( $taxonomy ) || in_array( $taxonomy, apply_filters( 'woocommerce_sortable_taxonomies', array( 'product_cat' ) ), true ) ) { + + // Don't modify the orderby when we're ordering attributes by name. + if ( taxonomy_is_product_attribute( $taxonomy ) && 'name' === wc_attribute_orderby( $taxonomy ) ) { + return $clauses; + } + $found = true; break; } @@ -537,11 +513,11 @@ function wc_terms_clauses( $clauses, $taxonomies, $args ) { } // Default to ASC. - if ( ! isset( $args['menu_order'] ) || ! in_array( strtoupper( $args['menu_order'] ), array( 'ASC', 'DESC' ) ) ) { + if ( ! isset( $args['menu_order'] ) || ! in_array( strtoupper( $args['menu_order'] ), array( 'ASC', 'DESC' ), true ) ) { $args['menu_order'] = 'ASC'; } - $order = "ORDER BY tm.meta_value+0 " . $args['menu_order']; + $order = 'ORDER BY tm.meta_value+0 ' . $args['menu_order']; if ( $clauses['orderby'] ) { $clauses['orderby'] = str_replace( 'ORDER BY', $order . ',', $clauses['orderby'] ); @@ -564,10 +540,10 @@ add_filter( 'terms_clauses', 'wc_terms_clauses', 99, 3 ); /** * Function for recounting product terms, ignoring hidden products. * - * @param array $terms - * @param string $taxonomy - * @param bool $callback - * @param bool $terms_are_term_taxonomy_ids + * @param array $terms List of terms. + * @param string $taxonomy Taxonomy. + * @param bool $callback Callback. + * @param bool $terms_are_term_taxonomy_ids If terms are from term_taxonomy_id column. */ function _wc_term_recount( $terms, $taxonomy, $callback = true, $terms_are_term_taxonomy_ids = true ) { global $wpdb; @@ -602,8 +578,8 @@ function _wc_term_recount( $terms, $taxonomy, $callback = true, $terms_are_term_ ); if ( count( $exclude_term_ids ) ) { - $query['join'] .= " LEFT JOIN ( SELECT object_id FROM {$wpdb->term_relationships} WHERE term_taxonomy_id IN ( " . implode( ',', array_map( 'absint', $exclude_term_ids ) ) . " ) ) AS exclude_join ON exclude_join.object_id = p.ID"; - $query['where'] .= " AND exclude_join.object_id IS NULL"; + $query['join'] .= " LEFT JOIN ( SELECT object_id FROM {$wpdb->term_relationships} WHERE term_taxonomy_id IN ( " . implode( ',', array_map( 'absint', $exclude_term_ids ) ) . ' ) ) AS exclude_join ON exclude_join.object_id = p.ID'; + $query['where'] .= ' AND exclude_join.object_id IS NULL'; } // Pre-process term taxonomy ids. @@ -640,20 +616,22 @@ function _wc_term_recount( $terms, $taxonomy, $callback = true, $terms_are_term_ $terms_to_count = array( absint( $term_id ) ); if ( is_taxonomy_hierarchical( $taxonomy->name ) ) { - // We need to get the $term's hierarchy so we can count its children too - if ( ( $children = get_term_children( $term_id, $taxonomy->name ) ) && ! is_wp_error( $children ) ) { + // We need to get the $term's hierarchy so we can count its children too. + $children = get_term_children( $term_id, $taxonomy->name ); + + if ( $children && ! is_wp_error( $children ) ) { $terms_to_count = array_unique( array_map( 'absint', array_merge( $terms_to_count, $children ) ) ); } } - // Generate term query + // Generate term query. $term_query = $query; - $term_query['join'] .= " INNER JOIN ( SELECT object_id FROM {$wpdb->term_relationships} INNER JOIN {$wpdb->term_taxonomy} using( term_taxonomy_id ) WHERE term_id IN ( " . implode( ',', array_map( 'absint', $terms_to_count ) ) . " ) ) AS include_join ON include_join.object_id = p.ID"; + $term_query['join'] .= " INNER JOIN ( SELECT object_id FROM {$wpdb->term_relationships} INNER JOIN {$wpdb->term_taxonomy} using( term_taxonomy_id ) WHERE term_id IN ( " . implode( ',', array_map( 'absint', $terms_to_count ) ) . ' ) ) AS include_join ON include_join.object_id = p.ID'; - // Get the count - $count = $wpdb->get_var( implode( ' ', $term_query ) ); + // Get the count. + $count = $wpdb->get_var( implode( ' ', $term_query ) ); // WPCS: unprepared SQL ok. - // Update the count + // Update the count. update_woocommerce_term_meta( $term_id, 'product_count_' . $taxonomy->name, absint( $count ) ); } @@ -663,7 +641,7 @@ function _wc_term_recount( $terms, $taxonomy, $callback = true, $terms_are_term_ /** * Recount terms after the stock amount changes. * - * @param int $product_id + * @param int $product_id Product ID. */ function wc_recount_after_stock_change( $product_id ) { if ( 'yes' !== get_option( 'woocommerce_hide_out_of_stock_items' ) ) { @@ -701,8 +679,8 @@ add_action( 'woocommerce_product_set_stock_status', 'wc_recount_after_stock_chan * Overrides the original term count for product categories and tags with the product count. * that takes catalog visibility into account. * - * @param array $terms - * @param string|array $taxonomies + * @param array $terms List of terms. + * @param string|array $taxonomies Single taxonomy or list of taxonomies. * @return array */ function wc_change_term_counts( $terms, $taxonomies ) { @@ -710,15 +688,16 @@ function wc_change_term_counts( $terms, $taxonomies ) { return $terms; } - if ( ! isset( $taxonomies[0] ) || ! in_array( $taxonomies[0], apply_filters( 'woocommerce_change_term_counts', array( 'product_cat', 'product_tag' ) ) ) ) { + if ( ! isset( $taxonomies[0] ) || ! in_array( $taxonomies[0], apply_filters( 'woocommerce_change_term_counts', array( 'product_cat', 'product_tag' ) ), true ) ) { return $terms; } - $term_counts = $o_term_counts = get_transient( 'wc_term_counts' ); + $o_term_counts = get_transient( 'wc_term_counts' ); + $term_counts = $o_term_counts; foreach ( $terms as &$term ) { if ( is_object( $term ) ) { - $term_counts[ $term->term_id ] = isset( $term_counts[ $term->term_id ] ) ? $term_counts[ $term->term_id ] : get_woocommerce_term_meta( $term->term_id, 'product_count_' . $taxonomies[0] , true ); + $term_counts[ $term->term_id ] = isset( $term_counts[ $term->term_id ] ) ? $term_counts[ $term->term_id ] : get_woocommerce_term_meta( $term->term_id, 'product_count_' . $taxonomies[0], true ); if ( '' !== $term_counts[ $term->term_id ] ) { $term->count = absint( $term_counts[ $term->term_id ] ); @@ -726,8 +705,8 @@ function wc_change_term_counts( $terms, $taxonomies ) { } } - // Update transient - if ( $term_counts != $o_term_counts ) { + // Update transient. + if ( $term_counts !== $o_term_counts ) { set_transient( 'wc_term_counts', $term_counts, DAY_IN_SECONDS * 30 ); } @@ -740,8 +719,8 @@ add_filter( 'get_terms', 'wc_change_term_counts', 10, 2 ); * * To keep in sync, product_count will be cleared on "set_object_terms". * - * @param int $term_id - * @param string $taxonomy + * @param int $term_id Term ID. + * @param string $taxonomy Taxonomy. * @return array */ function wc_get_term_product_ids( $term_id, $taxonomy ) { @@ -757,6 +736,7 @@ function wc_get_term_product_ids( $term_id, $taxonomy ) { /** * When a post is updated and terms recounted (called by _update_post_term_count), clear the ids. + * * @param int $object_id Object ID. * @param array $terms An array of object terms. * @param array $tt_ids An array of term taxonomy IDs. @@ -785,25 +765,29 @@ function wc_get_product_visibility_term_ids() { wc_doing_it_wrong( __FUNCTION__, 'wc_get_product_visibility_term_ids should not be called before taxonomies are registered (woocommerce_after_register_post_type action).', '3.1' ); return array(); } - return array_map( 'absint', wp_parse_args( - wp_list_pluck( - get_terms( array( - 'taxonomy' => 'product_visibility', - 'hide_empty' => false, - ) ), - 'term_taxonomy_id', - 'name' - ), - array( - 'exclude-from-catalog' => 0, - 'exclude-from-search' => 0, - 'featured' => 0, - 'outofstock' => 0, - 'rated-1' => 0, - 'rated-2' => 0, - 'rated-3' => 0, - 'rated-4' => 0, - 'rated-5' => 0, + return array_map( + 'absint', wp_parse_args( + wp_list_pluck( + get_terms( + array( + 'taxonomy' => 'product_visibility', + 'hide_empty' => false, + ) + ), + 'term_taxonomy_id', + 'name' + ), + array( + 'exclude-from-catalog' => 0, + 'exclude-from-search' => 0, + 'featured' => 0, + 'outofstock' => 0, + 'rated-1' => 0, + 'rated-2' => 0, + 'rated-3' => 0, + 'rated-4' => 0, + 'rated-5' => 0, + ) ) - ) ); + ); } diff --git a/includes/wc-update-functions.php b/includes/wc-update-functions.php index 6cdef46a8b3..f6e6fa2bfe7 100644 --- a/includes/wc-update-functions.php +++ b/includes/wc-update-functions.php @@ -4,20 +4,21 @@ * * Functions for updating data, used by the background updater. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.6.0 + * @package WooCommerce/Functions + * @version 3.3.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; +/** + * Update file paths for 2.0 + * + * @return void + */ function wc_update_200_file_paths() { global $wpdb; - // Upgrade old style files paths to support multiple file paths + // Upgrade old style files paths to support multiple file paths. $existing_file_paths = $wpdb->get_results( "SELECT meta_value, meta_id, post_id FROM {$wpdb->postmeta} WHERE meta_key = '_file_path' AND meta_value != '';" ); if ( $existing_file_paths ) { @@ -38,23 +39,29 @@ function wc_update_200_file_paths() { } } +/** + * Update permalinks for 2.0 + * + * @return void + */ function wc_update_200_permalinks() { - // Setup default permalinks if shop page is defined - $permalinks = get_option( 'woocommerce_permalinks' ); - $shop_page_id = wc_get_page_id( 'shop' ); + // Setup default permalinks if shop page is defined. + $permalinks = get_option( 'woocommerce_permalinks' ); + $shop_page_id = wc_get_page_id( 'shop' ); if ( empty( $permalinks ) && $shop_page_id > 0 ) { - $base_slug = $shop_page_id > 0 && get_post( $shop_page_id ) ? get_page_uri( $shop_page_id ) : 'shop'; + $base_slug = $shop_page_id > 0 && get_post( $shop_page_id ) ? get_page_uri( $shop_page_id ) : 'shop'; - $category_base = get_option( 'woocommerce_prepend_shop_page_to_urls' ) == "yes" ? trailingslashit( $base_slug ) : ''; - $category_slug = get_option( 'woocommerce_product_category_slug' ) ? get_option( 'woocommerce_product_category_slug' ) : _x( 'product-category', 'slug', 'woocommerce' ); - $tag_slug = get_option( 'woocommerce_product_tag_slug' ) ? get_option( 'woocommerce_product_tag_slug' ) : _x( 'product-tag', 'slug', 'woocommerce' ); + $category_base = get_option( 'woocommerce_prepend_shop_page_to_urls' ) == 'yes' ? trailingslashit( $base_slug ) : ''; + $category_slug = get_option( 'woocommerce_product_category_slug' ) ? get_option( 'woocommerce_product_category_slug' ) : _x( 'product-category', 'slug', 'woocommerce' ); + $tag_slug = get_option( 'woocommerce_product_tag_slug' ) ? get_option( 'woocommerce_product_tag_slug' ) : _x( 'product-tag', 'slug', 'woocommerce' ); if ( 'yes' == get_option( 'woocommerce_prepend_shop_page_to_products' ) ) { $product_base = trailingslashit( $base_slug ); } else { - if ( ( $product_slug = get_option( 'woocommerce_product_slug' ) ) !== false && ! empty( $product_slug ) ) { + $product_slug = get_option( 'woocommerce_product_slug' ); + if ( false !== $product_slug && ! empty( $product_slug ) ) { $product_base = trailingslashit( $product_slug ); } else { $product_base = trailingslashit( _x( 'product', 'slug', 'woocommerce' ) ); @@ -66,18 +73,23 @@ function wc_update_200_permalinks() { } $permalinks = array( - 'product_base' => untrailingslashit( $product_base ), - 'category_base' => untrailingslashit( $category_base . $category_slug ), - 'attribute_base' => untrailingslashit( $category_base ), - 'tag_base' => untrailingslashit( $category_base . $tag_slug ), + 'product_base' => untrailingslashit( $product_base ), + 'category_base' => untrailingslashit( $category_base . $category_slug ), + 'attribute_base' => untrailingslashit( $category_base ), + 'tag_base' => untrailingslashit( $category_base . $tag_slug ), ); update_option( 'woocommerce_permalinks', $permalinks ); } } +/** + * Update sub-category display options for 2.0 + * + * @return void + */ function wc_update_200_subcat_display() { - // Update subcat display settings + // Update subcat display settings. if ( get_option( 'woocommerce_shop_show_subcategories' ) == 'yes' ) { if ( get_option( 'woocommerce_hide_products_when_showing_subcategories' ) == 'yes' ) { update_option( 'woocommerce_shop_page_display', 'subcategories' ); @@ -95,11 +107,16 @@ function wc_update_200_subcat_display() { } } +/** + * Update tax rates for 2.0 + * + * @return void + */ function wc_update_200_taxrates() { global $wpdb; - // Update tax rates - $loop = 0; + // Update tax rates. + $loop = 0; $tax_rates = get_option( 'woocommerce_tax_rates' ); if ( $tax_rates ) { @@ -116,7 +133,7 @@ function wc_update_200_taxrates() { } $wpdb->insert( - $wpdb->prefix . "woocommerce_tax_rates", + $wpdb->prefix . 'woocommerce_tax_rates', array( 'tax_rate_country' => $country, 'tax_rate_state' => $state, @@ -148,7 +165,7 @@ function wc_update_200_taxrates() { } $wpdb->insert( - $wpdb->prefix . "woocommerce_tax_rates", + $wpdb->prefix . 'woocommerce_tax_rates', array( 'tax_rate_country' => $tax_rate['country'], 'tax_rate_state' => $tax_rate['state'], @@ -168,7 +185,7 @@ function wc_update_200_taxrates() { foreach ( $tax_rate['locations'] as $location ) { $wpdb->insert( - $wpdb->prefix . "woocommerce_tax_rate_locations", + $wpdb->prefix . 'woocommerce_tax_rate_locations', array( 'location_code' => $location, 'tax_rate_id' => $tax_rate_id, @@ -189,15 +206,19 @@ function wc_update_200_taxrates() { delete_option( 'woocommerce_local_tax_rates' ); } +/** + * Update order item line items for 2.0 + * + * @return void + */ function wc_update_200_line_items() { global $wpdb; - // Now its time for the massive update to line items - move them to the new DB tables - // Reverse with UPDATE `wpwc_postmeta` SET meta_key = '_order_items' WHERE meta_key = '_order_items_old' - $order_item_rows = $wpdb->get_results( " - SELECT meta_value, post_id FROM {$wpdb->postmeta} - WHERE meta_key = '_order_items' - " ); + // Now its time for the massive update to line items - move them to the new DB tables. + // Reverse with UPDATE `wpwc_postmeta` SET meta_key = '_order_items' WHERE meta_key = '_order_items_old'. + $order_item_rows = $wpdb->get_results( + "SELECT meta_value, post_id FROM {$wpdb->postmeta} WHERE meta_key = '_order_items'" + ); foreach ( $order_item_rows as $order_item_row ) { @@ -206,39 +227,42 @@ function wc_update_200_line_items() { foreach ( $order_items as $order_item ) { if ( ! isset( $order_item['line_total'] ) && isset( $order_item['taxrate'] ) && isset( $order_item['cost'] ) ) { - $order_item['line_tax'] = number_format( ( $order_item['cost'] * $order_item['qty'] ) * ( $order_item['taxrate'] / 100 ), 2, '.', '' ); - $order_item['line_total'] = $order_item['cost'] * $order_item['qty']; - $order_item['line_subtotal_tax'] = $order_item['line_tax']; - $order_item['line_subtotal'] = $order_item['line_total']; + $order_item['line_tax'] = number_format( ( $order_item['cost'] * $order_item['qty'] ) * ( $order_item['taxrate'] / 100 ), 2, '.', '' ); + $order_item['line_total'] = $order_item['cost'] * $order_item['qty']; + $order_item['line_subtotal_tax'] = $order_item['line_tax']; + $order_item['line_subtotal'] = $order_item['line_total']; } - $order_item['line_tax'] = isset( $order_item['line_tax'] ) ? $order_item['line_tax'] : 0; - $order_item['line_total'] = isset( $order_item['line_total'] ) ? $order_item['line_total'] : 0; - $order_item['line_subtotal_tax'] = isset( $order_item['line_subtotal_tax'] ) ? $order_item['line_subtotal_tax'] : 0; - $order_item['line_subtotal'] = isset( $order_item['line_subtotal'] ) ? $order_item['line_subtotal'] : 0; + $order_item['line_tax'] = isset( $order_item['line_tax'] ) ? $order_item['line_tax'] : 0; + $order_item['line_total'] = isset( $order_item['line_total'] ) ? $order_item['line_total'] : 0; + $order_item['line_subtotal_tax'] = isset( $order_item['line_subtotal_tax'] ) ? $order_item['line_subtotal_tax'] : 0; + $order_item['line_subtotal'] = isset( $order_item['line_subtotal'] ) ? $order_item['line_subtotal'] : 0; - $item_id = wc_add_order_item( $order_item_row->post_id, array( - 'order_item_name' => $order_item['name'], - 'order_item_type' => 'line_item', - ) ); + $item_id = wc_add_order_item( + $order_item_row->post_id, + array( + 'order_item_name' => $order_item['name'], + 'order_item_type' => 'line_item', + ) + ); - // Add line item meta - if ( $item_id ) { - wc_add_order_item_meta( $item_id, '_qty', absint( $order_item['qty'] ) ); - wc_add_order_item_meta( $item_id, '_tax_class', $order_item['tax_class'] ); - wc_add_order_item_meta( $item_id, '_product_id', $order_item['id'] ); - wc_add_order_item_meta( $item_id, '_variation_id', $order_item['variation_id'] ); - wc_add_order_item_meta( $item_id, '_line_subtotal', wc_format_decimal( $order_item['line_subtotal'] ) ); - wc_add_order_item_meta( $item_id, '_line_subtotal_tax', wc_format_decimal( $order_item['line_subtotal_tax'] ) ); - wc_add_order_item_meta( $item_id, '_line_total', wc_format_decimal( $order_item['line_total'] ) ); - wc_add_order_item_meta( $item_id, '_line_tax', wc_format_decimal( $order_item['line_tax'] ) ); + // Add line item meta. + if ( $item_id ) { + wc_add_order_item_meta( $item_id, '_qty', absint( $order_item['qty'] ) ); + wc_add_order_item_meta( $item_id, '_tax_class', $order_item['tax_class'] ); + wc_add_order_item_meta( $item_id, '_product_id', $order_item['id'] ); + wc_add_order_item_meta( $item_id, '_variation_id', $order_item['variation_id'] ); + wc_add_order_item_meta( $item_id, '_line_subtotal', wc_format_decimal( $order_item['line_subtotal'] ) ); + wc_add_order_item_meta( $item_id, '_line_subtotal_tax', wc_format_decimal( $order_item['line_subtotal_tax'] ) ); + wc_add_order_item_meta( $item_id, '_line_total', wc_format_decimal( $order_item['line_total'] ) ); + wc_add_order_item_meta( $item_id, '_line_tax', wc_format_decimal( $order_item['line_tax'] ) ); - $meta_rows = array(); + $meta_rows = array(); - // Insert meta + // Insert meta. if ( ! empty( $order_item['item_meta'] ) ) { foreach ( $order_item['item_meta'] as $key => $meta ) { - // Backwards compatibility + // Backwards compatibility. if ( is_array( $meta ) && isset( $meta['meta_name'] ) ) { $meta_rows[] = '(' . $item_id . ',"' . esc_sql( $meta['meta_name'] ) . '","' . esc_sql( $meta['meta_value'] ) . '")'; } else { @@ -247,33 +271,39 @@ function wc_update_200_line_items() { } } - // Insert meta rows at once - if ( sizeof( $meta_rows ) > 0 ) { - $wpdb->query( $wpdb->prepare( " - INSERT INTO {$wpdb->prefix}woocommerce_order_itemmeta ( order_item_id, meta_key, meta_value ) - VALUES " . implode( ',', $meta_rows ) . "; - ", $order_item_row->post_id ) ); + // Insert meta rows at once. + if ( count( $meta_rows ) > 0 ) { + $wpdb->query( + $wpdb->prepare( + "INSERT INTO {$wpdb->prefix}woocommerce_order_itemmeta ( order_item_id, meta_key, meta_value ) + VALUES " . implode( ',', $meta_rows ) . ';', // @codingStandardsIgnoreLine + $order_item_row->post_id + ) + ); } - // Delete from DB (rename) - $wpdb->query( $wpdb->prepare( " - UPDATE {$wpdb->postmeta} - SET meta_key = '_order_items_old' - WHERE meta_key = '_order_items' - AND post_id = %d - ", $order_item_row->post_id ) ); - } + // Delete from DB (rename). + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->postmeta} + SET meta_key = '_order_items_old' + WHERE meta_key = '_order_items' + AND post_id = %d", + $order_item_row->post_id + ) + ); + } unset( $meta_rows, $item_id, $order_item ); } } - // Do the same kind of update for order_taxes - move to lines - // Reverse with UPDATE `wpwc_postmeta` SET meta_key = '_order_taxes' WHERE meta_key = '_order_taxes_old' - $order_tax_rows = $wpdb->get_results( " - SELECT meta_value, post_id FROM {$wpdb->postmeta} - WHERE meta_key = '_order_taxes' - " ); + // Do the same kind of update for order_taxes - move to lines. + // Reverse with UPDATE `wpwc_postmeta` SET meta_key = '_order_taxes' WHERE meta_key = '_order_taxes_old'. + $order_tax_rows = $wpdb->get_results( + "SELECT meta_value, post_id FROM {$wpdb->postmeta} + WHERE meta_key = '_order_taxes'" + ); foreach ( $order_tax_rows as $order_tax_row ) { @@ -286,25 +316,30 @@ function wc_update_200_line_items() { continue; } - $item_id = wc_add_order_item( $order_tax_row->post_id, array( - 'order_item_name' => $order_tax['label'], - 'order_item_type' => 'tax', - ) ); + $item_id = wc_add_order_item( + $order_tax_row->post_id, array( + 'order_item_name' => $order_tax['label'], + 'order_item_type' => 'tax', + ) + ); - // Add line item meta - if ( $item_id ) { - wc_add_order_item_meta( $item_id, 'compound', absint( isset( $order_tax['compound'] ) ? $order_tax['compound'] : 0 ) ); - wc_add_order_item_meta( $item_id, 'tax_amount', wc_clean( $order_tax['cart_tax'] ) ); - wc_add_order_item_meta( $item_id, 'shipping_tax_amount', wc_clean( $order_tax['shipping_tax'] ) ); + // Add line item meta. + if ( $item_id ) { + wc_add_order_item_meta( $item_id, 'compound', absint( isset( $order_tax['compound'] ) ? $order_tax['compound'] : 0 ) ); + wc_add_order_item_meta( $item_id, 'tax_amount', wc_clean( $order_tax['cart_tax'] ) ); + wc_add_order_item_meta( $item_id, 'shipping_tax_amount', wc_clean( $order_tax['shipping_tax'] ) ); } - // Delete from DB (rename) - $wpdb->query( $wpdb->prepare( " - UPDATE {$wpdb->postmeta} - SET meta_key = '_order_taxes_old' - WHERE meta_key = '_order_taxes' - AND post_id = %d - ", $order_tax_row->post_id ) ); + // Delete from DB (rename). + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->postmeta} + SET meta_key = '_order_taxes_old' + WHERE meta_key = '_order_taxes' + AND post_id = %d", + $order_tax_row->post_id + ) + ); unset( $tax_amount ); } @@ -312,16 +347,23 @@ function wc_update_200_line_items() { } } +/** + * Update image settings for 2.0 + * + * @return void + */ function wc_update_200_images() { // Grab the pre 2.0 Image options and use to populate the new image options settings, - // cleaning up afterwards like nice people do + // cleaning up afterwards like nice people do. foreach ( array( 'catalog', 'single', 'thumbnail' ) as $value ) { - $old_settings = array_filter( array( - 'width' => get_option( 'woocommerce_' . $value . '_image_width' ), - 'height' => get_option( 'woocommerce_' . $value . '_image_height' ), - 'crop' => get_option( 'woocommerce_' . $value . '_image_crop' ), - ) ); + $old_settings = array_filter( + array( + 'width' => get_option( 'woocommerce_' . $value . '_image_width' ), + 'height' => get_option( 'woocommerce_' . $value . '_image_height' ), + 'crop' => get_option( 'woocommerce_' . $value . '_image_crop' ), + ) + ); if ( ! empty( $old_settings ) && update_option( 'shop_' . $value . '_image_size', $old_settings ) ) { @@ -333,14 +375,24 @@ function wc_update_200_images() { } } +/** + * Update DB version for 2.0 + * + * @return void + */ function wc_update_200_db_version() { WC_Install::update_db_version( '2.0.0' ); } +/** + * Update Brazilian States for 2.0.9 + * + * @return void + */ function wc_update_209_brazillian_state() { global $wpdb; - // Update brazillian state codes + // Update brazillian state codes. $wpdb->update( $wpdb->postmeta, array( @@ -383,12 +435,22 @@ function wc_update_209_brazillian_state() { ); } +/** + * Update DB version for 2.0.9 + * + * @return void + */ function wc_update_209_db_version() { WC_Install::update_db_version( '2.0.9' ); } +/** + * Remove pages for 2.1 + * + * @return void + */ function wc_update_210_remove_pages() { - // Pages no longer used + // Pages no longer used. wp_trash_post( get_option( 'woocommerce_pay_page_id' ) ); wp_trash_post( get_option( 'woocommerce_thanks_page_id' ) ); wp_trash_post( get_option( 'woocommerce_view_order_page_id' ) ); @@ -397,10 +459,15 @@ function wc_update_210_remove_pages() { wp_trash_post( get_option( 'woocommerce_lost_password_page_id' ) ); } +/** + * Update file paths to support multiple files for 2.1 + * + * @return void + */ function wc_update_210_file_paths() { global $wpdb; - // Upgrade file paths to support multiple file paths + names etc + // Upgrade file paths to support multiple file paths + names etc. $existing_file_paths = $wpdb->get_results( "SELECT meta_value, meta_id FROM {$wpdb->postmeta} WHERE meta_key = '_file_paths' AND meta_value != '';" ); if ( $existing_file_paths ) { @@ -433,10 +500,20 @@ function wc_update_210_file_paths() { } } +/** + * Update DB version for 2.1 + * + * @return void + */ function wc_update_210_db_version() { WC_Install::update_db_version( '2.1.0' ); } +/** + * Update shipping options for 2.2 + * + * @return void + */ function wc_update_220_shipping() { $woocommerce_ship_to_destination = 'shipping'; @@ -449,10 +526,15 @@ function wc_update_220_shipping() { add_option( 'woocommerce_ship_to_destination', $woocommerce_ship_to_destination, '', 'no' ); } +/** + * Update order statuses for 2.2 + * + * @return void + */ function wc_update_220_order_status() { global $wpdb; - $wpdb->query( " - UPDATE {$wpdb->posts} as posts + $wpdb->query( + "UPDATE {$wpdb->posts} as posts LEFT JOIN {$wpdb->term_relationships} AS rel ON posts.ID = rel.object_id LEFT JOIN {$wpdb->term_taxonomy} AS tax USING( term_taxonomy_id ) LEFT JOIN {$wpdb->terms} AS term USING( term_id ) @@ -460,11 +542,10 @@ function wc_update_220_order_status() { WHERE posts.post_type = 'shop_order' AND posts.post_status = 'publish' AND tax.taxonomy = 'shop_order_status' - AND term.slug LIKE 'pending%'; - " + AND term.slug LIKE 'pending%';" ); - $wpdb->query( " - UPDATE {$wpdb->posts} as posts + $wpdb->query( + "UPDATE {$wpdb->posts} as posts LEFT JOIN {$wpdb->term_relationships} AS rel ON posts.ID = rel.object_id LEFT JOIN {$wpdb->term_taxonomy} AS tax USING( term_taxonomy_id ) LEFT JOIN {$wpdb->terms} AS term USING( term_id ) @@ -472,11 +553,10 @@ function wc_update_220_order_status() { WHERE posts.post_type = 'shop_order' AND posts.post_status = 'publish' AND tax.taxonomy = 'shop_order_status' - AND term.slug LIKE 'processing%'; - " + AND term.slug LIKE 'processing%';" ); - $wpdb->query( " - UPDATE {$wpdb->posts} as posts + $wpdb->query( + "UPDATE {$wpdb->posts} as posts LEFT JOIN {$wpdb->term_relationships} AS rel ON posts.ID = rel.object_id LEFT JOIN {$wpdb->term_taxonomy} AS tax USING( term_taxonomy_id ) LEFT JOIN {$wpdb->terms} AS term USING( term_id ) @@ -484,11 +564,10 @@ function wc_update_220_order_status() { WHERE posts.post_type = 'shop_order' AND posts.post_status = 'publish' AND tax.taxonomy = 'shop_order_status' - AND term.slug LIKE 'on-hold%'; - " + AND term.slug LIKE 'on-hold%';" ); - $wpdb->query( " - UPDATE {$wpdb->posts} as posts + $wpdb->query( + "UPDATE {$wpdb->posts} as posts LEFT JOIN {$wpdb->term_relationships} AS rel ON posts.ID = rel.object_id LEFT JOIN {$wpdb->term_taxonomy} AS tax USING( term_taxonomy_id ) LEFT JOIN {$wpdb->terms} AS term USING( term_id ) @@ -496,11 +575,10 @@ function wc_update_220_order_status() { WHERE posts.post_type = 'shop_order' AND posts.post_status = 'publish' AND tax.taxonomy = 'shop_order_status' - AND term.slug LIKE 'completed%'; - " + AND term.slug LIKE 'completed%';" ); - $wpdb->query( " - UPDATE {$wpdb->posts} as posts + $wpdb->query( + "UPDATE {$wpdb->posts} as posts LEFT JOIN {$wpdb->term_relationships} AS rel ON posts.ID = rel.object_id LEFT JOIN {$wpdb->term_taxonomy} AS tax USING( term_taxonomy_id ) LEFT JOIN {$wpdb->terms} AS term USING( term_id ) @@ -508,11 +586,10 @@ function wc_update_220_order_status() { WHERE posts.post_type = 'shop_order' AND posts.post_status = 'publish' AND tax.taxonomy = 'shop_order_status' - AND term.slug LIKE 'cancelled%'; - " + AND term.slug LIKE 'cancelled%';" ); - $wpdb->query( " - UPDATE {$wpdb->posts} as posts + $wpdb->query( + "UPDATE {$wpdb->posts} as posts LEFT JOIN {$wpdb->term_relationships} AS rel ON posts.ID = rel.object_id LEFT JOIN {$wpdb->term_taxonomy} AS tax USING( term_taxonomy_id ) LEFT JOIN {$wpdb->terms} AS term USING( term_id ) @@ -520,11 +597,10 @@ function wc_update_220_order_status() { WHERE posts.post_type = 'shop_order' AND posts.post_status = 'publish' AND tax.taxonomy = 'shop_order_status' - AND term.slug LIKE 'refunded%'; - " + AND term.slug LIKE 'refunded%';" ); - $wpdb->query( " - UPDATE {$wpdb->posts} as posts + $wpdb->query( + "UPDATE {$wpdb->posts} as posts LEFT JOIN {$wpdb->term_relationships} AS rel ON posts.ID = rel.object_id LEFT JOIN {$wpdb->term_taxonomy} AS tax USING( term_taxonomy_id ) LEFT JOIN {$wpdb->terms} AS term USING( term_id ) @@ -532,23 +608,27 @@ function wc_update_220_order_status() { WHERE posts.post_type = 'shop_order' AND posts.post_status = 'publish' AND tax.taxonomy = 'shop_order_status' - AND term.slug LIKE 'failed%'; - " + AND term.slug LIKE 'failed%';" ); } +/** + * Update variations for 2.2 + * + * @return void + */ function wc_update_220_variations() { global $wpdb; - // Update variations which manage stock - $update_variations = $wpdb->get_results( " - SELECT DISTINCT posts.ID AS variation_id, posts.post_parent AS variation_parent FROM {$wpdb->posts} as posts + // Update variations which manage stock. + $update_variations = $wpdb->get_results( + "SELECT DISTINCT posts.ID AS variation_id, posts.post_parent AS variation_parent FROM {$wpdb->posts} as posts LEFT OUTER JOIN {$wpdb->postmeta} AS postmeta ON posts.ID = postmeta.post_id AND postmeta.meta_key = '_stock' LEFT OUTER JOIN {$wpdb->postmeta} as postmeta2 ON posts.ID = postmeta2.post_id AND postmeta2.meta_key = '_manage_stock' WHERE posts.post_type = 'product_variation' AND postmeta.meta_value IS NOT NULL AND postmeta.meta_value != '' - AND postmeta2.meta_value IS NULL - " ); + AND postmeta2.meta_value IS NULL" + ); foreach ( $update_variations as $variation ) { $parent_backorders = get_post_meta( $variation->variation_parent, '_backorders', true ); @@ -557,16 +637,21 @@ function wc_update_220_variations() { } } +/** + * Update attributes for 2.2 + * + * @return void + */ function wc_update_220_attributes() { global $wpdb; - // Update taxonomy names with correct sanitized names - $attribute_taxonomies = $wpdb->get_results( "SELECT attribute_name, attribute_id FROM " . $wpdb->prefix . "woocommerce_attribute_taxonomies" ); + // Update taxonomy names with correct sanitized names. + $attribute_taxonomies = $wpdb->get_results( 'SELECT attribute_name, attribute_id FROM ' . $wpdb->prefix . 'woocommerce_attribute_taxonomies' ); foreach ( $attribute_taxonomies as $attribute_taxonomy ) { $sanitized_attribute_name = wc_sanitize_taxonomy_name( $attribute_taxonomy->attribute_name ); if ( $sanitized_attribute_name !== $attribute_taxonomy->attribute_name ) { if ( ! $wpdb->get_var( $wpdb->prepare( "SELECT 1=1 FROM {$wpdb->prefix}woocommerce_attribute_taxonomies WHERE attribute_name = %s;", $sanitized_attribute_name ) ) ) { - // Update attribute + // Update attribute. $wpdb->update( "{$wpdb->prefix}woocommerce_attribute_taxonomies", array( @@ -577,7 +662,7 @@ function wc_update_220_attributes() { ) ); - // Update terms + // Update terms. $wpdb->update( $wpdb->term_taxonomy, array( 'taxonomy' => wc_attribute_taxonomy_name( $sanitized_attribute_name ) ), @@ -588,25 +673,45 @@ function wc_update_220_attributes() { } } +/** + * Update DB version for 2.2 + * + * @return void + */ function wc_update_220_db_version() { WC_Install::update_db_version( '2.2.0' ); } +/** + * Update options for 2.3 + * + * @return void + */ function wc_update_230_options() { // _money_spent and _order_count may be out of sync - clear them delete_metadata( 'user', 0, '_money_spent', '', true ); delete_metadata( 'user', 0, '_order_count', '', true ); - // To prevent taxes being hidden when using a default 'no address' in a store with tax inc prices, set the woocommerce_default_customer_address to use the store base address by default + // To prevent taxes being hidden when using a default 'no address' in a store with tax inc prices, set the woocommerce_default_customer_address to use the store base address by default. if ( '' === get_option( 'woocommerce_default_customer_address', false ) && wc_prices_include_tax() ) { update_option( 'woocommerce_default_customer_address', 'base' ); } } +/** + * Update DB version for 2.3 + * + * @return void + */ function wc_update_230_db_version() { WC_Install::update_db_version( '2.3.0' ); } +/** + * Update calc discount options for 2.4 + * + * @return void + */ function wc_update_240_options() { /** * Coupon discount calculations. @@ -615,6 +720,11 @@ function wc_update_240_options() { update_option( 'woocommerce_calc_discounts_sequentially', 'yes' ); } +/** + * Update shipping methods for 2.4 + * + * @return void + */ function wc_update_240_shipping_methods() { /** * Flat Rate Shipping. @@ -625,15 +735,20 @@ function wc_update_240_shipping_methods() { 'woocommerce_international_delivery_flat_rates' => new WC_Shipping_Legacy_International_Delivery(), ); foreach ( $shipping_methods as $flat_rate_option_key => $shipping_method ) { - // Stop this running more than once if routine is repeated + // Stop this running more than once if routine is repeated. if ( version_compare( $shipping_method->get_option( 'version', 0 ), '2.4.0', '<' ) ) { - $has_classes = sizeof( WC()->shipping->get_shipping_classes() ) > 0; + $has_classes = count( WC()->shipping->get_shipping_classes() ) > 0; $cost_key = $has_classes ? 'no_class_cost' : 'cost'; $min_fee = $shipping_method->get_option( 'minimum_fee' ); - $math_cost_strings = array( 'cost' => array(), 'no_class_cost' => array() ); - $math_cost_strings[ $cost_key ][] = $shipping_method->get_option( 'cost' ); + $math_cost_strings = array( + 'cost' => array(), + 'no_class_cost' => array(), + ); - if ( $fee = $shipping_method->get_option( 'fee' ) ) { + $math_cost_strings[ $cost_key ][] = $shipping_method->get_option( 'cost' ); + $fee = $shipping_method->get_option( 'fee' ); + + if ( $fee ) { $math_cost_strings[ $cost_key ][] = strstr( $fee, '%' ) ? '[fee percent="' . str_replace( '%', '', $fee ) . '" min="' . esc_attr( $min_fee ) . '"]' : $fee; } @@ -642,7 +757,9 @@ function wc_update_240_shipping_methods() { $math_cost_strings[ $rate_key ] = $math_cost_strings['no_class_cost']; } - if ( $flat_rates = array_filter( (array) get_option( $flat_rate_option_key, array() ) ) ) { + $flat_rates = array_filter( (array) get_option( $flat_rate_option_key, array() ) ); + + if ( $flat_rates ) { foreach ( $flat_rates as $shipping_class => $rate ) { $rate_key = 'class_cost_' . $shipping_class; if ( $rate['cost'] || $rate['fee'] ) { @@ -656,7 +773,7 @@ function wc_update_240_shipping_methods() { foreach ( $math_cost_strings as $key => $math_cost_string ) { $math_cost_strings[ $key ] = array_filter( array_map( 'trim', $math_cost_strings[ $key ] ) ); if ( ! empty( $math_cost_strings[ $key ] ) ) { - $last_key = max( 0, sizeof( $math_cost_strings[ $key ] ) - 1 ); + $last_key = max( 0, count( $math_cost_strings[ $key ] ) - 1 ); $math_cost_strings[ $key ][0] = '( ' . $math_cost_strings[ $key ][0]; $math_cost_strings[ $key ][ $last_key ] .= ' ) * [qty]'; } @@ -665,7 +782,7 @@ function wc_update_240_shipping_methods() { $math_cost_strings['cost'][] = $shipping_method->get_option( 'cost_per_order' ); - // Save settings + // Save settings. foreach ( $math_cost_strings as $option_id => $math_cost_string ) { $shipping_method->settings[ $option_id ] = implode( ' + ', array_filter( $math_cost_string ) ); } @@ -678,6 +795,11 @@ function wc_update_240_shipping_methods() { } } +/** + * Update API keys for 2.4 + * + * @return void + */ function wc_update_240_api_keys() { global $wpdb; /** @@ -686,9 +808,9 @@ function wc_update_240_api_keys() { $api_users = $wpdb->get_results( "SELECT user_id FROM $wpdb->usermeta WHERE meta_key = 'woocommerce_api_consumer_key'" ); $apps_keys = array(); - // Get user data + // Get user data. foreach ( $api_users as $_user ) { - $user = get_userdata( $_user->user_id ); + $user = get_userdata( $_user->user_id ); $apps_keys[] = array( 'user_id' => $user->ID, 'permissions' => $user->woocommerce_api_key_permissions, @@ -699,7 +821,7 @@ function wc_update_240_api_keys() { } if ( ! empty( $apps_keys ) ) { - // Create new apps + // Create new apps. foreach ( $apps_keys as $app ) { $wpdb->insert( $wpdb->prefix . 'woocommerce_api_keys', @@ -714,7 +836,7 @@ function wc_update_240_api_keys() { ); } - // Delete old user keys from usermeta + // Delete old user keys from usermeta. foreach ( $api_users as $_user ) { $user_id = intval( $_user->user_id ); delete_user_meta( $user_id, 'woocommerce_api_consumer_key' ); @@ -724,36 +846,50 @@ function wc_update_240_api_keys() { } } +/** + * Update webhooks for 2.4 + * + * @return void + */ function wc_update_240_webhooks() { /** * Webhooks. * Make sure order.update webhooks get the woocommerce_order_edit_status hook. */ - $order_update_webhooks = get_posts( array( - 'posts_per_page' => -1, - 'post_type' => 'shop_webhook', - 'meta_key' => '_topic', - 'meta_value' => 'order.updated', - ) ); + $order_update_webhooks = get_posts( + array( + 'posts_per_page' => -1, + 'post_type' => 'shop_webhook', + 'meta_key' => '_topic', + 'meta_value' => 'order.updated', + ) + ); foreach ( $order_update_webhooks as $order_update_webhook ) { $webhook = new WC_Webhook( $order_update_webhook->ID ); $webhook->set_topic( 'order.updated' ); } } +/** + * Update refunds for 2.4 + * + * @return void + */ function wc_update_240_refunds() { global $wpdb; /** * Refunds for full refunded orders. * Update fully refunded orders to ensure they have a refund line item so reports add up. */ - $refunded_orders = get_posts( array( - 'posts_per_page' => -1, - 'post_type' => 'shop_order', - 'post_status' => array( 'wc-refunded' ), - ) ); + $refunded_orders = get_posts( + array( + 'posts_per_page' => -1, + 'post_type' => 'shop_order', + 'post_status' => array( 'wc-refunded' ), + ) + ); - // Ensure emails are disabled during this update routine + // Ensure emails are disabled during this update routine. remove_all_actions( 'woocommerce_order_status_refunded_notification' ); remove_all_actions( 'woocommerce_order_partially_refunded_notification' ); remove_action( 'woocommerce_order_status_refunded', array( 'WC_Emails', 'send_transactional_email' ) ); @@ -761,63 +897,88 @@ function wc_update_240_refunds() { foreach ( $refunded_orders as $refunded_order ) { $order_total = get_post_meta( $refunded_order->ID, '_order_total', true ); - $refunded_total = $wpdb->get_var( $wpdb->prepare( " - SELECT SUM( postmeta.meta_value ) - FROM $wpdb->postmeta AS postmeta - INNER JOIN $wpdb->posts AS posts ON ( posts.post_type = 'shop_order_refund' AND posts.post_parent = %d ) - WHERE postmeta.meta_key = '_refund_amount' - AND postmeta.post_id = posts.ID - ", $refunded_order->ID ) ); + $refunded_total = $wpdb->get_var( + $wpdb->prepare( + "SELECT SUM( postmeta.meta_value ) + FROM $wpdb->postmeta AS postmeta + INNER JOIN $wpdb->posts AS posts ON ( posts.post_type = 'shop_order_refund' AND posts.post_parent = %d ) + WHERE postmeta.meta_key = '_refund_amount' + AND postmeta.post_id = posts.ID", + $refunded_order->ID + ) + ); if ( $order_total > $refunded_total ) { - wc_create_refund( array( - 'amount' => $order_total - $refunded_total, - 'reason' => __( 'Order fully refunded', 'woocommerce' ), - 'order_id' => $refunded_order->ID, - 'line_items' => array(), - 'date' => $refunded_order->post_modified, - ) ); + wc_create_refund( + array( + 'amount' => $order_total - $refunded_total, + 'reason' => __( 'Order fully refunded', 'woocommerce' ), + 'order_id' => $refunded_order->ID, + 'line_items' => array(), + 'date' => $refunded_order->post_modified, + ) + ); } } wc_delete_shop_order_transients(); } +/** + * Update DB version for 2.4 + * + * @return void + */ function wc_update_240_db_version() { WC_Install::update_db_version( '2.4.0' ); } +/** + * Update variations for 2.4.1 + * + * @return void + */ function wc_update_241_variations() { global $wpdb; - // Select variations that don't have any _stock_status implemented on WooCommerce 2.2 - $update_variations = $wpdb->get_results( " - SELECT DISTINCT posts.ID AS variation_id, posts.post_parent AS variation_parent + // Select variations that don't have any _stock_status implemented on WooCommerce 2.2. + $update_variations = $wpdb->get_results( + "SELECT DISTINCT posts.ID AS variation_id, posts.post_parent AS variation_parent FROM {$wpdb->posts} as posts LEFT OUTER JOIN {$wpdb->postmeta} AS postmeta ON posts.ID = postmeta.post_id AND postmeta.meta_key = '_stock_status' WHERE posts.post_type = 'product_variation' - AND postmeta.meta_value IS NULL - " ); + AND postmeta.meta_value IS NULL" + ); foreach ( $update_variations as $variation ) { - // Get the parent _stock_status + // Get the parent _stock_status. $parent_stock_status = get_post_meta( $variation->variation_parent, '_stock_status', true ); - // Set the _stock_status + // Set the _stock_status. add_post_meta( $variation->variation_id, '_stock_status', $parent_stock_status ? $parent_stock_status : 'instock', true ); - // Delete old product children array + // Delete old product children array. delete_transient( 'wc_product_children_' . $variation->variation_parent ); } - // Invalidate old transients such as wc_var_price + // Invalidate old transients such as wc_var_price. WC_Cache_Helper::get_transient_version( 'product', true ); } +/** + * Update DB version for 2.4.1 + * + * @return void + */ function wc_update_241_db_version() { WC_Install::update_db_version( '2.4.1' ); } +/** + * Update currency settings for 2.5 + * + * @return void + */ function wc_update_250_currency() { global $wpdb; // Fix currency settings for LAK currency. @@ -840,14 +1001,22 @@ function wc_update_250_currency() { ); } +/** + * Update DB version for 2.5 + * + * @return void + */ function wc_update_250_db_version() { WC_Install::update_db_version( '2.5.0' ); } +/** + * Update ship to countries options for 2.6 + * + * @return void + */ function wc_update_260_options() { - /** - * woocommerce_calc_shipping option has been removed in 2.6 - */ + // woocommerce_calc_shipping option has been removed in 2.6. if ( 'no' === get_option( 'woocommerce_calc_shipping' ) ) { update_option( 'woocommerce_ship_to_countries', 'disabled' ); } @@ -855,10 +1024,15 @@ function wc_update_260_options() { WC_Admin_Notices::add_notice( 'legacy_shipping' ); } +/** + * Update term meta for 2.6 + * + * @return void + */ function wc_update_260_termmeta() { global $wpdb; /** - * Migrate term meta to WordPress tables + * Migrate term meta to WordPress tables. */ if ( get_option( 'db_version' ) >= 34370 && $wpdb->get_var( "SHOW TABLES LIKE '{$wpdb->prefix}woocommerce_termmeta';" ) ) { if ( $wpdb->query( "INSERT INTO {$wpdb->termmeta} ( term_id, meta_key, meta_value ) SELECT woocommerce_term_id, meta_key, meta_value FROM {$wpdb->prefix}woocommerce_termmeta;" ) ) { @@ -868,6 +1042,11 @@ function wc_update_260_termmeta() { } } +/** + * Update zones for 2.6 + * + * @return void + */ function wc_update_260_zones() { global $wpdb; /** @@ -880,6 +1059,11 @@ function wc_update_260_zones() { } } +/** + * Update zone methods for 2.6 + * + * @return void + */ function wc_update_260_zone_methods() { global $wpdb; @@ -894,34 +1078,36 @@ function wc_update_260_zone_methods() { $max_new_id = $wpdb->get_var( "SELECT MAX(instance_id) FROM {$wpdb->prefix}woocommerce_shipping_zone_methods" ); $max_old_id = $wpdb->get_var( "SELECT MAX(shipping_method_id) FROM {$wpdb->prefix}woocommerce_shipping_zone_shipping_methods" ); - // Avoid ID conflicts + // Avoid ID conflicts. $wpdb->query( $wpdb->prepare( "ALTER TABLE {$wpdb->prefix}woocommerce_shipping_zone_methods AUTO_INCREMENT = %d;", max( $max_new_id, $max_old_id ) + 1 ) ); - // Store changes + // Store changes. $changes = array(); - // Move data + // Move data. foreach ( $old_methods as $old_method ) { - $wpdb->insert( $wpdb->prefix . 'woocommerce_shipping_zone_methods', array( - 'zone_id' => $old_method->zone_id, - 'method_id' => $old_method->shipping_method_type, - 'method_order' => $old_method->shipping_method_order, - ) ); + $wpdb->insert( + $wpdb->prefix . 'woocommerce_shipping_zone_methods', array( + 'zone_id' => $old_method->zone_id, + 'method_id' => $old_method->shipping_method_type, + 'method_order' => $old_method->shipping_method_order, + ) + ); $new_instance_id = $wpdb->insert_id; - // Move main settings + // Move main settings. $older_settings_key = 'woocommerce_' . $old_method->shipping_method_type . '-' . $old_method->shipping_method_id . '_settings'; $old_settings_key = 'woocommerce_' . $old_method->shipping_method_type . '_' . $old_method->shipping_method_id . '_settings'; add_option( 'woocommerce_' . $old_method->shipping_method_type . '_' . $new_instance_id . '_settings', get_option( $old_settings_key, get_option( $older_settings_key ) ) ); // Handling for table rate and flat rate box shipping. if ( 'table_rate' === $old_method->shipping_method_type ) { - // Move priority settings + // Move priority settings. add_option( 'woocommerce_table_rate_default_priority_' . $new_instance_id, get_option( 'woocommerce_table_rate_default_priority_' . $old_method->shipping_method_id ) ); add_option( 'woocommerce_table_rate_priorities_' . $new_instance_id, get_option( 'woocommerce_table_rate_priorities_' . $old_method->shipping_method_id ) ); - // Move rates + // Move rates. $wpdb->update( $wpdb->prefix . 'woocommerce_shipping_table_rates', array( @@ -957,35 +1143,52 @@ function wc_update_260_zone_methods() { $wpdb->query( "UPDATE {$wpdb->prefix}woocommerce_shipping_zone_locations SET location_code = REPLACE( location_code, '-', '...' );" ); } +/** + * Update refunds for 2.6 + * + * @return void + */ function wc_update_260_refunds() { global $wpdb; /** - * Refund item qty should be negative + * Refund item qty should be negative. */ - $wpdb->query( " - UPDATE {$wpdb->prefix}woocommerce_order_itemmeta as item_meta - LEFT JOIN {$wpdb->prefix}woocommerce_order_items as items ON item_meta.order_item_id = items.order_item_id - LEFT JOIN {$wpdb->posts} as posts ON items.order_id = posts.ID - SET item_meta.meta_value = item_meta.meta_value * -1 - WHERE item_meta.meta_value > 0 AND item_meta.meta_key = '_qty' AND posts.post_type = 'shop_order_refund' - " ); + $wpdb->query( + "UPDATE {$wpdb->prefix}woocommerce_order_itemmeta as item_meta + LEFT JOIN {$wpdb->prefix}woocommerce_order_items as items ON item_meta.order_item_id = items.order_item_id + LEFT JOIN {$wpdb->posts} as posts ON items.order_id = posts.ID + SET item_meta.meta_value = item_meta.meta_value * -1 + WHERE item_meta.meta_value > 0 AND item_meta.meta_key = '_qty' AND posts.post_type = 'shop_order_refund'" + ); } +/** + * Update DB version for 2.6 + * + * @return void + */ function wc_update_260_db_version() { WC_Install::update_db_version( '2.6.0' ); } +/** + * Update webhooks for 3.0 + * + * @return void + */ function wc_update_300_webhooks() { /** * Make sure product.update webhooks get the woocommerce_product_quick_edit_save * and woocommerce_product_bulk_edit_save hooks. */ - $product_update_webhooks = get_posts( array( - 'posts_per_page' => -1, - 'post_type' => 'shop_webhook', - 'meta_key' => '_topic', - 'meta_value' => 'product.updated', - ) ); + $product_update_webhooks = get_posts( + array( + 'posts_per_page' => -1, + 'post_type' => 'shop_webhook', + 'meta_key' => '_topic', + 'meta_value' => 'product.updated', + ) + ); foreach ( $product_update_webhooks as $product_update_webhook ) { $webhook = new WC_Webhook( $product_update_webhook->ID ); $webhook->set_topic( 'product.updated' ); @@ -995,8 +1198,6 @@ function wc_update_300_webhooks() { /** * Add an index to the field comment_type to improve the response time of the query * used by WC_Comments::wp_count_comments() to get the number of comments by type. - * - * @return null */ function wc_update_300_comment_type_index() { global $wpdb; @@ -1010,18 +1211,25 @@ function wc_update_300_comment_type_index() { } } +/** + * Update grouped products for 3.0 + * + * @return void + */ function wc_update_300_grouped_products() { global $wpdb; $parents = $wpdb->get_col( "SELECT DISTINCT( post_parent ) FROM {$wpdb->posts} WHERE post_parent > 0 AND post_type = 'product';" ); foreach ( $parents as $parent_id ) { $parent = wc_get_product( $parent_id ); if ( $parent && $parent->is_type( 'grouped' ) ) { - $children_ids = get_posts( array( - 'post_parent' => $parent_id, - 'posts_per_page' => -1, - 'post_type' => 'product', - 'fields' => 'ids', - ) ); + $children_ids = get_posts( + array( + 'post_parent' => $parent_id, + 'posts_per_page' => -1, + 'post_type' => 'product', + 'fields' => 'ids', + ) + ); update_post_meta( $parent_id, '_children', $children_ids ); // Update children to remove the parent. @@ -1038,6 +1246,11 @@ function wc_update_300_grouped_products() { } } +/** + * Update shipping tax classes for 3.0 + * + * @return void + */ function wc_update_300_settings() { $woocommerce_shipping_tax_class = get_option( 'woocommerce_shipping_tax_class' ); if ( '' === $woocommerce_shipping_tax_class ) { @@ -1055,39 +1268,57 @@ function wc_update_300_product_visibility() { WC_Install::create_terms(); - if ( $featured_term = get_term_by( 'name', 'featured', 'product_visibility' ) ) { + $featured_term = get_term_by( 'name', 'featured', 'product_visibility' ); + + if ( $featured_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_featured' AND meta_value = 'yes';", $featured_term->term_taxonomy_id ) ); } - if ( $exclude_search_term = get_term_by( 'name', 'exclude-from-search', 'product_visibility' ) ) { + $exclude_search_term = get_term_by( 'name', 'exclude-from-search', 'product_visibility' ); + + if ( $exclude_search_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_visibility' AND meta_value IN ('hidden', 'catalog');", $exclude_search_term->term_taxonomy_id ) ); } - if ( $exclude_catalog_term = get_term_by( 'name', 'exclude-from-catalog', 'product_visibility' ) ) { + $exclude_catalog_term = get_term_by( 'name', 'exclude-from-catalog', 'product_visibility' ); + + if ( $exclude_catalog_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_visibility' AND meta_value IN ('hidden', 'search');", $exclude_catalog_term->term_taxonomy_id ) ); } - if ( $outofstock_term = get_term_by( 'name', 'outofstock', 'product_visibility' ) ) { + $outofstock_term = get_term_by( 'name', 'outofstock', 'product_visibility' ); + + if ( $outofstock_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_stock_status' AND meta_value = 'outofstock';", $outofstock_term->term_taxonomy_id ) ); } - if ( $rating_term = get_term_by( 'name', 'rated-1', 'product_visibility' ) ) { + $rating_term = get_term_by( 'name', 'rated-1', 'product_visibility' ); + + if ( $rating_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_wc_average_rating' AND ROUND( meta_value ) = 1;", $rating_term->term_taxonomy_id ) ); } - if ( $rating_term = get_term_by( 'name', 'rated-2', 'product_visibility' ) ) { + $rating_term = get_term_by( 'name', 'rated-2', 'product_visibility' ); + + if ( $rating_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_wc_average_rating' AND ROUND( meta_value ) = 2;", $rating_term->term_taxonomy_id ) ); } - if ( $rating_term = get_term_by( 'name', 'rated-3', 'product_visibility' ) ) { + $rating_term = get_term_by( 'name', 'rated-3', 'product_visibility' ); + + if ( $rating_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_wc_average_rating' AND ROUND( meta_value ) = 3;", $rating_term->term_taxonomy_id ) ); } - if ( $rating_term = get_term_by( 'name', 'rated-4', 'product_visibility' ) ) { + $rating_term = get_term_by( 'name', 'rated-4', 'product_visibility' ); + + if ( $rating_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_wc_average_rating' AND ROUND( meta_value ) = 4;", $rating_term->term_taxonomy_id ) ); } - if ( $rating_term = get_term_by( 'name', 'rated-5', 'product_visibility' ) ) { + $rating_term = get_term_by( 'name', 'rated-5', 'product_visibility' ); + + if ( $rating_term ) { $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO {$wpdb->term_relationships} SELECT post_id, %d, 0 FROM {$wpdb->postmeta} WHERE meta_key = '_wc_average_rating' AND ROUND( meta_value ) = 5;", $rating_term->term_taxonomy_id ) ); } } @@ -1128,6 +1359,21 @@ function wc_update_310_db_version() { WC_Install::update_db_version( '3.1.0' ); } +/** + * Update shop_manager capabilities. + */ +function wc_update_312_shop_manager_capabilities() { + $role = get_role( 'shop_manager' ); + $role->remove_cap( 'unfiltered_html' ); +} + +/** + * Update DB Version. + */ +function wc_update_312_db_version() { + WC_Install::update_db_version( '3.1.2' ); +} + /** * Update state codes for Mexico. */ @@ -1170,13 +1416,13 @@ function wc_update_320_mexican_states() { ); foreach ( $mx_states as $old => $new ) { - $wpdb->update( - $wpdb->postmeta, - array( - 'meta_value' => $new, - ), - array( - 'meta_value' => $old, + $wpdb->query( + $wpdb->prepare( + "UPDATE $wpdb->postmeta + SET meta_value = %s + WHERE meta_key IN ( '_billing_state', '_shipping_state' ) + AND meta_value = %s", + $new, $old ) ); $wpdb->update( @@ -1206,3 +1452,543 @@ function wc_update_320_mexican_states() { function wc_update_320_db_version() { WC_Install::update_db_version( '3.2.0' ); } + +/** + * Update image settings to use new aspect ratios and widths. + */ +function wc_update_330_image_options() { + $old_thumbnail_size = get_option( 'shop_catalog_image_size', array() ); + $old_single_size = get_option( 'shop_single_image_size', array() ); + + if ( ! empty( $old_thumbnail_size['width'] ) ) { + $width = absint( $old_thumbnail_size['width'] ); + $height = absint( $old_thumbnail_size['height'] ); + $hard_crop = ! empty( $old_thumbnail_size['crop'] ); + + if ( ! $width ) { + $width = 300; + } + + if ( ! $height ) { + $height = $width; + } + + update_option( 'woocommerce_thumbnail_image_width', $width ); + + // Calculate cropping mode from old image options. + if ( ! $hard_crop ) { + update_option( 'woocommerce_thumbnail_cropping', 'uncropped' ); + } elseif ( $width === $height ) { + update_option( 'woocommerce_thumbnail_cropping', '1:1' ); + } else { + $ratio = $width / $height; + $fraction = wc_decimal_to_fraction( $ratio ); + + if ( $fraction ) { + update_option( 'woocommerce_thumbnail_cropping', 'custom' ); + update_option( 'woocommerce_thumbnail_cropping_custom_width', $fraction[0] ); + update_option( 'woocommerce_thumbnail_cropping_custom_height', $fraction[1] ); + } + } + } + + // Single is uncropped. + if ( ! empty( $old_single_size['width'] ) ) { + update_option( 'woocommerce_single_image_width', absint( $old_single_size['width'] ) ); + } +} + +/** + * Migrate webhooks from post type to CRUD. + */ +function wc_update_330_webhooks() { + register_post_type( 'shop_webhook' ); + + // Map statuses from post_type to Webhooks CRUD. + $statuses = array( + 'publish' => 'active', + 'draft' => 'paused', + 'pending' => 'disabled', + ); + + $posts = get_posts( array( + 'posts_per_page' => -1, + 'post_type' => 'shop_webhook', + 'post_status' => 'any', + ) ); + + foreach ( $posts as $post ) { + $webhook = new WC_Webhook(); + $webhook->set_name( $post->post_title ); + $webhook->set_status( isset( $statuses[ $post->post_status ] ) ? $statuses[ $post->post_status ] : 'disabled' ); + $webhook->set_delivery_url( get_post_meta( $post->ID, '_delivery_url', true ) ); + $webhook->set_secret( get_post_meta( $post->ID, '_secret', true ) ); + $webhook->set_topic( get_post_meta( $post->ID, '_topic', true ) ); + $webhook->set_api_version( get_post_meta( $post->ID, '_api_version', true ) ); + $webhook->set_user_id( $post->post_author ); + $webhook->set_pending_delivery( false ); + $webhook->save(); + + wp_delete_post( $post->ID, true ); + } + + unregister_post_type( 'shop_webhook' ); +} + +/** + * Assign default cat to all products with no cats. + */ +function wc_update_330_set_default_product_cat() { + global $wpdb; + + $default_category = get_option( 'default_product_cat', 0 ); + + if ( $default_category ) { + $result = $wpdb->query( $wpdb->prepare( " + INSERT INTO {$wpdb->term_relationships} (object_id, term_taxonomy_id) + SELECT DISTINCT posts.ID, %s FROM {$wpdb->posts} posts + LEFT JOIN + ( + SELECT object_id FROM {$wpdb->term_relationships} term_relationships + LEFT JOIN {$wpdb->term_taxonomy} term_taxonomy ON term_relationships.term_taxonomy_id = term_taxonomy.term_taxonomy_id + WHERE term_taxonomy.taxonomy = 'product_cat' + ) AS tax_query + ON posts.ID = tax_query.object_id + WHERE posts.post_type = 'product' + AND tax_query.object_id IS NULL + ", $default_category ) ); + wp_cache_flush(); + delete_transient( 'wc_term_counts' ); + wp_update_term_count_now( array( $default_category ), 'product_cat' ); + } +} + +/** + * Update product stock status to use the new onbackorder status. + */ +function wc_update_330_product_stock_status() { + global $wpdb; + + if ( 'yes' !== get_option( 'woocommerce_manage_stock' ) ) { + return; + } + + $min_stock_amount = (int) get_option( 'woocommerce_notify_no_stock_amount', 0 ); + + // Get all products that have stock management enabled, stock less than or equal to min stock amount, and backorders enabled. + $post_ids = $wpdb->get_col( $wpdb->prepare( " + SELECT t1.post_id FROM $wpdb->postmeta t1 + INNER JOIN $wpdb->postmeta t2 + ON t1.post_id = t2.post_id + AND t1.meta_key = '_manage_stock' AND t1.meta_value = 'yes' + AND t2.meta_key = '_stock' AND t2.meta_value <= %d + INNER JOIN $wpdb->postmeta t3 + ON t2.post_id = t3.post_id + AND t3.meta_key = '_backorders' AND ( t3.meta_value = 'yes' OR t3.meta_value = 'notify' ) + ", $min_stock_amount ) ); // WPCS: db call ok, unprepared SQL ok, cache ok. + + if ( empty( $post_ids ) ) { + return; + } + + $post_ids = array_map( 'absint', $post_ids ); + + // Set the status to onbackorder for those products. + $wpdb->query( " + UPDATE $wpdb->postmeta + SET meta_value = 'onbackorder' + WHERE meta_key = '_stock_status' AND post_id IN ( " . implode( ',', $post_ids ) . ' ) + ' ); // WPCS: db call ok, unprepared SQL ok, cache ok. +} + +/** + * Clear addons page transients + */ +function wc_update_330_clear_transients() { + delete_transient( 'wc_addons_sections' ); + delete_transient( 'wc_addons_featured' ); +} + +/** + * Set PayPal's sandbox credentials. + */ +function wc_update_330_set_paypal_sandbox_credentials() { + + $paypal_settings = get_option( 'woocommerce_paypal_settings' ); + + if ( isset( $paypal_settings['testmode'] ) && 'yes' === $paypal_settings['testmode'] ) { + foreach ( array( 'api_username', 'api_password', 'api_signature' ) as $credential ) { + if ( ! empty( $paypal_settings[ $credential ] ) ) { + $paypal_settings[ 'sandbox_' . $credential ] = $paypal_settings[ $credential ]; + } + } + + update_option( 'woocommerce_paypal_settings', $paypal_settings ); + } +} + +/** + * Update DB Version. + */ +function wc_update_330_db_version() { + WC_Install::update_db_version( '3.3.0' ); +} + +/** + * Update state codes for Ireland and BD. + */ +function wc_update_340_states() { + $country_states = array( + 'IE' => array( + 'CK' => 'CO', + 'DN' => 'D', + 'GY' => 'G', + 'TY' => 'TA', + ), + 'BD' => array( + 'BAG' => 'BD-05', + 'BAN' => 'BD-01', + 'BAR' => 'BD-02', + 'BARI' => 'BD-06', + 'BHO' => 'BD-07', + 'BOG' => 'BD-03', + 'BRA' => 'BD-04', + 'CHA' => 'BD-09', + 'CHI' => 'BD-10', + 'CHU' => 'BD-12', + 'COX' => 'BD-11', + 'COM' => 'BD-08', + 'DHA' => 'BD-13', + 'DIN' => 'BD-14', + 'FAR' => 'BD-15', + 'FEN' => 'BD-16', + 'GAI' => 'BD-19', + 'GAZI' => 'BD-18', + 'GOP' => 'BD-17', + 'HAB' => 'BD-20', + 'JAM' => 'BD-21', + 'JES' => 'BD-22', + 'JHA' => 'BD-25', + 'JHE' => 'BD-23', + 'JOY' => 'BD-24', + 'KHA' => 'BD-29', + 'KHU' => 'BD-27', + 'KIS' => 'BD-26', + 'KUR' => 'BD-28', + 'KUS' => 'BD-30', + 'LAK' => 'BD-31', + 'LAL' => 'BD-32', + 'MAD' => 'BD-36', + 'MAG' => 'BD-37', + 'MAN' => 'BD-33', + 'MEH' => 'BD-39', + 'MOU' => 'BD-38', + 'MUN' => 'BD-35', + 'MYM' => 'BD-34', + 'NAO' => 'BD-48', + 'NAR' => 'BD-43', + 'NARG' => 'BD-40', + 'NARD' => 'BD-42', + 'NAT' => 'BD-44', + 'NAW' => 'BD-45', + 'NET' => 'BD-41', + 'NIL' => 'BD-46', + 'NOA' => 'BD-47', + 'PAB' => 'BD-49', + 'PAN' => 'BD-52', + 'PAT' => 'BD-51', + 'PIR' => 'BD-50', + 'RAJB' => 'BD-53', + 'RAJ' => 'BD-54', + 'RAN' => 'BD-56', + 'RANP' => 'BD-55', + 'SAT' => 'BD-58', + 'SHA' => 'BD-57', + 'SIR' => 'BD-59', + 'SUN' => 'BD-61', + 'SYL' => 'BD-60', + 'TAN' => 'BD-63', + 'THA' => 'BD-64', + ), + ); + + update_option( 'woocommerce_update_340_states', $country_states ); +} + +/** + * Update next state in the queue. + * + * @return bool True to run again, false if completed. + */ +function wc_update_340_state() { + global $wpdb; + + $country_states = array_filter( (array) get_option( 'woocommerce_update_340_states', array() ) ); + + if ( empty( $country_states ) ) { + return false; + } + + foreach ( $country_states as $country => $states ) { + foreach ( $states as $old => $new ) { + $wpdb->query( + $wpdb->prepare( + "UPDATE $wpdb->postmeta + SET meta_value = %s + WHERE meta_key IN ( '_billing_state', '_shipping_state' ) + AND meta_value = %s", + $new, $old + ) + ); + $wpdb->update( + "{$wpdb->prefix}woocommerce_shipping_zone_locations", + array( + 'location_code' => $country . ':' . $new, + ), + array( + 'location_code' => $country . ':' . $old, + ) + ); + $wpdb->update( + "{$wpdb->prefix}woocommerce_tax_rates", + array( + 'tax_rate_state' => strtoupper( $new ), + ), + array( + 'tax_rate_state' => strtoupper( $old ), + ) + ); + unset( $country_states[ $country ][ $old ] ); + + if ( empty( $country_states[ $country ] ) ) { + unset( $country_states[ $country ] ); + } + break 2; + } + } + + if ( ! empty( $country_states ) ) { + return update_option( 'woocommerce_update_340_states', $country_states ); + } + + delete_option( 'woocommerce_update_340_states' ); + + return false; +} + +/** + * Set last active prop for users. + */ +function wc_update_340_last_active() { + global $wpdb; + // @codingStandardsIgnoreStart. + $wpdb->query( + $wpdb->prepare( " + INSERT INTO {$wpdb->usermeta} (user_id, meta_key, meta_value) + SELECT DISTINCT users.ID, 'wc_last_active', %s + FROM {$wpdb->users} as users + LEFT OUTER JOIN {$wpdb->usermeta} AS usermeta ON users.ID = usermeta.user_id AND usermeta.meta_key = 'wc_last_active' + WHERE usermeta.meta_value IS NULL + ", + (string) strtotime( date( 'Y-m-d', current_time( 'timestamp', true ) ) ) + ) + ); + // @codingStandardsIgnoreEnd. +} + +/** + * Update DB Version. + */ +function wc_update_340_db_version() { + WC_Install::update_db_version( '3.4.0' ); +} + +/** + * Remove duplicate foreign keys + * + * @return void + */ +function wc_update_343_cleanup_foreign_keys() { + global $wpdb; + + $results = $wpdb->get_results( " + SELECT CONSTRAINT_NAME + FROM information_schema.TABLE_CONSTRAINTS + WHERE CONSTRAINT_SCHEMA = '{$wpdb->dbname}' + AND CONSTRAINT_NAME LIKE '%wc_download_log_ib%' + AND CONSTRAINT_TYPE = 'FOREIGN KEY' + AND TABLE_NAME = '{$wpdb->prefix}wc_download_log' + " ); + + if ( $results ) { + foreach ( $results as $fk ) { + $wpdb->query( "ALTER TABLE {$wpdb->prefix}wc_download_log DROP FOREIGN KEY {$fk->CONSTRAINT_NAME}" ); // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + } + } +} + +/** + * Update DB version. + * + * @return void + */ +function wc_update_343_db_version() { + WC_Install::update_db_version( '3.4.3' ); +} + +/** + * Recreate user roles so existing users will get the new capabilities. + * + * @return void + */ +function wc_update_344_recreate_roles() { + WC_Install::remove_roles(); + WC_Install::create_roles(); +} + +/** + * Update DB version. + * + * @return void + */ +function wc_update_344_db_version() { + WC_Install::update_db_version( '3.4.4' ); +} + +/** + * Copy order customer_id from post meta to post_author and set post_author to 0 for refunds. + * + * Two different strategies are used to copy data depending if the update is being executed from + * the command line or not. If `wp wc update` is used to update the database, this function + * copies data in a single go that is faster but uses more resources. If the databse update was + * triggered from the wp-admin, this function copies data in batches which is slower but uses + * few resources and thus is less likely to fail on smaller servers. + * + * @param WC_Background_Updater|false $updater Background updater instance or false if function is called from `wp wc update` WP-CLI command. + * @return true|void Return true if near memory limit and needs to restart. Return void if update completed. + */ +function wc_update_350_order_customer_id( $updater = false ) { + global $wpdb; + + $post_types = (array) apply_filters( 'woocommerce_update_350_order_customer_id_post_types', array( 'shop_order' ) ); + $post_types_placeholders = implode( ', ', array_fill( 0, count( $post_types ), '%s' ) ); + + if ( defined( 'WP_CLI' ) && WP_CLI ) { + // If running the update from the command-line, copy data in a single go which is faster but uses more resources. + $wpdb->query( + 'CREATE TEMPORARY TABLE customers_map (post_id BIGINT(20), customer_id BIGINT(20), PRIMARY KEY(post_id))' + ); + + $wpdb->query( + "INSERT IGNORE INTO customers_map (SELECT post_id, meta_value FROM {$wpdb->prefix}postmeta WHERE meta_key = '_customer_user')" + ); + + $wpdb->query( 'SET sql_safe_updates=1' ); + + $wpdb->query( + $wpdb->prepare( + "UPDATE {$wpdb->prefix}posts JOIN customers_map ON {$wpdb->prefix}posts.ID = customers_map.post_id SET {$wpdb->prefix}posts.post_author = customers_map.customer_id WHERE post_type IN ({$post_types_placeholders})", // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $post_types + ) + ); + + $wpdb->update( $wpdb->posts, array( 'post_author' => 0 ), array( 'post_type' => 'shop_order_refund' ) ); + } else { + // If running the update from the wp-admin, copy data in batches being careful not to use more memory than allowed. + $admin_orders_sql = ''; + $admin_orders = get_transient( 'wc_update_350_admin_orders' ); + + if ( false === $admin_orders ) { + // Get the list of orders that we don't want to change as they belong to user ID 1. + $admin_orders = $wpdb->get_col( + $wpdb->prepare( + "SELECT ID FROM {$wpdb->prefix}posts p + INNER JOIN {$wpdb->prefix}postmeta pm ON p.ID = pm.post_id + WHERE post_type IN ({$post_types_placeholders}) AND meta_key = '_customer_user' AND meta_value = 1", // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $post_types + ) + ); + + // Cache the list of orders placed by the user ID 1 as to large stores this query can be slow. + set_transient( 'wc_update_350_admin_orders', $admin_orders, DAY_IN_SECONDS ); + } + + if ( ! empty( $admin_orders ) ) { + $admin_orders_sql .= ' AND ID NOT IN (' . implode( ', ', $admin_orders ) . ') '; + } + + // Query to get a batch of orders IDs to change. + $query = $wpdb->prepare( + // phpcs:disable WordPress.WP.PreparedSQL.NotPrepared + "SELECT ID FROM {$wpdb->posts} + WHERE post_author = 1 AND post_type IN ({$post_types_placeholders}) $admin_orders_sql + LIMIT 1000", + $post_types + // phpcs:enable + ); + + while ( true ) { + // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + $orders_to_update = $wpdb->get_col( $query ); + + // Exit loop if no more orders to update. + if ( ! $orders_to_update ) { + break; + } + + $orders_meta_data = $wpdb->get_results( + // phpcs:ignore WordPress.WP.PreparedSQL.NotPrepared + "SELECT post_id, meta_value as customer_id FROM {$wpdb->postmeta} WHERE meta_key = '_customer_user' AND post_id IN (" . implode( ', ', $orders_to_update ) . ')' + ); + + // Exit loop if no _customer_user metas exist for the list of orders to update. + if ( ! $orders_meta_data ) { + break; + } + + // Update post_author for a batch of orders. + foreach ( $orders_meta_data as $order_meta ) { + // Stop update execution and re-enqueue it if near memory limit. + if ( $updater instanceof WC_Background_Updater && $updater->is_memory_exceeded() ) { + return true; + } + + $wpdb->update( $wpdb->posts, array( 'post_author' => $order_meta->customer_id ), array( 'ID' => $order_meta->post_id ) ); + } + } + + // Set post_author to 0 instead of 1 on all shop_order_refunds. + while ( true ) { + // Stop update execution and re-enqueue it if near memory limit. + if ( $updater instanceof WC_Background_Updater && $updater->is_memory_exceeded() ) { + return true; + } + + $updated_rows = $wpdb->query( "UPDATE {$wpdb->posts} SET post_author = 0 WHERE post_type = 'shop_order_refund' LIMIT 1000" ); + + if ( ! $updated_rows ) { + break; + } + } + } + + wp_cache_flush(); +} + +/** + * Set the comment type to 'review' for product reviews that don't have a comment type. + */ +function wc_update_350_reviews_comment_type() { + global $wpdb; + + $wpdb->query( + "UPDATE {$wpdb->prefix}comments JOIN {$wpdb->prefix}posts ON {$wpdb->prefix}posts.ID = {$wpdb->prefix}comments.comment_post_ID AND ( {$wpdb->prefix}posts.post_type = 'product' OR {$wpdb->prefix}posts.post_type = 'product_variation' ) SET {$wpdb->prefix}comments.comment_type = 'review' WHERE {$wpdb->prefix}comments.comment_type = ''" + ); +} + +/** + * Update DB Version. + */ +function wc_update_350_db_version() { + WC_Install::update_db_version( '3.5.0' ); +} diff --git a/includes/wc-user-functions.php b/includes/wc-user-functions.php index 9d572654eea..4dfc999153c 100644 --- a/includes/wc-user-functions.php +++ b/includes/wc-user-functions.php @@ -4,23 +4,18 @@ * * Functions for customers. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.2.0 + * @package WooCommerce/Functions + * @version 2.2.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; /** * Prevent any user who cannot 'edit_posts' (subscribers, customers etc) from seeing the admin bar. * - * Note: get_option( 'woocommerce_lock_down_admin', true ) is a deprecated option here for backwards compat. Defaults to true. + * Note: get_option( 'woocommerce_lock_down_admin', true ) is a deprecated option here for backwards compatibility. Defaults to true. * - * @access public - * @param bool $show_admin_bar + * @param bool $show_admin_bar If should display admin bar. * @return bool */ function wc_disable_admin_bar( $show_admin_bar ) { @@ -30,7 +25,7 @@ function wc_disable_admin_bar( $show_admin_bar ) { return $show_admin_bar; } -add_filter( 'show_admin_bar', 'wc_disable_admin_bar', 10, 1 ); +add_filter( 'show_admin_bar', 'wc_disable_admin_bar', 10, 1 ); // phpcs:ignore WordPress.VIP.AdminBarRemoval.RemovalDetected if ( ! function_exists( 'wc_create_new_customer' ) ) { @@ -50,7 +45,7 @@ if ( ! function_exists( 'wc_create_new_customer' ) ) { } if ( email_exists( $email ) ) { - return new WP_Error( 'registration-error-email-exists', __( 'An account is already registered with your email address. Please log in.', 'woocommerce' ) ); + return new WP_Error( 'registration-error-email-exists', apply_filters( 'woocommerce_registration_error_email_exists', __( 'An account is already registered with your email address. Please log in.', 'woocommerce' ), $email ) ); } // Handle username creation. @@ -78,13 +73,14 @@ if ( ! function_exists( 'wc_create_new_customer' ) ) { } // Handle password creation. + $password_generated = false; if ( 'yes' === get_option( 'woocommerce_registration_generate_password' ) && empty( $password ) ) { $password = wp_generate_password(); $password_generated = true; - } elseif ( empty( $password ) ) { + } + + if ( empty( $password ) ) { return new WP_Error( 'registration-error-missing-password', __( 'Please enter an account password.', 'woocommerce' ) ); - } else { - $password_generated = false; } // Use WP_Error to handle registration errors. @@ -98,17 +94,19 @@ if ( ! function_exists( 'wc_create_new_customer' ) ) { return $errors; } - $new_customer_data = apply_filters( 'woocommerce_new_customer_data', array( - 'user_login' => $username, - 'user_pass' => $password, - 'user_email' => $email, - 'role' => 'customer', - ) ); + $new_customer_data = apply_filters( + 'woocommerce_new_customer_data', array( + 'user_login' => $username, + 'user_pass' => $password, + 'user_email' => $email, + 'role' => 'customer', + ) + ); $customer_id = wp_insert_user( $new_customer_data ); if ( is_wp_error( $customer_id ) ) { - return new WP_Error( 'registration-error', '' . __( 'Error:', 'woocommerce' ) . ' ' . __( 'Couldn’t register you… please contact us if you continue to have problems.', 'woocommerce' ) ); + return new WP_Error( 'registration-error', __( 'Couldn’t register you… please contact us if you continue to have problems.', 'woocommerce' ) ); } do_action( 'woocommerce_created_customer', $customer_id, $new_customer_data, $password_generated ); @@ -120,12 +118,12 @@ if ( ! function_exists( 'wc_create_new_customer' ) ) { /** * Login a customer (set auth cookie and set global user object). * - * @param int $customer_id + * @param int $customer_id Customer ID. */ function wc_set_customer_auth_cookie( $customer_id ) { global $current_user; - $current_user = get_user_by( 'id', $customer_id ); + $current_user = get_user_by( 'id', $customer_id ); // WPCS: override ok. wp_set_auth_cookie( $customer_id, true ); } @@ -133,22 +131,36 @@ function wc_set_customer_auth_cookie( $customer_id ) { /** * Get past orders (by email) and update them. * - * @param int $customer_id + * @param int $customer_id Customer ID. * @return int */ function wc_update_new_customer_past_orders( $customer_id ) { $linked = 0; $complete = 0; $customer = get_user_by( 'id', absint( $customer_id ) ); - $customer_orders = wc_get_orders( array( - 'limit' => -1, - 'customer' => array( array( 0, $customer->user_email ) ), - 'return' => 'ids', - ) ); + $customer_orders = wc_get_orders( + array( + 'limit' => -1, + 'customer' => array( array( 0, $customer->user_email ) ), + 'return' => 'ids', + ) + ); if ( ! empty( $customer_orders ) ) { foreach ( $customer_orders as $order_id ) { - update_post_meta( $order_id, '_customer_user', $customer->ID ); + $order = wc_get_order( $order_id ); + if ( ! $order ) { + continue; + } + + $order->set_customer_id( $customer->ID ); + $order->save(); + + if ( $order->has_downloadable_item() ) { + $data_store = WC_Data_Store::load( 'customer-download' ); + $data_store->delete_by_order_id( $order->get_id() ); + wc_downloadable_product_permissions( $order->get_id(), true ); + } do_action( 'woocommerce_update_new_customer_past_order', $order_id, $customer ); @@ -172,8 +184,7 @@ function wc_update_new_customer_past_orders( $customer_id ) { /** * Order Status completed - This is a paying customer. * - * @access public - * @param int $order_id + * @param int $order_id Order ID. */ function wc_paying_customer( $order_id ) { $order = wc_get_order( $order_id ); @@ -189,22 +200,34 @@ add_action( 'woocommerce_order_status_completed', 'wc_paying_customer' ); /** * Checks if a user (by email or ID or both) has bought an item. - * @param string $customer_email - * @param int $user_id - * @param int $product_id + * + * @param string $customer_email Customer email to check. + * @param int $user_id User ID to check. + * @param int $product_id Product ID to check. * @return bool */ function wc_customer_bought_product( $customer_email, $user_id, $product_id ) { global $wpdb; - $transient_name = 'wc_cbp_' . md5( $customer_email . $user_id . WC_Cache_Helper::get_transient_version( 'orders' ) ); + $result = apply_filters( 'woocommerce_pre_customer_bought_product', null, $customer_email, $user_id, $product_id ); - if ( false === ( $result = get_transient( $transient_name ) ) ) { - $customer_data = array( $user_id ); + if ( null !== $result ) { + return $result; + } + + $transient_name = 'wc_cbp_' . md5( $customer_email . $user_id . WC_Cache_Helper::get_transient_version( 'orders' ) ); + $result = get_transient( $transient_name ); + + if ( false === $result ) { + $customer_data = array(); if ( $user_id ) { $user = get_user_by( 'id', $user_id ); + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '<' ) ) { + $customer_data[] = $user_id; + } + if ( isset( $user->user_email ) ) { $customer_data[] = $user->user_email; } @@ -217,54 +240,96 @@ function wc_customer_bought_product( $customer_email, $user_id, $product_id ) { $customer_data = array_map( 'esc_sql', array_filter( array_unique( $customer_data ) ) ); $statuses = array_map( 'esc_sql', wc_get_is_paid_statuses() ); - if ( sizeof( $customer_data ) == 0 ) { + if ( count( $customer_data ) === 0 ) { return false; } - $result = $wpdb->get_col( " - SELECT im.meta_value FROM {$wpdb->posts} AS p - INNER JOIN {$wpdb->postmeta} AS pm ON p.ID = pm.post_id - INNER JOIN {$wpdb->prefix}woocommerce_order_items AS i ON p.ID = i.order_id - INNER JOIN {$wpdb->prefix}woocommerce_order_itemmeta AS im ON i.order_item_id = im.order_item_id - WHERE p.post_status IN ( 'wc-" . implode( "','wc-", $statuses ) . "' ) - AND pm.meta_key IN ( '_billing_email', '_customer_user' ) - AND im.meta_key IN ( '_product_id', '_variation_id' ) - AND im.meta_value != 0 - AND pm.meta_value IN ( '" . implode( "','", $customer_data ) . "' ) - " ); + if ( version_compare( get_option( 'woocommerce_db_version' ), '3.5.0', '>=' ) && $user_id ) { + // Since WC 3.5 wp_posts.post_author is used to store the ID of the customer who placed an order. + $query = "SELECT im.meta_value FROM {$wpdb->posts} AS p + INNER JOIN {$wpdb->postmeta} AS pm ON p.ID = pm.post_id + INNER JOIN {$wpdb->prefix}woocommerce_order_items AS i ON p.ID = i.order_id + INNER JOIN {$wpdb->prefix}woocommerce_order_itemmeta AS im ON i.order_item_id = im.order_item_id + WHERE p.post_status IN ( 'wc-" . implode( "','wc-", $statuses ) . "' ) + AND p.post_author = {$user_id} + AND pm.meta_key = '_billing_email' + AND im.meta_key IN ( '_product_id', '_variation_id' ) + AND im.meta_value != 0 + AND pm.meta_value IN ( '" . implode( "','", $customer_data ) . "' )"; + } else { + $query = "SELECT im.meta_value FROM {$wpdb->posts} AS p + INNER JOIN {$wpdb->postmeta} AS pm ON p.ID = pm.post_id + INNER JOIN {$wpdb->prefix}woocommerce_order_items AS i ON p.ID = i.order_id + INNER JOIN {$wpdb->prefix}woocommerce_order_itemmeta AS im ON i.order_item_id = im.order_item_id + WHERE p.post_status IN ( 'wc-" . implode( "','wc-", $statuses ) . "' ) + AND pm.meta_key IN ( '_billing_email', '_customer_user' ) + AND im.meta_key IN ( '_product_id', '_variation_id' ) + AND im.meta_value != 0 + AND pm.meta_value IN ( '" . implode( "','", $customer_data ) . "' )"; + } + + $result = $wpdb->get_col( $query ); // WPCS: unprepared SQL ok. $result = array_map( 'absint', $result ); set_transient( $transient_name, $result, DAY_IN_SECONDS * 30 ); } - return in_array( absint( $product_id ), $result ); + return in_array( absint( $product_id ), $result, true ); +} + +/** + * Checks if the current user has a role. + * + * @param string $role The role. + * @return bool + */ +function wc_current_user_has_role( $role ) { + return wc_user_has_role( wp_get_current_user(), $role ); +} + +/** + * Checks if a user has a role. + * + * @param int|\WP_User $user The user. + * @param string $role The role. + * @return bool + */ +function wc_user_has_role( $user, $role ) { + if ( ! is_object( $user ) ) { + $user = get_userdata( $user ); + } + + if ( ! $user || ! $user->exists() ) { + return false; + } + + return in_array( $role, $user->roles, true ); } /** * Checks if a user has a certain capability. * - * @access public - * @param array $allcaps - * @param array $caps - * @param array $args + * @param array $allcaps All capabilities. + * @param array $caps Capabilities. + * @param array $args Arguments. * @return bool */ function wc_customer_has_capability( $allcaps, $caps, $args ) { if ( isset( $caps[0] ) ) { switch ( $caps[0] ) { - case 'view_order' : - $user_id = $args[1]; + case 'view_order': + $user_id = intval( $args[1] ); $order = wc_get_order( $args[2] ); - if ( $order && $user_id == $order->get_user_id() ) { + if ( $order && $user_id === $order->get_user_id() ) { $allcaps['view_order'] = true; } - break; - case 'pay_for_order' : - $user_id = $args[1]; + break; + case 'pay_for_order': + $user_id = intval( $args[1] ); $order_id = isset( $args[2] ) ? $args[2] : null; // When no order ID, we assume it's a new order - // and thus, customer can pay for it + // and thus, customer can pay for it. if ( ! $order_id ) { $allcaps['pay_for_order'] = true; break; @@ -272,34 +337,34 @@ function wc_customer_has_capability( $allcaps, $caps, $args ) { $order = wc_get_order( $order_id ); - if ( $order && ( $user_id == $order->get_user_id() || ! $order->get_user_id() ) ) { + if ( $order && ( $user_id === $order->get_user_id() || ! $order->get_user_id() ) ) { $allcaps['pay_for_order'] = true; } - break; - case 'order_again' : - $user_id = $args[1]; + break; + case 'order_again': + $user_id = intval( $args[1] ); $order = wc_get_order( $args[2] ); - if ( $order && $user_id == $order->get_user_id() ) { + if ( $order && $user_id === $order->get_user_id() ) { $allcaps['order_again'] = true; } - break; - case 'cancel_order' : - $user_id = $args[1]; + break; + case 'cancel_order': + $user_id = intval( $args[1] ); $order = wc_get_order( $args[2] ); - if ( $order && $user_id == $order->get_user_id() ) { + if ( $order && $user_id === $order->get_user_id() ) { $allcaps['cancel_order'] = true; } - break; - case 'download_file' : - $user_id = $args[1]; + break; + case 'download_file': + $user_id = intval( $args[1] ); $download = $args[2]; - if ( $download && $user_id == $download->get_user_id() ) { + if ( $download && $user_id === $download->get_user_id() ) { $allcaps['download_file'] = true; } - break; + break; } } return $allcaps; @@ -308,42 +373,64 @@ add_filter( 'user_has_cap', 'wc_customer_has_capability', 10, 3 ); /** * Modify the list of editable roles to prevent non-admin adding admin users. - * @param array $roles + * + * @param array $roles Roles. * @return array */ function wc_modify_editable_roles( $roles ) { - if ( ! current_user_can( 'administrator' ) ) { - unset( $roles['administrator'] ); + if ( is_multisite() && is_super_admin() ) { + return $roles; } + if ( ! wc_current_user_has_role( 'administrator' ) ) { + unset( $roles['administrator'] ); + + if ( wc_current_user_has_role( 'shop_manager' ) ) { + $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); + return array_intersect_key( $roles, array_flip( $shop_manager_editable_roles ) ); + } + } + return $roles; } add_filter( 'editable_roles', 'wc_modify_editable_roles' ); /** - * Modify capabiltiies to prevent non-admin users editing admin users. + * Modify capabilities to prevent non-admin users editing admin users. * * $args[0] will be the user being edited in this case. * - * @param array $caps Array of caps - * @param string $cap Name of the cap we are checking - * @param int $user_id ID of the user being checked against - * @param array $args + * @param array $caps Array of caps. + * @param string $cap Name of the cap we are checking. + * @param int $user_id ID of the user being checked against. + * @param array $args Arguments. * @return array */ function wc_modify_map_meta_cap( $caps, $cap, $user_id, $args ) { + if ( is_multisite() && is_super_admin() ) { + return $caps; + } switch ( $cap ) { - case 'edit_user' : - case 'remove_user' : - case 'promote_user' : - case 'delete_user' : + case 'edit_user': + case 'remove_user': + case 'promote_user': + case 'delete_user': if ( ! isset( $args[0] ) || $args[0] === $user_id ) { break; } else { - if ( user_can( $args[0], 'administrator' ) && ! current_user_can( 'administrator' ) ) { - $caps[] = 'do_not_allow'; + if ( ! wc_current_user_has_role( 'administrator' ) ) { + if ( wc_user_has_role( $args[0], 'administrator' ) ) { + $caps[] = 'do_not_allow'; + } elseif ( wc_current_user_has_role( 'shop_manager' ) ) { + // Shop managers can only edit customer info. + $userdata = get_userdata( $args[0] ); + $shop_manager_editable_roles = apply_filters( 'woocommerce_shop_manager_editable_roles', array( 'customer' ) ); + if ( property_exists( $userdata, 'roles' ) && ! empty( $userdata->roles ) && ! array_intersect( $userdata->roles, $shop_manager_editable_roles ) ) { + $caps[] = 'do_not_allow'; + } + } } } - break; + break; } return $caps; } @@ -352,7 +439,7 @@ add_filter( 'map_meta_cap', 'wc_modify_map_meta_cap', 10, 4 ); /** * Get customer download permissions from the database. * - * @param int $customer_id Customer/User ID + * @param int $customer_id Customer/User ID. * @return array */ function wc_get_customer_download_permissions( $customer_id ) { @@ -363,7 +450,7 @@ function wc_get_customer_download_permissions( $customer_id ) { /** * Get customer available downloads. * - * @param int $customer_id Customer/User ID + * @param int $customer_id Customer/User ID. * @return array */ function wc_get_customer_available_downloads( $customer_id ) { @@ -372,36 +459,38 @@ function wc_get_customer_available_downloads( $customer_id ) { $order = null; $file_number = 0; - // Get results from valid orders only + // Get results from valid orders only. $results = wc_get_customer_download_permissions( $customer_id ); if ( $results ) { foreach ( $results as $result ) { - if ( ! $order || $order->get_id() != $result->order_id ) { - // new order - $order = wc_get_order( $result->order_id ); + $order_id = intval( $result->order_id ); + + if ( ! $order || $order->get_id() !== $order_id ) { + // New order. + $order = wc_get_order( $order_id ); $_product = null; } - // Make sure the order exists for this download + // Make sure the order exists for this download. if ( ! $order ) { continue; } - // Downloads permitted? + // Check if downloads are permitted. if ( ! $order->is_download_permitted() ) { continue; } $product_id = intval( $result->product_id ); - if ( ! $_product || $_product->get_id() != $product_id ) { - // new product + if ( ! $_product || $_product->get_id() !== $product_id ) { + // New product. $file_number = 0; $_product = wc_get_product( $product_id ); } - // Check product exists and has the file + // Check product exists and has the file. if ( ! $_product || ! $_product->exists() || ! $_product->has_file( $result->download_id ) ) { continue; } @@ -418,24 +507,25 @@ function wc_get_customer_available_downloads( $customer_id ) { ); $downloads[] = array( - 'download_url' => add_query_arg( + 'download_url' => add_query_arg( array( 'download_file' => $product_id, 'order' => $result->order_key, - 'email' => urlencode( $result->user_email ), + 'email' => rawurlencode( $result->user_email ), 'key' => $result->download_id, ), home_url( '/' ) ), - 'download_id' => $result->download_id, - 'product_id' => $_product->get_id(), - 'product_name' => $_product->get_name(), - 'download_name' => $download_name, - 'order_id' => $order->get_id(), - 'order_key' => $order->get_order_key(), - 'downloads_remaining' => $result->downloads_remaining, - 'access_expires' => $result->access_expires, - 'file' => array( + 'download_id' => $result->download_id, + 'product_id' => $_product->get_id(), + 'product_name' => $_product->get_name(), + 'product_url' => $_product->is_visible() ? $_product->get_permalink() : '', // Since 3.3.0. + 'download_name' => $download_name, + 'order_id' => $order->get_id(), + 'order_key' => $order->get_order_key(), + 'downloads_remaining' => $result->downloads_remaining, + 'access_expires' => $result->access_expires, + 'file' => array( 'name' => $download_file->get_name(), 'file' => $download_file->get_file(), ), @@ -450,7 +540,8 @@ function wc_get_customer_available_downloads( $customer_id ) { /** * Get total spent by customer. - * @param int $user_id + * + * @param int $user_id User ID. * @return string */ function wc_get_customer_total_spent( $user_id ) { @@ -460,7 +551,8 @@ function wc_get_customer_total_spent( $user_id ) { /** * Get total orders by customer. - * @param int $user_id + * + * @param int $user_id User ID. * @return int */ function wc_get_customer_order_count( $user_id ) { @@ -469,31 +561,48 @@ function wc_get_customer_order_count( $user_id ) { } /** - * Reset _customer_user on orders when a user is deleted. - * @param int $user_id + * Reset customer ID on orders when a user is deleted. + * + * @param int $user_id User ID. */ function wc_reset_order_customer_id_on_deleted_user( $user_id ) { global $wpdb; - $wpdb->update( $wpdb->postmeta, array( 'meta_value' => 0 ), array( 'meta_key' => '_customer_user', 'meta_value' => $user_id ) ); + $wpdb->update( + $wpdb->postmeta, array( 'meta_value' => 0 ), array( + 'meta_key' => '_customer_user', + 'meta_value' => $user_id, + ) + ); // WPCS: slow query ok. + + $post_types = (array) apply_filters( 'woocommerce_reset_order_customer_id_post_types', array( 'shop_order' ) ); + $post_types_placeholders = implode( ', ', array_fill( 0, count( $post_types ), '%s' ) ); + $query_args = array_merge( $post_types, array( $user_id ) ); + + // Since WC 3.5, the customer ID is stored both in the _customer_user postmeta and in the post_author field. + // In future versions of WC, the plan is to use only post_author and stop using _customer_user, but for now + // we have to update both places. + $wpdb->query( + // phpcs:disable WordPress.WP.PreparedSQL.NotPrepared, WordPress.DB.PreparedSQLPlaceholders.UnfinishedPrepare + $wpdb->prepare( + "UPDATE {$wpdb->posts} SET `post_author` = 0 WHERE post_type IN ({$post_types_placeholders}) AND post_author = %d", + $query_args + ) + // phpcs:enable + ); } add_action( 'deleted_user', 'wc_reset_order_customer_id_on_deleted_user' ); /** * Get review verification status. - * @param int $comment_id + * + * @param int $comment_id Comment ID. * @return bool */ function wc_review_is_from_verified_owner( $comment_id ) { $verified = get_comment_meta( $comment_id, 'verified', true ); - - // If no "verified" meta is present, generate it (if this is a product review). - if ( '' === $verified ) { - $verified = WC_Comments::add_comment_purchase_verification( $comment_id ); - } - - return (bool) $verified; + return '' === $verified ? WC_Comments::add_comment_purchase_verification( $comment_id ) : (bool) $verified; } /** @@ -539,16 +648,10 @@ add_action( 'profile_update', 'wc_update_profile_last_update_time', 10, 2 ); */ function wc_meta_update_last_update_time( $meta_id, $user_id, $meta_key, $_meta_value ) { $keys_to_track = apply_filters( 'woocommerce_user_last_update_fields', array( 'first_name', 'last_name' ) ); - $update_time = false; - if ( in_array( $meta_key, $keys_to_track ) ) { - $update_time = true; - } - if ( 'billing_' === substr( $meta_key, 0, 8 ) ) { - $update_time = true; - } - if ( 'shipping_' === substr( $meta_key, 0, 9 ) ) { - $update_time = true; - } + + $update_time = in_array( $meta_key, $keys_to_track, true ) ? true : false; + $update_time = 'billing_' === substr( $meta_key, 0, 8 ) ? true : $update_time; + $update_time = 'shipping_' === substr( $meta_key, 0, 9 ) ? true : $update_time; if ( $update_time ) { wc_set_user_last_update_time( $user_id ); @@ -571,7 +674,7 @@ function wc_set_user_last_update_time( $user_id ) { * Get customer saved payment methods list. * * @since 2.6.0 - * @param int $customer_id + * @param int $customer_id Customer ID. * @return array */ function wc_get_customer_saved_methods_list( $customer_id ) { @@ -583,22 +686,111 @@ function wc_get_customer_saved_methods_list( $customer_id ) { * * @since 2.6.0 * @param int $customer_id Customer ID. - * @return WC_Order Order object if successful or false. + * @return WC_Order|bool Order object if successful or false. */ function wc_get_customer_last_order( $customer_id ) { + $customer = new WC_Customer( $customer_id ); + + return $customer->get_last_order(); +} + +/** + * Add support for searching by display_name. + * + * @since 3.2.0 + * @param array $search_columns Column names. + * @return array + */ +function wc_user_search_columns( $search_columns ) { + $search_columns[] = 'display_name'; + return $search_columns; +} +add_filter( 'user_search_columns', 'wc_user_search_columns' ); + +/** + * When a user is deleted in WordPress, delete corresponding WooCommerce data. + * + * @param int $user_id User ID being deleted. + */ +function wc_delete_user_data( $user_id ) { global $wpdb; - $customer_id = absint( $customer_id ); + // Clean up sessions. + $wpdb->delete( + $wpdb->prefix . 'woocommerce_sessions', + array( + 'session_key' => $user_id, + ) + ); - $id = $wpdb->get_var( "SELECT id - FROM $wpdb->posts AS posts - LEFT JOIN {$wpdb->postmeta} AS meta on posts.ID = meta.post_id - WHERE meta.meta_key = '_customer_user' - AND meta.meta_value = {$customer_id} - AND posts.post_type = 'shop_order' - AND posts.post_status IN ( '" . implode( "','", array_keys( wc_get_order_statuses() ) ) . "' ) - ORDER BY posts.ID DESC - " ); + // Revoke API keys. + $wpdb->delete( + $wpdb->prefix . 'woocommerce_api_keys', + array( + 'user_id' => $user_id, + ) + ); - return wc_get_order( $id ); + // Clean up payment tokens. + $payment_tokens = WC_Payment_Tokens::get_customer_tokens( $user_id ); + + foreach ( $payment_tokens as $payment_token ) { + $payment_token->delete(); + } +} +add_action( 'delete_user', 'wc_delete_user_data' ); + +/** + * Store user agents. Used for tracker. + * + * @since 3.0.0 + * @param string $user_login User login. + * @param int|object $user User. + */ +function wc_maybe_store_user_agent( $user_login, $user ) { + if ( 'yes' === get_option( 'woocommerce_allow_tracking', 'no' ) && user_can( $user, 'manage_woocommerce' ) ) { + $admin_user_agents = array_filter( (array) get_option( 'woocommerce_tracker_ua', array() ) ); + $admin_user_agents[] = wc_get_user_agent(); + update_option( 'woocommerce_tracker_ua', array_unique( $admin_user_agents ) ); + } +} +add_action( 'wp_login', 'wc_maybe_store_user_agent', 10, 2 ); + +/** + * Update logic triggered on login. + * + * @since 3.4.0 + * @param string $user_login User login. + * @param object $user User. + */ +function wc_user_logged_in( $user_login, $user ) { + wc_update_user_last_active( $user->ID ); + update_user_meta( $user->ID, '_woocommerce_load_saved_cart_after_login', 1 ); +} +add_action( 'wp_login', 'wc_user_logged_in', 10, 2 ); + +/** + * Update when the user was last active. + * + * @since 3.4.0 + */ +function wc_current_user_is_active() { + if ( ! is_user_logged_in() ) { + return; + } + wc_update_user_last_active( get_current_user_id() ); +} +add_action( 'wp', 'wc_current_user_is_active', 10 ); + +/** + * Set the user last active timestamp to now. + * + * @since 3.4.0 + * @param int $user_id User ID to mark active. + */ +function wc_update_user_last_active( $user_id ) { + if ( ! $user_id ) { + return; + } + update_user_meta( $user_id, 'wc_last_active', (string) strtotime( date( 'Y-m-d', current_time( 'timestamp', true ) ) ) ); } diff --git a/includes/wc-webhook-functions.php b/includes/wc-webhook-functions.php index 0dafe6a93d4..23361fb976c 100644 --- a/includes/wc-webhook-functions.php +++ b/includes/wc-webhook-functions.php @@ -2,14 +2,79 @@ /** * WooCommerce Webhook functions * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.3.0 + * @package WooCommerce/Functions + * @version 3.3.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly +defined( 'ABSPATH' ) || exit; + +/** + * Process webhook delivery. + * + * @since 3.3.0 + * @param WC_Webhook $webhook Webhook instance. + * @param array $arg Delivery arguments. + */ +function wc_webhook_process_delivery( $webhook, $arg ) { + // Webhooks are processed in the background by default + // so as to avoid delays or failures in delivery from affecting the + // user who triggered it. + if ( apply_filters( 'woocommerce_webhook_deliver_async', true, $webhook, $arg ) ) { + // Deliver in background. + WC()->queue()->add( 'woocommerce_deliver_webhook_async', array( 'webhook_id' => $webhook->get_id(), 'arg' => $arg ), 'woocommerce-webhooks' ); + } else { + // Deliver immediately. + $webhook->deliver( $arg ); + } +} +add_action( 'woocommerce_webhook_process_delivery', 'wc_webhook_process_delivery', 10, 2 ); + +/** + * Wrapper function to execute the `woocommerce_deliver_webhook_async` cron. + * hook, see WC_Webhook::process(). + * + * @since 2.2.0 + * @param int $webhook_id Webhook ID to deliver. + * @throws Exception If webhook cannot be read/found and $data parameter of WC_Webhook class constructor is set. + * @param mixed $arg Hook argument. + */ +function wc_deliver_webhook_async( $webhook_id, $arg ) { + $webhook = new WC_Webhook( $webhook_id ); + $webhook->deliver( $arg ); +} +add_action( 'woocommerce_deliver_webhook_async', 'wc_deliver_webhook_async', 10, 2 ); + +/** + * 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; } /** @@ -25,3 +90,37 @@ function wc_get_webhook_statuses() { 'disabled' => __( 'Disabled', 'woocommerce' ), ) ); } + +/** + * Load webhooks. + * + * @since 3.3.0 + * @throws Exception If webhook cannot be read/found and $data parameter of WC_Webhook class constructor is set. + * @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|WC_Webhook $id Webhook ID or object. + * @throws Exception If webhook cannot be read/found and $data parameter of WC_Webhook class constructor is set. + * @return WC_Webhook|null + */ +function wc_get_webhook( $id ) { + $webhook = new WC_Webhook( $id ); + + return 0 !== $webhook->get_id() ? $webhook : null; +} diff --git a/includes/wc-widget-functions.php b/includes/wc-widget-functions.php index e4b374d0560..2972680371f 100644 --- a/includes/wc-widget-functions.php +++ b/includes/wc-widget-functions.php @@ -4,10 +4,8 @@ * * Widget related functions and widget registration. * - * @author WooThemes - * @category Core - * @package WooCommerce/Functions - * @version 2.3.0 + * @package WooCommerce/Functions + * @version 2.3.0 */ if ( ! defined( 'ABSPATH' ) ) { @@ -15,19 +13,19 @@ if ( ! defined( 'ABSPATH' ) ) { } // Include widget classes. -include_once( dirname( __FILE__ ) . '/abstracts/abstract-wc-widget.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-cart.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-layered-nav-filters.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-layered-nav.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-price-filter.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-product-categories.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-product-search.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-product-tag-cloud.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-products.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-rating-filter.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-recent-reviews.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-recently-viewed.php' ); -include_once( dirname( __FILE__ ) . '/widgets/class-wc-widget-top-rated-products.php' ); +require_once dirname( __FILE__ ) . '/abstracts/abstract-wc-widget.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-cart.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-layered-nav-filters.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-layered-nav.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-price-filter.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-product-categories.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-product-search.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-product-tag-cloud.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-products.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-rating-filter.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-recent-reviews.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-recently-viewed.php'; +require_once dirname( __FILE__ ) . '/widgets/class-wc-widget-top-rated-products.php'; /** * Register Widgets. diff --git a/includes/widgets/class-wc-widget-cart.php b/includes/widgets/class-wc-widget-cart.php index f7f359b8891..e699476d135 100644 --- a/includes/widgets/class-wc-widget-cart.php +++ b/includes/widgets/class-wc-widget-cart.php @@ -1,19 +1,17 @@ widget_cssclass = 'woocommerce widget_shopping_cart'; - $this->widget_description = __( "Display the user's cart in the sidebar.", 'woocommerce' ); + $this->widget_description = __( 'Display the customer shopping cart.', 'woocommerce' ); $this->widget_id = 'woocommerce_widget_cart'; - $this->widget_name = __( 'WooCommerce cart', 'woocommerce' ); + $this->widget_name = __( 'Cart', 'woocommerce' ); $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => __( 'Cart', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), @@ -46,8 +44,8 @@ class WC_Widget_Cart extends WC_Widget { * * @see WP_Widget * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { if ( apply_filters( 'woocommerce_widget_cart_is_hidden', is_cart() || is_checkout() ) ) { @@ -62,7 +60,7 @@ class WC_Widget_Cart extends WC_Widget { echo '
          '; } - // Insert cart widget placeholder - code in woocommerce.js will update this on page load + // Insert cart widget placeholder - code in woocommerce.js will update this on page load. echo '
          '; if ( $hide_if_empty ) { diff --git a/includes/widgets/class-wc-widget-layered-nav-filters.php b/includes/widgets/class-wc-widget-layered-nav-filters.php index 1d85c6e7404..1f9d1df071d 100644 --- a/includes/widgets/class-wc-widget-layered-nav-filters.php +++ b/includes/widgets/class-wc-widget-layered-nav-filters.php @@ -1,17 +1,15 @@ widget_cssclass = 'woocommerce widget_layered_nav_filters'; - $this->widget_description = __( 'Shows active layered nav filters so users can see and deactivate them.', 'woocommerce' ); + $this->widget_description = __( 'Display a list of active product filters.', 'woocommerce' ); $this->widget_id = 'woocommerce_layered_nav_filters'; - $this->widget_name = __( 'WooCommerce layered nav filters', 'woocommerce' ); + $this->widget_name = __( 'Active Product Filters', 'woocommerce' ); $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => __( 'Active filters', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), @@ -34,90 +32,23 @@ class WC_Widget_Layered_Nav_Filters extends WC_Widget { parent::__construct(); } - /** - * Get current page URL for layered nav items. - * - * @return string - */ - protected function get_page_base_url() { - if ( defined( 'SHOP_IS_ON_FRONT' ) ) { - $link = home_url(); - } elseif ( is_post_type_archive( 'product' ) || is_page( wc_get_page_id( 'shop' ) ) ) { - $link = get_post_type_archive_link( 'product' ); - } elseif ( is_product_category() ) { - $link = get_term_link( get_query_var( 'product_cat' ), 'product_cat' ); - } elseif ( is_product_tag() ) { - $link = get_term_link( get_query_var( 'product_tag' ), 'product_tag' ); - } else { - $queried_object = get_queried_object(); - $link = get_term_link( $queried_object->slug, $queried_object->taxonomy ); - } - - // Min/Max - if ( isset( $_GET['min_price'] ) ) { - $link = add_query_arg( 'min_price', wc_clean( $_GET['min_price'] ), $link ); - } - - if ( isset( $_GET['max_price'] ) ) { - $link = add_query_arg( 'max_price', wc_clean( $_GET['max_price'] ), $link ); - } - - // Orderby - if ( isset( $_GET['orderby'] ) ) { - $link = add_query_arg( 'orderby', wc_clean( $_GET['orderby'] ), $link ); - } - - /** - * Search Arg. - * To support quote characters, first they are decoded from " entities, then URL encoded. - */ - if ( get_search_query() ) { - $link = add_query_arg( 's', rawurlencode( htmlspecialchars_decode( get_search_query() ) ), $link ); - } - - // Post Type Arg - if ( isset( $_GET['post_type'] ) ) { - $link = add_query_arg( 'post_type', wc_clean( $_GET['post_type'] ), $link ); - } - - // Min Rating Arg - if ( isset( $_GET['rating_filter'] ) ) { - $link = add_query_arg( 'rating_filter', wc_clean( $_GET['rating_filter'] ), $link ); - } - - // All current filters - if ( $_chosen_attributes = WC_Query::get_layered_nav_chosen_attributes() ) { - foreach ( $_chosen_attributes as $name => $data ) { - $filter_name = sanitize_title( str_replace( 'pa_', '', $name ) ); - if ( ! empty( $data['terms'] ) ) { - $link = add_query_arg( 'filter_' . $filter_name, implode( ',', $data['terms'] ), $link ); - } - if ( 'or' == $data['query_type'] ) { - $link = add_query_arg( 'query_type_' . $filter_name, 'or', $link ); - } - } - } - - return $link; - } - /** * Output widget. * * @see WP_Widget - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { - if ( ! is_post_type_archive( 'product' ) && ! is_tax( get_object_taxonomies( 'product' ) ) ) { + if ( ! is_shop() && ! is_product_taxonomy() ) { return; } $_chosen_attributes = WC_Query::get_layered_nav_chosen_attributes(); - $min_price = isset( $_GET['min_price'] ) ? wc_clean( $_GET['min_price'] ) : 0; - $max_price = isset( $_GET['max_price'] ) ? wc_clean( $_GET['max_price'] ) : 0; - $rating_filter = isset( $_GET['rating_filter'] ) ? array_filter( array_map( 'absint', explode( ',', $_GET['rating_filter'] ) ) ) : array(); - $base_link = $this->get_page_base_url(); + $min_price = isset( $_GET['min_price'] ) ? wc_clean( wp_unslash( $_GET['min_price'] ) ) : 0; // WPCS: input var ok, CSRF ok. + $max_price = isset( $_GET['max_price'] ) ? wc_clean( wp_unslash( $_GET['max_price'] ) ) : 0; // WPCS: input var ok, CSRF ok. + $rating_filter = isset( $_GET['rating_filter'] ) ? array_filter( array_map( 'absint', explode( ',', wp_unslash( $_GET['rating_filter'] ) ) ) ) : array(); // WPCS: sanitization ok, input var ok, CSRF ok. + $base_link = $this->get_current_page_url(); if ( 0 < count( $_chosen_attributes ) || 0 < $min_price || 0 < $max_price || ! empty( $rating_filter ) ) { @@ -125,45 +56,50 @@ class WC_Widget_Layered_Nav_Filters extends WC_Widget { echo '
            '; - // Attributes + // Attributes. if ( ! empty( $_chosen_attributes ) ) { foreach ( $_chosen_attributes as $taxonomy => $data ) { foreach ( $data['terms'] as $term_slug ) { - if ( ! $term = get_term_by( 'slug', $term_slug, $taxonomy ) ) { + $term = get_term_by( 'slug', $term_slug, $taxonomy ); + if ( ! $term ) { continue; } $filter_name = 'filter_' . sanitize_title( str_replace( 'pa_', '', $taxonomy ) ); - $current_filter = isset( $_GET[ $filter_name ] ) ? explode( ',', wc_clean( $_GET[ $filter_name ] ) ) : array(); + $current_filter = isset( $_GET[ $filter_name ] ) ? explode( ',', wc_clean( wp_unslash( $_GET[ $filter_name ] ) ) ) : array(); // WPCS: input var ok, CSRF ok. $current_filter = array_map( 'sanitize_title', $current_filter ); - $new_filter = array_diff( $current_filter, array( $term_slug ) ); + $new_filter = array_diff( $current_filter, array( $term_slug ) ); $link = remove_query_arg( array( 'add-to-cart', $filter_name ), $base_link ); - if ( sizeof( $new_filter ) > 0 ) { + if ( count( $new_filter ) > 0 ) { $link = add_query_arg( $filter_name, implode( ',', $new_filter ), $link ); } - echo '
          • ' . esc_html( $term->name ) . '
            • '; + echo '
          • ' . esc_html( $term->name ) . '
            • '; } } } if ( $min_price ) { $link = remove_query_arg( 'min_price', $base_link ); - echo '
          • ' . sprintf( __( 'Min %s', 'woocommerce' ), wc_price( $min_price ) ) . '
            • '; + /* translators: %s: minimum price */ + echo '
          • ' . sprintf( __( 'Min %s', 'woocommerce' ), wc_price( $min_price ) ) . '
            • '; // WPCS: XSS ok. } if ( $max_price ) { $link = remove_query_arg( 'max_price', $base_link ); - echo '
          • ' . sprintf( __( 'Max %s', 'woocommerce' ), wc_price( $max_price ) ) . '
            • '; + /* translators: %s: maximum price */ + echo '
          • ' . sprintf( __( 'Max %s', 'woocommerce' ), wc_price( $max_price ) ) . '
            • '; // WPCS: XSS ok. } if ( ! empty( $rating_filter ) ) { foreach ( $rating_filter as $rating ) { $link_ratings = implode( ',', array_diff( $rating_filter, array( $rating ) ) ); $link = $link_ratings ? add_query_arg( 'rating_filter', $link_ratings ) : remove_query_arg( 'rating_filter', $base_link ); - echo '
          • ' . sprintf( esc_html__( 'Rated %s out of 5', 'woocommerce' ), esc_html( $rating ) ) . '
            • '; + + /* translators: %s: rating */ + echo '
          • ' . sprintf( esc_html__( 'Rated %s out of 5', 'woocommerce' ), esc_html( $rating ) ) . '
            • '; } } diff --git a/includes/widgets/class-wc-widget-layered-nav.php b/includes/widgets/class-wc-widget-layered-nav.php index e267c81b2e8..31b73654b2e 100644 --- a/includes/widgets/class-wc-widget-layered-nav.php +++ b/includes/widgets/class-wc-widget-layered-nav.php @@ -1,17 +1,15 @@ widget_cssclass = 'woocommerce widget_layered_nav woocommerce-widget-layered-nav'; - $this->widget_description = __( 'Shows a custom attribute in a widget which lets you narrow down the list of products when viewing product categories.', 'woocommerce' ); + $this->widget_description = __( 'Display a list of attributes to filter products in your store.', 'woocommerce' ); $this->widget_id = 'woocommerce_layered_nav'; - $this->widget_name = __( 'WooCommerce layered nav', 'woocommerce' ); + $this->widget_name = __( 'Filter Products by Attribute', 'woocommerce' ); parent::__construct(); } @@ -31,8 +29,8 @@ class WC_Widget_Layered_Nav extends WC_Widget { * * @see WP_Widget->update * - * @param array $new_instance - * @param array $old_instance + * @param array $new_instance New Instance. + * @param array $old_instance Old Instance. * * @return array */ @@ -46,7 +44,7 @@ class WC_Widget_Layered_Nav extends WC_Widget { * * @see WP_Widget->form * - * @param array $instance + * @param array $instance Instance. */ public function form( $instance ) { $this->init_settings(); @@ -69,12 +67,12 @@ class WC_Widget_Layered_Nav extends WC_Widget { } $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => __( 'Filter by', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), ), - 'attribute' => array( + 'attribute' => array( 'type' => 'select', 'std' => '', 'label' => __( 'Attribute', 'woocommerce' ), @@ -89,7 +87,7 @@ class WC_Widget_Layered_Nav extends WC_Widget { 'dropdown' => __( 'Dropdown', 'woocommerce' ), ), ), - 'query_type' => array( + 'query_type' => array( 'type' => 'select', 'std' => 'and', 'label' => __( 'Query type', 'woocommerce' ), @@ -106,11 +104,11 @@ class WC_Widget_Layered_Nav extends WC_Widget { * * @see WP_Widget * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Instance. */ public function widget( $args, $instance ) { - if ( ! is_post_type_archive( 'product' ) && ! is_tax( get_object_taxonomies( 'product' ) ) ) { + if ( ! is_shop() && ! is_product_taxonomy() ) { return; } @@ -128,33 +126,33 @@ class WC_Widget_Layered_Nav extends WC_Widget { $orderby = wc_attribute_orderby( $taxonomy ); switch ( $orderby ) { - case 'name' : + case 'name': $get_terms_args['orderby'] = 'name'; $get_terms_args['menu_order'] = false; - break; - case 'id' : + break; + case 'id': $get_terms_args['orderby'] = 'id'; $get_terms_args['order'] = 'ASC'; $get_terms_args['menu_order'] = false; - break; - case 'menu_order' : + break; + case 'menu_order': $get_terms_args['menu_order'] = 'ASC'; - break; + break; } $terms = get_terms( $taxonomy, $get_terms_args ); - if ( 0 === sizeof( $terms ) ) { + if ( 0 === count( $terms ) ) { return; } switch ( $orderby ) { - case 'name_num' : + case 'name_num': usort( $terms, '_wc_get_product_terms_name_num_usort_callback' ); - break; - case 'parent' : + break; + case 'parent': usort( $terms, '_wc_get_product_terms_parent_usort_callback' ); - break; + break; } ob_start(); @@ -171,7 +169,7 @@ class WC_Widget_Layered_Nav extends WC_Widget { $this->widget_end( $args ); - // Force found when option is selected - do not force found on taxonomy attributes + // Force found when option is selected - do not force found on taxonomy attributes. if ( ! is_tax() && is_array( $_chosen_attributes ) && array_key_exists( $taxonomy, $_chosen_attributes ) ) { $found = true; } @@ -179,12 +177,13 @@ class WC_Widget_Layered_Nav extends WC_Widget { if ( ! $found ) { ob_end_clean(); } else { - echo ob_get_clean(); + echo ob_get_clean(); // @codingStandardsIgnoreLine } } /** * Return the currently viewed taxonomy name. + * * @return string */ protected function get_current_taxonomy() { @@ -193,6 +192,7 @@ class WC_Widget_Layered_Nav extends WC_Widget { /** * Return the currently viewed term ID. + * * @return int */ protected function get_current_term_id() { @@ -201,6 +201,7 @@ class WC_Widget_Layered_Nav extends WC_Widget { /** * Return the currently viewed term slug. + * * @return int */ protected function get_current_term_slug() { @@ -209,9 +210,10 @@ class WC_Widget_Layered_Nav extends WC_Widget { /** * Show dropdown layered nav. - * @param array $terms - * @param string $taxonomy - * @param string $query_type + * + * @param array $terms Terms. + * @param string $taxonomy Taxonomy. + * @param string $query_type Query Type. * @return bool Will nav display? */ protected function layered_nav_dropdown( $terms, $taxonomy, $query_type ) { @@ -223,9 +225,11 @@ class WC_Widget_Layered_Nav extends WC_Widget { $_chosen_attributes = WC_Query::get_layered_nav_chosen_attributes(); $taxonomy_filter_name = str_replace( 'pa_', '', $taxonomy ); $taxonomy_label = wc_attribute_label( $taxonomy ); - $any_label = apply_filters( 'woocommerce_layered_nav_any_label', sprintf( __( 'Any %s', 'woocommerce' ), $taxonomy_label ), $taxonomy_label, $taxonomy ); - $multiple = 'or' === $query_type; - $current_values = isset( $_chosen_attributes[ $taxonomy ]['terms'] ) ? $_chosen_attributes[ $taxonomy ]['terms'] : array(); + + /* translators: %s: taxonomy name */ + $any_label = apply_filters( 'woocommerce_layered_nav_any_label', sprintf( __( 'Any %s', 'woocommerce' ), $taxonomy_label ), $taxonomy_label, $taxonomy ); + $multiple = 'or' === $query_type; + $current_values = isset( $_chosen_attributes[ $taxonomy ]['terms'] ) ? $_chosen_attributes[ $taxonomy ]['terms'] : array(); if ( '' === get_option( 'permalink_structure' ) ) { $form_action = remove_query_arg( array( 'page', 'paged' ), add_query_arg( $wp->query_string, '', home_url( $wp->request ) ) ); @@ -239,29 +243,29 @@ class WC_Widget_Layered_Nav extends WC_Widget { foreach ( $terms as $term ) { - // If on a term page, skip that term in widget list + // If on a term page, skip that term in widget list. if ( $term->term_id === $this->get_current_term_id() ) { continue; } - // Get count based on current view - $option_is_set = in_array( $term->slug, $current_values ); - $count = isset( $term_counts[ $term->term_id ] ) ? $term_counts[ $term->term_id ] : 0; + // Get count based on current view. + $option_is_set = in_array( $term->slug, $current_values, true ); + $count = isset( $term_counts[ $term->term_id ] ) ? $term_counts[ $term->term_id ] : 0; - // Only show options with count > 0 + // Only show options with count > 0. if ( 0 < $count ) { $found = true; } elseif ( 0 === $count && ! $option_is_set ) { continue; } - echo ''; + echo ''; } echo ''; if ( $multiple ) { - echo ''; + echo ''; } if ( 'or' === $query_type ) { @@ -269,10 +273,11 @@ class WC_Widget_Layered_Nav extends WC_Widget { } echo ''; - echo wc_query_string_form_fields( null, array( 'filter_' . $taxonomy_filter_name, 'query_type_' . $taxonomy_filter_name ), '', true ); + echo wc_query_string_form_fields( null, array( 'filter_' . $taxonomy_filter_name, 'query_type_' . $taxonomy_filter_name ), '', true ); // @codingStandardsIgnoreLine echo ''; - wc_enqueue_js( " + wc_enqueue_js( + " // Update value on change. jQuery( '.dropdown_layered_nav_" . esc_js( $taxonomy_filter_name ) . "' ).change( function() { var slug = jQuery( this ).val(); @@ -288,99 +293,34 @@ class WC_Widget_Layered_Nav extends WC_Widget { if ( jQuery().selectWoo ) { var wc_layered_nav_select = function() { jQuery( '.dropdown_layered_nav_" . esc_js( $taxonomy_filter_name ) . "' ).selectWoo( { - placeholder: '" . esc_html( $any_label ) . "', + placeholder: '" . wp_json_encode( (string) wp_specialchars_decode( $any_label, ENT_QUOTES ) ) . "', minimumResultsForSearch: 5, - width: '100%' + width: '100%', + allowClear: " . ( $multiple ? 'false' : 'true' ) . ", + language: { + noResults: function() { + return '" . esc_js( _x( 'No matches found', 'enhanced select', 'woocommerce' ) ) . "'; + } + } } ); }; wc_layered_nav_select(); } - " ); + " + ); } return $found; } - /** - * Get current page URL for layered nav items. - * - * @param string $taxonomy - * - * @return string - */ - protected function get_page_base_url( $taxonomy ) { - if ( defined( 'SHOP_IS_ON_FRONT' ) ) { - $link = home_url(); - } elseif ( is_post_type_archive( 'product' ) || is_page( wc_get_page_id( 'shop' ) ) ) { - $link = get_post_type_archive_link( 'product' ); - } elseif ( is_product_category() ) { - $link = get_term_link( get_query_var( 'product_cat' ), 'product_cat' ); - } elseif ( is_product_tag() ) { - $link = get_term_link( get_query_var( 'product_tag' ), 'product_tag' ); - } else { - $queried_object = get_queried_object(); - $link = get_term_link( $queried_object->slug, $queried_object->taxonomy ); - } - - // Min/Max - if ( isset( $_GET['min_price'] ) ) { - $link = add_query_arg( 'min_price', wc_clean( $_GET['min_price'] ), $link ); - } - - if ( isset( $_GET['max_price'] ) ) { - $link = add_query_arg( 'max_price', wc_clean( $_GET['max_price'] ), $link ); - } - - // Orderby - if ( isset( $_GET['orderby'] ) ) { - $link = add_query_arg( 'orderby', wc_clean( $_GET['orderby'] ), $link ); - } - - /** - * Search Arg. - * To support quote characters, first they are decoded from " entities, then URL encoded. - */ - if ( get_search_query() ) { - $link = add_query_arg( 's', rawurlencode( htmlspecialchars_decode( get_search_query() ) ), $link ); - } - - // Post Type Arg - if ( isset( $_GET['post_type'] ) ) { - $link = add_query_arg( 'post_type', wc_clean( $_GET['post_type'] ), $link ); - } - - // Min Rating Arg - if ( isset( $_GET['rating_filter'] ) ) { - $link = add_query_arg( 'rating_filter', wc_clean( $_GET['rating_filter'] ), $link ); - } - - // All current filters - if ( $_chosen_attributes = WC_Query::get_layered_nav_chosen_attributes() ) { - foreach ( $_chosen_attributes as $name => $data ) { - if ( $name === $taxonomy ) { - continue; - } - $filter_name = sanitize_title( str_replace( 'pa_', '', $name ) ); - if ( ! empty( $data['terms'] ) ) { - $link = add_query_arg( 'filter_' . $filter_name, implode( ',', $data['terms'] ), $link ); - } - if ( 'or' == $data['query_type'] ) { - $link = add_query_arg( 'query_type_' . $filter_name, 'or', $link ); - } - } - } - - return $link; - } - /** * Count products within certain terms, taking the main WP query into consideration. * * This query allows counts to be generated based on the viewed products, not all products. * - * @param array $term_ids - * @param string $taxonomy - * @param string $query_type + * @param array $term_ids Term IDs. + * @param string $taxonomy Taxonomy. + * @param string $query_type Query Type. * @return array */ protected function get_filtered_term_product_counts( $term_ids, $taxonomy, $query_type ) { @@ -397,12 +337,12 @@ class WC_Widget_Layered_Nav extends WC_Widget { } } - $meta_query = new WP_Meta_Query( $meta_query ); - $tax_query = new WP_Tax_Query( $tax_query ); - $meta_query_sql = $meta_query->get_sql( 'post', $wpdb->posts, 'ID' ); - $tax_query_sql = $tax_query->get_sql( $wpdb->posts, 'ID' ); + $meta_query = new WP_Meta_Query( $meta_query ); + $tax_query = new WP_Tax_Query( $tax_query ); + $meta_query_sql = $meta_query->get_sql( 'post', $wpdb->posts, 'ID' ); + $tax_query_sql = $tax_query->get_sql( $wpdb->posts, 'ID' ); - // Generate query + // Generate query. $query = array(); $query['select'] = "SELECT COUNT( DISTINCT {$wpdb->posts}.ID ) as term_count, terms.term_id as term_count_id"; $query['from'] = "FROM {$wpdb->posts}"; @@ -412,30 +352,39 @@ class WC_Widget_Layered_Nav extends WC_Widget { INNER JOIN {$wpdb->terms} AS terms USING( term_id ) " . $tax_query_sql['join'] . $meta_query_sql['join']; - $query['where'] = " + $query['where'] = " WHERE {$wpdb->posts}.post_type IN ( 'product' ) - AND {$wpdb->posts}.post_status = 'publish' - " . $tax_query_sql['where'] . $meta_query_sql['where'] . " - AND terms.term_id IN (" . implode( ',', array_map( 'absint', $term_ids ) ) . ") - "; + AND {$wpdb->posts}.post_status = 'publish'" + . $tax_query_sql['where'] . $meta_query_sql['where'] . + 'AND terms.term_id IN (' . implode( ',', array_map( 'absint', $term_ids ) ) . ')'; - if ( $search = WC_Query::get_main_search_query_sql() ) { + $search = WC_Query::get_main_search_query_sql(); + if ( $search ) { $query['where'] .= ' AND ' . $search; } - $query['group_by'] = "GROUP BY terms.term_id"; + $query['group_by'] = 'GROUP BY terms.term_id'; $query = apply_filters( 'woocommerce_get_filtered_term_product_counts_query', $query ); $query = implode( ' ', $query ); // We have a query - let's see if cached results of this query already exist. $query_hash = md5( $query ); - $cached_counts = (array) get_transient( 'wc_layered_nav_counts' ); + + // Maybe store a transient of the count values. + $cache = apply_filters( 'woocommerce_layered_nav_count_maybe_cache', true ); + if ( true === $cache ) { + $cached_counts = (array) get_transient( 'wc_layered_nav_counts_' . sanitize_title( $taxonomy ) ); + } else { + $cached_counts = array(); + } if ( ! isset( $cached_counts[ $query_hash ] ) ) { - $results = $wpdb->get_results( $query, ARRAY_A ); + $results = $wpdb->get_results( $query, ARRAY_A ); // @codingStandardsIgnoreLine $counts = array_map( 'absint', wp_list_pluck( $results, 'term_count', 'term_count_id' ) ); $cached_counts[ $query_hash ] = $counts; - set_transient( 'wc_layered_nav_counts', $cached_counts, DAY_IN_SECONDS ); + if ( true === $cache ) { + set_transient( 'wc_layered_nav_counts_' . sanitize_title( $taxonomy ), $cached_counts, DAY_IN_SECONDS ); + } } return array_map( 'absint', (array) $cached_counts[ $query_hash ] ); @@ -444,13 +393,13 @@ class WC_Widget_Layered_Nav extends WC_Widget { /** * Show list based layered nav. * - * @param array $terms - * @param string $taxonomy - * @param string $query_type + * @param array $terms Terms. + * @param string $taxonomy Taxonomy. + * @param string $query_type Query Type. * @return bool Will nav display? */ protected function layered_nav_list( $terms, $taxonomy, $query_type ) { - // List display + // List display. echo '
              '; $term_counts = $this->get_filtered_term_product_counts( wp_list_pluck( $terms, 'term_id' ), $taxonomy, $query_type ); @@ -459,34 +408,34 @@ class WC_Widget_Layered_Nav extends WC_Widget { foreach ( $terms as $term ) { $current_values = isset( $_chosen_attributes[ $taxonomy ]['terms'] ) ? $_chosen_attributes[ $taxonomy ]['terms'] : array(); - $option_is_set = in_array( $term->slug, $current_values ); + $option_is_set = in_array( $term->slug, $current_values, true ); $count = isset( $term_counts[ $term->term_id ] ) ? $term_counts[ $term->term_id ] : 0; - // Skip the term for the current archive + // Skip the term for the current archive. if ( $this->get_current_term_id() === $term->term_id ) { continue; } - // Only show options with count > 0 + // Only show options with count > 0. if ( 0 < $count ) { $found = true; } elseif ( 0 === $count && ! $option_is_set ) { continue; } - $filter_name = 'filter_' . sanitize_title( str_replace( 'pa_', '', $taxonomy ) ); - $current_filter = isset( $_GET[ $filter_name ] ) ? explode( ',', wc_clean( $_GET[ $filter_name ] ) ) : array(); + $filter_name = 'filter_' . str_replace( 'pa_', '', $taxonomy ); + $current_filter = isset( $_GET[ $filter_name ] ) ? explode( ',', wc_clean( wp_unslash( $_GET[ $filter_name ] ) ) ) : array(); // WPCS: input var ok, CSRF ok. $current_filter = array_map( 'sanitize_title', $current_filter ); - if ( ! in_array( $term->slug, $current_filter ) ) { + if ( ! in_array( $term->slug, $current_filter, true ) ) { $current_filter[] = $term->slug; } - $link = $this->get_page_base_url( $taxonomy ); + $link = remove_query_arg( $filter_name, $this->get_current_page_url() ); // Add current filters to URL. foreach ( $current_filter as $key => $value ) { - // Exclude query arg for current term archive term + // Exclude query arg for current term archive term. if ( $value === $this->get_current_term_slug() ) { unset( $current_filter[ $key ] ); } @@ -498,17 +447,19 @@ class WC_Widget_Layered_Nav extends WC_Widget { } if ( ! empty( $current_filter ) ) { + asort( $current_filter ); $link = add_query_arg( $filter_name, implode( ',', $current_filter ), $link ); - // Add Query type Arg to URL - if ( 'or' === $query_type && ! ( 1 === sizeof( $current_filter ) && $option_is_set ) ) { + // Add Query type Arg to URL. + if ( 'or' === $query_type && ! ( 1 === count( $current_filter ) && $option_is_set ) ) { $link = add_query_arg( 'query_type_' . sanitize_title( str_replace( 'pa_', '', $taxonomy ) ), 'or', $link ); } + $link = str_replace( '%2C', ',', $link ); } if ( $count > 0 || $option_is_set ) { $link = esc_url( apply_filters( 'woocommerce_layered_nav_link', $link, $term, $taxonomy ) ); - $term_html = '' . esc_html( $term->name ) . ''; + $term_html = '' . esc_html( $term->name ) . ''; } else { $link = false; $term_html = '' . esc_html( $term->name ) . ''; diff --git a/includes/widgets/class-wc-widget-price-filter.php b/includes/widgets/class-wc-widget-price-filter.php index 47c62b71b69..45f41b90bcb 100644 --- a/includes/widgets/class-wc-widget-price-filter.php +++ b/includes/widgets/class-wc-widget-price-filter.php @@ -1,19 +1,17 @@ widget_cssclass = 'woocommerce widget_price_filter'; - $this->widget_description = __( 'Shows a price filter slider in a widget which lets you narrow down the list of shown products when viewing product categories.', 'woocommerce' ); + $this->widget_description = __( 'Display a slider to filter products in your store by price.', 'woocommerce' ); $this->widget_id = 'woocommerce_price_filter'; - $this->widget_name = __( 'WooCommerce price filter', 'woocommerce' ); + $this->widget_name = __( 'Filter Products by Price', 'woocommerce' ); $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => __( 'Filter by price', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), ), ); - $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min'; + $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min'; wp_register_script( 'accounting', WC()->plugin_url() . '/assets/js/accounting/accounting' . $suffix . '.js', array( 'jquery' ), '0.4.2' ); wp_register_script( 'wc-jquery-ui-touchpunch', WC()->plugin_url() . '/assets/js/jquery-ui-touch-punch/jquery-ui-touch-punch' . $suffix . '.js', array( 'jquery-ui-slider' ), WC_VERSION, true ); wp_register_script( 'wc-price-slider', WC()->plugin_url() . '/assets/js/frontend/price-slider' . $suffix . '.js', array( 'jquery-ui-slider', 'wc-jquery-ui-touchpunch', 'accounting' ), WC_VERSION, true ); - wp_localize_script( 'wc-price-slider', 'woocommerce_price_slider_params', array( - 'min_price' => isset( $_GET['min_price'] ) ? esc_attr( $_GET['min_price'] ) : '', - 'max_price' => isset( $_GET['max_price'] ) ? esc_attr( $_GET['max_price'] ) : '', - 'currency_format_num_decimals' => 0, - 'currency_format_symbol' => get_woocommerce_currency_symbol(), - 'currency_format_decimal_sep' => esc_attr( wc_get_price_decimal_separator() ), - 'currency_format_thousand_sep' => esc_attr( wc_get_price_thousand_separator() ), - 'currency_format' => esc_attr( str_replace( array( '%1$s', '%2$s' ), array( '%s', '%v' ), get_woocommerce_price_format() ) ), - ) ); + wp_localize_script( + 'wc-price-slider', 'woocommerce_price_slider_params', array( + 'currency_format_num_decimals' => 0, + 'currency_format_symbol' => get_woocommerce_currency_symbol(), + 'currency_format_decimal_sep' => esc_attr( wc_get_price_decimal_separator() ), + 'currency_format_thousand_sep' => esc_attr( wc_get_price_thousand_separator() ), + 'currency_format' => esc_attr( str_replace( array( '%1$s', '%2$s' ), array( '%s', '%v' ), get_woocommerce_price_format() ) ), + ) + ); + + if ( is_customize_preview() ) { + wp_enqueue_script( 'wc-price-slider' ); + } + parent::__construct(); } @@ -53,26 +56,23 @@ class WC_Widget_Price_Filter extends WC_Widget { * * @see WP_Widget * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { - global $wp, $wp_the_query; + global $wp; - if ( ! is_post_type_archive( 'product' ) && ! is_tax( get_object_taxonomies( 'product' ) ) ) { + if ( ! is_shop() && ! is_product_taxonomy() ) { return; } - if ( ! $wp_the_query->post_count ) { + if ( ! wc()->query->get_main_query()->post_count ) { return; } - $min_price = isset( $_GET['min_price'] ) ? esc_attr( $_GET['min_price'] ) : ''; - $max_price = isset( $_GET['max_price'] ) ? esc_attr( $_GET['max_price'] ) : ''; - wp_enqueue_script( 'wc-price-slider' ); - // Find min and max price in current result set + // Find min and max price in current result set. $prices = $this->get_filtered_price(); $min = floor( $prices->min_price ); $max = ceil( $prices->max_price ); @@ -84,28 +84,13 @@ class WC_Widget_Price_Filter extends WC_Widget { $this->widget_start( $args, $instance ); if ( '' === get_option( 'permalink_structure' ) ) { - $form_action = remove_query_arg( array( 'page', 'paged' ), add_query_arg( $wp->query_string, '', home_url( $wp->request ) ) ); + $form_action = remove_query_arg( array( 'page', 'paged', 'product-page' ), add_query_arg( $wp->query_string, '', home_url( $wp->request ) ) ); } else { $form_action = preg_replace( '%\/page/[0-9]+%', '', home_url( trailingslashit( $wp->request ) ) ); } - /** - * Adjust max if the store taxes are not displayed how they are stored. - * Min is left alone because the product may not be taxable. - * Kicks in when prices excluding tax are displayed including tax. - */ - if ( wc_tax_enabled() && 'incl' === get_option( 'woocommerce_tax_display_shop' ) && ! wc_prices_include_tax() ) { - $tax_classes = array_merge( array( '' ), WC_Tax::get_tax_classes() ); - $class_max = $max; - - foreach ( $tax_classes as $tax_class ) { - if ( $tax_rates = WC_Tax::get_rates( $tax_class ) ) { - $class_max = $max + WC_Tax::get_tax_total( WC_Tax::calc_exclusive_tax( $max, $tax_rates ) ); - } - } - - $max = $class_max; - } + $min_price = isset( $_GET['min_price'] ) ? wc_clean( wp_unslash( $_GET['min_price'] ) ) : apply_filters( 'woocommerce_price_filter_widget_min_amount', $min ); // WPCS: input var ok, CSRF ok. + $max_price = isset( $_GET['max_price'] ) ? wc_clean( wp_unslash( $_GET['max_price'] ) ) : apply_filters( 'woocommerce_price_filter_widget_max_amount', $max ); // WPCS: input var ok, CSRF ok. echo '
              @@ -121,19 +106,20 @@ class WC_Widget_Price_Filter extends WC_Widget {
          - '; + '; // WPCS: XSS ok. $this->widget_end( $args ); } /** * Get filtered min price for current products. + * * @return int */ protected function get_filtered_price() { - global $wpdb, $wp_the_query; + global $wpdb; - $args = $wp_the_query->query_vars; + $args = wc()->query->get_main_query()->query_vars; $tax_query = isset( $args['tax_query'] ) ? $args['tax_query'] : array(); $meta_query = isset( $args['meta_query'] ) ? $args['meta_query'] : array(); @@ -160,15 +146,18 @@ class WC_Widget_Price_Filter extends WC_Widget { $sql = "SELECT min( FLOOR( price_meta.meta_value ) ) as min_price, max( CEILING( price_meta.meta_value ) ) as max_price FROM {$wpdb->posts} "; $sql .= " LEFT JOIN {$wpdb->postmeta} as price_meta ON {$wpdb->posts}.ID = price_meta.post_id " . $tax_query_sql['join'] . $meta_query_sql['join']; $sql .= " WHERE {$wpdb->posts}.post_type IN ('" . implode( "','", array_map( 'esc_sql', apply_filters( 'woocommerce_price_filter_post_type', array( 'product' ) ) ) ) . "') - AND {$wpdb->posts}.post_status = 'publish' - AND price_meta.meta_key IN ('" . implode( "','", array_map( 'esc_sql', apply_filters( 'woocommerce_price_filter_meta_keys', array( '_price' ) ) ) ) . "') - AND price_meta.meta_value > '' "; + AND {$wpdb->posts}.post_status = 'publish' + AND price_meta.meta_key IN ('" . implode( "','", array_map( 'esc_sql', apply_filters( 'woocommerce_price_filter_meta_keys', array( '_price' ) ) ) ) . "') + AND price_meta.meta_value > '' "; $sql .= $tax_query_sql['where'] . $meta_query_sql['where']; - if ( $search = WC_Query::get_main_search_query_sql() ) { + $search = WC_Query::get_main_search_query_sql(); + if ( $search ) { $sql .= ' AND ' . $search; } - return $wpdb->get_row( $sql ); + $sql = apply_filters( 'woocommerce_price_filter_sql', $sql, $meta_query_sql, $tax_query_sql ); + + return $wpdb->get_row( $sql ); // WPCS: unprepared SQL ok. } } diff --git a/includes/widgets/class-wc-widget-product-categories.php b/includes/widgets/class-wc-widget-product-categories.php index 6ba8d22c3f3..48f61a863f1 100644 --- a/includes/widgets/class-wc-widget-product-categories.php +++ b/includes/widgets/class-wc-widget-product-categories.php @@ -1,17 +1,17 @@ widget_cssclass = 'woocommerce widget_product_categories'; $this->widget_description = __( 'A list or dropdown of product categories.', 'woocommerce' ); $this->widget_id = 'woocommerce_product_categories'; - $this->widget_name = __( 'WooCommerce product categories', 'woocommerce' ); + $this->widget_name = __( 'Product Categories', 'woocommerce' ); $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => __( 'Product categories', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), ), - 'orderby' => array( - 'type' => 'select', - 'std' => 'name', - 'label' => __( 'Order by', 'woocommerce' ), + 'orderby' => array( + 'type' => 'select', + 'std' => 'name', + 'label' => __( 'Order by', 'woocommerce' ), 'options' => array( 'order' => __( 'Category order', 'woocommerce' ), 'name' => __( 'Name', 'woocommerce' ), ), ), - 'dropdown' => array( + 'dropdown' => array( 'type' => 'checkbox', 'std' => 0, 'label' => __( 'Show as dropdown', 'woocommerce' ), ), - 'count' => array( + 'count' => array( 'type' => 'checkbox', 'std' => 0, 'label' => __( 'Show product counts', 'woocommerce' ), ), - 'hierarchical' => array( + 'hierarchical' => array( 'type' => 'checkbox', 'std' => 1, 'label' => __( 'Show hierarchy', 'woocommerce' ), @@ -72,11 +72,16 @@ class WC_Widget_Product_Categories extends WC_Widget { 'std' => 0, 'label' => __( 'Only show children of the current category', 'woocommerce' ), ), - 'hide_empty' => array( + 'hide_empty' => array( 'type' => 'checkbox', 'std' => 0, 'label' => __( 'Hide empty categories', 'woocommerce' ), ), + 'max_depth' => array( + 'type' => 'text', + 'std' => '', + 'label' => __( 'Maximum depth', 'woocommerce' ), + ), ); parent::__construct(); @@ -86,9 +91,8 @@ class WC_Widget_Product_Categories extends WC_Widget { * Output widget. * * @see WP_Widget - * - * @param array $args - * @param array $instance + * @param array $args Widget arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { global $wp_query, $post; @@ -99,86 +103,107 @@ class WC_Widget_Product_Categories extends WC_Widget { $dropdown = isset( $instance['dropdown'] ) ? $instance['dropdown'] : $this->settings['dropdown']['std']; $orderby = isset( $instance['orderby'] ) ? $instance['orderby'] : $this->settings['orderby']['std']; $hide_empty = isset( $instance['hide_empty'] ) ? $instance['hide_empty'] : $this->settings['hide_empty']['std']; - $dropdown_args = array( 'hide_empty' => $hide_empty ); - $list_args = array( 'show_count' => $count, 'hierarchical' => $hierarchical, 'taxonomy' => 'product_cat', 'hide_empty' => $hide_empty ); + $dropdown_args = array( + 'hide_empty' => $hide_empty, + ); + $list_args = array( + 'show_count' => $count, + 'hierarchical' => $hierarchical, + 'taxonomy' => 'product_cat', + 'hide_empty' => $hide_empty, + ); + $max_depth = absint( isset( $instance['max_depth'] ) ? $instance['max_depth'] : $this->settings['max_depth']['std'] ); - // Menu Order $list_args['menu_order'] = false; + $dropdown_args['depth'] = $max_depth; + $list_args['depth'] = $max_depth; + if ( 'order' === $orderby ) { $list_args['menu_order'] = 'asc'; } else { - $list_args['orderby'] = 'title'; + $list_args['orderby'] = 'title'; } - // Setup Current Category $this->current_cat = false; $this->cat_ancestors = array(); if ( is_tax( 'product_cat' ) ) { - $this->current_cat = $wp_query->queried_object; $this->cat_ancestors = get_ancestors( $this->current_cat->term_id, 'product_cat' ); } elseif ( is_singular( 'product' ) ) { + $terms = wc_get_product_terms( + $post->ID, 'product_cat', apply_filters( + 'woocommerce_product_categories_widget_product_terms_args', array( + 'orderby' => 'parent', + 'order' => 'DESC', + ) + ) + ); - $product_category = wc_get_product_terms( $post->ID, 'product_cat', apply_filters( 'woocommerce_product_categories_widget_product_terms_args', array( 'orderby' => 'parent' ) ) ); - - if ( ! empty( $product_category ) ) { - $this->current_cat = end( $product_category ); - $this->cat_ancestors = get_ancestors( $this->current_cat->term_id, 'product_cat' ); + if ( $terms ) { + $main_term = apply_filters( 'woocommerce_product_categories_widget_main_term', $terms[0], $terms ); + $this->current_cat = $main_term; + $this->cat_ancestors = get_ancestors( $main_term->term_id, 'product_cat' ); } } - // Show Siblings and Children Only + // Show Siblings and Children Only. if ( $show_children_only && $this->current_cat ) { - - // Top level is needed - $top_level = get_terms( - 'product_cat', - array( - 'fields' => 'ids', - 'parent' => 0, - 'hierarchical' => true, - 'hide_empty' => false, - ) - ); - - // Direct children are wanted - $direct_children = get_terms( - 'product_cat', - array( - 'fields' => 'ids', - 'parent' => $this->current_cat->term_id, - 'hierarchical' => true, - 'hide_empty' => false, - ) - ); - - // Gather siblings of ancestors - $siblings = array(); - if ( $this->cat_ancestors ) { - foreach ( $this->cat_ancestors as $ancestor ) { - $ancestor_siblings = get_terms( + if ( $hierarchical ) { + $include = array_merge( + $this->cat_ancestors, + array( $this->current_cat->term_id ), + get_terms( 'product_cat', array( 'fields' => 'ids', - 'parent' => $ancestor, - 'hierarchical' => false, + 'parent' => 0, + 'hierarchical' => true, 'hide_empty' => false, ) - ); - $siblings = array_merge( $siblings, $ancestor_siblings ); + ), + get_terms( + 'product_cat', + array( + 'fields' => 'ids', + 'parent' => $this->current_cat->term_id, + 'hierarchical' => true, + 'hide_empty' => false, + ) + ) + ); + // Gather siblings of ancestors. + if ( $this->cat_ancestors ) { + foreach ( $this->cat_ancestors as $ancestor ) { + $include = array_merge( + $include, get_terms( + 'product_cat', + array( + 'fields' => 'ids', + 'parent' => $ancestor, + 'hierarchical' => false, + 'hide_empty' => false, + ) + ) + ); + } } - } - - if ( $hierarchical ) { - $include = array_merge( $top_level, $this->cat_ancestors, $siblings, $direct_children, array( $this->current_cat->term_id ) ); } else { - $include = array_merge( $direct_children ); + // Direct children. + $include = get_terms( + 'product_cat', + array( + 'fields' => 'ids', + 'parent' => $this->current_cat->term_id, + 'hierarchical' => true, + 'hide_empty' => false, + ) + ); } - $dropdown_args['include'] = implode( ',', $include ); $list_args['include'] = implode( ',', $include ); + $dropdown_args['include'] = $list_args['include']; if ( empty( $include ) ) { return; @@ -194,21 +219,26 @@ class WC_Widget_Product_Categories extends WC_Widget { $this->widget_start( $args, $instance ); - // Dropdown if ( $dropdown ) { - $dropdown_defaults = array( - 'show_count' => $count, - 'hierarchical' => $hierarchical, - 'show_uncategorized' => 0, - 'orderby' => $orderby, - 'selected' => $this->current_cat ? $this->current_cat->slug : '', + wc_product_dropdown_categories( + apply_filters( + 'woocommerce_product_categories_widget_dropdown_args', wp_parse_args( + $dropdown_args, array( + 'show_count' => $count, + 'hierarchical' => $hierarchical, + 'show_uncategorized' => 0, + 'orderby' => $orderby, + 'selected' => $this->current_cat ? $this->current_cat->slug : '', + ) + ) + ) ); - $dropdown_args = wp_parse_args( $dropdown_args, $dropdown_defaults ); - // Stuck with this until a fix for https://core.trac.wordpress.org/ticket/13258 - wc_product_dropdown_categories( apply_filters( 'woocommerce_product_categories_widget_dropdown_args', $dropdown_args ) ); + wp_enqueue_script( 'selectWoo' ); + wp_enqueue_style( 'select2' ); - wc_enqueue_js( " + wc_enqueue_js( + " jQuery( '.dropdown_product_cat' ).change( function() { if ( jQuery(this).val() != '' ) { var this_page = ''; @@ -219,21 +249,39 @@ class WC_Widget_Product_Categories extends WC_Widget { this_page = home_url + '?product_cat=' + jQuery(this).val(); } location.href = this_page; + } else { + location.href = '" . esc_js( wc_get_page_permalink( 'shop' ) ) . "'; } }); - " ); - // List + if ( jQuery().selectWoo ) { + var wc_product_cat_select = function() { + jQuery( '.dropdown_product_cat' ).selectWoo( { + placeholder: '" . esc_js( __( 'Select a category', 'woocommerce' ) ) . "', + minimumResultsForSearch: 5, + width: '100%', + allowClear: true, + language: { + noResults: function() { + return '" . esc_js( _x( 'No matches found', 'enhanced select', 'woocommerce' ) ) . "'; + } + } + } ); + }; + wc_product_cat_select(); + } + " + ); } else { + include_once WC()->plugin_path() . '/includes/walkers/class-wc-product-cat-list-walker.php'; - include_once( WC()->plugin_path() . '/includes/walkers/class-product-cat-list-walker.php' ); - - $list_args['walker'] = new WC_Product_Cat_List_Walker; + $list_args['walker'] = new WC_Product_Cat_List_Walker(); $list_args['title_li'] = ''; $list_args['pad_counts'] = 1; $list_args['show_option_none'] = __( 'No product categories exist.', 'woocommerce' ); $list_args['current_category'] = ( $this->current_cat ) ? $this->current_cat->term_id : ''; $list_args['current_category_ancestors'] = $this->cat_ancestors; + $list_args['max_depth'] = $max_depth; echo '
            '; diff --git a/includes/widgets/class-wc-widget-product-search.php b/includes/widgets/class-wc-widget-product-search.php index ed3d0053e2c..2df11926494 100644 --- a/includes/widgets/class-wc-widget-product-search.php +++ b/includes/widgets/class-wc-widget-product-search.php @@ -1,17 +1,15 @@ widget_cssclass = 'woocommerce widget_product_search'; - $this->widget_description = __( 'A Search box for products only.', 'woocommerce' ); + $this->widget_description = __( 'A search form for your store.', 'woocommerce' ); $this->widget_id = 'woocommerce_product_search'; - $this->widget_name = __( 'WooCommerce product search', 'woocommerce' ); + $this->widget_name = __( 'Product Search', 'woocommerce' ); $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => '', 'label' => __( 'Title', 'woocommerce' ), @@ -39,8 +37,8 @@ class WC_Widget_Product_Search extends WC_Widget { * * @see WP_Widget * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { $this->widget_start( $args, $instance ); diff --git a/includes/widgets/class-wc-widget-product-tag-cloud.php b/includes/widgets/class-wc-widget-product-tag-cloud.php index a680aec2d72..d934366a096 100644 --- a/includes/widgets/class-wc-widget-product-tag-cloud.php +++ b/includes/widgets/class-wc-widget-product-tag-cloud.php @@ -1,17 +1,17 @@ widget_cssclass = 'woocommerce widget_product_tag_cloud'; - $this->widget_description = __( 'Your most used product tags in cloud format.', 'woocommerce' ); + $this->widget_description = __( 'A cloud of your most used product tags.', 'woocommerce' ); $this->widget_id = 'woocommerce_product_tag_cloud'; - $this->widget_name = __( 'WooCommerce product tags', 'woocommerce' ); + $this->widget_name = __( 'Product Tag Cloud', 'woocommerce' ); $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => __( 'Product tags', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), @@ -39,14 +39,14 @@ class WC_Widget_Product_Tag_Cloud extends WC_Widget { * * @see WP_Widget * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { - $current_taxonomy = $this->_get_current_taxonomy( $instance ); + $current_taxonomy = $this->get_current_taxonomy( $instance ); if ( empty( $instance['title'] ) ) { - $taxonomy = get_taxonomy( $current_taxonomy ); + $taxonomy = get_taxonomy( $current_taxonomy ); $instance['title'] = $taxonomy->labels->name; } @@ -54,10 +54,14 @@ class WC_Widget_Product_Tag_Cloud extends WC_Widget { echo '
            '; - wp_tag_cloud( apply_filters( 'woocommerce_product_tag_cloud_widget_args', array( - 'taxonomy' => $current_taxonomy, - 'topic_count_text_callback' => array( $this, '_topic_count_text' ), - ) ) ); + wp_tag_cloud( + apply_filters( + 'woocommerce_product_tag_cloud_widget_args', array( + 'taxonomy' => $current_taxonomy, + 'topic_count_text_callback' => array( $this, 'topic_count_text' ), + ) + ) + ); echo '
            '; @@ -67,22 +71,50 @@ class WC_Widget_Product_Tag_Cloud extends WC_Widget { /** * Return the taxonomy being displayed. * - * @param object $instance + * @param object $instance Widget instance. * @return string */ - public function _get_current_taxonomy( $instance ) { + public function get_current_taxonomy( $instance ) { return 'product_tag'; } /** * Returns topic count text. * - * @since 2.6.0 - * @param int $count + * @since 3.4.0 + * @param int $count Count text. * @return string */ - public function _topic_count_text( $count ) { + public function topic_count_text( $count ) { /* translators: %s: product count */ return sprintf( _n( '%s product', '%s products', $count, 'woocommerce' ), number_format_i18n( $count ) ); } + + // Ignore whole block to avoid warnings about PSR2.Methods.MethodDeclaration.Underscore violation. + // @codingStandardsIgnoreStart + /** + * Return the taxonomy being displayed. + * + * @deprecated 3.4.0 + * @param object $instance Widget instance. + * @return string + */ + public function _get_current_taxonomy( $instance ) { + wc_deprecated_function( '_get_current_taxonomy', '3.4.0', 'WC_Widget_Product_Tag_Cloud->get_current_taxonomy' ); + return $this->get_current_taxonomy( $instance ); + } + + /** + * Returns topic count text. + * + * @deprecated 3.4.0 + * @since 2.6.0 + * @param int $count Count text. + * @return string + */ + public function _topic_count_text( $count ) { + wc_deprecated_function( '_topic_count_text', '3.4.0', 'WC_Widget_Product_Tag_Cloud->topic_count_text' ); + return $this->topic_count_text( $count ); + } + // @codingStandardsIgnoreEnd } diff --git a/includes/widgets/class-wc-widget-products.php b/includes/widgets/class-wc-widget-products.php index 4d5195a9298..d3e5334594a 100644 --- a/includes/widgets/class-wc-widget-products.php +++ b/includes/widgets/class-wc-widget-products.php @@ -1,17 +1,15 @@ widget_cssclass = 'woocommerce widget_products'; - $this->widget_description = __( 'Display a list of your products on your site.', 'woocommerce' ); + $this->widget_description = __( "A list of your store's products.", 'woocommerce' ); $this->widget_id = 'woocommerce_products'; - $this->widget_name = __( 'WooCommerce products', 'woocommerce' ); + $this->widget_name = __( 'Products', 'woocommerce' ); $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => __( 'Products', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), ), - 'number' => array( + 'number' => array( 'type' => 'number', 'step' => 1, 'min' => 1, @@ -37,37 +35,37 @@ class WC_Widget_Products extends WC_Widget { 'std' => 5, 'label' => __( 'Number of products to show', 'woocommerce' ), ), - 'show' => array( - 'type' => 'select', - 'std' => '', - 'label' => __( 'Show', 'woocommerce' ), + 'show' => array( + 'type' => 'select', + 'std' => '', + 'label' => __( 'Show', 'woocommerce' ), 'options' => array( '' => __( 'All products', 'woocommerce' ), 'featured' => __( 'Featured products', 'woocommerce' ), 'onsale' => __( 'On-sale products', 'woocommerce' ), ), ), - 'orderby' => array( - 'type' => 'select', - 'std' => 'date', - 'label' => __( 'Order by', 'woocommerce' ), + 'orderby' => array( + 'type' => 'select', + 'std' => 'date', + 'label' => __( 'Order by', 'woocommerce' ), 'options' => array( - 'date' => __( 'Date', 'woocommerce' ), - 'price' => __( 'Price', 'woocommerce' ), - 'rand' => __( 'Random', 'woocommerce' ), - 'sales' => __( 'Sales', 'woocommerce' ), + 'date' => __( 'Date', 'woocommerce' ), + 'price' => __( 'Price', 'woocommerce' ), + 'rand' => __( 'Random', 'woocommerce' ), + 'sales' => __( 'Sales', 'woocommerce' ), ), ), - 'order' => array( - 'type' => 'select', - 'std' => 'desc', - 'label' => _x( 'Order', 'Sorting order', 'woocommerce' ), + 'order' => array( + 'type' => 'select', + 'std' => 'desc', + 'label' => _x( 'Order', 'Sorting order', 'woocommerce' ), 'options' => array( 'asc' => __( 'ASC', 'woocommerce' ), 'desc' => __( 'DESC', 'woocommerce' ), ), ), - 'hide_free' => array( + 'hide_free' => array( 'type' => 'checkbox', 'std' => 0, 'label' => __( 'Hide free products', 'woocommerce' ), @@ -84,15 +82,16 @@ class WC_Widget_Products extends WC_Widget { /** * Query the products and return them. - * @param array $args - * @param array $instance + * + * @param array $args Arguments. + * @param array $instance Widget instance. * @return WP_Query */ public function get_products( $args, $instance ) { - $number = ! empty( $instance['number'] ) ? absint( $instance['number'] ) : $this->settings['number']['std']; - $show = ! empty( $instance['show'] ) ? sanitize_title( $instance['show'] ) : $this->settings['show']['std']; + $number = ! empty( $instance['number'] ) ? absint( $instance['number'] ) : $this->settings['number']['std']; + $show = ! empty( $instance['show'] ) ? sanitize_title( $instance['show'] ) : $this->settings['show']['std']; $orderby = ! empty( $instance['orderby'] ) ? sanitize_title( $instance['orderby'] ) : $this->settings['orderby']['std']; - $order = ! empty( $instance['order'] ) ? sanitize_title( $instance['order'] ) : $this->settings['order']['std']; + $order = ! empty( $instance['order'] ) ? sanitize_title( $instance['order'] ) : $this->settings['order']['std']; $product_visibility_term_ids = wc_get_product_visibility_term_ids(); $query_args = array( @@ -105,7 +104,7 @@ class WC_Widget_Products extends WC_Widget { 'tax_query' => array( 'relation' => 'AND', ), - ); + ); // WPCS: slow query ok. if ( empty( $instance['show_hidden'] ) ) { $query_args['tax_query'][] = array( @@ -114,7 +113,7 @@ class WC_Widget_Products extends WC_Widget { 'terms' => is_search() ? $product_visibility_term_ids['exclude-from-search'] : $product_visibility_term_ids['exclude-from-catalog'], 'operator' => 'NOT IN', ); - $query_args['post_parent'] = 0; + $query_args['post_parent'] = 0; } if ( ! empty( $instance['hide_free'] ) ) { @@ -134,18 +133,18 @@ class WC_Widget_Products extends WC_Widget { 'terms' => $product_visibility_term_ids['outofstock'], 'operator' => 'NOT IN', ), - ); + ); // WPCS: slow query ok. } switch ( $show ) { - case 'featured' : + case 'featured': $query_args['tax_query'][] = array( 'taxonomy' => 'product_visibility', 'field' => 'term_taxonomy_id', 'terms' => $product_visibility_term_ids['featured'], ); break; - case 'onsale' : + case 'onsale': $product_ids_on_sale = wc_get_product_ids_on_sale(); $product_ids_on_sale[] = 0; $query_args['post__in'] = $product_ids_on_sale; @@ -153,19 +152,19 @@ class WC_Widget_Products extends WC_Widget { } switch ( $orderby ) { - case 'price' : - $query_args['meta_key'] = '_price'; + case 'price': + $query_args['meta_key'] = '_price'; // WPCS: slow query ok. $query_args['orderby'] = 'meta_value_num'; break; - case 'rand' : - $query_args['orderby'] = 'rand'; + case 'rand': + $query_args['orderby'] = 'rand'; break; - case 'sales' : - $query_args['meta_key'] = 'total_sales'; + case 'sales': + $query_args['meta_key'] = 'total_sales'; // WPCS: slow query ok. $query_args['orderby'] = 'meta_value_num'; break; - default : - $query_args['orderby'] = 'date'; + default: + $query_args['orderby'] = 'date'; } return new WP_Query( apply_filters( 'woocommerce_products_widget_query_args', $query_args ) ); @@ -176,8 +175,8 @@ class WC_Widget_Products extends WC_Widget { * * @see WP_Widget * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { if ( $this->get_cached_widget( $args ) ) { @@ -186,23 +185,29 @@ class WC_Widget_Products extends WC_Widget { ob_start(); - if ( ( $products = $this->get_products( $args, $instance ) ) && $products->have_posts() ) { + $products = $this->get_products( $args, $instance ); + if ( $products && $products->have_posts() ) { $this->widget_start( $args, $instance ); - echo apply_filters( 'woocommerce_before_widget_product_list', '
              ' ); + echo wp_kses_post( apply_filters( 'woocommerce_before_widget_product_list', '
                ' ) ); + + $template_args = array( + 'widget_id' => $args['widget_id'], + 'show_rating' => true, + ); while ( $products->have_posts() ) { $products->the_post(); - wc_get_template( 'content-widget-product.php', array( 'show_rating' => false ) ); + wc_get_template( 'content-widget-product.php', $template_args ); } - echo apply_filters( 'woocommerce_after_widget_product_list', '
              ' ); + echo wp_kses_post( apply_filters( 'woocommerce_after_widget_product_list', '
            ' ) ); $this->widget_end( $args ); } wp_reset_postdata(); - echo $this->cache_widget( $args, ob_get_clean() ); + echo $this->cache_widget( $args, ob_get_clean() ); // WPCS: XSS ok. } } diff --git a/includes/widgets/class-wc-widget-rating-filter.php b/includes/widgets/class-wc-widget-rating-filter.php index 3a78a8bd623..b9601cc9d64 100644 --- a/includes/widgets/class-wc-widget-rating-filter.php +++ b/includes/widgets/class-wc-widget-rating-filter.php @@ -1,18 +1,15 @@ widget_cssclass = 'woocommerce widget_rating_filter'; - $this->widget_description = __( 'Filter products by rating when viewing product archives and categories.', 'woocommerce' ); + $this->widget_description = __( 'Display a list of star ratings to filter products in your store.', 'woocommerce' ); $this->widget_id = 'woocommerce_rating_filter'; - $this->widget_name = __( 'WooCommerce average rating filter', 'woocommerce' ); + $this->widget_name = __( 'Filter Products by Rating', 'woocommerce' ); $this->settings = array( - 'title' => array( + 'title' => array( 'type' => 'text', 'std' => __( 'Average rating', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), @@ -34,65 +31,10 @@ class WC_Widget_Rating_Filter extends WC_Widget { parent::__construct(); } - /** - * Get current page URL for layered nav items. - * @return string - */ - protected function get_page_base_url() { - if ( defined( 'SHOP_IS_ON_FRONT' ) ) { - $link = home_url(); - } elseif ( is_post_type_archive( 'product' ) || is_page( wc_get_page_id( 'shop' ) ) ) { - $link = get_post_type_archive_link( 'product' ); - } else { - $link = get_term_link( get_query_var( 'term' ), get_query_var( 'taxonomy' ) ); - } - - // Min/Max - if ( isset( $_GET['min_price'] ) ) { - $link = add_query_arg( 'min_price', wc_clean( $_GET['min_price'] ), $link ); - } - - if ( isset( $_GET['max_price'] ) ) { - $link = add_query_arg( 'max_price', wc_clean( $_GET['max_price'] ), $link ); - } - - // Orderby - if ( isset( $_GET['orderby'] ) ) { - $link = add_query_arg( 'orderby', wc_clean( $_GET['orderby'] ), $link ); - } - - /** - * Search Arg. - * To support quote characters, first they are decoded from " entities, then URL encoded. - */ - if ( get_search_query() ) { - $link = add_query_arg( 's', rawurlencode( htmlspecialchars_decode( get_search_query() ) ), $link ); - } - - // Post Type Arg - if ( isset( $_GET['post_type'] ) ) { - $link = add_query_arg( 'post_type', wc_clean( $_GET['post_type'] ), $link ); - } - - // All current filters - if ( $_chosen_attributes = WC_Query::get_layered_nav_chosen_attributes() ) { - foreach ( $_chosen_attributes as $name => $data ) { - $filter_name = sanitize_title( str_replace( 'pa_', '', $name ) ); - if ( ! empty( $data['terms'] ) ) { - $link = add_query_arg( 'filter_' . $filter_name, implode( ',', $data['terms'] ), $link ); - } - if ( 'or' == $data['query_type'] ) { - $link = add_query_arg( 'query_type_' . $filter_name, 'or', $link ); - } - } - } - - return $link; - } - /** * Count products after other filters have occurred by adjusting the main query. - * @param int $rating + * + * @param int $rating Rating. * @return int */ protected function get_filtered_product_count( $rating ) { @@ -111,7 +53,7 @@ class WC_Widget_Rating_Filter extends WC_Widget { // Set new rating filter. $product_visibility_terms = wc_get_product_visibility_term_ids(); - $tax_query[] = array( + $tax_query[] = array( 'taxonomy' => 'product_visibility', 'field' => 'term_taxonomy_id', 'terms' => $product_visibility_terms[ 'rated-' . $rating ], @@ -129,36 +71,34 @@ class WC_Widget_Rating_Filter extends WC_Widget { $sql .= " WHERE {$wpdb->posts}.post_type = 'product' AND {$wpdb->posts}.post_status = 'publish' "; $sql .= $tax_query_sql['where'] . $meta_query_sql['where']; - if ( $search = WC_Query::get_main_search_query_sql() ) { + $search = WC_Query::get_main_search_query_sql(); + if ( $search ) { $sql .= ' AND ' . $search; } - return absint( $wpdb->get_var( $sql ) ); + return absint( $wpdb->get_var( $sql ) ); // WPCS: unprepared SQL ok. } /** - * widget function. + * Widget function. * * @see WP_Widget - * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { - global $wp_the_query; - - if ( ! is_post_type_archive( 'product' ) && ! is_tax( get_object_taxonomies( 'product' ) ) ) { + if ( ! is_shop() && ! is_product_taxonomy() ) { return; } - if ( ! $wp_the_query->post_count ) { + if ( ! wc()->query->get_main_query()->post_count ) { return; } ob_start(); $found = false; - $rating_filter = isset( $_GET['rating_filter'] ) ? array_filter( array_map( 'absint', explode( ',', $_GET['rating_filter'] ) ) ) : array(); + $rating_filter = isset( $_GET['rating_filter'] ) ? array_filter( array_map( 'absint', explode( ',', wp_unslash( $_GET['rating_filter'] ) ) ) ) : array(); // WPCS: input var ok, CSRF ok, sanitization ok. $this->widget_start( $args, $instance ); @@ -170,20 +110,20 @@ class WC_Widget_Rating_Filter extends WC_Widget { continue; } $found = true; - $link = $this->get_page_base_url(); + $link = $this->get_current_page_url(); - if ( in_array( $rating, $rating_filter ) ) { + if ( in_array( $rating, $rating_filter, true ) ) { $link_ratings = implode( ',', array_diff( $rating_filter, array( $rating ) ) ); } else { $link_ratings = implode( ',', array_merge( $rating_filter, array( $rating ) ) ); } - $class = in_array( $rating, $rating_filter ) ? 'wc-layered-nav-rating chosen' : 'wc-layered-nav-rating'; + $class = in_array( $rating, $rating_filter, true ) ? 'wc-layered-nav-rating chosen' : 'wc-layered-nav-rating'; $link = apply_filters( 'woocommerce_rating_filter_link', $link_ratings ? add_query_arg( 'rating_filter', $link_ratings ) : remove_query_arg( 'rating_filter' ) ); $rating_html = wc_get_star_rating_html( $rating ); $count_html = esc_html( apply_filters( 'woocommerce_rating_filter_count', "({$count})", $count, $rating ) ); - printf( '
          • %s %s
            • ', esc_attr( $class ), esc_url( $link ), $rating_html, $count_html ); + printf( '
          • %s %s
            • ', esc_attr( $class ), esc_url( $link ), $rating_html, $count_html ); // WPCS: XSS ok. } echo '
          '; @@ -193,7 +133,7 @@ class WC_Widget_Rating_Filter extends WC_Widget { if ( ! $found ) { ob_end_clean(); } else { - echo ob_get_clean(); + echo ob_get_clean(); // WPCS: XSS ok. } } } diff --git a/includes/widgets/class-wc-widget-recent-reviews.php b/includes/widgets/class-wc-widget-recent-reviews.php index c93ede254a0..c609610db3c 100644 --- a/includes/widgets/class-wc-widget-recent-reviews.php +++ b/includes/widgets/class-wc-widget-recent-reviews.php @@ -1,17 +1,15 @@ widget_cssclass = 'woocommerce widget_recent_reviews'; - $this->widget_description = __( 'Display a list of your most recent reviews on your site.', 'woocommerce' ); + $this->widget_description = __( 'Display a list of recent reviews from your store.', 'woocommerce' ); $this->widget_id = 'woocommerce_recent_reviews'; - $this->widget_name = __( 'WooCommerce recent reviews', 'woocommerce' ); + $this->widget_name = __( 'Recent Product Reviews', 'woocommerce' ); $this->settings = array( 'title' => array( 'type' => 'text', @@ -46,11 +44,10 @@ class WC_Widget_Recent_Reviews extends WC_Widget { * Output widget. * * @see WP_Widget - * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ - public function widget( $args, $instance ) { + public function widget( $args, $instance ) { global $comments, $comment; if ( $this->get_cached_widget( $args ) ) { @@ -60,41 +57,37 @@ class WC_Widget_Recent_Reviews extends WC_Widget { ob_start(); $number = ! empty( $instance['number'] ) ? absint( $instance['number'] ) : $this->settings['number']['std']; - $comments = get_comments( array( 'number' => $number, 'status' => 'approve', 'post_status' => 'publish', 'post_type' => 'product', 'parent' => 0 ) ); + $comments = get_comments( + array( + 'number' => $number, + 'status' => 'approve', + 'post_status' => 'publish', + 'post_type' => 'product', + 'parent' => 0, + ) + ); // WPCS: override ok. if ( $comments ) { $this->widget_start( $args, $instance ); - echo '
            '; + echo wp_kses_post( apply_filters( 'woocommerce_before_widget_product_review_list', '
              ' ) ); foreach ( (array) $comments as $comment ) { - - $_product = wc_get_product( $comment->comment_post_ID ); - - $rating = intval( get_comment_meta( $comment->comment_ID, 'rating', true ) ); - - $rating_html = wc_get_rating_html( $rating ); - - echo '
            • '; - - echo $_product->get_image() . wp_kses_post( $_product->get_name() ) . ''; - - echo $rating_html; - - /* translators: %s: review author */ - echo '' . sprintf( esc_html__( 'by %s', 'woocommerce' ), get_comment_author() ) . ''; - - echo '
              • '; + wc_get_template( 'content-widget-reviews.php', array( + 'comment' => $comment, + 'product' => wc_get_product( $comment->comment_post_ID ), + ) ); } - echo '
            '; + echo wp_kses_post( apply_filters( 'woocommerce_after_widget_product_review_list', '
          ' ) ); $this->widget_end( $args ); + } $content = ob_get_clean(); - echo $content; + echo $content; // WPCS: XSS ok. $this->cache_widget( $args, $content ); } diff --git a/includes/widgets/class-wc-widget-recently-viewed.php b/includes/widgets/class-wc-widget-recently-viewed.php index 69939da1b60..e5a8db3dc6a 100644 --- a/includes/widgets/class-wc-widget-recently-viewed.php +++ b/includes/widgets/class-wc-widget-recently-viewed.php @@ -1,17 +1,15 @@ widget_cssclass = 'woocommerce widget_recently_viewed_products'; - $this->widget_description = __( 'Display a list of recently viewed products.', 'woocommerce' ); + $this->widget_description = __( "Display a list of a customer's recently viewed products.", 'woocommerce' ); $this->widget_id = 'woocommerce_recently_viewed_products'; - $this->widget_name = __( 'WooCommerce recently viewed', 'woocommerce' ); + $this->widget_name = __( 'Recent Viewed Products', 'woocommerce' ); $this->settings = array( 'title' => array( 'type' => 'text', - 'std' => __( 'Recently viewed products', 'woocommerce' ), + 'std' => __( 'Recently Viewed Products', 'woocommerce' ), 'label' => __( 'Title', 'woocommerce' ), ), 'number' => array( 'type' => 'number', 'step' => 1, 'min' => 1, - 'max' => '', + 'max' => 15, 'std' => 10, 'label' => __( 'Number of products to show', 'woocommerce' ), ), @@ -46,13 +44,11 @@ class WC_Widget_Recently_Viewed extends WC_Widget { * Output widget. * * @see WP_Widget - * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { - - $viewed_products = ! empty( $_COOKIE['woocommerce_recently_viewed'] ) ? (array) explode( '|', $_COOKIE['woocommerce_recently_viewed'] ) : array(); + $viewed_products = ! empty( $_COOKIE['woocommerce_recently_viewed'] ) ? (array) explode( '|', wp_unslash( $_COOKIE['woocommerce_recently_viewed'] ) ) : array(); // @codingStandardsIgnoreLine $viewed_products = array_reverse( array_filter( array_map( 'absint', $viewed_products ) ) ); if ( empty( $viewed_products ) ) { @@ -80,23 +76,27 @@ class WC_Widget_Recently_Viewed extends WC_Widget { 'terms' => 'outofstock', 'operator' => 'NOT IN', ), - ); + ); // WPCS: slow query ok. } - $r = new WP_Query( $query_args ); + $r = new WP_Query( apply_filters( 'woocommerce_recently_viewed_products_widget_query_args', $query_args ) ); if ( $r->have_posts() ) { $this->widget_start( $args, $instance ); - echo apply_filters( 'woocommerce_before_widget_product_list', '
            ' ); + echo wp_kses_post( apply_filters( 'woocommerce_before_widget_product_list', '
              ' ) ); + + $template_args = array( + 'widget_id' => $args['widget_id'], + ); while ( $r->have_posts() ) { $r->the_post(); - wc_get_template( 'content-widget-product.php' ); + wc_get_template( 'content-widget-product.php', $template_args ); } - echo apply_filters( 'woocommerce_after_widget_product_list', '
            ' ); + echo wp_kses_post( apply_filters( 'woocommerce_after_widget_product_list', '
          ' ) ); $this->widget_end( $args ); } @@ -105,6 +105,6 @@ class WC_Widget_Recently_Viewed extends WC_Widget { $content = ob_get_clean(); - echo $content; + echo $content; // WPCS: XSS ok. } } diff --git a/includes/widgets/class-wc-widget-top-rated-products.php b/includes/widgets/class-wc-widget-top-rated-products.php index 70ee5671023..1717e6a1336 100644 --- a/includes/widgets/class-wc-widget-top-rated-products.php +++ b/includes/widgets/class-wc-widget-top-rated-products.php @@ -1,19 +1,16 @@ widget_cssclass = 'woocommerce widget_top_rated_products'; - $this->widget_description = __( 'Display a list of your top rated products on your site.', 'woocommerce' ); + $this->widget_description = __( "A list of your store's top-rated products.", 'woocommerce' ); $this->widget_id = 'woocommerce_top_rated_products'; - $this->widget_name = __( 'WooCommerce top rated products', 'woocommerce' ); + $this->widget_name = __( 'Products by Rating', 'woocommerce' ); $this->settings = array( 'title' => array( 'type' => 'text', @@ -48,9 +45,8 @@ class WC_Widget_Top_Rated_Products extends WC_Widget { * Output widget. * * @see WP_Widget - * - * @param array $args - * @param array $instance + * @param array $args Arguments. + * @param array $instance Widget instance. */ public function widget( $args, $instance ) { @@ -72,7 +68,7 @@ class WC_Widget_Top_Rated_Products extends WC_Widget { 'order' => 'DESC', 'meta_query' => WC()->query->get_meta_query(), 'tax_query' => WC()->query->get_tax_query(), - ); + ); // WPCS: slow query ok. $r = new WP_Query( $query_args ); @@ -80,14 +76,19 @@ class WC_Widget_Top_Rated_Products extends WC_Widget { $this->widget_start( $args, $instance ); - echo apply_filters( 'woocommerce_before_widget_product_list', '
            ' ); + echo wp_kses_post( apply_filters( 'woocommerce_before_widget_product_list', '
              ' ) ); + + $template_args = array( + 'widget_id' => $args['widget_id'], + 'show_rating' => true, + ); while ( $r->have_posts() ) { $r->the_post(); - wc_get_template( 'content-widget-product.php', array( 'show_rating' => true ) ); + wc_get_template( 'content-widget-product.php', $template_args ); } - echo apply_filters( 'woocommerce_after_widget_product_list', '
            ' ); + echo wp_kses_post( apply_filters( 'woocommerce_after_widget_product_list', '
          ' ) ); $this->widget_end( $args ); } @@ -96,7 +97,7 @@ class WC_Widget_Top_Rated_Products extends WC_Widget { $content = ob_get_clean(); - echo $content; + echo $content; // WPCS: XSS ok. $this->cache_widget( $args, $content ); } diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 00000000000..4fc6f7913f9 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,9375 @@ +{ + "name": "woocommerce", + "version": "3.4.0", + "lockfileVersion": 1, + "requires": true, + "dependencies": { + "@babel/code-frame": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.0.0-beta.49.tgz", + "integrity": "sha1-vs2AVIJzREDJ0TfkbXc0DmTX9Rs=", + "dev": true, + "requires": { + "@babel/highlight": "7.0.0-beta.49" + } + }, + "@babel/generator": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.0.0-beta.49.tgz", + "integrity": "sha1-6c/9qROZaszseTu8JauRvBnQv3o=", + "dev": true, + "requires": { + "@babel/types": "7.0.0-beta.49", + "jsesc": "^2.5.1", + "lodash": "^4.17.5", + "source-map": "^0.5.0", + "trim-right": "^1.0.1" + }, + "dependencies": { + "jsesc": { + "version": "2.5.1", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.1.tgz", + "integrity": "sha1-5CGiqOINawgZ3yiQj3glJrlt0f4=", + "dev": true + }, + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + } + } + }, + "@babel/helper-function-name": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/helper-function-name/-/helper-function-name-7.0.0-beta.49.tgz", + "integrity": "sha1-olwRGbnwNSeGcBJuAiXAMEHI3jI=", + "dev": true, + "requires": { + "@babel/helper-get-function-arity": "7.0.0-beta.49", + "@babel/template": "7.0.0-beta.49", + "@babel/types": "7.0.0-beta.49" + } + }, + "@babel/helper-get-function-arity": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/helper-get-function-arity/-/helper-get-function-arity-7.0.0-beta.49.tgz", + "integrity": "sha1-z1Aj8y0q2S0Ic3STnOwJUby1FEE=", + "dev": true, + "requires": { + "@babel/types": "7.0.0-beta.49" + } + }, + "@babel/helper-split-export-declaration": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/helper-split-export-declaration/-/helper-split-export-declaration-7.0.0-beta.49.tgz", + "integrity": "sha1-QNeO2glo0BGxxShm5XRs+yPldUg=", + "dev": true, + "requires": { + "@babel/types": "7.0.0-beta.49" + } + }, + "@babel/highlight": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.0.0-beta.49.tgz", + "integrity": "sha1-lr3GtD4TSCASumaRsQGEktOWIsw=", + "dev": true, + "requires": { + "chalk": "^2.0.0", + "esutils": "^2.0.2", + "js-tokens": "^3.0.0" + } + }, + "@babel/parser": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.0.0-beta.49.tgz", + "integrity": "sha1-lE0MW6KBK7FZ7b0iZ0Ov0mUXm9w=", + "dev": true + }, + "@babel/template": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.0.0-beta.49.tgz", + "integrity": "sha1-44q+ghfLl5P0YaUwbXrXRdg+HSc=", + "dev": true, + "requires": { + "@babel/code-frame": "7.0.0-beta.49", + "@babel/parser": "7.0.0-beta.49", + "@babel/types": "7.0.0-beta.49", + "lodash": "^4.17.5" + } + }, + "@babel/traverse": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.0.0-beta.49.tgz", + "integrity": "sha1-TypzaCoYM07WYl0QCo0nMZ98LWg=", + "dev": true, + "requires": { + "@babel/code-frame": "7.0.0-beta.49", + "@babel/generator": "7.0.0-beta.49", + "@babel/helper-function-name": "7.0.0-beta.49", + "@babel/helper-split-export-declaration": "7.0.0-beta.49", + "@babel/parser": "7.0.0-beta.49", + "@babel/types": "7.0.0-beta.49", + "debug": "^3.1.0", + "globals": "^11.1.0", + "invariant": "^2.2.0", + "lodash": "^4.17.5" + }, + "dependencies": { + "debug": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz", + "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==", + "dev": true, + "requires": { + "ms": "2.0.0" + } + }, + "globals": { + "version": "11.5.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-11.5.0.tgz", + "integrity": "sha512-hYyf+kI8dm3nORsiiXUQigOU62hDLfJ9G01uyGMxhc6BKsircrUhC4uJPQPUSuq2GrTmiiEt7ewxlMdBewfmKQ==", + "dev": true + } + } + }, + "@babel/types": { + "version": "7.0.0-beta.49", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.0.0-beta.49.tgz", + "integrity": "sha1-t+Oxw/TUz+Eb34yJ8e/V4WF7h6Y=", + "dev": true, + "requires": { + "esutils": "^2.0.2", + "lodash": "^4.17.5", + "to-fast-properties": "^2.0.0" + }, + "dependencies": { + "to-fast-properties": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-2.0.0.tgz", + "integrity": "sha1-3F5pjL0HkmW8c+A3doGk5Og/YW4=", + "dev": true + } + } + }, + "@mrmlnc/readdir-enhanced": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/@mrmlnc/readdir-enhanced/-/readdir-enhanced-2.2.1.tgz", + "integrity": "sha512-bPHp6Ji8b41szTOcaP63VlnbbO5Ny6dwAATtY6JTjh5N2OLrb5Qk/Th5cRkRQhkWCt+EJsYrNB0MiL+Gpn6e3g==", + "dev": true, + "requires": { + "call-me-maybe": "^1.0.1", + "glob-to-regexp": "^0.3.0" + } + }, + "@nodelib/fs.stat": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-1.1.0.tgz", + "integrity": "sha512-LAQ1d4OPfSJ/BMbI2DuizmYrrkD9JMaTdi2hQTlI53lQ4kRQPyZQRS4CYQ7O66bnBBnP/oYdRxbk++X0xuFU6A==", + "dev": true + }, + "abbrev": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.1.tgz", + "integrity": "sha1-+PLIh60Qv2f2NPAFtph/7TF5qsg=", + "dev": true + }, + "ajv": { + "version": "5.5.2", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-5.5.2.tgz", + "integrity": "sha1-c7Xuyj+rZT49P5Qis0GtQiBdyWU=", + "dev": true, + "requires": { + "co": "^4.6.0", + "fast-deep-equal": "^1.0.0", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.3.0" + } + }, + "ajv-keywords": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-3.2.0.tgz", + "integrity": "sha1-6GuBnGAs+IIa1jdBNpjx3sAhhHo=", + "dev": true + }, + "align-text": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/align-text/-/align-text-0.1.4.tgz", + "integrity": "sha1-DNkKVhCT810KmSVsIrcGlDP60Rc=", + "dev": true, + "requires": { + "kind-of": "^3.0.2", + "longest": "^1.0.1", + "repeat-string": "^1.5.2" + } + }, + "amdefine": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/amdefine/-/amdefine-1.0.1.tgz", + "integrity": "sha1-SlKCrBZHKek2Gbz9OtFR+BfOkfU=", + "dev": true + }, + "ansi-escapes": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-1.4.0.tgz", + "integrity": "sha1-06ioOzGapneTZisT52HHkRQiMG4=", + "dev": true + }, + "ansi-regex": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-2.1.1.tgz", + "integrity": "sha1-w7M6te42DYbg5ijwRorn7yfWVN8=", + "dev": true + }, + "ansi-styles": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.0.tgz", + "integrity": "sha1-wVm41b4PnlpvNG2rlPFs4CIWG4g=", + "dev": true, + "requires": { + "color-convert": "^1.9.0" + } + }, + "anymatch": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-1.3.2.tgz", + "integrity": "sha1-VT3Lj5HjyImEXf26NMd3IbkLnXo=", + "dev": true, + "optional": true, + "requires": { + "micromatch": "^2.1.5", + "normalize-path": "^2.0.0" + } + }, + "aproba": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/aproba/-/aproba-1.2.0.tgz", + "integrity": "sha512-Y9J6ZjXtoYh8RnXVCMOU/ttDmk1aBjunq9vO0ta5x85WDQiQfUF9sIPBITdbiiIVcBo03Hi3jMxigBtsddlXRw==", + "dev": true + }, + "are-we-there-yet": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/are-we-there-yet/-/are-we-there-yet-1.1.5.tgz", + "integrity": "sha512-5hYdAkZlcG8tOLujVDTgCT+uPX0VnpAH28gWsLfzpXYm7wP6mp5Q/gYyR7YQ0cKVJcXJnl3j2kpBan13PtQf6w==", + "dev": true, + "requires": { + "delegates": "^1.0.0", + "readable-stream": "^2.0.6" + } + }, + "argparse": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.9.tgz", + "integrity": "sha1-c9g7wmP4bpf4zE9rrhsOkKfSLIY=", + "dev": true, + "requires": { + "sprintf-js": "~1.0.2" + } + }, + "arr-diff": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/arr-diff/-/arr-diff-2.0.0.tgz", + "integrity": "sha1-jzuCf5Vai9ZpaX5KQlasPOrjVs8=", + "dev": true, + "requires": { + "arr-flatten": "^1.0.1" + } + }, + "arr-flatten": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/arr-flatten/-/arr-flatten-1.1.0.tgz", + "integrity": "sha1-NgSLv/TntH4TZkQxbJlmnqWukfE=", + "dev": true + }, + "arr-union": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/arr-union/-/arr-union-3.1.0.tgz", + "integrity": "sha1-45sJrqne+Gao8gbiiK9jkZuuOcQ=", + "dev": true + }, + "array-find-index": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/array-find-index/-/array-find-index-1.0.2.tgz", + "integrity": "sha1-3wEKoSh+Fku9pvlyOwqWoexBh6E=", + "dev": true + }, + "array-iterate": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/array-iterate/-/array-iterate-1.1.2.tgz", + "integrity": "sha512-1hWSHTIlG/8wtYD+PPX5AOBtKWngpDFjrsrHgZpe+JdgNGz0udYu6ZIkAa/xuenIUEqFv7DvE2Yr60jxweJSrQ==", + "dev": true + }, + "array-union": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/array-union/-/array-union-1.0.2.tgz", + "integrity": "sha1-mjRBDk9OPaI96jdb5b5w8kd47Dk=", + "dev": true, + "requires": { + "array-uniq": "^1.0.1" + } + }, + "array-uniq": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/array-uniq/-/array-uniq-1.0.3.tgz", + "integrity": "sha1-r2rId6Jcx/dOBYiUdThY39sk/bY=", + "dev": true + }, + "array-unique": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/array-unique/-/array-unique-0.2.1.tgz", + "integrity": "sha1-odl8yvy8JiXMcPrc6zalDFiwGlM=", + "dev": true + }, + "arrify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/arrify/-/arrify-1.0.1.tgz", + "integrity": "sha1-iYUI2iIm84DfkEcoRWhJwVAaSw0=", + "dev": true + }, + "asn1": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/asn1/-/asn1-0.2.3.tgz", + "integrity": "sha1-2sh4dxPJlmhJ/IGAd36+nB3fO4Y=", + "dev": true + }, + "assert-plus": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/assert-plus/-/assert-plus-1.0.0.tgz", + "integrity": "sha1-8S4PPF13sLHN2RRpQuTpbB5N1SU=", + "dev": true + }, + "assertion-error": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-1.1.0.tgz", + "integrity": "sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==", + "dev": true + }, + "assign-symbols": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/assign-symbols/-/assign-symbols-1.0.0.tgz", + "integrity": "sha1-WWZ/QfrdTyDMvCu5a41Pf3jsA2c=", + "dev": true + }, + "async": { + "version": "1.5.2", + "resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz", + "integrity": "sha1-7GphrlZIDAw8skHJVhjiCJL5Zyo=", + "dev": true + }, + "async-each": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/async-each/-/async-each-1.0.1.tgz", + "integrity": "sha1-GdOGodntxufByF04iu28xW0zYC0=", + "dev": true, + "optional": true + }, + "async-foreach": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/async-foreach/-/async-foreach-0.1.3.tgz", + "integrity": "sha1-NhIfhFwFeBct5Bmpfb6x0W7DRUI=", + "dev": true + }, + "asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha1-x57Zf380y48robyXkLzDZkdLS3k=", + "dev": true + }, + "atob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/atob/-/atob-2.1.1.tgz", + "integrity": "sha1-ri1acpR38onWDdf5amMUoi3Wwio=", + "dev": true + }, + "autoprefixer": { + "version": "8.6.2", + "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-8.6.2.tgz", + "integrity": "sha512-cv9v1mYYBcAnZq4MHseJ9AIdjQmNahnpCpPO46oTkQJS2GggsBp2azHjNpAuQ95Epvsg+AIsyjYhfI9YwFxGSA==", + "dev": true, + "requires": { + "browserslist": "^3.2.8", + "caniuse-lite": "^1.0.30000851", + "normalize-range": "^0.1.2", + "num2fraction": "^1.2.2", + "postcss": "^6.0.22", + "postcss-value-parser": "^3.2.3" + }, + "dependencies": { + "ansi-styles": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", + "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", + "dev": true, + "requires": { + "color-convert": "^1.9.0" + } + }, + "chalk": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz", + "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==", + "dev": true, + "requires": { + "ansi-styles": "^3.2.1", + "escape-string-regexp": "^1.0.5", + "supports-color": "^5.3.0" + } + }, + "has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", + "dev": true + }, + "postcss": { + "version": "6.0.22", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-6.0.22.tgz", + "integrity": "sha512-Toc9lLoUASwGqxBSJGTVcOQiDqjK+Z2XlWBg+IgYwQMY9vA2f7iMpXVc1GpPcfTSyM5lkxNo0oDwDRO+wm7XHA==", + "dev": true, + "requires": { + "chalk": "^2.4.1", + "source-map": "^0.6.1", + "supports-color": "^5.4.0" + } + }, + "supports-color": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz", + "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==", + "dev": true, + "requires": { + "has-flag": "^3.0.0" + } + } + } + }, + "aws-sign2": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/aws-sign2/-/aws-sign2-0.7.0.tgz", + "integrity": "sha1-tG6JCTSpWR8tL2+G1+ap8bP+dqg=", + "dev": true + }, + "aws4": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/aws4/-/aws4-1.6.0.tgz", + "integrity": "sha1-g+9cqGCysy5KDe7e6MdxudtXRx4=", + "dev": true + }, + "babel": { + "version": "6.23.0", + "resolved": "https://registry.npmjs.org/babel/-/babel-6.23.0.tgz", + "integrity": "sha1-0NHn2APpdHZb7qMjLU4VPA77kPQ=", + "dev": true + }, + "babel-cli": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-cli/-/babel-cli-6.26.0.tgz", + "integrity": "sha1-UCq1SHTX24itALiHoGODzgPQAvE=", + "dev": true, + "requires": { + "babel-core": "^6.26.0", + "babel-polyfill": "^6.26.0", + "babel-register": "^6.26.0", + "babel-runtime": "^6.26.0", + "chokidar": "^1.6.1", + "commander": "^2.11.0", + "convert-source-map": "^1.5.0", + "fs-readdir-recursive": "^1.0.0", + "glob": "^7.1.2", + "lodash": "^4.17.4", + "output-file-sync": "^1.1.2", + "path-is-absolute": "^1.0.1", + "slash": "^1.0.0", + "source-map": "^0.5.6", + "v8flags": "^2.1.1" + }, + "dependencies": { + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + } + } + }, + "babel-code-frame": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-code-frame/-/babel-code-frame-6.26.0.tgz", + "integrity": "sha1-Y/1D99weO7fONZR9uP42mj9Yx0s=", + "dev": true, + "requires": { + "chalk": "^1.1.3", + "esutils": "^2.0.2", + "js-tokens": "^3.0.2" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "babel-core": { + "version": "6.26.3", + "resolved": "https://registry.npmjs.org/babel-core/-/babel-core-6.26.3.tgz", + "integrity": "sha512-6jyFLuDmeidKmUEb3NM+/yawG0M2bDZ9Z1qbZP59cyHLz8kYGKYwpJP0UwUKKUiTRNvxfLesJnTedqczP7cTDA==", + "dev": true, + "requires": { + "babel-code-frame": "^6.26.0", + "babel-generator": "^6.26.0", + "babel-helpers": "^6.24.1", + "babel-messages": "^6.23.0", + "babel-register": "^6.26.0", + "babel-runtime": "^6.26.0", + "babel-template": "^6.26.0", + "babel-traverse": "^6.26.0", + "babel-types": "^6.26.0", + "babylon": "^6.18.0", + "convert-source-map": "^1.5.1", + "debug": "^2.6.9", + "json5": "^0.5.1", + "lodash": "^4.17.4", + "minimatch": "^3.0.4", + "path-is-absolute": "^1.0.1", + "private": "^0.1.8", + "slash": "^1.0.0", + "source-map": "^0.5.7" + }, + "dependencies": { + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + } + } + }, + "babel-eslint": { + "version": "8.2.3", + "resolved": "https://registry.npmjs.org/babel-eslint/-/babel-eslint-8.2.3.tgz", + "integrity": "sha512-0HeSTtaXg/Em7FCUWxwOT+KeFSO1O7LuRuzhk7g+1BjwdlQGlHq4OyMi3GqGxrNfEq8jEi6Hmt5ylEQUhurgiQ==", + "dev": true, + "requires": { + "@babel/code-frame": "7.0.0-beta.44", + "@babel/traverse": "7.0.0-beta.44", + "@babel/types": "7.0.0-beta.44", + "babylon": "7.0.0-beta.44", + "eslint-scope": "~3.7.1", + "eslint-visitor-keys": "^1.0.0" + }, + "dependencies": { + "@babel/code-frame": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.0.0-beta.44.tgz", + "integrity": "sha512-cuAuTTIQ9RqcFRJ/Y8PvTh+paepNcaGxwQwjIDRWPXmzzyAeCO4KqS9ikMvq0MCbRk6GlYKwfzStrcP3/jSL8g==", + "dev": true, + "requires": { + "@babel/highlight": "7.0.0-beta.44" + } + }, + "@babel/generator": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.0.0-beta.44.tgz", + "integrity": "sha512-5xVb7hlhjGcdkKpMXgicAVgx8syK5VJz193k0i/0sLP6DzE6lRrU1K3B/rFefgdo9LPGMAOOOAWW4jycj07ShQ==", + "dev": true, + "requires": { + "@babel/types": "7.0.0-beta.44", + "jsesc": "^2.5.1", + "lodash": "^4.2.0", + "source-map": "^0.5.0", + "trim-right": "^1.0.1" + } + }, + "@babel/helper-function-name": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/helper-function-name/-/helper-function-name-7.0.0-beta.44.tgz", + "integrity": "sha512-MHRG2qZMKMFaBavX0LWpfZ2e+hLloT++N7rfM3DYOMUOGCD8cVjqZpwiL8a0bOX3IYcQev1ruciT0gdFFRTxzg==", + "dev": true, + "requires": { + "@babel/helper-get-function-arity": "7.0.0-beta.44", + "@babel/template": "7.0.0-beta.44", + "@babel/types": "7.0.0-beta.44" + } + }, + "@babel/helper-get-function-arity": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/helper-get-function-arity/-/helper-get-function-arity-7.0.0-beta.44.tgz", + "integrity": "sha512-w0YjWVwrM2HwP6/H3sEgrSQdkCaxppqFeJtAnB23pRiJB5E/O9Yp7JAAeWBl+gGEgmBFinnTyOv2RN7rcSmMiw==", + "dev": true, + "requires": { + "@babel/types": "7.0.0-beta.44" + } + }, + "@babel/helper-split-export-declaration": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/helper-split-export-declaration/-/helper-split-export-declaration-7.0.0-beta.44.tgz", + "integrity": "sha512-aQ7QowtkgKKzPGf0j6u77kBMdUFVBKNHw2p/3HX/POt5/oz8ec5cs0GwlgM8Hz7ui5EwJnzyfRmkNF1Nx1N7aA==", + "dev": true, + "requires": { + "@babel/types": "7.0.0-beta.44" + } + }, + "@babel/highlight": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.0.0-beta.44.tgz", + "integrity": "sha512-Il19yJvy7vMFm8AVAh6OZzaFoAd0hbkeMZiX3P5HGD+z7dyI7RzndHB0dg6Urh/VAFfHtpOIzDUSxmY6coyZWQ==", + "dev": true, + "requires": { + "chalk": "^2.0.0", + "esutils": "^2.0.2", + "js-tokens": "^3.0.0" + } + }, + "@babel/template": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.0.0-beta.44.tgz", + "integrity": "sha512-w750Sloq0UNifLx1rUqwfbnC6uSUk0mfwwgGRfdLiaUzfAOiH0tHJE6ILQIUi3KYkjiCDTskoIsnfqZvWLBDng==", + "dev": true, + "requires": { + "@babel/code-frame": "7.0.0-beta.44", + "@babel/types": "7.0.0-beta.44", + "babylon": "7.0.0-beta.44", + "lodash": "^4.2.0" + } + }, + "@babel/traverse": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.0.0-beta.44.tgz", + "integrity": "sha512-UHuDz8ukQkJCDASKHf+oDt3FVUzFd+QYfuBIsiNu/4+/ix6pP/C+uQZJ6K1oEfbCMv/IKWbgDEh7fcsnIE5AtA==", + "dev": true, + "requires": { + "@babel/code-frame": "7.0.0-beta.44", + "@babel/generator": "7.0.0-beta.44", + "@babel/helper-function-name": "7.0.0-beta.44", + "@babel/helper-split-export-declaration": "7.0.0-beta.44", + "@babel/types": "7.0.0-beta.44", + "babylon": "7.0.0-beta.44", + "debug": "^3.1.0", + "globals": "^11.1.0", + "invariant": "^2.2.0", + "lodash": "^4.2.0" + } + }, + "@babel/types": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.0.0-beta.44.tgz", + "integrity": "sha512-5eTV4WRmqbaFM3v9gHAIljEQJU4Ssc6fxL61JN+Oe2ga/BwyjzjamwkCVVAQjHGuAX8i0BWo42dshL8eO5KfLQ==", + "dev": true, + "requires": { + "esutils": "^2.0.2", + "lodash": "^4.2.0", + "to-fast-properties": "^2.0.0" + } + }, + "babylon": { + "version": "7.0.0-beta.44", + "resolved": "https://registry.npmjs.org/babylon/-/babylon-7.0.0-beta.44.tgz", + "integrity": "sha512-5Hlm13BJVAioCHpImtFqNOF2H3ieTOHd0fmFGMxOJ9jgeFqeAwsv3u5P5cR7CSeFrkgHsT19DgFJkHV0/Mcd8g==", + "dev": true + }, + "debug": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz", + "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==", + "dev": true, + "requires": { + "ms": "2.0.0" + } + }, + "globals": { + "version": "11.5.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-11.5.0.tgz", + "integrity": "sha512-hYyf+kI8dm3nORsiiXUQigOU62hDLfJ9G01uyGMxhc6BKsircrUhC4uJPQPUSuq2GrTmiiEt7ewxlMdBewfmKQ==", + "dev": true + }, + "jsesc": { + "version": "2.5.1", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.1.tgz", + "integrity": "sha1-5CGiqOINawgZ3yiQj3glJrlt0f4=", + "dev": true + }, + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + }, + "to-fast-properties": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-2.0.0.tgz", + "integrity": "sha1-3F5pjL0HkmW8c+A3doGk5Og/YW4=", + "dev": true + } + } + }, + "babel-generator": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-generator/-/babel-generator-6.26.0.tgz", + "integrity": "sha1-rBriAHC3n248odMmlhMFN3TyDcU=", + "dev": true, + "requires": { + "babel-messages": "^6.23.0", + "babel-runtime": "^6.26.0", + "babel-types": "^6.26.0", + "detect-indent": "^4.0.0", + "jsesc": "^1.3.0", + "lodash": "^4.17.4", + "source-map": "^0.5.6", + "trim-right": "^1.0.1" + }, + "dependencies": { + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + } + } + }, + "babel-helper-bindify-decorators": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-bindify-decorators/-/babel-helper-bindify-decorators-6.24.1.tgz", + "integrity": "sha1-FMGeXxQte0fxmlJDHlKxzLxAozA=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-helper-builder-binary-assignment-operator-visitor": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-builder-binary-assignment-operator-visitor/-/babel-helper-builder-binary-assignment-operator-visitor-6.24.1.tgz", + "integrity": "sha1-zORReto1b0IgvK6KAsKzRvmlZmQ=", + "dev": true, + "requires": { + "babel-helper-explode-assignable-expression": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-helper-call-delegate": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-call-delegate/-/babel-helper-call-delegate-6.24.1.tgz", + "integrity": "sha1-7Oaqzdx25Bw0YfiL/Fdb0Nqi340=", + "dev": true, + "requires": { + "babel-helper-hoist-variables": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-helper-define-map": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-helper-define-map/-/babel-helper-define-map-6.26.0.tgz", + "integrity": "sha1-pfVtq0GiX5fstJjH66ypgZ+Vvl8=", + "dev": true, + "requires": { + "babel-helper-function-name": "^6.24.1", + "babel-runtime": "^6.26.0", + "babel-types": "^6.26.0", + "lodash": "^4.17.4" + } + }, + "babel-helper-explode-assignable-expression": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-explode-assignable-expression/-/babel-helper-explode-assignable-expression-6.24.1.tgz", + "integrity": "sha1-8luCz33BBDPFX3BZLVdGQArCLKo=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-helper-explode-class": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-explode-class/-/babel-helper-explode-class-6.24.1.tgz", + "integrity": "sha1-fcKjkQ3uAHBW4eMdZAztPVTqqes=", + "dev": true, + "requires": { + "babel-helper-bindify-decorators": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-helper-function-name": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-function-name/-/babel-helper-function-name-6.24.1.tgz", + "integrity": "sha1-00dbjAPtmCQqJbSDUasYOZ01gKk=", + "dev": true, + "requires": { + "babel-helper-get-function-arity": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-helper-get-function-arity": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-get-function-arity/-/babel-helper-get-function-arity-6.24.1.tgz", + "integrity": "sha1-j3eCqpNAfEHTqlCQj4mwMbG2hT0=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-helper-hoist-variables": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-hoist-variables/-/babel-helper-hoist-variables-6.24.1.tgz", + "integrity": "sha1-HssnaJydJVE+rbyZFKc/VAi+enY=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-helper-optimise-call-expression": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-optimise-call-expression/-/babel-helper-optimise-call-expression-6.24.1.tgz", + "integrity": "sha1-96E0J7qfc/j0+pk8VKl4gtEkQlc=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-helper-regex": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-helper-regex/-/babel-helper-regex-6.26.0.tgz", + "integrity": "sha1-MlxZ+QL4LyS3T6zu0DY5VPZJXnI=", + "dev": true, + "requires": { + "babel-runtime": "^6.26.0", + "babel-types": "^6.26.0", + "lodash": "^4.17.4" + } + }, + "babel-helper-remap-async-to-generator": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-remap-async-to-generator/-/babel-helper-remap-async-to-generator-6.24.1.tgz", + "integrity": "sha1-XsWBgnrXI/7N04HxySg5BnbkVRs=", + "dev": true, + "requires": { + "babel-helper-function-name": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-helper-replace-supers": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helper-replace-supers/-/babel-helper-replace-supers-6.24.1.tgz", + "integrity": "sha1-v22/5Dk40XNpohPKiov3S2qQqxo=", + "dev": true, + "requires": { + "babel-helper-optimise-call-expression": "^6.24.1", + "babel-messages": "^6.23.0", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-helpers": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-helpers/-/babel-helpers-6.24.1.tgz", + "integrity": "sha1-NHHenK7DiOXIUOWX5Yom3fN2ArI=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1" + } + }, + "babel-messages": { + "version": "6.23.0", + "resolved": "https://registry.npmjs.org/babel-messages/-/babel-messages-6.23.0.tgz", + "integrity": "sha1-8830cDhYA1sqKVHG7F7fbGLyYw4=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-add-module-exports": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/babel-plugin-add-module-exports/-/babel-plugin-add-module-exports-0.2.1.tgz", + "integrity": "sha1-mumh9KjcZ/DN7E9K7aHkOl/2XiU=", + "dev": true + }, + "babel-plugin-check-es2015-constants": { + "version": "6.22.0", + "resolved": "https://registry.npmjs.org/babel-plugin-check-es2015-constants/-/babel-plugin-check-es2015-constants-6.22.0.tgz", + "integrity": "sha1-NRV7EBQm/S/9PaP3XH0ekYNbv4o=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-syntax-async-functions": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-async-functions/-/babel-plugin-syntax-async-functions-6.13.0.tgz", + "integrity": "sha1-ytnK0RkbWtY0vzCuCHI5HgZHvpU=", + "dev": true + }, + "babel-plugin-syntax-async-generators": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-async-generators/-/babel-plugin-syntax-async-generators-6.13.0.tgz", + "integrity": "sha1-a8lj67FuzLrmuStZbrfzXDQqi5o=", + "dev": true + }, + "babel-plugin-syntax-class-properties": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-class-properties/-/babel-plugin-syntax-class-properties-6.13.0.tgz", + "integrity": "sha1-1+sjt5oxf4VDlixQW4J8fWysJ94=", + "dev": true + }, + "babel-plugin-syntax-decorators": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-decorators/-/babel-plugin-syntax-decorators-6.13.0.tgz", + "integrity": "sha1-MSVjtNvePMgGzuPkFszurd0RrAs=", + "dev": true + }, + "babel-plugin-syntax-dynamic-import": { + "version": "6.18.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-dynamic-import/-/babel-plugin-syntax-dynamic-import-6.18.0.tgz", + "integrity": "sha1-jWomIpyDdFqZgqRBBRVyyqF5sdo=", + "dev": true + }, + "babel-plugin-syntax-exponentiation-operator": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-exponentiation-operator/-/babel-plugin-syntax-exponentiation-operator-6.13.0.tgz", + "integrity": "sha1-nufoM3KQ2pUoggGmpX9BcDF4MN4=", + "dev": true + }, + "babel-plugin-syntax-object-rest-spread": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-object-rest-spread/-/babel-plugin-syntax-object-rest-spread-6.13.0.tgz", + "integrity": "sha1-/WU28rzhODb/o6VFjEkDpZe7O/U=", + "dev": true + }, + "babel-plugin-syntax-trailing-function-commas": { + "version": "6.22.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-trailing-function-commas/-/babel-plugin-syntax-trailing-function-commas-6.22.0.tgz", + "integrity": "sha1-ugNgk3+NBuQBgKQ/4NVhb/9TLPM=", + "dev": true + }, + "babel-plugin-transform-async-generator-functions": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-async-generator-functions/-/babel-plugin-transform-async-generator-functions-6.24.1.tgz", + "integrity": "sha1-8FiQAUX9PpkHpt3yjaWfIVJYpds=", + "dev": true, + "requires": { + "babel-helper-remap-async-to-generator": "^6.24.1", + "babel-plugin-syntax-async-generators": "^6.5.0", + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-async-to-generator": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-async-to-generator/-/babel-plugin-transform-async-to-generator-6.24.1.tgz", + "integrity": "sha1-ZTbjeK/2yx1VF6wOQOs+n8jQh2E=", + "dev": true, + "requires": { + "babel-helper-remap-async-to-generator": "^6.24.1", + "babel-plugin-syntax-async-functions": "^6.8.0", + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-class-properties": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-class-properties/-/babel-plugin-transform-class-properties-6.24.1.tgz", + "integrity": "sha1-anl2PqYdM9NvN7YRqp3vgagbRqw=", + "dev": true, + "requires": { + "babel-helper-function-name": "^6.24.1", + "babel-plugin-syntax-class-properties": "^6.8.0", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1" + } + }, + "babel-plugin-transform-decorators": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-decorators/-/babel-plugin-transform-decorators-6.24.1.tgz", + "integrity": "sha1-eIAT2PjGtSIr33s0Q5Df13Vp4k0=", + "dev": true, + "requires": { + "babel-helper-explode-class": "^6.24.1", + "babel-plugin-syntax-decorators": "^6.13.0", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-arrow-functions": { + "version": "6.22.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-arrow-functions/-/babel-plugin-transform-es2015-arrow-functions-6.22.0.tgz", + "integrity": "sha1-RSaSy3EdX3ncf4XkQM5BufJE0iE=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-block-scoped-functions": { + "version": "6.22.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-block-scoped-functions/-/babel-plugin-transform-es2015-block-scoped-functions-6.22.0.tgz", + "integrity": "sha1-u8UbSflk1wy42OC5ToICRs46YUE=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-block-scoping": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-block-scoping/-/babel-plugin-transform-es2015-block-scoping-6.26.0.tgz", + "integrity": "sha1-1w9SmcEwjQXBL0Y4E7CgnnOxiV8=", + "dev": true, + "requires": { + "babel-runtime": "^6.26.0", + "babel-template": "^6.26.0", + "babel-traverse": "^6.26.0", + "babel-types": "^6.26.0", + "lodash": "^4.17.4" + } + }, + "babel-plugin-transform-es2015-classes": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-classes/-/babel-plugin-transform-es2015-classes-6.24.1.tgz", + "integrity": "sha1-WkxYpQyclGHlZLSyo7+ryXolhNs=", + "dev": true, + "requires": { + "babel-helper-define-map": "^6.24.1", + "babel-helper-function-name": "^6.24.1", + "babel-helper-optimise-call-expression": "^6.24.1", + "babel-helper-replace-supers": "^6.24.1", + "babel-messages": "^6.23.0", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-computed-properties": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-computed-properties/-/babel-plugin-transform-es2015-computed-properties-6.24.1.tgz", + "integrity": "sha1-b+Ko0WiV1WNPTNmZttNICjCBWbM=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-destructuring": { + "version": "6.23.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-destructuring/-/babel-plugin-transform-es2015-destructuring-6.23.0.tgz", + "integrity": "sha1-mXux8auWf2gtKwh2/jWNYOdlxW0=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-duplicate-keys": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-duplicate-keys/-/babel-plugin-transform-es2015-duplicate-keys-6.24.1.tgz", + "integrity": "sha1-c+s9MQypaePvnskcU3QabxV2Qj4=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-for-of": { + "version": "6.23.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-for-of/-/babel-plugin-transform-es2015-for-of-6.23.0.tgz", + "integrity": "sha1-9HyVsrYT3x0+zC/bdXNiPHUkhpE=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-function-name": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-function-name/-/babel-plugin-transform-es2015-function-name-6.24.1.tgz", + "integrity": "sha1-g0yJhTvDaxrw86TF26qU/Y6sqos=", + "dev": true, + "requires": { + "babel-helper-function-name": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-literals": { + "version": "6.22.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-literals/-/babel-plugin-transform-es2015-literals-6.22.0.tgz", + "integrity": "sha1-T1SgLWzWbPkVKAAZox0xklN3yi4=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-modules-amd": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-modules-amd/-/babel-plugin-transform-es2015-modules-amd-6.24.1.tgz", + "integrity": "sha1-Oz5UAXI5hC1tGcMBHEvS8AoA0VQ=", + "dev": true, + "requires": { + "babel-plugin-transform-es2015-modules-commonjs": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-modules-commonjs": { + "version": "6.26.2", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-modules-commonjs/-/babel-plugin-transform-es2015-modules-commonjs-6.26.2.tgz", + "integrity": "sha512-CV9ROOHEdrjcwhIaJNBGMBCodN+1cfkwtM1SbUHmvyy35KGT7fohbpOxkE2uLz1o6odKK2Ck/tz47z+VqQfi9Q==", + "dev": true, + "requires": { + "babel-plugin-transform-strict-mode": "^6.24.1", + "babel-runtime": "^6.26.0", + "babel-template": "^6.26.0", + "babel-types": "^6.26.0" + } + }, + "babel-plugin-transform-es2015-modules-systemjs": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-modules-systemjs/-/babel-plugin-transform-es2015-modules-systemjs-6.24.1.tgz", + "integrity": "sha1-/4mhQrkRmpBhlfXxBuzzBdlAfSM=", + "dev": true, + "requires": { + "babel-helper-hoist-variables": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-modules-umd": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-modules-umd/-/babel-plugin-transform-es2015-modules-umd-6.24.1.tgz", + "integrity": "sha1-rJl+YoXNGO1hdq22B9YCNErThGg=", + "dev": true, + "requires": { + "babel-plugin-transform-es2015-modules-amd": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-object-super": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-object-super/-/babel-plugin-transform-es2015-object-super-6.24.1.tgz", + "integrity": "sha1-JM72muIcuDp/hgPa0CH1cusnj40=", + "dev": true, + "requires": { + "babel-helper-replace-supers": "^6.24.1", + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-parameters": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-parameters/-/babel-plugin-transform-es2015-parameters-6.24.1.tgz", + "integrity": "sha1-V6w1GrScrxSpfNE7CfZv3wpiXys=", + "dev": true, + "requires": { + "babel-helper-call-delegate": "^6.24.1", + "babel-helper-get-function-arity": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-template": "^6.24.1", + "babel-traverse": "^6.24.1", + "babel-types": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-shorthand-properties": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-shorthand-properties/-/babel-plugin-transform-es2015-shorthand-properties-6.24.1.tgz", + "integrity": "sha1-JPh11nIch2YbvZmkYi5R8U3jiqA=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-spread": { + "version": "6.22.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-spread/-/babel-plugin-transform-es2015-spread-6.22.0.tgz", + "integrity": "sha1-1taKmfia7cRTbIGlQujdnxdG+NE=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-sticky-regex": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-sticky-regex/-/babel-plugin-transform-es2015-sticky-regex-6.24.1.tgz", + "integrity": "sha1-AMHNsaynERLN8M9hJsLta0V8zbw=", + "dev": true, + "requires": { + "babel-helper-regex": "^6.24.1", + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-plugin-transform-es2015-template-literals": { + "version": "6.22.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-template-literals/-/babel-plugin-transform-es2015-template-literals-6.22.0.tgz", + "integrity": "sha1-qEs0UPfp+PH2g51taH2oS7EjbY0=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-typeof-symbol": { + "version": "6.23.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-typeof-symbol/-/babel-plugin-transform-es2015-typeof-symbol-6.23.0.tgz", + "integrity": "sha1-3sCfHN3/lLUqxz1QXITfWdzOs3I=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-es2015-unicode-regex": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-es2015-unicode-regex/-/babel-plugin-transform-es2015-unicode-regex-6.24.1.tgz", + "integrity": "sha1-04sS9C6nMj9yk4fxinxa4frrNek=", + "dev": true, + "requires": { + "babel-helper-regex": "^6.24.1", + "babel-runtime": "^6.22.0", + "regexpu-core": "^2.0.0" + } + }, + "babel-plugin-transform-exponentiation-operator": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-exponentiation-operator/-/babel-plugin-transform-exponentiation-operator-6.24.1.tgz", + "integrity": "sha1-KrDJx/MJj6SJB3cruBP+QejeOg4=", + "dev": true, + "requires": { + "babel-helper-builder-binary-assignment-operator-visitor": "^6.24.1", + "babel-plugin-syntax-exponentiation-operator": "^6.8.0", + "babel-runtime": "^6.22.0" + } + }, + "babel-plugin-transform-object-rest-spread": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-object-rest-spread/-/babel-plugin-transform-object-rest-spread-6.26.0.tgz", + "integrity": "sha1-DzZpLVD+9rfi1LOsFHgTepY7ewY=", + "dev": true, + "requires": { + "babel-plugin-syntax-object-rest-spread": "^6.8.0", + "babel-runtime": "^6.26.0" + } + }, + "babel-plugin-transform-regenerator": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-regenerator/-/babel-plugin-transform-regenerator-6.26.0.tgz", + "integrity": "sha1-4HA2lvveJ/Cj78rPi03KL3s6jy8=", + "dev": true, + "requires": { + "regenerator-transform": "^0.10.0" + } + }, + "babel-plugin-transform-strict-mode": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-strict-mode/-/babel-plugin-transform-strict-mode-6.24.1.tgz", + "integrity": "sha1-1fr3qleKZbvlkc9e2uBKDGcCB1g=", + "dev": true, + "requires": { + "babel-runtime": "^6.22.0", + "babel-types": "^6.24.1" + } + }, + "babel-polyfill": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-polyfill/-/babel-polyfill-6.26.0.tgz", + "integrity": "sha1-N5k3q8Z9eJWXCtxiHyhM2WbPIVM=", + "dev": true, + "requires": { + "babel-runtime": "^6.26.0", + "core-js": "^2.5.0", + "regenerator-runtime": "^0.10.5" + }, + "dependencies": { + "regenerator-runtime": { + "version": "0.10.5", + "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.10.5.tgz", + "integrity": "sha1-M2w+/BIgrc7dosn6tntaeVWjNlg=", + "dev": true + } + } + }, + "babel-preset-es2015": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-preset-es2015/-/babel-preset-es2015-6.24.1.tgz", + "integrity": "sha1-1EBQ1rwsn+6nAqrzjXJ6AhBTiTk=", + "dev": true, + "requires": { + "babel-plugin-check-es2015-constants": "^6.22.0", + "babel-plugin-transform-es2015-arrow-functions": "^6.22.0", + "babel-plugin-transform-es2015-block-scoped-functions": "^6.22.0", + "babel-plugin-transform-es2015-block-scoping": "^6.24.1", + "babel-plugin-transform-es2015-classes": "^6.24.1", + "babel-plugin-transform-es2015-computed-properties": "^6.24.1", + "babel-plugin-transform-es2015-destructuring": "^6.22.0", + "babel-plugin-transform-es2015-duplicate-keys": "^6.24.1", + "babel-plugin-transform-es2015-for-of": "^6.22.0", + "babel-plugin-transform-es2015-function-name": "^6.24.1", + "babel-plugin-transform-es2015-literals": "^6.22.0", + "babel-plugin-transform-es2015-modules-amd": "^6.24.1", + "babel-plugin-transform-es2015-modules-commonjs": "^6.24.1", + "babel-plugin-transform-es2015-modules-systemjs": "^6.24.1", + "babel-plugin-transform-es2015-modules-umd": "^6.24.1", + "babel-plugin-transform-es2015-object-super": "^6.24.1", + "babel-plugin-transform-es2015-parameters": "^6.24.1", + "babel-plugin-transform-es2015-shorthand-properties": "^6.24.1", + "babel-plugin-transform-es2015-spread": "^6.22.0", + "babel-plugin-transform-es2015-sticky-regex": "^6.24.1", + "babel-plugin-transform-es2015-template-literals": "^6.22.0", + "babel-plugin-transform-es2015-typeof-symbol": "^6.22.0", + "babel-plugin-transform-es2015-unicode-regex": "^6.24.1", + "babel-plugin-transform-regenerator": "^6.24.1" + } + }, + "babel-preset-stage-2": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-preset-stage-2/-/babel-preset-stage-2-6.24.1.tgz", + "integrity": "sha1-2eKWD7PXEYfw5k7sYrwHdnIZvcE=", + "dev": true, + "requires": { + "babel-plugin-syntax-dynamic-import": "^6.18.0", + "babel-plugin-transform-class-properties": "^6.24.1", + "babel-plugin-transform-decorators": "^6.24.1", + "babel-preset-stage-3": "^6.24.1" + } + }, + "babel-preset-stage-3": { + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/babel-preset-stage-3/-/babel-preset-stage-3-6.24.1.tgz", + "integrity": "sha1-g2raCp56f6N8sTj7kyb4eTSkg5U=", + "dev": true, + "requires": { + "babel-plugin-syntax-trailing-function-commas": "^6.22.0", + "babel-plugin-transform-async-generator-functions": "^6.24.1", + "babel-plugin-transform-async-to-generator": "^6.24.1", + "babel-plugin-transform-exponentiation-operator": "^6.24.1", + "babel-plugin-transform-object-rest-spread": "^6.22.0" + } + }, + "babel-register": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-register/-/babel-register-6.26.0.tgz", + "integrity": "sha1-btAhFz4vy0htestFxgCahW9kcHE=", + "dev": true, + "requires": { + "babel-core": "^6.26.0", + "babel-runtime": "^6.26.0", + "core-js": "^2.5.0", + "home-or-tmp": "^2.0.0", + "lodash": "^4.17.4", + "mkdirp": "^0.5.1", + "source-map-support": "^0.4.15" + }, + "dependencies": { + "babel-core": { + "version": "6.26.3", + "resolved": "https://registry.npmjs.org/babel-core/-/babel-core-6.26.3.tgz", + "integrity": "sha512-6jyFLuDmeidKmUEb3NM+/yawG0M2bDZ9Z1qbZP59cyHLz8kYGKYwpJP0UwUKKUiTRNvxfLesJnTedqczP7cTDA==", + "dev": true, + "requires": { + "babel-code-frame": "^6.26.0", + "babel-generator": "^6.26.0", + "babel-helpers": "^6.24.1", + "babel-messages": "^6.23.0", + "babel-register": "^6.26.0", + "babel-runtime": "^6.26.0", + "babel-template": "^6.26.0", + "babel-traverse": "^6.26.0", + "babel-types": "^6.26.0", + "babylon": "^6.18.0", + "convert-source-map": "^1.5.1", + "debug": "^2.6.9", + "json5": "^0.5.1", + "lodash": "^4.17.4", + "minimatch": "^3.0.4", + "path-is-absolute": "^1.0.1", + "private": "^0.1.8", + "slash": "^1.0.0", + "source-map": "^0.5.7" + } + }, + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + } + } + }, + "babel-runtime": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-runtime/-/babel-runtime-6.26.0.tgz", + "integrity": "sha1-llxwWGaOgrVde/4E/yM3vItWR/4=", + "dev": true, + "requires": { + "core-js": "^2.4.0", + "regenerator-runtime": "^0.11.0" + } + }, + "babel-template": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-template/-/babel-template-6.26.0.tgz", + "integrity": "sha1-3gPi0WOWsGn0bdn/+FIfsaDjXgI=", + "dev": true, + "requires": { + "babel-runtime": "^6.26.0", + "babel-traverse": "^6.26.0", + "babel-types": "^6.26.0", + "babylon": "^6.18.0", + "lodash": "^4.17.4" + } + }, + "babel-traverse": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-traverse/-/babel-traverse-6.26.0.tgz", + "integrity": "sha1-RqnL1+3MYsjlwGTi0tjQ9ANXZu4=", + "dev": true, + "requires": { + "babel-code-frame": "^6.26.0", + "babel-messages": "^6.23.0", + "babel-runtime": "^6.26.0", + "babel-types": "^6.26.0", + "babylon": "^6.18.0", + "debug": "^2.6.8", + "globals": "^9.18.0", + "invariant": "^2.2.2", + "lodash": "^4.17.4" + } + }, + "babel-types": { + "version": "6.26.0", + "resolved": "https://registry.npmjs.org/babel-types/-/babel-types-6.26.0.tgz", + "integrity": "sha1-o7Bz+Uq0nrb6Vc1lInozQ4BjJJc=", + "dev": true, + "requires": { + "babel-runtime": "^6.26.0", + "esutils": "^2.0.2", + "lodash": "^4.17.4", + "to-fast-properties": "^1.0.3" + } + }, + "babylon": { + "version": "6.18.0", + "resolved": "https://registry.npmjs.org/babylon/-/babylon-6.18.0.tgz", + "integrity": "sha1-ry87iPpvXB5MY00aD46sT1WzleM=", + "dev": true + }, + "bail": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/bail/-/bail-1.0.3.tgz", + "integrity": "sha512-1X8CnjFVQ+a+KW36uBNMTU5s8+v5FzeqrP7hTG5aTb4aPreSbZJlhwPon9VKMuEVgV++JM+SQrALY3kr7eswdg==", + "dev": true + }, + "balanced-match": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.0.tgz", + "integrity": "sha1-ibTRmasr7kneFk6gK4nORi1xt2c=", + "dev": true + }, + "base": { + "version": "0.11.2", + "resolved": "https://registry.npmjs.org/base/-/base-0.11.2.tgz", + "integrity": "sha512-5T6P4xPgpp0YDFvSWwEZ4NoE3aM4QBQXDzmVbraCkFj8zHM+mba8SyqB5DbZWyR7mYHo6Y7BdQo3MoA4m0TeQg==", + "dev": true, + "requires": { + "cache-base": "^1.0.1", + "class-utils": "^0.3.5", + "component-emitter": "^1.2.1", + "define-property": "^1.0.0", + "isobject": "^3.0.1", + "mixin-deep": "^1.2.0", + "pascalcase": "^0.1.1" + }, + "dependencies": { + "define-property": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz", + "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=", + "dev": true, + "requires": { + "is-descriptor": "^1.0.0" + } + }, + "is-accessor-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz", + "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==", + "dev": true, + "requires": { + "kind-of": "^6.0.0" + } + }, + "is-data-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz", + "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==", + "dev": true, + "requires": { + "kind-of": "^6.0.0" + } + }, + "is-descriptor": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz", + "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==", + "dev": true, + "requires": { + "is-accessor-descriptor": "^1.0.0", + "is-data-descriptor": "^1.0.0", + "kind-of": "^6.0.2" + } + }, + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + }, + "kind-of": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz", + "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==", + "dev": true + } + } + }, + "bcrypt-pbkdf": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/bcrypt-pbkdf/-/bcrypt-pbkdf-1.0.1.tgz", + "integrity": "sha1-Y7xdy2EzG5K8Bf1SiVPDNGKgb40=", + "dev": true, + "optional": true, + "requires": { + "tweetnacl": "^0.14.3" + } + }, + "binary-extensions": { + "version": "1.11.0", + "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-1.11.0.tgz", + "integrity": "sha1-RqoXUftqL5PuXmibsQh9SxTGwgU=", + "dev": true, + "optional": true + }, + "block-stream": { + "version": "0.0.9", + "resolved": "https://registry.npmjs.org/block-stream/-/block-stream-0.0.9.tgz", + "integrity": "sha1-E+v+d4oDIFz+A3UUgeu0szAMEmo=", + "dev": true, + "requires": { + "inherits": "~2.0.0" + } + }, + "bluebird": { + "version": "3.5.1", + "resolved": "https://registry.npmjs.org/bluebird/-/bluebird-3.5.1.tgz", + "integrity": "sha1-2VUfnemPH82h5oPRfukaBgLuLrk=", + "dev": true + }, + "body": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/body/-/body-5.1.0.tgz", + "integrity": "sha1-5LoM5BCkaTYyM2dgnstOZVMSUGk=", + "dev": true, + "requires": { + "continuable-cache": "^0.3.1", + "error": "^7.0.0", + "raw-body": "~1.1.0", + "safe-json-parse": "~1.0.1" + } + }, + "boom": { + "version": "2.10.1", + "resolved": "https://registry.npmjs.org/boom/-/boom-2.10.1.tgz", + "integrity": "sha1-OciRjO/1eZ+D+UkqhI9iWt0Mdm8=", + "dev": true, + "requires": { + "hoek": "2.x.x" + } + }, + "brace-expansion": { + "version": "1.1.8", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.8.tgz", + "integrity": "sha1-wHshHHyVLsH479Uad+8NHTmQopI=", + "dev": true, + "requires": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "braces": { + "version": "1.8.5", + "resolved": "https://registry.npmjs.org/braces/-/braces-1.8.5.tgz", + "integrity": "sha1-uneWLhLf+WnWt2cR6RS3N4V79qc=", + "dev": true, + "requires": { + "expand-range": "^1.8.1", + "preserve": "^0.2.0", + "repeat-element": "^1.1.2" + } + }, + "browser-stdout": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/browser-stdout/-/browser-stdout-1.3.1.tgz", + "integrity": "sha1-uqVZ7hTO1zRSIputcyZGfGH6vWA=", + "dev": true + }, + "browserify-zlib": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/browserify-zlib/-/browserify-zlib-0.1.4.tgz", + "integrity": "sha1-uzX4pRn2AOD6a4SFJByXnQFB+y0=", + "dev": true, + "requires": { + "pako": "~0.2.0" + } + }, + "browserslist": { + "version": "3.2.8", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-3.2.8.tgz", + "integrity": "sha512-WHVocJYavUwVgVViC0ORikPHQquXwVh939TaelZ4WDqpWgTX/FsGhl/+P4qBUAGcRvtOgDgC+xftNWWp2RUTAQ==", + "dev": true, + "requires": { + "caniuse-lite": "^1.0.30000844", + "electron-to-chromium": "^1.3.47" + } + }, + "buffer-from": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.0.tgz", + "integrity": "sha512-c5mRlguI/Pe2dSZmpER62rSCu0ryKmWddzRYsuXc50U2/g8jMOulc31VZMa4mYx31U5xsmSOpDCgH88Vl9cDGQ==", + "dev": true + }, + "builtin-modules": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/builtin-modules/-/builtin-modules-1.1.1.tgz", + "integrity": "sha1-Jw8HbFpywC9bZaR9+Uxf46J4iS8=", + "dev": true + }, + "bytes": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-1.0.0.tgz", + "integrity": "sha1-NWnt6Lo0MV+rmcPpLLBMciDeH6g=", + "dev": true + }, + "cache-base": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/cache-base/-/cache-base-1.0.1.tgz", + "integrity": "sha512-AKcdTnFSWATd5/GCPRxr2ChwIJ85CeyrEyjRHlKxQ56d4XJMGym0uAiKn0xbLOGOl3+yRpOTi484dVCEc5AUzQ==", + "dev": true, + "requires": { + "collection-visit": "^1.0.0", + "component-emitter": "^1.2.1", + "get-value": "^2.0.6", + "has-value": "^1.0.0", + "isobject": "^3.0.1", + "set-value": "^2.0.0", + "to-object-path": "^0.3.0", + "union-value": "^1.0.0", + "unset-value": "^1.0.0" + }, + "dependencies": { + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + } + } + }, + "call-me-maybe": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.1.tgz", + "integrity": "sha1-JtII6onje1y95gJQoV8DHBak1ms=", + "dev": true + }, + "camelcase": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-2.1.1.tgz", + "integrity": "sha1-fB0W1nmhu+WcoCys7PsBHiAfWh8=", + "dev": true + }, + "camelcase-keys": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz", + "integrity": "sha1-MIvur/3ygRkFHvodkyITyRuPkuc=", + "dev": true, + "requires": { + "camelcase": "^2.0.0", + "map-obj": "^1.0.0" + } + }, + "caniuse-lite": { + "version": "1.0.30000851", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30000851.tgz", + "integrity": "sha512-Y1ecA1cL9wg0vni8t33nBw/poX8ypm+2c3fbwAESj8cm4ufK9CBFQ1+nUK8Dp5dtFo5Fc3JzkI5DKmQbuIo6hQ==", + "dev": true + }, + "caseless": { + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz", + "integrity": "sha1-G2gcIf+EAzyCZUMJBolCDRhxUdw=", + "dev": true + }, + "ccount": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/ccount/-/ccount-1.0.3.tgz", + "integrity": "sha512-Jt9tIBkRc9POUof7QA/VwWd+58fKkEEfI+/t1/eOlxKM7ZhrczNzMFefge7Ai+39y1pR/pP6cI19guHy3FSLmw==", + "dev": true + }, + "center-align": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/center-align/-/center-align-0.1.3.tgz", + "integrity": "sha1-qg0yYptu6XIgBBHL1EYckHvCt60=", + "dev": true, + "optional": true, + "requires": { + "align-text": "^0.1.3", + "lazy-cache": "^1.0.3" + } + }, + "chai": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chai/-/chai-4.1.2.tgz", + "integrity": "sha1-D2RYS6ZC8PKs4oBiefTwbKI61zw=", + "dev": true, + "requires": { + "assertion-error": "^1.0.1", + "check-error": "^1.0.1", + "deep-eql": "^3.0.0", + "get-func-name": "^2.0.0", + "pathval": "^1.0.0", + "type-detect": "^4.0.0" + } + }, + "chai-as-promised": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/chai-as-promised/-/chai-as-promised-7.1.1.tgz", + "integrity": "sha512-azL6xMoi+uxu6z4rhWQ1jbdUhOMhis2PvscD/xjLqNMkv3BPPp2JyyuTHOrf9BOosGpNQ11v6BKv/g57RXbiaA==", + "dev": true, + "requires": { + "check-error": "^1.0.2" + } + }, + "chalk": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.3.0.tgz", + "integrity": "sha1-tepI78nBeT3MybR2fJORTT8tUro=", + "dev": true, + "requires": { + "ansi-styles": "^3.1.0", + "escape-string-regexp": "^1.0.5", + "supports-color": "^4.0.0" + } + }, + "character-entities": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-1.2.2.tgz", + "integrity": "sha512-sMoHX6/nBiy3KKfC78dnEalnpn0Az0oSNvqUWYTtYrhRI5iUIYsROU48G+E+kMFQzqXaJ8kHJZ85n7y6/PHgwQ==", + "dev": true + }, + "character-entities-html4": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-1.1.2.tgz", + "integrity": "sha512-sIrXwyna2+5b0eB9W149izTPJk/KkJTg6mEzDGibwBUkyH1SbDa+nf515Ppdi3MaH35lW0JFJDWeq9Luzes1Iw==", + "dev": true + }, + "character-entities-legacy": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-1.1.2.tgz", + "integrity": "sha512-9NB2VbXtXYWdXzqrvAHykE/f0QJxzaKIpZ5QzNZrrgQ7Iyxr2vnfS8fCBNVW9nUEZE0lo57nxKRqnzY/dKrwlA==", + "dev": true + }, + "character-reference-invalid": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/character-reference-invalid/-/character-reference-invalid-1.1.2.tgz", + "integrity": "sha512-7I/xceXfKyUJmSAn/jw8ve/9DyOP7XxufNYLI9Px7CmsKgEUaZLUTax6nZxGQtaoiZCjpu6cHPj20xC/vqRReQ==", + "dev": true + }, + "check-error": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/check-error/-/check-error-1.0.2.tgz", + "integrity": "sha1-V00xLt2Iu13YkS6Sht1sCu1KrII=", + "dev": true + }, + "chokidar": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-1.7.0.tgz", + "integrity": "sha1-eY5ol3gVHIB2tLNg5e3SjNortGg=", + "dev": true, + "optional": true, + "requires": { + "anymatch": "^1.3.0", + "async-each": "^1.0.0", + "fsevents": "^1.0.0", + "glob-parent": "^2.0.0", + "inherits": "^2.0.1", + "is-binary-path": "^1.0.0", + "is-glob": "^2.0.0", + "path-is-absolute": "^1.0.0", + "readdirp": "^2.0.0" + } + }, + "chromedriver": { + "version": "2.40.0", + "resolved": "https://registry.npmjs.org/chromedriver/-/chromedriver-2.40.0.tgz", + "integrity": "sha512-ewvRQ1HMk0vpFSWYCk5hKDoEz5QMPplx5w3C6/Me+03y1imr67l3Hxl9U0jn3mu2N7+c7BoC7JtNW6HzbRAwDQ==", + "dev": true, + "requires": { + "del": "^3.0.0", + "extract-zip": "^1.6.7", + "kew": "^0.7.0", + "mkdirp": "^0.5.1", + "request": "^2.87.0" + }, + "dependencies": { + "request": { + "version": "2.87.0", + "resolved": "https://registry.npmjs.org/request/-/request-2.87.0.tgz", + "integrity": "sha512-fcogkm7Az5bsS6Sl0sibkbhcKsnyon/jV1kF3ajGmF0c8HrttdKTPRT9hieOaQHA5HEq6r8OyWOo/o781C1tNw==", + "dev": true, + "requires": { + "aws-sign2": "~0.7.0", + "aws4": "^1.6.0", + "caseless": "~0.12.0", + "combined-stream": "~1.0.5", + "extend": "~3.0.1", + "forever-agent": "~0.6.1", + "form-data": "~2.3.1", + "har-validator": "~5.0.3", + "http-signature": "~1.2.0", + "is-typedarray": "~1.0.0", + "isstream": "~0.1.2", + "json-stringify-safe": "~5.0.1", + "mime-types": "~2.1.17", + "oauth-sign": "~0.8.2", + "performance-now": "^2.1.0", + "qs": "~6.5.1", + "safe-buffer": "^5.1.1", + "tough-cookie": "~2.3.3", + "tunnel-agent": "^0.6.0", + "uuid": "^3.1.0" + } + } + } + }, + "circular-json": { + "version": "0.3.3", + "resolved": "https://registry.npmjs.org/circular-json/-/circular-json-0.3.3.tgz", + "integrity": "sha512-UZK3NBx2Mca+b5LsG7bY183pHWt5Y1xts4P3Pz7ENTwGVnJOUWbRb3ocjvX7hx9tq/yTAdclXm9sZ38gNuem4A==", + "dev": true + }, + "class-utils": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/class-utils/-/class-utils-0.3.6.tgz", + "integrity": "sha512-qOhPa/Fj7s6TY8H8esGu5QNpMMQxz79h+urzrNYN6mn+9BnxlDGf5QZ+XeCDsxSjPqsSR56XOZOJmpeurnLMeg==", + "dev": true, + "requires": { + "arr-union": "^3.1.0", + "define-property": "^0.2.5", + "isobject": "^3.0.0", + "static-extend": "^0.1.1" + }, + "dependencies": { + "define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=", + "dev": true, + "requires": { + "is-descriptor": "^0.1.0" + } + }, + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + } + } + }, + "clean-css": { + "version": "4.1.9", + "resolved": "https://registry.npmjs.org/clean-css/-/clean-css-4.1.9.tgz", + "integrity": "sha1-Nc7ornaHpJuYA09w3gDE7dOCYwE=", + "dev": true, + "requires": { + "source-map": "0.5.x" + }, + "dependencies": { + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + } + } + }, + "cli": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/cli/-/cli-1.0.1.tgz", + "integrity": "sha1-IoF1NPJL+klQw01TLUjsvGIbjBQ=", + "dev": true, + "requires": { + "exit": "0.1.2", + "glob": "^7.1.1" + } + }, + "cli-cursor": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-1.0.2.tgz", + "integrity": "sha1-ZNo/fValRBLll5S9Ytw1KV6PKYc=", + "dev": true, + "requires": { + "restore-cursor": "^1.0.1" + } + }, + "cli-width": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/cli-width/-/cli-width-1.1.1.tgz", + "integrity": "sha1-pNKT72frt7iNSk1CwMzwDE0eNm0=", + "dev": true + }, + "cliui": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-3.2.0.tgz", + "integrity": "sha1-EgYBU3qRbSmUD5NNo7SNWFo5IT0=", + "dev": true, + "requires": { + "string-width": "^1.0.1", + "strip-ansi": "^3.0.1", + "wrap-ansi": "^2.0.0" + } + }, + "clone-regexp": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/clone-regexp/-/clone-regexp-1.0.1.tgz", + "integrity": "sha512-Fcij9IwRW27XedRIJnSOEupS7RVcXtObJXbcUOX93UCLqqOdRpkvzKywOOSizmEK/Is3S/RHX9dLdfo6R1Q1mw==", + "dev": true, + "requires": { + "is-regexp": "^1.0.0", + "is-supported-regexp-flag": "^1.0.0" + } + }, + "co": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz", + "integrity": "sha1-bqa989hTrlTMuOR7+gvz+QMfsYQ=", + "dev": true + }, + "code-point-at": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/code-point-at/-/code-point-at-1.1.0.tgz", + "integrity": "sha1-DQcLTQQ6W+ozovGkDi7bPZpMz3c=", + "dev": true + }, + "coffeescript": { + "version": "1.10.0", + "resolved": "https://registry.npmjs.org/coffeescript/-/coffeescript-1.10.0.tgz", + "integrity": "sha1-56qDAZF+9iGzXYo580jc3R234z4=", + "dev": true + }, + "collapse-white-space": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/collapse-white-space/-/collapse-white-space-1.0.4.tgz", + "integrity": "sha512-YfQ1tAUZm561vpYD+5eyWN8+UsceQbSrqqlc/6zDY2gtAE+uZLSdkkovhnGpmCThsvKBFakq4EdY/FF93E8XIw==", + "dev": true + }, + "collection-visit": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/collection-visit/-/collection-visit-1.0.0.tgz", + "integrity": "sha1-S8A3PBZLwykbTTaMgpzxqApZ3KA=", + "dev": true, + "requires": { + "map-visit": "^1.0.0", + "object-visit": "^1.0.0" + } + }, + "color-convert": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.1.tgz", + "integrity": "sha1-wSYRB66y8pTr/+ye2eytUppgl+0=", + "dev": true, + "requires": { + "color-name": "^1.1.1" + } + }, + "color-name": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", + "integrity": "sha1-p9BVi9icQveV3UIyj3QIMcpTvCU=", + "dev": true + }, + "colors": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/colors/-/colors-1.1.2.tgz", + "integrity": "sha1-FopHAXVran9RoSzgyXv6KMCE7WM=", + "dev": true + }, + "combined-stream": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.5.tgz", + "integrity": "sha1-k4NwpXtKUd6ix3wV1cX9+JUWQAk=", + "dev": true, + "requires": { + "delayed-stream": "~1.0.0" + } + }, + "commander": { + "version": "2.12.2", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.12.2.tgz", + "integrity": "sha1-D1lGxCftnsDZGka7ne9T5UZQ5VU=", + "dev": true + }, + "compare-versions": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/compare-versions/-/compare-versions-3.2.1.tgz", + "integrity": "sha512-2y2nHcopMG/NAyk6vWXlLs86XeM9sik4jmx1tKIgzMi9/RQ2eo758RGpxQO3ErihHmg0RlQITPqgz73y6s7quA==", + "dev": true + }, + "component-emitter": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/component-emitter/-/component-emitter-1.2.1.tgz", + "integrity": "sha1-E3kY1teCg/ffemt8WmPhQOaUJeY=", + "dev": true + }, + "concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=", + "dev": true + }, + "concat-stream": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-1.6.0.tgz", + "integrity": "sha1-CqxmL9Ur54lk1VMvaUeE5wEQrPc=", + "dev": true, + "requires": { + "inherits": "^2.0.3", + "readable-stream": "^2.2.2", + "typedarray": "^0.0.6" + } + }, + "config": { + "version": "1.30.0", + "resolved": "https://registry.npmjs.org/config/-/config-1.30.0.tgz", + "integrity": "sha1-HWCp81NIoTwXV5jThOgaWhbDum4=", + "dev": true, + "requires": { + "json5": "0.4.0", + "os-homedir": "1.0.2" + }, + "dependencies": { + "json5": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/json5/-/json5-0.4.0.tgz", + "integrity": "sha1-BUNS5MTIDIbAkjh31EneF2pzLI0=", + "dev": true + } + } + }, + "console-browserify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/console-browserify/-/console-browserify-1.1.0.tgz", + "integrity": "sha1-8CQcRXMKn8YyOyBtvzjtx0HQuxA=", + "dev": true, + "requires": { + "date-now": "^0.1.4" + } + }, + "console-control-strings": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/console-control-strings/-/console-control-strings-1.1.0.tgz", + "integrity": "sha1-PXz0Rk22RG6mRL9LOVB/mFEAjo4=", + "dev": true + }, + "continuable-cache": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/continuable-cache/-/continuable-cache-0.3.1.tgz", + "integrity": "sha1-vXJ6f67XfnH/OYWskzUakSczrQ8=", + "dev": true + }, + "convert-source-map": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-1.5.1.tgz", + "integrity": "sha1-uCeAl7m8IpNl3lxiz1/K7YtVmeU=", + "dev": true + }, + "copy-descriptor": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/copy-descriptor/-/copy-descriptor-0.1.1.tgz", + "integrity": "sha1-Z29us8OZl8LuGsOpJP1hJHSPV40=", + "dev": true + }, + "core-js": { + "version": "2.5.3", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-2.5.3.tgz", + "integrity": "sha1-isw4NFgk8W2DZbfJtCWRaOjtYD4=", + "dev": true + }, + "core-util-is": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz", + "integrity": "sha1-tf1UIgqivFq1eqtxQMlAdUUDwac=", + "dev": true + }, + "cosmiconfig": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-5.0.5.tgz", + "integrity": "sha512-94j37OtvxS5w7qr7Ta6dt67tWdnOxigBVN4VnSxNXFez9o18PGQ0D33SchKP17r9LAcWVTYV72G6vDayAUBFIg==", + "dev": true, + "requires": { + "is-directory": "^0.3.1", + "js-yaml": "^3.9.0", + "parse-json": "^4.0.0" + }, + "dependencies": { + "esprima": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.0.tgz", + "integrity": "sha512-oftTcaMu/EGrEIu904mWteKIv8vMuOgGYo7EhVJJN00R/EED9DCua/xxHRdYnKtcECzVg7xOWhflvJMnqcFZjw==", + "dev": true + }, + "js-yaml": { + "version": "3.12.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.12.0.tgz", + "integrity": "sha512-PIt2cnwmPfL4hKNwqeiuz4bKfnzHTBv6HyVgjahA6mPLwPDzjDWrplJBMjHUFxku/N3FlmrbyPclad+I+4mJ3A==", + "dev": true, + "requires": { + "argparse": "^1.0.7", + "esprima": "^4.0.0" + } + }, + "parse-json": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-4.0.0.tgz", + "integrity": "sha1-vjX1Qlvh9/bHRxhPmKeIy5lHfuA=", + "dev": true, + "requires": { + "error-ex": "^1.3.1", + "json-parse-better-errors": "^1.0.1" + } + } + } + }, + "cross-env": { + "version": "5.1.6", + "resolved": "https://registry.npmjs.org/cross-env/-/cross-env-5.1.6.tgz", + "integrity": "sha512-VWTDq+G4v383SzgRS7jsAVWqEWF0aKZpDz1GVjhONvPRgHB1LnxP2sXUVFKbykHkPSnfRKS8YdiDevWFwZmQ9g==", + "dev": true, + "requires": { + "cross-spawn": "^5.1.0", + "is-windows": "^1.0.0" + } + }, + "cross-spawn": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-5.1.0.tgz", + "integrity": "sha1-6L0O/uWPz/b4+UUQoKVUu/ojVEk=", + "dev": true, + "requires": { + "lru-cache": "^4.0.1", + "shebang-command": "^1.2.0", + "which": "^1.2.9" + } + }, + "cryptiles": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/cryptiles/-/cryptiles-2.0.5.tgz", + "integrity": "sha1-O9/s3GCBR8HGcgL6KR59ylnqo7g=", + "dev": true, + "requires": { + "boom": "2.x.x" + } + }, + "currently-unhandled": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/currently-unhandled/-/currently-unhandled-0.4.1.tgz", + "integrity": "sha1-mI3zP+qxke95mmE2nddsF635V+o=", + "dev": true, + "requires": { + "array-find-index": "^1.0.1" + } + }, + "dashdash": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/dashdash/-/dashdash-1.14.1.tgz", + "integrity": "sha1-hTz6D3y+L+1d4gMmuN1YEDX24vA=", + "dev": true, + "requires": { + "assert-plus": "^1.0.0" + } + }, + "date-now": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/date-now/-/date-now-0.1.4.tgz", + "integrity": "sha1-6vQ5/U1ISK105cx9vvIAZyueNFs=", + "dev": true + }, + "dateformat": { + "version": "1.0.12", + "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-1.0.12.tgz", + "integrity": "sha1-nxJLZ1lMk3/3BpMuSmQsyo27/uk=", + "dev": true, + "requires": { + "get-stdin": "^4.0.1", + "meow": "^3.3.0" + } + }, + "debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha1-XRKFFd8TT/Mn6QpMk/Tgd6U2NB8=", + "dev": true, + "requires": { + "ms": "2.0.0" + } + }, + "decamelize": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz", + "integrity": "sha1-9lNNFRSCabIDUue+4m9QH5oZEpA=", + "dev": true + }, + "decamelize-keys": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/decamelize-keys/-/decamelize-keys-1.1.0.tgz", + "integrity": "sha1-0XGoeTMlKAfrPLYdwcFEXQeN8tk=", + "dev": true, + "requires": { + "decamelize": "^1.1.0", + "map-obj": "^1.0.0" + } + }, + "decode-uri-component": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/decode-uri-component/-/decode-uri-component-0.2.0.tgz", + "integrity": "sha1-6zkTMzRYd1y4TNGh+uBiEGu4dUU=", + "dev": true + }, + "deep-eql": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-3.0.1.tgz", + "integrity": "sha512-+QeIQyN5ZuO+3Uk5DYh6/1eKO0m0YmJFGNmFHGACpf1ClL1nmlV/p4gNgbl2pJGxgXb4faqo6UE+M5ACEMyVcw==", + "dev": true, + "requires": { + "type-detect": "^4.0.0" + } + }, + "define-property": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-2.0.2.tgz", + "integrity": "sha512-jwK2UV4cnPpbcG7+VRARKTZPUWowwXA8bzH5NP6ud0oeAxyYPuGZUAC7hMugpCdz4BeSZl2Dl9k66CHJ/46ZYQ==", + "dev": true, + "requires": { + "is-descriptor": "^1.0.2", + "isobject": "^3.0.1" + }, + "dependencies": { + "is-accessor-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz", + "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==", + "dev": true, + "requires": { + "kind-of": "^6.0.0" + } + }, + "is-data-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz", + "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==", + "dev": true, + "requires": { + "kind-of": "^6.0.0" + } + }, + "is-descriptor": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz", + "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==", + "dev": true, + "requires": { + "is-accessor-descriptor": "^1.0.0", + "is-data-descriptor": "^1.0.0", + "kind-of": "^6.0.2" + } + }, + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + }, + "kind-of": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz", + "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==", + "dev": true + } + } + }, + "del": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/del/-/del-3.0.0.tgz", + "integrity": "sha1-U+z2mf/LyzljdpGrE7rxYIGXZuU=", + "dev": true, + "requires": { + "globby": "^6.1.0", + "is-path-cwd": "^1.0.0", + "is-path-in-cwd": "^1.0.0", + "p-map": "^1.1.1", + "pify": "^3.0.0", + "rimraf": "^2.2.8" + } + }, + "delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha1-3zrhmayt+31ECqrgsp4icrJOxhk=", + "dev": true + }, + "delegates": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delegates/-/delegates-1.0.0.tgz", + "integrity": "sha1-hMbhWbgZBP3KWaDvRM2HDTElD5o=", + "dev": true + }, + "deprecate": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/deprecate/-/deprecate-1.0.0.tgz", + "integrity": "sha1-ZhSQ7SQokWpsiIPYg05WRvTkpKg=", + "dev": true + }, + "detect-indent": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/detect-indent/-/detect-indent-4.0.0.tgz", + "integrity": "sha1-920GQ1LN9Docts5hnE7jqUdd4gg=", + "dev": true, + "requires": { + "repeating": "^2.0.0" + } + }, + "diff": { + "version": "3.4.0", + "resolved": "https://registry.npmjs.org/diff/-/diff-3.4.0.tgz", + "integrity": "sha1-sdhVB9rzlkgo3lSzfQ1zumfdpWw=", + "dev": true + }, + "dir-glob": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-2.0.0.tgz", + "integrity": "sha512-37qirFDz8cA5fimp9feo43fSuRo2gHwaIn6dXL8Ber1dGwUosDrGZeCCXq57WnIqE4aQ+u3eQZzsk1yOzhdwag==", + "dev": true, + "requires": { + "arrify": "^1.0.1", + "path-type": "^3.0.0" + }, + "dependencies": { + "path-type": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-3.0.0.tgz", + "integrity": "sha512-T2ZUsdZFHgA3u4e5PfPbjd7HDDpxPnQb5jN0SrDsjNSuVXHJqtwTnWqG0B1jZrgmJ/7lj1EmVIByWt1gxGkWvg==", + "dev": true, + "requires": { + "pify": "^3.0.0" + } + } + } + }, + "dom-serializer": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-0.1.0.tgz", + "integrity": "sha1-BzxpdUbOB4DOI75KKOKT5AvDDII=", + "dev": true, + "requires": { + "domelementtype": "~1.1.1", + "entities": "~1.1.1" + }, + "dependencies": { + "domelementtype": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.1.3.tgz", + "integrity": "sha1-vSh3PiZCiBrsUVRJJCmcXNgiGFs=", + "dev": true + }, + "entities": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-1.1.1.tgz", + "integrity": "sha1-blwtClYhtdra7O+AuQ7ftc13cvA=", + "dev": true + } + } + }, + "domelementtype": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.3.0.tgz", + "integrity": "sha1-sXrtguirWeUt2cGbF1bg/BhyBMI=", + "dev": true + }, + "domhandler": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-2.3.0.tgz", + "integrity": "sha1-LeWaCCLVAn+r/28DLCsloqir5zg=", + "dev": true, + "requires": { + "domelementtype": "1" + } + }, + "domutils": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.5.1.tgz", + "integrity": "sha1-3NhIiib1Y9YQeeSMn3t+Mjc2gs8=", + "dev": true, + "requires": { + "dom-serializer": "0", + "domelementtype": "1" + } + }, + "dot-prop": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/dot-prop/-/dot-prop-4.2.0.tgz", + "integrity": "sha512-tUMXrxlExSW6U2EXiiKGSBVdYgtV8qlHL+C10TsW4PURY/ic+eaysnSkwB4kA/mBlCyy/IKDJ+Lc3wbWeaXtuQ==", + "dev": true, + "requires": { + "is-obj": "^1.0.0" + } + }, + "duplexer": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/duplexer/-/duplexer-0.1.1.tgz", + "integrity": "sha1-rOb/gIwc5mtX0ev5eXessCM0z8E=", + "dev": true + }, + "each-async": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/each-async/-/each-async-1.1.1.tgz", + "integrity": "sha1-3uUim98KtrogEqOV4bhpq/iBNHM=", + "dev": true, + "requires": { + "onetime": "^1.0.0", + "set-immediate-shim": "^1.0.0" + } + }, + "ecc-jsbn": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/ecc-jsbn/-/ecc-jsbn-0.1.1.tgz", + "integrity": "sha1-D8c6ntXw1Tw4GTOYUj735UN3dQU=", + "dev": true, + "optional": true, + "requires": { + "jsbn": "~0.1.0" + } + }, + "electron-to-chromium": { + "version": "1.3.48", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.3.48.tgz", + "integrity": "sha1-07DYWTgUBE4JLs4hCPw6ya6kuQA=", + "dev": true + }, + "encoding": { + "version": "0.1.12", + "resolved": "https://registry.npmjs.org/encoding/-/encoding-0.1.12.tgz", + "integrity": "sha1-U4tm8+5izRq1HsMjgp0flIDHS+s=", + "dev": true, + "requires": { + "iconv-lite": "~0.4.13" + } + }, + "entities": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-1.0.0.tgz", + "integrity": "sha1-sph6o4ITR/zeZCsk/fyeT7cSvyY=", + "dev": true + }, + "error": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/error/-/error-7.0.2.tgz", + "integrity": "sha1-pfdf/02ZJhJt2sDqXcOOaJFTywI=", + "dev": true, + "requires": { + "string-template": "~0.2.1", + "xtend": "~4.0.0" + } + }, + "error-ex": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.1.tgz", + "integrity": "sha1-+FWobOYa3E6GIcPNoh56dhLDqNw=", + "dev": true, + "requires": { + "is-arrayish": "^0.2.1" + } + }, + "es6-promise": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-3.0.2.tgz", + "integrity": "sha1-AQ1YWEI6XxGJeWZfRkhqlcbuK7Y=", + "dev": true + }, + "es6-promisify": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/es6-promisify/-/es6-promisify-5.0.0.tgz", + "integrity": "sha1-UQnWLz5W6pZ8S2NQWu8IKRyKUgM=", + "dev": true, + "requires": { + "es6-promise": "^4.0.3" + }, + "dependencies": { + "es6-promise": { + "version": "4.2.4", + "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-4.2.4.tgz", + "integrity": "sha512-/NdNZVJg+uZgtm9eS3O6lrOLYmQag2DjdEXuPaHlZ6RuVqgqaVZfgYCepEIKsLqwdQArOPtC3XzRLqGGfT8KQQ==", + "dev": true + } + } + }, + "escape-string-regexp": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", + "integrity": "sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=", + "dev": true + }, + "eslint-scope": { + "version": "3.7.1", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-3.7.1.tgz", + "integrity": "sha1-PWPD7f2gLgbgGkUq2IyqzHzctug=", + "dev": true, + "requires": { + "esrecurse": "^4.1.0", + "estraverse": "^4.1.1" + } + }, + "eslint-visitor-keys": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-1.0.0.tgz", + "integrity": "sha512-qzm/XxIbxm/FHyH341ZrbnMUpe+5Bocte9xkmFMzPMjRaZMcXww+MpBptFvtU+79L362nqiLhekCxCxDPaUMBQ==", + "dev": true + }, + "esprima": { + "version": "2.7.3", + "resolved": "https://registry.npmjs.org/esprima/-/esprima-2.7.3.tgz", + "integrity": "sha1-luO3DVd59q1JzQMmc9HDEnZ7pYE=", + "dev": true + }, + "esrecurse": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.2.1.tgz", + "integrity": "sha512-64RBB++fIOAXPw3P9cy89qfMlvZEXZkqqJkjqqXIvzP5ezRZjW+lPWjw35UX/3EhUPFYbg5ER4JYgDw4007/DQ==", + "dev": true, + "requires": { + "estraverse": "^4.1.0" + } + }, + "estraverse": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.2.0.tgz", + "integrity": "sha1-De4/7TH81GlhjOc0IJn8GvoL2xM=", + "dev": true + }, + "esutils": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.2.tgz", + "integrity": "sha1-Cr9PHKpbyx96nYrMbepPqqBLrJs=", + "dev": true + }, + "eventemitter2": { + "version": "0.4.14", + "resolved": "https://registry.npmjs.org/eventemitter2/-/eventemitter2-0.4.14.tgz", + "integrity": "sha1-j2G3XN4BKy6esoTUVFWDtWQ7Yas=", + "dev": true + }, + "execall": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/execall/-/execall-1.0.0.tgz", + "integrity": "sha1-c9CQTjlbPKsGWLCNCewlMH8pu3M=", + "dev": true, + "requires": { + "clone-regexp": "^1.0.0" + } + }, + "exit": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz", + "integrity": "sha1-BjJjj42HfMghB9MKD/8aF8uhzQw=", + "dev": true + }, + "exit-hook": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/exit-hook/-/exit-hook-1.1.1.tgz", + "integrity": "sha1-8FyiM7SMBdVP/wd2XfhQfpXAL/g=", + "dev": true + }, + "expand-brackets": { + "version": "0.1.5", + "resolved": "https://registry.npmjs.org/expand-brackets/-/expand-brackets-0.1.5.tgz", + "integrity": "sha1-3wcoTjQqgHzXM6xa9yQR5YHRF3s=", + "dev": true, + "requires": { + "is-posix-bracket": "^0.1.0" + } + }, + "expand-range": { + "version": "1.8.2", + "resolved": "https://registry.npmjs.org/expand-range/-/expand-range-1.8.2.tgz", + "integrity": "sha1-opnv/TNf4nIeuujiV+x5ZE/IUzc=", + "dev": true, + "requires": { + "fill-range": "^2.1.0" + } + }, + "extend": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.1.tgz", + "integrity": "sha1-p1Xqe8Gt/MWjHOfnYtuq3F5jZEQ=", + "dev": true + }, + "extend-shallow": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-3.0.2.tgz", + "integrity": "sha1-Jqcarwc7OfshJxcnRhMcJwQCjbg=", + "dev": true, + "requires": { + "assign-symbols": "^1.0.0", + "is-extendable": "^1.0.1" + }, + "dependencies": { + "is-extendable": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz", + "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==", + "dev": true, + "requires": { + "is-plain-object": "^2.0.4" + } + } + } + }, + "extglob": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/extglob/-/extglob-0.3.2.tgz", + "integrity": "sha1-Lhj/PS9JqydlzskCPwEdqo2DSaE=", + "dev": true, + "requires": { + "is-extglob": "^1.0.0" + } + }, + "extract-zip": { + "version": "1.6.7", + "resolved": "https://registry.npmjs.org/extract-zip/-/extract-zip-1.6.7.tgz", + "integrity": "sha1-qEC0uK9kAyZMjbV/Txp0Mz74H+k=", + "dev": true, + "requires": { + "concat-stream": "1.6.2", + "debug": "2.6.9", + "mkdirp": "0.5.1", + "yauzl": "2.4.1" + }, + "dependencies": { + "concat-stream": { + "version": "1.6.2", + "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-1.6.2.tgz", + "integrity": "sha512-27HBghJxjiZtIk3Ycvn/4kbJk/1uZuJFfuPEns6LaEvpvG1f0hTea8lilrouyo9mVc2GWdcEZ8OLoGmSADlrCw==", + "dev": true, + "requires": { + "buffer-from": "^1.0.0", + "inherits": "^2.0.3", + "readable-stream": "^2.2.2", + "typedarray": "^0.0.6" + } + } + } + }, + "extsprintf": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/extsprintf/-/extsprintf-1.3.0.tgz", + "integrity": "sha1-lpGEQOMEGnpBT4xS48V06zw+HgU=", + "dev": true + }, + "fast-deep-equal": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-1.1.0.tgz", + "integrity": "sha1-wFNHeBfIa1HaqFPIHgWbcz0CNhQ=", + "dev": true + }, + "fast-glob": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-2.2.2.tgz", + "integrity": "sha512-TR6zxCKftDQnUAPvkrCWdBgDq/gbqx8A3ApnBrR5rMvpp6+KMJI0Igw7fkWPgeVK0uhRXTXdvO3O+YP0CaUX2g==", + "dev": true, + "requires": { + "@mrmlnc/readdir-enhanced": "^2.2.1", + "@nodelib/fs.stat": "^1.0.1", + "glob-parent": "^3.1.0", + "is-glob": "^4.0.0", + "merge2": "^1.2.1", + "micromatch": "^3.1.10" + }, + "dependencies": { + "arr-diff": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/arr-diff/-/arr-diff-4.0.0.tgz", + "integrity": "sha1-1kYQdP6/7HHn4VI1dhoyml3HxSA=", + "dev": true + }, + "array-unique": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/array-unique/-/array-unique-0.3.2.tgz", + "integrity": "sha1-qJS3XUvE9s1nnvMkSp/Y9Gri1Cg=", + "dev": true + }, + "braces": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/braces/-/braces-2.3.2.tgz", + "integrity": "sha512-aNdbnj9P8PjdXU4ybaWLK2IF3jc/EoDYbC7AazW6to3TRsfXxscC9UXOB5iDiEQrkyIbWp2SLQda4+QAa7nc3w==", + "dev": true, + "requires": { + "arr-flatten": "^1.1.0", + "array-unique": "^0.3.2", + "extend-shallow": "^2.0.1", + "fill-range": "^4.0.0", + "isobject": "^3.0.1", + "repeat-element": "^1.1.2", + "snapdragon": "^0.8.1", + "snapdragon-node": "^2.0.1", + "split-string": "^3.0.2", + "to-regex": "^3.0.1" + }, + "dependencies": { + "extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=", + "dev": true, + "requires": { + "is-extendable": "^0.1.0" + } + } + } + }, + "expand-brackets": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/expand-brackets/-/expand-brackets-2.1.4.tgz", + "integrity": "sha1-t3c14xXOMPa27/D4OwQVGiJEliI=", + "dev": true, + "requires": { + "debug": "^2.3.3", + "define-property": "^0.2.5", + "extend-shallow": "^2.0.1", + "posix-character-classes": "^0.1.0", + "regex-not": "^1.0.0", + "snapdragon": "^0.8.1", + "to-regex": "^3.0.1" + }, + "dependencies": { + "define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=", + "dev": true, + "requires": { + "is-descriptor": "^0.1.0" + } + }, + "extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=", + "dev": true, + "requires": { + "is-extendable": "^0.1.0" + } + }, + "is-accessor-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz", + "integrity": "sha1-qeEss66Nh2cn7u84Q/igiXtcmNY=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + }, + "dependencies": { + "kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", + "dev": true, + "requires": { + "is-buffer": "^1.1.5" + } + } + } + }, + "is-data-descriptor": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz", + "integrity": "sha1-C17mSDiOLIYCgueT8YVv7D8wG1Y=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + }, + "dependencies": { + "kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", + "dev": true, + "requires": { + "is-buffer": "^1.1.5" + } + } + } + }, + "is-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz", + "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==", + "dev": true, + "requires": { + "is-accessor-descriptor": "^0.1.6", + "is-data-descriptor": "^0.1.4", + "kind-of": "^5.0.0" + } + }, + "kind-of": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz", + "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw==", + "dev": true + } + } + }, + "extglob": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/extglob/-/extglob-2.0.4.tgz", + "integrity": "sha512-Nmb6QXkELsuBr24CJSkilo6UHHgbekK5UiZgfE6UHD3Eb27YC6oD+bhcT+tJ6cl8dmsgdQxnWlcry8ksBIBLpw==", + "dev": true, + "requires": { + "array-unique": "^0.3.2", + "define-property": "^1.0.0", + "expand-brackets": "^2.1.4", + "extend-shallow": "^2.0.1", + "fragment-cache": "^0.2.1", + "regex-not": "^1.0.0", + "snapdragon": "^0.8.1", + "to-regex": "^3.0.1" + }, + "dependencies": { + "define-property": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz", + "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=", + "dev": true, + "requires": { + "is-descriptor": "^1.0.0" + } + }, + "extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=", + "dev": true, + "requires": { + "is-extendable": "^0.1.0" + } + } + } + }, + "fill-range": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-4.0.0.tgz", + "integrity": "sha1-1USBHUKPmOsGpj3EAtJAPDKMOPc=", + "dev": true, + "requires": { + "extend-shallow": "^2.0.1", + "is-number": "^3.0.0", + "repeat-string": "^1.6.1", + "to-regex-range": "^2.1.0" + }, + "dependencies": { + "extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=", + "dev": true, + "requires": { + "is-extendable": "^0.1.0" + } + } + } + }, + "glob-parent": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-3.1.0.tgz", + "integrity": "sha1-nmr2KZ2NO9K9QEMIMr0RPfkGxa4=", + "dev": true, + "requires": { + "is-glob": "^3.1.0", + "path-dirname": "^1.0.0" + }, + "dependencies": { + "is-glob": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-3.1.0.tgz", + "integrity": "sha1-e6WuJCF4BKxwcHuWkiVnSGzD6Eo=", + "dev": true, + "requires": { + "is-extglob": "^2.1.0" + } + } + } + }, + "is-accessor-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz", + "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==", + "dev": true, + "requires": { + "kind-of": "^6.0.0" + } + }, + "is-data-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz", + "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==", + "dev": true, + "requires": { + "kind-of": "^6.0.0" + } + }, + "is-descriptor": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz", + "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==", + "dev": true, + "requires": { + "is-accessor-descriptor": "^1.0.0", + "is-data-descriptor": "^1.0.0", + "kind-of": "^6.0.2" + } + }, + "is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha1-qIwCU1eR8C7TfHahueqXc8gz+MI=", + "dev": true + }, + "is-glob": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.0.tgz", + "integrity": "sha1-lSHHaEXMJhCoUgPd8ICpWML/q8A=", + "dev": true, + "requires": { + "is-extglob": "^2.1.1" + } + }, + "is-number": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-3.0.0.tgz", + "integrity": "sha1-JP1iAaR4LPUFYcgQJ2r8fRLXEZU=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + }, + "dependencies": { + "kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", + "dev": true, + "requires": { + "is-buffer": "^1.1.5" + } + } + } + }, + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + }, + "kind-of": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz", + "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==", + "dev": true + }, + "micromatch": { + "version": "3.1.10", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-3.1.10.tgz", + "integrity": "sha512-MWikgl9n9M3w+bpsY3He8L+w9eF9338xRl8IAO5viDizwSzziFEyUzo2xrrloB64ADbTf8uA8vRqqttDTOmccg==", + "dev": true, + "requires": { + "arr-diff": "^4.0.0", + "array-unique": "^0.3.2", + "braces": "^2.3.1", + "define-property": "^2.0.2", + "extend-shallow": "^3.0.2", + "extglob": "^2.0.4", + "fragment-cache": "^0.2.1", + "kind-of": "^6.0.2", + "nanomatch": "^1.2.9", + "object.pick": "^1.3.0", + "regex-not": "^1.0.0", + "snapdragon": "^0.8.1", + "to-regex": "^3.0.2" + } + } + } + }, + "fast-json-stable-stringify": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.0.0.tgz", + "integrity": "sha1-1RQsDK7msRifh9OnYREGT4bIu/I=", + "dev": true + }, + "faye-websocket": { + "version": "0.10.0", + "resolved": "https://registry.npmjs.org/faye-websocket/-/faye-websocket-0.10.0.tgz", + "integrity": "sha1-TkkvjQTftviQA1B/btvy1QHnxvQ=", + "dev": true, + "requires": { + "websocket-driver": ">=0.5.1" + } + }, + "fd-slicer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/fd-slicer/-/fd-slicer-1.0.1.tgz", + "integrity": "sha1-i1vL2ewyfFBBv5qwI/1nUPEXfmU=", + "dev": true, + "requires": { + "pend": "~1.2.0" + } + }, + "figures": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/figures/-/figures-1.7.0.tgz", + "integrity": "sha1-y+Hjr/zxzUS4DK3+0o3Hk6lwHS4=", + "dev": true, + "requires": { + "escape-string-regexp": "^1.0.5", + "object-assign": "^4.1.0" + } + }, + "file-entry-cache": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-2.0.0.tgz", + "integrity": "sha1-w5KZDD5oR4PYOLjISkXYoEhFg2E=", + "dev": true, + "requires": { + "flat-cache": "^1.2.1", + "object-assign": "^4.0.1" + } + }, + "filename-regex": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/filename-regex/-/filename-regex-2.0.1.tgz", + "integrity": "sha1-wcS5vuPglyXdsQa3XB4wH+LxiyY=", + "dev": true + }, + "fileset": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/fileset/-/fileset-2.0.3.tgz", + "integrity": "sha1-jnVIqW08wjJ+5eZ0FocjozO7oqA=", + "dev": true, + "requires": { + "glob": "^7.0.3", + "minimatch": "^3.0.3" + } + }, + "fill-range": { + "version": "2.2.4", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-2.2.4.tgz", + "integrity": "sha512-cnrcCbj01+j2gTG921VZPnHbjmdAf8oQV/iGeV2kZxGSyfYjjTyY79ErsK1WJWMpw6DaApEX72binqJE+/d+5Q==", + "dev": true, + "requires": { + "is-number": "^2.1.0", + "isobject": "^2.0.0", + "randomatic": "^3.0.0", + "repeat-element": "^1.1.2", + "repeat-string": "^1.5.2" + }, + "dependencies": { + "kind-of": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz", + "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==", + "dev": true + }, + "randomatic": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/randomatic/-/randomatic-3.0.0.tgz", + "integrity": "sha512-VdxFOIEY3mNO5PtSRkkle/hPJDHvQhK21oa73K4yAc9qmp6N429gAyF1gZMOTMeS0/AYzaV/2Trcef+NaIonSA==", + "dev": true, + "requires": { + "is-number": "^4.0.0", + "kind-of": "^6.0.0", + "math-random": "^1.0.1" + }, + "dependencies": { + "is-number": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-4.0.0.tgz", + "integrity": "sha512-rSklcAIlf1OmFdyAqbnWTLVelsQ58uvZ66S/ZyawjWqIviTWCjg2PzVGw8WUA+nNuPTqb4wgA+NszrJ+08LlgQ==", + "dev": true + } + } + } + } + }, + "find-up": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-1.1.2.tgz", + "integrity": "sha1-ay6YIrGizgpgq2TWEOzK1TyyTQ8=", + "dev": true, + "requires": { + "path-exists": "^2.0.0", + "pinkie-promise": "^2.0.0" + } + }, + "findup": { + "version": "0.1.5", + "resolved": "https://registry.npmjs.org/findup/-/findup-0.1.5.tgz", + "integrity": "sha1-itkpozk7rGJ5V6fl3kYjsGsOLOs=", + "dev": true, + "requires": { + "colors": "~0.6.0-1", + "commander": "~2.1.0" + }, + "dependencies": { + "colors": { + "version": "0.6.2", + "resolved": "https://registry.npmjs.org/colors/-/colors-0.6.2.tgz", + "integrity": "sha1-JCP+ZnisDF2uiFLl0OW+CMmXq8w=", + "dev": true + }, + "commander": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.1.0.tgz", + "integrity": "sha1-0SG7roYNmZKj1Re6lvVliOR8Z4E=", + "dev": true + } + } + }, + "findup-sync": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.3.0.tgz", + "integrity": "sha1-N5MKpdgWt3fANEXhlmzGeQpMCxY=", + "dev": true, + "requires": { + "glob": "~5.0.0" + }, + "dependencies": { + "glob": { + "version": "5.0.15", + "resolved": "https://registry.npmjs.org/glob/-/glob-5.0.15.tgz", + "integrity": "sha1-G8k2ueAvSmA/zCIuz3Yz0wuLk7E=", + "dev": true, + "requires": { + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "2 || 3", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + } + } + } + }, + "flat-cache": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-1.3.0.tgz", + "integrity": "sha1-0wMLMrOBVPTjt+nHCfSQ9++XxIE=", + "dev": true, + "requires": { + "circular-json": "^0.3.1", + "del": "^2.0.2", + "graceful-fs": "^4.1.2", + "write": "^0.2.1" + }, + "dependencies": { + "del": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/del/-/del-2.2.2.tgz", + "integrity": "sha1-wSyYHQZ4RshLyvhiz/kw2Qf/0ag=", + "dev": true, + "requires": { + "globby": "^5.0.0", + "is-path-cwd": "^1.0.0", + "is-path-in-cwd": "^1.0.0", + "object-assign": "^4.0.1", + "pify": "^2.0.0", + "pinkie-promise": "^2.0.0", + "rimraf": "^2.2.8" + } + }, + "globby": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/globby/-/globby-5.0.0.tgz", + "integrity": "sha1-69hGZ8oNuzMLmbz8aOrCvFQ3Dg0=", + "dev": true, + "requires": { + "array-union": "^1.0.1", + "arrify": "^1.0.0", + "glob": "^7.0.3", + "object-assign": "^4.0.1", + "pify": "^2.0.0", + "pinkie-promise": "^2.0.0" + } + }, + "pify": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=", + "dev": true + } + } + }, + "for-in": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/for-in/-/for-in-1.0.2.tgz", + "integrity": "sha1-gQaNKVqBQuwKxybG4iAMMPttXoA=", + "dev": true + }, + "for-own": { + "version": "0.1.5", + "resolved": "https://registry.npmjs.org/for-own/-/for-own-0.1.5.tgz", + "integrity": "sha1-UmXGgaTylNq78XyVCbZ2OqhFEM4=", + "dev": true, + "requires": { + "for-in": "^1.0.1" + } + }, + "forever-agent": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/forever-agent/-/forever-agent-0.6.1.tgz", + "integrity": "sha1-+8cfDEGt6zf5bFd60e1C2P2sypE=", + "dev": true + }, + "form-data": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.3.2.tgz", + "integrity": "sha1-SXBJi+YEwgwAXU9cI67NIda0kJk=", + "dev": true, + "requires": { + "asynckit": "^0.4.0", + "combined-stream": "1.0.6", + "mime-types": "^2.1.12" + }, + "dependencies": { + "combined-stream": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.6.tgz", + "integrity": "sha1-cj599ugBrFYTETp+RFqbactjKBg=", + "dev": true, + "requires": { + "delayed-stream": "~1.0.0" + } + } + } + }, + "fragment-cache": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/fragment-cache/-/fragment-cache-0.2.1.tgz", + "integrity": "sha1-QpD60n8T6Jvn8zeZxrxaCr//DRk=", + "dev": true, + "requires": { + "map-cache": "^0.2.2" + } + }, + "fs-extra": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-5.0.0.tgz", + "integrity": "sha1-QU0BEM3QZwVzTQVWUsVBEmDDGr0=", + "dev": true, + "requires": { + "graceful-fs": "^4.1.2", + "jsonfile": "^4.0.0", + "universalify": "^0.1.0" + } + }, + "fs-readdir-recursive": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fs-readdir-recursive/-/fs-readdir-recursive-1.1.0.tgz", + "integrity": "sha1-4y/AMKLM7kSmtTcTCNpUvgs5fSc=", + "dev": true + }, + "fs.realpath": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", + "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=", + "dev": true + }, + "fsevents": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-1.2.4.tgz", + "integrity": "sha512-z8H8/diyk76B7q5wg+Ud0+CqzcAF3mBBI/bA5ne5zrRUUIvNkJY//D3BqyH571KuAC4Nr7Rw7CjWX4r0y9DvNg==", + "dev": true, + "optional": true, + "requires": { + "nan": "^2.9.2", + "node-pre-gyp": "^0.10.0" + }, + "dependencies": { + "abbrev": { + "version": "1.1.1", + "bundled": true, + "dev": true, + "optional": true + }, + "ansi-regex": { + "version": "2.1.1", + "bundled": true, + "dev": true + }, + "aproba": { + "version": "1.2.0", + "bundled": true, + "dev": true, + "optional": true + }, + "are-we-there-yet": { + "version": "1.1.4", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "delegates": "^1.0.0", + "readable-stream": "^2.0.6" + } + }, + "balanced-match": { + "version": "1.0.0", + "bundled": true, + "dev": true + }, + "brace-expansion": { + "version": "1.1.11", + "bundled": true, + "dev": true, + "requires": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "chownr": { + "version": "1.0.1", + "bundled": true, + "dev": true, + "optional": true + }, + "code-point-at": { + "version": "1.1.0", + "bundled": true, + "dev": true + }, + "concat-map": { + "version": "0.0.1", + "bundled": true, + "dev": true + }, + "console-control-strings": { + "version": "1.1.0", + "bundled": true, + "dev": true + }, + "core-util-is": { + "version": "1.0.2", + "bundled": true, + "dev": true, + "optional": true + }, + "debug": { + "version": "2.6.9", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "ms": "2.0.0" + } + }, + "deep-extend": { + "version": "0.5.1", + "bundled": true, + "dev": true, + "optional": true + }, + "delegates": { + "version": "1.0.0", + "bundled": true, + "dev": true, + "optional": true + }, + "detect-libc": { + "version": "1.0.3", + "bundled": true, + "dev": true, + "optional": true + }, + "fs-minipass": { + "version": "1.2.5", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "minipass": "^2.2.1" + } + }, + "fs.realpath": { + "version": "1.0.0", + "bundled": true, + "dev": true, + "optional": true + }, + "gauge": { + "version": "2.7.4", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "aproba": "^1.0.3", + "console-control-strings": "^1.0.0", + "has-unicode": "^2.0.0", + "object-assign": "^4.1.0", + "signal-exit": "^3.0.0", + "string-width": "^1.0.1", + "strip-ansi": "^3.0.1", + "wide-align": "^1.1.0" + } + }, + "glob": { + "version": "7.1.2", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.0.4", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + } + }, + "has-unicode": { + "version": "2.0.1", + "bundled": true, + "dev": true, + "optional": true + }, + "iconv-lite": { + "version": "0.4.21", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "safer-buffer": "^2.1.0" + } + }, + "ignore-walk": { + "version": "3.0.1", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "minimatch": "^3.0.4" + } + }, + "inflight": { + "version": "1.0.6", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "once": "^1.3.0", + "wrappy": "1" + } + }, + "inherits": { + "version": "2.0.3", + "bundled": true, + "dev": true + }, + "ini": { + "version": "1.3.5", + "bundled": true, + "dev": true, + "optional": true + }, + "is-fullwidth-code-point": { + "version": "1.0.0", + "bundled": true, + "dev": true, + "requires": { + "number-is-nan": "^1.0.0" + } + }, + "isarray": { + "version": "1.0.0", + "bundled": true, + "dev": true, + "optional": true + }, + "minimatch": { + "version": "3.0.4", + "bundled": true, + "dev": true, + "requires": { + "brace-expansion": "^1.1.7" + } + }, + "minimist": { + "version": "0.0.8", + "bundled": true, + "dev": true + }, + "minipass": { + "version": "2.2.4", + "bundled": true, + "dev": true, + "requires": { + "safe-buffer": "^5.1.1", + "yallist": "^3.0.0" + } + }, + "minizlib": { + "version": "1.1.0", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "minipass": "^2.2.1" + } + }, + "mkdirp": { + "version": "0.5.1", + "bundled": true, + "dev": true, + "requires": { + "minimist": "0.0.8" + } + }, + "ms": { + "version": "2.0.0", + "bundled": true, + "dev": true, + "optional": true + }, + "nan": { + "version": "2.10.0", + "resolved": "https://registry.npmjs.org/nan/-/nan-2.10.0.tgz", + "integrity": "sha512-bAdJv7fBLhWC+/Bls0Oza+mvTaNQtP+1RyhhhvD95pgUJz6XM5IzgmxOkItJ9tkoCiplvAnXI1tNmmUD/eScyA==", + "dev": true, + "optional": true + }, + "needle": { + "version": "2.2.0", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "debug": "^2.1.2", + "iconv-lite": "^0.4.4", + "sax": "^1.2.4" + } + }, + "node-pre-gyp": { + "version": "0.10.0", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "detect-libc": "^1.0.2", + "mkdirp": "^0.5.1", + "needle": "^2.2.0", + "nopt": "^4.0.1", + "npm-packlist": "^1.1.6", + "npmlog": "^4.0.2", + "rc": "^1.1.7", + "rimraf": "^2.6.1", + "semver": "^5.3.0", + "tar": "^4" + } + }, + "nopt": { + "version": "4.0.1", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "abbrev": "1", + "osenv": "^0.1.4" + } + }, + "npm-bundled": { + "version": "1.0.3", + "bundled": true, + "dev": true, + "optional": true + }, + "npm-packlist": { + "version": "1.1.10", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "ignore-walk": "^3.0.1", + "npm-bundled": "^1.0.1" + } + }, + "npmlog": { + "version": "4.1.2", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "are-we-there-yet": "~1.1.2", + "console-control-strings": "~1.1.0", + "gauge": "~2.7.3", + "set-blocking": "~2.0.0" + } + }, + "number-is-nan": { + "version": "1.0.1", + "bundled": true, + "dev": true + }, + "object-assign": { + "version": "4.1.1", + "bundled": true, + "dev": true, + "optional": true + }, + "once": { + "version": "1.4.0", + "bundled": true, + "dev": true, + "requires": { + "wrappy": "1" + } + }, + "os-homedir": { + "version": "1.0.2", + "bundled": true, + "dev": true, + "optional": true + }, + "os-tmpdir": { + "version": "1.0.2", + "bundled": true, + "dev": true, + "optional": true + }, + "osenv": { + "version": "0.1.5", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "os-homedir": "^1.0.0", + "os-tmpdir": "^1.0.0" + } + }, + "path-is-absolute": { + "version": "1.0.1", + "bundled": true, + "dev": true, + "optional": true + }, + "process-nextick-args": { + "version": "2.0.0", + "bundled": true, + "dev": true, + "optional": true + }, + "rc": { + "version": "1.2.7", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "deep-extend": "^0.5.1", + "ini": "~1.3.0", + "minimist": "^1.2.0", + "strip-json-comments": "~2.0.1" + }, + "dependencies": { + "minimist": { + "version": "1.2.0", + "bundled": true, + "dev": true, + "optional": true + } + } + }, + "readable-stream": { + "version": "2.3.6", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.3", + "isarray": "~1.0.0", + "process-nextick-args": "~2.0.0", + "safe-buffer": "~5.1.1", + "string_decoder": "~1.1.1", + "util-deprecate": "~1.0.1" + } + }, + "rimraf": { + "version": "2.6.2", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "glob": "^7.0.5" + } + }, + "safe-buffer": { + "version": "5.1.1", + "bundled": true, + "dev": true + }, + "safer-buffer": { + "version": "2.1.2", + "bundled": true, + "dev": true, + "optional": true + }, + "sax": { + "version": "1.2.4", + "bundled": true, + "dev": true, + "optional": true + }, + "semver": { + "version": "5.5.0", + "bundled": true, + "dev": true, + "optional": true + }, + "set-blocking": { + "version": "2.0.0", + "bundled": true, + "dev": true, + "optional": true + }, + "signal-exit": { + "version": "3.0.2", + "bundled": true, + "dev": true, + "optional": true + }, + "string-width": { + "version": "1.0.2", + "bundled": true, + "dev": true, + "requires": { + "code-point-at": "^1.0.0", + "is-fullwidth-code-point": "^1.0.0", + "strip-ansi": "^3.0.0" + } + }, + "string_decoder": { + "version": "1.1.1", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "safe-buffer": "~5.1.0" + } + }, + "strip-ansi": { + "version": "3.0.1", + "bundled": true, + "dev": true, + "requires": { + "ansi-regex": "^2.0.0" + } + }, + "strip-json-comments": { + "version": "2.0.1", + "bundled": true, + "dev": true, + "optional": true + }, + "tar": { + "version": "4.4.1", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "chownr": "^1.0.1", + "fs-minipass": "^1.2.5", + "minipass": "^2.2.4", + "minizlib": "^1.1.0", + "mkdirp": "^0.5.0", + "safe-buffer": "^5.1.1", + "yallist": "^3.0.2" + } + }, + "util-deprecate": { + "version": "1.0.2", + "bundled": true, + "dev": true, + "optional": true + }, + "wide-align": { + "version": "1.1.2", + "bundled": true, + "dev": true, + "optional": true, + "requires": { + "string-width": "^1.0.2" + } + }, + "wrappy": { + "version": "1.0.2", + "bundled": true, + "dev": true + }, + "yallist": { + "version": "3.0.2", + "bundled": true, + "dev": true + } + } + }, + "fstream": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/fstream/-/fstream-1.0.11.tgz", + "integrity": "sha1-XB+x8RdHcRTwYyoOtLcbPLD9MXE=", + "dev": true, + "requires": { + "graceful-fs": "^4.1.2", + "inherits": "~2.0.0", + "mkdirp": ">=0.5 0", + "rimraf": "2" + } + }, + "gauge": { + "version": "2.7.4", + "resolved": "https://registry.npmjs.org/gauge/-/gauge-2.7.4.tgz", + "integrity": "sha1-LANAXHU4w51+s3sxcCLjJfsBi/c=", + "dev": true, + "requires": { + "aproba": "^1.0.3", + "console-control-strings": "^1.0.0", + "has-unicode": "^2.0.0", + "object-assign": "^4.1.0", + "signal-exit": "^3.0.0", + "string-width": "^1.0.1", + "strip-ansi": "^3.0.1", + "wide-align": "^1.1.0" + } + }, + "gaze": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/gaze/-/gaze-1.1.2.tgz", + "integrity": "sha1-hHIkZ3rbiHDWeSV+0ziP22HkAQU=", + "dev": true, + "requires": { + "globule": "^1.0.0" + } + }, + "generate-function": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/generate-function/-/generate-function-2.0.0.tgz", + "integrity": "sha1-aFj+fAlpt9TpCTM3ZHrHn2DfvnQ=", + "dev": true + }, + "generate-object-property": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/generate-object-property/-/generate-object-property-1.2.0.tgz", + "integrity": "sha1-nA4cQDCM6AT0eDYYuTf6iPmdUNA=", + "dev": true, + "requires": { + "is-property": "^1.0.0" + } + }, + "get-caller-file": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-1.0.2.tgz", + "integrity": "sha1-9wLmMSfn4jHBYKgMFVSstw1QR+U=", + "dev": true + }, + "get-func-name": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/get-func-name/-/get-func-name-2.0.0.tgz", + "integrity": "sha1-6td0q+5y4gQJQzoGY2YCPdaIekE=", + "dev": true + }, + "get-stdin": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/get-stdin/-/get-stdin-4.0.1.tgz", + "integrity": "sha1-uWjGsKBDhDJJAui/Gl3zJXmkUP4=", + "dev": true + }, + "get-value": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/get-value/-/get-value-2.0.6.tgz", + "integrity": "sha1-3BXKHGcjh8p2vTesCjlbogQqLCg=", + "dev": true + }, + "getobject": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/getobject/-/getobject-0.1.0.tgz", + "integrity": "sha1-BHpEl4n6Fg0Bj1SG7ZEyC27HiFw=", + "dev": true + }, + "getpass": { + "version": "0.1.7", + "resolved": "https://registry.npmjs.org/getpass/-/getpass-0.1.7.tgz", + "integrity": "sha1-Xv+OPmhNVprkyysSgmBOi6YhSfo=", + "dev": true, + "requires": { + "assert-plus": "^1.0.0" + } + }, + "gettext-parser": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/gettext-parser/-/gettext-parser-1.3.1.tgz", + "integrity": "sha1-dLepnktfqNqrEfpRXopYJIBEihI=", + "dev": true, + "requires": { + "encoding": "^0.1.12", + "safe-buffer": "^5.1.1" + } + }, + "github-contributors-list": { + "version": "https://github.com/woocommerce/github-contributors-list/tarball/master", + "integrity": "sha1-x/jBWtseshWNb8iGGLtEkK64xd8=", + "requires": { + "marked": "~0.3.1", + "merge": "^1.2.0", + "minimist": "0.0.8", + "q": "~1.4.1", + "sprintf-js": "0.0.7" + }, + "dependencies": { + "sprintf-js": { + "version": "0.0.7", + "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-0.0.7.tgz", + "integrity": "sha1-8A14/RYBMICbSrNAwDEPqnElPb0=" + } + } + }, + "glob": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.2.tgz", + "integrity": "sha1-wZyd+aAocC1nhhI4SmVSQExjbRU=", + "dev": true, + "requires": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.0.4", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + } + }, + "glob-base": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/glob-base/-/glob-base-0.3.0.tgz", + "integrity": "sha1-27Fk9iIbHAscz4Kuoyi0l98Oo8Q=", + "dev": true, + "requires": { + "glob-parent": "^2.0.0", + "is-glob": "^2.0.0" + } + }, + "glob-parent": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-2.0.0.tgz", + "integrity": "sha1-gTg9ctsFT8zPUzbaqQLxgvbtuyg=", + "dev": true, + "requires": { + "is-glob": "^2.0.0" + } + }, + "glob-to-regexp": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.3.0.tgz", + "integrity": "sha1-jFoUlNIGbFcMw7/kSWF1rMTVAqs=", + "dev": true + }, + "globals": { + "version": "9.18.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-9.18.0.tgz", + "integrity": "sha1-qjiWs+abSH8X4x7SFD1pqOMMLYo=", + "dev": true + }, + "globby": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/globby/-/globby-6.1.0.tgz", + "integrity": "sha1-9abXDoOV4hyFj7BInWTfAkJNUGw=", + "dev": true, + "requires": { + "array-union": "^1.0.1", + "glob": "^7.0.3", + "object-assign": "^4.0.1", + "pify": "^2.0.0", + "pinkie-promise": "^2.0.0" + }, + "dependencies": { + "pify": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=", + "dev": true + } + } + }, + "globjoin": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/globjoin/-/globjoin-0.1.4.tgz", + "integrity": "sha1-L0SUrIkZ43Z8XLtpHp9GMyQoXUM=", + "dev": true + }, + "globule": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/globule/-/globule-1.2.0.tgz", + "integrity": "sha1-HcScaCLdnoovoAuiopUAboZkvQk=", + "dev": true, + "requires": { + "glob": "~7.1.1", + "lodash": "~4.17.4", + "minimatch": "~3.0.2" + } + }, + "gonzales-pe": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/gonzales-pe/-/gonzales-pe-4.2.3.tgz", + "integrity": "sha512-Kjhohco0esHQnOiqqdJeNz/5fyPkOMD/d6XVjwTAoPGUFh0mCollPUTUTa2OZy4dYNAqlPIQdTiNzJTWdd9Htw==", + "dev": true, + "requires": { + "minimist": "1.1.x" + }, + "dependencies": { + "minimist": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.1.3.tgz", + "integrity": "sha1-O+39kaktOQFvz6ocaB6Pqhoe/ag=", + "dev": true + } + } + }, + "graceful-fs": { + "version": "4.1.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.1.11.tgz", + "integrity": "sha1-Dovf5NHduIVNZOBOp8AOKgJuVlg=", + "dev": true + }, + "growl": { + "version": "1.10.5", + "resolved": "https://registry.npmjs.org/growl/-/growl-1.10.5.tgz", + "integrity": "sha1-8nNdwig2dPpnR4sQGBBZNVw2nl4=", + "dev": true + }, + "grunt": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.0.3.tgz", + "integrity": "sha512-/JzmZNPfKorlCrrmxWqQO4JVodO+DVd5XX4DkocL/1WlLlKVLE9+SdEIempOAxDhWPysLle6afvn/hg7Ck2k9g==", + "dev": true, + "requires": { + "coffeescript": "~1.10.0", + "dateformat": "~1.0.12", + "eventemitter2": "~0.4.13", + "exit": "~0.1.1", + "findup-sync": "~0.3.0", + "glob": "~7.0.0", + "grunt-cli": "~1.2.0", + "grunt-known-options": "~1.1.0", + "grunt-legacy-log": "~2.0.0", + "grunt-legacy-util": "~1.1.1", + "iconv-lite": "~0.4.13", + "js-yaml": "~3.5.2", + "minimatch": "~3.0.2", + "mkdirp": "~0.5.1", + "nopt": "~3.0.6", + "path-is-absolute": "~1.0.0", + "rimraf": "~2.6.2" + }, + "dependencies": { + "glob": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.0.6.tgz", + "integrity": "sha1-IRuvr0nlJbjNkyYNFKsTYVKz9Xo=", + "dev": true, + "requires": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.0.2", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + } + }, + "grunt-cli": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.2.0.tgz", + "integrity": "sha1-VisRnrsGndtGSs4oRVAb6Xs1tqg=", + "dev": true, + "requires": { + "findup-sync": "~0.3.0", + "grunt-known-options": "~1.1.0", + "nopt": "~3.0.6", + "resolve": "~1.1.0" + } + } + } + }, + "grunt-checktextdomain": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/grunt-checktextdomain/-/grunt-checktextdomain-1.0.1.tgz", + "integrity": "sha1-slTQHh3pEwBdTbHFMD2QI7mD4Zs=", + "dev": true, + "requires": { + "chalk": "~0.2.1", + "text-table": "~0.2.0" + }, + "dependencies": { + "ansi-styles": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-0.2.0.tgz", + "integrity": "sha1-NZq0sV3NZLptdHNLcsNjYKmvLBk=", + "dev": true + }, + "chalk": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-0.2.1.tgz", + "integrity": "sha1-dhPhV1FFshOGSD9/SFql/6jL0Qw=", + "dev": true, + "requires": { + "ansi-styles": "~0.2.0", + "has-color": "~0.1.0" + } + } + } + }, + "grunt-contrib-clean": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/grunt-contrib-clean/-/grunt-contrib-clean-1.1.0.tgz", + "integrity": "sha1-Vkq/LQN4qYOhW54/MO51tzjEBjg=", + "dev": true, + "requires": { + "async": "^1.5.2", + "rimraf": "^2.5.1" + } + }, + "grunt-contrib-concat": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/grunt-contrib-concat/-/grunt-contrib-concat-1.0.1.tgz", + "integrity": "sha1-YVCYYwhOhx1+ht5IwBUlntl3Rb0=", + "dev": true, + "requires": { + "chalk": "^1.0.0", + "source-map": "^0.5.3" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "grunt-contrib-cssmin": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/grunt-contrib-cssmin/-/grunt-contrib-cssmin-2.2.1.tgz", + "integrity": "sha1-ZMvr5gE0vBJwykFUUU7EAHzBb38=", + "dev": true, + "requires": { + "chalk": "^1.0.0", + "clean-css": "~4.1.1", + "maxmin": "^2.1.0" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "grunt-contrib-jshint": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/grunt-contrib-jshint/-/grunt-contrib-jshint-1.1.0.tgz", + "integrity": "sha1-Np2QmyWTxA6L55lAshNAhQx5Oaw=", + "dev": true, + "requires": { + "chalk": "^1.1.1", + "hooker": "^0.2.3", + "jshint": "~2.9.4" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "grunt-contrib-uglify": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/grunt-contrib-uglify/-/grunt-contrib-uglify-3.3.0.tgz", + "integrity": "sha512-W9O7lJE3PlD8VCc5fyaf98QV7f5wEDiU4PBIh0+/6UBbk2LhgzEFS0/p+taH5UD3+PlEn7QPN0o06Z0To6SqXw==", + "dev": true, + "requires": { + "chalk": "^1.0.0", + "maxmin": "^1.1.0", + "uglify-js": "~3.3.0", + "uri-path": "^1.0.0" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "gzip-size": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/gzip-size/-/gzip-size-1.0.0.tgz", + "integrity": "sha1-Zs+LEBBHInuVus5uodoMF37Vwi8=", + "dev": true, + "requires": { + "browserify-zlib": "^0.1.4", + "concat-stream": "^1.4.1" + } + }, + "maxmin": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/maxmin/-/maxmin-1.1.0.tgz", + "integrity": "sha1-cTZehKmd2Piz99X94vANHn9zvmE=", + "dev": true, + "requires": { + "chalk": "^1.0.0", + "figures": "^1.0.1", + "gzip-size": "^1.0.0", + "pretty-bytes": "^1.0.0" + } + }, + "pretty-bytes": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-1.0.4.tgz", + "integrity": "sha1-CiLoIQYJrTVUL4yNXSFZr/B1HIQ=", + "dev": true, + "requires": { + "get-stdin": "^4.0.1", + "meow": "^3.1.0" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "grunt-contrib-watch": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/grunt-contrib-watch/-/grunt-contrib-watch-1.1.0.tgz", + "integrity": "sha512-yGweN+0DW5yM+oo58fRu/XIRrPcn3r4tQx+nL7eMRwjpvk+rQY6R8o94BPK0i2UhTg9FN21hS+m8vR8v9vXfeg==", + "dev": true, + "requires": { + "async": "^2.6.0", + "gaze": "^1.1.0", + "lodash": "^4.17.10", + "tiny-lr": "^1.1.1" + }, + "dependencies": { + "async": { + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/async/-/async-2.6.1.tgz", + "integrity": "sha512-fNEiL2+AZt6AlAw/29Cr0UDe4sRAHCpEHh54WMz+Bb7QfNcFw4h3loofyJpLeQs4Yx7yuqu/2dLgM5hKOs6HlQ==", + "dev": true, + "requires": { + "lodash": "^4.17.10" + } + } + } + }, + "grunt-known-options": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/grunt-known-options/-/grunt-known-options-1.1.0.tgz", + "integrity": "sha1-pCdO6zL6dl2lp6OxcSYXzjsUQUk=", + "dev": true + }, + "grunt-legacy-log": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/grunt-legacy-log/-/grunt-legacy-log-2.0.0.tgz", + "integrity": "sha512-1m3+5QvDYfR1ltr8hjiaiNjddxGdQWcH0rw1iKKiQnF0+xtgTazirSTGu68RchPyh1OBng1bBUjLmX8q9NpoCw==", + "dev": true, + "requires": { + "colors": "~1.1.2", + "grunt-legacy-log-utils": "~2.0.0", + "hooker": "~0.2.3", + "lodash": "~4.17.5" + } + }, + "grunt-legacy-log-utils": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/grunt-legacy-log-utils/-/grunt-legacy-log-utils-2.0.1.tgz", + "integrity": "sha512-o7uHyO/J+i2tXG8r2bZNlVk20vlIFJ9IEYyHMCQGfWYru8Jv3wTqKZzvV30YW9rWEjq0eP3cflQ1qWojIe9VFA==", + "dev": true, + "requires": { + "chalk": "~2.4.1", + "lodash": "~4.17.10" + }, + "dependencies": { + "ansi-styles": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", + "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", + "dev": true, + "requires": { + "color-convert": "^1.9.0" + } + }, + "chalk": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz", + "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==", + "dev": true, + "requires": { + "ansi-styles": "^3.2.1", + "escape-string-regexp": "^1.0.5", + "supports-color": "^5.3.0" + } + }, + "has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", + "dev": true + }, + "supports-color": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz", + "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==", + "dev": true, + "requires": { + "has-flag": "^3.0.0" + } + } + } + }, + "grunt-legacy-util": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/grunt-legacy-util/-/grunt-legacy-util-1.1.1.tgz", + "integrity": "sha512-9zyA29w/fBe6BIfjGENndwoe1Uy31BIXxTH3s8mga0Z5Bz2Sp4UCjkeyv2tI449ymkx3x26B+46FV4fXEddl5A==", + "dev": true, + "requires": { + "async": "~1.5.2", + "exit": "~0.1.1", + "getobject": "~0.1.0", + "hooker": "~0.2.3", + "lodash": "~4.17.10", + "underscore.string": "~3.3.4", + "which": "~1.3.0" + } + }, + "grunt-phpcs": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/grunt-phpcs/-/grunt-phpcs-0.4.0.tgz", + "integrity": "sha1-oI1iX8ZEZeRTsr2T+BCyqB6Uvao=", + "dev": true + }, + "grunt-postcss": { + "version": "0.9.0", + "resolved": "https://registry.npmjs.org/grunt-postcss/-/grunt-postcss-0.9.0.tgz", + "integrity": "sha1-++WTSmvp6siTr20FfiMYyX+unaM=", + "dev": true, + "requires": { + "chalk": "^2.1.0", + "diff": "^3.0.0", + "postcss": "^6.0.11" + } + }, + "grunt-prompt": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/grunt-prompt/-/grunt-prompt-1.3.3.tgz", + "integrity": "sha1-xbQ77DqimqaWKsZhGolnEvy6Z5E=", + "dev": true, + "requires": { + "inquirer": "^0.11.0", + "lodash": "^3.10.1" + }, + "dependencies": { + "lodash": { + "version": "3.10.1", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz", + "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y=", + "dev": true + } + } + }, + "grunt-rtlcss": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/grunt-rtlcss/-/grunt-rtlcss-2.0.1.tgz", + "integrity": "sha1-6eYc5DdAY5f546Sxv2aeR+cf/MM=", + "dev": true, + "requires": { + "chalk": "^1.0.0", + "rtlcss": "^2.0.0" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "grunt-sass": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/grunt-sass/-/grunt-sass-2.1.0.tgz", + "integrity": "sha512-XkexnQt/9rhReNd+Y7T0n/2g5FqYOQKfi2iSlpwDqvgs7EgEaGTxNhnWzHnbW5oNRvzL9AHopBG3AgRxL0d+DA==", + "dev": true, + "requires": { + "each-async": "^1.0.0", + "node-sass": "^4.7.2", + "object-assign": "^4.0.1" + } + }, + "grunt-shell": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/grunt-shell/-/grunt-shell-2.1.0.tgz", + "integrity": "sha1-Q595FZ7RHmSmUaacyKPQK+v17MI=", + "dev": true, + "requires": { + "chalk": "^1.0.0", + "npm-run-path": "^2.0.0" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "grunt-stylelint": { + "version": "0.10.0", + "resolved": "https://registry.npmjs.org/grunt-stylelint/-/grunt-stylelint-0.10.0.tgz", + "integrity": "sha512-1HC3H1CZlK3niJGORr+1nmcdtogoSiZex7ej9MtJPXVmxrvWvXTVhZppKoPVVQgHRvNozmtGCZTZr7c9kMPO5g==", + "dev": true, + "requires": { + "chalk": "1.1.3" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "grunt-wp-i18n": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/grunt-wp-i18n/-/grunt-wp-i18n-1.0.2.tgz", + "integrity": "sha1-4cwnw/bxiPbUMv0DBq97F/uDy1Q=", + "dev": true, + "requires": { + "grunt": "^1.0.2", + "node-wp-i18n": "^1.0.5" + } + }, + "gzip-size": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/gzip-size/-/gzip-size-3.0.0.tgz", + "integrity": "sha1-VGGI6b3DN/Zzdy+BZgRks4nc5SA=", + "dev": true, + "requires": { + "duplexer": "^0.1.1" + } + }, + "handlebars": { + "version": "4.0.11", + "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.0.11.tgz", + "integrity": "sha1-Ywo13+ApS8KB7a5v/F0yn8eYLcw=", + "dev": true, + "requires": { + "async": "^1.4.0", + "optimist": "^0.6.1", + "source-map": "^0.4.4", + "uglify-js": "^2.6" + }, + "dependencies": { + "camelcase": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-1.2.1.tgz", + "integrity": "sha1-m7UwTS4LVmmLLHWLCKPqqdqlijk=", + "dev": true, + "optional": true + }, + "cliui": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-2.1.0.tgz", + "integrity": "sha1-S0dXYP+AJkx2LDoXGQMukcf+oNE=", + "dev": true, + "optional": true, + "requires": { + "center-align": "^0.1.1", + "right-align": "^0.1.1", + "wordwrap": "0.0.2" + } + }, + "source-map": { + "version": "0.4.4", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz", + "integrity": "sha1-66T12pwNyZneaAMti092FzZSA2s=", + "dev": true, + "requires": { + "amdefine": ">=0.0.4" + } + }, + "uglify-js": { + "version": "2.8.29", + "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-2.8.29.tgz", + "integrity": "sha1-KcVzMUgFe7Th913zW3qcty5qWd0=", + "dev": true, + "optional": true, + "requires": { + "source-map": "~0.5.1", + "uglify-to-browserify": "~1.0.0", + "yargs": "~3.10.0" + }, + "dependencies": { + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true, + "optional": true + } + } + }, + "wordwrap": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.2.tgz", + "integrity": "sha1-t5Zpu0LstAn4PVg8rVLKF+qhZD8=", + "dev": true, + "optional": true + }, + "yargs": { + "version": "3.10.0", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-3.10.0.tgz", + "integrity": "sha1-9+572FfdfB0tOMDnTvvWgdFDH9E=", + "dev": true, + "optional": true, + "requires": { + "camelcase": "^1.0.2", + "cliui": "^2.1.0", + "decamelize": "^1.0.0", + "window-size": "0.1.0" + } + } + } + }, + "har-schema": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/har-schema/-/har-schema-2.0.0.tgz", + "integrity": "sha1-qUwiJOvKwEeCoNkDVSHyRzW37JI=", + "dev": true + }, + "har-validator": { + "version": "5.0.3", + "resolved": "https://registry.npmjs.org/har-validator/-/har-validator-5.0.3.tgz", + "integrity": "sha1-ukAsJmGU8VlW7xXg/PJCmT9qff0=", + "dev": true, + "requires": { + "ajv": "^5.1.0", + "har-schema": "^2.0.0" + } + }, + "has-ansi": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/has-ansi/-/has-ansi-2.0.0.tgz", + "integrity": "sha1-NPUEnOHs3ysGSa8+8k5F7TVBbZE=", + "dev": true, + "requires": { + "ansi-regex": "^2.0.0" + } + }, + "has-color": { + "version": "0.1.7", + "resolved": "https://registry.npmjs.org/has-color/-/has-color-0.1.7.tgz", + "integrity": "sha1-ZxRKUmDDT8PMpnfQQdr1L+e3iy8=", + "dev": true + }, + "has-flag": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-2.0.0.tgz", + "integrity": "sha1-6CB68cx7MNRGzHC3NLXovhj4jVE=", + "dev": true + }, + "has-unicode": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/has-unicode/-/has-unicode-2.0.1.tgz", + "integrity": "sha1-4Ob+aijPUROIVeCG0Wkedx3iqLk=", + "dev": true + }, + "has-value": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/has-value/-/has-value-1.0.0.tgz", + "integrity": "sha1-GLKB2lhbHFxR3vJMkw7SmgvmsXc=", + "dev": true, + "requires": { + "get-value": "^2.0.6", + "has-values": "^1.0.0", + "isobject": "^3.0.0" + }, + "dependencies": { + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + } + } + }, + "has-values": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/has-values/-/has-values-1.0.0.tgz", + "integrity": "sha1-lbC2P+whRmGab+V/51Yo1aOe/k8=", + "dev": true, + "requires": { + "is-number": "^3.0.0", + "kind-of": "^4.0.0" + }, + "dependencies": { + "is-number": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-3.0.0.tgz", + "integrity": "sha1-JP1iAaR4LPUFYcgQJ2r8fRLXEZU=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + }, + "dependencies": { + "kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", + "dev": true, + "requires": { + "is-buffer": "^1.1.5" + } + } + } + }, + "kind-of": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-4.0.0.tgz", + "integrity": "sha1-IIE989cSkosgc3hpGkUGb65y3Vc=", + "dev": true, + "requires": { + "is-buffer": "^1.1.5" + } + } + } + }, + "hawk": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/hawk/-/hawk-3.1.3.tgz", + "integrity": "sha1-B4REvXwWQLD+VA0sm3PVlnjo4cQ=", + "dev": true, + "requires": { + "boom": "2.x.x", + "cryptiles": "2.x.x", + "hoek": "2.x.x", + "sntp": "1.x.x" + } + }, + "he": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/he/-/he-1.1.1.tgz", + "integrity": "sha1-k0EP0hsAlzUVH4howvJx80J+I/0=", + "dev": true + }, + "hoek": { + "version": "2.16.3", + "resolved": "https://registry.npmjs.org/hoek/-/hoek-2.16.3.tgz", + "integrity": "sha1-ILt0A9POo5jpHcRxCo/xuCdKJe0=", + "dev": true + }, + "home-or-tmp": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/home-or-tmp/-/home-or-tmp-2.0.0.tgz", + "integrity": "sha1-42w/LSyufXRqhX440Y1fMqeILbg=", + "dev": true, + "requires": { + "os-homedir": "^1.0.0", + "os-tmpdir": "^1.0.1" + } + }, + "hooker": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/hooker/-/hooker-0.2.3.tgz", + "integrity": "sha1-uDT3I8xKJCqmWWNFnfbZhMXT2Vk=", + "dev": true + }, + "hosted-git-info": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.5.0.tgz", + "integrity": "sha1-bWDjSzq7yDEwYsO3mO+NkBoHrzw=", + "dev": true + }, + "html-tags": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/html-tags/-/html-tags-2.0.0.tgz", + "integrity": "sha1-ELMKOGCF9Dzt41PMj6fLDe7qZos=", + "dev": true + }, + "htmlparser2": { + "version": "3.8.3", + "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-3.8.3.tgz", + "integrity": "sha1-mWwosZFRaovoZQGn15dX5ccMEGg=", + "dev": true, + "requires": { + "domelementtype": "1", + "domhandler": "2.3", + "domutils": "1.5", + "entities": "1.0", + "readable-stream": "1.1" + }, + "dependencies": { + "isarray": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz", + "integrity": "sha1-ihis/Kmo9Bd+Cav8YDiTmwXR7t8=", + "dev": true + }, + "readable-stream": { + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz", + "integrity": "sha1-fPTFTvZI44EwhMY23SB54WbAgdk=", + "dev": true, + "requires": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.1", + "isarray": "0.0.1", + "string_decoder": "~0.10.x" + } + }, + "string_decoder": { + "version": "0.10.31", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", + "dev": true + } + } + }, + "http-parser-js": { + "version": "0.4.13", + "resolved": "https://registry.npmjs.org/http-parser-js/-/http-parser-js-0.4.13.tgz", + "integrity": "sha1-O9bW/ebjFyyTNMOzO2wZPYD+ETc=", + "dev": true + }, + "http-signature": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/http-signature/-/http-signature-1.2.0.tgz", + "integrity": "sha1-muzZJRFHcvPZW2WmCruPfBj7rOE=", + "dev": true, + "requires": { + "assert-plus": "^1.0.0", + "jsprim": "^1.2.2", + "sshpk": "^1.7.0" + } + }, + "iconv-lite": { + "version": "0.4.21", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.21.tgz", + "integrity": "sha1-xH+HM9AhcRievEpADzIY00gJR5g=", + "dev": true, + "requires": { + "safer-buffer": "^2.1.0" + } + }, + "ignore": { + "version": "3.3.8", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-3.3.8.tgz", + "integrity": "sha512-pUh+xUQQhQzevjRHHFqqcTy0/dP/kS9I8HSrUydhihjuD09W6ldVWFtIrwhXdUJHis3i2rZNqEHpZH/cbinFbg==", + "dev": true + }, + "immediate": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz", + "integrity": "sha1-nbHb0Pr43m++D13V5Wu2BigN5ps=", + "dev": true + }, + "import-lazy": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/import-lazy/-/import-lazy-3.1.0.tgz", + "integrity": "sha512-8/gvXvX2JMn0F+CDlSC4l6kOmVaLOO3XLkksI7CI3Ud95KDYJuYur2b9P/PUt/i/pDAMd/DulQsNbbbmRRsDIQ==", + "dev": true + }, + "imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha1-khi5srkoojixPcT7a21XbyMUU+o=", + "dev": true + }, + "in-publish": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/in-publish/-/in-publish-2.0.0.tgz", + "integrity": "sha1-4g/146KvwmkDILbcVSaCqcf631E=", + "dev": true + }, + "indent-string": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-2.1.0.tgz", + "integrity": "sha1-ji1INIdCEhtKghi3oTfppSBJ3IA=", + "dev": true, + "requires": { + "repeating": "^2.0.0" + } + }, + "indexes-of": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/indexes-of/-/indexes-of-1.0.1.tgz", + "integrity": "sha1-8w9xbI4r00bHtn0985FVZqfAVgc=", + "dev": true + }, + "inflight": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", + "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=", + "dev": true, + "requires": { + "once": "^1.3.0", + "wrappy": "1" + } + }, + "inherits": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz", + "integrity": "sha1-Yzwsg+PaQqUC9SRmAiSA9CCCYd4=", + "dev": true + }, + "inquirer": { + "version": "0.11.4", + "resolved": "https://registry.npmjs.org/inquirer/-/inquirer-0.11.4.tgz", + "integrity": "sha1-geM3ToNhvq/y2XAWIG01nQsy+k0=", + "dev": true, + "requires": { + "ansi-escapes": "^1.1.0", + "ansi-regex": "^2.0.0", + "chalk": "^1.0.0", + "cli-cursor": "^1.0.1", + "cli-width": "^1.0.1", + "figures": "^1.3.5", + "lodash": "^3.3.1", + "readline2": "^1.0.1", + "run-async": "^0.1.0", + "rx-lite": "^3.1.2", + "string-width": "^1.0.1", + "strip-ansi": "^3.0.0", + "through": "^2.3.6" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "lodash": { + "version": "3.10.1", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz", + "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y=", + "dev": true + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "invariant": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/invariant/-/invariant-2.2.2.tgz", + "integrity": "sha1-nh9WrArNtr8wMwbzOL47IErmA2A=", + "dev": true, + "requires": { + "loose-envify": "^1.0.0" + } + }, + "invert-kv": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/invert-kv/-/invert-kv-1.0.0.tgz", + "integrity": "sha1-EEqOSqym09jNFXqO+L+rLXo//bY=", + "dev": true + }, + "is-accessor-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz", + "integrity": "sha1-qeEss66Nh2cn7u84Q/igiXtcmNY=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + } + }, + "is-alphabetical": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-1.0.2.tgz", + "integrity": "sha512-V0xN4BYezDHcBSKb1QHUFMlR4as/XEuCZBzMJUU4n7+Cbt33SmUnSol+pnXFvLxSHNq2CemUXNdaXV6Flg7+xg==", + "dev": true + }, + "is-alphanumeric": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-alphanumeric/-/is-alphanumeric-1.0.0.tgz", + "integrity": "sha1-Spzvcdr0wAHB2B1j0UDPU/1oifQ=", + "dev": true + }, + "is-alphanumerical": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-alphanumerical/-/is-alphanumerical-1.0.2.tgz", + "integrity": "sha512-pyfU/0kHdISIgslFfZN9nfY1Gk3MquQgUm1mJTjdkEPpkAKNWuBTSqFwewOpR7N351VkErCiyV71zX7mlQQqsg==", + "dev": true, + "requires": { + "is-alphabetical": "^1.0.0", + "is-decimal": "^1.0.0" + } + }, + "is-arrayish": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", + "integrity": "sha1-d8mYQFJ6qOyxqLppe4BkWnqSap0=", + "dev": true + }, + "is-binary-path": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-1.0.1.tgz", + "integrity": "sha1-dfFmQrSA8YenEcgUFh/TpKdlWJg=", + "dev": true, + "optional": true, + "requires": { + "binary-extensions": "^1.0.0" + } + }, + "is-buffer": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz", + "integrity": "sha1-76ouqdqg16suoTqXsritUf776L4=", + "dev": true + }, + "is-builtin-module": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-builtin-module/-/is-builtin-module-1.0.0.tgz", + "integrity": "sha1-VAVy0096wxGfj3bDDLwbHgN6/74=", + "dev": true, + "requires": { + "builtin-modules": "^1.0.0" + } + }, + "is-data-descriptor": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz", + "integrity": "sha1-C17mSDiOLIYCgueT8YVv7D8wG1Y=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + } + }, + "is-decimal": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-decimal/-/is-decimal-1.0.2.tgz", + "integrity": "sha512-TRzl7mOCchnhchN+f3ICUCzYvL9ul7R+TYOsZ8xia++knyZAJfv/uA1FvQXsAnYIl1T3B2X5E/J7Wb1QXiIBXg==", + "dev": true + }, + "is-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz", + "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==", + "dev": true, + "requires": { + "is-accessor-descriptor": "^0.1.6", + "is-data-descriptor": "^0.1.4", + "kind-of": "^5.0.0" + }, + "dependencies": { + "kind-of": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz", + "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw==", + "dev": true + } + } + }, + "is-directory": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/is-directory/-/is-directory-0.3.1.tgz", + "integrity": "sha1-YTObbyR1/Hcv2cnYP1yFddwVSuE=", + "dev": true + }, + "is-dotfile": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/is-dotfile/-/is-dotfile-1.0.3.tgz", + "integrity": "sha1-pqLzL/0t+wT1yiXs0Pa4PPeYoeE=", + "dev": true + }, + "is-equal-shallow": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/is-equal-shallow/-/is-equal-shallow-0.1.3.tgz", + "integrity": "sha1-IjgJj8Ih3gvPpdnqxMRdY4qhxTQ=", + "dev": true, + "requires": { + "is-primitive": "^2.0.0" + } + }, + "is-extendable": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz", + "integrity": "sha1-YrEQ4omkcUGOPsNqYX1HLjAd/Ik=", + "dev": true + }, + "is-extglob": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-1.0.0.tgz", + "integrity": "sha1-rEaBd8SUNAWgkvyPKXYMb/xiBsA=", + "dev": true + }, + "is-finite": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-finite/-/is-finite-1.0.2.tgz", + "integrity": "sha1-zGZ3aVYCvlUO8R6LSqYwU0K20Ko=", + "dev": true, + "requires": { + "number-is-nan": "^1.0.0" + } + }, + "is-fullwidth-code-point": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-1.0.0.tgz", + "integrity": "sha1-754xOG8DGn8NZDr4L95QxFfvAMs=", + "dev": true, + "requires": { + "number-is-nan": "^1.0.0" + } + }, + "is-glob": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-2.0.1.tgz", + "integrity": "sha1-0Jb5JqPe1WAPP9/ZEZjLCIjC2GM=", + "dev": true, + "requires": { + "is-extglob": "^1.0.0" + } + }, + "is-hexadecimal": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-hexadecimal/-/is-hexadecimal-1.0.2.tgz", + "integrity": "sha512-but/G3sapV3MNyqiDBLrOi4x8uCIw0RY3o/Vb5GT0sMFHrVV7731wFSVy41T5FO1og7G0gXLJh0MkgPRouko/A==", + "dev": true + }, + "is-my-ip-valid": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-my-ip-valid/-/is-my-ip-valid-1.0.0.tgz", + "integrity": "sha512-gmh/eWXROncUzRnIa1Ubrt5b8ep/MGSnfAUI3aRp+sqTCs1tv1Isl8d8F6JmkN3dXKc3ehZMrtiPN9eL03NuaQ==", + "dev": true + }, + "is-my-json-valid": { + "version": "2.17.2", + "resolved": "https://registry.npmjs.org/is-my-json-valid/-/is-my-json-valid-2.17.2.tgz", + "integrity": "sha512-IBhBslgngMQN8DDSppmgDv7RNrlFotuuDsKcrCP3+HbFaVivIBU7u9oiiErw8sH4ynx3+gOGQ3q2otkgiSi6kg==", + "dev": true, + "requires": { + "generate-function": "^2.0.0", + "generate-object-property": "^1.1.0", + "is-my-ip-valid": "^1.0.0", + "jsonpointer": "^4.0.0", + "xtend": "^4.0.0" + } + }, + "is-number": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-2.1.0.tgz", + "integrity": "sha1-Afy7s5NGOlSPL0ZszhbezknbkI8=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + } + }, + "is-obj": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-obj/-/is-obj-1.0.1.tgz", + "integrity": "sha1-PkcprB9f3gJc19g6iW2rn09n2w8=", + "dev": true + }, + "is-odd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-odd/-/is-odd-2.0.0.tgz", + "integrity": "sha512-OTiixgpZAT1M4NHgS5IguFp/Vz2VI3U7Goh4/HA1adtwyLtSBrxYlcSYkhpAE07s4fKEcjrFxyvtQBND4vFQyQ==", + "dev": true, + "requires": { + "is-number": "^4.0.0" + }, + "dependencies": { + "is-number": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-4.0.0.tgz", + "integrity": "sha512-rSklcAIlf1OmFdyAqbnWTLVelsQ58uvZ66S/ZyawjWqIviTWCjg2PzVGw8WUA+nNuPTqb4wgA+NszrJ+08LlgQ==", + "dev": true + } + } + }, + "is-path-cwd": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-path-cwd/-/is-path-cwd-1.0.0.tgz", + "integrity": "sha1-0iXsIxMuie3Tj9p2dHLmLmXxEG0=", + "dev": true + }, + "is-path-in-cwd": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-path-in-cwd/-/is-path-in-cwd-1.0.0.tgz", + "integrity": "sha1-ZHdYK4IU1gI0YJRWcAO+ip6sBNw=", + "dev": true, + "requires": { + "is-path-inside": "^1.0.0" + } + }, + "is-path-inside": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-1.0.1.tgz", + "integrity": "sha1-jvW33lBDej/cprToZe96pVy0gDY=", + "dev": true, + "requires": { + "path-is-inside": "^1.0.1" + } + }, + "is-plain-obj": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-1.1.0.tgz", + "integrity": "sha1-caUMhCnfync8kqOQpKA7OfzVHT4=", + "dev": true + }, + "is-plain-object": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-2.0.4.tgz", + "integrity": "sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==", + "dev": true, + "requires": { + "isobject": "^3.0.1" + }, + "dependencies": { + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + } + } + }, + "is-posix-bracket": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-posix-bracket/-/is-posix-bracket-0.1.1.tgz", + "integrity": "sha1-MzTceXdDaOkvAW5vvAqI9c1ua8Q=", + "dev": true + }, + "is-primitive": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-primitive/-/is-primitive-2.0.0.tgz", + "integrity": "sha1-IHurkWOEmcB7Kt8kCkGochADRXU=", + "dev": true + }, + "is-property": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-property/-/is-property-1.0.2.tgz", + "integrity": "sha1-V/4cTkhHTt1lsJkR8msc1Ald2oQ=", + "dev": true + }, + "is-regexp": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-regexp/-/is-regexp-1.0.0.tgz", + "integrity": "sha1-/S2INUXEa6xaYz57mgnof6LLUGk=", + "dev": true + }, + "is-supported-regexp-flag": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-supported-regexp-flag/-/is-supported-regexp-flag-1.0.1.tgz", + "integrity": "sha512-3vcJecUUrpgCqc/ca0aWeNu64UGgxcvO60K/Fkr1N6RSvfGCTU60UKN68JDmKokgba0rFFJs12EnzOQa14ubKQ==", + "dev": true + }, + "is-typedarray": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-typedarray/-/is-typedarray-1.0.0.tgz", + "integrity": "sha1-5HnICFjfDBsR3dppQPlgEfzaSpo=", + "dev": true + }, + "is-utf8": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/is-utf8/-/is-utf8-0.2.1.tgz", + "integrity": "sha1-Sw2hRCEE0bM2NA6AeX6GXPOffXI=", + "dev": true + }, + "is-whitespace-character": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-whitespace-character/-/is-whitespace-character-1.0.2.tgz", + "integrity": "sha512-SzM+T5GKUCtLhlHFKt2SDAX2RFzfS6joT91F2/WSi9LxgFdsnhfPK/UIA+JhRR2xuyLdrCys2PiFDrtn1fU5hQ==", + "dev": true + }, + "is-windows": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-windows/-/is-windows-1.0.2.tgz", + "integrity": "sha1-0YUOuXkezRjmGCzhKjDzlmNLsZ0=", + "dev": true + }, + "is-word-character": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-word-character/-/is-word-character-1.0.2.tgz", + "integrity": "sha512-T3FlsX8rCHAH8e7RE7PfOPZVFQlcV3XRF9eOOBQ1uf70OxO7CjjSOjeImMPCADBdYWcStAbVbYvJ1m2D3tb+EA==", + "dev": true + }, + "isarray": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", + "integrity": "sha1-u5NdSFgsuhaMBoNJV6VKPgcSTxE=", + "dev": true + }, + "isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=", + "dev": true + }, + "isobject": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-2.1.0.tgz", + "integrity": "sha1-8GVWEJaj8dou9GJy+BXIQNh+DIk=", + "dev": true, + "requires": { + "isarray": "1.0.0" + } + }, + "isstream": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/isstream/-/isstream-0.1.2.tgz", + "integrity": "sha1-R+Y/evVa+m+S4VAOaQ64uFKcCZo=", + "dev": true + }, + "istanbul": { + "version": "1.0.0-alpha.2", + "resolved": "https://registry.npmjs.org/istanbul/-/istanbul-1.0.0-alpha.2.tgz", + "integrity": "sha1-BglrwI6Yuq10Sq5Gli2N+frGPQg=", + "dev": true, + "requires": { + "abbrev": "1.0.x", + "async": "1.x", + "istanbul-api": "^1.0.0-alpha", + "js-yaml": "3.x", + "mkdirp": "0.5.x", + "nopt": "3.x", + "which": "^1.1.1", + "wordwrap": "^1.0.0" + }, + "dependencies": { + "abbrev": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.0.9.tgz", + "integrity": "sha1-kbR5JYinc4wl813W9jdSovh3YTU=", + "dev": true + } + } + }, + "istanbul-api": { + "version": "1.3.6", + "resolved": "https://registry.npmjs.org/istanbul-api/-/istanbul-api-1.3.6.tgz", + "integrity": "sha512-luJDnB1uJ5Qsg/WwusGfNXayQ4598yDgW5S0nUS85T576m1LVJzSqLrCDULkT6sTQXVKHa54093gNuCKumMCjQ==", + "dev": true, + "requires": { + "async": "^2.1.4", + "compare-versions": "^3.1.0", + "fileset": "^2.0.2", + "istanbul-lib-coverage": "^1.2.0", + "istanbul-lib-hook": "^1.2.0", + "istanbul-lib-instrument": "^2.1.0", + "istanbul-lib-report": "^1.1.4", + "istanbul-lib-source-maps": "^1.2.5", + "istanbul-reports": "^1.4.1", + "js-yaml": "^3.7.0", + "mkdirp": "^0.5.1", + "once": "^1.4.0" + }, + "dependencies": { + "append-transform": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/append-transform/-/append-transform-1.0.0.tgz", + "integrity": "sha512-P009oYkeHyU742iSZJzZZywj4QRJdnTWffaKuJQLablCZ1uz6/cW4yaRgcDaoQ+uwOxxnt0gRUcwfsNP2ri0gw==", + "dev": true, + "requires": { + "default-require-extensions": "^2.0.0" + } + }, + "async": { + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/async/-/async-2.6.1.tgz", + "integrity": "sha512-fNEiL2+AZt6AlAw/29Cr0UDe4sRAHCpEHh54WMz+Bb7QfNcFw4h3loofyJpLeQs4Yx7yuqu/2dLgM5hKOs6HlQ==", + "dev": true, + "requires": { + "lodash": "^4.17.10" + } + }, + "debug": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz", + "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==", + "dev": true, + "requires": { + "ms": "2.0.0" + } + }, + "default-require-extensions": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/default-require-extensions/-/default-require-extensions-2.0.0.tgz", + "integrity": "sha1-9fj7sYp9bVCyH2QfZJ67Uiz+JPc=", + "dev": true, + "requires": { + "strip-bom": "^3.0.0" + } + }, + "esprima": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.0.tgz", + "integrity": "sha1-RJnt3NERDgshi6zy+n9/WfVcqAQ=", + "dev": true + }, + "has-flag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-1.0.0.tgz", + "integrity": "sha1-nZ55MWXOAXoA8AQYxD+UKnsdEfo=", + "dev": true + }, + "istanbul-lib-coverage": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-1.2.0.tgz", + "integrity": "sha512-GvgM/uXRwm+gLlvkWHTjDAvwynZkL9ns15calTrmhGgowlwJBbWMYzWbKqE2DT6JDP1AFXKa+Zi0EkqNCUqY0A==", + "dev": true + }, + "istanbul-lib-hook": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-hook/-/istanbul-lib-hook-1.2.1.tgz", + "integrity": "sha512-eLAMkPG9FU0v5L02lIkcj/2/Zlz9OuluaXikdr5iStk8FDbSwAixTK9TkYxbF0eNnzAJTwM2fkV2A1tpsIp4Jg==", + "dev": true, + "requires": { + "append-transform": "^1.0.0" + } + }, + "istanbul-lib-instrument": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-2.2.0.tgz", + "integrity": "sha512-ozQGtlIw+/a/F3n6QwWiuuyRAPp64+g2GVsKYsIez0sgIEzkU5ZpL2uZ5pmAzbEJ82anlRaPlOQZzkRXspgJyg==", + "dev": true, + "requires": { + "@babel/generator": "7.0.0-beta.49", + "@babel/parser": "7.0.0-beta.49", + "@babel/template": "7.0.0-beta.49", + "@babel/traverse": "7.0.0-beta.49", + "@babel/types": "7.0.0-beta.49", + "istanbul-lib-coverage": "^2.0.0", + "semver": "^5.5.0" + }, + "dependencies": { + "istanbul-lib-coverage": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.0.tgz", + "integrity": "sha512-yMSw5xLIbdaxiVXHk3amfNM2WeBxLrwH/BCyZ9HvA/fylwziAIJOG2rKqWyLqEJqwKT725vxxqidv+SyynnGAA==", + "dev": true + } + } + }, + "istanbul-lib-report": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-1.1.4.tgz", + "integrity": "sha512-Azqvq5tT0U09nrncK3q82e/Zjkxa4tkFZv7E6VcqP0QCPn6oNljDPfrZEC/umNXds2t7b8sRJfs6Kmpzt8m2kA==", + "dev": true, + "requires": { + "istanbul-lib-coverage": "^1.2.0", + "mkdirp": "^0.5.1", + "path-parse": "^1.0.5", + "supports-color": "^3.1.2" + } + }, + "istanbul-lib-source-maps": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-1.2.5.tgz", + "integrity": "sha512-8O2T/3VhrQHn0XcJbP1/GN7kXMiRAlPi+fj3uEHrjBD8Oz7Py0prSC25C09NuAZS6bgW1NNKAvCSHZXB0irSGA==", + "dev": true, + "requires": { + "debug": "^3.1.0", + "istanbul-lib-coverage": "^1.2.0", + "mkdirp": "^0.5.1", + "rimraf": "^2.6.1", + "source-map": "^0.5.3" + } + }, + "istanbul-reports": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-1.5.0.tgz", + "integrity": "sha512-HeZG0WHretI9FXBni5wZ9DOgNziqDCEwetxnme5k1Vv5e81uTqcsy3fMH99gXGDGKr1ea87TyGseDMa2h4HEUA==", + "dev": true, + "requires": { + "handlebars": "^4.0.11" + } + }, + "js-yaml": { + "version": "3.12.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.12.0.tgz", + "integrity": "sha512-PIt2cnwmPfL4hKNwqeiuz4bKfnzHTBv6HyVgjahA6mPLwPDzjDWrplJBMjHUFxku/N3FlmrbyPclad+I+4mJ3A==", + "dev": true, + "requires": { + "argparse": "^1.0.7", + "esprima": "^4.0.0" + } + }, + "semver": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-5.5.0.tgz", + "integrity": "sha512-4SJ3dm0WAwWy/NVeioZh5AntkdJoWKxHxcmyP622fOkgHa4z3R0TdBJICINyaSDE6uNwVc8gZr+ZinwZAH4xIA==", + "dev": true + }, + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + }, + "strip-bom": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", + "integrity": "sha1-IzTBjpx1n3vdVv3vfprj1YjmjtM=", + "dev": true + }, + "supports-color": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz", + "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=", + "dev": true, + "requires": { + "has-flag": "^1.0.0" + } + } + } + }, + "js-base64": { + "version": "2.4.5", + "resolved": "https://registry.npmjs.org/js-base64/-/js-base64-2.4.5.tgz", + "integrity": "sha512-aUnNwqMOXw3yvErjMPSQu6qIIzUmT1e5KcU1OZxRDU1g/am6mzBvcrmLAYwzmB59BHPrh5/tKaiF4OPhqRWESQ==", + "dev": true + }, + "js-tokens": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-3.0.2.tgz", + "integrity": "sha1-mGbfOVECEw449/mWvOtlRDIJwls=", + "dev": true + }, + "js-yaml": { + "version": "3.5.5", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.5.5.tgz", + "integrity": "sha1-A3fDgBfKvHMisNH7zSWkkWQfL74=", + "dev": true, + "requires": { + "argparse": "^1.0.2", + "esprima": "^2.6.0" + } + }, + "jsbn": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/jsbn/-/jsbn-0.1.1.tgz", + "integrity": "sha1-peZUwuWi3rXyAdls77yoDA7y9RM=", + "dev": true, + "optional": true + }, + "jsesc": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-1.3.0.tgz", + "integrity": "sha1-RsP+yMGJKxKwgz25vHYiF226s0s=", + "dev": true + }, + "jshint": { + "version": "2.9.5", + "resolved": "https://registry.npmjs.org/jshint/-/jshint-2.9.5.tgz", + "integrity": "sha1-HnJSkVzmgbQIJ+4UJIxG006apiw=", + "dev": true, + "requires": { + "cli": "~1.0.0", + "console-browserify": "1.1.x", + "exit": "0.1.x", + "htmlparser2": "3.8.x", + "lodash": "3.7.x", + "minimatch": "~3.0.2", + "shelljs": "0.3.x", + "strip-json-comments": "1.0.x" + }, + "dependencies": { + "lodash": { + "version": "3.7.0", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.7.0.tgz", + "integrity": "sha1-Nni9irmVBXwHreg27S7wh9qBHUU=", + "dev": true + } + } + }, + "json-parse-better-errors": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/json-parse-better-errors/-/json-parse-better-errors-1.0.2.tgz", + "integrity": "sha512-mrqyZKfX5EhL7hvqcV6WG1yYjnjeuYDzDhhcAAUrq8Po85NBQBJP+ZDUT75qZQ98IkUoBqdkExkukOU7Ts2wrw==", + "dev": true + }, + "json-schema": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.2.3.tgz", + "integrity": "sha1-tIDIkuWaLwWVTOcnvT8qTogvnhM=", + "dev": true + }, + "json-schema-traverse": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.3.1.tgz", + "integrity": "sha1-NJptRMU6Ud6JtAgFxdXlm0F9M0A=", + "dev": true + }, + "json-stringify-safe": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz", + "integrity": "sha1-Epai1Y/UXxmg9s4B1lcB4sc1tus=", + "dev": true + }, + "json5": { + "version": "0.5.1", + "resolved": "https://registry.npmjs.org/json5/-/json5-0.5.1.tgz", + "integrity": "sha1-Hq3nrMASA0rYTiOWdn6tn6VJWCE=", + "dev": true + }, + "jsonfile": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz", + "integrity": "sha1-h3Gq4HmbZAdrdmQPygWPnBDjPss=", + "dev": true, + "requires": { + "graceful-fs": "^4.1.6" + } + }, + "jsonpointer": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-4.0.1.tgz", + "integrity": "sha1-T9kss04OnbPInIYi7PUfm5eMbLk=", + "dev": true + }, + "jsprim": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/jsprim/-/jsprim-1.4.1.tgz", + "integrity": "sha1-MT5mvB5cwG5Di8G3SZwuXFastqI=", + "dev": true, + "requires": { + "assert-plus": "1.0.0", + "extsprintf": "1.3.0", + "json-schema": "0.2.3", + "verror": "1.10.0" + } + }, + "jszip": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.1.5.tgz", + "integrity": "sha1-48KmxtcGrG5gMxQDbUPNQL7v3zc=", + "dev": true, + "requires": { + "core-js": "~2.3.0", + "es6-promise": "~3.0.2", + "lie": "~3.1.0", + "pako": "~1.0.2", + "readable-stream": "~2.0.6" + }, + "dependencies": { + "core-js": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-2.3.0.tgz", + "integrity": "sha1-+rg/uwstjchfpjbEudNMdUIMbWU=", + "dev": true + }, + "pako": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.6.tgz", + "integrity": "sha1-AQEhG6pwxLykoPY/Igbpe3368lg=", + "dev": true + }, + "readable-stream": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.0.6.tgz", + "integrity": "sha1-j5A0HmilPMySh4jaz80Rs265t44=", + "dev": true, + "requires": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.1", + "isarray": "~1.0.0", + "process-nextick-args": "~1.0.6", + "string_decoder": "~0.10.x", + "util-deprecate": "~1.0.1" + } + }, + "string_decoder": { + "version": "0.10.31", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", + "dev": true + } + } + }, + "kew": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/kew/-/kew-0.7.0.tgz", + "integrity": "sha1-edk9LTM2PW/dKXCzNdkUGtWR15s=", + "dev": true + }, + "kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=", + "dev": true, + "requires": { + "is-buffer": "^1.1.5" + } + }, + "known-css-properties": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/known-css-properties/-/known-css-properties-0.6.1.tgz", + "integrity": "sha512-nQRpMcHm1cQ6gmztdvLcIvxocznSMqH/y6XtERrWrHaymOYdDGroRqetJvJycxGEr1aakXiigDgn7JnzuXlk6A==", + "dev": true + }, + "lazy-cache": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/lazy-cache/-/lazy-cache-1.0.4.tgz", + "integrity": "sha1-odePw6UEdMuAhF07O24dpJpEbo4=", + "dev": true, + "optional": true + }, + "lcid": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/lcid/-/lcid-1.0.0.tgz", + "integrity": "sha1-MIrMr6C8SDo4Z7S28rlQYlHRuDU=", + "dev": true, + "requires": { + "invert-kv": "^1.0.0" + } + }, + "lie": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/lie/-/lie-3.1.1.tgz", + "integrity": "sha1-mkNrLMd0bKWd56QfpGmz77dr2H4=", + "dev": true, + "requires": { + "immediate": "~3.0.5" + } + }, + "livereload-js": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/livereload-js/-/livereload-js-2.3.0.tgz", + "integrity": "sha1-w6si6Kr1vzUF2A0JjLrWdyZUjJo=", + "dev": true + }, + "load-json-file": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz", + "integrity": "sha1-lWkFcI1YtLq0wiYbBPWfMcmTdMA=", + "dev": true, + "requires": { + "graceful-fs": "^4.1.2", + "parse-json": "^2.2.0", + "pify": "^2.0.0", + "pinkie-promise": "^2.0.0", + "strip-bom": "^2.0.0" + }, + "dependencies": { + "pify": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=", + "dev": true + } + } + }, + "locate-path": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-2.0.0.tgz", + "integrity": "sha1-K1aLJl7slExtnA3pw9u7ygNUzY4=", + "dev": true, + "requires": { + "p-locate": "^2.0.0", + "path-exists": "^3.0.0" + }, + "dependencies": { + "path-exists": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-3.0.0.tgz", + "integrity": "sha1-zg6+ql94yxiSXqfYENe1mwEP1RU=", + "dev": true + } + } + }, + "lodash": { + "version": "4.17.10", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.10.tgz", + "integrity": "sha512-UejweD1pDoXu+AD825lWwp4ZGtSwgnpZxb3JDViD7StjQz+Nb/6l093lx4OQ0foGWNRoc19mWy7BzL+UAK2iVg==", + "dev": true + }, + "lodash.assign": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/lodash.assign/-/lodash.assign-4.2.0.tgz", + "integrity": "sha1-DZnzzNem0mHRm9rrkkUAXShYCOc=", + "dev": true + }, + "lodash.clonedeep": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/lodash.clonedeep/-/lodash.clonedeep-4.5.0.tgz", + "integrity": "sha1-4j8/nE+Pvd6HJSnBBxhXoIblzO8=", + "dev": true + }, + "lodash.mergewith": { + "version": "4.6.1", + "resolved": "https://registry.npmjs.org/lodash.mergewith/-/lodash.mergewith-4.6.1.tgz", + "integrity": "sha512-eWw5r+PYICtEBgrBE5hhlT6aAa75f411bgDz/ZL2KZqYV03USvucsxcHUIlGTDTECs1eunpI7HOV7U+WLDvNdQ==", + "dev": true + }, + "log-symbols": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-2.2.0.tgz", + "integrity": "sha512-VeIAFslyIerEJLXHziedo2basKbMKtTw3vfn5IzG0XTjhAVEJyNHnL2p7vc+wBDSdQuUpNw3M2u6xb9QsAY5Eg==", + "dev": true, + "requires": { + "chalk": "^2.0.1" + } + }, + "longest": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/longest/-/longest-1.0.1.tgz", + "integrity": "sha1-MKCy2jj3N3DoKUoNIuZiXtd9AJc=", + "dev": true + }, + "longest-streak": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-2.0.2.tgz", + "integrity": "sha512-TmYTeEYxiAmSVdpbnQDXGtvYOIRsCMg89CVZzwzc2o7GFL1CjoiRPjH5ec0NFAVlAx3fVof9dX/t6KKRAo2OWA==", + "dev": true + }, + "loose-envify": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.3.1.tgz", + "integrity": "sha1-0aitM/qc4OcT1l/dCsi3SNR4yEg=", + "dev": true, + "requires": { + "js-tokens": "^3.0.0" + } + }, + "loud-rejection": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/loud-rejection/-/loud-rejection-1.6.0.tgz", + "integrity": "sha1-W0b4AUft7leIcPCG0Eghz5mOVR8=", + "dev": true, + "requires": { + "currently-unhandled": "^0.4.1", + "signal-exit": "^3.0.0" + } + }, + "lru-cache": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-4.1.1.tgz", + "integrity": "sha1-Yi4y6CSItJJ5EUpPns9F581rulU=", + "dev": true, + "requires": { + "pseudomap": "^1.0.2", + "yallist": "^2.1.2" + } + }, + "map-cache": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/map-cache/-/map-cache-0.2.2.tgz", + "integrity": "sha1-wyq9C9ZSXZsFFkW7TyasXcmKDb8=", + "dev": true + }, + "map-obj": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-1.0.1.tgz", + "integrity": "sha1-2TPOuSBdgr3PSIb2dCvcK03qFG0=", + "dev": true + }, + "map-visit": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/map-visit/-/map-visit-1.0.0.tgz", + "integrity": "sha1-7Nyo8TFE5mDxtb1B8S80edmN+48=", + "dev": true, + "requires": { + "object-visit": "^1.0.0" + } + }, + "markdown-escapes": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/markdown-escapes/-/markdown-escapes-1.0.2.tgz", + "integrity": "sha512-lbRZ2mE3Q9RtLjxZBZ9+IMl68DKIXaVAhwvwn9pmjnPLS0h/6kyBMgNhqi1xFJ/2yv6cSyv0jbiZavZv93JkkA==", + "dev": true + }, + "markdown-table": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/markdown-table/-/markdown-table-1.1.2.tgz", + "integrity": "sha512-NcWuJFHDA8V3wkDgR/j4+gZx+YQwstPgfQDV8ndUeWWzta3dnDTBxpVzqS9lkmJAuV5YX35lmyojl6HO5JXAgw==", + "dev": true + }, + "marked": { + "version": "0.3.19", + "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.19.tgz", + "integrity": "sha1-XUf3CcTJ/Dwha21GEnKA9As515A=" + }, + "math-random": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/math-random/-/math-random-1.0.1.tgz", + "integrity": "sha1-izqsWIuKZuSXXjzepn97sylgH6w=", + "dev": true + }, + "mathml-tag-names": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mathml-tag-names/-/mathml-tag-names-2.1.0.tgz", + "integrity": "sha512-3Zs9P/0zzwTob2pdgT0CHZuMbnSUSp8MB1bddfm+HDmnFWHGT4jvEZRf+2RuPoa+cjdn/z25SEt5gFTqdhvJAg==", + "dev": true + }, + "maxmin": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/maxmin/-/maxmin-2.1.0.tgz", + "integrity": "sha1-TTsiCQPZXu5+t6x/qGTnLcCaMWY=", + "dev": true, + "requires": { + "chalk": "^1.0.0", + "figures": "^1.0.1", + "gzip-size": "^3.0.0", + "pretty-bytes": "^3.0.0" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "mdast-util-compact": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/mdast-util-compact/-/mdast-util-compact-1.0.1.tgz", + "integrity": "sha1-zbX4TitqLTEU3zO9BdnLMuPECDo=", + "dev": true, + "requires": { + "unist-util-modify-children": "^1.0.0", + "unist-util-visit": "^1.1.0" + } + }, + "meow": { + "version": "3.7.0", + "resolved": "https://registry.npmjs.org/meow/-/meow-3.7.0.tgz", + "integrity": "sha1-cstmi0JSKCkKu/qFaJJYcwioAfs=", + "dev": true, + "requires": { + "camelcase-keys": "^2.0.0", + "decamelize": "^1.1.2", + "loud-rejection": "^1.0.0", + "map-obj": "^1.0.1", + "minimist": "^1.1.3", + "normalize-package-data": "^2.3.4", + "object-assign": "^4.0.1", + "read-pkg-up": "^1.0.1", + "redent": "^1.0.0", + "trim-newlines": "^1.0.0" + }, + "dependencies": { + "minimist": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz", + "integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ=", + "dev": true + } + } + }, + "merge": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/merge/-/merge-1.2.0.tgz", + "integrity": "sha1-dTHjnUlJwoGma4xabgJl6LBYlNo=" + }, + "merge2": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.2.2.tgz", + "integrity": "sha512-bgM8twH86rWni21thii6WCMQMRMmwqqdW3sGWi9IipnVAszdLXRjwDwAnyrVXo6DuP3AjRMMttZKUB48QWIFGg==", + "dev": true + }, + "micromatch": { + "version": "2.3.11", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-2.3.11.tgz", + "integrity": "sha1-hmd8l9FyCzY0MdBNDRUpO9OMFWU=", + "dev": true, + "requires": { + "arr-diff": "^2.0.0", + "array-unique": "^0.2.1", + "braces": "^1.8.2", + "expand-brackets": "^0.1.4", + "extglob": "^0.3.1", + "filename-regex": "^2.0.0", + "is-extglob": "^1.0.0", + "is-glob": "^2.0.1", + "kind-of": "^3.0.2", + "normalize-path": "^2.0.1", + "object.omit": "^2.0.0", + "parse-glob": "^3.0.4", + "regex-cache": "^0.4.2" + } + }, + "mime-db": { + "version": "1.30.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.30.0.tgz", + "integrity": "sha1-dMZD2i3Z1qRTmZY0ZbJtXKfXHwE=", + "dev": true + }, + "mime-types": { + "version": "2.1.17", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.17.tgz", + "integrity": "sha1-Cdejk/A+mVp5+K+Fe3Cp4KsWVXo=", + "dev": true, + "requires": { + "mime-db": "~1.30.0" + } + }, + "minimatch": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz", + "integrity": "sha1-UWbihkV/AzBgZL5Ul+jbsMPTIIM=", + "dev": true, + "requires": { + "brace-expansion": "^1.1.7" + } + }, + "minimist": { + "version": "0.0.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz", + "integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0=" + }, + "minimist-options": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/minimist-options/-/minimist-options-3.0.2.tgz", + "integrity": "sha512-FyBrT/d0d4+uiZRbqznPXqw3IpZZG3gl3wKWiX784FycUKVwBt0uLBFkQrtE4tZOrgo78nZp2jnKz3L65T5LdQ==", + "dev": true, + "requires": { + "arrify": "^1.0.1", + "is-plain-obj": "^1.1.0" + } + }, + "mixin-deep": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/mixin-deep/-/mixin-deep-1.3.1.tgz", + "integrity": "sha512-8ZItLHeEgaqEvd5lYBXfm4EZSFCX29Jb9K+lAHhDKzReKBQKj3R+7NOF6tjqYi9t4oI8VUfaWITJQm86wnXGNQ==", + "dev": true, + "requires": { + "for-in": "^1.0.2", + "is-extendable": "^1.0.1" + }, + "dependencies": { + "is-extendable": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz", + "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==", + "dev": true, + "requires": { + "is-plain-object": "^2.0.4" + } + } + } + }, + "mkdirp": { + "version": "0.5.1", + "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz", + "integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=", + "dev": true, + "requires": { + "minimist": "0.0.8" + } + }, + "mocha": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/mocha/-/mocha-5.2.0.tgz", + "integrity": "sha1-bYrlCPWRZ/lA8rWzxKYSrlDJCuY=", + "dev": true, + "requires": { + "browser-stdout": "1.3.1", + "commander": "2.15.1", + "debug": "3.1.0", + "diff": "3.5.0", + "escape-string-regexp": "1.0.5", + "glob": "7.1.2", + "growl": "1.10.5", + "he": "1.1.1", + "minimatch": "3.0.4", + "mkdirp": "0.5.1", + "supports-color": "5.4.0" + }, + "dependencies": { + "commander": { + "version": "2.15.1", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.15.1.tgz", + "integrity": "sha1-30boZ9D8Kuxmo0ZitAapzK//Ww8=", + "dev": true + }, + "debug": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz", + "integrity": "sha1-W7WgZyYotkFJVmuhaBnmFRjGcmE=", + "dev": true, + "requires": { + "ms": "2.0.0" + } + }, + "diff": { + "version": "3.5.0", + "resolved": "https://registry.npmjs.org/diff/-/diff-3.5.0.tgz", + "integrity": "sha1-gAwN0eCov7yVg1wgKtIg/jF+WhI=", + "dev": true + }, + "has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", + "dev": true + }, + "supports-color": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz", + "integrity": "sha1-HGszdALCE3YF7+GfEP7DkPb6q1Q=", + "dev": true, + "requires": { + "has-flag": "^3.0.0" + } + } + } + }, + "ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=", + "dev": true + }, + "mute-stream": { + "version": "0.0.5", + "resolved": "https://registry.npmjs.org/mute-stream/-/mute-stream-0.0.5.tgz", + "integrity": "sha1-j7+rsKmKJT0xhDMfno3rc3L6xsA=", + "dev": true + }, + "nan": { + "version": "2.10.0", + "resolved": "https://registry.npmjs.org/nan/-/nan-2.10.0.tgz", + "integrity": "sha512-bAdJv7fBLhWC+/Bls0Oza+mvTaNQtP+1RyhhhvD95pgUJz6XM5IzgmxOkItJ9tkoCiplvAnXI1tNmmUD/eScyA==", + "dev": true + }, + "nanomatch": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/nanomatch/-/nanomatch-1.2.9.tgz", + "integrity": "sha512-n8R9bS8yQ6eSXaV6jHUpKzD8gLsin02w1HSFiegwrs9E098Ylhw5jdyKPaYqvHknHaSCKTPp7C8dGCQ0q9koXA==", + "dev": true, + "requires": { + "arr-diff": "^4.0.0", + "array-unique": "^0.3.2", + "define-property": "^2.0.2", + "extend-shallow": "^3.0.2", + "fragment-cache": "^0.2.1", + "is-odd": "^2.0.0", + "is-windows": "^1.0.2", + "kind-of": "^6.0.2", + "object.pick": "^1.3.0", + "regex-not": "^1.0.0", + "snapdragon": "^0.8.1", + "to-regex": "^3.0.1" + }, + "dependencies": { + "arr-diff": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/arr-diff/-/arr-diff-4.0.0.tgz", + "integrity": "sha1-1kYQdP6/7HHn4VI1dhoyml3HxSA=", + "dev": true + }, + "array-unique": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/array-unique/-/array-unique-0.3.2.tgz", + "integrity": "sha1-qJS3XUvE9s1nnvMkSp/Y9Gri1Cg=", + "dev": true + }, + "kind-of": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz", + "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==", + "dev": true + } + } + }, + "node-gyp": { + "version": "3.7.0", + "resolved": "https://registry.npmjs.org/node-gyp/-/node-gyp-3.7.0.tgz", + "integrity": "sha512-qDQE/Ft9xXP6zphwx4sD0t+VhwV7yFaloMpfbL2QnnDZcyaiakWlLdtFGGQfTAwpFHdpbRhRxVhIHN1OKAjgbg==", + "dev": true, + "requires": { + "fstream": "^1.0.0", + "glob": "^7.0.3", + "graceful-fs": "^4.1.2", + "mkdirp": "^0.5.0", + "nopt": "2 || 3", + "npmlog": "0 || 1 || 2 || 3 || 4", + "osenv": "0", + "request": ">=2.9.0 <2.82.0", + "rimraf": "2", + "semver": "~5.3.0", + "tar": "^2.0.0", + "which": "1" + }, + "dependencies": { + "semver": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-5.3.0.tgz", + "integrity": "sha1-myzl094C0XxgEq0yaqa00M9U+U8=", + "dev": true + } + } + }, + "node-sass": { + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/node-sass/-/node-sass-4.9.0.tgz", + "integrity": "sha512-QFHfrZl6lqRU3csypwviz2XLgGNOoWQbo2GOvtsfQqOfL4cy1BtWnhx/XUeAO9LT3ahBzSRXcEO6DdvAH9DzSg==", + "dev": true, + "requires": { + "async-foreach": "^0.1.3", + "chalk": "^1.1.1", + "cross-spawn": "^3.0.0", + "gaze": "^1.0.0", + "get-stdin": "^4.0.1", + "glob": "^7.0.3", + "in-publish": "^2.0.0", + "lodash.assign": "^4.2.0", + "lodash.clonedeep": "^4.3.2", + "lodash.mergewith": "^4.6.0", + "meow": "^3.7.0", + "mkdirp": "^0.5.1", + "nan": "^2.10.0", + "node-gyp": "^3.3.1", + "npmlog": "^4.0.0", + "request": "~2.79.0", + "sass-graph": "^2.2.4", + "stdout-stream": "^1.4.0", + "true-case-path": "^1.0.2" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "cross-spawn": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-3.0.1.tgz", + "integrity": "sha1-ElYDfsufDF9549bvE14wdwGEuYI=", + "dev": true, + "requires": { + "lru-cache": "^4.0.1", + "which": "^1.2.9" + } + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "node-wp-i18n": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/node-wp-i18n/-/node-wp-i18n-1.1.1.tgz", + "integrity": "sha1-ODd6vO93ZVJhfWqG9q+Nq5jX+vs=", + "dev": true, + "requires": { + "bluebird": "^3.4.1", + "gettext-parser": "^1.2.0", + "glob": "^7.0.5", + "lodash": "^4.14.2", + "minimist": "^1.2.0", + "mkdirp": "^0.5.1", + "tmp": "^0.0.33" + }, + "dependencies": { + "minimist": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz", + "integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ=", + "dev": true + } + } + }, + "nopt": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz", + "integrity": "sha1-xkZdvwirzU2zWTF/eaxopkayj/k=", + "dev": true, + "requires": { + "abbrev": "1" + } + }, + "normalize-package-data": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.4.0.tgz", + "integrity": "sha1-EvlaMH1YNSB1oEkHuErIvpisAS8=", + "dev": true, + "requires": { + "hosted-git-info": "^2.1.4", + "is-builtin-module": "^1.0.0", + "semver": "2 || 3 || 4 || 5", + "validate-npm-package-license": "^3.0.1" + } + }, + "normalize-path": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-2.1.1.tgz", + "integrity": "sha1-GrKLVW4Zg2Oowab35vogE3/mrtk=", + "dev": true, + "requires": { + "remove-trailing-separator": "^1.0.1" + } + }, + "normalize-range": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz", + "integrity": "sha1-LRDAa9/TEuqXd2laTShDlFa3WUI=", + "dev": true + }, + "normalize-selector": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/normalize-selector/-/normalize-selector-0.2.0.tgz", + "integrity": "sha1-0LFF62kRicY6eNIB3E/bEpPvDAM=", + "dev": true + }, + "npm-run-path": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-2.0.2.tgz", + "integrity": "sha1-NakjLfo11wZ7TLLd8jV7GHFTbF8=", + "dev": true, + "requires": { + "path-key": "^2.0.0" + } + }, + "npmlog": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/npmlog/-/npmlog-4.1.2.tgz", + "integrity": "sha512-2uUqazuKlTaSI/dC8AzicUck7+IrEaOnN/e0jd3Xtt1KcGpwx30v50mL7oPyr/h9bL3E4aZccVwpwP+5W9Vjkg==", + "dev": true, + "requires": { + "are-we-there-yet": "~1.1.2", + "console-control-strings": "~1.1.0", + "gauge": "~2.7.3", + "set-blocking": "~2.0.0" + } + }, + "num2fraction": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/num2fraction/-/num2fraction-1.2.2.tgz", + "integrity": "sha1-b2gragJ6Tp3fpFZM0lidHU5mnt4=", + "dev": true + }, + "number-is-nan": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/number-is-nan/-/number-is-nan-1.0.1.tgz", + "integrity": "sha1-CXtgK1NCKlIsGvuHkDGDNpQaAR0=", + "dev": true + }, + "oauth-sign": { + "version": "0.8.2", + "resolved": "https://registry.npmjs.org/oauth-sign/-/oauth-sign-0.8.2.tgz", + "integrity": "sha1-Rqarfwrq2N6unsBWV4C31O/rnUM=", + "dev": true + }, + "object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha1-IQmtx5ZYh8/AXLvUQsrIv7s2CGM=", + "dev": true + }, + "object-copy": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/object-copy/-/object-copy-0.1.0.tgz", + "integrity": "sha1-fn2Fi3gb18mRpBupde04EnVOmYw=", + "dev": true, + "requires": { + "copy-descriptor": "^0.1.0", + "define-property": "^0.2.5", + "kind-of": "^3.0.3" + }, + "dependencies": { + "define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=", + "dev": true, + "requires": { + "is-descriptor": "^0.1.0" + } + } + } + }, + "object-visit": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/object-visit/-/object-visit-1.0.1.tgz", + "integrity": "sha1-95xEk68MU3e1n+OdOV5BBC3QRbs=", + "dev": true, + "requires": { + "isobject": "^3.0.0" + }, + "dependencies": { + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + } + } + }, + "object.omit": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/object.omit/-/object.omit-2.0.1.tgz", + "integrity": "sha1-Gpx0SCnznbuFjHbKNXmuKlTr0fo=", + "dev": true, + "requires": { + "for-own": "^0.1.4", + "is-extendable": "^0.1.1" + } + }, + "object.pick": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/object.pick/-/object.pick-1.3.0.tgz", + "integrity": "sha1-h6EKxMFpS9Lhy/U1kaZhQftd10c=", + "dev": true, + "requires": { + "isobject": "^3.0.1" + }, + "dependencies": { + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + } + } + }, + "once": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", + "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=", + "dev": true, + "requires": { + "wrappy": "1" + } + }, + "onetime": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-1.1.0.tgz", + "integrity": "sha1-ofeDj4MUxRbwXs78vEzP4EtO14k=", + "dev": true + }, + "optimist": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/optimist/-/optimist-0.6.1.tgz", + "integrity": "sha1-2j6nRob6IaGaERwybpDrFaAZZoY=", + "dev": true, + "requires": { + "minimist": "~0.0.1", + "wordwrap": "~0.0.2" + }, + "dependencies": { + "wordwrap": { + "version": "0.0.3", + "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.3.tgz", + "integrity": "sha1-o9XabNXAvAAI03I0u68b7WMFkQc=", + "dev": true + } + } + }, + "os-homedir": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/os-homedir/-/os-homedir-1.0.2.tgz", + "integrity": "sha1-/7xJiDNuDoM94MFox+8VISGqf7M=", + "dev": true + }, + "os-locale": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/os-locale/-/os-locale-1.4.0.tgz", + "integrity": "sha1-IPnxeuKe00XoveWDsT0gCYA8FNk=", + "dev": true, + "requires": { + "lcid": "^1.0.0" + } + }, + "os-tmpdir": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz", + "integrity": "sha1-u+Z0BseaqFxc/sdm/lc0VV36EnQ=", + "dev": true + }, + "osenv": { + "version": "0.1.5", + "resolved": "https://registry.npmjs.org/osenv/-/osenv-0.1.5.tgz", + "integrity": "sha512-0CWcCECdMVc2Rw3U5w9ZjqX6ga6ubk1xDVKxtBQPK7wis/0F2r9T6k4ydGYhecl7YUBxBVxhL5oisPsNxAPe2g==", + "dev": true, + "requires": { + "os-homedir": "^1.0.0", + "os-tmpdir": "^1.0.0" + } + }, + "output-file-sync": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/output-file-sync/-/output-file-sync-1.1.2.tgz", + "integrity": "sha1-0KM+7+YaIF+suQCS6CZZjVJFznY=", + "dev": true, + "requires": { + "graceful-fs": "^4.1.4", + "mkdirp": "^0.5.1", + "object-assign": "^4.1.0" + } + }, + "p-limit": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-1.3.0.tgz", + "integrity": "sha512-vvcXsLAJ9Dr5rQOPk7toZQZJApBl2K4J6dANSsEuh6QI41JYcsS/qhTGa9ErIUUgK3WNQoJYvylxvjqmiqEA9Q==", + "dev": true, + "requires": { + "p-try": "^1.0.0" + } + }, + "p-locate": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-2.0.0.tgz", + "integrity": "sha1-IKAQOyIqcMj9OcwuWAaA893l7EM=", + "dev": true, + "requires": { + "p-limit": "^1.1.0" + } + }, + "p-map": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/p-map/-/p-map-1.2.0.tgz", + "integrity": "sha512-r6zKACMNhjPJMTl8KcFH4li//gkrXWfbD6feV8l6doRHlzljFWGJ2AP6iKaCJXyZmAUMOPtvbW7EXkbWO/pLEA==", + "dev": true + }, + "p-try": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/p-try/-/p-try-1.0.0.tgz", + "integrity": "sha1-y8ec26+P1CKOE/Yh8rGiN8GyB7M=", + "dev": true + }, + "pako": { + "version": "0.2.9", + "resolved": "https://registry.npmjs.org/pako/-/pako-0.2.9.tgz", + "integrity": "sha1-8/dSL073gjSNqBYbrZ7P1Rv4OnU=", + "dev": true + }, + "parse-entities": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/parse-entities/-/parse-entities-1.1.2.tgz", + "integrity": "sha512-5N9lmQ7tmxfXf+hO3X6KRG6w7uYO/HL9fHalSySTdyn63C3WNvTM/1R8tn1u1larNcEbo3Slcy2bsVDQqvEpUg==", + "dev": true, + "requires": { + "character-entities": "^1.0.0", + "character-entities-legacy": "^1.0.0", + "character-reference-invalid": "^1.0.0", + "is-alphanumerical": "^1.0.0", + "is-decimal": "^1.0.0", + "is-hexadecimal": "^1.0.0" + } + }, + "parse-glob": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/parse-glob/-/parse-glob-3.0.4.tgz", + "integrity": "sha1-ssN2z7EfNVE7rdFz7wu246OIORw=", + "dev": true, + "requires": { + "glob-base": "^0.3.0", + "is-dotfile": "^1.0.0", + "is-extglob": "^1.0.0", + "is-glob": "^2.0.0" + } + }, + "parse-json": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-2.2.0.tgz", + "integrity": "sha1-9ID0BDTvgHQfhGkJn43qGPVaTck=", + "dev": true, + "requires": { + "error-ex": "^1.2.0" + } + }, + "pascalcase": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/pascalcase/-/pascalcase-0.1.1.tgz", + "integrity": "sha1-s2PlXoAGym/iF4TS2yK9FdeRfxQ=", + "dev": true + }, + "path-dirname": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/path-dirname/-/path-dirname-1.0.2.tgz", + "integrity": "sha1-zDPSTVJeCZpTiMAzbG4yuRYGCeA=", + "dev": true + }, + "path-exists": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-2.1.0.tgz", + "integrity": "sha1-D+tsZPD8UY2adU3V77YscCJ2H0s=", + "dev": true, + "requires": { + "pinkie-promise": "^2.0.0" + } + }, + "path-is-absolute": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", + "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=", + "dev": true + }, + "path-is-inside": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/path-is-inside/-/path-is-inside-1.0.2.tgz", + "integrity": "sha1-NlQX3t5EQw0cEa9hAn+s8HS9/FM=", + "dev": true + }, + "path-key": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-2.0.1.tgz", + "integrity": "sha1-QRyttXTFoUDTpLGRDUDYDMn0C0A=", + "dev": true + }, + "path-parse": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.5.tgz", + "integrity": "sha1-PBrfhx6pzWyUMbbqK9dKD/BVxME=", + "dev": true + }, + "path-type": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-1.1.0.tgz", + "integrity": "sha1-WcRPfuSR2nBNpBXaWkBwuk+P5EE=", + "dev": true, + "requires": { + "graceful-fs": "^4.1.2", + "pify": "^2.0.0", + "pinkie-promise": "^2.0.0" + }, + "dependencies": { + "pify": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=", + "dev": true + } + } + }, + "pathval": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/pathval/-/pathval-1.1.0.tgz", + "integrity": "sha1-uULm1L3mUwBe9rcTYd74cn0GReA=", + "dev": true + }, + "pend": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/pend/-/pend-1.2.0.tgz", + "integrity": "sha1-elfrVQpng/kRUzH89GY9XI4AelA=", + "dev": true + }, + "performance-now": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/performance-now/-/performance-now-2.1.0.tgz", + "integrity": "sha1-Ywn04OX6kT7BxpMHrjZLSzd8nns=", + "dev": true + }, + "pify": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz", + "integrity": "sha1-5aSs0sEB/fPZpNB/DbxNtJ3SgXY=", + "dev": true + }, + "pinkie": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/pinkie/-/pinkie-2.0.4.tgz", + "integrity": "sha1-clVrgM+g1IqXToDnckjoDtT3+HA=", + "dev": true + }, + "pinkie-promise": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/pinkie-promise/-/pinkie-promise-2.0.1.tgz", + "integrity": "sha1-ITXW36ejWMBprJsXh3YogihFD/o=", + "dev": true, + "requires": { + "pinkie": "^2.0.0" + } + }, + "posix-character-classes": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/posix-character-classes/-/posix-character-classes-0.1.1.tgz", + "integrity": "sha1-AerA/jta9xoqbAL+q7jB/vfgDqs=", + "dev": true + }, + "postcss": { + "version": "6.0.14", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-6.0.14.tgz", + "integrity": "sha1-VTTHIRRznnXQr88BfbhTCZ9WKIU=", + "dev": true, + "requires": { + "chalk": "^2.3.0", + "source-map": "^0.6.1", + "supports-color": "^4.4.0" + } + }, + "postcss-html": { + "version": "0.23.7", + "resolved": "https://registry.npmjs.org/postcss-html/-/postcss-html-0.23.7.tgz", + "integrity": "sha1-RxRsFeIbnAB0bEARXc/4JwxDnzI=", + "dev": true, + "requires": { + "htmlparser2": "^3.9.2" + }, + "dependencies": { + "entities": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-1.1.1.tgz", + "integrity": "sha1-blwtClYhtdra7O+AuQ7ftc13cvA=", + "dev": true + }, + "htmlparser2": { + "version": "3.9.2", + "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-3.9.2.tgz", + "integrity": "sha1-G9+HrMoPP55T+k/M6w9LTLsAszg=", + "dev": true, + "requires": { + "domelementtype": "^1.3.0", + "domhandler": "^2.3.0", + "domutils": "^1.5.1", + "entities": "^1.1.1", + "inherits": "^2.0.1", + "readable-stream": "^2.0.2" + } + } + } + }, + "postcss-less": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/postcss-less/-/postcss-less-1.1.5.tgz", + "integrity": "sha512-QQIiIqgEjNnquc0d4b6HDOSFZxbFQoy4MPpli2lSLpKhMyBkKwwca2HFqu4xzxlKID/F2fxSOowwtKpgczhF7A==", + "dev": true, + "requires": { + "postcss": "^5.2.16" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + }, + "dependencies": { + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + } + } + }, + "has-flag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-1.0.0.tgz", + "integrity": "sha1-nZ55MWXOAXoA8AQYxD+UKnsdEfo=", + "dev": true + }, + "postcss": { + "version": "5.2.18", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz", + "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==", + "dev": true, + "requires": { + "chalk": "^1.1.3", + "js-base64": "^2.1.9", + "source-map": "^0.5.6", + "supports-color": "^3.2.3" + } + }, + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + }, + "supports-color": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz", + "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=", + "dev": true, + "requires": { + "has-flag": "^1.0.0" + } + } + } + }, + "postcss-markdown": { + "version": "0.23.7", + "resolved": "https://registry.npmjs.org/postcss-markdown/-/postcss-markdown-0.23.7.tgz", + "integrity": "sha1-fjo5h5QpXEJeUeTwq97m0TrT0TQ=", + "dev": true, + "requires": { + "remark": "^9.0.0", + "unist-util-find-all-after": "^1.0.2" + } + }, + "postcss-media-query-parser": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/postcss-media-query-parser/-/postcss-media-query-parser-0.2.3.tgz", + "integrity": "sha1-J7Ocb02U+Bsac7j3Y1HGCeXO8kQ=", + "dev": true + }, + "postcss-reporter": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/postcss-reporter/-/postcss-reporter-5.0.0.tgz", + "integrity": "sha512-rBkDbaHAu5uywbCR2XE8a25tats3xSOsGNx6mppK6Q9kSFGKc/FyAzfci+fWM2l+K402p1D0pNcfDGxeje5IKg==", + "dev": true, + "requires": { + "chalk": "^2.0.1", + "lodash": "^4.17.4", + "log-symbols": "^2.0.0", + "postcss": "^6.0.8" + } + }, + "postcss-resolve-nested-selector": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/postcss-resolve-nested-selector/-/postcss-resolve-nested-selector-0.1.1.tgz", + "integrity": "sha1-Kcy8fDfe36wwTp//C/FZaz9qDk4=", + "dev": true + }, + "postcss-safe-parser": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/postcss-safe-parser/-/postcss-safe-parser-3.0.1.tgz", + "integrity": "sha1-t1Pv9sfArqXoN1++TN6L+QY/8UI=", + "dev": true, + "requires": { + "postcss": "^6.0.6" + } + }, + "postcss-sass": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/postcss-sass/-/postcss-sass-0.3.2.tgz", + "integrity": "sha512-0HgxikiZ07VKYr98KT+k7/rAzyMgZlP+3+R8vUti56T2dPdhW0OhPGDQzddxY/N2iDtBVZQqCHRDA09j5I6EWg==", + "dev": true, + "requires": { + "gonzales-pe": "4.2.3", + "postcss": "6.0.22" + }, + "dependencies": { + "ansi-styles": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", + "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", + "dev": true, + "requires": { + "color-convert": "^1.9.0" + } + }, + "chalk": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz", + "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==", + "dev": true, + "requires": { + "ansi-styles": "^3.2.1", + "escape-string-regexp": "^1.0.5", + "supports-color": "^5.3.0" + } + }, + "has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", + "dev": true + }, + "postcss": { + "version": "6.0.22", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-6.0.22.tgz", + "integrity": "sha512-Toc9lLoUASwGqxBSJGTVcOQiDqjK+Z2XlWBg+IgYwQMY9vA2f7iMpXVc1GpPcfTSyM5lkxNo0oDwDRO+wm7XHA==", + "dev": true, + "requires": { + "chalk": "^2.4.1", + "source-map": "^0.6.1", + "supports-color": "^5.4.0" + } + }, + "supports-color": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz", + "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==", + "dev": true, + "requires": { + "has-flag": "^3.0.0" + } + } + } + }, + "postcss-scss": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/postcss-scss/-/postcss-scss-1.0.5.tgz", + "integrity": "sha512-gJB1tKYMkBy0MU+COt6WXA4ZiRctAKoWLa6qD7a6bbEbBMqrpa/BhfQdN80eYMV+JkKddZVEpZlOggnGShpvyg==", + "dev": true, + "requires": { + "postcss": "^6.0.21" + }, + "dependencies": { + "ansi-styles": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", + "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", + "dev": true, + "requires": { + "color-convert": "^1.9.0" + } + }, + "chalk": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz", + "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==", + "dev": true, + "requires": { + "ansi-styles": "^3.2.1", + "escape-string-regexp": "^1.0.5", + "supports-color": "^5.3.0" + } + }, + "has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", + "dev": true + }, + "postcss": { + "version": "6.0.22", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-6.0.22.tgz", + "integrity": "sha512-Toc9lLoUASwGqxBSJGTVcOQiDqjK+Z2XlWBg+IgYwQMY9vA2f7iMpXVc1GpPcfTSyM5lkxNo0oDwDRO+wm7XHA==", + "dev": true, + "requires": { + "chalk": "^2.4.1", + "source-map": "^0.6.1", + "supports-color": "^5.4.0" + } + }, + "supports-color": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz", + "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==", + "dev": true, + "requires": { + "has-flag": "^3.0.0" + } + } + } + }, + "postcss-selector-parser": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-3.1.1.tgz", + "integrity": "sha1-T4dfSvsMllc9XPTXQBGu4lCn6GU=", + "dev": true, + "requires": { + "dot-prop": "^4.1.1", + "indexes-of": "^1.0.1", + "uniq": "^1.0.1" + } + }, + "postcss-syntax": { + "version": "0.9.1", + "resolved": "https://registry.npmjs.org/postcss-syntax/-/postcss-syntax-0.9.1.tgz", + "integrity": "sha512-oC78MbSKmT/kPgqRl9sQrBIsbfr4TN+vH0STuUa7gnewVg9cs+wjJ00Lclu1GbKy38vJE7tBrhvjlEWvyxiZcg==", + "dev": true + }, + "postcss-value-parser": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-3.3.0.tgz", + "integrity": "sha1-h/OPnxj3dKSrTIojL1xc6IcqnRU=", + "dev": true + }, + "preserve": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/preserve/-/preserve-0.2.0.tgz", + "integrity": "sha1-gV7R9uvGWSb4ZbMQwHE7yzMVzks=", + "dev": true + }, + "pretty-bytes": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-3.0.1.tgz", + "integrity": "sha1-J9AAjXeAY6C0gRuzXHnxvV1fvM8=", + "dev": true, + "requires": { + "number-is-nan": "^1.0.0" + } + }, + "private": { + "version": "0.1.8", + "resolved": "https://registry.npmjs.org/private/-/private-0.1.8.tgz", + "integrity": "sha1-I4Hts2ifelPWUxkAYPz4ItLzaP8=", + "dev": true + }, + "process-nextick-args": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-1.0.7.tgz", + "integrity": "sha1-FQ4gt1ZZCtP5EJPyWk8q2L/zC6M=", + "dev": true + }, + "pseudomap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/pseudomap/-/pseudomap-1.0.2.tgz", + "integrity": "sha1-8FKijacOYYkX7wqKw0wa5aaChrM=", + "dev": true + }, + "punycode": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.4.1.tgz", + "integrity": "sha1-wNWmOycYgArY4esPpSachN1BhF4=", + "dev": true + }, + "q": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/q/-/q-1.4.1.tgz", + "integrity": "sha1-VXBbzZPF82c1MMLCy8DCs63cKG4=" + }, + "qs": { + "version": "6.5.1", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.5.1.tgz", + "integrity": "sha1-NJzfbu+J7EXBLX1es/wMhwNDptg=", + "dev": true + }, + "quick-lru": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-1.1.0.tgz", + "integrity": "sha1-Q2CxfGETatOAeDl/8RQW4Ybc+7g=", + "dev": true + }, + "raw-body": { + "version": "1.1.7", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-1.1.7.tgz", + "integrity": "sha1-HQJ8K/oRasxmI7yo8AAWVyqH1CU=", + "dev": true, + "requires": { + "bytes": "1", + "string_decoder": "0.10" + }, + "dependencies": { + "string_decoder": { + "version": "0.10.31", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz", + "integrity": "sha1-YuIDvEF2bGwoyfyEMB2rHFMQ+pQ=", + "dev": true + } + } + }, + "read-pkg": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-1.1.0.tgz", + "integrity": "sha1-9f+qXs0pyzHAR0vKfXVra7KePyg=", + "dev": true, + "requires": { + "load-json-file": "^1.0.0", + "normalize-package-data": "^2.3.2", + "path-type": "^1.0.0" + } + }, + "read-pkg-up": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-1.0.1.tgz", + "integrity": "sha1-nWPBMnbAZZGNV/ACpX9AobZD+wI=", + "dev": true, + "requires": { + "find-up": "^1.0.0", + "read-pkg": "^1.0.0" + } + }, + "readable-stream": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.3.tgz", + "integrity": "sha1-No8lEtefnUb9/HE0mueHi7weuVw=", + "dev": true, + "requires": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.3", + "isarray": "~1.0.0", + "process-nextick-args": "~1.0.6", + "safe-buffer": "~5.1.1", + "string_decoder": "~1.0.3", + "util-deprecate": "~1.0.1" + } + }, + "readdirp": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-2.1.0.tgz", + "integrity": "sha1-TtCtBg3zBzMAxIRANz9y0cxkLXg=", + "dev": true, + "optional": true, + "requires": { + "graceful-fs": "^4.1.2", + "minimatch": "^3.0.2", + "readable-stream": "^2.0.2", + "set-immediate-shim": "^1.0.1" + } + }, + "readline2": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/readline2/-/readline2-1.0.1.tgz", + "integrity": "sha1-QQWWCP/BVHV7cV2ZidGZ/783LjU=", + "dev": true, + "requires": { + "code-point-at": "^1.0.0", + "is-fullwidth-code-point": "^1.0.0", + "mute-stream": "0.0.5" + } + }, + "redent": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/redent/-/redent-1.0.0.tgz", + "integrity": "sha1-z5Fqsf1fHxbfsggi3W7H9zDCr94=", + "dev": true, + "requires": { + "indent-string": "^2.1.0", + "strip-indent": "^1.0.1" + } + }, + "regenerate": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.3.3.tgz", + "integrity": "sha1-DDNtOYBVPXVcObWGrjsgqknIK38=", + "dev": true + }, + "regenerator-runtime": { + "version": "0.11.1", + "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.11.1.tgz", + "integrity": "sha1-vgWtf5v30i4Fb5cmzuUBf78Z4uk=", + "dev": true + }, + "regenerator-transform": { + "version": "0.10.1", + "resolved": "https://registry.npmjs.org/regenerator-transform/-/regenerator-transform-0.10.1.tgz", + "integrity": "sha1-HkmWg3Ix2ot/PPQRTXG1aRoGgN0=", + "dev": true, + "requires": { + "babel-runtime": "^6.18.0", + "babel-types": "^6.19.0", + "private": "^0.1.6" + } + }, + "regex-cache": { + "version": "0.4.4", + "resolved": "https://registry.npmjs.org/regex-cache/-/regex-cache-0.4.4.tgz", + "integrity": "sha1-db3FiioUls7EihKDW8VMjVYjNt0=", + "dev": true, + "requires": { + "is-equal-shallow": "^0.1.3" + } + }, + "regex-not": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/regex-not/-/regex-not-1.0.2.tgz", + "integrity": "sha512-J6SDjUgDxQj5NusnOtdFxDwN/+HWykR8GELwctJ7mdqhcyy1xEc4SRFHUXvxTp661YaVKAjfRLZ9cCqS6tn32A==", + "dev": true, + "requires": { + "extend-shallow": "^3.0.2", + "safe-regex": "^1.1.0" + } + }, + "regexpu-core": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-2.0.0.tgz", + "integrity": "sha1-SdA4g3uNz4v6W5pCE5k45uoq4kA=", + "dev": true, + "requires": { + "regenerate": "^1.2.1", + "regjsgen": "^0.2.0", + "regjsparser": "^0.1.4" + } + }, + "regjsgen": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/regjsgen/-/regjsgen-0.2.0.tgz", + "integrity": "sha1-bAFq3qxVT3WCP+N6wFuS1aTtsfc=", + "dev": true + }, + "regjsparser": { + "version": "0.1.5", + "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.1.5.tgz", + "integrity": "sha1-fuj4Tcb6eS0/0K4ijSS9lJ6tIFw=", + "dev": true, + "requires": { + "jsesc": "~0.5.0" + }, + "dependencies": { + "jsesc": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-0.5.0.tgz", + "integrity": "sha1-597mbjXW/Bb3EP6R1c9p9w8IkR0=", + "dev": true + } + } + }, + "remark": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/remark/-/remark-9.0.0.tgz", + "integrity": "sha512-amw8rGdD5lHbMEakiEsllmkdBP+/KpjW/PRK6NSGPZKCQowh0BT4IWXDAkRMyG3SB9dKPXWMviFjNusXzXNn3A==", + "dev": true, + "requires": { + "remark-parse": "^5.0.0", + "remark-stringify": "^5.0.0", + "unified": "^6.0.0" + } + }, + "remark-parse": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/remark-parse/-/remark-parse-5.0.0.tgz", + "integrity": "sha512-b3iXszZLH1TLoyUzrATcTQUZrwNl1rE70rVdSruJFlDaJ9z5aMkhrG43Pp68OgfHndL/ADz6V69Zow8cTQu+JA==", + "dev": true, + "requires": { + "collapse-white-space": "^1.0.2", + "is-alphabetical": "^1.0.0", + "is-decimal": "^1.0.0", + "is-whitespace-character": "^1.0.0", + "is-word-character": "^1.0.0", + "markdown-escapes": "^1.0.0", + "parse-entities": "^1.1.0", + "repeat-string": "^1.5.4", + "state-toggle": "^1.0.0", + "trim": "0.0.1", + "trim-trailing-lines": "^1.0.0", + "unherit": "^1.0.4", + "unist-util-remove-position": "^1.0.0", + "vfile-location": "^2.0.0", + "xtend": "^4.0.1" + } + }, + "remark-stringify": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/remark-stringify/-/remark-stringify-5.0.0.tgz", + "integrity": "sha512-Ws5MdA69ftqQ/yhRF9XhVV29mhxbfGhbz0Rx5bQH+oJcNhhSM6nCu1EpLod+DjrFGrU0BMPs+czVmJZU7xiS7w==", + "dev": true, + "requires": { + "ccount": "^1.0.0", + "is-alphanumeric": "^1.0.0", + "is-decimal": "^1.0.0", + "is-whitespace-character": "^1.0.0", + "longest-streak": "^2.0.1", + "markdown-escapes": "^1.0.0", + "markdown-table": "^1.1.0", + "mdast-util-compact": "^1.0.0", + "parse-entities": "^1.0.2", + "repeat-string": "^1.5.4", + "state-toggle": "^1.0.0", + "stringify-entities": "^1.0.1", + "unherit": "^1.0.4", + "xtend": "^4.0.1" + } + }, + "remove-trailing-separator": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/remove-trailing-separator/-/remove-trailing-separator-1.1.0.tgz", + "integrity": "sha1-wkvOKig62tW8P1jg1IJJuSN52O8=", + "dev": true + }, + "repeat-element": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/repeat-element/-/repeat-element-1.1.2.tgz", + "integrity": "sha1-7wiaF40Ug7quTZPrmLT55OEdmQo=", + "dev": true + }, + "repeat-string": { + "version": "1.6.1", + "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz", + "integrity": "sha1-jcrkcOHIirwtYA//Sndihtp15jc=", + "dev": true + }, + "repeating": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/repeating/-/repeating-2.0.1.tgz", + "integrity": "sha1-UhTFOpJtNVJwdSf7q0FdvAjQbdo=", + "dev": true, + "requires": { + "is-finite": "^1.0.0" + } + }, + "replace-ext": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/replace-ext/-/replace-ext-1.0.0.tgz", + "integrity": "sha1-3mMSg3P8v3w8z6TeWkgMRaZ5WOs=", + "dev": true + }, + "request": { + "version": "2.79.0", + "resolved": "https://registry.npmjs.org/request/-/request-2.79.0.tgz", + "integrity": "sha1-Tf5b9r6LjNw3/Pk+BLZVd3InEN4=", + "dev": true, + "requires": { + "aws-sign2": "~0.6.0", + "aws4": "^1.2.1", + "caseless": "~0.11.0", + "combined-stream": "~1.0.5", + "extend": "~3.0.0", + "forever-agent": "~0.6.1", + "form-data": "~2.1.1", + "har-validator": "~2.0.6", + "hawk": "~3.1.3", + "http-signature": "~1.1.0", + "is-typedarray": "~1.0.0", + "isstream": "~0.1.2", + "json-stringify-safe": "~5.0.1", + "mime-types": "~2.1.7", + "oauth-sign": "~0.8.1", + "qs": "~6.3.0", + "stringstream": "~0.0.4", + "tough-cookie": "~2.3.0", + "tunnel-agent": "~0.4.1", + "uuid": "^3.0.0" + }, + "dependencies": { + "ansi-styles": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz", + "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=", + "dev": true + }, + "assert-plus": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/assert-plus/-/assert-plus-0.2.0.tgz", + "integrity": "sha1-104bh+ev/A24qttwIfP+SBAasjQ=", + "dev": true + }, + "aws-sign2": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/aws-sign2/-/aws-sign2-0.6.0.tgz", + "integrity": "sha1-FDQt0428yU0OW4fXY81jYSwOeU8=", + "dev": true + }, + "caseless": { + "version": "0.11.0", + "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.11.0.tgz", + "integrity": "sha1-cVuW6phBWTzDMGeSP17GDr2k99c=", + "dev": true + }, + "chalk": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz", + "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=", + "dev": true, + "requires": { + "ansi-styles": "^2.2.1", + "escape-string-regexp": "^1.0.2", + "has-ansi": "^2.0.0", + "strip-ansi": "^3.0.0", + "supports-color": "^2.0.0" + } + }, + "form-data": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.1.4.tgz", + "integrity": "sha1-M8GDrPGTJ27KqYFDpp6Uv+4XUNE=", + "dev": true, + "requires": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.5", + "mime-types": "^2.1.12" + } + }, + "har-validator": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/har-validator/-/har-validator-2.0.6.tgz", + "integrity": "sha1-zcvAgYgmWtEZtqWnyKtw7s+10n0=", + "dev": true, + "requires": { + "chalk": "^1.1.1", + "commander": "^2.9.0", + "is-my-json-valid": "^2.12.4", + "pinkie-promise": "^2.0.0" + } + }, + "http-signature": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/http-signature/-/http-signature-1.1.1.tgz", + "integrity": "sha1-33LiZwZs0Kxn+3at+OE0qPvPkb8=", + "dev": true, + "requires": { + "assert-plus": "^0.2.0", + "jsprim": "^1.2.2", + "sshpk": "^1.7.0" + } + }, + "qs": { + "version": "6.3.2", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.3.2.tgz", + "integrity": "sha1-51vV9uJoEioqDgvaYwslUMFmUCw=", + "dev": true + }, + "supports-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz", + "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=", + "dev": true + }, + "tunnel-agent": { + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.4.3.tgz", + "integrity": "sha1-Y3PbdpCf5XDgjXNYM2Xtgop07us=", + "dev": true + } + } + }, + "require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha1-jGStX9MNqxyXbiNE/+f3kqam30I=", + "dev": true + }, + "require-main-filename": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/require-main-filename/-/require-main-filename-1.0.1.tgz", + "integrity": "sha1-l/cXtp1IeE9fUmpsWqj/3aBVpNE=", + "dev": true + }, + "resolve": { + "version": "1.1.7", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.1.7.tgz", + "integrity": "sha1-IDEU2CrSxe2ejgQRs5ModeiJ6Xs=", + "dev": true + }, + "resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true + }, + "resolve-url": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/resolve-url/-/resolve-url-0.2.1.tgz", + "integrity": "sha1-LGN/53yJOv0qZj/iGqkIAGjiBSo=", + "dev": true + }, + "restore-cursor": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-1.0.1.tgz", + "integrity": "sha1-NGYfRohjJ/7SmRR5FSJS35LapUE=", + "dev": true, + "requires": { + "exit-hook": "^1.0.0", + "onetime": "^1.0.0" + } + }, + "ret": { + "version": "0.1.15", + "resolved": "https://registry.npmjs.org/ret/-/ret-0.1.15.tgz", + "integrity": "sha512-TTlYpa+OL+vMMNG24xSlQGEJ3B/RzEfUlLct7b5G/ytav+wPrplCpVMFuwzXbkecJrb6IYo1iFb0S9v37754mg==", + "dev": true + }, + "right-align": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/right-align/-/right-align-0.1.3.tgz", + "integrity": "sha1-YTObci/mo1FWiSENJOFMlhSGE+8=", + "dev": true, + "optional": true, + "requires": { + "align-text": "^0.1.1" + } + }, + "rimraf": { + "version": "2.6.2", + "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.6.2.tgz", + "integrity": "sha1-LtgVDSShbqhlHm1u8PR8QVjOejY=", + "dev": true, + "requires": { + "glob": "^7.0.5" + } + }, + "rtlcss": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/rtlcss/-/rtlcss-2.2.1.tgz", + "integrity": "sha1-+FN+QVUggWawXhiYAhMZNvzv0p4=", + "dev": true, + "requires": { + "chalk": "^2.3.0", + "findup": "^0.1.5", + "mkdirp": "^0.5.1", + "postcss": "^6.0.14", + "strip-json-comments": "^2.0.0" + }, + "dependencies": { + "strip-json-comments": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", + "integrity": "sha1-PFMZQukIwml8DsNEhYwobHygpgo=", + "dev": true + } + } + }, + "run-async": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/run-async/-/run-async-0.1.0.tgz", + "integrity": "sha1-yK1KXhEGYeQCp9IbUw4AnyX444k=", + "dev": true, + "requires": { + "once": "^1.3.0" + } + }, + "rx-lite": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/rx-lite/-/rx-lite-3.1.2.tgz", + "integrity": "sha1-Gc5QLKVyZl87ZHsQk5+X/RYV8QI=", + "dev": true + }, + "safe-buffer": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.1.tgz", + "integrity": "sha1-iTMSr2myEj3vcfV4iQAWce6yyFM=", + "dev": true + }, + "safe-json-parse": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/safe-json-parse/-/safe-json-parse-1.0.1.tgz", + "integrity": "sha1-PnZyPjjf3aE8mx0poeB//uSzC1c=", + "dev": true + }, + "safe-regex": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/safe-regex/-/safe-regex-1.1.0.tgz", + "integrity": "sha1-QKNmnzsHfR6UPURinhV91IAjvy4=", + "dev": true, + "requires": { + "ret": "~0.1.10" + } + }, + "safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha1-RPoWGwGHuVSd2Eu5GAL5vYOFzWo=", + "dev": true + }, + "sass-graph": { + "version": "2.2.4", + "resolved": "https://registry.npmjs.org/sass-graph/-/sass-graph-2.2.4.tgz", + "integrity": "sha1-E/vWPNHK8JCLn9k0dq1DpR0eC0k=", + "dev": true, + "requires": { + "glob": "^7.0.0", + "lodash": "^4.0.0", + "scss-tokenizer": "^0.2.3", + "yargs": "^7.0.0" + } + }, + "saucelabs": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/saucelabs/-/saucelabs-1.5.0.tgz", + "integrity": "sha512-jlX3FGdWvYf4Q3LFfFWS1QvPg3IGCGWxIc8QBFdPTbpTJnt/v17FHXYVAn7C8sHf1yUXo2c7yIM0isDryfYtHQ==", + "dev": true, + "requires": { + "https-proxy-agent": "^2.2.1" + }, + "dependencies": { + "agent-base": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-4.2.0.tgz", + "integrity": "sha512-c+R/U5X+2zz2+UCrCFv6odQzJdoqI+YecuhnAJLa1zYaMc13zPfwMwZrr91Pd1DYNo/yPRbiM4WVf9whgwFsIg==", + "dev": true, + "requires": { + "es6-promisify": "^5.0.0" + } + }, + "debug": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz", + "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==", + "dev": true, + "requires": { + "ms": "2.0.0" + } + }, + "https-proxy-agent": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-2.2.1.tgz", + "integrity": "sha512-HPCTS1LW51bcyMYbxUIOO4HEOlQ1/1qRaFWcyxvwaqUS9TY88aoEuHUY33kuAh1YhVVaDQhLZsnPd+XNARWZlQ==", + "dev": true, + "requires": { + "agent-base": "^4.1.0", + "debug": "^3.1.0" + } + } + } + }, + "sax": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/sax/-/sax-1.2.4.tgz", + "integrity": "sha1-KBYjTiN4vdxOU1T6tcqold9xANk=", + "dev": true + }, + "scss-tokenizer": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/scss-tokenizer/-/scss-tokenizer-0.2.3.tgz", + "integrity": "sha1-jrBtualyMzOCTT9VMGQRSYR85dE=", + "dev": true, + "requires": { + "js-base64": "^2.1.8", + "source-map": "^0.4.2" + }, + "dependencies": { + "source-map": { + "version": "0.4.4", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz", + "integrity": "sha1-66T12pwNyZneaAMti092FzZSA2s=", + "dev": true, + "requires": { + "amdefine": ">=0.0.4" + } + } + } + }, + "selenium-webdriver": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/selenium-webdriver/-/selenium-webdriver-3.6.0.tgz", + "integrity": "sha1-K6h6FmLAILiYjJga5iyyoBKY6vw=", + "dev": true, + "requires": { + "jszip": "^3.1.3", + "rimraf": "^2.5.4", + "tmp": "0.0.30", + "xml2js": "^0.4.17" + }, + "dependencies": { + "tmp": { + "version": "0.0.30", + "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.30.tgz", + "integrity": "sha1-ckGdSovn1s51FI/YsyTlk6cRwu0=", + "dev": true, + "requires": { + "os-tmpdir": "~1.0.1" + } + } + } + }, + "semver": { + "version": "5.4.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-5.4.1.tgz", + "integrity": "sha1-4FnAnYVx8FQII3M0M1BdOi8AsY4=", + "dev": true + }, + "set-blocking": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz", + "integrity": "sha1-BF+XgtARrppoA93TgrJDkrPYkPc=", + "dev": true + }, + "set-immediate-shim": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/set-immediate-shim/-/set-immediate-shim-1.0.1.tgz", + "integrity": "sha1-SysbJ+uAip+NzEgaWOXlb1mfP2E=", + "dev": true + }, + "set-value": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/set-value/-/set-value-2.0.0.tgz", + "integrity": "sha512-hw0yxk9GT/Hr5yJEYnHNKYXkIA8mVJgd9ditYZCe16ZczcaELYYcfvaXesNACk2O8O0nTiPQcQhGUQj8JLzeeg==", + "dev": true, + "requires": { + "extend-shallow": "^2.0.1", + "is-extendable": "^0.1.1", + "is-plain-object": "^2.0.3", + "split-string": "^3.0.1" + }, + "dependencies": { + "extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=", + "dev": true, + "requires": { + "is-extendable": "^0.1.0" + } + } + } + }, + "shebang-command": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-1.2.0.tgz", + "integrity": "sha1-RKrGW2lbAzmJaMOfNj/uXer98eo=", + "dev": true, + "requires": { + "shebang-regex": "^1.0.0" + } + }, + "shebang-regex": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-1.0.0.tgz", + "integrity": "sha1-2kL0l0DAtC2yypcoVxyxkMmO/qM=", + "dev": true + }, + "shelljs": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/shelljs/-/shelljs-0.3.0.tgz", + "integrity": "sha1-NZbmMHp4FUT1kfN9phg2DzHbV7E=", + "dev": true + }, + "signal-exit": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.2.tgz", + "integrity": "sha1-tf3AjxKH6hF4Yo5BXiUTK3NkbG0=", + "dev": true + }, + "slash": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-1.0.0.tgz", + "integrity": "sha1-xB8vbDn8FtHNF61LXYlhFK5HDVU=", + "dev": true + }, + "slice-ansi": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-1.0.0.tgz", + "integrity": "sha512-POqxBK6Lb3q6s047D/XsDVNPnF9Dl8JSaqe9h9lURl0OdNqy/ujDrOiIHtsqXMGbWWTIomRzAMaTyawAU//Reg==", + "dev": true, + "requires": { + "is-fullwidth-code-point": "^2.0.0" + }, + "dependencies": { + "is-fullwidth-code-point": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-2.0.0.tgz", + "integrity": "sha1-o7MKXE8ZkYMWeqq5O+764937ZU8=", + "dev": true + } + } + }, + "slugs": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/slugs/-/slugs-0.1.3.tgz", + "integrity": "sha1-aa+sUbv3ctuWhFGnGiAm5lQ1CDM=", + "dev": true + }, + "snapdragon": { + "version": "0.8.2", + "resolved": "https://registry.npmjs.org/snapdragon/-/snapdragon-0.8.2.tgz", + "integrity": "sha512-FtyOnWN/wCHTVXOMwvSv26d+ko5vWlIDD6zoUJ7LW8vh+ZBC8QdljveRP+crNrtBwioEUWy/4dMtbBjA4ioNlg==", + "dev": true, + "requires": { + "base": "^0.11.1", + "debug": "^2.2.0", + "define-property": "^0.2.5", + "extend-shallow": "^2.0.1", + "map-cache": "^0.2.2", + "source-map": "^0.5.6", + "source-map-resolve": "^0.5.0", + "use": "^3.1.0" + }, + "dependencies": { + "define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=", + "dev": true, + "requires": { + "is-descriptor": "^0.1.0" + } + }, + "extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=", + "dev": true, + "requires": { + "is-extendable": "^0.1.0" + } + }, + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + } + } + }, + "snapdragon-node": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/snapdragon-node/-/snapdragon-node-2.1.1.tgz", + "integrity": "sha512-O27l4xaMYt/RSQ5TR3vpWCAB5Kb/czIcqUFOM/C4fYcLnbZUc1PkjTAMjof2pBWaSTwOUd6qUHcFGVGj7aIwnw==", + "dev": true, + "requires": { + "define-property": "^1.0.0", + "isobject": "^3.0.0", + "snapdragon-util": "^3.0.1" + }, + "dependencies": { + "define-property": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz", + "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=", + "dev": true, + "requires": { + "is-descriptor": "^1.0.0" + } + }, + "is-accessor-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz", + "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==", + "dev": true, + "requires": { + "kind-of": "^6.0.0" + } + }, + "is-data-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz", + "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==", + "dev": true, + "requires": { + "kind-of": "^6.0.0" + } + }, + "is-descriptor": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz", + "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==", + "dev": true, + "requires": { + "is-accessor-descriptor": "^1.0.0", + "is-data-descriptor": "^1.0.0", + "kind-of": "^6.0.2" + } + }, + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + }, + "kind-of": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz", + "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==", + "dev": true + } + } + }, + "snapdragon-util": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/snapdragon-util/-/snapdragon-util-3.0.1.tgz", + "integrity": "sha512-mbKkMdQKsjX4BAL4bRYTj21edOf8cN7XHdYUJEe+Zn99hVEYcMvKPct1IqNe7+AZPirn8BCDOQBHQZknqmKlZQ==", + "dev": true, + "requires": { + "kind-of": "^3.2.0" + } + }, + "sntp": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/sntp/-/sntp-1.0.9.tgz", + "integrity": "sha1-ZUEYTMkK7qbG57NeJlkIJEPGYZg=", + "dev": true, + "requires": { + "hoek": "2.x.x" + } + }, + "source-map": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", + "integrity": "sha1-dHIq8y6WFOnCh6jQu95IteLxomM=", + "dev": true + }, + "source-map-resolve": { + "version": "0.5.2", + "resolved": "https://registry.npmjs.org/source-map-resolve/-/source-map-resolve-0.5.2.tgz", + "integrity": "sha512-MjqsvNwyz1s0k81Goz/9vRBe9SZdB09Bdw+/zYyO+3CuPk6fouTaxscHkgtE8jKvf01kVfl8riHzERQ/kefaSA==", + "dev": true, + "requires": { + "atob": "^2.1.1", + "decode-uri-component": "^0.2.0", + "resolve-url": "^0.2.1", + "source-map-url": "^0.4.0", + "urix": "^0.1.0" + } + }, + "source-map-support": { + "version": "0.4.18", + "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.4.18.tgz", + "integrity": "sha1-Aoam3ovkJkEzhZTpfM6nXwosWF8=", + "dev": true, + "requires": { + "source-map": "^0.5.6" + }, + "dependencies": { + "source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=", + "dev": true + } + } + }, + "source-map-url": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/source-map-url/-/source-map-url-0.4.0.tgz", + "integrity": "sha1-PpNdfd1zYxuXZZlW1VEo6HtQhKM=", + "dev": true + }, + "spdx-correct": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-1.0.2.tgz", + "integrity": "sha1-SzBz2TP/UfORLwOsVRlJikFQ20A=", + "dev": true, + "requires": { + "spdx-license-ids": "^1.0.2" + } + }, + "spdx-expression-parse": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-1.0.4.tgz", + "integrity": "sha1-m98vIOH0DtRH++JzJmGR/O1RYmw=", + "dev": true + }, + "spdx-license-ids": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-1.2.2.tgz", + "integrity": "sha1-yd96NCRZSt5r0RkA1ZZpbcBrrFc=", + "dev": true + }, + "specificity": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/specificity/-/specificity-0.3.2.tgz", + "integrity": "sha512-Nc/QN/A425Qog7j9aHmwOrlwX2e7pNI47ciwxwy4jOlvbbMHkNNJchit+FX+UjF3IAdiaaV5BKeWuDUnws6G1A==", + "dev": true + }, + "split-string": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/split-string/-/split-string-3.1.0.tgz", + "integrity": "sha512-NzNVhJDYpwceVVii8/Hu6DKfD2G+NrQHlS/V/qgv763EYudVwEcMQNxd2lh+0VrUByXN/oJkl5grOhYWvQUYiw==", + "dev": true, + "requires": { + "extend-shallow": "^3.0.0" + } + }, + "sprintf-js": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz", + "integrity": "sha1-BOaSb2YolTVPPdAVIDYzuFcpfiw=", + "dev": true + }, + "sshpk": { + "version": "1.13.1", + "resolved": "https://registry.npmjs.org/sshpk/-/sshpk-1.13.1.tgz", + "integrity": "sha1-US322mKHFEMW3EwY/hzx2UBzm+M=", + "dev": true, + "requires": { + "asn1": "~0.2.3", + "assert-plus": "^1.0.0", + "bcrypt-pbkdf": "^1.0.0", + "dashdash": "^1.12.0", + "ecc-jsbn": "~0.1.1", + "getpass": "^0.1.1", + "jsbn": "~0.1.0", + "tweetnacl": "~0.14.0" + } + }, + "state-toggle": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/state-toggle/-/state-toggle-1.0.1.tgz", + "integrity": "sha512-Qe8QntFrrpWTnHwvwj2FZTgv+PKIsp0B9VxLzLLbSpPXWOgRgc5LVj/aTiSfK1RqIeF9jeC1UeOH8Q8y60A7og==", + "dev": true + }, + "static-extend": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/static-extend/-/static-extend-0.1.2.tgz", + "integrity": "sha1-YICcOcv/VTNyJv1eC1IPNB8ftcY=", + "dev": true, + "requires": { + "define-property": "^0.2.5", + "object-copy": "^0.1.0" + }, + "dependencies": { + "define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=", + "dev": true, + "requires": { + "is-descriptor": "^0.1.0" + } + } + } + }, + "stdout-stream": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/stdout-stream/-/stdout-stream-1.4.0.tgz", + "integrity": "sha1-osfIWH5U2UJ+qe2zrD8s1SLfN4s=", + "dev": true, + "requires": { + "readable-stream": "^2.0.1" + } + }, + "string-template": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/string-template/-/string-template-0.2.1.tgz", + "integrity": "sha1-QpMuWYo1LQH8IuwzZ9nYTuxsmt0=", + "dev": true + }, + "string-width": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-1.0.2.tgz", + "integrity": "sha1-EYvfW4zcUaKn5w0hHgfisLmxB9M=", + "dev": true, + "requires": { + "code-point-at": "^1.0.0", + "is-fullwidth-code-point": "^1.0.0", + "strip-ansi": "^3.0.0" + } + }, + "string_decoder": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.0.3.tgz", + "integrity": "sha1-D8Z9fBQYJd6UKC3VNr7GubzoYKs=", + "dev": true, + "requires": { + "safe-buffer": "~5.1.0" + } + }, + "stringify-entities": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/stringify-entities/-/stringify-entities-1.3.2.tgz", + "integrity": "sha512-nrBAQClJAPN2p+uGCVJRPIPakKeKWZ9GtBCmormE7pWOSlHat7+x5A8gx85M7HM5Dt0BP3pP5RhVW77WdbJJ3A==", + "dev": true, + "requires": { + "character-entities-html4": "^1.0.0", + "character-entities-legacy": "^1.0.0", + "is-alphanumerical": "^1.0.0", + "is-hexadecimal": "^1.0.0" + } + }, + "stringstream": { + "version": "0.0.6", + "resolved": "https://registry.npmjs.org/stringstream/-/stringstream-0.0.6.tgz", + "integrity": "sha512-87GEBAkegbBcweToUrdzf3eLhWNg06FJTebl4BVJz/JgWy8CvEr9dRtX5qWphiynMSQlxxi+QqN0z5T32SLlhA==", + "dev": true + }, + "strip-ansi": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz", + "integrity": "sha1-ajhfuIU9lS1f8F0Oiq+UJ43GPc8=", + "dev": true, + "requires": { + "ansi-regex": "^2.0.0" + } + }, + "strip-bom": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-2.0.0.tgz", + "integrity": "sha1-YhmoVhZSBJHzV4i9vxRHqZx+aw4=", + "dev": true, + "requires": { + "is-utf8": "^0.2.0" + } + }, + "strip-indent": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-1.0.1.tgz", + "integrity": "sha1-DHlipq3vp7vUrDZkYKY4VSrhoKI=", + "dev": true, + "requires": { + "get-stdin": "^4.0.1" + } + }, + "strip-json-comments": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-1.0.4.tgz", + "integrity": "sha1-HhX7ysl9Pumb8tc7TGVrCCu6+5E=", + "dev": true + }, + "style-search": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/style-search/-/style-search-0.1.0.tgz", + "integrity": "sha1-eVjHk+R+MuB9K1yv5cC/jhLneQI=", + "dev": true + }, + "stylelint": { + "version": "9.2.1", + "resolved": "https://registry.npmjs.org/stylelint/-/stylelint-9.2.1.tgz", + "integrity": "sha512-zR0rSMITL8VjTVoIEGsUh5m0lMluHaIbDLAJTrFYVLElYhP6d5HcJc5/cexA1mrKzQkKu7gvmbDclNLgAeiabw==", + "dev": true, + "requires": { + "autoprefixer": "^8.0.0", + "balanced-match": "^1.0.0", + "chalk": "^2.4.1", + "cosmiconfig": "^5.0.0", + "debug": "^3.0.0", + "execall": "^1.0.0", + "file-entry-cache": "^2.0.0", + "get-stdin": "^6.0.0", + "globby": "^8.0.0", + "globjoin": "^0.1.4", + "html-tags": "^2.0.0", + "ignore": "^3.3.3", + "import-lazy": "^3.1.0", + "imurmurhash": "^0.1.4", + "known-css-properties": "^0.6.0", + "lodash": "^4.17.4", + "log-symbols": "^2.0.0", + "mathml-tag-names": "^2.0.1", + "meow": "^5.0.0", + "micromatch": "^2.3.11", + "normalize-selector": "^0.2.0", + "pify": "^3.0.0", + "postcss": "^6.0.16", + "postcss-html": "^0.23.6", + "postcss-less": "^1.1.5", + "postcss-markdown": "^0.23.6", + "postcss-media-query-parser": "^0.2.3", + "postcss-reporter": "^5.0.0", + "postcss-resolve-nested-selector": "^0.1.1", + "postcss-safe-parser": "^3.0.1", + "postcss-sass": "^0.3.0", + "postcss-scss": "^1.0.2", + "postcss-selector-parser": "^3.1.0", + "postcss-syntax": "^0.9.0", + "postcss-value-parser": "^3.3.0", + "resolve-from": "^4.0.0", + "signal-exit": "^3.0.2", + "specificity": "^0.3.1", + "string-width": "^2.1.0", + "style-search": "^0.1.0", + "sugarss": "^1.0.0", + "svg-tags": "^1.0.0", + "table": "^4.0.1" + }, + "dependencies": { + "ansi-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-3.0.0.tgz", + "integrity": "sha1-7QMXwyIGT3lGbAKWa922Bas32Zg=", + "dev": true + }, + "ansi-styles": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", + "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", + "dev": true, + "requires": { + "color-convert": "^1.9.0" + } + }, + "camelcase": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-4.1.0.tgz", + "integrity": "sha1-1UVjW+HjPFQmScaRc+Xeas+uNN0=", + "dev": true + }, + "camelcase-keys": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-4.2.0.tgz", + "integrity": "sha1-oqpfsa9oh1glnDLBQUJteJI7m3c=", + "dev": true, + "requires": { + "camelcase": "^4.1.0", + "map-obj": "^2.0.0", + "quick-lru": "^1.0.0" + } + }, + "chalk": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz", + "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==", + "dev": true, + "requires": { + "ansi-styles": "^3.2.1", + "escape-string-regexp": "^1.0.5", + "supports-color": "^5.3.0" + } + }, + "debug": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz", + "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==", + "dev": true, + "requires": { + "ms": "2.0.0" + } + }, + "find-up": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-2.1.0.tgz", + "integrity": "sha1-RdG35QbHF93UgndaK3eSCjwMV6c=", + "dev": true, + "requires": { + "locate-path": "^2.0.0" + } + }, + "get-stdin": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/get-stdin/-/get-stdin-6.0.0.tgz", + "integrity": "sha512-jp4tHawyV7+fkkSKyvjuLZswblUtz+SQKzSWnBbii16BuZksJlU1wuBYXY75r+duh/llF1ur6oNwi+2ZzjKZ7g==", + "dev": true + }, + "globby": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/globby/-/globby-8.0.1.tgz", + "integrity": "sha512-oMrYrJERnKBLXNLVTqhm3vPEdJ/b2ZE28xN4YARiix1NOIOBPEpOUnm844K1iu/BkphCaf2WNFwMszv8Soi1pw==", + "dev": true, + "requires": { + "array-union": "^1.0.1", + "dir-glob": "^2.0.0", + "fast-glob": "^2.0.2", + "glob": "^7.1.2", + "ignore": "^3.3.5", + "pify": "^3.0.0", + "slash": "^1.0.0" + } + }, + "has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", + "dev": true + }, + "indent-string": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-3.2.0.tgz", + "integrity": "sha1-Sl/W0nzDMvN+VBmlBNu4NxBckok=", + "dev": true + }, + "is-fullwidth-code-point": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-2.0.0.tgz", + "integrity": "sha1-o7MKXE8ZkYMWeqq5O+764937ZU8=", + "dev": true + }, + "load-json-file": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-4.0.0.tgz", + "integrity": "sha1-L19Fq5HjMhYjT9U62rZo607AmTs=", + "dev": true, + "requires": { + "graceful-fs": "^4.1.2", + "parse-json": "^4.0.0", + "pify": "^3.0.0", + "strip-bom": "^3.0.0" + } + }, + "map-obj": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-2.0.0.tgz", + "integrity": "sha1-plzSkIepJZi4eRJXpSPgISIqwfk=", + "dev": true + }, + "meow": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/meow/-/meow-5.0.0.tgz", + "integrity": "sha512-CbTqYU17ABaLefO8vCU153ZZlprKYWDljcndKKDCFcYQITzWCXZAVk4QMFZPgvzrnUQ3uItnIE/LoUOwrT15Ig==", + "dev": true, + "requires": { + "camelcase-keys": "^4.0.0", + "decamelize-keys": "^1.0.0", + "loud-rejection": "^1.0.0", + "minimist-options": "^3.0.1", + "normalize-package-data": "^2.3.4", + "read-pkg-up": "^3.0.0", + "redent": "^2.0.0", + "trim-newlines": "^2.0.0", + "yargs-parser": "^10.0.0" + } + }, + "parse-json": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-4.0.0.tgz", + "integrity": "sha1-vjX1Qlvh9/bHRxhPmKeIy5lHfuA=", + "dev": true, + "requires": { + "error-ex": "^1.3.1", + "json-parse-better-errors": "^1.0.1" + } + }, + "path-type": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-3.0.0.tgz", + "integrity": "sha512-T2ZUsdZFHgA3u4e5PfPbjd7HDDpxPnQb5jN0SrDsjNSuVXHJqtwTnWqG0B1jZrgmJ/7lj1EmVIByWt1gxGkWvg==", + "dev": true, + "requires": { + "pify": "^3.0.0" + } + }, + "postcss": { + "version": "6.0.22", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-6.0.22.tgz", + "integrity": "sha512-Toc9lLoUASwGqxBSJGTVcOQiDqjK+Z2XlWBg+IgYwQMY9vA2f7iMpXVc1GpPcfTSyM5lkxNo0oDwDRO+wm7XHA==", + "dev": true, + "requires": { + "chalk": "^2.4.1", + "source-map": "^0.6.1", + "supports-color": "^5.4.0" + } + }, + "read-pkg": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-3.0.0.tgz", + "integrity": "sha1-nLxoaXj+5l0WwA4rGcI3/Pbjg4k=", + "dev": true, + "requires": { + "load-json-file": "^4.0.0", + "normalize-package-data": "^2.3.2", + "path-type": "^3.0.0" + } + }, + "read-pkg-up": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-3.0.0.tgz", + "integrity": "sha1-PtSWaF26D4/hGNBpHcUfSh/5bwc=", + "dev": true, + "requires": { + "find-up": "^2.0.0", + "read-pkg": "^3.0.0" + } + }, + "redent": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/redent/-/redent-2.0.0.tgz", + "integrity": "sha1-wbIAe0LVfrE4kHmzyDM2OdXhzKo=", + "dev": true, + "requires": { + "indent-string": "^3.0.0", + "strip-indent": "^2.0.0" + } + }, + "string-width": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-2.1.1.tgz", + "integrity": "sha512-nOqH59deCq9SRHlxq1Aw85Jnt4w6KvLKqWVik6oA9ZklXLNIOlqg4F2yrT1MVaTjAqvVwdfeZ7w7aCvJD7ugkw==", + "dev": true, + "requires": { + "is-fullwidth-code-point": "^2.0.0", + "strip-ansi": "^4.0.0" + } + }, + "strip-ansi": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz", + "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=", + "dev": true, + "requires": { + "ansi-regex": "^3.0.0" + } + }, + "strip-bom": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", + "integrity": "sha1-IzTBjpx1n3vdVv3vfprj1YjmjtM=", + "dev": true + }, + "strip-indent": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-2.0.0.tgz", + "integrity": "sha1-XvjbKV0B5u1sv3qrlpmNeCJSe2g=", + "dev": true + }, + "supports-color": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz", + "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==", + "dev": true, + "requires": { + "has-flag": "^3.0.0" + } + }, + "trim-newlines": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-2.0.0.tgz", + "integrity": "sha1-tAPQuRvlDDMd/EuC7s6yLD3hbSA=", + "dev": true + }, + "yargs-parser": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-10.0.0.tgz", + "integrity": "sha512-+DHejWujTVYeMHLff8U96rLc4uE4Emncoftvn5AjhB1Jw1pWxLzgBUT/WYbPrHmy6YPEBTZQx5myHhVcuuu64g==", + "dev": true, + "requires": { + "camelcase": "^4.1.0" + } + } + } + }, + "sugarss": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/sugarss/-/sugarss-1.0.1.tgz", + "integrity": "sha512-3qgLZytikQQEVn1/FrhY7B68gPUUGY3R1Q1vTiD5xT+Ti1DP/8iZuwFet9ONs5+bmL8pZoDQ6JrQHVgrNlK6mA==", + "dev": true, + "requires": { + "postcss": "^6.0.14" + } + }, + "supports-color": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-4.5.0.tgz", + "integrity": "sha1-vnoN5ITexcXN34s9WRJQRJEvY1s=", + "dev": true, + "requires": { + "has-flag": "^2.0.0" + } + }, + "svg-tags": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/svg-tags/-/svg-tags-1.0.0.tgz", + "integrity": "sha1-WPcc7jvVGbWdSyqEO2x95krAR2Q=", + "dev": true + }, + "table": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/table/-/table-4.0.3.tgz", + "integrity": "sha512-S7rnFITmBH1EnyKcvxBh1LjYeQMmnZtCXSEbHcH6S0NoKit24ZuFO/T1vDcLdYsLQkM188PVVhQmzKIuThNkKg==", + "dev": true, + "requires": { + "ajv": "^6.0.1", + "ajv-keywords": "^3.0.0", + "chalk": "^2.1.0", + "lodash": "^4.17.4", + "slice-ansi": "1.0.0", + "string-width": "^2.1.1" + }, + "dependencies": { + "ajv": { + "version": "6.5.1", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.5.1.tgz", + "integrity": "sha512-pgZos1vgOHDiC7gKNbZW8eKvCnNXARv2oqrGQT7Hzbq5Azp7aZG6DJzADnkuSq7RH6qkXp4J/m68yPX/2uBHyQ==", + "dev": true, + "requires": { + "fast-deep-equal": "^2.0.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.1" + } + }, + "ansi-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-3.0.0.tgz", + "integrity": "sha1-7QMXwyIGT3lGbAKWa922Bas32Zg=", + "dev": true + }, + "fast-deep-equal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-2.0.1.tgz", + "integrity": "sha1-ewUhjd+WZ79/Nwv3/bLLFf3Qqkk=", + "dev": true + }, + "is-fullwidth-code-point": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-2.0.0.tgz", + "integrity": "sha1-o7MKXE8ZkYMWeqq5O+764937ZU8=", + "dev": true + }, + "json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true + }, + "string-width": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-2.1.1.tgz", + "integrity": "sha512-nOqH59deCq9SRHlxq1Aw85Jnt4w6KvLKqWVik6oA9ZklXLNIOlqg4F2yrT1MVaTjAqvVwdfeZ7w7aCvJD7ugkw==", + "dev": true, + "requires": { + "is-fullwidth-code-point": "^2.0.0", + "strip-ansi": "^4.0.0" + } + }, + "strip-ansi": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz", + "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=", + "dev": true, + "requires": { + "ansi-regex": "^3.0.0" + } + } + } + }, + "tar": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/tar/-/tar-2.2.1.tgz", + "integrity": "sha1-jk0qJWwOIYXGsYrWlK7JaLg8sdE=", + "dev": true, + "requires": { + "block-stream": "*", + "fstream": "^1.0.2", + "inherits": "2" + } + }, + "temp": { + "version": "0.8.3", + "resolved": "https://registry.npmjs.org/temp/-/temp-0.8.3.tgz", + "integrity": "sha1-4Ma8TSa5AxJEEOT+2BEDAU38H1k=", + "dev": true, + "requires": { + "os-tmpdir": "^1.0.0", + "rimraf": "~2.2.6" + }, + "dependencies": { + "rimraf": { + "version": "2.2.8", + "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.2.8.tgz", + "integrity": "sha1-5Dm+Kq7jJzIZUnMPmaiSnk/FBYI=", + "dev": true + } + } + }, + "text-table": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/text-table/-/text-table-0.2.0.tgz", + "integrity": "sha1-f17oI66AUgfACvLfSoTsP8+lcLQ=", + "dev": true + }, + "through": { + "version": "2.3.8", + "resolved": "https://registry.npmjs.org/through/-/through-2.3.8.tgz", + "integrity": "sha1-DdTJ/6q8NXlgsbckEV1+Doai4fU=", + "dev": true + }, + "tiny-lr": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/tiny-lr/-/tiny-lr-1.1.1.tgz", + "integrity": "sha512-44yhA3tsaRoMOjQQ+5v5mVdqef+kH6Qze9jTpqtVufgYjYt08zyZAwNwwVBj3i1rJMnR52IxOW0LK0vBzgAkuA==", + "dev": true, + "requires": { + "body": "^5.1.0", + "debug": "^3.1.0", + "faye-websocket": "~0.10.0", + "livereload-js": "^2.3.0", + "object-assign": "^4.1.0", + "qs": "^6.4.0" + }, + "dependencies": { + "debug": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz", + "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==", + "dev": true, + "requires": { + "ms": "2.0.0" + } + } + } + }, + "tmp": { + "version": "0.0.33", + "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.33.tgz", + "integrity": "sha1-bTQzWIl2jSGyvNoKonfO07G/rfk=", + "dev": true, + "requires": { + "os-tmpdir": "~1.0.2" + } + }, + "to-fast-properties": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-1.0.3.tgz", + "integrity": "sha1-uDVx+k2MJbguIxsG46MFXeTKGkc=", + "dev": true + }, + "to-object-path": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/to-object-path/-/to-object-path-0.3.0.tgz", + "integrity": "sha1-KXWIt7Dn4KwI4E5nL4XB9JmeF68=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + } + }, + "to-regex": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/to-regex/-/to-regex-3.0.2.tgz", + "integrity": "sha512-FWtleNAtZ/Ki2qtqej2CXTOayOH9bHDQF+Q48VpWyDXjbYxA4Yz8iDB31zXOBUlOHHKidDbqGVrTUvQMPmBGBw==", + "dev": true, + "requires": { + "define-property": "^2.0.2", + "extend-shallow": "^3.0.2", + "regex-not": "^1.0.2", + "safe-regex": "^1.1.0" + } + }, + "to-regex-range": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-2.1.1.tgz", + "integrity": "sha1-fIDBe53+vlmeJzZ+DU3VWQFB2zg=", + "dev": true, + "requires": { + "is-number": "^3.0.0", + "repeat-string": "^1.6.1" + }, + "dependencies": { + "is-number": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-3.0.0.tgz", + "integrity": "sha1-JP1iAaR4LPUFYcgQJ2r8fRLXEZU=", + "dev": true, + "requires": { + "kind-of": "^3.0.2" + } + } + } + }, + "tough-cookie": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.3.3.tgz", + "integrity": "sha1-C2GKVWW23qkL80JdBNVe3EdadWE=", + "dev": true, + "requires": { + "punycode": "^1.4.1" + } + }, + "trim": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/trim/-/trim-0.0.1.tgz", + "integrity": "sha1-WFhUf2spB1fulczMZm+1AITEYN0=", + "dev": true + }, + "trim-newlines": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-1.0.0.tgz", + "integrity": "sha1-WIeWa7WCpFA6QetST301ARgVphM=", + "dev": true + }, + "trim-right": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/trim-right/-/trim-right-1.0.1.tgz", + "integrity": "sha1-yy4SAwZ+DI3h9hQJS5/kVwTqYAM=", + "dev": true + }, + "trim-trailing-lines": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/trim-trailing-lines/-/trim-trailing-lines-1.1.1.tgz", + "integrity": "sha512-bWLv9BbWbbd7mlqqs2oQYnLD/U/ZqeJeJwbO0FG2zA1aTq+HTvxfHNKFa/HGCVyJpDiioUYaBhfiT6rgk+l4mg==", + "dev": true + }, + "trough": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/trough/-/trough-1.0.2.tgz", + "integrity": "sha512-FHkoUZvG6Egrv9XZAyYGKEyb1JMsFphgPjoczkZC2y6W93U1jswcVURB8MUvtsahEPEVACyxD47JAL63vF4JsQ==", + "dev": true + }, + "true-case-path": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/true-case-path/-/true-case-path-1.0.2.tgz", + "integrity": "sha1-fskRMJJHZsf1c74wIMNPj9/QDWI=", + "dev": true, + "requires": { + "glob": "^6.0.4" + }, + "dependencies": { + "glob": { + "version": "6.0.4", + "resolved": "https://registry.npmjs.org/glob/-/glob-6.0.4.tgz", + "integrity": "sha1-DwiGD2oVUSey+t1PnOJLGqtuTSI=", + "dev": true, + "requires": { + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "2 || 3", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + } + } + } + }, + "tunnel-agent": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", + "integrity": "sha1-J6XeoGs2sEoKmWZ3SykIaPD8QP0=", + "dev": true, + "requires": { + "safe-buffer": "^5.0.1" + } + }, + "tweetnacl": { + "version": "0.14.5", + "resolved": "https://registry.npmjs.org/tweetnacl/-/tweetnacl-0.14.5.tgz", + "integrity": "sha1-WuaBd/GS1EViadEIr6k/+HQ/T2Q=", + "dev": true, + "optional": true + }, + "type-detect": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz", + "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==", + "dev": true + }, + "typedarray": { + "version": "0.0.6", + "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz", + "integrity": "sha1-hnrHTjhkGHsdPUfZlqeOxciDB3c=", + "dev": true + }, + "uglify-js": { + "version": "3.3.28", + "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.3.28.tgz", + "integrity": "sha512-68Rc/aA6cswiaQ5SrE979UJcXX+ADA1z33/ZsPd+fbAiVdjZ16OXdbtGO+rJUUBgK6qdf3SOPhQf3K/ybF5Miw==", + "dev": true, + "requires": { + "commander": "~2.15.0", + "source-map": "~0.6.1" + }, + "dependencies": { + "commander": { + "version": "2.15.1", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.15.1.tgz", + "integrity": "sha512-VlfT9F3V0v+jr4yxPc5gg9s62/fIVWsd2Bk2iD435um1NlGMYdVCq+MjcXnhYq2icNOizHr1kK+5TI6H0Hy0ag==", + "dev": true + } + } + }, + "uglify-to-browserify": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/uglify-to-browserify/-/uglify-to-browserify-1.0.2.tgz", + "integrity": "sha1-bgkk1r2mta/jSeOabWMoUKD4grc=", + "dev": true, + "optional": true + }, + "underscore.string": { + "version": "3.3.4", + "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-3.3.4.tgz", + "integrity": "sha1-LCo/n4PmR2L9xF5s6sZRQoZCE9s=", + "dev": true, + "requires": { + "sprintf-js": "^1.0.3", + "util-deprecate": "^1.0.2" + } + }, + "unherit": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/unherit/-/unherit-1.1.1.tgz", + "integrity": "sha512-+XZuV691Cn4zHsK0vkKYwBEwB74T3IZIcxrgn2E4rKwTfFyI1zCh7X7grwh9Re08fdPlarIdyWgI8aVB3F5A5g==", + "dev": true, + "requires": { + "inherits": "^2.0.1", + "xtend": "^4.0.1" + } + }, + "unified": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/unified/-/unified-6.2.0.tgz", + "integrity": "sha512-1k+KPhlVtqmG99RaTbAv/usu85fcSRu3wY8X+vnsEhIxNP5VbVIDiXnLqyKIG+UMdyTg0ZX9EI6k2AfjJkHPtA==", + "dev": true, + "requires": { + "bail": "^1.0.0", + "extend": "^3.0.0", + "is-plain-obj": "^1.1.0", + "trough": "^1.0.0", + "vfile": "^2.0.0", + "x-is-string": "^0.1.0" + } + }, + "union-value": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/union-value/-/union-value-1.0.0.tgz", + "integrity": "sha1-XHHDTLW61dzr4+oM0IIHulqhrqQ=", + "dev": true, + "requires": { + "arr-union": "^3.1.0", + "get-value": "^2.0.6", + "is-extendable": "^0.1.1", + "set-value": "^0.4.3" + }, + "dependencies": { + "extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=", + "dev": true, + "requires": { + "is-extendable": "^0.1.0" + } + }, + "set-value": { + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/set-value/-/set-value-0.4.3.tgz", + "integrity": "sha1-fbCPnT0i3H945Trzw79GZuzfzPE=", + "dev": true, + "requires": { + "extend-shallow": "^2.0.1", + "is-extendable": "^0.1.1", + "is-plain-object": "^2.0.1", + "to-object-path": "^0.3.0" + } + } + } + }, + "uniq": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/uniq/-/uniq-1.0.1.tgz", + "integrity": "sha1-sxxa6CVIRKOoKBVBzisEuGWnNP8=", + "dev": true + }, + "unist-util-find-all-after": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/unist-util-find-all-after/-/unist-util-find-all-after-1.0.2.tgz", + "integrity": "sha512-nDl79mKpffXojLpCimVXnxhlH/jjaTnDuScznU9J4jjsaUtBdDbxmlc109XtcqxY4SDO0SwzngsxxW8DIISt1w==", + "dev": true, + "requires": { + "unist-util-is": "^2.0.0" + } + }, + "unist-util-is": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-2.1.2.tgz", + "integrity": "sha512-YkXBK/H9raAmG7KXck+UUpnKiNmUdB+aBGrknfQ4EreE1banuzrKABx3jP6Z5Z3fMSPMQQmeXBlKpCbMwBkxVw==", + "dev": true + }, + "unist-util-modify-children": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/unist-util-modify-children/-/unist-util-modify-children-1.1.2.tgz", + "integrity": "sha512-GRi04yhng1WqBf5RBzPkOtWAadcZS2gvuOgNn/cyJBYNxtTuyYqTKN0eg4rC1YJwGnzrqfRB3dSKm8cNCjNirg==", + "dev": true, + "requires": { + "array-iterate": "^1.0.0" + } + }, + "unist-util-remove-position": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/unist-util-remove-position/-/unist-util-remove-position-1.1.2.tgz", + "integrity": "sha512-XxoNOBvq1WXRKXxgnSYbtCF76TJrRoe5++pD4cCBsssSiWSnPEktyFrFLE8LTk3JW5mt9hB0Sk5zn4x/JeWY7Q==", + "dev": true, + "requires": { + "unist-util-visit": "^1.1.0" + } + }, + "unist-util-stringify-position": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-1.1.2.tgz", + "integrity": "sha512-pNCVrk64LZv1kElr0N1wPiHEUoXNVFERp+mlTg/s9R5Lwg87f9bM/3sQB99w+N9D/qnM9ar3+AKDBwo/gm/iQQ==", + "dev": true + }, + "unist-util-visit": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-1.3.1.tgz", + "integrity": "sha512-0fdB9EQJU0tho5tK0VzOJzAQpPv2LyLZ030b10GxuzAWEfvd54mpY7BMjQ1L69k2YNvL+SvxRzH0yUIehOO8aA==", + "dev": true, + "requires": { + "unist-util-is": "^2.1.1" + } + }, + "universalify": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.1.tgz", + "integrity": "sha1-+nG63UQ3r0wUiEHjs7Fl+enlkLc=", + "dev": true + }, + "unset-value": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unset-value/-/unset-value-1.0.0.tgz", + "integrity": "sha1-g3aHP30jNRef+x5vw6jtDfyKtVk=", + "dev": true, + "requires": { + "has-value": "^0.3.1", + "isobject": "^3.0.0" + }, + "dependencies": { + "has-value": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/has-value/-/has-value-0.3.1.tgz", + "integrity": "sha1-ex9YutpiyoJ+wKIHgCVlSEWZXh8=", + "dev": true, + "requires": { + "get-value": "^2.0.3", + "has-values": "^0.1.4", + "isobject": "^2.0.0" + }, + "dependencies": { + "isobject": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-2.1.0.tgz", + "integrity": "sha1-8GVWEJaj8dou9GJy+BXIQNh+DIk=", + "dev": true, + "requires": { + "isarray": "1.0.0" + } + } + } + }, + "has-values": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/has-values/-/has-values-0.1.4.tgz", + "integrity": "sha1-bWHeldkd/Km5oCCJrThL/49it3E=", + "dev": true + }, + "isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=", + "dev": true + } + } + }, + "uri-js": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.2.2.tgz", + "integrity": "sha512-KY9Frmirql91X2Qgjry0Wd4Y+YTdrdZheS8TFwvkbLWf/G5KNJDCh6pKL5OZctEW4+0Baa5idK2ZQuELRwPznQ==", + "dev": true, + "requires": { + "punycode": "^2.1.0" + }, + "dependencies": { + "punycode": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.1.1.tgz", + "integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==", + "dev": true + } + } + }, + "uri-path": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/uri-path/-/uri-path-1.0.0.tgz", + "integrity": "sha1-l0fwGDWJM8Md4PzP2C0TjmcmLjI=", + "dev": true + }, + "urix": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/urix/-/urix-0.1.0.tgz", + "integrity": "sha1-2pN/emLiH+wf0Y1Js1wpNQZ6bHI=", + "dev": true + }, + "url-join": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/url-join/-/url-join-4.0.0.tgz", + "integrity": "sha1-TTNA6AfTdzvamZH4MFrNzCpmXSo=", + "dev": true + }, + "use": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/use/-/use-3.1.0.tgz", + "integrity": "sha512-6UJEQM/L+mzC3ZJNM56Q4DFGLX/evKGRg15UJHGB9X5j5Z3AFbgZvjUh2yq/UJUY4U5dh7Fal++XbNg1uzpRAw==", + "dev": true, + "requires": { + "kind-of": "^6.0.2" + }, + "dependencies": { + "kind-of": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz", + "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==", + "dev": true + } + } + }, + "user-home": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/user-home/-/user-home-1.1.1.tgz", + "integrity": "sha1-K1viOjK2Onyd640PKNSFcko98ZA=", + "dev": true + }, + "util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8=", + "dev": true + }, + "uuid": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-3.1.0.tgz", + "integrity": "sha1-PdPT55Crwk17DToDT/q6vijrvAQ=", + "dev": true + }, + "v8flags": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/v8flags/-/v8flags-2.1.1.tgz", + "integrity": "sha1-qrGh+jDUX4jdMhFIh1rALAtV5bQ=", + "dev": true, + "requires": { + "user-home": "^1.1.1" + } + }, + "validate-npm-package-license": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.1.tgz", + "integrity": "sha1-KAS6vnEq0zeUWaz74kdGqywwP7w=", + "dev": true, + "requires": { + "spdx-correct": "~1.0.0", + "spdx-expression-parse": "~1.0.0" + } + }, + "verror": { + "version": "1.10.0", + "resolved": "https://registry.npmjs.org/verror/-/verror-1.10.0.tgz", + "integrity": "sha1-OhBcoXBTr1XW4nDB+CiGguGNpAA=", + "dev": true, + "requires": { + "assert-plus": "^1.0.0", + "core-util-is": "1.0.2", + "extsprintf": "^1.2.0" + } + }, + "vfile": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/vfile/-/vfile-2.3.0.tgz", + "integrity": "sha512-ASt4mBUHcTpMKD/l5Q+WJXNtshlWxOogYyGYYrg4lt/vuRjC1EFQtlAofL5VmtVNIZJzWYFJjzGWZ0Gw8pzW1w==", + "dev": true, + "requires": { + "is-buffer": "^1.1.4", + "replace-ext": "1.0.0", + "unist-util-stringify-position": "^1.0.0", + "vfile-message": "^1.0.0" + } + }, + "vfile-location": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/vfile-location/-/vfile-location-2.0.3.tgz", + "integrity": "sha512-zM5/l4lfw1CBoPx3Jimxoc5RNDAHHpk6AM6LM0pTIkm5SUSsx8ZekZ0PVdf0WEZ7kjlhSt7ZlqbRL6Cd6dBs6A==", + "dev": true + }, + "vfile-message": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-1.0.1.tgz", + "integrity": "sha512-vSGCkhNvJzO6VcWC6AlJW4NtYOVtS+RgCaqFIYUjoGIlHnFL+i0LbtYvonDWOMcB97uTPT4PRsyYY7REWC9vug==", + "dev": true, + "requires": { + "unist-util-stringify-position": "^1.1.1" + } + }, + "wc-e2e-page-objects": { + "version": "0.10.0", + "resolved": "https://registry.npmjs.org/wc-e2e-page-objects/-/wc-e2e-page-objects-0.10.0.tgz", + "integrity": "sha1-opnsEUmyVMO2PErx7sNGRww61kg=", + "dev": true, + "requires": { + "lodash": "^4.13.1", + "wp-e2e-page-objects": "0.8.1", + "wp-e2e-webdriver": "0.14.0" + } + }, + "websocket-driver": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.7.0.tgz", + "integrity": "sha1-DK+dLXVdk67gSdS90NP+LMoqJOs=", + "dev": true, + "requires": { + "http-parser-js": ">=0.4.0", + "websocket-extensions": ">=0.1.1" + } + }, + "websocket-extensions": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/websocket-extensions/-/websocket-extensions-0.1.3.tgz", + "integrity": "sha1-XS/yKXcAPsaHpLhwc9+7rBRszyk=", + "dev": true + }, + "which": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/which/-/which-1.3.0.tgz", + "integrity": "sha1-/wS9/AEO5UfXgL7DjhrBwnd9JTo=", + "dev": true, + "requires": { + "isexe": "^2.0.0" + } + }, + "which-module": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/which-module/-/which-module-1.0.0.tgz", + "integrity": "sha1-u6Y8qGGUiZT/MHc2CJ47lgJsKk8=", + "dev": true + }, + "wide-align": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/wide-align/-/wide-align-1.1.3.tgz", + "integrity": "sha512-QGkOQc8XL6Bt5PwnsExKBPuMKBxnGxWWW3fU55Xt4feHozMUhdUMaBCk290qpm/wG5u/RSKzwdAC4i51YigihA==", + "dev": true, + "requires": { + "string-width": "^1.0.2 || 2" + } + }, + "window-size": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/window-size/-/window-size-0.1.0.tgz", + "integrity": "sha1-VDjNLqk7IC76Ohn+iIeu58lPnJ0=", + "dev": true, + "optional": true + }, + "wordwrap": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", + "integrity": "sha1-J1hIEIkUVqQXHI0CJkQa3pDLyus=", + "dev": true + }, + "wp-e2e-page-objects": { + "version": "0.8.1", + "resolved": "https://registry.npmjs.org/wp-e2e-page-objects/-/wp-e2e-page-objects-0.8.1.tgz", + "integrity": "sha1-m1+Nx1p9pU7q4YDUxp0FBIIksg0=", + "dev": true, + "requires": { + "deprecate": "^1.0.0", + "lodash": "^4.13.1", + "selenium-webdriver": "^3.6.0", + "sprintf-js": "^1.0.3", + "wp-e2e-webdriver": "^0.14.0" + } + }, + "wp-e2e-webdriver": { + "version": "0.14.0", + "resolved": "https://registry.npmjs.org/wp-e2e-webdriver/-/wp-e2e-webdriver-0.14.0.tgz", + "integrity": "sha1-fHJnxDUv4barX10yu2rt+SaMdP8=", + "dev": true, + "requires": { + "chromedriver": "^2.37.0", + "fs-extra": "^5.0.0", + "saucelabs": "^1.4.0", + "selenium-webdriver": "3.6.0", + "slugs": "^0.1.3", + "temp": "^0.8.3", + "url-join": "^4.0.0" + } + }, + "wrap-ansi": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-2.1.0.tgz", + "integrity": "sha1-2Pw9KE3QV5T+hJc8rs3Rz4JP3YU=", + "dev": true, + "requires": { + "string-width": "^1.0.1", + "strip-ansi": "^3.0.1" + } + }, + "wrappy": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", + "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=", + "dev": true + }, + "write": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/write/-/write-0.2.1.tgz", + "integrity": "sha1-X8A4KOJkzqP+kUVUdvejxWbLB1c=", + "dev": true, + "requires": { + "mkdirp": "^0.5.1" + } + }, + "x-is-string": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/x-is-string/-/x-is-string-0.1.0.tgz", + "integrity": "sha1-R0tQhlrzpJqcRlfwWs0UVFj3fYI=", + "dev": true + }, + "xml2js": { + "version": "0.4.19", + "resolved": "https://registry.npmjs.org/xml2js/-/xml2js-0.4.19.tgz", + "integrity": "sha1-aGwg8hMgnpSr8NG88e+qKRx4J6c=", + "dev": true, + "requires": { + "sax": ">=0.6.0", + "xmlbuilder": "~9.0.1" + } + }, + "xmlbuilder": { + "version": "9.0.7", + "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-9.0.7.tgz", + "integrity": "sha1-Ey7mPS7FVlxVfiD0wi35rKaGsQ0=", + "dev": true + }, + "xtend": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.1.tgz", + "integrity": "sha1-pcbVMr5lbiPbgg77lDofBJmNY68=", + "dev": true + }, + "y18n": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-3.2.1.tgz", + "integrity": "sha1-bRX7qITAhnnA136I53WegR4H+kE=", + "dev": true + }, + "yallist": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-2.1.2.tgz", + "integrity": "sha1-HBH5IY8HYImkfdUS+TxmmaaoHVI=", + "dev": true + }, + "yargs": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-7.1.0.tgz", + "integrity": "sha1-a6MY6xaWFyf10oT46gA+jWFU0Mg=", + "dev": true, + "requires": { + "camelcase": "^3.0.0", + "cliui": "^3.2.0", + "decamelize": "^1.1.1", + "get-caller-file": "^1.0.1", + "os-locale": "^1.4.0", + "read-pkg-up": "^1.0.1", + "require-directory": "^2.1.1", + "require-main-filename": "^1.0.1", + "set-blocking": "^2.0.0", + "string-width": "^1.0.2", + "which-module": "^1.0.0", + "y18n": "^3.2.1", + "yargs-parser": "^5.0.0" + }, + "dependencies": { + "camelcase": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-3.0.0.tgz", + "integrity": "sha1-MvxLn82vhF/N9+c7uXysImHwqwo=", + "dev": true + } + } + }, + "yargs-parser": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-5.0.0.tgz", + "integrity": "sha1-J17PDX/+Bcd+ZOfIbkzZS/DhIoo=", + "dev": true, + "requires": { + "camelcase": "^3.0.0" + }, + "dependencies": { + "camelcase": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-3.0.0.tgz", + "integrity": "sha1-MvxLn82vhF/N9+c7uXysImHwqwo=", + "dev": true + } + } + }, + "yauzl": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/yauzl/-/yauzl-2.4.1.tgz", + "integrity": "sha1-lSj0QtqxsihOWLQ3m7GU4i4MQAU=", + "dev": true, + "requires": { + "fd-slicer": "~1.0.1" + } + } + } +} diff --git a/package.json b/package.json index 2829576de86..a8bae722568 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "woocommerce", "title": "WooCommerce", - "version": "3.1.0", + "version": "3.4.0", "homepage": "https://woocommerce.com/", "repository": { "type": "git", @@ -10,43 +10,51 @@ "license": "GPL-3.0+", "main": "Gruntfile.js", "scripts": { - "test": "cross-env NODE_CONFIG_DIR='./tests/e2e-tests/config' BABEL_ENV=commonjs mocha \"tests/e2e-tests\" --compilers js:babel-register --recursive", - "test:single": "cross-env NODE_CONFIG_DIR='./tests/e2e-tests/config' BABEL_ENV=commonjs mocha --compilers js:babel-register" + "build": "grunt", + "build-watch": "grunt watch", + "test": "cross-env NODE_CONFIG_DIR='./tests/e2e-tests/config' BABEL_ENV=commonjs mocha \"tests/e2e-tests\" --require babel-register --recursive", + "test:grep": "cross-env NODE_CONFIG_DIR='./tests/e2e-tests/config' BABEL_ENV=commonjs mocha \"tests/e2e-tests\" --require babel-register --grep ", + "test:single": "cross-env NODE_CONFIG_DIR='./tests/e2e-tests/config' BABEL_ENV=commonjs mocha --require babel-register" }, "devDependencies": { - "autoprefixer": "^6.7.7", + "autoprefixer": "~8.6.2", "babel": "^6.5.2", "babel-cli": "^6.14.0", - "babel-eslint": "^7.0.0", + "babel-eslint": "^8.2.3", "babel-plugin-add-module-exports": "^0.2.1", "babel-preset-es2015": "^6.14.0", "babel-preset-stage-2": "^6.13.0", - "chai": "^3.5.0", - "chai-as-promised": "^6.0.0", - "chromedriver": "^2.25.0", + "chai": "^4.1.2", + "chai-as-promised": "^7.1.1", + "chromedriver": "^2.40.0", "config": "^1.24.0", - "cross-env": "^3.0.0", - "grunt": "~1.0.1", - "grunt-checktextdomain": "~1.0.0", - "grunt-contrib-clean": "~1.0.0", - "grunt-contrib-concat": "1.0.1", - "grunt-contrib-cssmin": "~2.2.0", + "cross-env": "^5.1.6", + "grunt": "^1.0.3", + "grunt-checktextdomain": "~1.0.1", + "grunt-contrib-clean": "~1.1.0", + "grunt-contrib-concat": "~1.0.1", + "grunt-contrib-cssmin": "~2.2.1", "grunt-contrib-jshint": "~1.1.0", - "grunt-contrib-uglify": "~3.0.0", - "grunt-contrib-watch": "~1.0.0", + "grunt-contrib-uglify": "~3.3.0", + "grunt-contrib-watch": "^1.1.0", "grunt-phpcs": "~0.4.0", - "grunt-postcss": "~0.8.0", + "grunt-postcss": "~0.9.0", + "grunt-prompt": "^1.3.3", "grunt-rtlcss": "~2.0.1", + "grunt-sass": "~2.1.0", "grunt-shell": "~2.1.0", - "grunt-sass": "~2.0.0", - "grunt-stylelint": "~0.8.0", - "grunt-wp-i18n": "~1.0.0", + "grunt-stylelint": "~0.10.0", + "grunt-wp-i18n": "~1.0.1", "istanbul": "^1.0.0-alpha", - "mocha": "^3.0.2", - "wc-e2e-page-objects": "0.3.0" + "mocha": "^5.2.0", + "stylelint": "~9.2.1", + "wc-e2e-page-objects": "0.10.0" }, "engines": { - "node": ">=6.9.4", - "npm": ">=1.1.0" + "node": ">=8.9.3", + "npm": ">=5.5.1" + }, + "dependencies": { + "github-contributors-list": "https://github.com/woocommerce/github-contributors-list/tarball/master" } } diff --git a/phpcs.ruleset.xml b/phpcs.ruleset.xml deleted file mode 100644 index 1cb68a2b0b0..00000000000 --- a/phpcs.ruleset.xml +++ /dev/null @@ -1,194 +0,0 @@ - - - - - - - A custom set of code standard rules to check for WordPress themes and plugins. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/phpcs.xml b/phpcs.xml new file mode 100644 index 00000000000..66454fde0d5 --- /dev/null +++ b/phpcs.xml @@ -0,0 +1,93 @@ + + + + + + WooCommerce dev PHP_CodeSniffer ruleset. + + + tests/cli/ + apigen/ + includes/gateways/simplify-commerce + includes/libraries/ + includes/legacy/ + includes/api/legacy/ + includes/api/v1/ + includes/class-wc-geo-ip.php + includes/wc-deprecated-functions.php + */node_modules/* + */vendor/* + + + + + + + + + + + + tests/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + includes/**/abstract-*.php + tests/* + + + tests/ + + + tests/ + + + + + tests/e2e-tests/ + + + i18n/ + + + + + includes/cli/ + + + includes/cli/ + + + includes/cli/ + + + i18n/ + + diff --git a/phpunit.xml b/phpunit.xml index 0a829bc9242..7412941c4e4 100644 --- a/phpunit.xml +++ b/phpunit.xml @@ -16,28 +16,35 @@ - . + ./includes + woocommerce.php + uninstall.php - ./apigen/ - ./i18n/ - ./includes/api/legacy/ - ./includes/gateways/simplify-commerce-deprecated/ - ./includes/gateways/simplify-commerce/includes/ - ./includes/libraries/ - ./includes/shipping/legacy-flat-rate/ - ./includes/shipping/legacy-free-shipping/ - ./includes/shipping/legacy-international-delivery/ - ./includes/shipping/legacy-local-delivery/ - ./includes/shipping/legacy-local-pickup/ - ./includes/updates/ - ./includes/widgets/ - ./templates/ - ./tests/ - ./tmp/ + ./includes/admin/helper/views + ./includes/admin/importers/views + ./includes/admin/meta-boxes/views + ./includes/admin/plugin-updates/views + ./includes/admin/views + ./includes/api/legacy + ./includes/api/v1 + ./includes/gateways/simplify-commerce/includes + ./includes/legacy + ./includes/libraries + ./includes/shipping/legacy-flat-rate + ./includes/shipping/legacy-free-shipping + ./includes/shipping/legacy-international-delivery + ./includes/shipping/legacy-local-delivery + ./includes/shipping/legacy-local-pickup + ./includes/updates + ./includes/vendor + ./includes/widgets + ./includes/wc-deprecated-functions.php + ./includes/wc-template-hooks.php + ./includes/wc-widget-functions.php - - - + + + diff --git a/phpunit.xml.dist b/phpunit.xml.dist deleted file mode 100644 index 0ae53994749..00000000000 --- a/phpunit.xml.dist +++ /dev/null @@ -1,40 +0,0 @@ - - - - - ./tests/unit-tests - - - - - . - - ./apigen/ - ./i18n/ - ./includes/api/legacy/ - ./includes/gateways/simplify-commerce-deprecated/ - ./includes/gateways/simplify-commerce/includes/ - ./includes/libraries/ - ./includes/shipping/legacy-flat-rate/ - ./includes/shipping/legacy-free-shipping/ - ./includes/shipping/legacy-international-delivery/ - ./includes/shipping/legacy-local-delivery/ - ./includes/shipping/legacy-local-pickup/ - ./includes/updates/ - ./includes/widgets/ - ./templates/ - ./tests/ - ./tmp/ - - - - diff --git a/readme.txt b/readme.txt index b5078d8cabd..60b869da06c 100644 --- a/readme.txt +++ b/readme.txt @@ -1,9 +1,9 @@ === WooCommerce === -Contributors: automattic, mikejolley, jameskoster, claudiosanches, jshreve, coderkevin, claudiulodro, woothemes, iCaleb +Contributors: automattic, mikejolley, jameskoster, claudiosanches, claudiulodro, kloon, rodrigosprimo, jshreve, coderkevin Tags: ecommerce, e-commerce, store, sales, sell, shop, cart, checkout, downloadable, downloads, paypal, storefront, woo commerce -Requires at least: 4.4 -Tested up to: 4.8 -Stable tag: 3.0.8 +Requires at least: 4.7 +Tested up to: 4.9 +Stable tag: 3.4.5 License: GPLv3 License URI: https://www.gnu.org/licenses/gpl-3.0.html @@ -13,7 +13,7 @@ WooCommerce is a powerful, extendable eCommerce plugin that helps you sell anyth WooCommerce is a free eCommerce plugin that allows you to sell anything, beautifully. Built to integrate seamlessly with WordPress, WooCommerce is the world’s favorite eCommerce solution that gives both store owners and developers complete control. -With endless flexibility and access to hundreds of free and premium WordPress extensions, WooCommerce now powers 30% of all online stores -- more than any other platform. +With endless flexibility and access to hundreds of free and premium WordPress extensions, WooCommerce now powers 30% of all online stores — more than any other platform. [youtube https://www.youtube.com/watch?v=1KahlicghaE] @@ -28,24 +28,24 @@ Offer free shipping, flat rate shipping, or make real-time calculations. Limit y = Extensive payment options = WooCommerce comes bundled with the ability to accept major credit cards, PayPal, BACS (bank transfers), and cash on delivery. Need additional options? More than 140 region-specific gateways integrate with WooCommerce, including popular choices like Stripe, Authorize.Net, and Amazon Payments. -= You control it all -- forever = += You control it all — forever = WooCommerce gives you complete control of your store, from taxes to stock levels to customer accounts. Add and remove extensions, change your design, and switch settings as you please. It’s all under your control. -One of the biggest risks of using a hosted eCommerce platform is what happens to your store if the provider closes up shop. With WooCommerce, you have complete control, so there’s never any reason to worry. Your data belongs to you -- and it’s kept secure, thanks to regular audits by industry leaders. +One of the biggest risks of using a hosted eCommerce platform is what happens to your store if the provider closes up shop. With WooCommerce, you have complete control, so there’s never any reason to worry. Your data belongs to you — and it’s kept secure, thanks to regular audits by industry leaders. = Define your style with Storefront = -[Storefront](https://wordpress.org/themes/storefront/) is a free WordPress theme available to any WooCommerce store. Along with deep WooCommerce integration, Storefront prioritizes speed and uptime while eliminating theme and plugin conflicts during major updates. +[Storefront](https://woocommerce.com/storefront/) is a free WordPress theme available to any WooCommerce store. Along with deep WooCommerce integration, Storefront prioritizes speed and uptime while eliminating theme and plugin conflicts during major updates. Define your style even further by customizing Storefront to your liking or choosing from one of our several [Storefront child themes](https://woocommerce.com/product-category/themes/storefront-child-theme-themes/). It’s all up to you, and all open source. = Built with developers in mind = -Extendable, adaptable, and open source -- WooCommerce was created with developers in mind. With its strong, robust framework, you can scale your client’s store all the way from basic to high-end (infinity and beyond). +Extendable, adaptable, and open source — WooCommerce was created with developers in mind. With its strong, robust framework, you can scale your client’s store all the way from basic to high-end (infinity and beyond). Built with a REST API, WooCommerce can integrate with virtually any service. Your store’s data can be accessed anywhere, anytime, 100% securely. WooCommerce allows developers to easily create, modify, and grow a store that meets their specifications. -No matter the size of the store you want to build, WooCommerce will scale to meet your requirements. With a growing collection of more than 300 extensions, you can enhance each store’s features to meet your client’s unique needs -- or even create your own solution. +No matter the size of the store you want to build, WooCommerce will scale to meet your requirements. With a growing collection of more than 300 extensions, you can enhance each store’s features to meet your client’s unique needs — or even create your own solution. If security is a concern, rest easy. WooCommerce is audited by a dedicated team of developers working around the clock to identify and patch any and all discovered bugs. @@ -76,7 +76,7 @@ And there’s plenty more where they came from. Visit our [extensions page](http = Join our growing community = -When you download WooCommerce, you join a community of more than a million store owners, developers, and WordPress enthusiasts. We’re one of the fastest-growing open source communities online, and whether you’re a n00b or a Ninja, we’d love to have you! +When you download WooCommerce, you join a community of more than a million store owners, developers, and WordPress enthusiasts. We're one of the fastest-growing open source communities online, and no matter your skill level we'd love to have you! If you’re interested in contributing to WooCommerce we’ve got more than 350 contributors, and there’s always room for more. Head over to the [WooCommerce GitHub Repository](https://github.com/woocommerce/woocommerce) to find out how you can pitch in. @@ -88,11 +88,8 @@ And, finally, consider joining or spearheading a WooCommerce Meetup locally, mor = Minimum Requirements = -* PHP version 5.2.4 or greater (PHP 5.6 or greater is recommended) +* PHP version 5.2.4 or greater (PHP 7.2 or greater is recommended) * MySQL version 5.0 or greater (MySQL 5.6 or greater is recommended) -* Some payment gateways require fsockopen support (for IPN access) -* WooCommerce 2.5 requires WordPress 4.1+ -* WooCommerce 2.6 requires WordPress 4.4+ Visit the [WooCommerce server requirements documentation](https://docs.woocommerce.com/document/server-requirements/) for a detailed list of server requirements. @@ -112,9 +109,9 @@ Automatic updates should work like a charm; as always though, ensure you backup If on the off-chance you do encounter issues with the shop/category pages after an update you simply need to flush the permalinks by going to WordPress > Settings > Permalinks and hitting 'save'. That should return things to normal. -= Dummy data = += Sample data = -WooCommerce comes with some dummy data you can use to see how products look; either import dummy_data.xml via the [WordPress importer](https://wordpress.org/plugins/wordpress-importer/) or use our [CSV Import Suite plugin](https://woocommerce.com/products/product-csv-import-suite/) to import dummy_data.csv and dummy_data_variations.csv. +WooCommerce comes with some sample data you can use to see how products look; import sample_products.xml via the [WordPress importer](https://wordpress.org/plugins/wordpress-importer/). You can also use the core [CSV importer](https://docs.woocommerce.com/document/product-csv-importer-exporter/) or our [CSV Import Suite plugin](https://woocommerce.com/products/product-csv-import-suite/) to import sample_products.csv. == Frequently Asked Questions == @@ -128,7 +125,7 @@ For extending or theming WooCommerce, see our [codex](https://docs.woocommerce.c If you get stuck, you can ask for help in the [WooCommerce Plugin Forum](https://wordpress.org/support/plugin/woocommerce). -For help with premium extensions from WooThemes, use [our helpdesk](https://support.woothemes.com/). +For help with premium extensions from WooCommerce.com, use [our helpdesk](https://woocommerce.com/my-account/tickets/). = Will WooCommerce work with my theme? = @@ -136,7 +133,7 @@ Yes; WooCommerce will work with any theme, but may require some styling to make = Where can I request new features, eCommerce themes and extensions? = -You can vote on and request new features and extensions in our [WooIdeas board](http://ideas.woothemes.com/forums/133476-woocommerce) +You can vote on and request new features and extensions in our [WooIdeas board](http://ideas.woocommerce.com/forums/133476-woocommerce) = Where can I report bugs or contribute to the project? = @@ -148,11 +145,11 @@ You can find the documentation of our REST API on the [WooCommerce REST API Docs = WooCommerce is awesome! Can I contribute? = -Yes you can! Join in on our [GitHub repository](http://github.com/woocommerce/woocommerce/) :) +Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/woocommerce/) :) == Screenshots == -1. The slick WooCommerce settings panel. +1. The WooCommerce settings panel. 2. WooCommerce products admin. 3. Product data panel. 4. WooCommerce sales reports. @@ -161,7 +158,129 @@ Yes you can! Join in on our [GitHub repository](http://github.com/woocommerce/wo == Changelog == -= 3.2.0 - 2017-XX-XX = += 3.5.0 - 2018-10-17 = +* Feature - REST API v3. #20111 +* Feature - Option has been added on the inventory tab of the edit product page to set a low stock threshold for individual products. #20260 +* Feature - Add ability to export products by category to the CSV exporter. #20870 +* Feature - Ability to define custom product placeholder images that will resize to correct store aspect ratio. #20644 +* Enhancement - Excluded children categories from WP_Query in product shortcode if cat_operator=AND. #20207 +* Enhancement - Add anchor tag example to email template preview. #20246 +* Enhancement - Introduce is_paypal_supported_currency check in setup wizard. #20244 +* Enhancement - Payment method table reordering accessibility. #19844 +* Enhancement - Log errors from transaction emails with logger. #20203 +* Enhancement - Improved shipping calculator experience. Shows destination country and added context to calculate shipping link. #20345 +* Enhancement - On the fly image generation for frontend, if image sizes are missing. #20011 +* Enhancement - SelectWoo enabled product categories dropdown widget. #20617 +* Enhancement - Make it easier to read and act upon the outdated template notice. #20732 +* Enhancement - Styled date, time, etc. inputs in admin to match styling of other inputs. #21013 +* Enhancement - Show update notices on the System Status page for WordPress.org hosted Official WooCommerce extensions. #21073 +* Enhancement - Better wording for transactional emails. #21288 +* Fix - Check billing email is posted before using in WC_Cart::check_customer_coupons. #20180 +* Fix - Shipping postcode formatting when only posting a billing address. #20330 +* Fix - Correctly show/hide save card checkbox on tokenization form. #20506 +* Fix - orderby and order parameters in WC_Customer_Download_Log_Data_Store::get_download_logs() were ignored. #20931 +* Fix - Unslash city name to prevent double escape in tax settings. #21205 +* Fix - Updated phone validation logic. #21188 +* Fix - Fix weight and dimensions cache of variable products if childs doesn't have any of those params. #21244 +* Fix - Correctly replace images in the woocommerce_uploads folder with the placeholder image. #20848 +* Fix - Show parent variable product in shipping class admin screen when variation has shipping class. #21278 +* Fix - Correctly excluded administrators from "Customer list" report. #21304 +* Fix - Update quick edit logic to show/hide Stock qty and Backorders fields. #21301 +* Fix - Fix Layered Nav Widget where special HTML entities did not display correctly in the "Any %s" string. #21312 +* Fix - Set the is_checkout javascript parameter on any page that uses the checkout filter or shortcode. #21328 +* Fix - Fix cron_interval property support in WP_Background_Process. #21353 +* Fix - CSS Changes to make text fields line up on the shipping settings page. #21247 +* Fix - Add extra null check to fix an issue with select payment fields using disabed select as placeholders. #21391 +* Fix - Don't modify attributes orderby when sorting by name. #21408 +* Fix - Allow saving a stock quantity of 0 using quick edit. #21447 +* Fix - Change the query used to save session data to the database to protect against deadlocks. #21455 +* Fix - Make sure default category tooltip is rendered when the image column is deactivated. #21410 +* Fix - Fix warning when using logger instance in woocommerce_logging_class filter. #21448 +* Fix - Use uppercase "ID" when sorting product queries by ID. #21461 +* Fix - Consistently escape the gateway ID in the checkout payment method template. #21439 +* Fix - Avoid treating HTTP 301 and 302 codes as failures for webhooks. #21491 +* Fix - Add address_1 to shipping packages info in WC_Cart:: get_shipping_packages to make it work correctly in address formatting functions. #21493 +* Fix - Don't fire two of the same action when saving shipping settings. #21494 +* Fix - Remove double condition for address line 2 in `WC_Countries::get_default_address_fields`. #20629 +* Fix - Correctly handle shorthand values for memory_limit in php.ini. #21557 +* Fix - Product shortcode numeric term slug matching. #21560 +* Fix - Remove the erasure tools links from the descriptions of the erasure settings for users without the manage_privacy_options capability. #21565 +* Fix - Don't double urldecode posted variation attributes. #21570 +* Fix - Don't double-sanitize cart images. #21574 +* Fix - Check if ID exists and is not empty before set Product's download ID in API. #21588 +* Fix - Ensure wp_list_pluck() gets a array and not possibly null in WC_Product_Data_Store_CPT::update_attributes. #21591 +* Fix - Trim CSV header rows to prevent leading/trailing whitespace issues. #21614 +* Fix - Show draft products in previews on unsupported themes. #21619 +* Fix/Tweak - Fire `woocommerce_grant_product_download_access` hook after the download has its ID set. #20905 +* Fix/Tweak/Performance - Change wp_woocommerce_sessions primary key to session_id. #21245 +* Tweak - Show empty terms in admin product category filter dropdown. #20324 +* Tweak - Don't force default token gateway active by default. #20125 +* Tweak - Move notice output to hooked in functions. #19794 +* Tweak - Apply order bulk actions in chronological order. #20338 +* Tweak - Updated Emogrifier to 2.0. #20547 +* Tweak - Avoid using wp.template (eval) in add-to-cart-variation.js. #19496 +* Tweak - Hide Preview button when creating new products, as most fields aren't set up for it. #20650 +* Tweak - For guests, store all address fields to the session whilst placing an order. #20665 +* Tweak - Removed 'ajax_add_to_cart' class from 'Read more' button. #20690 +* Tweak - Removed unnecessary checkout form change trigger on load of the checkout page. #20655 +* Tweak - Add image size filters to wc_get_product_attachment_props(). #20722 +* Tweak - Only display the current site's tables for a multisite install when viewing the system status. #20731 +* Tweak - include the file path and line number where a fatal error occurred in the fatal errors log. #20787 +* Tweak - Cast tax rate to float so that it can be treated as number further on in the code. #20910 +* Tweak - Send webhooks using Action Scheduler. #20030 +* Tweak - Update customer's ip address on successful payment. #21038 +* Tweak - Changed wc_clean to checking for valid utf8 for line items and password. #20993 +* Tweak - Add to cart notice actions (View cart/Continue shopping) now have tabindex 1 for improved accessibility. #21108 +* Tweak - Remove icanhazip from geolocation services. #21198 +* Tweak - Remove unnecessary aria-required attributes from product reviews template. #21211 +* Tweak - Added hidden label for screen readers on checkout address line 2 input. #21193 +* Tweak - Remove empty space in mini-cart template. #21261 +* Tweak - Tax display in cart now depends on whether customer is tax exempt. #21292 +* Tweak - Change sort dropdown option "Sort by newness" to "Sort by latest". #21311 +* Tweak - Sanitize endpoint slugs upon saving. #21355 +* Tweak - Ignore converting float meta value for registered post meta. #21333 +* Tweak - Remove 'order_again' query string to avoid multiple re-orders. #21444 +* Tweak - Remove Netherlands Antilles from the North America continent definitions. #21449 +* Tweak - Display label and meta on the same line in order emails to match frontend Order Details styling. #21456 +* Tweak - Use wp_get_upload_dir for geolite DB path. #21550 +* Performance/Tweak - Use post_author for the order customer instead of '_customer_user' meta data. #17895 +* Performance - Exclude frontend include from REST API calls. #20000 +* Performance - Improve performance of the query to delete version transients by removing unneeded "ORDER BY". #21274 +* Dev - REST API - Allows oAuth1.0a authentication under SSL. +* Dev - REST API - Fix position param for images. #20497 +* Dev - REST API - Handle children products deletion regardless of type. #20670 +* Dev - Added woocommerce_increase_coupon_usage_count and woocommerce_decrease_coupon_usage_count action hooks to increase extensibility of Coupons. #19981 +* Dev - Add endpoints to account menu items filter. #19980 +* Dev - Added qty param to `wc_add_to_cart_message` filter. #19817 +* Dev - Added `woocommerce_search_products_ids` filter. #20160 +* Dev - Introduced `woocommerce_cart_calculate_shipping_address` field to allow manipulation of cart shipping calculator data. #20046 +* Dev - Introduced `woocommerce_shipping_calculator_enable_country` filter. #20046 +* Dev - Pass product id to backorder notification. #20416 +* Dev - Added woocommerce_cart_shipping_total filter to control shipping display. #20591 +* Dev - Refactor "Order again" handling to separate logic better. #20606 +* Dev - Added 'woocommerce_products_admin_list_table_filters' filter to make it easier to customize the products list table filters. #20634 +* Dev - Added `woocommerce_shipping_method_add_rate_args` and `woocommerce_shipping_method_add_rate` filters. #20633 +* Dev - Added `woocommerce_coupon_validate_user_usage_limit` filter. #20630 +* Dev - Add hooks needed for product custom tables feature plugin. #20520 +* Dev - Added new filter to 'Item in quotes' translation for messages. #20714 +* Dev - Add 'woocommerce_shutdown_error' hook triggered on request termination with an error. #20787 +* Dev - New filter 'woocommerce_admin_meta_boxes_variations_count' to customize the shown count of variations. #21067 +* Dev - Added ability to query products that have a field set in wc_get_products/WC_Product_Query using the wildcard symbol '*'. #21162 +* Dev - Added a JavaScript events before and after the order total recalculation on the Edit Order page. #21181 +* Dev - Check for `needs_payment` instead of `has_status( 'pending' )` in PayPal PDT handler for custom order status support. #21200 +* Dev - Added form action hooks for edit account and login templates. #21248 +* Dev - Add action for when system tools are run. #21270 +* Dev - Add - woocommerce_restock_refunded_items filter to control default state of the restock option when refunding items on an order. #21314 +* Dev - Add an extensible/swappable job queue via WC_Action_Queue and WC_Queue_Interface. #20030 +* Dev - Use WC_Action_Queue for schedule and delivery of webhooks. #20030 +* Dev - Include Action Scheduler v2.1.0 and use it for the default job queue. #21424 / #20030 +* Dev - Save reviews under the 'review' comment type. #21305 +* Localization - Updated IT provinces. #20286 +* Localization - Eircode validation. #20330 +* Localization - Disable postcode requirement for Bahrain. #21103 +* Localization - Make postcode field optional and hidden for Nigeria and label State. #21056 +* Localization - Make Romania state selection mandatory. #21180 +* Localization - Make city field optional and hidden for Singapore addresses. #21016 [See changelog for all versions](https://raw.githubusercontent.com/woocommerce/woocommerce/master/CHANGELOG.txt). diff --git a/sample-data/sample_products.csv b/sample-data/sample_products.csv new file mode 100644 index 00000000000..dfb25e8889a --- /dev/null +++ b/sample-data/sample_products.csv @@ -0,0 +1,26 @@ +ID,Type,SKU,Name,Published,"Is featured?","Visibility in catalog","Short description",Description,"Date sale price starts","Date sale price ends","Tax status","Tax class","In stock?",Stock,"Backorders allowed?","Sold individually?","Weight (lbs)","Length (in)","Width (in)","Height (in)","Allow customer reviews?","Purchase note","Sale price","Regular price",Categories,Tags,"Shipping class",Images,"Download limit","Download expiry days",Parent,"Grouped products",Upsells,Cross-sells,"External URL","Button text",Position,"Attribute 1 name","Attribute 1 value(s)","Attribute 1 visible","Attribute 1 global","Attribute 2 name","Attribute 2 value(s)","Attribute 2 visible","Attribute 2 global","Meta: _wpcom_is_markdown","Download 1 name","Download 1 URL","Download 2 name","Download 2 URL" +44,variable,woo-vneck-tee,"V-Neck T-Shirt",1,1,visible,"This is a variable product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,.5,24,1,2,1,,,,"Clothing > Tshirts",,,"https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/vneck-tee-2.jpg, https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/vnech-tee-green-1.jpg, https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/vnech-tee-blue-1.jpg",,,,,,,,,0,Color,"Blue, Green, Red",1,1,Size,"Large, Medium, Small",1,1,1,,,, +45,variable,woo-hoodie,Hoodie,1,0,visible,"This is a variable product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,1.5,10,8,3,1,,,,"Clothing > Hoodies",,,"https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-2.jpg, https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-blue-1.jpg, https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-green-1.jpg, https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-with-logo-2.jpg",,,,,,,,,0,Color,"Blue, Green, Red",1,1,Logo,"Yes, No",1,0,1,,,, +46,simple,woo-hoodie-with-logo,"Hoodie with Logo",1,0,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,2,10,6,3,1,,,45,"Clothing > Hoodies",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-with-logo-2.jpg,,,,,,,,,0,Color,Blue,1,1,,,,,1,,,, +47,simple,woo-tshirt,T-Shirt,1,0,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,.8,8,6,1,1,,,18,"Clothing > Tshirts",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/tshirt-2.jpg,,,,,,,,,0,Color,Gray,1,1,,,,,1,,,, +48,simple,woo-beanie,Beanie,1,0,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,.2,4,5,.5,1,,18,20,"Clothing > Accessories",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/beanie-2.jpg,,,,,,,,,0,Color,Red,1,1,,,,,1,,,, +58,simple,woo-belt,Belt,1,0,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,1.2,12,2,1.5,1,,55,65,"Clothing > Accessories",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/belt-2.jpg,,,,,,,,,0,,,,,,,,,1,,,, +60,simple,woo-cap,Cap,1,1,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,0.6,8,6.5,4,1,,16,18,"Clothing > Accessories",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/cap-2.jpg,,,,,,,,,0,Color,Yellow,1,1,,,,,1,,,, +62,simple,woo-sunglasses,Sunglasses,1,1,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,.2,4,1.4,1,1,,,90,"Clothing > Accessories",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/sunglasses-2.jpg,,,,,,,,,0,,,,,,,,,1,,,, +64,simple,woo-hoodie-with-pocket,"Hoodie with Pocket",1,1,hidden,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,3,10,8,2,1,,35,45,"Clothing > Hoodies",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-with-pocket-2.jpg,,,,,,,,,0,Color,Gray,1,1,,,,,1,,,, +66,simple,woo-hoodie-with-zipper,"Hoodie with Zipper",1,1,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,2,8,6,2,1,,,45,"Clothing > Hoodies",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-with-zipper-2.jpg,,,,,,,,,0,,,,,,,,,1,,,, +68,simple,woo-long-sleeve-tee,"Long Sleeve Tee",1,0,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,1,7,5,1,1,,,25,"Clothing > Tshirts",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/long-sleeve-tee-2.jpg,,,,,,,,,0,Color,Green,1,1,,,,,1,,,, +70,simple,woo-polo,Polo,1,0,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,.8,6,5,1,1,,,20,"Clothing > Tshirts",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/polo-2.jpg,,,,,,,,,0,Color,Blue,1,1,,,,,1,,,, +73,"simple, downloadable, virtual",woo-album,Album,1,0,visible,"This is a simple, virtual product.","Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,1,,,15,Music,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/album-1.jpg,1,1,,,,,,,0,,,,,,,,,1,"Single 1",https://demo.woothemes.com/woocommerce/wp-content/uploads/sites/56/2017/08/single.jpg,"Single 2",https://demo.woothemes.com/woocommerce/wp-content/uploads/sites/56/2017/08/album.jpg +75,"simple, downloadable, virtual",woo-single,Single,1,0,visible,"This is a simple, virtual product.","Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,1,,2,3,Music,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/single-1.jpg,1,1,,,,,,,0,,,,,,,,,1,Single,https://demo.woothemes.com/woocommerce/wp-content/uploads/sites/56/2017/08/single.jpg,, +76,variation,woo-vneck-tee-red,"V-Neck T-Shirt - Red",1,0,visible,,"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,0,,,20,,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/vneck-tee-2.jpg,,,woo-vneck-tee,,,,,,0,Color,Red,,1,Size,,,1,,,,, +77,variation,woo-vneck-tee-green,"V-Neck T-Shirt - Green",1,0,visible,,"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,0,,,20,,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/vnech-tee-green-1.jpg,,,woo-vneck-tee,,,,,,0,Color,Green,,1,Size,,,1,,,,, +78,variation,woo-vneck-tee-blue,"V-Neck T-Shirt - Blue",1,0,visible,,"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,0,,,15,,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/vnech-tee-blue-1.jpg,,,woo-vneck-tee,,,,,,0,Color,Blue,,1,Size,,,1,,,,, +79,variation,woo-hoodie-red,"Hoodie - Red, No",1,0,visible,,"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,0,,42,45,,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-2.jpg,,,woo-hoodie,,,,,,1,Color,Red,,1,Logo,No,,0,,,,, +80,variation,woo-hoodie-green,"Hoodie - Green, No",1,0,visible,,"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,0,,,45,,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-green-1.jpg,,,woo-hoodie,,,,,,2,Color,Green,,1,Logo,No,,0,,,,, +81,variation,woo-hoodie-blue,"Hoodie - Blue, No",1,0,visible,,"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,0,,,45,,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-blue-1.jpg,,,woo-hoodie,,,,,,3,Color,Blue,,1,Logo,No,,0,,,,, +83,simple,Woo-tshirt-logo,"T-Shirt with Logo",1,0,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,.5,10,12,.5,1,,,18,"Clothing > Tshirts",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/t-shirt-with-logo-1.jpg,,,,,,,,,0,Color,Gray,1,1,,,,,1,,,, +85,simple,Woo-beanie-logo,"Beanie with Logo",1,0,visible,"This is a simple product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,.2,6,4,1,1,,18,20,"Clothing > Accessories",,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/beanie-with-logo-1.jpg,,,,,,,,,0,Color,Red,1,1,,,,,1,,,, +87,grouped,logo-collection,"Logo Collection",1,0,visible,"This is a grouped product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,,,,,1,,,,Clothing,,,"https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/logo-1.jpg, https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/beanie-with-logo-1.jpg, https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/t-shirt-with-logo-1.jpg, https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-with-logo-2.jpg",,,,"woo-hoodie-with-logo, woo-tshirt, woo-beanie",,,,,0,,,,,,,,,1,,,, +89,external,wp-pennant,"WordPress Pennant",1,0,visible,"This is an external product.","Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",,,taxable,,1,,0,0,,,,,1,,,11.05,Decor,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/pennant-1.jpg,,,,,,,https://mercantile.wordpress.org/product/wordpress-pennant/,"Buy on the WordPress swag store!",0,,,,,,,,,1,,,, +90,variation,woo-hoodie-blue-logo,"Hoodie - Blue, Yes",1,0,visible,,"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum sagittis orci ac odio dictum tincidunt. Donec ut metus leo. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed luctus, dui eu sagittis sodales, nulla nibh sagittis augue, vel porttitor diam enim non metus. Vestibulum aliquam augue neque. Phasellus tincidunt odio eget ullamcorper efficitur. Cras placerat ut turpis pellentesque vulputate. Nam sed consequat tortor. Curabitur finibus sapien dolor. Ut eleifend tellus nec erat pulvinar dignissim. Nam non arcu purus. Vivamus et massa massa.",,,taxable,,1,,0,0,,,,,0,,,45,,,,https://woocommercecore.mystagingwebsite.com/wp-content/uploads/2017/12/hoodie-with-logo-2.jpg,,,woo-hoodie,,,,,,0,Color,Blue,,1,Logo,Yes,,0,,,,, diff --git a/sample-data/sample_products.xml b/sample-data/sample_products.xml new file mode 100644 index 00000000000..2781b920344 --- /dev/null +++ b/sample-data/sample_products.xml @@ -0,0 +1,3164 @@ + + + + + + + + + + + + + + + + + + + + + + + WooCommerce Videos + https://woocommercecore.mystagingwebsite.com + Just another WordPress site + Thu, 11 Jan 2018 16:36:21 +0000 + en-US + 1.2 + https://woocommercecore.mystagingwebsite.com + https://woocommercecore.mystagingwebsite.com + + 1 + + + +118514079 + + V-Neck T-Shirt + https://woocommercecore.mystagingwebsite.com/product/v-neck-t-shirt/ + Fri, 15 Dec 2017 03:56:33 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=import-placeholder-for-woo-vneck-tee + + + + 44 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Hoodie + https://woocommercecore.mystagingwebsite.com/product/hoodie/ + Fri, 15 Dec 2017 03:56:34 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=import-placeholder-for-woo-hoodie + + + + 45 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Hoodie with Logo + https://woocommercecore.mystagingwebsite.com/product/hoodie-with-logo/ + Fri, 15 Dec 2017 03:56:34 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=import-placeholder-for-woo-hoodie-with-logo + + + + 46 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + T-Shirt + https://woocommercecore.mystagingwebsite.com/product/t-shirt/ + Fri, 15 Dec 2017 03:56:34 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=import-placeholder-for-woo-tshirt + + + + 47 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Beanie + https://woocommercecore.mystagingwebsite.com/product/beanie/ + Fri, 15 Dec 2017 03:56:34 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=import-placeholder-for-woo-beanie + + + + 48 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Belt + https://woocommercecore.mystagingwebsite.com/product/belt/ + Fri, 15 Dec 2017 03:56:41 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=belt + + + + 58 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Cap + https://woocommercecore.mystagingwebsite.com/product/cap/ + Fri, 15 Dec 2017 03:56:42 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=cap + + + + 60 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Sunglasses + https://woocommercecore.mystagingwebsite.com/product/sunglasses/ + Fri, 15 Dec 2017 03:56:43 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=sunglasses + + + + 62 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Hoodie with Pocket + https://woocommercecore.mystagingwebsite.com/product/hoodie-with-pocket/ + Fri, 15 Dec 2017 03:56:45 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=hoodie-with-pocket + + + + 64 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Hoodie with Zipper + https://woocommercecore.mystagingwebsite.com/product/hoodie-with-zipper/ + Fri, 15 Dec 2017 03:56:45 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=hoodie-with-zipper + + + + 66 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Long Sleeve Tee + https://woocommercecore.mystagingwebsite.com/product/long-sleeve-tee/ + Fri, 15 Dec 2017 03:56:46 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=long-sleeve-tee + + + + 68 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Polo + https://woocommercecore.mystagingwebsite.com/product/polo/ + Fri, 15 Dec 2017 03:56:47 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=polo + + + + 70 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Album + https://woocommercecore.mystagingwebsite.com/product/album/ + Fri, 15 Dec 2017 03:56:49 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=album + + + + 73 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Single + https://woocommercecore.mystagingwebsite.com/product/single/ + Fri, 15 Dec 2017 03:56:49 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=single + + + + 75 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 35 + + + + + + + + + + 0 + 7 + + + + + + + + + + + + + + + + + + + + + + + + T-Shirt with Logo + https://woocommercecore.mystagingwebsite.com/product/t-shirt-with-logo/ + Fri, 15 Dec 2017 03:56:52 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=t-shirt-with-logo + + + + 83 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Beanie with Logo + https://woocommercecore.mystagingwebsite.com/product/beanie-with-logo/ + Fri, 15 Dec 2017 03:56:53 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=beanie-with-logo + + + + 85 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Logo Collection + https://woocommercecore.mystagingwebsite.com/product/logo-collection/ + Fri, 15 Dec 2017 03:56:54 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=logo-collection + + + + 87 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + WordPress Pennant + https://woocommercecore.mystagingwebsite.com/product/wordpress-pennant/ + Fri, 15 Dec 2017 03:57:20 +0000 + + https://woocommercecore.mystagingwebsite.com/?product=wordpress-pennant + + + + 89 + + + + + + + 0 + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/dummy-data/sample_tax_rates.csv b/sample-data/sample_tax_rates.csv similarity index 100% rename from dummy-data/sample_tax_rates.csv rename to sample-data/sample_tax_rates.csv diff --git a/templates/archive-product.php b/templates/archive-product.php index ada4a8fbc5b..f96e68acffb 100644 --- a/templates/archive-product.php +++ b/templates/archive-product.php @@ -10,121 +10,98 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 2.0.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly +defined( 'ABSPATH' ) || exit; + +get_header( 'shop' ); + +/** + * Hook: woocommerce_before_main_content. + * + * @hooked woocommerce_output_content_wrapper - 10 (outputs opening divs for the content) + * @hooked woocommerce_breadcrumb - 20 + * @hooked WC_Structured_Data::generate_website_data() - 30 + */ +do_action( 'woocommerce_before_main_content' ); + +?> +
          + +

          + + + +
          + +/** + * Hook: woocommerce_after_main_content. + * + * @hooked woocommerce_output_content_wrapper_end - 10 (outputs closing divs for the content) + */ +do_action( 'woocommerce_after_main_content' ); - +/** + * Hook: woocommerce_sidebar. + * + * @hooked woocommerce_get_sidebar - 10 + */ +do_action( 'woocommerce_sidebar' ); -
          - - - -

          - - - - - -
          - - - - - - - - - - - - - - - - - - - - - - woocommerce_product_loop_start( false ), 'after' => woocommerce_product_loop_end( false ) ) ) ) : ?> - - - - - - - - - - +get_footer( 'shop' ); diff --git a/templates/auth/form-grant-access.php b/templates/auth/form-grant-access.php index c7338d7e816..1a58595e426 100644 --- a/templates/auth/form-grant-access.php +++ b/templates/auth/form-grant-access.php @@ -22,11 +22,11 @@ if ( ! defined( 'ABSPATH' ) ) { -

          +

          -

          ' . esc_html( $app_name ) . '', '' . esc_html( $scope ) . '' ); ?>

          +

          ' . esc_html( $app_name ) . '', '' . esc_html( $scope ) . '' ); ?>

            diff --git a/templates/auth/form-login.php b/templates/auth/form-login.php index 13b292fd132..8aa5330044a 100644 --- a/templates/auth/form-login.php +++ b/templates/auth/form-login.php @@ -10,38 +10,43 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates/Auth - * @version 2.4.0 + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; -?> +do_action( 'woocommerce_auth_page_header' ); ?> - - -

            +

            + +

            -

            cancel and return to %1$s', 'woocommerce' ), wc_clean( $app_name ), esc_url( $return_url ) ); ?>

            +

            + cancel and return to %1$s', 'woocommerce' ), esc_html( wc_clean( $app_name ) ), esc_url( $return_url ) ) ); + ?> +

            diff --git a/templates/cart/cart-empty.php b/templates/cart/cart-empty.php index d0a37915d66..739c8a8c6d2 100644 --- a/templates/cart/cart-empty.php +++ b/templates/cart/cart-empty.php @@ -10,19 +10,14 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 3.1.0 + * @version 3.5.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; -wc_print_notices(); - -/** +/* * @hooked wc_empty_cart_message - 10 */ do_action( 'woocommerce_cart_is_empty' ); @@ -30,7 +25,7 @@ do_action( 'woocommerce_cart_is_empty' ); if ( wc_get_page_id( 'shop' ) > 0 ) : ?>

            - +

            diff --git a/templates/cart/cart-item-data.php b/templates/cart/cart-item-data.php index a65242c8626..98f3296e37b 100644 --- a/templates/cart/cart-item-data.php +++ b/templates/cart/cart-item-data.php @@ -21,7 +21,7 @@ if ( ! defined( 'ABSPATH' ) ) { ?>
            -
            :
            -
            +
            :
            +
            diff --git a/templates/cart/cart-shipping.php b/templates/cart/cart-shipping.php index bc8c05d4c33..8ba509219ce 100644 --- a/templates/cart/cart-shipping.php +++ b/templates/cart/cart-shipping.php @@ -12,50 +12,68 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 3.1.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.5.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; + +$formatted_destination = isset( $formatted_destination ) ? $formatted_destination : WC()->countries->get_formatted_address( $package['destination'], ', ' ); +$has_calculated_shipping = ! empty( $has_calculated_shipping ); +$show_shipping_calculator = ! empty( $show_shipping_calculator ); +$calculator_text = ''; ?> -
          • - -
            + +
            • - ', - $index, sanitize_title( $method->id ), esc_attr( $method->id ), checked( $method->id, $chosen_method, false ), wc_cart_totals_shipping_method_label( $method ) ); - - do_action( 'woocommerce_after_shipping_rate', $method, $index ); + if ( 1 < count( $available_methods ) ) { + printf( '', $index, esc_attr( sanitize_title( $method->id ) ), esc_attr( $method->id ), checked( $method->id, $chosen_method, false ) ); // WPCS: XSS ok. + } else { + printf( '', $index, esc_attr( sanitize_title( $method->id ) ), esc_attr( $method->id ) ); // WPCS: XSS ok. + } + printf( '', $index, esc_attr( sanitize_title( $method->id ) ), wc_cart_totals_shipping_method_label( $method ) ); // WPCS: XSS ok. + do_action( 'woocommerce_after_shipping_rate', $method, $index ); ?>
            - - ', $index, esc_attr( $method->id ), wc_cart_totals_shipping_method_label( $method ) ); - do_action( 'woocommerce_after_shipping_rate', $method, $index ); - ?> - customer->has_calculated_shipping() ) : ?> - - - - + +

            + ' . esc_html( $formatted_destination ) . '' ); + $calculator_text = __( 'Change address', 'woocommerce' ); + } else { + echo esc_html__( 'This is only an estimate. Prices will be updated during checkout.', 'woocommerce' ); + } + ?> +

            + + ' . esc_html( $formatted_destination ) . '' ) ) ); + $calculator_text = __( 'Enter a different address', 'woocommerce' ); + endif; + ?> ' . esc_html( $package_details ) . '

            '; ?> - - + +
             
          ×', - esc_url( WC()->cart->get_remove_url( $cart_item_key ) ), + esc_url( wc_get_cart_remove_url( $cart_item_key ) ), __( 'Remove this item', 'woocommerce' ), esc_attr( $product_id ), esc_attr( $_product->get_sku() ) @@ -64,61 +60,64 @@ do_action( 'woocommerce_before_cart' ); ?> - get_image(), $cart_item, $cart_item_key ); + get_image(), $cart_item, $cart_item_key ); - if ( ! $product_permalink ) { - echo $thumbnail; - } else { - printf( '%s', esc_url( $product_permalink ), $thumbnail ); - } - ?> + if ( ! $product_permalink ) { + echo $thumbnail; // PHPCS: XSS ok. + } else { + printf( '%s', esc_url( $product_permalink ), $thumbnail ); // PHPCS: XSS ok. + } + ?> - get_name(), $cart_item, $cart_item_key ) . ' '; - } else { - echo apply_filters( 'woocommerce_cart_item_name', sprintf( '%s', esc_url( $product_permalink ), $_product->get_name() ), $cart_item, $cart_item_key ); - } + get_name(), $cart_item, $cart_item_key ) . ' ' ); + } else { + echo wp_kses_post( apply_filters( 'woocommerce_cart_item_name', sprintf( '%s', esc_url( $product_permalink ), $_product->get_name() ), $cart_item, $cart_item_key ) ); + } - // Meta data - echo WC()->cart->get_item_data( $cart_item ); + do_action( 'woocommerce_after_cart_item_name', $cart_item, $cart_item_key ); - // Backorder notification - if ( $_product->backorders_require_notification() && $_product->is_on_backorder( $cart_item['quantity'] ) ) { - echo '

          ' . esc_html__( 'Available on backorder', 'woocommerce' ) . '

          '; - } - ?> + // Meta data. + echo wc_get_formatted_cart_item_data( $cart_item ); // PHPCS: XSS ok. + + // Backorder notification. + if ( $_product->backorders_require_notification() && $_product->is_on_backorder( $cart_item['quantity'] ) ) { + echo wp_kses_post( apply_filters( 'woocommerce_cart_item_backorder_notification', '

          ' . esc_html__( 'Available on backorder', 'woocommerce' ) . '

          ', $product_id ) ); + } + ?>           		cart->get_product_price( $_product ), $cart_item, $cart_item_key ); + echo apply_filters( 'woocommerce_cart_item_price', WC()->cart->get_product_price( $_product ), $cart_item, $cart_item_key ); // PHPCS: XSS ok. ?> - is_sold_individually() ) { - $product_quantity = sprintf( '1 ', $cart_item_key ); - } else { - $product_quantity = woocommerce_quantity_input( array( - 'input_name' => "cart[{$cart_item_key}][qty]", - 'input_value' => $cart_item['quantity'], - 'max_value' => $_product->get_max_purchase_quantity(), - 'min_value' => '0', - ), $_product, false ); - } + is_sold_individually() ) { + $product_quantity = sprintf( '1 ', $cart_item_key ); + } else { + $product_quantity = woocommerce_quantity_input( array( + 'input_name' => "cart[{$cart_item_key}][qty]", + 'input_value' => $cart_item['quantity'], + 'max_value' => $_product->get_max_purchase_quantity(), + 'min_value' => '0', + 'product_name' => $_product->get_name(), + ), $_product, false ); + } - echo apply_filters( 'woocommerce_cart_item_quantity', $product_quantity, $cart_item_key, $cart_item ); - ?> + echo apply_filters( 'woocommerce_cart_item_quantity', $product_quantity, $cart_item_key, $cart_item ); // PHPCS: XSS ok. + ?> cart->get_product_subtotal( $_product, $cart_item['quantity'] ), $cart_item, $cart_item_key ); + echo apply_filters( 'woocommerce_cart_item_subtotal', WC()->cart->get_product_subtotal( $_product, $cart_item['quantity'] ), $cart_item, $cart_item_key ); // PHPCS: XSS ok. ?>
          - - - + + + - get_items() ) > 0 ) : ?> + get_items() ) > 0 ) : ?> get_items() as $item_id => $item ) : ?> - - + + - get_order_item_totals() ) : ?> + - - + + @@ -73,13 +71,13 @@ if ( ! defined( 'ABSPATH' ) ) { needs_payment() ) : ?>
            $gateway ) ); - } - } else { - echo '
          • ' . apply_filters( 'woocommerce_no_available_payment_methods_message', __( 'Sorry, it seems that there are no available payment methods for your location. Please contact us if you require assistance or wish to make alternate arrangements.', 'woocommerce' ) ) . '
            • '; + if ( ! empty( $available_gateways ) ) { + foreach ( $available_gateways as $gateway ) { + wc_get_template( 'checkout/payment-method.php', array( 'gateway' => $gateway ) ); } + } else { + echo '
          • ' . apply_filters( 'woocommerce_no_available_payment_methods_message', __( 'Sorry, it seems that there are no available payment methods for your location. Please contact us if you require assistance or wish to make alternate arrangements.', 'woocommerce' ) ) . '
            • '; // @codingStandardsIgnoreLine + } ?>
          @@ -90,11 +88,11 @@ if ( ! defined( 'ABSPATH' ) ) { - ' ); ?> + ' . esc_html( $order_button_text ) . '' ); // @codingStandardsIgnoreLine ?> - + diff --git a/templates/checkout/order-receipt.php b/templates/checkout/order-receipt.php new file mode 100644 index 00000000000..e7d351c752a --- /dev/null +++ b/templates/checkout/order-receipt.php @@ -0,0 +1,47 @@ + + +
            +
          • + + get_order_number() ); ?> +
            • +
          • + + get_date_created() ) ); ?> +
            • +
          • + + get_formatted_order_total() ); ?> +
            • + get_payment_method_title() ) : ?> +
          • + + get_payment_method_title() ); ?> +
            • + +
          + +get_payment_method(), $order->get_id() ); ?> + +
          diff --git a/templates/checkout/payment-method.php b/templates/checkout/payment-method.php index dead8df7953..0e8a654508a 100644 --- a/templates/checkout/payment-method.php +++ b/templates/checkout/payment-method.php @@ -10,24 +10,23 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 2.3.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; } ?> -
        • - chosen, true ); ?> data-order_button_text="order_button_text ); ?>" /> +
        • + chosen, true ); ?> data-order_button_text="order_button_text ); ?>" /> -
          • - cart->tax_display_cart ) : ?> + cart->display_prices_including_tax() ) : ?> cart->get_tax_totals() as $code => $tax ) : ?> diff --git a/templates/checkout/terms.php b/templates/checkout/terms.php index 5aa5480a541..cca6c52b08f 100644 --- a/templates/checkout/terms.php +++ b/templates/checkout/terms.php @@ -1,31 +1,40 @@ 0 && apply_filters( 'woocommerce_checkout_show_terms', true ) ) : - $terms = get_post( $terms_page_id ); - $terms_content = has_shortcode( $terms->post_content, 'woocommerce_checkout' ) ? '' : wc_format_content( $terms->post_content ); +if ( apply_filters( 'woocommerce_checkout_show_terms', true ) && function_exists( 'wc_terms_and_conditions_checkbox_enabled' ) ) { + do_action( 'woocommerce_checkout_before_terms_and_conditions' ); - if ( $terms_content ) { - do_action( 'woocommerce_checkout_before_terms_and_conditions' ); - echo ''; - } ?> -

          - - -

          - - +
          + + + +

          + + +

          + +
          + get_user_id() === get_current_user_id() && $order->get_billing_email() ) : ?> -
        • +
          • diff --git a/templates/content-product.php b/templates/content-product.php index bc8204642b8..36ffa701aa0 100644 --- a/templates/content-product.php +++ b/templates/content-product.php @@ -11,33 +11,30 @@ * the readme will list any important changes. * * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes * @package WooCommerce/Templates - * @version 3.0.0 + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly -} +defined( 'ABSPATH' ) || exit; global $product; -// Ensure visibility +// Ensure visibility. if ( empty( $product ) || ! $product->is_visible() ) { return; } ?> -
        • > +
        • > is_visible() ) { do_action( 'woocommerce_before_shop_loop_item_title' ); /** - * woocommerce_shop_loop_item_title hook. + * Hook: woocommerce_shop_loop_item_title. * * @hooked woocommerce_template_loop_product_title - 10 */ do_action( 'woocommerce_shop_loop_item_title' ); /** - * woocommerce_after_shop_loop_item_title hook. + * Hook: woocommerce_after_shop_loop_item_title. * * @hooked woocommerce_template_loop_rating - 5 * @hooked woocommerce_template_loop_price - 10 @@ -60,7 +57,7 @@ if ( empty( $product ) || ! $product->is_visible() ) { do_action( 'woocommerce_after_shop_loop_item_title' ); /** - * woocommerce_after_shop_loop_item hook. + * Hook: woocommerce_after_shop_loop_item. * * @hooked woocommerce_template_loop_product_link_close - 5 * @hooked woocommerce_template_loop_add_to_cart - 10 diff --git a/templates/content-single-product.php b/templates/content-single-product.php index 31404e7bda4..7dcb3574fa3 100644 --- a/templates/content-single-product.php +++ b/templates/content-single-product.php @@ -10,37 +10,30 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 3.0.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; // Exit if accessed directly +defined( 'ABSPATH' ) || exit; + +/** + * Hook: woocommerce_before_single_product. + * + * @hooked wc_print_notices - 10 + */ +do_action( 'woocommerce_before_single_product' ); + +if ( post_password_required() ) { + echo get_the_password_form(); // WPCS: XSS ok. + return; } - ?> - - - -
          > +
          >
          - - -
          +
          - -
          + diff --git a/templates/content-widget-product.php b/templates/content-widget-product.php index 136547bcdb8..b74aab4ef4c 100644 --- a/templates/content-widget-product.php +++ b/templates/content-widget-product.php @@ -1,35 +1,43 @@ +global $product; +if ( ! is_a( $product, 'WC_Product' ) ) { + return; +} + +?>
        • + + - get_image(); ?> - get_name(); ?> + get_image() ); ?> + get_name() ); ?> + - get_average_rating() ); ?> + get_average_rating() ) ); ?> - get_price_html(); ?> + + get_price_html() ); ?> + +
          • diff --git a/templates/content-widget-reviews.php b/templates/content-widget-reviews.php new file mode 100644 index 00000000000..eff07699755 --- /dev/null +++ b/templates/content-widget-reviews.php @@ -0,0 +1,34 @@ + +
        • + + + + get_image(); ?> + get_name(); ?> + + + comment_ID, 'rating', true ) ) );?> + + comment_ID ) ); ?> + + +
          • diff --git a/templates/emails/admin-cancelled-order.php b/templates/emails/admin-cancelled-order.php index 1e97814dd12..7073349157b 100644 --- a/templates/emails/admin-cancelled-order.php +++ b/templates/emails/admin-cancelled-order.php @@ -10,45 +10,50 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates/Emails - * @version 2.5.0 + * @version 3.5.0 */ - if ( ! defined( 'ABSPATH' ) ) { - exit; - } +if ( ! defined( 'ABSPATH' ) ) { + exit; +} - /** - * @hooked WC_Emails::email_header() Output the email header - */ - do_action( 'woocommerce_email_header', $email_heading, $email ); ?> +/* + * @hooked WC_Emails::email_header() Output the email header +*/ +do_action( 'woocommerce_email_header', $email_heading, $email ); ?> -

          get_order_number(), $order->get_formatted_billing_full_name() ); ?>

          + +

          get_formatted_billing_full_name() ), esc_html( $order->get_order_number() ) ); ?>

          - +

          + +

          + +/* + * @hooked WC_Emails::email_header() Output the email header + */ +do_action( 'woocommerce_email_header', $email_heading, $email ); ?> -

          get_order_number(), $order->get_formatted_billing_full_name() ); ?>

          + +

          get_order_number() ), esc_html( $order->get_formatted_billing_full_name() ) ); ?>

          - +

          +troubleshooting failed payments.', 'woocommerce' ) ); ?> +

          + +/* + * @hooked WC_Emails::email_header() Output the email header + */ +do_action( 'woocommerce_email_header', $email_heading, $email ); ?> -

          get_formatted_billing_full_name() ); ?>

          + +

          get_formatted_billing_full_name() ); ?>

          + +

          + -

          - + +

          get_billing_first_name() ) ); ?>

          + +

          */ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); -/** +?> +

          + +

          + -has_status( 'pending' ) ) : ?> -

          get_checkout_payment_url() ) . '">' . __( 'pay', 'woocommerce' ) . '' ); ?>

          - + +

          get_billing_first_name() ) ); ?>

          +has_status( 'pending' ) ) { ?> +

          + array( + 'href' => array(), + ), + ) + ), + esc_html( get_bloginfo( 'name', 'display' ) ), + '' . esc_html__( 'Pay for this order', 'woocommerce' ) . '' + ); + ?> +

          + + +

          + get_date_created() ) ) ); + ?> +

          do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email ); /** + * Hook for the woocommerce_email_order_meta. + * * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); /** + * Hook for woocommerce_email_customer_details. + * * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); +?> +

          + +

          + -

          ' . esc_html( $user_login ) . '' ); ?>

          + +

          + +

          ' . esc_html( $user_login ) . '', make_clickable( esc_url( wc_get_page_permalink( 'myaccount' ) ) ) ); ?>

          - -

          ' . esc_html( $user_pass ) . '' ); ?>

          - + +

          ' . esc_html( $user_pass ) . '' ); ?>

          -

          +

          - -

          + +

          get_billing_first_name() ) ); ?>

          +

          -
          +
          -

          +

          */ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); -/** +?> +

          + -

          + +

          get_billing_first_name() ); ?>

          +

          */ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); -/** +?> +

          + +

          + -

          + +

          get_billing_first_name() ) ); ?>

          + +

          get_order_number() ) ); ?>

          */ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); -/** +?> +

          + +

          + -

          + +

          get_billing_first_name() ); ?>

          +

          + +

          */ do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::order_meta() Shows order meta data. */ do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email ); -/** +/* * @hooked WC_Emails::customer_details() Shows customer details * @hooked WC_Emails::email_address() Shows email address */ do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email ); -/** +?> +

          + +

          + -

          -

          -

          -

          + +

          + +

          + +

          +

          - - + + +

          -

          +

          diff --git a/templates/emails/email-addresses.php b/templates/emails/email-addresses.php index 0a9f13158a8..2cce13d8d91 100644 --- a/templates/emails/email-addresses.php +++ b/templates/emails/email-addresses.php @@ -13,7 +13,7 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates/Emails - * @version 3.2.0 + * @version 3.2.1 */ if ( ! defined( 'ABSPATH' ) ) { @@ -30,7 +30,10 @@ $text_align = is_rtl() ? 'right' : 'left';
          get_formatted_billing_address() ) ? $address : __( 'N/A', 'woocommerce' ); ?> get_billing_phone() ) : ?> -

          get_billing_phone() ); ?>

          +
          get_billing_phone() ); ?> + + get_billing_email() ) : ?> +

          get_billing_email() ); ?>

          diff --git a/templates/emails/email-downloads.php b/templates/emails/email-downloads.php index efb8f8320d1..a5fcff7f353 100644 --- a/templates/emails/email-downloads.php +++ b/templates/emails/email-downloads.php @@ -10,23 +10,22 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 3.2.0 + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} -?> -

          +defined( 'ABSPATH' ) || exit; + +$text_align = is_rtl() ? 'right' : 'left'; + +?>
          get_name() ), $item, false ); + echo apply_filters( 'woocommerce_order_item_name', esc_html( $item->get_name() ), $item, false ); // @codingStandardsIgnoreLine - do_action( 'woocommerce_order_item_meta_start', $item_id, $item, $order ); + do_action( 'woocommerce_order_item_meta_start', $item_id, $item, $order, false ); wc_display_item_meta( $item ); - do_action( 'woocommerce_order_item_meta_end', $item_id, $item, $order ); + do_action( 'woocommerce_order_item_meta_end', $item_id, $item, $order, false ); ?> ' . sprintf( '× %s', esc_html( $item->get_quantity() ) ) . '', $item ); ?>get_formatted_line_subtotal( $item ); ?>' . sprintf( '× %s', esc_html( $item->get_quantity() ) ) . '', $item ); ?>get_formatted_line_subtotal( $item ); ?>
          cart->get_product_subtotal( $_product, $cart_item['quantity'] ), $cart_item, $cart_item_key ); ?> @@ -84,7 +84,7 @@ if ( ! defined( 'ABSPATH' ) ) {
          $column_name ) : ?> - + @@ -34,29 +33,35 @@ if ( ! defined( 'ABSPATH' ) ) { $column_name ) : ?> - + ?> + diff --git a/templates/emails/email-order-details.php b/templates/emails/email-order-details.php index 5f39425fce9..997fae8761f 100644 --- a/templates/emails/email-order-details.php +++ b/templates/emails/email-order-details.php @@ -10,10 +10,9 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails - * @version 3.2.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails + * @version 3.3.1 */ if ( ! defined( 'ABSPATH' ) ) { @@ -24,45 +23,67 @@ $text_align = is_rtl() ? 'right' : 'left'; do_action( 'woocommerce_email_before_order_table', $order, $sent_to_admin, $plain_text, $email ); ?> -

          +

          + get_edit_order_url() ) . '">'; + $after = ''; + } else { + $before = ''; + $after = ''; + } + /* translators: %s: Order ID. */ + echo wp_kses_post( $before . sprintf( __( '[Order #%s]', 'woocommerce' ) . $after . ' ()', $order->get_order_number(), $order->get_date_created()->format( 'c' ), wc_format_datetime( $order->get_date_created() ) ) ); + ?> +

          -
          ;"> + - + case 'download-product': + ?> + + break; + case 'download-file': + ?> - - - - - + +
          - - - - - - - - - $sent_to_admin, - 'show_image' => false, - 'image_size' => array( 32, 32 ), - 'plain_text' => $plain_text, - 'sent_to_admin' => $sent_to_admin, - ) ); ?> - - - get_order_item_totals() ) { +
          +
          + + + + + + + + + $sent_to_admin, + 'show_image' => false, + 'image_size' => array( 32, 32 ), + 'plain_text' => $plain_text, + 'sent_to_admin' => $sent_to_admin, + ) ); + ?> + + + get_order_item_totals(); + + if ( $totals ) { $i = 0; foreach ( $totals as $total ) { $i++; - ?> - - - + + + + + get_customer_note() ) { - ?> - - - + + + + + - -
          get_customer_note() ); ?>
          get_customer_note() ) ); ?>
          + ?> + +
          + diff --git a/templates/emails/email-order-items.php b/templates/emails/email-order-items.php index fbe6ae9d7f7..66f64fdb673 100644 --- a/templates/emails/email-order-items.php +++ b/templates/emails/email-order-items.php @@ -10,57 +10,81 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates/Emails - * @version 3.2.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates/Emails + * @version 3.5.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} +defined( 'ABSPATH' ) || exit; $text_align = is_rtl() ? 'right' : 'left'; foreach ( $items as $item_id => $item ) : - if ( apply_filters( 'woocommerce_order_item_visible', true, $item ) ) { - $product = $item->get_product(); + $product = $item->get_product(); + $sku = ''; + $purchase_note = ''; + $image = ''; + + if ( ! apply_filters( 'woocommerce_order_item_visible', true, $item ) ) { + continue; + } + + if ( is_object( $product ) ) { + $sku = $product->get_sku(); + $purchase_note = $product->get_purchase_note(); + $image = $product->get_image( $image_size ); + } + + ?> +
          + get_name(), $item, false ) ); + + // SKU. + if ( $show_sku && $sku ) { + echo wp_kses_post( ' (#' . $sku . ')' ); + } + + // allow other plugins to add additional product information here. + do_action( 'woocommerce_order_item_meta_start', $item_id, $item, $order, $plain_text ); + + wc_display_item_meta( $item, array( + 'label_before' => '', + ) ); + + // allow other plugins to add additional product information here. + do_action( 'woocommerce_order_item_meta_end', $item_id, $item, $order, $plain_text ); + ?> -
          + + get_quantity(), $item ) ); ?> + + get_formatted_line_subtotal( $item ) ); ?> +
          get_quantity(), $item ); ?>get_formatted_line_subtotal( $item ); ?>
          + +
          @@ -47,20 +49,23 @@ if ( $show_downloads ) { $item ) { - $product = apply_filters( 'woocommerce_order_item_product', $item->get_product(), $item ); + do_action( 'woocommerce_order_details_before_order_table_items', $order ); - wc_get_template( 'order/order-details-item.php', array( - 'order' => $order, - 'item_id' => $item_id, - 'item' => $item, - 'show_purchase_note' => $show_purchase_note, - 'purchase_note' => $product ? $product->get_purchase_note() : '', - 'product' => $product, - ) ); - } + foreach ( $order_items as $item_id => $item ) { + $product = $item->get_product(); + + wc_get_template( 'order/order-details-item.php', array( + 'order' => $order, + 'item_id' => $item_id, + 'item' => $item, + 'show_purchase_note' => $show_purchase_note, + 'purchase_note' => $product ? $product->get_purchase_note() : '', + 'product' => $product, + ) ); + } + + do_action( 'woocommerce_order_details_after_order_table_items', $order ); ?> - diff --git a/templates/order/order-downloads.php b/templates/order/order-downloads.php index 392f75aa4ba..50ff7dbee88 100644 --- a/templates/order/order-downloads.php +++ b/templates/order/order-downloads.php @@ -10,10 +10,10 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ + * @author Automattic * @package WooCommerce/Templates - * @version 3.2.0 + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { @@ -22,10 +22,10 @@ if ( ! defined( 'ABSPATH' ) ) { ?>
          -

          +

          -
          +
          $column_name ) : ?> @@ -37,32 +37,36 @@ if ( ! defined( 'ABSPATH' ) ) { $column_name ) : ?> - + ?> + diff --git a/templates/product-searchform.php b/templates/product-searchform.php index 16e96a33abc..50e528550ce 100644 --- a/templates/product-searchform.php +++ b/templates/product-searchform.php @@ -13,7 +13,7 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 2.5.0 + * @version 3.3.0 */ if ( ! defined( 'ABSPATH' ) ) { @@ -22,8 +22,8 @@ if ( ! defined( 'ABSPATH' ) ) { ?> - + - + diff --git a/templates/single-product-reviews.php b/templates/single-product-reviews.php index 50d182d2ec1..b0f19745233 100644 --- a/templates/single-product-reviews.php +++ b/templates/single-product-reviews.php @@ -13,7 +13,7 @@ * @see https://docs.woocommerce.com/document/template-structure/ * @author WooThemes * @package WooCommerce/Templates - * @version 2.3.2 + * @version 3.5.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly @@ -74,10 +74,10 @@ if ( ! comments_open() ) { 'title_reply_after' => '', 'comment_notes_after' => '', 'fields' => array( - 'author' => '

          ' . ' ' . - '

          ', - 'email' => '', + 'author' => '

          ' . ' ' . + '

          ', + 'email' => '', ), 'label_submit' => __( 'Submit', 'woocommerce' ), 'logged_in_as' => '', @@ -89,7 +89,7 @@ if ( ! comments_open() ) { } if ( get_option( 'woocommerce_enable_review_rating' ) === 'yes' ) { - $comment_form['comment_field'] = '
          @@ -99,7 +99,7 @@ if ( ! comments_open() ) {
          '; } - $comment_form['comment_field'] .= '

          '; + $comment_form['comment_field'] .= '

          '; comment_form( apply_filters( 'woocommerce_product_review_comment_form_args', $comment_form ) ); ?> diff --git a/templates/single-product/add-to-cart/external.php b/templates/single-product/add-to-cart/external.php index fd5e03cb2fe..8a9e3e0d6ca 100644 --- a/templates/single-product/add-to-cart/external.php +++ b/templates/single-product/add-to-cart/external.php @@ -10,19 +10,23 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 2.1.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} -do_action( 'woocommerce_before_add_to_cart_button' ); ?> +defined( 'ABSPATH' ) || exit; -

          - -

          +do_action( 'woocommerce_before_add_to_cart_form' ); ?> - + + + + + + + + + + + diff --git a/templates/single-product/add-to-cart/grouped.php b/templates/single-product/add-to-cart/grouped.php index b0d811cfdbe..0408fd8c637 100644 --- a/templates/single-product/add-to-cart/grouped.php +++ b/templates/single-product/add-to-cart/grouped.php @@ -11,77 +11,85 @@ * the readme will list any important changes. * * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes * @package WooCommerce/Templates - * @version 3.0.7 + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; global $product, $post; do_action( 'woocommerce_before_add_to_cart_form' ); ?> - -
          " data-title=""> + - - - - - - - - - ' . esc_html( $download['product_name'] ) . ''; + } else { + echo esc_html( $download['product_name'] ); + } + break; + case 'download-file': + echo '' . esc_html( $download['download_name'] ) . ''; + break; + case 'download-remaining': + echo is_numeric( $download['downloads_remaining'] ) ? esc_html( $download['downloads_remaining'] ) : esc_html__( '∞', 'woocommerce' ); + break; + case 'download-expires': + if ( ! empty( $download['access_expires'] ) ) { + echo ''; + } else { + esc_html_e( 'Never', 'woocommerce' ); + } + break; } } - ?>
          + +
          get_id() ); - $quantites_required = $quantites_required || ( $grouped_product->is_purchasable() && ! $grouped_product->has_options() ); + foreach ( $grouped_products as $grouped_product_child ) { + $post_object = get_post( $grouped_product_child->get_id() ); + $quantites_required = $quantites_required || ( $grouped_product_child->is_purchasable() && ! $grouped_product_child->has_options() ); + $post = $post_object; // WPCS: override ok. + setup_postdata( $post ); - setup_postdata( $post =& $post_object ); - ?> - > - '; - is_sold_individually() ) : ?> - + // Output columns for each product. + foreach ( $grouped_product_columns as $column_id ) { + do_action( 'woocommerce_grouped_product_list_before_' . $column_id, $grouped_product_child ); - - 'quantity[' . $grouped_product->get_id() . ']', - 'input_value' => isset( $_POST['quantity'][ $grouped_product->get_id() ] ) ? wc_stock_amount( $_POST['quantity'][ $grouped_product->get_id() ] ) : 0, - 'min_value' => apply_filters( 'woocommerce_quantity_input_min', 0, $grouped_product ), - 'max_value' => apply_filters( 'woocommerce_quantity_input_max', $grouped_product->get_max_purchase_quantity(), $grouped_product ), - ) ); + if ( ! $grouped_product_child->is_purchasable() || $grouped_product_child->has_options() || ! $grouped_product_child->is_in_stock() ) { + woocommerce_template_loop_add_to_cart(); + } elseif ( $grouped_product_child->is_sold_individually() ) { + echo ''; + } else { + do_action( 'woocommerce_before_add_to_cart_quantity' ); - /** - * @since 3.0.0. - */ - do_action( 'woocommerce_after_add_to_cart_quantity' ); - ?> - - - - - - - 'quantity[' . $grouped_product_child->get_id() . ']', + 'input_value' => isset( $_POST['quantity'][ $grouped_product_child->get_id() ] ) ? wc_stock_amount( wc_clean( wp_unslash( $_POST['quantity'][ $grouped_product_child->get_id() ] ) ) ) : 0, // WPCS: CSRF ok, input var okay, sanitization ok. + 'min_value' => apply_filters( 'woocommerce_quantity_input_min', 0, $grouped_product_child ), + 'max_value' => apply_filters( 'woocommerce_quantity_input_max', $grouped_product_child->get_max_purchase_quantity(), $grouped_product_child ), + ) ); + + do_action( 'woocommerce_after_add_to_cart_quantity' ); + } + + $value = ob_get_clean(); + break; + case 'label': + $value = ''; + break; + case 'price': + $value = $grouped_product_child->get_price_html() . wc_get_stock_html( $grouped_product_child ); + break; + default: + $value = ''; + break; + } + + echo ''; // WPCS: XSS ok. + + do_action( 'woocommerce_grouped_product_list_after_' . $column_id, $grouped_product_child ); } - // Return data to original post. - setup_postdata( $post =& $previous_post ); + + echo ''; + } + $post = $previous_post; // WPCS: override ok. + setup_postdata( $post ); ?>
          - is_purchasable() || $grouped_product->has_options() ) : ?> - + echo '
          - - - get_price_html(); - echo wc_get_stock_html( $grouped_product ); - ?> -
          ' . apply_filters( 'woocommerce_grouped_product_list_column_' . $column_id, $value, $grouped_product_child ) . '
          diff --git a/templates/single-product/add-to-cart/simple.php b/templates/single-product/add-to-cart/simple.php index d4e542b0635..bc4cfc02c4d 100644 --- a/templates/single-product/add-to-cart/simple.php +++ b/templates/single-product/add-to-cart/simple.php @@ -10,14 +10,12 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes - * @package WooCommerce/Templates - * @version 3.0.0 + * @see https://docs.woocommerce.com/document/template-structure/ + * @package WooCommerce/Templates + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; global $product; @@ -25,44 +23,30 @@ if ( ! $product->is_purchasable() ) { return; } -echo wc_get_stock_html( $product ); +echo wc_get_stock_html( $product ); // WPCS: XSS ok. if ( $product->is_in_stock() ) : ?> - + + + apply_filters( 'woocommerce_quantity_input_min', $product->get_min_purchase_quantity(), $product ), + 'max_value' => apply_filters( 'woocommerce_quantity_input_max', $product->get_max_purchase_quantity(), $product ), + 'input_value' => isset( $_POST['quantity'] ) ? wc_stock_amount( wp_unslash( $_POST['quantity'] ) ) : $product->get_min_purchase_quantity(), // WPCS: CSRF ok, input var ok. + ) ); - woocommerce_quantity_input( array( - 'min_value' => apply_filters( 'woocommerce_quantity_input_min', $product->get_min_purchase_quantity(), $product ), - 'max_value' => apply_filters( 'woocommerce_quantity_input_max', $product->get_max_purchase_quantity(), $product ), - 'input_value' => isset( $_POST['quantity'] ) ? wc_stock_amount( $_POST['quantity'] ) : $product->get_min_purchase_quantity(), - ) ); - - /** - * @since 3.0.0. - */ - do_action( 'woocommerce_after_add_to_cart_quantity' ); + do_action( 'woocommerce_after_add_to_cart_quantity' ); ?> - + diff --git a/templates/single-product/add-to-cart/variable.php b/templates/single-product/add-to-cart/variable.php index ac325c0770a..852a3a51a0d 100644 --- a/templates/single-product/add-to-cart/variable.php +++ b/templates/single-product/add-to-cart/variable.php @@ -10,14 +10,12 @@ * happen. When this occurs the version of the template file will be bumped and * the readme will list any important changes. * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 3.0.0 + * @version 3.4.1 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; global $product; @@ -25,40 +23,42 @@ $attribute_keys = array_keys( $attributes ); do_action( 'woocommerce_before_add_to_cart_form' ); ?> -
          + -

          +

          $options ) : ?> - + - +
          get_variation_default_attribute( $attribute_name ); - wc_dropdown_variation_attribute_options( array( 'options' => $options, 'attribute' => $attribute_name, 'product' => $product, 'selected' => $selected ) ); - echo end( $attribute_keys ) === $attribute_name ? apply_filters( 'woocommerce_reset_variations_link', '' . esc_html__( 'Clear', 'woocommerce' ) . '' ) : ''; + wc_dropdown_variation_attribute_options( array( + 'options' => $options, + 'attribute' => $attribute_name, + 'product' => $product, + ) ); + echo end( $attribute_keys ) === $attribute_name ? wp_kses_post( apply_filters( 'woocommerce_reset_variations_link', '' . esc_html__( 'Clear', 'woocommerce' ) . '' ) ) : ''; ?>
          - -
          do_action( 'woocommerce_single_variation' ); /** - * woocommerce_after_single_variation Hook. + * Hook: woocommerce_after_single_variation. */ do_action( 'woocommerce_after_single_variation' ); ?>
          - - diff --git a/templates/single-product/add-to-cart/variation-add-to-cart-button.php b/templates/single-product/add-to-cart/variation-add-to-cart-button.php index 1aa8ace21e8..81019ce85a6 100644 --- a/templates/single-product/add-to-cart/variation-add-to-cart-button.php +++ b/templates/single-product/add-to-cart/variation-add-to-cart-button.php @@ -2,36 +2,34 @@ /** * Single variation cart button * - * @see https://docs.woocommerce.com/document/template-structure/ - * @author WooThemes + * @see https://docs.woocommerce.com/document/template-structure/ * @package WooCommerce/Templates - * @version 3.0.0 + * @version 3.4.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; global $product; ?>
          + + apply_filters( 'woocommerce_quantity_input_min', $product->get_min_purchase_quantity(), $product ), - 'max_value' => apply_filters( 'woocommerce_quantity_input_max', $product->get_max_purchase_quantity(), $product ), - 'input_value' => isset( $_POST['quantity'] ) ? wc_stock_amount( $_POST['quantity'] ) : $product->get_min_purchase_quantity(), - ) ); + woocommerce_quantity_input( array( + 'min_value' => apply_filters( 'woocommerce_quantity_input_min', $product->get_min_purchase_quantity(), $product ), + 'max_value' => apply_filters( 'woocommerce_quantity_input_max', $product->get_max_purchase_quantity(), $product ), + 'input_value' => isset( $_POST['quantity'] ) ? wc_stock_amount( wp_unslash( $_POST['quantity'] ) ) : $product->get_min_purchase_quantity(), // WPCS: CSRF ok, input var ok. + ) ); - /** - * @since 3.0.0. - */ - do_action( 'woocommerce_after_add_to_cart_quantity' ); + do_action( 'woocommerce_after_add_to_cart_quantity' ); ?> + + + + diff --git a/templates/single-product/add-to-cart/variation.php b/templates/single-product/add-to-cart/variation.php index dd27206ed0a..3e4ae710a20 100644 --- a/templates/single-product/add-to-cart/variation.php +++ b/templates/single-product/add-to-cart/variation.php @@ -10,22 +10,14 @@ * @package WooCommerce/Templates * @version 2.5.0 */ -if ( ! defined( 'ABSPATH' ) ) { - exit; -} + +defined( 'ABSPATH' ) || exit; + ?> ' ) ); + } + + /** + * Test wc_clean(). * * @since 2.2 */ public function test_wc_clean() { - $this->assertEquals( 'cleaned', wc_clean( 'cleaned' ) ); + $this->assertEquals( array( 'cleaned', 'foo' ), wc_clean( array( 'cleaned', 'foo' ) ) ); } /** - * Test wc_sanitize_tooltip() - note this is a basic type test as WP core already. - * has coverage for wp_kses(). + * Test wc_sanitize_textarea(). + * + * @since 3.3.0 + */ + public function test_wc_sanitize_textarea() { + $this->assertEquals( "foo\ncleaned\nbar", wc_sanitize_textarea( "foo\ncleaned\nbar" ) ); + } + + /** + * Test wc_sanitize_tooltip(). + * + * Note this is a basic type test as WP core already has coverage for wp_kses(). * * @since 2.4 */ public function test_wc_sanitize_tooltip() { - - $this->assertEquals( 'alert();cleaned', wc_sanitize_tooltip( 'cleaned' ) ); + $this->assertEquals( 'alert();cleaned<p>foo</p><span>bar</span>', wc_sanitize_tooltip( 'cleaned

          foo

          bar' ) ); } /** @@ -334,7 +407,6 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_array_overlay() { - $a1 = array( 'apple' => 'banana', 'pear' => 'grape', @@ -368,7 +440,6 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_stock_amount() { - $this->assertEquals( 10, wc_stock_amount( 10 ) ); $this->assertEquals( 10, wc_stock_amount( '10' ) ); $this->assertEquals( 3, wc_stock_amount( 3.43 ) ); @@ -380,26 +451,25 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_get_woocommerce_price_format() { - - // save default + // Save default. $currency_pos = get_option( 'woocommerce_currency_pos' ); - // default format (left) + // Default format (left). $this->assertEquals( '%1$s%2$s', get_woocommerce_price_format() ); - // right + // Right. update_option( 'woocommerce_currency_pos', 'right' ); $this->assertEquals( '%2$s%1$s', get_woocommerce_price_format() ); - // left space + // Left space. update_option( 'woocommerce_currency_pos', 'left_space' ); $this->assertEquals( '%1$s %2$s', get_woocommerce_price_format() ); - // right space + // Right space. update_option( 'woocommerce_currency_pos', 'right_space' ); $this->assertEquals( '%2$s %1$s', get_woocommerce_price_format() ); - // restore default + // Restore default. update_option( 'woocommerce_currency_pos', $currency_pos ); } @@ -411,7 +481,7 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { public function test_wc_get_price_thousand_separator() { $separator = get_option( 'woocommerce_price_thousand_sep' ); - // default value + // Default value. $this->assertEquals( ',', wc_get_price_thousand_separator() ); update_option( 'woocommerce_price_thousand_sep', '.' ); @@ -431,7 +501,7 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { public function test_wc_get_price_decimal_separator() { $separator = get_option( 'woocommerce_price_decimal_sep' ); - // default value + // Default value. $this->assertEquals( '.', wc_get_price_decimal_separator() ); update_option( 'woocommerce_price_decimal_sep', ',' ); @@ -451,7 +521,7 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { public function test_wc_get_price_decimals() { $decimals = get_option( 'woocommerce_price_num_decimals' ); - // default value + // Default value. $this->assertEquals( 2, wc_get_price_decimals() ); update_option( 'woocommerce_price_num_decimals', '1' ); @@ -472,31 +542,30 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_price() { - - // common prices + // Common prices. $this->assertEquals( '£1.00', wc_price( 1 ) ); $this->assertEquals( '£1.10', wc_price( 1.1 ) ); $this->assertEquals( '£1.17', wc_price( 1.17 ) ); $this->assertEquals( '£1,111.17', wc_price( 1111.17 ) ); $this->assertEquals( '£0.00', wc_price( 0 ) ); - // different currency + // Different currency. $this->assertEquals( '$1,111.17', wc_price( 1111.17, array( 'currency' => 'USD' ) ) ); - // negative price + // Negative price. $this->assertEquals( '-£1.17', wc_price( -1.17 ) ); - // bogus prices + // Bogus prices. $this->assertEquals( '£0.00', wc_price( null ) ); $this->assertEquals( '£0.00', wc_price( 'Q' ) ); $this->assertEquals( '£0.00', wc_price( 'ಠ_ಠ' ) ); - // trim zeros + // Trim zeros. add_filter( 'woocommerce_price_trim_zeros', '__return_true' ); $this->assertEquals( '£1', wc_price( 1.00 ) ); remove_filter( 'woocommerce_price_trim_zeros', '__return_true' ); - // ex tax label + // Ex tax label. $calc_taxes = get_option( 'woocommerce_calc_taxes' ); update_option( 'woocommerce_calc_taxes', 'yes' ); $this->assertEquals( '£1,111.17 (ex. VAT)', wc_price( '1111.17', array( 'ex_tax_label' => true ) ) ); @@ -509,18 +578,13 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_let_to_num() { - - $sizes = array( - '10K' => 10240, - '10M' => 10485760, - '10G' => 10737418240, - '10T' => 10995116277760, - '10P' => 11258999068426240, - ); - - foreach ( $sizes as $notation => $size ) { - $this->assertEquals( $size, wc_let_to_num( $notation ) ); - } + $this->assertEquals( array( 10240, 10485760, 10737418240, 10995116277760, 11258999068426240 ), array( + wc_let_to_num( '10K' ), + wc_let_to_num( '10M' ), + wc_let_to_num( '10G' ), + wc_let_to_num( '10T' ), + wc_let_to_num( '10P' ), + ) ); } /** @@ -529,7 +593,6 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_date_format() { - $this->assertEquals( get_option( 'date_format' ), wc_date_format() ); } @@ -542,43 +605,72 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { $this->assertEquals( get_option( 'time_format' ), wc_time_format() ); } + /** + * Test wc_string_to_timestamp(). + * + * @since 3.3.0 + */ + public function test_wc_string_to_timestamp() { + $this->assertEquals( 1507075200, wc_string_to_timestamp( '2017-10-04' ) ); + $this->assertEquals( 1507075200, wc_string_to_timestamp( '2017-10-04', strtotime( '3000-10-04' ) ) ); + } + + /** + * Test wc_string_to_datetime(). + * + * @since 3.3.0 + */ + public function test_wc_string_to_datetime() { + $data = wc_string_to_datetime( '2014-10-04' ); + + $this->assertInstanceOf( 'WC_DateTime', $data ); + $this->assertEquals( 1412380800, $data->getTimestamp() ); + } + /** * Test wc_timezone_string(). * * @since 2.2 */ public function test_wc_timezone_string() { - - // test when timezone string exists + // Test when timezone string exists. update_option( 'timezone_string', 'America/New_York' ); $this->assertEquals( 'America/New_York', wc_timezone_string() ); - // restore default + // Restore default. update_option( 'timezone_string', '' ); - // test with missing UTC offset + // Test with missing UTC offset. delete_option( 'gmt_offset' ); $this->assertEquals( 'UTC', wc_timezone_string() ); - // test with manually set UTC offset + // Test with manually set UTC offset. update_option( 'gmt_offset', -4 ); $this->assertNotEquals( 'UTC', wc_timezone_string() ); - // test with invalid offset + // Test with invalid offset. update_option( 'gmt_offset', 99 ); $this->assertEquals( 'UTC', wc_timezone_string() ); - // restore default + // Restore default. update_option( 'gmt_offset', '0' ); } + /** + * Test wc_timezone_offset(). + * + * @since 3.3.0 + */ + public function test_wc_timezone_offset() { + $this->assertEquals( 0.0, wc_timezone_offset() ); + } + /** * Test wc_rgb_from_hex(). * * @since 2.2 */ public function test_wc_rgb_from_hex() { - $rgb = array( 'R' => 0, 'G' => 93, @@ -595,7 +687,6 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_hex_darker() { - $this->assertEquals( '#004178', wc_hex_darker( '005dab' ) ); $this->assertEquals( '#004178', wc_hex_darker( '#005dab' ) ); } @@ -606,7 +697,6 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_hex_lighter() { - $this->assertEquals( '#4d8ec4', wc_hex_lighter( '005dab' ) ); $this->assertEquals( '#4d8ec4', wc_hex_lighter( '#005dab' ) ); $this->assertEquals( '#0c3a3b', wc_hex_lighter( '0a3839', 1 ) ); @@ -618,7 +708,6 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_light_or_dark() { - $this->assertEquals( '#FFFFFF', wc_light_or_dark( '005dab' ) ); $this->assertEquals( '#FFFFFF', wc_light_or_dark( '#005dab' ) ); } @@ -629,7 +718,6 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_format_hex() { - $this->assertEquals( '#CCCCCC', wc_format_hex( 'CCC' ) ); $this->assertEquals( '#CCCCCC', wc_format_hex( '#CCC' ) ); $this->assertEquals( null, wc_format_hex( null ) ); @@ -641,15 +729,29 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_format_postcode() { - - // Generic postcode + // Generic postcode. $this->assertEquals( '02111', wc_format_postcode( ' 02111 ', 'US' ) ); - // US 9-digit postcode + // US 9-digit postcode. $this->assertEquals( '02111-9999', wc_format_postcode( ' 021119999 ', 'US' ) ); - // UK postcode + // UK postcode. $this->assertEquals( 'PCRN 1ZZ', wc_format_postcode( 'pcrn1zz', 'GB' ) ); + + // BR/PL postcode. + $this->assertEquals( '99999-999', wc_format_postcode( '99999999', 'BR' ) ); + + // JP postcode. + $this->assertEquals( '999-9999', wc_format_postcode( '9999999', 'JP' ) ); + } + + /** + * Test wc_normalize_postcode(). + * + * @since 3.3.0 + */ + public function test_wc_normalize_postcode() { + $this->assertEquals( '99999999', wc_normalize_postcode( '99999-999' ) ); } /** @@ -658,8 +760,11 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { * @since 2.2 */ public function test_wc_format_phone_number() { - $this->assertEquals( '1-610-385-0000', wc_format_phone_number( '1.610.385.0000' ) ); + // This number contains non-visible unicode chars at the beginning and end of string, which makes it invalid phone number. + $this->assertEquals( '', wc_format_phone_number( '‭+47 0000 00003‬' ) ); + $this->assertEquals( '27 00 00 0000', wc_format_phone_number( '27 00 00 0000' ) ); + $this->assertEquals( '', wc_format_phone_number( '1-800-not a phone number' ) ); } /** @@ -669,8 +774,227 @@ class WC_Tests_Formatting_Functions extends WC_Unit_Test_Case { */ public function test_wc_trim_string() { $this->assertEquals( 'string', wc_trim_string( 'string' ) ); - $this->assertEquals( 's...', wc_trim_string( 'string', 4 ) ); - $this->assertEquals( 'st.', wc_trim_string( 'string', 3, '.' ) ); + $this->assertEquals( 's...', wc_trim_string( 'string', 4 ) ); + $this->assertEquals( 'st.', wc_trim_string( 'string', 3, '.' ) ); $this->assertEquals( 'string¥', wc_trim_string( 'string¥', 7, '' ) ); } + + /** + * Test wc_format_content(). + * + * @since 3.3.0 + */ + public function test_wc_format_content() { + $this->assertEquals( "

          foo

          \n", wc_format_content( 'foo' ) ); + } + + /** + * Test wc_sanitize_term_text_based(). + * + * @since 3.3.0 + */ + public function test_wc_sanitize_term_text_based() { + $this->assertEquals( 'foo', wc_sanitize_term_text_based( "

          foo

          \n" ) ); + } + + /** + * Test wc_make_numeric_postcode(). + * + * @since 3.3.0 + */ + public function test_wc_make_numeric_postcode() { + $this->assertEquals( '16050300', wc_make_numeric_postcode( 'PE30' ) ); + } + + /** + * Test wc_format_stock_for_display(). + * + * @since 3.3.0 + */ + public function test_wc_format_stock_for_display() { + $product = WC_Helper_Product::create_simple_product(); + + $product->set_stock_quantity( '10' ); + $this->assertEquals( '10 in stock', wc_format_stock_for_display( $product ) ); + + $product->set_stock_quantity( '1' ); + $default = get_option( 'woocommerce_stock_format' ); + update_option( 'woocommerce_stock_format', 'low_amount' ); + $this->assertEquals( 'Only 1 left in stock', wc_format_stock_for_display( $product ) ); + update_option( 'woocommerce_stock_format', $default ); + + $product->set_stock_quantity( '-1' ); + $product->set_manage_stock( true ); + $product->set_backorders( 'notify' ); + $this->assertEquals( '-1 in stock (can be backordered)', wc_format_stock_for_display( $product ) ); + + $product->delete( true ); + } + + /** + * Test wc_format_stock_quantity_for_display(). + * + * @since 3.3.0 + */ + public function test_wc_format_stock_quantity_for_display() { + $product = WC_Helper_Product::create_simple_product(); + + $product->set_stock_quantity( '10' ); + $this->assertEquals( '10', wc_format_stock_quantity_for_display( $product->get_stock_quantity(), $product ) ); + + $product->delete( true ); + } + + /** + * Test wc_format_sale_price(). + * + * @since 3.3.0 + */ + public function test_wc_format_sale_price() { + $this->assertEquals( '£10.00 £5.00', wc_format_sale_price( '10', '5' ) ); + } + + /** + * Test wc_format_price_range(). + * + * @since 3.3.0 + */ + public function test_wc_format_price_range() { + $this->assertEquals( '£10.00 – £5.00', wc_format_price_range( '10', '5' ) ); + } + + /** + * Test wc_format_weight(). + * + * @since 3.3.0 + */ + public function test_wc_format_weight() { + $this->assertEquals( '10 kg', wc_format_weight( '10' ) ); + } + + /** + * Test wc_format_dimensions(). + * + * @since 3.3.0 + */ + public function test_wc_format_dimensions() { + $this->assertEquals( '10 x 10 x 10 cm', wc_format_dimensions( array( 10, 10, 10 ) ) ); + } + + /** + * Test wc_format_datetime(). + * + * @since 3.3.0 + */ + public function test_wc_format_datetime() { + $date = new WC_DateTime( '2017-10-05', new DateTimeZone( 'UTC' ) ); + $this->assertEquals( 'October 5, 2017', wc_format_datetime( $date ) ); + $this->assertEquals( '', wc_format_datetime( 'foo' ) ); + } + + /** + * Test wc_do_oembeds(). + * + * @since 3.3.0 + */ + public function test_wc_do_oembeds() { + // In this case should only return the URL back, since oEmbed will run other actions on frontend. + $this->assertEquals( + "", // phpcs:ignore WordPress.WP.EnqueuedResources.NonEnqueuedScript + wc_do_oembeds( 'https://wordpress.tv/2015/10/19/mike-jolley-user-onboarding-for-wordpress-plugins/' ) + ); + } + + /** + * Provides a mocked response for the oembed test. This way it is not necessary to perform + * a regular request to an external server which would significantly slow down the tests. + * + * This function is called by WP_HTTP_TestCase::http_request_listner(). + * + * @param array $request Request arguments. + * @param string $url URL of the request. + * + * @return array|false mocked response or false to let WP perform a regular request. + */ + protected function mock_http_responses( $request, $url ) { + $mocked_response = false; + + if ( false !== strpos( $url, 'https://wordpress.tv/oembed/' ) ) { + $mocked_response = array( + // phpcs:ignore WordPress.WP.EnqueuedResources.NonEnqueuedScript + 'body' => '{"type":"video","version":"1.0","title":null,"width":500,"height":281,"html":"