eventespresso / event-espresso-core

core/db_models/EEM_Form_Input.model.php

Indentation +216 added lines, -216 removed lines

@@ -35,233 +35,233 @@
 class EEM_Form_Input extends EEM_Form_Element
 {
 
-    /**
-     * @var EEM_Form_Input
-     */
-    protected static $_instance;
+	/**
+	 * @var EEM_Form_Input
+	 */
+	protected static $_instance;
 
-    /**
-     * @var RequestInterface
-     */
-    private $request;
+	/**
+	 * @var RequestInterface
+	 */
+	private $request;
 
-    /**
-     * @var array
-     */
-    private $input_types;
+	/**
+	 * @var array
+	 */
+	private $input_types;
 
 
-    protected function __construct(Element $element, InputTypes $input_types, $timezone = null)
-    {
-        $this->input_types = $input_types;
-        $this->singular_item = esc_html__('Form Input', 'event_espresso');
-        $this->plural_item   = esc_html__('Form Inputs', 'event_espresso');
+	protected function __construct(Element $element, InputTypes $input_types, $timezone = null)
+	{
+		$this->input_types = $input_types;
+		$this->singular_item = esc_html__('Form Input', 'event_espresso');
+		$this->plural_item   = esc_html__('Form Inputs', 'event_espresso');
 
-        $this->_tables          = [
-            'Form_Input' => new EE_Primary_Table('esp_form_input', 'FIN_ID'),
-        ];
-        $this->_fields          = [
-            'Form_Input' => [
-                'FIN_ID'        => new EE_Integer_Field(
-                    'FIN_ID',
-                    esc_html__('Form Input ID (autoincrement db id)', 'event_espresso'),
-                    false
-                ),
-                'FIN_UUID'      => new EE_Primary_Key_String_Field(
-                    'FIN_UUID',
-                    esc_html__('Form Input UUID (universally unique identifier)', 'event_espresso')
-                ),
-                'FIN_adminLabel' => new EE_Plain_Text_Field(
-                    'FIN_adminLabel',
-                    esc_html__(
-                        'Input label displayed in the admin to help differentiate input from others.',
-                        'event_espresso'
-                    ),
-                    true,
-                    null
-                ),
-                'FIN_adminOnly' => new EE_Boolean_Field(
-                    'FIN_adminOnly',
-                    esc_html__(
-                        'Whether or not input is only displayed in the admin. If false, input will appear in public forms',
-                        'event_espresso'
-                    ),
-                    false,
-                    false
-                ),
-                'FIN_belongsTo' => new EE_Foreign_Key_String_Field(
-                    'FIN_belongsTo',
-                    esc_html__('UUID of parent form section this form input belongs to.', 'event_espresso'),
-                    true,
-                    null,
-                    ['Form_Section']
-                ),
-                'FIN_helpClass' => new EE_Plain_Text_Field(
-                    'FIN_helpClass',
-                    esc_html__('Custom HTML classes to be applied to this form input\'s help text.', 'event_espresso'),
-                    true,
-                    null
-                ),
-                'FIN_helpText' => new EE_Plain_Text_Field(
-                    'FIN_helpText',
-                    esc_html__(
-                        'Additional text displayed alongside a form input to assist users with completing the form.',
-                        'event_espresso'
-                    ),
-                    true,
-                    null
-                ),
-                'FIN_htmlClass' => new EE_Plain_Text_Field(
-                    'FIN_htmlClass',
-                    esc_html__('HTML classes to be applied to this form input\'s container.', 'event_espresso'),
-                    true,
-                    null
-                ),
-                'FIN_max'     => new EE_Integer_Field(
-                    'FIN_max',
-                    esc_html__(
-                        'Maximum numeric value or maximum characters allowed for form input answer.',
-                        'event_espresso'
-                    ),
-                    false,
-                    EE_INF
-                ),
-                'FIN_min'     => new EE_Integer_Field(
-                    'FIN_min',
-                    esc_html__(
-                        'Minimum numeric value or minimum characters allowed for form input answer.',
-                        'event_espresso'
-                    ),
-                    true,
-                    null
-                ),
-                'FIN_order'     => new EE_Integer_Field(
-                    'FIN_order',
-                    esc_html__('Order in which form input appears in a form.', 'event_espresso'),
-                    false,
-                    0
-                ),
-                'FIN_placeholder' => new EE_Plain_Text_Field(
-                    'FIN_placeholder',
-                    esc_html__(
-                        'Example text displayed within an input to assist users with completing the form.',
-                        'event_espresso'
-                    ),
-                    true,
-                    null
-                ),
-                'FIN_publicLabel' => new EE_Plain_Text_Field(
-                    'FIN_publicLabel',
-                    esc_html__('Input label displayed on public forms, ie: the actual question text.', 'event_espresso'),
-                    true,
-                    null
-                ),
-                'FIN_required' => new EE_Boolean_Field(
-                    'FIN_required',
-                    esc_html__(
-                        'Whether or not the input must be supplied with a value in order to complete the form.',
-                        'event_espresso'
-                    ),
-                    false,
-                    false
-                ),
-                'FIN_requiredText' => new EE_Plain_Text_Field(
-                    'FIN_requiredText',
-                    esc_html__(
-                        'Custom validation text displayed alongside a required form input to assist users with completing the form.',
-                        'event_espresso'
-                    ),
-                    true,
-                    null
-                ),
-                'FIN_status'    => new EE_Enum_Text_Field(
-                    'FIN_status',
-                    esc_html__(
-                        'Whether form input is active, archived, trashed, or used as a default on new forms. Values correspond to the EEM_Form_Input::STATUS_* constants.',
-                        'event_espresso'
-                    ),
-                    false,
-                    Element::STATUS_ACTIVE,
-                    $element->validStatusOptions()
-                ),
-                'FIN_type'    => new EE_Enum_Text_Field(
-                    'FIN_type',
-                    esc_html__(
-                        'Form input type. Values correspond to the EventEspresso\core\domain\entities\form\Input::TYPE_* constants.',
-                        'event_espresso'
-                    ),
-                    false,
-                    Text::TYPE_TEXT,
-                    $this->validTypeOptions()
-                ),
-                'FIN_wpUser'    => new EE_WP_User_Field(
-                    'FIN_wpUser',
-                    esc_html__('ID of the WP User that created this form input.', 'event_espresso'),
-                    false
-                ),
-            ],
-        ];
-        $this->_model_relations = [];
-        $this->_model_relations['Form_Section'] = new EE_Belongs_To_Any_Relation();
-        // this model is generally available for reading
-        $restrictions                              = [];
-        $restrictions[ EEM_Base::caps_read ]       = new EE_Restriction_Generator_Public();
-        $restrictions[ EEM_Base::caps_read_admin ] = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
-        $restrictions[ EEM_Base::caps_edit ]       = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
-        $restrictions[ EEM_Base::caps_delete ]     = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
-        $this->_cap_restriction_generators         = $restrictions;
-        parent::__construct($element, $timezone);
-        $this->request = $this->getLoader()->getShared('EventEspresso\core\services\request\RequestInterface');
-    }
+		$this->_tables          = [
+			'Form_Input' => new EE_Primary_Table('esp_form_input', 'FIN_ID'),
+		];
+		$this->_fields          = [
+			'Form_Input' => [
+				'FIN_ID'        => new EE_Integer_Field(
+					'FIN_ID',
+					esc_html__('Form Input ID (autoincrement db id)', 'event_espresso'),
+					false
+				),
+				'FIN_UUID'      => new EE_Primary_Key_String_Field(
+					'FIN_UUID',
+					esc_html__('Form Input UUID (universally unique identifier)', 'event_espresso')
+				),
+				'FIN_adminLabel' => new EE_Plain_Text_Field(
+					'FIN_adminLabel',
+					esc_html__(
+						'Input label displayed in the admin to help differentiate input from others.',
+						'event_espresso'
+					),
+					true,
+					null
+				),
+				'FIN_adminOnly' => new EE_Boolean_Field(
+					'FIN_adminOnly',
+					esc_html__(
+						'Whether or not input is only displayed in the admin. If false, input will appear in public forms',
+						'event_espresso'
+					),
+					false,
+					false
+				),
+				'FIN_belongsTo' => new EE_Foreign_Key_String_Field(
+					'FIN_belongsTo',
+					esc_html__('UUID of parent form section this form input belongs to.', 'event_espresso'),
+					true,
+					null,
+					['Form_Section']
+				),
+				'FIN_helpClass' => new EE_Plain_Text_Field(
+					'FIN_helpClass',
+					esc_html__('Custom HTML classes to be applied to this form input\'s help text.', 'event_espresso'),
+					true,
+					null
+				),
+				'FIN_helpText' => new EE_Plain_Text_Field(
+					'FIN_helpText',
+					esc_html__(
+						'Additional text displayed alongside a form input to assist users with completing the form.',
+						'event_espresso'
+					),
+					true,
+					null
+				),
+				'FIN_htmlClass' => new EE_Plain_Text_Field(
+					'FIN_htmlClass',
+					esc_html__('HTML classes to be applied to this form input\'s container.', 'event_espresso'),
+					true,
+					null
+				),
+				'FIN_max'     => new EE_Integer_Field(
+					'FIN_max',
+					esc_html__(
+						'Maximum numeric value or maximum characters allowed for form input answer.',
+						'event_espresso'
+					),
+					false,
+					EE_INF
+				),
+				'FIN_min'     => new EE_Integer_Field(
+					'FIN_min',
+					esc_html__(
+						'Minimum numeric value or minimum characters allowed for form input answer.',
+						'event_espresso'
+					),
+					true,
+					null
+				),
+				'FIN_order'     => new EE_Integer_Field(
+					'FIN_order',
+					esc_html__('Order in which form input appears in a form.', 'event_espresso'),
+					false,
+					0
+				),
+				'FIN_placeholder' => new EE_Plain_Text_Field(
+					'FIN_placeholder',
+					esc_html__(
+						'Example text displayed within an input to assist users with completing the form.',
+						'event_espresso'
+					),
+					true,
+					null
+				),
+				'FIN_publicLabel' => new EE_Plain_Text_Field(
+					'FIN_publicLabel',
+					esc_html__('Input label displayed on public forms, ie: the actual question text.', 'event_espresso'),
+					true,
+					null
+				),
+				'FIN_required' => new EE_Boolean_Field(
+					'FIN_required',
+					esc_html__(
+						'Whether or not the input must be supplied with a value in order to complete the form.',
+						'event_espresso'
+					),
+					false,
+					false
+				),
+				'FIN_requiredText' => new EE_Plain_Text_Field(
+					'FIN_requiredText',
+					esc_html__(
+						'Custom validation text displayed alongside a required form input to assist users with completing the form.',
+						'event_espresso'
+					),
+					true,
+					null
+				),
+				'FIN_status'    => new EE_Enum_Text_Field(
+					'FIN_status',
+					esc_html__(
+						'Whether form input is active, archived, trashed, or used as a default on new forms. Values correspond to the EEM_Form_Input::STATUS_* constants.',
+						'event_espresso'
+					),
+					false,
+					Element::STATUS_ACTIVE,
+					$element->validStatusOptions()
+				),
+				'FIN_type'    => new EE_Enum_Text_Field(
+					'FIN_type',
+					esc_html__(
+						'Form input type. Values correspond to the EventEspresso\core\domain\entities\form\Input::TYPE_* constants.',
+						'event_espresso'
+					),
+					false,
+					Text::TYPE_TEXT,
+					$this->validTypeOptions()
+				),
+				'FIN_wpUser'    => new EE_WP_User_Field(
+					'FIN_wpUser',
+					esc_html__('ID of the WP User that created this form input.', 'event_espresso'),
+					false
+				),
+			],
+		];
+		$this->_model_relations = [];
+		$this->_model_relations['Form_Section'] = new EE_Belongs_To_Any_Relation();
+		// this model is generally available for reading
+		$restrictions                              = [];
+		$restrictions[ EEM_Base::caps_read ]       = new EE_Restriction_Generator_Public();
+		$restrictions[ EEM_Base::caps_read_admin ] = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
+		$restrictions[ EEM_Base::caps_edit ]       = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
+		$restrictions[ EEM_Base::caps_delete ]     = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
+		$this->_cap_restriction_generators         = $restrictions;
+		parent::__construct($element, $timezone);
+		$this->request = $this->getLoader()->getShared('EventEspresso\core\services\request\RequestInterface');
+	}
 
 
-    /**
-     * @param bool $constants_only
-     * @return array
-     */
-    public function validTypeOptions(bool $constants_only = false): array
-    {
-        return $this->input_types->validTypeOptions($constants_only);
-    }
+	/**
+	 * @param bool $constants_only
+	 * @return array
+	 */
+	public function validTypeOptions(bool $constants_only = false): array
+	{
+		return $this->input_types->validTypeOptions($constants_only);
+	}
 
 
-    /**
-     * @return EE_Form_Input[]
-     * @throws EE_Error
-     */
-    public function getFormInputsForSection(string $relation, string $related_UUID): array
-    {
-        $where_params = [$relation => $related_UUID];
-        $query_params = $this->addDefaultWhereConditions([$where_params]);
-        $query_params = $this->addOrderByQueryParams($query_params);
-        return $this->get_all($query_params);
-    }
+	/**
+	 * @return EE_Form_Input[]
+	 * @throws EE_Error
+	 */
+	public function getFormInputsForSection(string $relation, string $related_UUID): array
+	{
+		$where_params = [$relation => $related_UUID];
+		$query_params = $this->addDefaultWhereConditions([$where_params]);
+		$query_params = $this->addOrderByQueryParams($query_params);
+		return $this->get_all($query_params);
+	}
 
 
-    /**
-     * @param array $query_params
-     * @return array
-     */
-    private function addDefaultWhereConditions(array $query_params): array
-    {
-        // might need to add a way to identify GQL requests for admin domains
-        $admin_request                            = $this->request->isAdmin() || $this->request->isAdminAjax();
-        $query_params['default_where_conditions'] = $admin_request
-            ? EEM_Base::default_where_conditions_none
-            : EEM_Base::default_where_conditions_all;
-        return $query_params;
-    }
+	/**
+	 * @param array $query_params
+	 * @return array
+	 */
+	private function addDefaultWhereConditions(array $query_params): array
+	{
+		// might need to add a way to identify GQL requests for admin domains
+		$admin_request                            = $this->request->isAdmin() || $this->request->isAdminAjax();
+		$query_params['default_where_conditions'] = $admin_request
+			? EEM_Base::default_where_conditions_none
+			: EEM_Base::default_where_conditions_all;
+		return $query_params;
+	}
 
 
-    /**
-     * form inputs should always be sorted in ascending order via the FIN_order field
-     *
-     * @param array $query_params
-     * @return array
-     */
-    private function addOrderByQueryParams(array $query_params): array
-    {
-        $query_params['order_by'] = ['FIN_order' => 'ASC'];
-        return $query_params;
-    }
+	/**
+	 * form inputs should always be sorted in ascending order via the FIN_order field
+	 *
+	 * @param array $query_params
+	 * @return array
+	 */
+	private function addOrderByQueryParams(array $query_params): array
+	{
+		$query_params['order_by'] = ['FIN_order' => 'ASC'];
+		return $query_params;
+	}
 }

Spacing +4 added lines, -4 removed lines

@@ -205,10 +205,10 @@
         $this->_model_relations['Form_Section'] = new EE_Belongs_To_Any_Relation();
         // this model is generally available for reading
         $restrictions                              = [];
-        $restrictions[ EEM_Base::caps_read ]       = new EE_Restriction_Generator_Public();
-        $restrictions[ EEM_Base::caps_read_admin ] = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
-        $restrictions[ EEM_Base::caps_edit ]       = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
-        $restrictions[ EEM_Base::caps_delete ]     = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
+        $restrictions[EEM_Base::caps_read]       = new EE_Restriction_Generator_Public();
+        $restrictions[EEM_Base::caps_read_admin] = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
+        $restrictions[EEM_Base::caps_edit]       = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
+        $restrictions[EEM_Base::caps_delete]     = new EE_Restriction_Generator_Reg_Form('FIN_applies_to');
         $this->_cap_restriction_generators         = $restrictions;
         parent::__construct($element, $timezone);
         $this->request = $this->getLoader()->getShared('EventEspresso\core\services\request\RequestInterface');

core/db_models/EEM_WP_User.model.php

Indentation +122 added lines, -122 removed lines

@@ -13,132 +13,132 @@
 class EEM_WP_User extends EEM_Base
 {
 
-    /**
-     * private instance of the EEM_WP_User object
-     *
-     * @type EEM_WP_User
-     */
-    protected static $_instance;
+	/**
+	 * private instance of the EEM_WP_User object
+	 *
+	 * @type EEM_WP_User
+	 */
+	protected static $_instance;
 
 
-    /**
-     *    constructor
-     *
-     * @param null              $timezone
-     * @param ModelFieldFactory $model_field_factory
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     */
-    protected function __construct($timezone = null, ModelFieldFactory $model_field_factory)
-    {
-        $this->singular_item = esc_html__('WP_User', 'event_espresso');
-        $this->plural_item = esc_html__('WP_Users', 'event_espresso');
-        global $wpdb;
-        $this->_tables = array(
-            'WP_User' => new EE_Primary_Table($wpdb->users, 'ID', true),
-        );
-        $this->_fields = array(
-            'WP_User' => array(
-                'ID'                  => $model_field_factory->createPrimaryKeyIntField(
-                    'ID',
-                    esc_html__('WP_User ID', 'event_espresso')
-                ),
-                'user_login'          => $model_field_factory->createPlainTextField(
-                    'user_login',
-                    esc_html__('User Login', 'event_espresso'),
-                    false
-                ),
-                'user_pass'           => $model_field_factory->createPlainTextField(
-                    'user_pass',
-                    esc_html__('User Password', 'event_espresso'),
-                    false
-                ),
-                'user_nicename'       => $model_field_factory->createPlainTextField(
-                    'user_nicename',
-                    esc_html__(' User Nice Name', 'event_espresso'),
-                    false
-                ),
-                'user_email'          => $model_field_factory->createEmailField(
-                    'user_email',
-                    esc_html__('User Email', 'event_espresso'),
-                    false
-                ),
-                'user_registered'     => $model_field_factory->createDatetimeField(
-                    'user_registered',
-                    esc_html__('Date User Registered', 'event_espresso'),
-                    $timezone
-                ),
-                'user_activation_key' => $model_field_factory->createPlainTextField(
-                    'user_activation_key',
-                    esc_html__('User Activation Key', 'event_espresso'),
-                    false
-                ),
-                'user_status'         => $model_field_factory->createIntegerField(
-                    'user_status',
-                    esc_html__('User Status', 'event_espresso')
-                ),
-                'display_name'        => $model_field_factory->createPlainTextField(
-                    'display_name',
-                    esc_html__('Display Name', 'event_espresso'),
-                    false
-                ),
-            ),
-        );
-        $this->_model_relations = array(
-            'Attendee'       => new EE_Has_Many_Relation(),
-            // all models are related to the change log
-            // 'Change_Log'     => new EE_Has_Many_Relation(),
-            'Event'          => new EE_Has_Many_Relation(),
-            'Message'        => new EE_Has_Many_Relation(),
-            'Payment_Method' => new EE_Has_Many_Relation(),
-            'Price'          => new EE_Has_Many_Relation(),
-            'Price_Type'     => new EE_Has_Many_Relation(),
-            'Question'       => new EE_Has_Many_Relation(),
-            'Question_Group' => new EE_Has_Many_Relation(),
-            'Ticket'         => new EE_Has_Many_Relation(),
-            'Venue'          => new EE_Has_Many_Relation(),
-        );
-        $this->foreign_key_aliases = [
-            'Event.EVT_wp_user'          => 'WP_User.ID',
-            'Payment_Method.PMD_wp_user' => 'WP_User.ID',
-            'Price.PRC_wp_user'          => 'WP_User.ID',
-            'Price_Type.PRT_wp_user'     => 'WP_User.ID',
-            'Question.QST_wp_user'       => 'WP_User.ID',
-            'Question_Group.QSG_wp_user' => 'WP_User.ID',
-            'Ticket.VNU_wp_user'         => 'WP_User.ID',
-            'Venue.TKT_wp_user'          => 'WP_User.ID',
-        ];
-        $this->_wp_core_model = true;
-        $this->_caps_slug = 'users';
-        $this->_cap_contexts_to_cap_action_map[ EEM_Base::caps_read ] = 'list';
-        $this->_cap_contexts_to_cap_action_map[ EEM_Base::caps_read_admin ] = 'list';
-        foreach ($this->_cap_contexts_to_cap_action_map as $context => $action) {
-            $this->_cap_restriction_generators[ $context ] = new EE_Restriction_Generator_WP_User();
-        }
-        // @todo: account for create_users controls whether they can create users at all
-        parent::__construct($timezone);
-    }
+	/**
+	 *    constructor
+	 *
+	 * @param null              $timezone
+	 * @param ModelFieldFactory $model_field_factory
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 */
+	protected function __construct($timezone = null, ModelFieldFactory $model_field_factory)
+	{
+		$this->singular_item = esc_html__('WP_User', 'event_espresso');
+		$this->plural_item = esc_html__('WP_Users', 'event_espresso');
+		global $wpdb;
+		$this->_tables = array(
+			'WP_User' => new EE_Primary_Table($wpdb->users, 'ID', true),
+		);
+		$this->_fields = array(
+			'WP_User' => array(
+				'ID'                  => $model_field_factory->createPrimaryKeyIntField(
+					'ID',
+					esc_html__('WP_User ID', 'event_espresso')
+				),
+				'user_login'          => $model_field_factory->createPlainTextField(
+					'user_login',
+					esc_html__('User Login', 'event_espresso'),
+					false
+				),
+				'user_pass'           => $model_field_factory->createPlainTextField(
+					'user_pass',
+					esc_html__('User Password', 'event_espresso'),
+					false
+				),
+				'user_nicename'       => $model_field_factory->createPlainTextField(
+					'user_nicename',
+					esc_html__(' User Nice Name', 'event_espresso'),
+					false
+				),
+				'user_email'          => $model_field_factory->createEmailField(
+					'user_email',
+					esc_html__('User Email', 'event_espresso'),
+					false
+				),
+				'user_registered'     => $model_field_factory->createDatetimeField(
+					'user_registered',
+					esc_html__('Date User Registered', 'event_espresso'),
+					$timezone
+				),
+				'user_activation_key' => $model_field_factory->createPlainTextField(
+					'user_activation_key',
+					esc_html__('User Activation Key', 'event_espresso'),
+					false
+				),
+				'user_status'         => $model_field_factory->createIntegerField(
+					'user_status',
+					esc_html__('User Status', 'event_espresso')
+				),
+				'display_name'        => $model_field_factory->createPlainTextField(
+					'display_name',
+					esc_html__('Display Name', 'event_espresso'),
+					false
+				),
+			),
+		);
+		$this->_model_relations = array(
+			'Attendee'       => new EE_Has_Many_Relation(),
+			// all models are related to the change log
+			// 'Change_Log'     => new EE_Has_Many_Relation(),
+			'Event'          => new EE_Has_Many_Relation(),
+			'Message'        => new EE_Has_Many_Relation(),
+			'Payment_Method' => new EE_Has_Many_Relation(),
+			'Price'          => new EE_Has_Many_Relation(),
+			'Price_Type'     => new EE_Has_Many_Relation(),
+			'Question'       => new EE_Has_Many_Relation(),
+			'Question_Group' => new EE_Has_Many_Relation(),
+			'Ticket'         => new EE_Has_Many_Relation(),
+			'Venue'          => new EE_Has_Many_Relation(),
+		);
+		$this->foreign_key_aliases = [
+			'Event.EVT_wp_user'          => 'WP_User.ID',
+			'Payment_Method.PMD_wp_user' => 'WP_User.ID',
+			'Price.PRC_wp_user'          => 'WP_User.ID',
+			'Price_Type.PRT_wp_user'     => 'WP_User.ID',
+			'Question.QST_wp_user'       => 'WP_User.ID',
+			'Question_Group.QSG_wp_user' => 'WP_User.ID',
+			'Ticket.VNU_wp_user'         => 'WP_User.ID',
+			'Venue.TKT_wp_user'          => 'WP_User.ID',
+		];
+		$this->_wp_core_model = true;
+		$this->_caps_slug = 'users';
+		$this->_cap_contexts_to_cap_action_map[ EEM_Base::caps_read ] = 'list';
+		$this->_cap_contexts_to_cap_action_map[ EEM_Base::caps_read_admin ] = 'list';
+		foreach ($this->_cap_contexts_to_cap_action_map as $context => $action) {
+			$this->_cap_restriction_generators[ $context ] = new EE_Restriction_Generator_WP_User();
+		}
+		// @todo: account for create_users controls whether they can create users at all
+		parent::__construct($timezone);
+	}
 
 
-    /**
-     * We don't need a foreign key to the WP_User model, we just need its primary key
-     *
-     * @return string
-     * @throws EE_Error
-     */
-    public function wp_user_field_name()
-    {
-        return $this->primary_key_name();
-    }
+	/**
+	 * We don't need a foreign key to the WP_User model, we just need its primary key
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 */
+	public function wp_user_field_name()
+	{
+		return $this->primary_key_name();
+	}
 
 
-    /**
-     * This WP_User model IS owned, even though it doesn't have a foreign key to itself
-     *
-     * @return boolean
-     */
-    public function is_owned()
-    {
-        return true;
-    }
+	/**
+	 * This WP_User model IS owned, even though it doesn't have a foreign key to itself
+	 *
+	 * @return boolean
+	 */
+	public function is_owned()
+	{
+		return true;
+	}
 }

core/db_classes/EE_Form_Input.class.php

Indentation +445 added lines, -445 removed lines

@@ -28,449 +28,449 @@
 class EE_Form_Input extends EE_Base_Class
 {
 
-    /**
-     * @param array $props_n_values
-     * @return EE_Form_Input
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public static function new_instance(array $props_n_values = []): EE_Form_Input
-    {
-        $has_object = parent::_check_for_object($props_n_values, __CLASS__);
-        return $has_object
-            ?: new self($props_n_values);
-    }
-
-
-    /**
-     * @param array $props_n_values
-     * @return EE_Form_Input
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public static function new_instance_from_db(array $props_n_values = []): EE_Form_Input
-    {
-        return new self($props_n_values);
-    }
-
-
-    /**
-     * Form Input UUID (universally unique identifier)
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function UUID(): string
-    {
-        return $this->get('FIN_UUID');
-    }
-
-
-    /**
-     * @param string $UUID
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setUUID(string $UUID)
-    {
-        $this->set('FIN_UUID', $UUID);
-    }
-
-
-    /**
-     * Input label displayed in the admin to help differentiate input from others
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function adminLabel(): string
-    {
-        return $this->get('FIN_adminLabel');
-    }
-
-
-    /**
-     * @param string $admin_label
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setAdminLabel(string $admin_label)
-    {
-        $this->set('FIN_adminLabel', $admin_label);
-    }
-
-
-    /**
-     * Whether or not input is only displayed in the admin. If false, input will appear in public forms
-     *
-     * @return bool
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function adminOnly(): bool
-    {
-        return $this->get('FIN_adminOnly');
-    }
-
-
-    /**
-     * @param bool $admin_only
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setAdminOnly(bool $admin_only)
-    {
-        $this->set('FIN_adminOnly', $admin_only);
-    }
-
-
-    /**
-     * UUID of parent form section this form input belongs to.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function belongsTo(): string
-    {
-        return $this->get('FIN_belongsTo');
-    }
-
-
-    /**
-     * @param string $relation_UUID
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setBelongsTo(string $relation_UUID)
-    {
-        $this->set('FIN_belongsTo', $relation_UUID);
-    }
-
-
-    /**
-     * Custom HTML classes to be applied to this form input's help text.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function helpClass(): string
-    {
-        return $this->get('FIN_helpClass');
-    }
-
-
-    /**
-     * @param string $help_class
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setHelpClass(string $help_class)
-    {
-        $this->set('FIN_helpClass', $help_class);
-    }
-
-
-    /**
-     * Additional text displayed alongside a form input to assist users with completing the form.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function helpText(): string
-    {
-        return $this->get('FIN_helpText');
-    }
-
-
-    /**
-     * @param string $help_text
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setHelpText(string $help_text)
-    {
-        $this->set('FIN_helpText', $help_text);
-    }
-
-
-    /**
-     * HTML classes to be applied to this form input's container.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function htmlClass(): string
-    {
-        return $this->get('FIN_htmlClass');
-    }
-
-
-    /**
-     * HTML classes to be applied to this form input's container.
-     *
-     * @param string $html_class
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setHtmlClass(string $html_class)
-    {
-        $this->set('FIN_htmlClass', $html_class);
-    }
-
-
-    /**
-     * Maximum numeric value or maximum characters allowed for form input answer.
-     *
-     * @return int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function max(): int
-    {
-        return $this->get('FIN_max');
-    }
-
-
-    /**
-     * @param int $max
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setMax(int $max)
-    {
-        $this->set('FIN_max', $max);
-    }
-
-
-
-    /**
-     * Minimum numeric value or minimum characters allowed for form input answer.
-     *
-     * @return int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function min(): int
-    {
-        return $this->get('FIN_min');
-    }
-
-
-    /**
-     * @param int $min
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setMin(int $min)
-    {
-        $this->set('FIN_min', $min);
-    }
-
-
-
-    /**
-     * Order in which form input appears in a form.
-     *
-     * @return int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function order(): int
-    {
-        return $this->get('FIN_order');
-    }
-
-
-    /**
-     * Order in which form input appears in a form.
-     *
-     * @param int $order
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setOrder(int $order)
-    {
-        $this->set('FIN_order', $order);
-    }
-
-
-    /**
-     * Example text displayed within an input to assist users with completing the form.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function placeholder(): string
-    {
-        return $this->get('FIN_placeholder');
-    }
-
-
-    /**
-     * @param string $placeholder
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setPlaceholder(string $placeholder)
-    {
-        $this->set('FIN_placeholder', $placeholder);
-    }
-
-
-    /**
-     * Input label displayed on public forms, ie: the actual question text.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function publicLabel(): string
-    {
-        return $this->get('FIN_publicLabel');
-    }
-
-
-    /**
-     * @param string $publicLabel
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setPublicLabel(string $publicLabel)
-    {
-        $this->set('FIN_publicLabel', $publicLabel);
-    }
-
-
-    /**
-     * Whether or not the input must be supplied with a value in order to complete the form.
-     *
-     * @return bool
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function required(): bool
-    {
-        return $this->get('FIN_required');
-    }
-
-
-    /**
-     * @param bool $required
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setRequired(bool $required)
-    {
-        $this->set('FIN_required', $required);
-    }
-
-
-    /**
-     * Custom validation text displayed alongside a required form input to assist users with completing the form.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function requiredText(): string
-    {
-        return $this->get('FIN_requiredText');
-    }
-
-
-    /**
-     * @param string $requiredText
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setRequiredText(string $requiredText)
-    {
-        $this->set('FIN_requiredText', $requiredText);
-    }
-
-
-    /**
-     * Whether form input is active, archived, trashed, or used as a default on new forms.
-     * Values correspond to the EEM_Form_Input::STATUS_* constants.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function status(): string
-    {
-        return $this->get('FIN_status');
-    }
-
-
-    /**
-     * Whether form input is active, archived, trashed, or used as a default on new forms.
-     * Values correspond to the EEM_Form_Input::STATUS_* constants.
-     *
-     * @param string $status
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setStatus(string $status)
-    {
-        $this->set('FIN_status', $status);
-    }
-
-
-    /**
-     * Form input type.
-     * Values correspond to the EventEspresso\core\domain\entities\form\Input::TYPE_* constants.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function type(): string
-    {
-        return $this->get('FIN_type');
-    }
-
-
-    /**
-     * @param string $type
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setType(string $type)
-    {
-        $this->set('FIN_type', $type);
-    }
-
-
-    /**
-     * ID of the WP User that created this form input.
-     *
-     * @return int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function wpUser(): int
-    {
-        return $this->get('FIN_wpUser');
-    }
-
-
-    /**
-     * returns the id the wordpress user who created this question
-     *
-     * @param int $wp_user
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setWpUser(int $wp_user)
-    {
-        $this->set('FIN_wpUser', $wp_user);
-    }
+	/**
+	 * @param array $props_n_values
+	 * @return EE_Form_Input
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public static function new_instance(array $props_n_values = []): EE_Form_Input
+	{
+		$has_object = parent::_check_for_object($props_n_values, __CLASS__);
+		return $has_object
+			?: new self($props_n_values);
+	}
+
+
+	/**
+	 * @param array $props_n_values
+	 * @return EE_Form_Input
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public static function new_instance_from_db(array $props_n_values = []): EE_Form_Input
+	{
+		return new self($props_n_values);
+	}
+
+
+	/**
+	 * Form Input UUID (universally unique identifier)
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function UUID(): string
+	{
+		return $this->get('FIN_UUID');
+	}
+
+
+	/**
+	 * @param string $UUID
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setUUID(string $UUID)
+	{
+		$this->set('FIN_UUID', $UUID);
+	}
+
+
+	/**
+	 * Input label displayed in the admin to help differentiate input from others
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function adminLabel(): string
+	{
+		return $this->get('FIN_adminLabel');
+	}
+
+
+	/**
+	 * @param string $admin_label
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setAdminLabel(string $admin_label)
+	{
+		$this->set('FIN_adminLabel', $admin_label);
+	}
+
+
+	/**
+	 * Whether or not input is only displayed in the admin. If false, input will appear in public forms
+	 *
+	 * @return bool
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function adminOnly(): bool
+	{
+		return $this->get('FIN_adminOnly');
+	}
+
+
+	/**
+	 * @param bool $admin_only
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setAdminOnly(bool $admin_only)
+	{
+		$this->set('FIN_adminOnly', $admin_only);
+	}
+
+
+	/**
+	 * UUID of parent form section this form input belongs to.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function belongsTo(): string
+	{
+		return $this->get('FIN_belongsTo');
+	}
+
+
+	/**
+	 * @param string $relation_UUID
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setBelongsTo(string $relation_UUID)
+	{
+		$this->set('FIN_belongsTo', $relation_UUID);
+	}
+
+
+	/**
+	 * Custom HTML classes to be applied to this form input's help text.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function helpClass(): string
+	{
+		return $this->get('FIN_helpClass');
+	}
+
+
+	/**
+	 * @param string $help_class
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setHelpClass(string $help_class)
+	{
+		$this->set('FIN_helpClass', $help_class);
+	}
+
+
+	/**
+	 * Additional text displayed alongside a form input to assist users with completing the form.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function helpText(): string
+	{
+		return $this->get('FIN_helpText');
+	}
+
+
+	/**
+	 * @param string $help_text
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setHelpText(string $help_text)
+	{
+		$this->set('FIN_helpText', $help_text);
+	}
+
+
+	/**
+	 * HTML classes to be applied to this form input's container.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function htmlClass(): string
+	{
+		return $this->get('FIN_htmlClass');
+	}
+
+
+	/**
+	 * HTML classes to be applied to this form input's container.
+	 *
+	 * @param string $html_class
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setHtmlClass(string $html_class)
+	{
+		$this->set('FIN_htmlClass', $html_class);
+	}
+
+
+	/**
+	 * Maximum numeric value or maximum characters allowed for form input answer.
+	 *
+	 * @return int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function max(): int
+	{
+		return $this->get('FIN_max');
+	}
+
+
+	/**
+	 * @param int $max
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setMax(int $max)
+	{
+		$this->set('FIN_max', $max);
+	}
+
+
+
+	/**
+	 * Minimum numeric value or minimum characters allowed for form input answer.
+	 *
+	 * @return int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function min(): int
+	{
+		return $this->get('FIN_min');
+	}
+
+
+	/**
+	 * @param int $min
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setMin(int $min)
+	{
+		$this->set('FIN_min', $min);
+	}
+
+
+
+	/**
+	 * Order in which form input appears in a form.
+	 *
+	 * @return int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function order(): int
+	{
+		return $this->get('FIN_order');
+	}
+
+
+	/**
+	 * Order in which form input appears in a form.
+	 *
+	 * @param int $order
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setOrder(int $order)
+	{
+		$this->set('FIN_order', $order);
+	}
+
+
+	/**
+	 * Example text displayed within an input to assist users with completing the form.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function placeholder(): string
+	{
+		return $this->get('FIN_placeholder');
+	}
+
+
+	/**
+	 * @param string $placeholder
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setPlaceholder(string $placeholder)
+	{
+		$this->set('FIN_placeholder', $placeholder);
+	}
+
+
+	/**
+	 * Input label displayed on public forms, ie: the actual question text.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function publicLabel(): string
+	{
+		return $this->get('FIN_publicLabel');
+	}
+
+
+	/**
+	 * @param string $publicLabel
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setPublicLabel(string $publicLabel)
+	{
+		$this->set('FIN_publicLabel', $publicLabel);
+	}
+
+
+	/**
+	 * Whether or not the input must be supplied with a value in order to complete the form.
+	 *
+	 * @return bool
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function required(): bool
+	{
+		return $this->get('FIN_required');
+	}
+
+
+	/**
+	 * @param bool $required
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setRequired(bool $required)
+	{
+		$this->set('FIN_required', $required);
+	}
+
+
+	/**
+	 * Custom validation text displayed alongside a required form input to assist users with completing the form.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function requiredText(): string
+	{
+		return $this->get('FIN_requiredText');
+	}
+
+
+	/**
+	 * @param string $requiredText
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setRequiredText(string $requiredText)
+	{
+		$this->set('FIN_requiredText', $requiredText);
+	}
+
+
+	/**
+	 * Whether form input is active, archived, trashed, or used as a default on new forms.
+	 * Values correspond to the EEM_Form_Input::STATUS_* constants.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function status(): string
+	{
+		return $this->get('FIN_status');
+	}
+
+
+	/**
+	 * Whether form input is active, archived, trashed, or used as a default on new forms.
+	 * Values correspond to the EEM_Form_Input::STATUS_* constants.
+	 *
+	 * @param string $status
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setStatus(string $status)
+	{
+		$this->set('FIN_status', $status);
+	}
+
+
+	/**
+	 * Form input type.
+	 * Values correspond to the EventEspresso\core\domain\entities\form\Input::TYPE_* constants.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function type(): string
+	{
+		return $this->get('FIN_type');
+	}
+
+
+	/**
+	 * @param string $type
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setType(string $type)
+	{
+		$this->set('FIN_type', $type);
+	}
+
+
+	/**
+	 * ID of the WP User that created this form input.
+	 *
+	 * @return int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function wpUser(): int
+	{
+		return $this->get('FIN_wpUser');
+	}
+
+
+	/**
+	 * returns the id the wordpress user who created this question
+	 *
+	 * @param int $wp_user
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setWpUser(int $wp_user)
+	{
+		$this->set('FIN_wpUser', $wp_user);
+	}
 }

core/db_classes/EE_Form_Section.class.php

Indentation +221 added lines, -221 removed lines

@@ -19,225 +19,225 @@
 class EE_Form_Section extends EE_Base_Class
 {
 
-    /**
-     * @param array $props_n_values
-     * @return EE_Form_Section
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public static function new_instance(array $props_n_values = []): EE_Form_Section
-    {
-        $has_object = parent::_check_for_object($props_n_values, __CLASS__);
-        return $has_object
-            ?: new self($props_n_values);
-    }
-
-
-    /**
-     * @param array $props_n_values
-     * @return EE_Form_Section
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public static function new_instance_from_db(array $props_n_values = []): EE_Form_Section
-    {
-        return new self($props_n_values);
-    }
-
-
-    /**
-     * Form Section UUID (universally unique identifier)
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function UUID(): string
-    {
-        return $this->get('FSC_UUID');
-    }
-
-
-    /**
-     * @param string $UUID
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setUUID(string $UUID)
-    {
-        $this->set('FSC_UUID', $UUID);
-    }
-
-
-    /**
-     * Form user types that this form section should be presented to.
-     * Values correspond to the EEM_Form_Section::APPLIES_TO_* constants.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function appliesTo(): string
-    {
-        return $this->get('FSC_appliesTo');
-    }
-
-
-    /**
-     * @param string $user_type
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setAppliesTo(string $user_type)
-    {
-        $this->set('FSC_appliesTo', $user_type);
-    }
-
-
-    /**
-     * UUID or ID of related entity this form section belongs to.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function belongsTo(): string
-    {
-        return $this->get('FSC_belongsTo');
-    }
-
-
-    /**
-     * @param string $relation_UUID
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setBelongsTo(string $relation_UUID)
-    {
-        $this->set('FSC_belongsTo', $relation_UUID);
-    }
-
-
-    /**
-     * HTML classes to be applied to this form section's container.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function htmlClass(): string
-    {
-        return $this->get('FSC_htmlClass');
-    }
-
-
-    /**
-     * @param string $html_class
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setHtmlClass(string $html_class)
-    {
-        $this->set('FSC_htmlClass', $html_class);
-    }
-
-
-    /**
-     * Order in which form section appears in a form.
-     *
-     * @return int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function order(): int
-    {
-        return $this->get('FSC_order');
-    }
-
-
-    /**
-     * @param int $order
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setOrder(int $order)
-    {
-        $this->set('FSC_order', $order);
-    }
-
-
-    /**
-     * Related model type.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function relation(): string
-    {
-        return $this->get('FSC_relation');
-    }
-
-
-    /**
-     * @param string $relation
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setRelation(string $relation)
-    {
-        $this->set('FSC_relation', $relation);
-    }
-
-
-    /**
-     * Whether form section is active, archived, trashed, or used as a default on new forms.
-     * Values correspond to the EEM_Form_Section::STATUS_* constants.
-     *
-     * @return string
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function status(): string
-    {
-        return $this->get('FSC_status');
-    }
-
-
-    /**
-     * Whether form section is active, archived, trashed, or used as a default on new forms.
-     * Values correspond to the EEM_Form_Section::STATUS_* constants.
-     *
-     * @param string $status
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setStatus(string $status)
-    {
-        $this->set('FSC_status', $status);
-    }
-
-
-    /**
-     * returns the id the wordpress user who created this question
-     *
-     * @return int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function wpUser(): int
-    {
-        return $this->get('FSC_wpUser');
-    }
-
-
-    /**
-     * @param int $wp_user
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function setWpUser(int $wp_user)
-    {
-        $this->set('FSC_wpUser', $wp_user);
-    }
+	/**
+	 * @param array $props_n_values
+	 * @return EE_Form_Section
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public static function new_instance(array $props_n_values = []): EE_Form_Section
+	{
+		$has_object = parent::_check_for_object($props_n_values, __CLASS__);
+		return $has_object
+			?: new self($props_n_values);
+	}
+
+
+	/**
+	 * @param array $props_n_values
+	 * @return EE_Form_Section
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public static function new_instance_from_db(array $props_n_values = []): EE_Form_Section
+	{
+		return new self($props_n_values);
+	}
+
+
+	/**
+	 * Form Section UUID (universally unique identifier)
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function UUID(): string
+	{
+		return $this->get('FSC_UUID');
+	}
+
+
+	/**
+	 * @param string $UUID
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setUUID(string $UUID)
+	{
+		$this->set('FSC_UUID', $UUID);
+	}
+
+
+	/**
+	 * Form user types that this form section should be presented to.
+	 * Values correspond to the EEM_Form_Section::APPLIES_TO_* constants.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function appliesTo(): string
+	{
+		return $this->get('FSC_appliesTo');
+	}
+
+
+	/**
+	 * @param string $user_type
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setAppliesTo(string $user_type)
+	{
+		$this->set('FSC_appliesTo', $user_type);
+	}
+
+
+	/**
+	 * UUID or ID of related entity this form section belongs to.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function belongsTo(): string
+	{
+		return $this->get('FSC_belongsTo');
+	}
+
+
+	/**
+	 * @param string $relation_UUID
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setBelongsTo(string $relation_UUID)
+	{
+		$this->set('FSC_belongsTo', $relation_UUID);
+	}
+
+
+	/**
+	 * HTML classes to be applied to this form section's container.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function htmlClass(): string
+	{
+		return $this->get('FSC_htmlClass');
+	}
+
+
+	/**
+	 * @param string $html_class
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setHtmlClass(string $html_class)
+	{
+		$this->set('FSC_htmlClass', $html_class);
+	}
+
+
+	/**
+	 * Order in which form section appears in a form.
+	 *
+	 * @return int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function order(): int
+	{
+		return $this->get('FSC_order');
+	}
+
+
+	/**
+	 * @param int $order
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setOrder(int $order)
+	{
+		$this->set('FSC_order', $order);
+	}
+
+
+	/**
+	 * Related model type.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function relation(): string
+	{
+		return $this->get('FSC_relation');
+	}
+
+
+	/**
+	 * @param string $relation
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setRelation(string $relation)
+	{
+		$this->set('FSC_relation', $relation);
+	}
+
+
+	/**
+	 * Whether form section is active, archived, trashed, or used as a default on new forms.
+	 * Values correspond to the EEM_Form_Section::STATUS_* constants.
+	 *
+	 * @return string
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function status(): string
+	{
+		return $this->get('FSC_status');
+	}
+
+
+	/**
+	 * Whether form section is active, archived, trashed, or used as a default on new forms.
+	 * Values correspond to the EEM_Form_Section::STATUS_* constants.
+	 *
+	 * @param string $status
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setStatus(string $status)
+	{
+		$this->set('FSC_status', $status);
+	}
+
+
+	/**
+	 * returns the id the wordpress user who created this question
+	 *
+	 * @return int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function wpUser(): int
+	{
+		return $this->get('FSC_wpUser');
+	}
+
+
+	/**
+	 * @param int $wp_user
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function setWpUser(int $wp_user)
+	{
+		$this->set('FSC_wpUser', $wp_user);
+	}
 }