update hooks docs

includes/Abstracts/Store.php

@@ -62,6 +62,7 @@ class Store extends \WC_Data {
 	 * Construct the default POS store.
 	 */
 	public function __construct() {
+		parent::__construct();
 		$this->set_wordpress_settings();
 		$this->set_woocommerce_general_settings();
 		$this->set_woocommerce_tax_settings();

includes/Admin.php

@@ -104,8 +104,9 @@ public function admin_menu(): void {
 	 * @param \WP_Screen $current_screen Current screen object.
 	 */
 	public function current_screen( $current_screen ): void {
-				/**
+		/**
 		 * Backwards compatibility for WooCommerce POS Pro 1.4.2 and below.
+		 * DO NOT USE THIS!
 		 *
 		 * @TODO: Remove in WooCommerce POS 2.0.0.
 		 */
@@ -114,6 +115,8 @@ public function current_screen( $current_screen ): void {
 		/**
 		 * Filters the screen handlers for WooCommerce POS admin screens.
 		 *
+		 * @hook woocommerce_pos_admin_screen_handlers
+		 *
 		 * @since 1.4.10
 		 *
 		 * @param array       $handlers       Associative array of screen IDs and their corresponding handlers.

includes/Admin/Notices.php

@@ -44,11 +44,11 @@ public function admin_notices(): void {
 		/**
 		 * Filters the POS admin notices.
 		 *
-		 * @param {array} $notices
+		 * @since 1.0.0
 		 *
-		 * @returns {array} $notices
+		 * @param array $notices
 		 *
-		 * @since 1.0.0
+		 * @return array $notices
 		 *
 		 * @hook woocommerce_pos_admin_notices
 		 */

includes/Services/Settings.php

@@ -205,9 +205,12 @@ public function get_general_settings(): array {
 		/*
 		 * Filters the general settings.
 		 *
-		 * @param {array} $settings
-		 * @returns {array} $settings
 		 * @since 1.0.0
+		 *
+		 * @param array $settings
+		 *
+		 * @return array $settings
+		 *
 		 * @hook woocommerce_pos_general_settings
 		 */
 		return apply_filters( 'woocommerce_pos_general_settings', $settings );

includes/wcpos-functions.php

@@ -157,14 +157,14 @@ function woocommerce_pos_locate_template( $template = '' ) {
 		/*
 		 * Filters the template path.
 		 *
-		 * @param {string} $template
-		 * @param {string} $path
-		 *
-		 * @returns {string} $path
+		 * @hook woocommerce_pos_locate_template
 		 *
 		 * @since 1.0.0
 		 *
-		 * @hook woocommerce_pos_locate_template
+		 * @param string $path   The full path to the template.
+		 * @param string $template The template name, eg: 'receipt.php'.
+		 *
+		 * @return string $path The full path to the template.
 		 */
 		$filtered_path = apply_filters( 'woocommerce_pos_locate_template', $path, $template );