From 6e8d068bfbf80e943d8e1fd01c735e2597d35d01 Mon Sep 17 00:00:00 2001
From: Niklas Gutberlet <70433191+InpsydeNiklas@users.noreply.github.com>
Date: Wed, 13 Sep 2023 19:29:49 +0200
Subject: [PATCH] Update Package Tracking strings

---
 .../src/MetaBoxRenderer.php                    | 18 ++++++++++++++----
 .../src/OrderTrackingModule.php                |  2 +-
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/modules/ppcp-order-tracking/src/MetaBoxRenderer.php b/modules/ppcp-order-tracking/src/MetaBoxRenderer.php
index d9ce236f7..ccc1118be 100644
--- a/modules/ppcp-order-tracking/src/MetaBoxRenderer.php
+++ b/modules/ppcp-order-tracking/src/MetaBoxRenderer.php
@@ -100,7 +100,7 @@ public function render( $post_or_order_object ): void {
 		?>
 		<div class="ppcp-tracking-columns-wrapper">
 			<div class="ppcp-tracking-column">
-				<h3><?php echo esc_html__( 'Add New Shipment Tracking to PayPal order', 'woocommerce-paypal-payments' ); ?></h3>
+				<h3><?php echo esc_html__( 'Send Package Tracking Data to PayPal', 'woocommerce-paypal-payments' ); ?></h3>
 				<p>
 					<label for="ppcp-tracking-transaction_id"><?php echo esc_html__( 'Transaction ID', 'woocommerce-paypal-payments' ); ?></label>
 					<input type="text" disabled class="ppcp-tracking-transaction_id disabled" id="ppcp-tracking-transaction_id" name="ppcp-tracking[transaction_id]" value="<?php echo esc_attr( $transaction_id ); ?>" />
@@ -155,18 +155,28 @@ public function render( $post_or_order_object ): void {
 					<input type="text" class="ppcp-tracking-carrier_name_other" id="ppcp-tracking-carrier_name_other" name="ppcp-tracking[carrier_name_other]" />
 				</p>
 				<input type="hidden" class="ppcp-tracking-order_id" name="ppcp-tracking[order_id]" value="<?php echo (int) $wc_order->get_id(); ?>"/>
-				<p><button type="button" class="button submit_tracking_info"><?php echo esc_html__( 'Add Shipment', 'woocommerce-paypal-payments' ); ?></button></p>
+				<p><button type="button" class="button submit_tracking_info"><?php echo esc_html__( 'Add Package Tracking', 'woocommerce-paypal-payments' ); ?></button></p>
 			</div>
 			<div class="ppcp-tracking-column shipments">
-				<h3><?php echo esc_html__( 'Shipments', 'woocommerce-paypal-payments' ); ?></h3>
+				<h3><?php echo esc_html__( 'Package Tracking', 'woocommerce-paypal-payments' ); ?></h3>
 				<?php
 				foreach ( $shipments as $shipment ) {
 					$shipment->render( $this->allowed_statuses );
 				}
 				?>
 				<?php if ( empty( $shipments ) ) : ?>
-					<p class="ppcp-tracking-no-shipments"><?php echo esc_html__( 'No PayPal Shipment Tracking added to this order yet. Add new Shipment Tracking or reload the page to refresh', 'woocommerce-paypal-payments' ); ?></p>
+					<?php
+					$documentation_url = 'https://woocommerce.com/document/woocommerce-paypal-payments/#package-tracking';
+					$message = sprintf(
+					/* translators: %1$s: the documentation URL opening HTML tag, %2$s: the link ending HTML tag. */
+						esc_html__( 'No PayPal Package Tracking added to this order yet. Add new Package Tracking or reload the page to refresh. %1$sLearn more%2$s about the benefits of sharing package tracking data with PayPal.', 'woocommerce-paypal-payments' ),
+						'<a href="' . esc_url( $documentation_url ) . '">',
+						'</a>'
+					);
+					?>
+					<p class="ppcp-tracking-no-shipments"><?php echo $message; ?></p>
 				<?php endif; ?>
+
 			</div>
 			<div class="blockUI blockOverlay ppcp-tracking-loader"></div>
 		</div>
diff --git a/modules/ppcp-order-tracking/src/OrderTrackingModule.php b/modules/ppcp-order-tracking/src/OrderTrackingModule.php
index 3bd82700c..94dc1ffd0 100644
--- a/modules/ppcp-order-tracking/src/OrderTrackingModule.php
+++ b/modules/ppcp-order-tracking/src/OrderTrackingModule.php
@@ -99,7 +99,7 @@ function() use ( $meta_box_renderer, $bearer ) {
 
 				add_meta_box(
 					'ppcp_order-tracking',
-					__( 'PayPal Shipment Tracking', 'woocommerce-paypal-payments' ),
+					__( 'PayPal Package Tracking', 'woocommerce-paypal-payments' ),
 					array( $meta_box_renderer, 'render' ),
 					$screen,
 					'normal'