Fix PHPCS findings: docblock cleanup, →$instance, index.php

Author: ali7ali

include/class-alpha-google-map-widget.php

@@ -1119,8 +1119,8 @@ protected function render() {
 						// Sanitize IDs.
 						$gallery_ids = ! empty( $pin['pin_desc_gallery'] ) && is_array( $pin['pin_desc_gallery'] ) ? $pin['pin_desc_gallery'] : array();
 						$ids         = array_map( 'intval', wp_list_pluck( $gallery_ids, 'id' ) );
-						$count      = count( $ids );
-						$data_count = max( 0, $count - 4 );
+						$count       = count( $ids );
+						$data_count  = max( 0, $count - 4 );
 						$this->add_render_attribute( 'shortcode' . $index, 'ids', implode( ',', $ids ) );
 
 						?>

include/class-alpha-google-map.php

@@ -23,55 +23,44 @@ final class Alpha_Google_Map {
 	/**
 	 * Minimum Elementor Version
 	 *
-	 * @since 1.0.0
 	 * @var   string Minimum Elementor version required to run the addon.
 	 */
 	const MINIMUM_ELEMENTOR_VERSION = '3.21.0';
 
 	/**
 	 * Minimum PHP Version
 	 *
-	 * @since 1.0.0
 	 * @var   string Minimum PHP version required to run the addon.
 	 */
 	const MINIMUM_PHP_VERSION = '7.4';
 
 	/**
 	 * Instance
 	 *
-	 * @since  1.0.0
-	 * @access private
-	 * @static
 	 * @var    \Elementor_Alpha_Google_Map_Addon\Alpha_Google_Map The single instance of the class.
 	 */
-	private static $_instance = null;
+	private static $instance = null;
 
 	/**
 	 * Instance
 	 *
 	 * Ensures only one instance of the class is loaded or can be loaded.
 	 *
-	 * @since  1.0.0
-	 * @access public
-	 * @static
 	 * @return \Elementor_Alpha_Google_Map_Addon\Alpha_Google_Map An instance of the class.
 	 */
 	public static function instance(): self {
 
-		if ( is_null( self::$_instance ) ) {
-			self::$_instance = new self();
+		if ( is_null( self::$instance ) ) {
+			self::$instance = new self();
 		}
-		return self::$_instance;
+		return self::$instance;
 	}
 
 	/**
 	 * Constructor
 	 *
 	 * Perform some compatibility checks to make sure basic requirements are meet.
 	 * If all compatibility checks pass, initialize the functionality.
-	 *
-	 * @since  1.0.0
-	 * @access private
 	 */
 	private function __construct() {
 		if ( $this->is_compatible() ) {
@@ -83,9 +72,6 @@ private function __construct() {
 	 * Compatibility Checks
 	 *
 	 * Checks whether the site meets the addon requirement.
-	 *
-	 * @since  1.0.0
-	 * @access public
 	 */
 	public function is_compatible(): bool {
 
@@ -137,9 +123,6 @@ public function register_frontend_styles(): void {
 	 * Admin notice
 	 *
 	 * Warning when the site doesn't have Elementor installed or activated.
-	 *
-	 * @since  1.0.0
-	 * @access public
 	 */
 	public function admin_notice_missing_main_plugin(): void {
 		$message = sprintf(
@@ -184,9 +167,6 @@ public function admin_notice_missing_main_plugin(): void {
 	 * Admin notice
 	 *
 	 * Warning when the site doesn't have a minimum required Elementor version.
-	 *
-	 * @since  1.0.0
-	 * @access public
 	 */
 	public function admin_notice_minimum_elementor_version(): void {
 		$message = sprintf(
@@ -215,9 +195,6 @@ public function admin_notice_minimum_elementor_version(): void {
 	 * Admin notice
 	 *
 	 * Warning when the site doesn't have a minimum required PHP version.
-	 *
-	 * @since  1.0.0
-	 * @access public
 	 */
 	public function admin_notice_minimum_php_version(): void {
 		$message = sprintf(

index.php

@@ -1,2 +1,2 @@
 <?php
-// Silence is golden.
+/** Silence is golden. */

phpcs.xml.dist

@@ -20,5 +20,6 @@
 		<exclude name="WordPress.NamingConventions.ValidVariableName" />
 		<exclude name="Squiz.Commenting.FileComment.Missing" />
 		<exclude name="Squiz.Commenting.FileComment.MissingPackageTag" />
+		<exclude name="WordPress.Files.FileName.InvalidClassFileName" />
 	</rule>
 </ruleset>