X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=CRM%2FCore%2FForm%2FSearch.php;h=c4ea8a259940579fc321911d818dbf5880350c05;hb=54744051dea726c2b1495f24fc1cf7ba7fa25e11;hp=c698c6d78555e9410c2a38346299a896eb1dd8d0;hpb=0058ef3f2335ac23d87a910b91c6a59fe7c4781d;p=civicrm-core.git diff --git a/CRM/Core/Form/Search.php b/CRM/Core/Form/Search.php index c698c6d785..c4ea8a2599 100644 --- a/CRM/Core/Form/Search.php +++ b/CRM/Core/Form/Search.php @@ -3,7 +3,7 @@ +--------------------------------------------------------------------+ | CiviCRM version 5 | +--------------------------------------------------------------------+ - | Copyright CiviCRM LLC (c) 2004-2019 | + | Copyright CiviCRM LLC (c) 2004-2020 | +--------------------------------------------------------------------+ | This file is a part of CiviCRM. | | | @@ -70,7 +70,7 @@ class CRM_Core_Form_Search extends CRM_Core_Form { * * @var string */ - protected $_context = NULL; + protected $_context; /** * The list of tasks or actions that a searcher can perform on a result set. @@ -124,6 +124,20 @@ class CRM_Core_Form_Search extends CRM_Core_Form { $this->searchFieldMetadata = array_merge($this->searchFieldMetadata, $searchFieldMetadata); } + /** + * Prepare for search by loading options from the url, handling force searches, retrieving form values. + * + * @throws \CRM_Core_Exception + * @throws \CiviCRM_API3_Exception + */ + public function preProcess() { + $this->loadStandardSearchOptionsFromUrl(); + if ($this->_force) { + $this->handleForcedSearch(); + } + $this->_formValues = $this->getFormValues(); + } + /** * This virtual function is used to set the default values of various form elements. * @@ -132,7 +146,10 @@ class CRM_Core_Form_Search extends CRM_Core_Form { * @throws \CRM_Core_Exception */ public function setDefaultValues() { - $defaults = (array) $this->_formValues; + // Use the form values stored to the form. Ideally 'formValues' + // would remain 'pure' & another array would be wrangled. + // We don't do that - so we want the version of formValues stored early on. + $defaults = (array) $this->get('formValues'); foreach (array_keys($this->getSearchFieldMetadata()) as $entity) { $defaults = array_merge($this->getEntityDefaults($entity), $defaults); } @@ -146,11 +163,14 @@ class CRM_Core_Form_Search extends CRM_Core_Form { */ protected function setFormValues() { $this->_formValues = $this->getFormValues(); + $this->set('formValues', $this->_formValues); $this->convertTextStringsToUseLikeOperator(); } /** * Common buildForm tasks required by all searches. + * + * @throws \CRM_Core_Exception */ public function buildQuickForm() { CRM_Core_Resources::singleton() @@ -176,6 +196,8 @@ class CRM_Core_Form_Search extends CRM_Core_Form { * * The goal is to describe all fields in metadata and handle from metadata rather * than existing ad hoc handling. + * + * @throws \CiviCRM_API3_Exception */ public function addFormFieldsFromMetadata() { $this->addFormRule(['CRM_Core_Form_Search', 'formRule'], $this); @@ -360,6 +382,8 @@ class CRM_Core_Form_Search extends CRM_Core_Form { * * Note that for translation purposes the full string works better than using 'prefix' hence we use override-able functions * to define the string. + * + * @throws \CiviCRM_API3_Exception */ protected function addSortNameField() { $title = civicrm_api3('setting', 'getvalue', ['name' => 'includeEmailInName', 'group' => 'Search Preferences']) ? $this->getSortNameLabelWithEmail() : $this->getSortNameLabelWithOutEmail(); @@ -403,6 +427,8 @@ class CRM_Core_Form_Search extends CRM_Core_Form { /** * Add generic fields that specify the contact. + * + * @throws \CiviCRM_API3_Exception */ protected function addContactSearchFields() { if (!$this->isFormInViewOrEditMode()) { @@ -442,6 +468,8 @@ class CRM_Core_Form_Search extends CRM_Core_Form { /** * we allow the controller to set force/reset externally, useful when we are being * driven by the wizard framework + * + * @throws \CRM_Core_Exception */ protected function loadStandardSearchOptionsFromUrl() { $this->_reset = CRM_Utils_Request::retrieve('reset', 'Boolean'); @@ -491,6 +519,22 @@ class CRM_Core_Form_Search extends CRM_Core_Form { return (array) $this->get('formValues'); } + /** + * Get the string processed to determine sort order. + * + * This looks like 'sort_name_u' for Sort name ascending. + * + * @return string|null + */ + protected function getSortID() { + if ($this->get(CRM_Utils_Sort::SORT_ID)) { + return CRM_Utils_Sort::sortIDValue($this->get(CRM_Utils_Sort::SORT_ID), + $this->get(CRM_Utils_Sort::SORT_DIRECTION) + ); + } + return NULL; + } + /** * Set the metadata for the form. * @@ -508,6 +552,7 @@ class CRM_Core_Form_Search extends CRM_Core_Form { */ protected function handleForcedSearch() { $this->setSearchMetadata(); + $this->addContactSearchFields(); $this->postProcess(); $this->set('force', 0); }