public function FederatedSearchPageFormBlock::blockForm in Search API Federated Solr 8.2
Same name and namespace in other branches
- 8.3 src/Plugin/Block/FederatedSearchPageFormBlock.php \Drupal\search_api_federated_solr\Plugin\Block\FederatedSearchPageFormBlock::blockForm()
- 4.x src/Plugin/Block/FederatedSearchPageFormBlock.php \Drupal\search_api_federated_solr\Plugin\Block\FederatedSearchPageFormBlock::blockForm()
Returns the configuration form elements specific to this block plugin.
Blocks that need to add form elements to the normal block configuration form should implement this method.
Parameters
array $form: The form definition array for the block configuration form.
\Drupal\Core\Form\FormStateInterface $form_state: The current state of the form.
Return value
array The renderable form array representing the entire configuration form.
Overrides BlockPluginTrait::blockForm
File
- src/
Plugin/ Block/ FederatedSearchPageFormBlock.php, line 77
Class
- FederatedSearchPageFormBlock
- Provides a "Federated Search Page Form" block.
Namespace
Drupal\search_api_federated_solr\Plugin\BlockCode
public function blockForm($form, FormStateInterface $form_state) {
$form = parent::blockForm($form, $form_state);
// Create a link to the Search App Settings Page to be reused.
$options = [
'attributes' => [
'target' => '_blank',
],
];
$search_app_settings_page_url = Url::fromRoute('search_api_federated_solr.search_app.settings', [], $options);
$search_app_settings_page_link = Link::fromTextAndUrl('Federated Search App settings page', $search_app_settings_page_url)
->toString();
$config = $this
->getConfiguration();
$index_options = [];
$search_api_indexes = \Drupal::entityTypeManager()
->getStorage('search_api_index')
->loadMultiple();
/* @var $search_api_index \Drupal\search_api\IndexInterface */
foreach ($search_api_indexes as $search_api_index) {
$index_options[$search_api_index
->id()] = $search_api_index
->label();
}
/**
* Autocomplete settings:
* - endpoint URL
* - use wildcard to support partial terms
* - customize number of autocomplete results
* - number of characters after which autocomplete query should be executed
* - autocomplete results mode (search results, terms)
* - title for autocomplete results
* - show/hide autocomplete keyboard directions
*/
$form['autocomplete'] = [
'#type' => 'details',
'#title' => $this
->t('Federated Search Page Form Block > Search Form > Autocomplete'),
'#description' => $this
->t('These options apply to the autocomplete functionality on the search form which appears on pages that render the Federated Search Page Form Block. Configure the search results page search form functionality on the ' . $search_app_settings_page_link . '.'),
'#open' => TRUE,
];
$form['autocomplete']['autocomplete_is_enabled'] = [
'#type' => 'checkbox',
'#title' => '<b>' . $this
->t('Enable autocomplete for the search results page search form') . '</b>',
'#default_value' => isset($config['autocomplete']['isEnabled']) ? $config['autocomplete']['isEnabled'] : 0,
'#description' => $this
->t('Check this box to enable autocomplete on the federated search block search form and to expose more configuration options below.'),
'#attributes' => [
'data-autocomplete-enable' => TRUE,
],
];
$form['autocomplete']['autocomplete_is_append_wildcard'] = [
'#type' => 'checkbox',
'#title' => '<b>' . $this
->t('Append a wildcard \'*\' to support partial text search') . '</b>',
'#default_value' => isset($config['autocomplete']['appendWildcard']) ? $config['autocomplete']['appendWildcard'] : 0,
'#description' => $this
->t('Check this box to append a wildcard * to the end of the autocomplete query term (i.e. "car" becomes "car*"). This option is only recommended if your solr config does not add a field(s) with <a href="https://lucene.apache.org/solr/guide/6_6/tokenizers.html" target="_blank">NGram Tokenizers</a> to your index or if your <a href="https://lucene.apache.org/solr/guide/6_6/requesthandlers-and-searchcomponents-in-solrconfig.html#RequestHandlersandSearchComponentsinSolrConfig-RequestHandlers" target="_blank">Request Handler</a> is not configured to search those fields.'),
'#states' => [
'visible' => [
':input[data-autocomplete-enable]' => [
'checked' => TRUE,
],
],
],
];
$form['autocomplete']['disable_query_proxy'] = [
'#type' => 'checkbox',
'#title' => '<b>' . $this
->t('Do not use the solr proxy for the autocomplete search query') . '</b>',
'#default_value' => isset($config['autocomplete']['proxyIsDisabled']) ? $config['autocomplete']['proxyIsDisabled'] : 0,
'#description' => $this
->t('Check this box to configure the block search form to query the Solr server directly. When checked, it is highly recommended that you also procure and configure read-only basic auth credentials for the search app. When unchecked, this site will act as a proxy for requests to the Solr server of the Search API index chosen on the ' . $search_app_settings_page_link . ' in Search Results Page > Set Up using the Drupal route defined by this module.<br/><br/>Note: Acquia Search customers must either leave this box unchecked or check the box and enter the URL for a view REST export endpoint. Using a url pointing directly to your solr backend will not work.'),
'#attributes' => [
'data-autocomplete-direct' => TRUE,
],
'#states' => [
'visible' => [
':input[data-autocomplete-enable]' => [
'checked' => TRUE,
],
],
],
];
$form['autocomplete']['direct'] = [
'#type' => 'fieldset',
'#title' => $this
->t('Direct Query Settings'),
'#states' => [
'visible' => [
':input[data-autocomplete-enable]' => [
'checked' => TRUE,
],
':input[data-autocomplete-direct]' => [
'checked' => TRUE,
],
],
],
];
$form['autocomplete']['direct']['autocomplete_url'] = [
'#type' => 'textfield',
'#title' => $this
->t('Endpoint URL'),
'#default_value' => isset($config['autocomplete']['directUrl']) ? $config['autocomplete']['directUrl'] : '',
'#maxlength' => 2048,
'#size' => 50,
'#description' => $this
->t('The URL where requests for autocomplete queries should be made. (Default: the url of the <code>select</code> <a href="https://lucene.apache.org/solr/guide/6_6/requesthandlers-and-searchcomponents-in-solrconfig.html#RequestHandlersandSearchComponentsinSolrConfig-RequestHandlers" target="_blank">Request Handler</a> on the server of the selected Search API index.)<ul><li>Supports absolute url pattern to any endpoint which returns the expected response structure:
<pre><code>{
response: {
docs: [
{
ss_federated_title: [result title to be used as link text],
ss_url: [result url to be used as link href],
}
]
}
}</code></pre></li><li>Include <code>[val]</code> in the URL to indicate where you would like the form value to be inserted: <code>http://d8.fs-demo.local/search-api-federated-solr-block-form-autocomplete/search-view?title=[val]&_format=json</code></li><li>Any facet/filter default values set for the search app will automatically be appended (i.e. <code>&sm_site_name=[value of the site name for the index]</code>)</li><li>Include any other necessary url params (like <code>&_format=json</code> if you are using a Views Rest Export or <code>&wt=json</code> if you are using a different Request Handler on your Solr index.</li>'),
'#states' => [
'visible' => [
':input[data-autocomplete-direct]' => [
'checked' => TRUE,
],
],
],
];
$form['autocomplete']['direct']['basic_auth'] = [
'#type' => 'fieldset',
'#title' => $this
->t('Search Form Autocomplete Basic Authentication'),
'#description' => $this
->t('If your autocomplete endpoint is protected by basic HTTP authentication (highly recommended), enter the login data here. This will be accessible to the client in an obscured, but non-secure method. It should, therefore, only provide read access to the index AND be different from that provided when configuring the server in Search API. The Password field is intentionally not obscured to emphasize this distinction.'),
'#states' => [
'visible' => [
':input[data-autocomplete-direct]' => [
'checked' => TRUE,
],
],
],
];
$form['autocomplete']['direct']['basic_auth']['use_search_app_creds'] = [
'#type' => 'checkbox',
'#title' => $this
->t('Use credentials provided for Search Index Basic Authentication in Search Results Page > Set Up on ' . $search_app_settings_page_link),
'#default_value' => isset($config['autocomplete']['use_search_app_creds']) ? $config['autocomplete']['use_search_app_creds'] : 0,
'#attributes' => [
'data-autocomplete-use-search-app-creds' => TRUE,
],
];
$form['autocomplete']['direct']['basic_auth']['username'] = [
'#type' => 'textfield',
'#title' => $this
->t('Username'),
'#default_value' => isset($config['autocomplete']['username']) ? $config['autocomplete']['username'] : '',
'#states' => [
'visible' => [
':input[data-autocomplete-use-search-app-creds]' => [
'checked' => FALSE,
],
],
],
];
$form['autocomplete']['direct']['basic_auth']['password'] = [
'#type' => 'textfield',
'#title' => $this
->t('Password'),
'#default_value' => isset($config['autocomplete']['password']) ? $config['autocomplete']['password'] : '',
'#states' => [
'visible' => [
':input[data-autocomplete-use-search-app-creds]' => [
'checked' => FALSE,
],
],
],
];
$form['autocomplete']['autocomplete_suggestion_rows'] = [
'#type' => 'number',
'#title' => $this
->t('Number of results'),
'#default_value' => isset($config['autocomplete']['suggestionRows']) ? $config['autocomplete']['suggestionRows'] : '',
'#description' => $this
->t('The max number of results to render in the autocomplete results dropdown. (Default: 5)'),
'#states' => [
'visible' => [
':input[data-autocomplete-enable]' => [
'checked' => TRUE,
],
],
],
];
$form['autocomplete']['autocomplete_num_chars'] = [
'#type' => 'number',
'#title' => $this
->t('Number of characters after which autocomplete query should execute'),
'#default_value' => isset($config['autocomplete']['numChars']) ? $config['autocomplete']['numChars'] : '',
'#description' => $this
->t('Autocomplete query will be executed <em>after</em> a user types this many characters in the search query field. (Default: 2)'),
'#states' => [
'visible' => [
':input[data-autocomplete-enable]' => [
'checked' => TRUE,
],
],
],
];
$autocomplete_mode = isset($config['autocomplete']['mode']) ? $config['autocomplete']['mode'] : '';
$form['autocomplete']['autocomplete_mode'] = [
'#type' => 'select',
'#title' => $this
->t('Autocomplete mode'),
'#description' => $this
->t('Type of results the autocomplete response returns: search results (default) or search terms.'),
'#options' => [
'result' => $this
->t('Search results (i.e. search as you type functionality)'),
'Search terms (coming soon)' => [],
],
'#default_value' => isset($config['autocomplete']['mode']) ? $config['autocomplete']['mode'] : 'result',
'#states' => [
'visible' => [
':input[data-autocomplete-enable]' => [
'checked' => TRUE,
],
],
],
];
$form['autocomplete']['autocomplete_mode_title_text'] = [
'#type' => 'textfield',
'#title' => $this
->t('Results title text'),
'#size' => 50,
'#default_value' => $autocomplete_mode && isset($config['autocomplete'][$autocomplete_mode]['titleText']) ? $config['autocomplete'][$autocomplete_mode]['titleText'] : '',
'#description' => $this
->t('The title text is shown above the results in the autocomplete drop down. (Default: "What are you interested in?" for Search Results mode and "What would you like to search for?" for Search Term mode.)'),
'#states' => [
'visible' => [
':input[data-autocomplete-enable]' => [
'checked' => TRUE,
],
],
],
];
$form['autocomplete']['autocomplete_mode_hide_directions'] = [
'#type' => 'checkbox',
'#title' => '<b>' . $this
->t('Hide keyboard directions') . '</b>',
'#default_value' => $autocomplete_mode && isset($config['autocomplete'][$autocomplete_mode]['hideDirectionsText']) ? $config['autocomplete'][$autocomplete_mode]['hideDirectionsText'] : 0,
'#description' => $this
->t('Check this box to make hide the autocomplete keyboard usage directions in the results dropdown. For sites that want to maximize their accessibility UX for sighted keyboard users, we recommend leaving this unchecked. (Default: directions are visible)'),
'#states' => [
'visible' => [
':input[data-autocomplete-enable]' => [
'checked' => TRUE,
],
],
],
];
return $form;
}