Make label field on relationship type required again (accidentally removed
[civicrm-core.git] / CRM / Member / Form / MembershipStatus.php
index e20ec7f86cf6e648914eb2272283659662e16308..10b468febd9c5530001950861151f9d24065bb32 100644 (file)
@@ -1,9 +1,9 @@
 <?php
 /*
  +--------------------------------------------------------------------+
- | CiviCRM version 4.7                                                |
+ | CiviCRM version 5                                                  |
  +--------------------------------------------------------------------+
- | Copyright CiviCRM LLC (c) 2004-2017                                |
+ | Copyright CiviCRM LLC (c) 2004-2018                                |
  +--------------------------------------------------------------------+
  | This file is a part of CiviCRM.                                    |
  |                                                                    |
 /**
  *
  * @package CRM
- * @copyright CiviCRM LLC (c) 2004-2017
- * $Id$
- *
+ * @copyright CiviCRM LLC (c) 2004-2018
  */
 
 /**
  * This class generates form components for Membership Type
- *
  */
-class CRM_Member_Form_MembershipStatus extends CRM_Member_Form_MembershipConfig {
+class CRM_Member_Form_MembershipStatus extends CRM_Core_Form {
+
+  use CRM_Core_Form_EntityFormTrait;
+
+  /**
+   * Explicitly declare the entity api name.
+   */
+  public function getDefaultEntity() {
+    return 'MembershipStatus';
+  }
+
+  /**
+   * Explicitly declare the form context.
+   */
+  public function getDefaultContext() {
+    return 'create';
+  }
+
+  /**
+   * Fields for the entity to be assigned to the template.
+   *
+   * Fields may have keys
+   *  - name (required to show in tpl from the array)
+   *  - description (optional, will appear below the field)
+   *  - not-auto-addable - this class will not attempt to add the field using addField.
+   *    (this will be automatically set if the field does not have html in it's metadata
+   *    or is not a core field on the form's entity).
+   *  - help (optional) add help to the field - e.g ['id' => 'id-source', 'file' => 'CRM/Contact/Form/Contact']]
+   *  - template - use a field specific template to render this field
+   *  - required
+   * @var array
+   */
+  protected $entityFields = [];
+
+  /**
+   * Set entity fields to be assigned to the form.
+   */
+  protected function setEntityFields() {
+    $this->entityFields = [
+      'label' => [
+        'name' => 'label',
+        'description' => ts("Display name for this Membership status (e.g. New, Current, Grace, Expired...)."),
+        'required' => TRUE,
+      ],
+      'is_admin' => [
+        'name' => 'is_admin',
+        'description' => ts("Check this box if this status is for use by administrative staff only. If checked, this status is never automatically assigned by CiviMember. It is assigned to a contact's Membership by checking the <strong>Status Override</strong> flag when adding or editing the Membership record. Start and End Event settings are ignored for Administrator statuses. EXAMPLE: This setting can be useful for special case statuses like 'Non-expiring', 'Barred' or 'Expelled', etc."),
+      ],
+    ];
+  }
+
+  /**
+   * Set the delete message.
+   *
+   * We do this from the constructor in order to do a translation.
+   */
+  public function setDeleteMessage() {
+    $this->deleteMessage = ts('You will not be able to delete this membership status if there are existing memberships with this status. You will need to check all your membership status rules afterwards to ensure that a valid status will always be available.') . " "  . ts('Do you want to continue?');
+  }
+
+  public function preProcess() {
+    $this->_id = $this->get('id');
+    $this->_BAOName = 'CRM_Member_BAO_MembershipStatus';
+  }
 
   /**
    * Set default values for the form. MobileProvider that in edit/view mode
    * the default values are retrieved from the database
    *
-   *
-   * @return void
+   * @return array
    */
   public function setDefaultValues() {
-    $defaults = parent::setDefaultValues();
+    $defaults = array();
+
+    if ($this->getEntityId()) {
+      $params = array('id' => $this->getEntityId());
+      $baoName = $this->_BAOName;
+      $baoName::retrieve($params, $defaults);
+    }
+
+    if ($this->_action & CRM_Core_Action::ADD) {
+      $defaults['is_active'] = 1;
+    }
 
     //finding default weight to be put
     if (empty($defaults['weight'])) {
@@ -58,18 +127,15 @@ class CRM_Member_Form_MembershipStatus extends CRM_Member_Form_MembershipConfig
 
   /**
    * Build the form object.
-   *
-   * @return void
    */
   public function buildQuickForm() {
+    self::buildQuickEntityForm();
     parent::buildQuickForm();
 
     if ($this->_action & CRM_Core_Action::DELETE) {
       return;
     }
 
-    $this->applyFilter('__ALL__', 'trim');
-
     if ($this->_id) {
       $name = $this->add('text', 'name', ts('Name'),
         CRM_Core_DAO::getAttribute('CRM_Member_DAO_MembershipStatus', 'name')
@@ -77,9 +143,6 @@ class CRM_Member_Form_MembershipStatus extends CRM_Member_Form_MembershipConfig
       $name->freeze();
       $this->assign('id', $this->_id);
     }
-    $this->add('text', 'label', ts('Label'),
-      CRM_Core_DAO::getAttribute('CRM_Member_DAO_MembershipStatus', 'label'), TRUE
-    );
     $this->addRule('label', ts('A membership status with this label already exists. Please select another label.'),
       'objectExists', array('CRM_Member_DAO_MembershipStatus', $this->_id, 'name')
     );
@@ -95,7 +158,6 @@ class CRM_Member_Form_MembershipStatus extends CRM_Member_Form_MembershipConfig
       CRM_Core_DAO::getAttribute('CRM_Member_DAO_MembershipStatus', 'end_event_adjust_interval')
     );
     $this->add('checkbox', 'is_current_member', ts('Current Membership?'));
-    $this->add('checkbox', 'is_admin', ts('Administrator Only?'));
 
     $this->add('text', 'weight', ts('Order'),
       CRM_Core_DAO::getAttribute('CRM_Member_DAO_MembershipStatus', 'weight')
@@ -106,9 +168,6 @@ class CRM_Member_Form_MembershipStatus extends CRM_Member_Form_MembershipConfig
 
   /**
    * Process the form submission.
-   *
-   *
-   * @return void
    */
   public function postProcess() {
     if ($this->_action & CRM_Core_Action::DELETE) {
@@ -121,7 +180,6 @@ class CRM_Member_Form_MembershipStatus extends CRM_Member_Form_MembershipConfig
       CRM_Core_Session::setStatus(ts('Selected membership status has been deleted.'), ts('Record Deleted'), 'success');
     }
     else {
-      $params = $ids = array();
       // store the submitted values in an array
       $params = $this->exportValues();
       $params['is_active'] = CRM_Utils_Array::value('is_active', $params, FALSE);
@@ -130,7 +188,7 @@ class CRM_Member_Form_MembershipStatus extends CRM_Member_Form_MembershipConfig
       $params['is_default'] = CRM_Utils_Array::value('is_default', $params, FALSE);
 
       if ($this->_action & CRM_Core_Action::UPDATE) {
-        $ids['membershipStatus'] = $this->_id;
+        $params['id'] = $this->getEntityId();
       }
       $oldWeight = NULL;
       if ($this->_id) {
@@ -143,7 +201,7 @@ class CRM_Member_Form_MembershipStatus extends CRM_Member_Form_MembershipConfig
         $params['name'] = $params['label'];
       }
 
-      $membershipStatus = CRM_Member_BAO_MembershipStatus::add($params, $ids);
+      $membershipStatus = CRM_Member_BAO_MembershipStatus::add($params);
       CRM_Core_Session::setStatus(ts('The membership status \'%1\' has been saved.',
         array(1 => $membershipStatus->label)
       ), ts('Saved'), 'success');