Add missing block comments and type comments

.php-cs-fixer.php

@@ -19,7 +19,6 @@
 	'no_useless_else'                      => true,
 	'no_superfluous_elseif'                => true,
 	'elseif'                               => true,
-	'phpdoc_add_missing_param_annotation'  => true,
 	'no_extra_blank_lines'                 => true,
 	'no_trailing_whitespace'               => true,
 	'no_whitespace_in_blank_line'          => true,

classes/helpers/FrmAppHelper.php

@@ -1167,6 +1167,8 @@ private static function allowed_html( $allowed ) {
 
 	/**
 	 * @since 2.05.03
+	 *
+	 * @return array
 	 */
 	private static function safe_html() {
 		$allow_class = array(

classes/helpers/FrmEntriesListHelper.php

@@ -17,6 +17,9 @@ class FrmEntriesListHelper extends FrmListHelper {
 	 */
 	public $total_items = 0;
 
+	/**
+	 * @param array $args
+	 */
 	public function __construct( $args ) {
 		parent::__construct( $args );
 		$this->screen->set_screen_reader_content(

classes/helpers/FrmFormsListHelper.php

@@ -12,6 +12,9 @@ class FrmFormsListHelper extends FrmListHelper {
 
 	public $total_items = 0;
 
+	/**
+	 * @param array $args
+	 */
 	public function __construct( $args ) {
 		$this->status = self::get_param( array( 'param' => 'form_type' ) );
 

classes/helpers/FrmListHelper.php

@@ -162,6 +162,9 @@ public function ajax_user_can() {
 		return current_user_can( 'administrator' );
 	}
 
+	/**
+	 * @return array
+	 */
 	public function get_columns() {
 		return array();
 	}

classes/models/FrmMigrate.php

@@ -390,6 +390,9 @@ private function migrate_data( $old_db_version ) {
 		}
 	}
 
+	/**
+	 * @return bool
+	 */
 	public function uninstall() {
 		if ( ! current_user_can( 'administrator' ) ) {
 			$frm_settings = FrmAppHelper::get_settings();

classes/models/FrmOnSubmitAction.php

@@ -50,6 +50,9 @@ public function form( $instance, $args = array() ) {
 		include FrmAppHelper::plugin_path() . '/classes/views/frm-form-actions/on_submit_settings.php';
 	}
 
+	/**
+	 * @return array
+	 */
 	public function get_defaults() {
 		return array(
 			'success_action'      => FrmOnSubmitHelper::get_default_action_type(),

classes/models/FrmSpamCheckUseWPComments.php

@@ -13,6 +13,9 @@
 
 class FrmSpamCheckUseWPComments extends FrmSpamCheck {
 
+	/**
+	 * @return bool
+	 */
 	protected function check() {
 		$spam_comments = get_comments(
 			array(

classes/models/FrmSpamCheckWPDisallowedWords.php

@@ -13,6 +13,9 @@
 
 class FrmSpamCheckWPDisallowedWords extends FrmSpamCheck {
 
+	/**
+	 * @return bool
+	 */
 	public function check() {
 		$mod_keys = trim( $this->get_disallowed_words() );
 

classes/models/fields/FrmFieldNumber.php

@@ -59,6 +59,9 @@ protected function add_extra_html_atts( $args, &$input_html ) {
 		$this->add_min_max( $args, $input_html );
 	}
 
+	/**
+	 * @param array $args
+	 */
 	public function validate( $args ) {
 		$errors = array();
 

classes/models/fields/FrmFieldText.php

@@ -39,6 +39,9 @@ protected function field_settings_for_type() {
 		);
 	}
 
+	/**
+	 * @param array $args
+	 */
 	public function validate( $args ) {
 		$errors     = parent::validate( $args );
 		$max_length = intval( FrmField::get_option( $this->field, 'max' ) );

classes/models/fields/FrmFieldUrl.php

@@ -65,6 +65,9 @@ protected function fill_default_atts( &$atts ) {
 		}
 	}
 
+	/**
+	 * @param array $args
+	 */
 	public function validate( $args ) {
 		$value = $args['value'];
 

classes/models/fields/FrmFieldUserID.php

@@ -48,6 +48,9 @@ protected function include_form_builder_file() {
 		return FrmAppHelper::plugin_path() . '/classes/views/frm-fields/back-end/field-user-id.php';
 	}
 
+	/**
+	 * @param array $args
+	 */
 	public function prepare_field_html( $args ) {
 		$args  = $this->fill_display_field_values( $args );
 		$value = $this->get_field_value( $args );
@@ -71,6 +74,11 @@ protected function get_field_value( $args ) {
 		return is_numeric( $this->field['value'] ) || $posted_value || $updating ? $this->field['value'] : $user_ID;
 	}
 
+	/**
+	 * @param array $args
+	 *
+	 * @return array
+	 */
 	public function validate( $args ) {
 		// phpcs:ignore Universal.Operators.StrictComparisons
 		if ( '' == $args['value'] ) {