Add var comments to object properties

classes/controllers/FrmFormActionsController.php

@@ -4,6 +4,10 @@
 }
 
 class FrmFormActionsController {
+
+	/**
+	 * @var string
+	 */
 	public static $action_post_type = 'frm_form_actions';
 
 	/**
@@ -779,6 +783,10 @@ public static function prevent_wpml_translations( $null, $post_type ) {
 }
 
 class Frm_Form_Action_Factory {
+
+	/**
+	 * @var array
+	 */
 	public $actions = array();
 
 	public function __construct() {

classes/helpers/FrmEntriesListHelper.php

@@ -5,9 +5,10 @@
 
 class FrmEntriesListHelper extends FrmListHelper {
 
+	/**
+	 * @var string|null
+	 */
 	protected $column_name;
-	protected $item;
-	protected $field;
 
 	/**
 	 * @since 4.07

classes/helpers/FrmFieldGridHelper.php

@@ -5,6 +5,9 @@
 
 class FrmFieldGridHelper {
 
+	/**
+	 * @var bool|string
+	 */
 	private $parent_li;
 
 	/**
@@ -52,6 +55,9 @@ class FrmFieldGridHelper {
 	 */
 	private $section_size;
 
+	/**
+	 * @var bool
+	 */
 	private $section_is_open = false;
 
 	/**

classes/helpers/FrmFormsListHelper.php

@@ -4,6 +4,10 @@
 }
 
 class FrmFormsListHelper extends FrmListHelper {
+
+	/**
+	 * @var string
+	 */
 	public $status = '';
 
 	public $total_items = 0;

classes/helpers/FrmListHelper.php

@@ -79,8 +79,14 @@ class FrmListHelper {
 	 */
 	protected $_column_headers;
 
+	/**
+	 * @var array
+	 */
 	protected $compat_fields = array( '_args', '_pagination_args', 'screen', '_actions', '_pagination' );
 
+	/**
+	 * @var array
+	 */
 	protected $compat_methods = array(
 		'set_pagination_args',
 		'get_views',

classes/helpers/FrmTipsHelper.php

@@ -396,8 +396,12 @@ public static function get_import_tip() {
 	 * @return array
 	 */
 	public static function get_random_tip( $tips ) {
-		$random = random_int( 0, count( $tips ) - 1 );
+		$count = count( $tips );
+		if ( $count === 0 ) {
+			return array();
+		}
 
+		$random = random_int( 0, $count - 1 );
 		return $tips[ $random ];
 	}
 

classes/models/FrmAddon.php

@@ -5,20 +5,80 @@
 
 /** @phpstan-consistent-constructor */
 class FrmAddon {
+
+	/**
+	 * @var string
+	 */
 	public $store_url = 'https://formidableforms.com';
+
+	/**
+	 * @var int|string|null
+	 */
 	public $download_id;
+
+	/**
+	 * @var string|null
+	 */
 	public $plugin_file;
+
+	/**
+	 * @var string
+	 */
 	public $plugin_folder;
+
+	/**
+	 * @var string
+	 */
 	public $plugin_name;
+
+	/**
+	 * @var string
+	 */
 	public $plugin_slug;
+
+	/**
+	 * @var string
+	 */
 	public $option_name;
+
+	/**
+	 * @var string|null
+	 */
 	public $version;
-	public $author            = 'Strategy11';
+
+	/**
+	 * @var string
+	 */
+	public $author = 'Strategy11';
+
+	/**
+	 * @var bool
+	 */
 	public $is_parent_licence = false;
-	public $needs_license     = true;
+
+	/**
+	 * @var bool
+	 */
+	public $needs_license = true;
+
+	/**
+	 * @var bool
+	 */
 	private $is_expired_addon = false;
+
+	/**
+	 * @var string|null
+	 */
 	public $license;
+
+	/**
+	 * @var bool
+	 */
 	protected $get_beta = false;
+
+	/**
+	 * @var array|null
+	 */
 	protected $save_status;
 
 	/**

classes/models/FrmCreateFile.php

@@ -5,13 +5,44 @@
 
 class FrmCreateFile {
 
+	/**
+	 * @var string
+	 */
 	public $folder_name;
+
+	/**
+	 * @var string
+	 */
 	public $file_name;
+
+	/**
+	 * @var string
+	 */
 	public $error_message;
+
+	/**
+	 * @var array
+	 */
 	public $uploads;
+
+	/**
+	 * @var string
+	 */
 	private $new_file_path;
+
+	/**
+	 * @var int
+	 */
 	public $chmod_dir       = 0755;
+
+	/**
+	 * @var int
+	 */
 	public $chmod_file      = 0644;
+
+	/**
+	 * @var bool
+	 */
 	private $has_permission = false;
 
 	/**

classes/models/FrmDb.php

@@ -4,9 +4,33 @@
 }
 
 class FrmDb {
+
+	/**
+	 * The table name for Formidable Fields.
+	 *
+	 * @var string
+	 */
 	public $fields;
+
+	/**
+	 * The table name for Formidable Forms.
+	 *
+	 * @var string
+	 */
 	public $forms;
+
+	/**
+	 * The table name for Formidable Entries.
+	 *
+	 * @var string
+	 */
 	public $entries;
+
+	/**
+	 * The table name for Formidable Entry Metas.
+	 *
+	 * @var string
+	 */
 	public $entry_metas;
 
 	public function __construct() {

classes/models/FrmField.php

@@ -5,7 +5,14 @@
 
 class FrmField {
 
+	/**
+	 * @var bool
+	 */
 	public static $use_cache      = true;
+
+	/**
+	 * @var int
+	 */
 	public static $transient_size = 200;
 
 	/**

classes/models/FrmFieldFormHtml.php

@@ -8,19 +8,34 @@
  */
 class FrmFieldFormHtml {
 
+	/**
+	 * @var string
+	 */
 	private $html;
 
+	/**
+	 * @var string
+	 */
 	private $html_id;
 
 	/**
 	 * @var FrmFieldType
 	 */
 	private $field_obj;
 
+	/**
+	 * @var int|string
+	 */
 	private $field_id;
 
+	/**
+	 * @var array
+	 */
 	private $form = array();
 
+	/**
+	 * @var array
+	 */
 	private $pass_args = array();
 
 	/**

classes/models/FrmFieldTypeOptionData.php

@@ -12,6 +12,9 @@
  */
 class FrmFieldTypeOptionData {
 
+	/**
+	 * @var array
+	 */
 	private static $data = array();
 
 	/**

classes/models/FrmFormMigrator.php

@@ -5,17 +5,49 @@
 
 abstract class FrmFormMigrator {
 
+	/**
+	 * @var bool
+	 */
 	public $source_active;
 
+	/**
+	 * @var string
+	 */
 	public $slug;
+
+	/**
+	 * @var string
+	 */
 	public $path;
+
+	/**
+	 * @var string
+	 */
 	public $name;
 
+	/**
+	 * @var array
+	 */
 	public $response = array();
+
+	/**
+	 * @var string
+	 */
 	public $tracking = 'frm_forms_imported';
 
+	/**
+	 * @var array
+	 */
 	protected $fields_map          = array();
+
+	/**
+	 * @var mixed
+	 */
 	protected $current_source_form;
+
+	/**
+	 * @var array
+	 */
 	protected $current_section     = array();
 
 	/**

classes/models/FrmFormTemplateApi.php

@@ -5,10 +5,19 @@
 
 class FrmFormTemplateApi extends FrmFormApi {
 
+	/**
+	 * @var string
+	 */
 	protected static $code_option_name = 'frm_free_license_code';
 
+	/**
+	 * @var string
+	 */
 	private static $base_api_url = 'https://formidableforms.com/wp-json/form-templates/v1/';
 
+	/**
+	 * @var string|null
+	 */
 	protected static $free_license;
 
 	/**