Infrastructure/11293 phpcs rule fullstop

includes/Core/Admin/Standalone.php

@@ -44,7 +44,7 @@ public function __construct( Context $context ) {
 	}
 
 	/**
-	 * Standalone mode
+	 * Standalone mode.
 	 *
 	 * @since 1.8.0
 	 */

includes/Core/Assets/Assets.php

@@ -892,7 +892,7 @@ private function get_inline_entity_data() {
 	}
 
 	/**
-	 * Gets the inline data specific to the current user
+	 * Gets the inline data specific to the current user.
 	 *
 	 * @since 1.9.0
 	 *
@@ -924,7 +924,7 @@ private function get_inline_user_data() {
 	}
 
 	/**
-	 * Gets the inline dashboard sharing data
+	 * Gets the inline dashboard sharing data.
 	 *
 	 * @since 1.49.0
 	 *

includes/Core/Authentication/Authentication.php

@@ -74,7 +74,7 @@ final class Authentication implements Provides_Feature_Metrics {
 	private $user_options = null;
 
 	/**
-	 * User_Input
+	 * User_Input.
 	 *
 	 * @since 1.90.0
 	 *
@@ -998,7 +998,7 @@ private function inline_js_tracking_data( $data ) {
 	}
 
 	/**
-	 * Add allowed redirect host to safe wp_safe_redirect
+	 * Add allowed redirect host to safe wp_safe_redirect.
 	 *
 	 * @since 1.0.0
 	 *

includes/Core/Authentication/Clients/Client_Factory.php

@@ -142,7 +142,7 @@ private static function get_http_client_config( $config ) {
 		// In our case however, the client is namespaced to be used by Site Kit only.
 		$config['headers']['User-Agent'] = Google_Proxy::get_application_name();
 
-		/** This filter is documented in wp-includes/class-http.php */
+		/** This filter is documented in wp-includes/class-http.php. */
 		$ssl_verify = apply_filters( 'https_ssl_verify', true, null );
 		// If SSL verification is enabled (default) use the SSL certificate bundle included with WP.
 		if ( $ssl_verify ) {

includes/Core/Authentication/Clients/OAuth_Client_Base.php

@@ -48,15 +48,15 @@ abstract class OAuth_Client_Base {
 	protected $context;
 
 	/**
-	 * Options instance
+	 * Options instance.
 	 *
 	 * @since 1.39.0
 	 * @var Options
 	 */
 	protected $options;
 
 	/**
-	 * User_Options instance
+	 * User_Options instance.
 	 *
 	 * @since 1.39.0
 	 * @var User_Options
@@ -179,7 +179,7 @@ public function get_required_scopes() {
 		/**
 		 * Filters the list of required Google OAuth scopes.
 		 *
-		 * See all Google oauth scopes here: https://developers.google.com/identity/protocols/googlescopes
+		 * See all Google oauth scopes here: https://developers.google.com/identity/protocols/googlescopes.
 		 *
 		 * @since 1.39.0
 		 *

includes/Core/Authentication/Credentials.php

@@ -46,7 +46,7 @@ public function get() {
 		 * - In the APIs & Services section, enable the APIs that are used within Site Kit
 		 * - Under 'credentials' either create new oAuth Client ID credentials or use an existing set of credentials
 		 * - Set the authorizes redirect URIs to be the URL to the oAuth callback for Site Kit, eg. https://<domainname>?oauth2callback=1 (this must be public)
-		 * - Click the 'Download JSON' button to download the JSON file that can be copied and pasted into the filter
+		 * - Click the 'Download JSON' button to download the JSON file that can be copied and pasted into the filter.
 		 */
 		$credentials = apply_filters( 'googlesitekit_oauth_secret', '' );
 

includes/Core/Authentication/Setup.php

@@ -325,7 +325,7 @@ public function handle_action_exchange_site_code() {
 	 * Verifies the given nonce for a setup action.
 	 *
 	 * The nonce passed from the proxy will always be the one initially provided to it.
-	 * {@see Google_Proxy::setup_url()}
+	 * {@see Google_Proxy::setup_url()}.
 	 *
 	 * @since 1.48.0
 	 *

includes/Core/CLI/Authentication_CLI_Command.php

@@ -25,6 +25,7 @@
  */
 class Authentication_CLI_Command extends CLI_Command {
 
+	// phpcs:disable PHPCS.Commenting.DocCommentFullStop.MissingFullStop -- Command examples should not include trailing punctuation.
 	/**
 	 * Disconnects a user from Site Kit, removing their relevant user options and revoking their token.
 	 *
@@ -45,6 +46,7 @@ class Authentication_CLI_Command extends CLI_Command {
 	 * @param array $assoc_args Array of associated arguments.
 	 */
 	public function disconnect( $args, $assoc_args ) {
+		// phpcs:enable PHPCS.Commenting.DocCommentFullStop.MissingFullStop
 		$user_id = absint( $assoc_args['id'] );
 
 		$authentication = new Authentication(

includes/Core/CLI/Reset_CLI_Command.php

@@ -23,6 +23,7 @@
  */
 class Reset_CLI_Command extends CLI_Command {
 
+	// phpcs:disable PHPCS.Commenting.DocCommentFullStop.MissingFullStop -- Command examples should not include trailing punctuation.
 	/**
 	 * Deletes options, user stored options, transients and clears object cache for stored options.
 	 *
@@ -43,6 +44,7 @@ class Reset_CLI_Command extends CLI_Command {
 	 * @param array $assoc_args Additional flags.
 	 */
 	public function __invoke( $args, $assoc_args ) {
+		// phpcs:enable PHPCS.Commenting.DocCommentFullStop.MissingFullStop
 		$reset = new Reset( $this->context );
 		$reset->all();
 

includes/Core/Conversion_Tracking/Conversion_Event_Providers/WooCommerce.php

@@ -295,7 +295,7 @@ function () {
 
 	/**
 	 * Returns an array of product data in the required format.
-	 * Adapted from https://github.com/woocommerce/woocommerce-google-analytics-integration
+	 * Adapted from https://github.com/woocommerce/woocommerce-google-analytics-integration.
 	 *
 	 * @since 1.153.0
 	 *
@@ -366,7 +366,7 @@ function ( $attribute, $value ) {
 
 	/**
 	 * Returns an array of order data in the required format.
-	 * Adapted from https://github.com/woocommerce/woocommerce-google-analytics-integration
+	 * Adapted from https://github.com/woocommerce/woocommerce-google-analytics-integration.
 	 *
 	 * @since 1.153.0
 	 *
@@ -581,7 +581,7 @@ protected function get_normalized_phone( $phone, $country ) {
 
 	/**
 	 * Formats a price the same way WooCommerce Blocks does.
-	 * Taken from https://github.com/woocommerce/woocommerce-google-analytics-integration
+	 * Taken from https://github.com/woocommerce/woocommerce-google-analytics-integration.
 	 *
 	 * @since 1.153.0
 	 *

includes/Core/Email_Reporting/Email_Assets.php

@@ -32,7 +32,7 @@ class Email_Assets {
 	 * Asset registry.
 	 *
 	 * Maps asset slugs to their full CDN filenames.
-	 * Format: 'asset-slug' => 'YYYY-MM-DD-asset-slug.ext'
+	 * Format: 'asset-slug' => 'YYYY-MM-DD-asset-slug.ext'.
 	 *
 	 * @since 1.173.0
 	 * @var array

includes/Core/Email_Reporting/Sections_Map.php

@@ -109,7 +109,7 @@ protected function get_dashboard_url() {
 	 * Returns an array describing the layout sections, where each section contains:
 	 * - title: The section heading
 	 * - icon: Icon identifier for the section
-	 * - section_parts: Array of template parts with their data
+	 * - section_parts: Array of template parts with their data.
 	 *
 	 * @since 1.168.0
 	 *

includes/Core/Modules/Module_With_Debug_Fields.php

@@ -13,7 +13,7 @@
 namespace Google\Site_Kit\Core\Modules;
 
 /**
- * Interface Module_With_Debug_Fields
+ * Interface Module_With_Debug_Fields.
  *
  * @since 1.5.0
  */

includes/Core/Modules/Modules.php

@@ -929,7 +929,7 @@ public function list_shared_modules() {
 	 * - No user is identified by its owner ID
 	 * - the owner lacks the capability to authenticate
 	 * - the owner is no longer authenticated
-	 * - no user exists for the owner ID
+	 * - no user exists for the owner ID.
 	 *
 	 * @since 1.69.0
 	 *

includes/Core/REST_API/Data_Request.php

@@ -13,7 +13,7 @@
 namespace Google\Site_Kit\Core\REST_API;
 
 /**
- * Class Data_Request
+ * Class Data_Request.
  *
  * @since 1.0.0
  *

includes/Core/Util/Entity_Factory.php

@@ -532,12 +532,12 @@ private static function maybe_convert_to_amp_entity( $url, $entity ) {
 		if ( ! empty( $url_parts['path'] ) ) {
 			// We need to correctly add trailing slash if the original url had trailing slash.
 			// That's the reason why we need to check for both version.
-			if ( '/amp' === substr( $url_parts['path'], -4 ) ) { // -strlen('/amp') is -4
+			if ( '/amp' === substr( $url_parts['path'], -4 ) ) { // -strlen('/amp') is -4.
 				$new_url = untrailingslashit( $current_url ) . '/amp';
 				return self::convert_to_amp_entity( $new_url, $entity );
 			}
 
-			if ( '/amp/' === substr( $url_parts['path'], -5 ) ) { // -strlen('/amp/') is -5
+			if ( '/amp/' === substr( $url_parts['path'], -5 ) ) { // -strlen('/amp/') is -5.
 				$new_url = untrailingslashit( $current_url ) . '/amp/';
 				return self::convert_to_amp_entity( $new_url, $entity );
 			}
@@ -586,7 +586,7 @@ private static function get_query_pagenum( $query, $query_var = 'paged' ) {
 	 * Paginates an entity URL.
 	 *
 	 * Logic extracted from `paginate_links` in WordPress core.
-	 * https://github.com/WordPress/WordPress/blob/7f5d7f1b56087c3eb718da4bd81deb06e077bbbb/wp-includes/general-template.php#L4203
+	 * https://github.com/WordPress/WordPress/blob/7f5d7f1b56087c3eb718da4bd81deb06e077bbbb/wp-includes/general-template.php#L4203.
 	 *
 	 * @since 1.68.0
 	 *
@@ -646,7 +646,7 @@ private static function paginate_entity_url( $url, $pagenum ) {
 	 * Paginates a post URL.
 	 *
 	 * Logic extracted from `_wp_link_page` in WordPress core.
-	 * https://github.com/WordPress/WordPress/blob/7f5d7f1b56087c3eb718da4bd81deb06e077bbbb/wp-includes/post-template.php#L1031
+	 * https://github.com/WordPress/WordPress/blob/7f5d7f1b56087c3eb718da4bd81deb06e077bbbb/wp-includes/post-template.php#L1031.
 	 *
 	 * @since 1.68.0
 	 *

includes/Core/Util/Google_Icon.php

@@ -11,7 +11,7 @@
 namespace Google\Site_Kit\Core\Util;
 
 /**
- * Class for the Google SVG Icon
+ * Class for the Google SVG Icon.
  *
  * @since 1.28.0
  * @access private

includes/Core/Util/Migration_1_123_0.php

@@ -18,7 +18,7 @@
 use Google\Site_Kit\Modules\Analytics_4\Settings as Analytics_Settings;
 
 /**
- * Class Migration_1_123_0
+ * Class Migration_1_123_0.
  *
  * @since 1.123.0
  * @access private

includes/Core/Util/Migration_1_129_0.php

@@ -18,7 +18,7 @@
 use Google\Site_Kit\Modules\Ads\Settings as Ads_Settings;
 
 /**
- * Class Migration_1_129_0
+ * Class Migration_1_129_0.
  *
  * @since 1.129.0
  * @access private

includes/Core/Util/Migration_1_150_0.php

@@ -16,7 +16,7 @@
 use Google\Site_Kit\Modules\Analytics_4\Audience_Settings;
 
 /**
- * Class Migration_1_150_0
+ * Class Migration_1_150_0.
  *
  * @since 1.151.0
  * @access private

includes/Core/Util/Migration_1_163_0.php

@@ -15,7 +15,7 @@
 use Google\Site_Kit\Modules\Sign_In_With_Google\Settings as Sign_In_With_Google_Settings;
 
 /**
- * Class Migration_1_163_0
+ * Class Migration_1_163_0.
  *
  * @since 1.163.0
  * @access private

includes/Core/Util/Migration_1_177_0.php

@@ -15,7 +15,7 @@
 use Google\Site_Kit\Modules\Reader_Revenue_Manager\Settings as Reader_Revenue_Manager_Settings;
 
 /**
- * Class Migration_1_177_0
+ * Class Migration_1_177_0.
  *
  * @since 1.177.0
  * @access private

includes/Core/Util/Migration_1_3_0.php

@@ -17,7 +17,7 @@
 use Google\Site_Kit\Core\Tracking\Tracking_Consent;
 
 /**
- * Class Migration_1_3_0
+ * Class Migration_1_3_0.
  *
  * @since 1.3.0
  * @access private

includes/Core/Util/Migration_1_8_1.php

@@ -23,7 +23,7 @@
 use WP_Error;
 
 /**
- * Class Migration_1_8_1
+ * Class Migration_1_8_1.
  *
  * @since 1.8.1
  * @access private

includes/Core/Util/URL.php

@@ -132,7 +132,7 @@ function ( $urls, $host ) use ( $path ) {
 	 * Returns a list of hostnames that includes:
 	 * - (if IDN) in Punycode encoding
 	 * - (if IDN) in Unicode encoding
-	 * - with and without www. subdomain (including IDNs)
+	 * - with and without www. subdomain (including IDNs).
 	 *
 	 * @since 1.99.0
 	 *

includes/Modules/AdSense/AMP_Tag.php

@@ -152,7 +152,7 @@ private function amp_content_add_auto_ads( $content ) {
 	}
 
 	/**
-	 * Set Web Story Ad Slot ID
+	 * Set Web Story Ad Slot ID.
 	 *
 	 * @since 1.27.0
 	 *

includes/Modules/Analytics_4/Report/ReportParsers.php

@@ -19,7 +19,7 @@
 use Google\Site_Kit_Dependencies\Google\Service\AnalyticsData\OrderBy as Google_Service_AnalyticsData_OrderBy;
 
 /**
- * A class with helper methods to parse report properties
+ * A class with helper methods to parse report properties.
  *
  * @since 1.130.0
  * @access private

includes/Modules/Sign_In_With_Google/Authenticator.php

@@ -160,7 +160,7 @@ protected function get_redirect_url( $user, $input ) {
 			$redirect_to = preg_replace( '|^http://|', 'https://', $redirect_to );
 		}
 
-		/** This filter is documented in wp-login.php */
+		/** This filter is documented in wp-login.php. */
 		$redirect_to = apply_filters( 'login_redirect', $redirect_to, $redirect_to, $user );
 
 		if ( ( empty( $redirect_to ) || 'wp-admin/' === $redirect_to || admin_url() === $redirect_to ) ) {