Passed
Push — master ( 613566...1c0463 )
by Timo
05:04
created

getPhraseSearchIsEnabled()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 5
Code Lines 3

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 4
CRAP Score 1

Importance

Changes 0
Metric Value
dl 0
loc 5
rs 9.4285
c 0
b 0
f 0
ccs 4
cts 4
cp 1
cc 1
eloc 3
nc 1
nop 1
crap 1
1
<?php
2
namespace ApacheSolrForTypo3\Solr\System\Configuration;
3
4
/***************************************************************
5
 *  Copyright notice
6
 *
7
 *  (c) 2016 Timo Schmidt <[email protected]>
8
 *  All rights reserved
9
 *
10
 *  This script is part of the TYPO3 project. The TYPO3 project is
11
 *  free software; you can redistribute it and/or modify
12
 *  it under the terms of the GNU General Public License as published by
13
 *  the Free Software Foundation; either version 2 of the License, or
14
 *  (at your option) any later version.
15
 *
16
 *  The GNU General Public License can be found at
17
 *  http://www.gnu.org/copyleft/gpl.html.
18
 *  A copy is found in the textfile GPL.txt and important notices to the license
19
 *  from the author is found in LICENSE.txt distributed with these scripts.
20
 *
21
 *
22
 *  This script is distributed in the hope that it will be useful,
23
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
24
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
25
 *  GNU General Public License for more details.
26
 *
27
 *  This copyright notice MUST APPEAR in all copies of the script!
28
 ***************************************************************/
29
30
use ApacheSolrForTypo3\Solr\IndexQueue\Indexer;
31
use ApacheSolrForTypo3\Solr\IndexQueue\Initializer\Record;
32
use ApacheSolrForTypo3\Solr\System\ContentObject\ContentObjectService;
33
use ApacheSolrForTypo3\Solr\System\Util\ArrayAccessor;
34
use InvalidArgumentException;
35
use TYPO3\CMS\Core\Utility\ArrayUtility;
36
use TYPO3\CMS\Core\Utility\GeneralUtility;
37
38
/**
39
 * TypoScript configuration object, used to read all TypoScript configuration.
40
 *
41
 * The TypoScriptConfiguration was introduced in order to be able to replace the old,
42
 * array based configuration with one configuration object.
43
 *
44
 * To read the configuration, you should use
45
 *
46
 * $configuration->getValueByPath
47
 *
48
 * or
49
 *
50
 * $configuration->isValidPath
51
 *
52
 * to check if an configuration path exists.
53
 *
54
 * To ensure Backwards compatibility the TypoScriptConfiguration object implements the
55
 * ArrayAccess interface (offsetGet,offsetExists,offsetUnset and offsetSet)
56
 *
57
 * This was only introduced to be backwards compatible in logTerm only "getValueByPath", "isValidPath" or
58
 * speaking methods for configuration settings should be used!
59
 *
60
 * @author Marc Bastian Heinrichs <[email protected]>
61
 * @author Timo Schmidt <[email protected]>
62
 */
63
class TypoScriptConfiguration
64
{
65
    /**
66
     * @var \ApacheSolrForTypo3\Solr\System\Util\ArrayAccessor|null
67
     */
68
    protected $configurationAccess = null;
69
70
    /**
71
     * Holds the pageId in which context the configuration was parsed
72
     * (normally $GLOBALS['TSFE']->id)
73
     */
74
    protected $contextPageId = 0;
75
76
    /**
77
     * @var ContentObjectService
78
     */
79
    protected $contentObjectService;
80
81
    /**
82
     * @param array $configuration
83
     * @param int $contextPageId
84
     * @param ContentObjectService $contentObjectService
85
     */
86 275
    public function __construct(array $configuration, $contextPageId = 0, ContentObjectService $contentObjectService = null)
87
    {
88 275
        $this->configurationAccess = new ArrayAccessor($configuration, '.', true);
89 275
        $this->contextPageId = $contextPageId;
90 275
        $this->contentObjectService = is_null($contentObjectService) ? GeneralUtility::makeInstance(ContentObjectService::class) : $contentObjectService;
91 275
    }
92
93
    /**
94
     * Checks if a value is 1, '1', 'true'
95
     * @param mixed $value
96
     * @return bool
97
     */
98 246
    protected function getBool($value)
99
    {
100 246
        return filter_var($value, FILTER_VALIDATE_BOOLEAN);
101
    }
102
103
    /**
104
     * This method can be used to only retrieve array keys where the value is not an array.
105
     *
106
     * This can be very handy in the configuration when only keys should ne taken into account
107
     * where the value is not a subconfiguration (typically an typoscript object path).
108
     *
109
     * @param $inputArray
110
     * @return array
111
     */
112 12
    protected function getOnlyArrayKeysWhereValueIsNotAnArray($inputArray)
113
    {
114 12
        $keysWithNonArrayValue = [];
115
116 12
        foreach ($inputArray as $key => $value) {
117 12
            if (is_array($value)) {
118
                // configuration for a content object, skipping
119 9
                continue;
120
            }
121
122 12
            $keysWithNonArrayValue[] = $key;
123
        }
124
125 12
        return $keysWithNonArrayValue;
126
    }
127
128
    /**
129
     * Gets the value from a given TypoScript path.
130
     *
131
     * In the context of an frontend content element the path plugin.tx_solr is
132
     * merged recursive with overrule with the content element specific typoscript
133
     * settings, like plugin.tx_solr_PiResults_Results, and possible flex form settings
134
     * (depends on the solr plugin).
135
     *
136
     * Example: plugin.tx_solr.search.targetPage
137
     * returns $GLOBALS['TSFE']->tmpl->setup['plugin.']['tx_solr.']['search.']['targetPage']
138
     *
139
     * @param string $path TypoScript path
140
     * @return mixed The TypoScript object defined by the given path
141
     * @throws InvalidArgumentException
142
     */
143 287
    public function getValueByPath($path)
144
    {
145 287
        if (!is_string($path)) {
146
            throw new InvalidArgumentException('Parameter $path is not a string',
147
                1325623321);
148
        }
149 287
        return $this->configurationAccess->get($path);
150
    }
151
152
    /**
153
     * This method can be used to get  a configuration value by path if it exists or return a
154
     * default value when it does not exist.
155
     *
156
     * @param string $path
157
     * @param mixed $defaultValue
158
     * @return mixed
159
     */
160 284
    public function getValueByPathOrDefaultValue($path, $defaultValue)
161
    {
162 284
        $value = $this->getValueByPath($path);
163 284
        if (is_null($value)) {
164 273
            return $defaultValue;
165
        }
166
167 169
        return $value;
168
    }
169
170
    /**
171
     * Gets the parent TypoScript Object from a given TypoScript path.
172
     *
173
     * In the context of an frontend content element the path plugin.tx_solr is
174
     * merged recursive with overrule with the content element specific typoscript
175
     * settings, like plugin.tx_solr_PiResults_Results, and possible flex form settings
176
     * (depends on the solr plugin).
177
     *
178
     * Example: plugin.tx_solr.index.queue.tt_news.fields.content
179
     * returns $GLOBALS['TSFE']->tmpl->setup['plugin.']['tx_solr.']['index.']['queue.']['tt_news.']['fields.']['content.']
180
     * which is a SOLR_CONTENT cObj.
181
     *
182
     * @param string $path TypoScript path
183
     * @return array The TypoScript object defined by the given path
184
     * @throws InvalidArgumentException
185
     */
186 187
    public function getObjectByPath($path)
187
    {
188 187
        if (substr($path, -1) !== '.') {
189 1
            $path = rtrim($path, '.');
190 1
            $path = substr($path, 0, strrpos($path, '.') + 1);
191
        }
192
193 187
        if (!is_string($path)) {
194
            throw new InvalidArgumentException('Parameter $path is not a string', 1325627243);
195
        }
196
197 187
        return $this->configurationAccess->get($path);
198
    }
199
200
    /**
201
     * Gets the parent TypoScript Object from a given TypoScript path and if not present return
202
     * the default value
203
     *
204
     * @see getObjectByPath
205
     * @param string $path
206
     * @param array $defaultValue
207
     * @return array
208
     */
209 182
    public function getObjectByPathOrDefault($path, array $defaultValue)
210
    {
211
        try {
212 182
            $object = $this->getObjectByPath($path);
213
        } catch (\InvalidArgumentException $e) {
214
            return $defaultValue;
215
        }
216
217 182
        if (!is_array($object)) {
218 49
            return $defaultValue;
219
        }
220
221 176
        return $object;
222
    }
223
224
    /**
225
     * Checks whether a given TypoScript path is valid.
226
     *
227
     * @param string $path TypoScript path
228
     * @return bool TRUE if the path resolves, FALSE otherwise
229
     */
230
    public function isValidPath($path)
231
    {
232
        $isValidPath = false;
233
234
        $pathValue = $this->getValueByPath($path);
235
        if (!is_null($pathValue)) {
236
            $isValidPath = true;
237
        }
238
239
        return $isValidPath;
240
    }
241
242
    /**
243
     * Merges a configuration with another configuration a
244
     *
245
     * @param array $configurationToMerge
246
     * @param bool $addKeys If set to FALSE, keys that are NOT found in $original will not be set. Thus only existing value can/will be overruled from overrule array.
247
     * @param bool $includeEmptyValues If set, values from $overrule will overrule if they are empty or zero.
248
     * @param bool $enableUnsetFeature If set, special values "__UNSET" can be used in the overrule array in order to unset array keys in the original array.
249
     * @return TypoScriptConfiguration
250
     */
251 16
    public function mergeSolrConfiguration(array $configurationToMerge, $addKeys = true, $includeEmptyValues = true, $enableUnsetFeature = true)
252
    {
253 16
        $data = $this->configurationAccess->getData();
254 16
        ArrayUtility::mergeRecursiveWithOverrule(
255 16
            $data['plugin.']['tx_solr.'],
256 16
            $configurationToMerge,
257 16
            $addKeys,
258 16
            $includeEmptyValues,
259 16
            $enableUnsetFeature
260
        );
261
262 16
        $this->configurationAccess->setData($data);
263
264 16
        return $this;
265
    }
266
267
    /**
268
     * Returns true when ext_solr is enabled
269
     *
270
     * @param boolean $defaultIfEmpty
271
     * @return boolean
272
     */
273 3
    public function getEnabled($defaultIfEmpty = false)
274
    {
275 3
        $path = 'plugin.tx_solr.enabled';
276 3
        $result = $this->getValueByPathOrDefaultValue($path, $defaultIfEmpty);
277 3
        return $this->getBool($result);
278
    }
279
280
    /**
281
     * Returns the configured additionalFields configured for the indexing.
282
     *
283
     * plugin.tx_solr.index.additionalFields.
284
     *
285
     * @param array $defaultIfEmpty
286
     * @return array
287
     */
288 3
    public function getIndexAdditionalFieldsConfiguration($defaultIfEmpty = [])
289
    {
290 3
        $result = $this->getObjectByPathOrDefault('plugin.tx_solr.index.additionalFields.', $defaultIfEmpty);
291 3
        return $result;
292
    }
293
294
    /**
295
     * Returns all solr fields names where a mapping is configured in index.additionalFields
296
     *
297
     * Returns all keys from
298
     * plugin.tx_solr.index.additionalFields.
299
     *
300
     * @param array $defaultIfEmpty
301
     * @return array
302
     */
303 2
    public function getIndexMappedAdditionalFieldNames($defaultIfEmpty = [])
304
    {
305 2
        $mappingConfiguration = $this->getIndexAdditionalFieldsConfiguration();
306 2
        $mappedFieldNames = $this->getOnlyArrayKeysWhereValueIsNotAnArray($mappingConfiguration);
307 2
        return count($mappedFieldNames) == 0 ? $defaultIfEmpty : $mappedFieldNames;
308
    }
309
310
    /**
311
     * Returns the fieldProcessingInstructions configuration array
312
     *
313
     * plugin.tx_solr.index.fieldProcessingInstructions.
314
     *
315
     * @param array $defaultIfEmpty
316
     * @return array
317
     */
318 74
    public function getIndexFieldProcessingInstructionsConfiguration(array $defaultIfEmpty = [])
319
    {
320 74
        $result = $this->getObjectByPathOrDefault('plugin.tx_solr.index.fieldProcessingInstructions.', $defaultIfEmpty);
321 74
        return $result;
322
    }
323
324
    /**
325
     * Retrieves the indexing configuration array for an indexing queue by configuration name.
326
     *
327
     * plugin.tx_solr.index.queue.<configurationName>.
328
     *
329
     * @param string $configurationName
330
     * @param array $defaultIfEmpty
331
     * @return array
332
     */
333 6
    public function getIndexQueueConfigurationByName($configurationName, array $defaultIfEmpty = [])
334
    {
335 6
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.';
336 6
        $result = $this->getObjectByPathOrDefault($path, $defaultIfEmpty);
337 6
        return $result;
338
    }
339
340
    /**
341
     * Returns an array of all additionalPageIds by index configuration name.
342
     *
343
     * plugin.tx_solr.index.queue.pages.additionalPageIds
344
     *
345
     * @param string $configurationName
346
     * @param array $defaultIfEmpty
347
     * @return array
348
     */
349 42
    public function getIndexQueueAdditionalPageIdsByConfigurationName($configurationName = 'pages', $defaultIfEmpty = [])
350
    {
351 42
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.additionalPageIds';
352 42
        $result = $this->getValueByPathOrDefaultValue($path, '');
353 42
        if (trim($result) === '') {
354 38
            return $defaultIfEmpty;
355
        }
356
357 4
        return GeneralUtility::trimExplode(',', $result);
358
    }
359
360
    /**
361
     * Returns an array of all allowedPageTypes.
362
     *
363
     * plugin.tx_solr.index.queue.pages.allowedPageTypes
364
     *
365
     * @param string $configurationName The configuration name of the queue to use.
366
     * @param array $defaultIfEmpty
367
     * @return array
368
     */
369 30
    public function getIndexQueueAllowedPageTypesArrayByConfigurationName($configurationName = 'pages', $defaultIfEmpty = [])
370
    {
371 30
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.allowedPageTypes';
372 30
        $result = $this->getValueByPathOrDefaultValue($path, '');
373 30
        if (trim($result) === '') {
374
            return $defaultIfEmpty;
375
        }
376
377 30
        return GeneralUtility::trimExplode(',', $result);
378
    }
379
380
    /**
381
     * Returns the configured excludeContentByClass patterns as array.
382
     *
383
     * plugin.tx_solr.index.queue.pages.excludeContentByClass
384
     *
385
     * @param array $defaultIfEmpty
386
     * @return array
387
     */
388 45
    public function getIndexQueuePagesExcludeContentByClassArray($defaultIfEmpty = [])
389
    {
390 45
        $path = 'plugin.tx_solr.index.queue.pages.excludeContentByClass';
391 45
        $result = $this->getValueByPathOrDefaultValue($path, '');
392
393 45
        if (trim($result) === '') {
394 7
            return $defaultIfEmpty;
395
        }
396
397 38
        return GeneralUtility::trimExplode(',', $result);
398
    }
399
400
    /**
401
     * Returns the configured database table for an indexing queue configuration or
402
     * the configurationName itself that is used by convention as tableName when no
403
     * other tablename is present.
404
     *
405
     * plugin.tx_solr.index.queue.<configurationName>.table or configurationName
406
     *
407
     * @param string $configurationName
408
     * @return string
409
     */
410 71
    public function getIndexQueueTableNameOrFallbackToConfigurationName($configurationName = '')
411
    {
412 71
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.table';
413 71
        $result = $this->getValueByPathOrDefaultValue($path, $configurationName);
414 71
        return $result;
415
    }
416
417
    /**
418
     * Returns the field configuration for a specific index queue.
419
     *
420
     * plugin.tx_solr.index.queue.<configurationName>.fields.
421
     *
422
     * @param string $configurationName
423
     * @param array $defaultIfEmpty
424
     * @return array
425
     */
426 31
    public function getIndexQueueFieldsConfigurationByConfigurationName($configurationName = '', $defaultIfEmpty = [])
427
    {
428 31
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.fields.';
429 31
        $result = $this->getObjectByPathOrDefault($path, $defaultIfEmpty);
430 31
        return $result;
431
    }
432
433
    /**
434
     * Gets an array of tables configured for indexing by the Index Queue. Since the
435
     * record monitor must watch these tables for manipulation.
436
     *
437
     * @return array Array of table names to be watched by the record monitor.
438
     */
439 35
    public function getIndexQueueMonitoredTables()
440
    {
441 35
        $monitoredTables = [];
442
443 35
        $indexingConfigurations = $this->getEnabledIndexQueueConfigurationNames();
444 35
        foreach ($indexingConfigurations as $indexingConfigurationName) {
445 35
            $monitoredTable = $this->getIndexQueueTableNameOrFallbackToConfigurationName($indexingConfigurationName);
446 35
            $monitoredTables[] = $monitoredTable;
447 35
            if ($monitoredTable === 'pages') {
448
                // when monitoring pages, also monitor creation of translations
449 35
                $monitoredTables[] = 'pages_language_overlay';
450
            }
451
        }
452
453 35
        return array_values(array_unique($monitoredTables));
454
    }
455
456
    /**
457
     * This method can be used to check if a table is configured to be monitored by the record monitor.
458
     *
459
     * @param string $tableName
460
     * @return bool
461
     */
462 34
    public function getIndexQueueIsMonitoredTable($tableName)
463
    {
464 34
        return in_array($tableName, $this->getIndexQueueMonitoredTables(), true);
465
    }
466
467
    /**
468
     * Returns the configured indexer class that should be used for a certain indexingConfiguration.
469
     * By default "ApacheSolrForTypo3\Solr\IndexQueue\Indexer" will be returned.
470
     *
471
     * plugin.tx_solr.index.queue.<configurationName>.indexer
472
     *
473
     * @param string $configurationName
474
     * @param string $defaultIfEmpty
475
     * @return string
476
     */
477 6
    public function getIndexQueueIndexerByConfigurationName($configurationName, $defaultIfEmpty = Indexer::class)
478
    {
479 6
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.indexer';
480 6
        $result = $this->getValueByPathOrDefaultValue($path, $defaultIfEmpty);
481 6
        return $result;
482
    }
483
484
    /**
485
     * Returns the configuration of an indexer for a special indexingConfiguration. By default an empty
486
     * array is returned.
487
     *
488
     * plugin.tx_solr.index.queue.<configurationName>.indexer.
489
     *
490
     * @param string $configurationName
491
     * @param array $defaultIfEmpty
492
     * @return array
493
     */
494 6
    public function getIndexQueueIndexerConfigurationByConfigurationName($configurationName, $defaultIfEmpty = [])
495
    {
496 6
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.indexer.';
497 6
        $result = $this->getObjectByPathOrDefault($path, $defaultIfEmpty);
498 6
        return $result;
499
    }
500
501
    /**
502
     * Returns all solr fields names where a mapping configuration is set for a certain index configuration
503
     *
504
     * Returns all keys from
505
     * plugin.tx_solr.index.queue.<configurationName>.fields.
506
     *
507
     * @param string $configurationName
508
     * @param array $defaultIfEmpty
509
     * @return array
510
     */
511 11
    public function getIndexQueueMappedFieldsByConfigurationName($configurationName = '', $defaultIfEmpty = [])
512
    {
513 11
        $mappingConfiguration = $this->getIndexQueueFieldsConfigurationByConfigurationName($configurationName);
514 11
        $mappedFieldNames = $this->getOnlyArrayKeysWhereValueIsNotAnArray($mappingConfiguration);
515 11
        return count($mappedFieldNames) == 0 ? $defaultIfEmpty : $mappedFieldNames;
516
    }
517
518
    /**
519
     * This method is used to check if an index queue configuration is enabled or not
520
     *
521
     * plugin.tx_solr.index.queue.<configurationName> = 1
522
     *
523
     * @param string $configurationName
524
     * @param bool $defaultIfEmpty
525
     * @return bool
526
     */
527 66
    public function getIndexQueueConfigurationIsEnabled($configurationName, $defaultIfEmpty = false)
528
    {
529 66
        $path = 'plugin.tx_solr.index.queue.' . $configurationName;
530 66
        $result = $this->getValueByPathOrDefaultValue($path, $defaultIfEmpty);
531 66
        return $this->getBool($result);
532
    }
533
534
    /**
535
     * Retrieves an array of enabled index queue configurations.
536
     *
537
     * plugin.tx_solr.index.queue.<configurationName>
538
     *
539
     * @param array $defaultIfEmpty
540
     * @return array
541
     */
542 73
    public function getEnabledIndexQueueConfigurationNames($defaultIfEmpty = [])
543
    {
544 73
        $tablesToIndex = [];
545 73
        $path = 'plugin.tx_solr.index.queue.';
546 73
        $indexQueueConfiguration = $this->getObjectByPathOrDefault($path, []);
547 73
        foreach ($indexQueueConfiguration as $configurationName => $indexingEnabled) {
548 71
            if (substr($configurationName, -1) != '.' && $indexingEnabled) {
549 71
                $tablesToIndex[] = $configurationName;
550
            }
551
        }
552
553 73
        return count($tablesToIndex) == 0 ? $defaultIfEmpty : $tablesToIndex;
554
    }
555
556
    /**
557
     * Retrieves an array of additional fields that will trigger an recursive update of pages
558
     * when some of the fields on that page are modified.
559
     *
560
     * plugin.tx_solr.index.queue.recursiveUpdateFields
561
     *
562
     * @param string $configurationName
563
     * @param array $defaultIfEmpty
564
     * @return array
565
     */
566 26
    public function getIndexQueueConfigurationRecursiveUpdateFields($configurationName, $defaultIfEmpty = [])
567
    {
568 26
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.recursiveUpdateFields';
569 26
        $recursiveUpdateFieldsString = $this->getValueByPathOrDefaultValue($path, '');
570 26
        if (trim($recursiveUpdateFieldsString) === '') {
571 20
            return $defaultIfEmpty;
572
        }
573 7
        $recursiveUpdateFields = GeneralUtility::trimExplode(',', $recursiveUpdateFieldsString);
574
        // For easier check later on we return an array by combining $recursiveUpdateFields
575 7
        return array_combine($recursiveUpdateFields, $recursiveUpdateFields);
576
    }
577
578
579
    /**
580
     * Retrieves and initialPagesAdditionalWhereClause where clause when configured or an empty string.
581
     *
582
     * plugin.tx_solr.index.queue.<configurationName>.initialPagesAdditionalWhereClause
583
     *
584
     * @param string $configurationName
585
     * @return string
586
     */
587 13
    public function getInitialPagesAdditionalWhereClause($configurationName)
588
    {
589 13
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.initialPagesAdditionalWhereClause';
590 13
        $initialPagesAdditionalWhereClause = $this->getValueByPathOrDefaultValue($path, '');
591
592 13
        if (trim($initialPagesAdditionalWhereClause) === '') {
593 13
            return '';
594
        }
595
596 1
        return ' AND ' . $initialPagesAdditionalWhereClause;
597
    }
598
599
    /**
600
     * Retrieves and additional where clause when configured or an empty string.
601
     *
602
     * plugin.tx_solr.index.queue.<configurationName>.additionalWhereClause
603
     *
604
     * @param string $configurationName
605
     * @return string
606
     */
607 69
    public function getIndexQueueAdditionalWhereClauseByConfigurationName($configurationName)
608
    {
609 69
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.additionalWhereClause';
610 69
        $additionalWhere = $this->getValueByPathOrDefaultValue($path, '');
611
612 69
        if (trim($additionalWhere) === '') {
613 24
            return '';
614
        }
615
616 46
        return ' AND ' . $additionalWhere;
617
    }
618
619
    /**
620
     * This method can be used to retrieve all index queue configuration names, where
621
     * a certain table is used. It can be configured with the property "table" or is using the configuration
622
     * key a fallback for the table name.
623
     *
624
     * plugin.tx_solr.index.queue.<configurationName>.
625
     *
626
     * @param string $tableName
627
     * @param array $defaultIfEmpty
628
     * @return array
629
     */
630 1
    public function getIndexQueueConfigurationNamesByTableName($tableName, $defaultIfEmpty = [])
631
    {
632 1
        $path = 'plugin.tx_solr.index.queue.';
633 1
        $configuration = $this->getObjectByPathOrDefault($path, []);
634 1
        $possibleConfigurations = [];
635
636 1
        foreach ($configuration as $configurationName => $indexingEnabled) {
637 1
            $isObject = substr($configurationName, -1) === '.';
638 1
            if ($isObject || !$indexingEnabled) {
639 1
                continue;
640
            }
641
642
            // when the configuration name equals the tableName we have a fallback
643 1
            $hasTableNameAsConfigurationName = $configurationName == $tableName;
644 1
            $hasTableAssignedInQueueConfiguration = isset($configuration[$configurationName . '.']['table']) &&
645 1
                                                    $configuration[$configurationName . '.']['table'] == $tableName;
646 1
            if ($hasTableNameAsConfigurationName || $hasTableAssignedInQueueConfiguration) {
647 1
                $possibleConfigurations[] = $configurationName;
648
            }
649
        }
650
651 1
        return count($possibleConfigurations) > 0 ? $possibleConfigurations : $defaultIfEmpty;
652
    }
653
654
    /**
655
     * This method is used to retrieve the className of a queue initializer for a certain indexing configuration
656
     * of returns the default initializer class, when noting is configured.
657
     *
658
     * plugin.tx_solr.index.queue.<configurationName>.initialization
659
     *
660
     * @param string $configurationName
661
     * @param string $defaultIfEmpty
662
     * @return string
663
     */
664 6
    public function getIndexQueueInitializerClassByConfigurationName($configurationName, $defaultIfEmpty = Record::class)
665
    {
666 6
        $path = 'plugin.tx_solr.index.queue.' . $configurationName . '.initialization';
667 6
        $className = $this->getValueByPathOrDefaultValue($path, $defaultIfEmpty);
668
669 6
        return $className;
670
    }
671
672
    /**
673
     * Returns the _LOCAL_LANG configuration from the TypoScript.
674
     *
675
     * plugin.tx_solr._LOCAL_LANG.
676
     *
677
     * @param array $defaultIfEmpty
678
     * @return array
679
     */
680
    public function getLocalLangConfiguration(array $defaultIfEmpty = [])
681
    {
682
        $result = $this->getObjectByPathOrDefault('plugin.tx_solr._LOCAL_LANG.', $defaultIfEmpty);
683
        return $result;
684
    }
685
686
    /**
687
     * When this is enabled the output of the devlog, will be printed as debug output.
688
     *
689
     * @param bool $defaultIfEmpty
690
     * @return bool
691
     */
692
    public function getLoggingDebugOutput($defaultIfEmpty = false)
693
    {
694
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.debugOutput', $defaultIfEmpty);
695
        return $this->getBool($result);
696
    }
697
698
    /**
699
     * Returns if query filters should be written to the log.
700
     *
701
     * plugin.tx_solr.logging.query.filters
702
     *
703
     * @param bool $defaultIfEmpty
704
     * @return bool
705
     */
706
    public function getLoggingQueryFilters($defaultIfEmpty = false)
707
    {
708
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.query.filters', $defaultIfEmpty);
709
        return $this->getBool($result);
710
    }
711
712
    /**
713
     * Returns if the querystring should be logged or not.
714
     *
715
     * plugin.tx_solr.logging.query.queryString
716
     *
717
     * @param bool $defaultIfEmpty
718
     * @return bool
719
     */
720 35
    public function getLoggingQueryQueryString($defaultIfEmpty = false)
721
    {
722 35
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.query.queryString', $defaultIfEmpty);
723 35
        return $this->getBool($result);
724
    }
725
726
    /**
727
     * Returns if the searchWords should be logged or not.
728
     *
729
     * plugin.tx_solr.logging.query.searchWords
730
     *
731
     * @param bool $defaultIfEmpty
732
     * @return bool
733
     */
734 32
    public function getLoggingQuerySearchWords($defaultIfEmpty = false)
735
    {
736 32
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.query.searchWords', $defaultIfEmpty);
737 32
        return $this->getBool($result);
738
    }
739
740
    /**
741
     * Returns if the rawGet requests should be logged or not.
742
     *
743
     * plugin.tx_solr.logging.query.rawGet
744
     *
745
     * @param bool $defaultIfEmpty
746
     * @return bool
747
     */
748 51
    public function getLoggingQueryRawGet($defaultIfEmpty = false)
749
    {
750 51
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.query.rawGet', $defaultIfEmpty);
751 51
        return $this->getBool($result);
752
    }
753
754
    /**
755
     * Returns if the rawPost requests should be logged or not.
756
     *
757
     * plugin.tx_solr.logging.query.rawPost
758
     *
759
     * @param bool $defaultIfEmpty
760
     * @return bool
761
     */
762 83
    public function getLoggingQueryRawPost($defaultIfEmpty = false)
763
    {
764 83
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.query.rawPost', $defaultIfEmpty);
765 83
        return $this->getBool($result);
766
    }
767
768
    /**
769
     * Returns if the rawDelete requests should be logged or not.
770
     *
771
     * plugin.tx_solr.logging.query.rawDelete
772
     *
773
     * @param bool $defaultIfEmpty
774
     * @return bool
775
     */
776 4
    public function getLoggingQueryRawDelete($defaultIfEmpty = false)
777
    {
778 4
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.query.rawDelete', $defaultIfEmpty);
779 4
        return $this->getBool($result);
780
    }
781
782
    /**
783
     * Returns if exceptions should be logged or not.
784
     *
785
     * plugin.tx_solr.logging.exceptions
786
     *
787
     * @param bool $defaultIfEmpty
788
     * @return bool
789
     */
790 4
    public function getLoggingExceptions($defaultIfEmpty = true)
791
    {
792 4
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.exceptions', $defaultIfEmpty);
793 4
        return $this->getBool($result);
794
    }
795
796
    /**
797
     * Returns if indexing operations should be logged or not.
798
     *
799
     * plugin.tx_solr.logging.indexing
800
     *
801
     * @param bool $defaultIfEmpty
802
     * @return bool
803
     */
804 22
    public function getLoggingIndexing($defaultIfEmpty = false)
805
    {
806 22
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.indexing', $defaultIfEmpty);
807 22
        return $this->getBool($result);
808
    }
809
810
    /**
811
     * Returns if indexing queue operations should be logged or not.
812
     *
813
     * plugin.tx_solr.logging.indexing.queue
814
     *
815
     * @param bool $defaultIfEmpty
816
     * @return bool
817
     */
818 21
    public function getLoggingIndexingQueue($defaultIfEmpty = false)
819
    {
820 21
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.indexing.queue', $defaultIfEmpty);
821 21
        return $this->getBool($result);
822
    }
823
824
    /**
825
     * This method can be used to check if the logging during indexing should be done.
826
     * It takes the specific configuration by indexQueueConfiguration into account or is using the
827
     * fallback when the logging is enabled on queue or indexing level.
828
     *
829
     * plugin.tx_solr.logging.indexing.queue.<indexQueueConfiguration>
830
     *
831
     * @param string $indexQueueConfiguration
832
     * @param bool $defaultIfEmpty
833
     * @return bool
834
     */
835 22
    public function getLoggingIndexingQueueOperationsByConfigurationNameWithFallBack($indexQueueConfiguration, $defaultIfEmpty = false)
836
    {
837
        // when logging is globally enabled we do not need to check the specific configuration
838 22
        if ($this->getLoggingIndexing()) {
839 1
            return true;
840
        }
841
842
        // when the logging for indexing is enabled on queue level we also do not need to check the specific configuration
843 21
        if ($this->getLoggingIndexingQueue()) {
844
            return true;
845
        }
846
847 21
        $path = 'plugin.tx_solr.logging.indexing.queue.' . $indexQueueConfiguration;
848 21
        $result = $this->getValueByPathOrDefaultValue($path, $defaultIfEmpty);
849 21
        return $this->getBool($result);
850
    }
851
852
    /**
853
     * Returns if a log message should be written when a page was indexed.
854
     *
855
     * plugin.tx_solr.logging.indexing.pageIndexed
856
     *
857
     * @param bool $defaultIfEmpty
858
     * @return bool
859
     */
860 10
    public function getLoggingIndexingPageIndexed($defaultIfEmpty = false)
861
    {
862 10
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.indexing.pageIndexed', $defaultIfEmpty);
863 10
        return $this->getBool($result);
864
    }
865
866
    /**
867
     * Returns if a log message should be written when the TYPO3 search markers are missing in the page.
868
     *
869
     * plugin.tx_solr.logging.indexing.missingTypo3SearchMarkers
870
     *
871
     * @param bool $defaultIfEmpty
872
     * @return bool
873
     */
874 11
    public function getLoggingIndexingMissingTypo3SearchMarkers($defaultIfEmpty = true)
875
    {
876 11
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.indexing.missingTypo3SearchMarkers', $defaultIfEmpty);
877 11
        return $this->getBool($result);
878
    }
879
880
    /**
881
     * Returns if the initialization of an indexqueue should be logged.
882
     *
883
     * plugin.tx_solr.logging.indexing.indexQueueInitialization
884
     *
885
     * @param bool $defaultIfEmpty
886
     * @return bool
887
     */
888 12
    public function getLoggingIndexingIndexQueueInitialization($defaultIfEmpty = false)
889
    {
890 12
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.logging.indexing.indexQueueInitialization', $defaultIfEmpty);
891 12
        return $this->getBool($result);
892
    }
893
894
    /**
895
     * Indicates if the debug mode is enabled or not.
896
     *
897
     * plugin.tx_solr.enableDebugMode
898
     *
899
     * @param bool $defaultIfEmpty
900
     * @return bool
901
     */
902 32
    public function getEnabledDebugMode($defaultIfEmpty = false)
903
    {
904 32
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.enableDebugMode', $defaultIfEmpty);
905 32
        return $this->getBool($result);
906
    }
907
908
    /**
909
     * Returns true or false if something is configured below plugin.tx_solr.solr.
910
     *
911
     * plugin.tx_solr.solr.
912
     *
913
     * @param boolean $defaultIfEmpty
914
     * @return boolean
915
     */
916 3
    public function getSolrHasConnectionConfiguration($defaultIfEmpty = false)
917
    {
918 3
        $configuration = $this->getObjectByPathOrDefault('plugin.tx_solr.solr.', []);
919 3
        return $configuration !== [] ? true : $defaultIfEmpty;
920
    }
921
922
    /**
923
     * Returns the defaultTimeout used for requests to the Solr server
924
     *
925
     * plugin.tx_solr.solr.timeout
926
     *
927
     * @param float $defaultIfEmpty
928
     * @return float
929
     */
930 107
    public function getSolrTimeout($defaultIfEmpty = 0.0)
931
    {
932 107
        return (float)$this->getValueByPathOrDefaultValue('plugin.tx_solr.solr.timeout', $defaultIfEmpty);
933
    }
934
935
    /**
936
     * Returns the scheme used for requests to the Solr server
937
     *
938
     * plugin.tx_solr.solr.scheme
939
     *
940
     * Applies stdWrap on the configured setting
941
     *
942
     * @param string $defaultIfEmpty
943
     * @return string
944
     */
945 4
    public function getSolrScheme($defaultIfEmpty = 'http')
946
    {
947 4
        $valuePath = 'plugin.tx_solr.solr.scheme';
948 4
        $value = (string)$this->getValueByPathOrDefaultValue($valuePath, $defaultIfEmpty);
949 4
        return $this->renderContentElementOfConfigured($valuePath, $value);
950
    }
951
952
    /**
953
     * Returns the hostname used for requests to the Solr server
954
     *
955
     * plugin.tx_solr.solr.host
956
     *
957
     * Applies stdWrap on the configured setting
958
     *
959
     * @param string $defaultIfEmpty
960
     * @return string
961
     */
962 7
    public function getSolrHost($defaultIfEmpty = 'localhost')
963
    {
964 7
        $valuePath = 'plugin.tx_solr.solr.host';
965 7
        $value = (string)$this->getValueByPathOrDefaultValue($valuePath, $defaultIfEmpty);
966 7
        return $this->renderContentElementOfConfigured($valuePath, $value);
967
    }
968
969
    /**
970
     * Returns the port used for requests to the Solr server
971
     *
972
     * plugin.tx_solr.solr.port
973
     *
974
     * Applies stdWrap on the configured setting
975
     *
976
     * @param int $defaultIfEmpty
977
     * @return int
978
     */
979 4
    public function getSolrPort($defaultIfEmpty = 8983)
980
    {
981 4
        $valuePath = 'plugin.tx_solr.solr.port';
982 4
        $value = (string)$this->getValueByPathOrDefaultValue($valuePath, $defaultIfEmpty);
983 4
        return $this->renderContentElementOfConfigured($valuePath, $value);
984
    }
985
986
    /**
987
     * Returns the path used for requests to the Solr server
988
     *
989
     * plugin.tx_solr.solr.path
990
     *
991
     * Applies stdWrap on the configured setting
992
     *
993
     * @param string $defaultIfEmpty
994
     * @return string
995
     */
996 7
    public function getSolrPath($defaultIfEmpty = '/solr/core_en/')
997
    {
998 7
        $valuePath = 'plugin.tx_solr.solr.path';
999 7
        $value = (string)$this->getValueByPathOrDefaultValue($valuePath, $defaultIfEmpty);
1000 7
        $solrPath = $this->renderContentElementOfConfigured($valuePath, $value);
1001
1002 7
        $solrPath = trim($solrPath, '/');
1003 7
        $solrPath = '/' . $solrPath . '/';
1004
1005 7
        return $solrPath;
1006
    }
1007
1008
    /**
1009
     * Returns the username used for requests to the Solr server
1010
     *
1011
     * plugin.tx_solr.solr.username
1012
     *
1013
     * Applies stdWrap on the configured setting
1014
     *
1015
     * @param string $defaultIfEmpty
1016
     * @return string
1017
     */
1018 4
    public function getSolrUsername($defaultIfEmpty = '')
1019
    {
1020 4
        $valuePath = 'plugin.tx_solr.solr.username';
1021 4
        $value = (string)$this->getValueByPathOrDefaultValue($valuePath, $defaultIfEmpty);
1022 4
        return $this->renderContentElementOfConfigured($valuePath, $value);
1023
    }
1024
1025
    /**
1026
     * Returns the password used for requests to the Solr server
1027
     *
1028
     * plugin.tx_solr.solr.password
1029
     *
1030
     * Applies stdWrap on the configured setting
1031
     *
1032
     * @param string $defaultIfEmpty
1033
     * @return string
1034
     */
1035 4
    public function getSolrPassword($defaultIfEmpty = '')
1036
    {
1037 4
        $valuePath = 'plugin.tx_solr.solr.password';
1038 4
        $value = (string)$this->getValueByPathOrDefaultValue($valuePath, $defaultIfEmpty);
1039 4
        return $this->renderContentElementOfConfigured($valuePath, $value);
1040
    }
1041
1042
    /**
1043
     * Retrieves the complete search configuration
1044
     *
1045
     * plugin.tx_solr.search.
1046
     *
1047
     * @param array $defaultIfEmpty
1048
     * @return array
1049
     */
1050 32
    public function getSearchConfiguration(array $defaultIfEmpty = [])
1051
    {
1052 32
        $result = $this->getObjectByPathOrDefault('plugin.tx_solr.search.', $defaultIfEmpty);
1053 32
        return $result;
1054
    }
1055
1056
    /**
1057
     * Indicates if elevation should be used or not
1058
     *
1059
     * plugin.tx_solr.search.elevation
1060
     *
1061
     * @param bool $defaultIfEmpty
1062
     * @return bool
1063
     */
1064 32
    public function getSearchElevation($defaultIfEmpty = false)
1065
    {
1066 32
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.elevation', $defaultIfEmpty);
1067 32
        return $this->getBool($result);
1068
    }
1069
1070
    /**
1071
     * Indicates if elevated results should be marked
1072
     *
1073
     * plugin.tx_solr.search.elevation.markElevatedResults
1074
     *
1075
     * @param bool $defaultIfEmpty
1076
     * @return bool
1077
     */
1078 32
    public function getSearchElevationMarkElevatedResults($defaultIfEmpty = true)
1079
    {
1080 32
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.elevation.markElevatedResults', $defaultIfEmpty);
1081 32
        return $this->getBool($result);
1082
    }
1083
1084
    /**
1085
     * Indicates if elevation should be forced
1086
     *
1087
     *plugin.tx_solr.search.elevation.forceElevation
1088
     *
1089
     * @param bool $defaultIfEmpty
1090
     * @return bool
1091
     */
1092 32
    public function getSearchElevationForceElevation($defaultIfEmpty = true)
1093
    {
1094 32
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.elevation.forceElevation', $defaultIfEmpty);
1095 32
        return $this->getBool($result);
1096
    }
1097
1098
    /**
1099
     * Indicates if collapsing on a certain field should be used to build variants or not.
1100
     *
1101
     * plugin.tx_solr.search.variants
1102
     *
1103
     * @param bool $defaultIfEmpty
1104
     * @return bool
1105
     */
1106 114
    public function getSearchVariants($defaultIfEmpty = false)
1107
    {
1108 114
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.variants', $defaultIfEmpty);
1109 114
        return $this->getBool($result);
1110
    }
1111
1112
    /**
1113
     * Indicates if collapsing on a certain field should be used or not
1114
     *
1115
     * plugin.tx_solr.search.variants.variantField
1116
     *
1117
     * @param string $defaultIfEmpty
1118
     * @return string
1119
     */
1120 3
    public function getSearchVariantsField($defaultIfEmpty = 'variantId')
1121
    {
1122 3
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.variants.variantField', $defaultIfEmpty);
1123
    }
1124
1125
    /**
1126
     * Indicates if expanding of collapsed items it activated.
1127
     *
1128
     * plugin.tx_solr.search.variants.expand
1129
     *
1130
     * @param bool $defaultIfEmpty
1131
     * @return bool
1132
     */
1133 5
    public function getSearchVariantsExpand($defaultIfEmpty = false)
1134
    {
1135 5
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.variants.expand', $defaultIfEmpty);
1136 5
        return $this->getBool($result);
1137
    }
1138
1139
    /**
1140
     * Retrieves the number of elements that should be expanded.
1141
     *
1142
     * plugin.tx_solr.search.variants.limit
1143
     *
1144
     * @param int $defaultIfEmpty
1145
     * @return int
1146
     */
1147 2
    public function getSearchVariantsLimit($defaultIfEmpty = 10)
1148
    {
1149 2
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.variants.limit', $defaultIfEmpty);
1150 2
        return (int)$result;
1151
    }
1152
1153
    /**
1154
     * Indicates if frequent searches should be show or not.
1155
     *
1156
     * plugin.tx_solr.search.frequentSearches
1157
     *
1158
     * @param bool $defaultIfEmpty
1159
     * @return bool
1160
     */
1161 25
    public function getSearchFrequentSearches($defaultIfEmpty = false)
1162
    {
1163 25
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.frequentSearches', $defaultIfEmpty);
1164 25
        return $this->getBool($result);
1165
    }
1166
1167
    /**
1168
     * Returns the sub configuration of the frequentSearches
1169
     *
1170
     * plugin.tx_solr.search.frequentSearches.
1171
     *
1172
     * @param array $defaultIfEmpty
1173
     * @return array
1174
     */
1175 29
    public function getSearchFrequentSearchesConfiguration($defaultIfEmpty = [])
1176
    {
1177 29
        $result = $this->getObjectByPathOrDefault('plugin.tx_solr.search.frequentSearches.', $defaultIfEmpty);
1178 29
        return $result;
1179
    }
1180
1181
    /**
1182
     * Retrieves the minimum font size that should be used for the frequentSearches.
1183
     *
1184
     * plugin.tx_solr.search.frequentSearches.minSize
1185
     *
1186
     * @param int $defaultIfEmpty
1187
     * @return int
1188
     */
1189 29
    public function getSearchFrequentSearchesMinSize($defaultIfEmpty = 14)
1190
    {
1191 29
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.frequentSearches.minSize', $defaultIfEmpty);
1192 29
        return (int)$result;
1193
    }
1194
1195
    /**
1196
     * Retrieves the maximum font size that should be used for the frequentSearches.
1197
     *
1198
     * plugin.tx_solr.search.frequentSearches.minSize
1199
     *
1200
     * @param int $defaultIfEmpty
1201
     * @return int
1202
     */
1203 29
    public function getSearchFrequentSearchesMaxSize($defaultIfEmpty = 32)
1204
    {
1205 29
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.frequentSearches.maxSize', $defaultIfEmpty);
1206 29
        return (int)$result;
1207
    }
1208
1209
    /**
1210
     * Indicates if frequent searches should be show or not.
1211
     *
1212
     * plugin.tx_solr.search.frequentSearches.useLowercaseKeywords
1213
     *
1214
     * @param bool $defaultIfEmpty
1215
     * @return bool
1216
     */
1217 27
    public function getSearchFrequentSearchesUseLowercaseKeywords($defaultIfEmpty = false)
1218
    {
1219 27
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.frequentSearches.useLowercaseKeywords', $defaultIfEmpty);
1220 27
        return $this->getBool($result);
1221
    }
1222
1223
    /**
1224
     * Returns the configuration if the search should be initialized with an empty query.
1225
     *
1226
     * plugin.tx_solr.search.initializeWithEmptyQuery
1227
     *
1228
     * @param bool $defaultIfEmpty
1229
     * @return bool
1230
     */
1231 34
    public function getSearchInitializeWithEmptyQuery($defaultIfEmpty = false)
1232
    {
1233 34
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.initializeWithEmptyQuery', $defaultIfEmpty);
1234 34
        return $this->getBool($result);
1235
    }
1236
1237
    /**
1238
     * Returns the configured initial query
1239
     *
1240
     * plugin.tx_solr.search.initializeWithQuery
1241
     *
1242
     * @param string $defaultIfEmpty
1243
     * @return string
1244
     */
1245 34
    public function getSearchInitializeWithQuery($defaultIfEmpty = '')
1246
    {
1247 34
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.initializeWithQuery', $defaultIfEmpty);
1248 34
        return (string)$result;
1249
    }
1250
1251
    /**
1252
     * Returns if the last searches should be displayed or not.
1253
     *
1254
     * plugin.tx_solr.search.lastSearches
1255
     *
1256
     * @param bool $defaultIfEmpty
1257
     * @return bool
1258
     */
1259 25
    public function getSearchLastSearches($defaultIfEmpty = false)
1260
    {
1261 25
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.lastSearches', $defaultIfEmpty);
1262 25
        return $this->getBool($result);
1263
    }
1264
1265
    /**
1266
     * Returns the lastSearch mode. "user" for user specific
1267
     *
1268
     * plugin.tx_solr.search.lastSearches.mode
1269
     *
1270
     * @param string $defaultIfEmpty
1271
     * @return string
1272
     */
1273 29
    public function getSearchLastSearchesMode($defaultIfEmpty = 'user')
1274
    {
1275 29
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.lastSearches.mode', $defaultIfEmpty);
1276 29
        return (string)$result;
1277
    }
1278
1279
    /**
1280
     * Returns the lastSearch limit
1281
     *
1282
     * plugin.tx_solr.search.lastSearches.limit
1283
     *
1284
     * @param int $defaultIfEmpty
1285
     * @return int
1286
     */
1287 29
    public function getSearchLastSearchesLimit($defaultIfEmpty = 10)
1288
    {
1289 29
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.lastSearches.limit', $defaultIfEmpty);
1290 29
        return (int)$result;
1291
    }
1292
1293
    /**
1294
     * Indicates if the results of an initial empty query should be shown or not.
1295
     *
1296
     * plugin.tx_solr.search.showResultsOfInitialEmptyQuery
1297
     *
1298
     * @param bool $defaultIfEmpty
1299
     * @return bool
1300
     */
1301 7
    public function getSearchShowResultsOfInitialEmptyQuery($defaultIfEmpty = false)
1302
    {
1303 7
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.showResultsOfInitialEmptyQuery', $defaultIfEmpty);
1304 7
        return $this->getBool($result);
1305
    }
1306
1307
    /**
1308
     * Indicates if the results of an initial search query should be shown.
1309
     *
1310
     * plugin.tx_solr.search.showResultsOfInitialQuery
1311
     *
1312
     * @param bool $defaultIfEmpty
1313
     * @return bool
1314
     */
1315 5
    public function getSearchShowResultsOfInitialQuery($defaultIfEmpty = false)
1316
    {
1317 5
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.showResultsOfInitialQuery', $defaultIfEmpty);
1318 5
        return $this->getBool($result);
1319
    }
1320
1321
    /**
1322
     * Indicates if sorting was enabled or not.
1323
     *
1324
     * plugin.tx_solr.search.sorting
1325
     *
1326
     * @param bool $defaultIfEmpty
1327
     * @return bool
1328
     */
1329 59
    public function getSearchSorting($defaultIfEmpty = false)
1330
    {
1331 59
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.sorting', $defaultIfEmpty);
1332 59
        return $this->getBool($result);
1333
    }
1334
1335
    /**
1336
     * Returns the sorting options configurations.
1337
     *
1338
     * plugin.tx_solr.search.sorting.options.
1339
     *
1340
     * @param array $defaultIfEmpty
1341
     * @return array
1342
     */
1343 29
    public function getSearchSortingOptionsConfiguration($defaultIfEmpty = [])
1344
    {
1345 29
        $result = $this->getObjectByPathOrDefault('plugin.tx_solr.search.sorting.options.', $defaultIfEmpty);
1346 29
        return $result;
1347
    }
1348
1349
    /**
1350
     * Retrieves the sorting default order for a sort option.
1351
     *
1352
     * plugin.tx_solr.search.sorting.options.<sortOptionName>.defaultOrder
1353
     *
1354
     * or
1355
     *
1356
     * plugin.tx_solr.search.sorting.defaultOrder
1357
     *
1358
     *
1359
     * @param string $sortOptionName
1360
     * @param string $defaultIfEmpty
1361
     * @return string
1362
     */
1363 32
    public function getSearchSortingDefaultOrderBySortOptionName($sortOptionName = '', $defaultIfEmpty = 'asc')
1364
    {
1365 32
        $sortOrderSpecificPath = 'plugin.tx_solr.search.sorting.options.' . $sortOptionName . '.defaultOrder';
1366 32
        $specificSortOrder = $this->getValueByPathOrDefaultValue($sortOrderSpecificPath, null);
1367
1368
        // if we have a concrete setting, use it
1369 32
        if ($specificSortOrder !== null) {
1370 2
            return mb_strtolower($specificSortOrder);
1371
        }
1372
1373
        // no specific setting, check common setting
1374 30
        $commonPath = 'plugin.tx_solr.search.sorting.defaultOrder';
1375 30
        $commonATagParamOrDefaultValue = $this->getValueByPathOrDefaultValue($commonPath, $defaultIfEmpty);
1376 30
        return mb_strtolower($commonATagParamOrDefaultValue);
1377
    }
1378
1379
    /**
1380
     * Returns the configured fixedOrder, if nothing configured defaultIfEmpty will be returned.
1381
     *
1382
     * plugin.tx_solr.search.sorting.options.<sortOptionName>.fixedOrder
1383
     *
1384
     * @param string $sortOptionName
1385
     * @param string $defaultIfEmpty
1386
     * @return string
1387
     */
1388
    public function getSearchSortingFixedOrderBySortOptionName($sortOptionName = '', $defaultIfEmpty = '')
1389
    {
1390
        $fixedOrder = 'plugin.tx_solr.search.sorting.options.' . $sortOptionName . '.fixedOrder';
1391
        return mb_strtolower($this->getValueByPathOrDefaultValue($fixedOrder, $defaultIfEmpty));
1392
    }
1393
1394
    /**
1395
     * Returns the trusted fields configured for the search that do not need to be escaped.
1396
     *
1397
     * @param array $defaultIfEmpty
1398
     * @return array
1399
     */
1400 35
    public function getSearchTrustedFieldsArray($defaultIfEmpty = ['url'])
1401
    {
1402 35
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.trustedFields', '');
1403
1404 35
        if (trim($result) === '') {
1405 3
            return $defaultIfEmpty;
1406
        }
1407
1408 32
        return GeneralUtility::trimExplode(',', $result);
1409
    }
1410
1411
    /**
1412
     * Indicates if the plugin arguments should be kept in the search form for a second submission.
1413
     *
1414
     * plugin.tx_solr.search.keepExistingParametersForNewSearches
1415
     *
1416
     * @param bool $defaultIfEmpty
1417
     * @return bool
1418
     */
1419
    public function getSearchKeepExistingParametersForNewSearches($defaultIfEmpty = false)
1420
    {
1421
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.keepExistingParametersForNewSearches', $defaultIfEmpty);
1422
        return $this->getBool($result);
1423
    }
1424
1425
    /**
1426
     * Returns if an empty query is allowed on the query level.
1427
     *
1428
     * plugin.tx_solr.search.query.allowEmptyQuery
1429
     *
1430
     * @param string $defaultIfEmpty
1431
     * @return bool
1432
     */
1433 29
    public function getSearchQueryAllowEmptyQuery($defaultIfEmpty = '')
1434
    {
1435 29
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.query.allowEmptyQuery', $defaultIfEmpty);
1436 29
        return $this->getBool($result);
1437
    }
1438
1439
    /**
1440
     * Returns the filter configuration array
1441
     *
1442
     * plugin.tx_solr.search.query.filter.
1443
     *
1444
     * @param array $defaultIfEmpty
1445
     * @return array
1446
     */
1447 41
    public function getSearchQueryFilterConfiguration(array $defaultIfEmpty = [])
1448
    {
1449 41
        $result = $this->getObjectByPathOrDefault('plugin.tx_solr.search.query.filter.', $defaultIfEmpty);
1450 41
        return $result;
1451
    }
1452
1453
    /**
1454
     * Can be used to overwrite the filterConfiguration.
1455
     *
1456
     * plugin.tx_solr.search.query.filter.
1457
     *
1458
     * @param array $configuration
1459
     */
1460 1
    public function setSearchQueryFilterConfiguration(array $configuration)
1461
    {
1462 1
        $this->configurationAccess->set('plugin.tx_solr.search.query.filter.', $configuration);
1463 1
    }
1464
1465
    /**
1466
     * Removes the pageSections filter setting.
1467
     *
1468
     * @return void
1469
     */
1470 2
    public function removeSearchQueryFilterForPageSections()
1471
    {
1472 2
        $this->configurationAccess->reset('plugin.tx_solr.search.query.filter.__pageSections');
1473 2
    }
1474
1475
    /**
1476
     * Returns the configured queryFields from TypoScript
1477
     *
1478
     * plugin.tx_solr.search.query.queryFields
1479
     *
1480
     * @param string $defaultIfEmpty
1481
     * @return string
1482
     */
1483 114
    public function getSearchQueryQueryFields($defaultIfEmpty = '')
1484
    {
1485 114
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.query.queryFields', $defaultIfEmpty);
1486
    }
1487
1488
    /**
1489
     * This method is used to check if a phrase search is enabled or not
1490
     *
1491
     * plugin.tx_solr.search.query.phrase = 1
1492
     *
1493
     * @param bool $defaultIfEmpty
1494
     * @return bool
1495
     */
1496 116
    public function getPhraseSearchIsEnabled(bool $defaultIfEmpty = false)
1497
    {
1498 116
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.query.phrase', $defaultIfEmpty);
1499 116
        return $this->getBool($result);
1500 78
    }
1501
1502
    /**
1503 38
     * Returns the configured phrase fields from TypoScript
1504
     *
1505
     * plugin.tx_solr.search.query.phrase.fields
1506
     *
1507
     * @param string $defaultIfEmpty
1508
     * @return string
1509
     */
1510
    public function getSearchQueryPhraseFields(string $defaultIfEmpty = '')
1511
    {
1512
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.query.phrase.fields', $defaultIfEmpty);
1513
    }
1514 120
1515
    /**
1516 120
     * This method is used to check if a bigram phrase search is enabled or not
1517 120
     *
1518
     * plugin.tx_solr.search.query.bigramPhrase = 1
1519 119
     *
1520
     * @param bool $defaultIfEmpty
1521
     * @return bool
1522 120
     */
1523
    public function getBigramPhraseSearchIsEnabled(bool $defaultIfEmpty = false)
1524
    {
1525
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.query.bigramPhrase', $defaultIfEmpty);
1526
        return $this->getBool($result);
1527
    }
1528
1529
    /**
1530
     * Returns the configured phrase fields from TypoScript
1531
     *
1532
     * plugin.tx_solr.search.query.bigramPhrase.fields
1533
     *
1534
     * @param string $defaultIfEmpty
1535
     * @return string
1536
     */
1537
    public function getSearchQueryBigramPhraseFields(string $defaultIfEmpty = '')
1538
    {
1539
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.query.bigramPhrase.fields', $defaultIfEmpty);
1540
    }
1541
1542
    /**
1543
     * This method is used to check if a trigram phrase search is enabled or not
1544
     *
1545
     * plugin.tx_solr.search.query.trigramPhrase = 1
1546
     *
1547
     * @param bool $defaultIfEmpty
1548 22
     * @return bool
1549
     */
1550 22
    public function getTrigramPhraseSearchIsEnabled(bool $defaultIfEmpty = false)
1551 22
    {
1552
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.query.trigramPhrase', $defaultIfEmpty);
1553
        return $this->getBool($result);
1554
    }
1555
1556
    /**
1557
     * Returns the configured trigram phrase fields from TypoScript
1558
     *
1559
     * plugin.tx_solr.search.query.trigramPhrase.fields
1560
     *
1561
     * @param string $defaultIfEmpty
1562
     * @return string
1563 114
     */
1564
    public function getSearchQueryTrigramPhraseFields(string $defaultIfEmpty = '')
1565 114
    {
1566 114
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.query.trigramPhrase.fields', $defaultIfEmpty);
1567
    }
1568
1569
    /**
1570
     * Returns the configured returnFields as array.
1571
     *
1572
     * plugin.tx_solr.search.query.returnFields
1573
     *
1574
     * @param array $defaultIfEmpty
1575
     * @return array
1576
     */
1577 39
    public function getSearchQueryReturnFieldsAsArray($defaultIfEmpty = [])
1578
    {
1579 39
        $returnFields = $this->getValueByPath('plugin.tx_solr.search.query.returnFields');
1580
        if (is_null($returnFields)) {
1581
            return $defaultIfEmpty;
1582
        }
1583
1584
        return GeneralUtility::trimExplode(',', $returnFields);
1585
    }
1586
1587
    /**
1588
     * Returns the configured target page for the search.
1589
     * By default the contextPageId will be used
1590
     *
1591
     * plugin.tx_solr.search.targetPage
1592
     *
1593
     * @return int
1594
     */
1595
    public function getSearchTargetPage()
1596
    {
1597
        $targetPage = (int)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.targetPage', 0);
1598
        if ($targetPage === 0) {
1599
            // when no specific page was configured we use the contextPageId (which is usual $GLOBALS['TSFE']->id)
1600
            $targetPage = $this->contextPageId;
1601
        }
1602
1603
        return $targetPage;
1604
    }
1605
1606
    /**
1607
     * Retrieves the targetPage configuration.
1608
     *
1609 39
     * plugin.tx_solr.search.targetPage.
1610
     *
1611 39
     * @param array $defaultIfEmpty
1612
     * @return array
1613
     */
1614
    public function getSearchTargetPageConfiguration(array $defaultIfEmpty = [])
1615
    {
1616
        $result = $this->getObjectByPathOrDefault('plugin.tx_solr.search.targetPage.', $defaultIfEmpty);
1617
        return $result;
1618
    }
1619
1620
    /**
1621
     * Method to check if the site highlighting is enabled. When the siteHighlighting is enabled the
1622 22
     * sword_list parameter is added to the results link.
1623
     *
1624 22
     * plugin.tx_solr.searcb.results.siteHighlighting
1625
     *
1626
     * @param bool $defaultIfEmpty
1627
     * @return bool
1628
     */
1629
    public function getSearchResultsSiteHighlighting($defaultIfEmpty = true)
1630
    {
1631
        $isSiteHightlightingEnabled = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.results.siteHighlighting', $defaultIfEmpty);
1632
        return $this->getBool($isSiteHightlightingEnabled);
1633
    }
1634
1635 30
1636
    /**
1637 30
     * Can be used to check if the highlighting is enabled
1638
     *
1639
     * plugin.tx_solr.search.results.resultsHighlighting
1640
     *
1641
     * @param boolean $defaultIfEmpty
1642
     * @return string
1643
     */
1644
    public function getSearchResultsHighlighting($defaultIfEmpty = false)
1645
    {
1646
        $isHighlightingEnabled = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.results.resultsHighlighting', $defaultIfEmpty);
1647
        return $this->getBool($isHighlightingEnabled);
1648 30
    }
1649
1650 30
    /**
1651
     * Returns the result highlighting fields.
1652 30
     *
1653
     * plugin.tx_solr.search.results.resultsHighlighting.highlightFields
1654
     *
1655
     * @param string $defaultIfEmpty
1656 30
     * @return string
1657
     */
1658
    public function getSearchResultsHighlightingFields($defaultIfEmpty = '')
1659
    {
1660
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.results.resultsHighlighting.highlightFields', $defaultIfEmpty);
1661
    }
1662
1663
    /**
1664
     * Returns the result highlighting fields as array.
1665
     *
1666
     * plugin.tx_solr.search.results.resultsHighlighting.highlightFields
1667 39
     *
1668
     * @param array $defaultIfEmpty
1669 39
     * @return array
1670
     */
1671
    public function getSearchResultsHighlightingFieldsAsArray($defaultIfEmpty = [])
1672
    {
1673
        $highlightingFields = $this->getSearchResultsHighlightingFields('');
1674
1675
        if ($highlightingFields === '') {
1676
            return $defaultIfEmpty;
1677
        }
1678
1679
        return GeneralUtility::trimExplode(',', $highlightingFields, true);
1680
    }
1681
1682
    /**
1683
     * Returns the fragmentSize for highlighted segments.
1684
     *
1685
     * plugin.tx_solr.search.results.resultsHighlighting.fragmentSize
1686
     *
1687
     * @param int $defaultIfEmpty
1688
     * @return int
1689
     */
1690
    public function getSearchResultsHighlightingFragmentSize($defaultIfEmpty = 200)
1691
    {
1692
        return (int)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.results.resultsHighlighting.fragmentSize', $defaultIfEmpty);
1693
    }
1694
1695
    /**
1696
     * Returns the fragmentSeparator for highlighted segments.
1697
     *
1698
     * plugin.tx_solr.search.results.resultsHighlighting.fragmentSeparator
1699
     *
1700
     * @param string $defaultIfEmpty
1701
     * @return string
1702
     */
1703
    public function getSearchResultsHighlightingFragmentSeparator($defaultIfEmpty = '[...]')
1704
    {
1705
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.results.resultsHighlighting.fragmentSeparator', $defaultIfEmpty);
1706
    }
1707 30
1708
    /**
1709 30
     * Returns the number of results that should be shown per page.
1710
     *
1711
     * plugin.tx_solr.search.results.resultsPerPage
1712
     *
1713
     * @param int $defaultIfEmpty
1714
     * @return int
1715
     */
1716
    public function getSearchResultsPerPage($defaultIfEmpty = 10)
1717
    {
1718
        return (int)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.results.resultsPerPage', $defaultIfEmpty);
1719
    }
1720 31
1721
    /**
1722 31
     * Returns the available options for the per page switch.
1723 31
     *
1724
     * plugin.tx_solr.search.results.resultsPerPageSwitchOptions
1725
     *
1726
     * @param array $defaultIfEmpty
1727
     * @return array
1728
     */
1729
    public function getSearchResultsPerPageSwitchOptionsAsArray($defaultIfEmpty = [])
1730
    {
1731
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.results.resultsPerPageSwitchOptions', '');
1732
1733
        if (trim($result) === '') {
1734 114
            return $defaultIfEmpty;
1735
        }
1736 114
1737 114
        return GeneralUtility::intExplode(',', $result, true);
1738
    }
1739
1740
    /**
1741
     * Returns the configured wrap for the resultHighlighting.
1742
     *
1743
     * plugin.tx_solr.search.results.resultsHighlighting.wrap
1744
     *
1745
     * @param string $defaultIfEmpty
1746
     * @return string
1747
     */
1748
    public function getSearchResultsHighlightingWrap($defaultIfEmpty = '')
1749
    {
1750
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.results.resultsHighlighting.wrap', $defaultIfEmpty);
1751
    }
1752
1753
    /**
1754
     * Indicates if spellchecking is enabled or not.
1755 60
     *
1756
     * plugin.tx_solr.search.spellchecking
1757 60
     *
1758 60
     * @param bool $defaultIfEmpty
1759
     * @return bool
1760
     */
1761 60
    public function getSearchSpellchecking($defaultIfEmpty = false)
1762 2
    {
1763
        $isFacetingEnabled = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.spellchecking', $defaultIfEmpty);
1764
        return $this->getBool($isFacetingEnabled);
1765
    }
1766 60
1767 60
    /**
1768 60
     * Returns the wrap that should be used for spellchecking
1769
     *
1770
     * plugin.tx_solr.search.spellchecking.wrap
1771
     *
1772
     * @param string $defaultIfEmpty
1773
     * @return string
1774
     */
1775
    public function getSearchSpellcheckingWrap($defaultIfEmpty = '')
1776
    {
1777
        return (string)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.spellchecking.wrap', $defaultIfEmpty);
1778
    }
1779
1780
    /**
1781
     * Returns the numberOfSuggestionsToTry that should be used for the spellchecking.
1782
     *
1783
     * plugin.tx_solr.search.spellchecking.numberOfSuggestionsToTry
1784
     *
1785
     * @param int $defaultIfEmpty
1786
     * @return int
1787
     */
1788
    public function getSearchSpellcheckingNumberOfSuggestionsToTry($defaultIfEmpty = 1)
1789
    {
1790
        return (int)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.spellchecking.numberOfSuggestionsToTry', $defaultIfEmpty);
1791
    }
1792 24
1793
    /**
1794 24
     * Indicates if a second search should be fired from the spellchecking suggestion if no results could be found.
1795
     *
1796 24
     * plugin.tx_solr.search.spellchecking.searchUsingSpellCheckerSuggestion
1797
     *
1798
     * @param bool $defaultIfEmpty
1799
     * @return bool
1800
     */
1801
    public function getSearchSpellcheckingSearchUsingSpellCheckerSuggestion($defaultIfEmpty = false)
1802
    {
1803
        $result = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.spellchecking.searchUsingSpellCheckerSuggestion', $defaultIfEmpty);
1804
        return $this->getBool($result);
1805
    }
1806
1807 2
    /**
1808
     * Indicates if faceting is enabled or not.
1809 2
     *
1810 2
     * plugin.tx_solr.search.faceting
1811
     *
1812
     * @param bool $defaultIfEmpty
1813
     * @return bool
1814
     */
1815
    public function getSearchFaceting($defaultIfEmpty = false)
1816
    {
1817
        $isFacetingEnabled = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting', $defaultIfEmpty);
1818
        return $this->getBool($isFacetingEnabled);
1819
    }
1820
1821 24
    /**
1822
     * Retrieves the showEvenWhenEmpty for a facet by facet name. If nothing specific is configured
1823 24
     * the global showEmptyFacets with be returned.
1824 24
     *
1825
     * plugin.tx_solr.search.faceting.facets.<facetName>.showEvenWhenEmpty
1826
     *
1827
     * or
1828 24
     *
1829
     * plugin.tx_solr.search.faceting.showEmptyFacets
1830
     *
1831
     *
1832
     * @param string $facetName
1833
     * @param bool $defaultIfEmpty
1834
     * @return bool
1835
     */
1836
    public function getSearchFacetingShowEmptyFacetsByName($facetName = '', $defaultIfEmpty = false)
1837
    {
1838
        $facetSpecificPath = 'plugin.tx_solr.search.faceting.facets.' . $facetName . '.showEvenWhenEmpty';
1839 40
        $specificShowWhenEmpty = $this->getValueByPathOrDefaultValue($facetSpecificPath, null);
1840
1841 40
        // if we have a concrete setting, use it
1842
        if ($specificShowWhenEmpty !== null) {
1843
            return $specificShowWhenEmpty;
1844
        }
1845
1846
        // no specific setting, check common setting
1847
        $commonPath = 'plugin.tx_solr.search.faceting.showEmptyFacets';
1848
        $commonIfEmptyOrDefaultValue = $this->getValueByPathOrDefaultValue($commonPath, $defaultIfEmpty);
1849
        return $commonIfEmptyOrDefaultValue;
1850
    }
1851
1852
    /**
1853
     * Returns the wrap for the faceting show all link
1854
     *
1855
     * plugin.tx_solr.search.faceting.showAllLink.wrap
1856
     *
1857
     * @param string $defaultIfEmpty
1858
     * @return string
1859
     */
1860
    public function getSearchFacetingShowAllLinkWrap($defaultIfEmpty = '')
1861
    {
1862
        return (string)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.showAllLink.wrap', $defaultIfEmpty);
1863
    }
1864
1865 40
    /**
1866
     * Returns the link url parameters that should be added to a facet.
1867 40
     *
1868
     * plugin.tx_solr.search.faceting.facetLinkUrlParameters
1869
     *
1870
     * @param string $defaultIfEmpty
1871
     * @return string
1872
     */
1873
    public function getSearchFacetingFacetLinkUrlParameters($defaultIfEmpty = '')
1874
    {
1875
        $linkUrlParameters = trim($this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.facetLinkUrlParameters', $defaultIfEmpty));
1876
1877
        return $linkUrlParameters;
1878
    }
1879
1880
    /**
1881
     * Returns if the facetLinkUrlsParameters should be included in the reset link.
1882
     *
1883
     * plugin.tx_solr.search.faceting.facetLinkUrlParameters.useForFacetResetLinkUrl
1884
     *
1885
     * @param bool $defaultIfEmpty
1886
     * @return bool
1887
     */
1888
    public function getSearchFacetingFacetLinkUrlParametersUseForFacetResetLinkUrl($defaultIfEmpty = true)
1889
    {
1890
        $useForFacetResetLinkUrl = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.facetLinkUrlParameters.useForFacetResetLinkUrl', $defaultIfEmpty);
1891
        return $this->getBool($useForFacetResetLinkUrl);
1892 40
    }
1893
1894 40
    /**
1895
     * Returns the link url parameters that should be added to a facet as array.
1896
     *
1897
     * plugin.tx_solr.search.faceting.facetLinkUrlParameters
1898
     *
1899
     * @param array $defaultIfEmpty
1900
     * @return array
1901
     */
1902
    public function getSearchFacetingFacetLinkUrlParametersAsArray($defaultIfEmpty = [])
1903
    {
1904
        $linkUrlParameters = $this->getSearchFacetingFacetLinkUrlParameters();
1905
        if ($linkUrlParameters === '') {
1906
            return $defaultIfEmpty;
1907 37
        }
1908
1909 37
        return GeneralUtility::explodeUrl2Array($linkUrlParameters);
1910 37
    }
1911
1912
    /**
1913
     * Return the configured minimumCount value for facets.
1914
     *
1915
     * plugin.tx_solr.search.faceting.minimumCount
1916
     *
1917
     * @param int $defaultIfEmpty
1918
     * @return int
1919
     */
1920
    public function getSearchFacetingMinimumCount($defaultIfEmpty = 1)
1921 65
    {
1922
        return (int)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.minimumCount', $defaultIfEmpty);
1923 65
    }
1924
1925
    /**
1926
     * Return the configured limit value for facets, used for displaying.
1927
     *
1928
     * plugin.tx_solr.search.faceting.limit
1929
     *
1930
     * @param int $defaultIfEmpty
1931
     * @return int
1932
     */
1933
    public function getSearchFacetingLimit($defaultIfEmpty = 10)
1934
    {
1935 37
        return (int)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.limit', $defaultIfEmpty);
1936
    }
1937 37
1938
    /**
1939
     * Return the configured limit value for facets, used for the response.
1940
     *
1941
     * plugin.tx_solr.search.faceting.facetLimit
1942
     *
1943
     * @param int $defaultIfEmpty
1944
     * @return int
1945
     */
1946
    public function getSearchFacetingFacetLimit($defaultIfEmpty = 100)
1947
    {
1948 33
        return (int)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.facetLimit', $defaultIfEmpty);
1949
    }
1950 33
1951 33
    /**
1952
     * Returns if the singleFacetMode is active or not.
1953
     *
1954
     * plugin.tx_solr.search.faceting.singleFacetMode
1955
     *
1956
     * @param bool $defaultIfEmpty
1957
     * @return bool
1958
     */
1959
    public function getSearchFacetingSingleFacetMode($defaultIfEmpty = false)
1960
    {
1961
        $singleFacetMode = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.singleFacetMode', $defaultIfEmpty);
1962 23
        return $this->getBool($singleFacetMode);
1963
    }
1964 23
1965 23
    /**
1966
     * Return the configured faceting sortBy value.
1967
     *
1968
     * plugin.tx_solr.search.faceting.sortBy
1969
     *
1970
     * @param string $defaultIfEmpty
1971
     * @return string
1972
     */
1973
    public function getSearchFacetingSortBy($defaultIfEmpty = '')
1974
    {
1975
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.sortBy', $defaultIfEmpty);
1976 29
    }
1977
1978 29
    /**
1979 29
     * Returns if a facets should be kept on selection. Global faceting setting
1980
     * can also be configured on facet level by using
1981
     * (plugin.tx_solr.search.faceting.facets.<fieldName>.keepAllOptionsOnSelection)
1982
     *
1983
     * plugin.tx_solr.search.faceting.keepAllFacetsOnSelection
1984
     *
1985
     * @param bool $defaultIfEmpty
1986
     * @return bool
1987
     */
1988
    public function getSearchFacetingKeepAllFacetsOnSelection($defaultIfEmpty = false)
1989
    {
1990
        $keepAllOptionsOnSelection = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.faceting.keepAllFacetsOnSelection', $defaultIfEmpty);
1991
        return $this->getBool($keepAllOptionsOnSelection);
1992
    }
1993
1994
    /**
1995
     * Returns the configured faceting configuration.
1996
     *
1997
     * plugin.tx_solr.search.faceting.facets
1998
     *
1999
     * @param array $defaultIfEmpty
2000
     * @return array
2001
     */
2002
    public function getSearchFacetingFacets(array $defaultIfEmpty = [])
2003
    {
2004
        return $this->getObjectByPathOrDefault('plugin.tx_solr.search.faceting.facets.', $defaultIfEmpty);
2005
    }
2006
2007
    /**
2008
     * Returns the configuration of a single facet by facet name.
2009
     *
2010
     * plugin.tx_solr.search.faceting.facets.<facetName>
2011
     *
2012
     * @param string $facetName
2013
     * @param array $defaultIfEmpty
2014
     * @return array
2015
     */
2016
    public function getSearchFacetingFacetByName($facetName, $defaultIfEmpty = [])
2017
    {
2018
        return $this->getObjectByPathOrDefault('plugin.tx_solr.search.faceting.facets.' . $facetName . '.', $defaultIfEmpty);
2019
    }
2020
2021
    /**
2022
     * Indicates if statistics is enabled or not.
2023
     *
2024
     * plugin.tx_solr.statistics
2025
     *
2026
     * @param bool $defaultIfEmpty
2027
     * @return bool
2028
     */
2029
    public function getStatistics($defaultIfEmpty = false)
2030
    {
2031
        $isStatisticsEnabled = $this->getValueByPathOrDefaultValue('plugin.tx_solr.statistics', $defaultIfEmpty);
2032
        return $this->getBool($isStatisticsEnabled);
2033
    }
2034
2035
    /**
2036
     * Indicates to which length an ip should be anonymized in the statistics
2037
     *
2038
     * plugin.tx_solr.statistics.anonymizeIP
2039
     *
2040
     * @param int $defaultIfEmpty
2041
     * @return int
2042
     */
2043
    public function getStatisticsAnonymizeIP($defaultIfEmpty = 0)
2044
    {
2045
        $anonymizeToLength = $this->getValueByPathOrDefaultValue('plugin.tx_solr.statistics.anonymizeIP', $defaultIfEmpty);
2046
        return (int)$anonymizeToLength;
2047
    }
2048
2049
    /**
2050
     * Indicates if additional debug Data should be added to the statistics
2051
     *
2052
     * plugin.tx_solr.statistics.addDebugData
2053
     *
2054
     * @param bool $defaultIfEmpty
2055
     * @return bool
2056
     */
2057
    public function getStatisticsAddDebugData($defaultIfEmpty = false)
2058
    {
2059
        $statisticsAddDebugDataEnabled = $this->getValueByPathOrDefaultValue('plugin.tx_solr.statistics.addDebugData', $defaultIfEmpty);
2060
        return $this->getBool($statisticsAddDebugDataEnabled);
2061 36
    }
2062
2063 36
    /**
2064 36
     * Indicates if suggestion is enabled or not.
2065
     *
2066
     * plugin.tx_solr.suggest
2067
     *
2068
     * @param bool $defaultIfEmpty
2069
     * @return bool
2070
     */
2071
    public function getSuggest($defaultIfEmpty = false)
2072
    {
2073
        $isSuggestionEnabled = $this->getValueByPathOrDefaultValue('plugin.tx_solr.suggest', $defaultIfEmpty);
2074
        return $this->getBool($isSuggestionEnabled);
2075
    }
2076
2077
    /**
2078
     * Indicates if https should be used for the suggest form.
2079
     *
2080
     * plugin.tx_solr.suggest.forceHttps
2081
     *
2082
     * @param bool $defaultIfEmpty
2083
     * @return bool
2084
     */
2085
    public function getSuggestForceHttps($defaultIfEmpty = false)
2086
    {
2087
        $isHttpsForced = $this->getValueByPathOrDefaultValue('plugin.tx_solr.suggest.forceHttps', $defaultIfEmpty);
2088
        return $this->getBool($isHttpsForced);
2089
    }
2090
2091
    /**
2092
     * Returns the allowed number of suggestions.
2093
     *
2094
     * plugin.tx_solr.suggest.numberOfSuggestions
2095
     *
2096
     * @param int $defaultIfEmpty
2097
     * @return int
2098
     */
2099
    public function getSuggestNumberOfSuggestions($defaultIfEmpty = 10)
2100
    {
2101
        $numberOfSuggestions = $this->getValueByPathOrDefaultValue('plugin.tx_solr.suggest.numberOfSuggestions', $defaultIfEmpty);
2102
        return (int)$numberOfSuggestions;
2103
    }
2104
2105
    /**
2106
     * Indicates if the topResults should be shown or not
2107
     *
2108
     * plugin.tx_solr.suggest.showTopResults
2109
     *
2110
     * @param bool $defaultIfEmpty
2111
     * @return bool
2112
     */
2113
    public function getSuggestShowTopResults($defaultIfEmpty = true)
2114
    {
2115
        $showTopResults = $this->getValueByPathOrDefaultValue('plugin.tx_solr.suggest.showTopResults', $defaultIfEmpty);
2116
        return $this->getBool($showTopResults);
2117
    }
2118
2119
    /**
2120
     * Returns the configured number of top results to show
2121
     *
2122 16
     * plugin.tx_solr.suggest.numberOfTopResults
2123
     *
2124 16
     * @param int $defaultIfEmpty
2125 16
     * @return int
2126
     */
2127
    public function getSuggestNumberOfTopResults($defaultIfEmpty = 5)
2128
    {
2129
        $numberOfTopResults = $this->getValueByPathOrDefaultValue('plugin.tx_solr.suggest.numberOfTopResults', $defaultIfEmpty);
2130
        return (int)$numberOfTopResults;
2131
    }
2132
2133
    /**
2134
     * Returns the configured template for a specific template fileKey.
2135
     *
2136 37
     * plugin.tx_solr.view.templateFiles.<fileKey>
2137
     *
2138 37
     * @param string $fileKey
2139
     * @param string $defaultIfEmpty
2140
     * @return string
2141
     */
2142
    public function getViewTemplateByFileKey($fileKey, $defaultIfEmpty = '')
2143
    {
2144
        $templateFileName = $this->getValueByPathOrDefaultValue('plugin.tx_solr.view.templateFiles.' . $fileKey, $defaultIfEmpty);
2145
        return (string)$templateFileName;
2146
    }
2147
2148
    /**
2149
     * Returns the configured available template files for the flexform.
2150
     *
2151 24
     * plugin.tx_solr.view.templateFiles.[fileKey].availableTemplates.
2152
     *
2153 24
     * @param string $fileKey
2154 24
     * @return array
2155
     */
2156
    public function getAvailableTemplatesByFileKey($fileKey)
2157
    {
2158
        $path = 'plugin.tx_solr.view.templateFiles.' . $fileKey . '.availableTemplates.';
2159
        return (array)$this->getObjectByPathOrDefault($path, []);
2160
    }
2161
2162
    /**
2163
     * Returns the configuration of the crop view helper.
2164
     *
2165
     * plugin.tx_solr.viewHelpers.crop.
2166 115
     *
2167
     * @param array $defaultIfEmpty
2168 115
     * @return array
2169 115
     */
2170
    public function getViewHelpersCropConfiguration(array $defaultIfEmpty = [])
2171
    {
2172
        $cropViewHelperConfiguration = $this->getObjectByPathOrDefault('plugin.tx_solr.viewHelpers.crop.', $defaultIfEmpty);
2173
        return $cropViewHelperConfiguration;
2174
    }
2175
2176
    /**
2177
     * Returns the configuration of the sorting view helper.
2178
     *
2179
     * plugin.tx_solr.viewHelpers.sortIndicator.
2180
     *
2181
     * @param array $defaultIfEmpty
2182
     * @return array
2183
     */
2184
    public function getViewHelpersSortIndicatorConfiguration(array $defaultIfEmpty = [])
2185
    {
2186
        $sortingViewHelperConfiguration = $this->getObjectByPathOrDefault('plugin.tx_solr.viewHelpers.sortIndicator.', $defaultIfEmpty);
2187
        return $sortingViewHelperConfiguration;
2188
    }
2189
2190
    /**
2191
     * Controls whether ext-solr will send commits to solr.
2192
     * Beware: If you disable this, you need to ensure
2193
     * that some other mechanism will commit your changes
2194 2
     * otherwise they will never be searchable.
2195
     * A good way to achieve this is enabling the solr
2196 2
     * daemons autoCommit feature.
2197 2
     *
2198 2
     * plugin.tx_solr.index.enableCommits
2199 2
     *
2200
     * @param bool $defaultIfEmpty
2201
     * @return bool
2202 2
     */
2203 2
    public function getEnableCommits($defaultIfEmpty = true)
2204
    {
2205
        $enableCommits = $this->getValueByPathOrDefaultValue('plugin.tx_solr.index.enableCommits', $defaultIfEmpty);
2206
        return $this->getBool($enableCommits);
2207 2
    }
2208 2
2209 2
    /**
2210
     * Returns the url namespace that is used for the arguments.
2211
     *
2212
     * plugin.tx_solr.view.pluginNamespace
2213 2
     *
2214
     * @param string $defaultIfEmpty
2215
     * @return string
2216
     */
2217
    public function getSearchPluginNamespace($defaultIfEmpty = 'tx_solr')
2218
    {
2219
        return $this->getValueByPathOrDefaultValue('plugin.tx_solr.view.pluginNamespace', $defaultIfEmpty);
2220
    }
2221
2222
    /**
2223
     * Returns true if the global url parameter q, that indicates the query should be used.
2224
     *
2225
     * Should be set to false, when multiple instance on the same page should have their querystring.
2226
     *
2227
     * plugin.tx_solr.search.ignoreGlobalQParameter
2228
     *
2229
     * @param bool $defaultIfEmpty
2230
     * @return bool
2231
     */
2232
    public function getSearchIgnoreGlobalQParameter($defaultIfEmpty = false)
2233
    {
2234
        $enableQParameter = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.ignoreGlobalQParameter', $defaultIfEmpty);
2235
        return $this->getBool($enableQParameter);
2236
2237
    }
2238
2239
    /**
2240
     * Method to check if grouping was enabled with typoscript.
2241
     *
2242
     * plugin.tx_solr.search.grouping
2243
     *
2244
     * @param bool $defaultIfEmpty
2245
     * @return bool
2246
     */
2247
    public function getSearchGrouping($defaultIfEmpty = false)
2248
    {
2249
        $groupingEnabled = $this->getValueByPathOrDefaultValue('plugin.tx_solr.search.grouping', $defaultIfEmpty);
2250
        return $this->getBool($groupingEnabled);
2251
    }
2252
2253
    /**
2254
     * Returns the configured numberOfGroups.
2255
     *
2256
     * plugin.tx_solr.search.grouping.numberOfGroups
2257
     *
2258
     * @param int $defaultIfEmpty
2259
     * @return int
2260
     */
2261
    public function getSearchGroupingNumberOfGroups($defaultIfEmpty = 5)
2262
    {
2263
        return (int)$this->getValueByPathOrDefaultValue('plugin.tx_solr.search.grouping.numberOfGroups', $defaultIfEmpty);
2264
    }
2265
2266 7
    /**
2267
     * Returns the highestValue of the numberOfResultsPerGroup configuration that is globally configured and
2268 7
     * for each group.
2269 7
     *
2270
     * plugin.tx_solr.search.grouping.
2271 7
     *
2272 5
     * @param int $defaultIfEmpty
2273
     * @return int
2274
     */
2275 2
    public function getSearchGroupingHighestGroupResultsLimit($defaultIfEmpty = 1)
2276
    {
2277
        $groupingConfiguration = $this->getObjectByPathOrDefault('plugin.tx_solr.search.grouping.', []);
2278
        $highestLimit = $defaultIfEmpty;
2279
        if (!empty($groupingConfiguration['numberOfResultsPerGroup'])) {
2280
            $highestLimit = $groupingConfiguration['numberOfResultsPerGroup'];
2281
        }
2282
2283
        $configuredGroups = $groupingConfiguration['groups.'];
2284
        if (!is_array($configuredGroups)) {
2285
            return $highestLimit;
2286
        }
2287
2288
        foreach ($configuredGroups as $groupName => $groupConfiguration) {
2289
            if (!empty($groupConfiguration['numberOfResultsPerGroup']) && $groupConfiguration['numberOfResultsPerGroup'] > $highestLimit) {
2290
                $highestLimit = $groupConfiguration['numberOfResultsPerGroup'];
2291
            }
2292
        }
2293
2294
        return $highestLimit;
2295
    }
2296
2297
    /**
2298
     * Returns the valid numberOfResultsPerGroup value for a group.
2299
     *
2300
     * Returns:
2301
     *
2302
     * plugin.tx_solr.search.grouping.groups.<groupName>.numberOfResultsPerGroup if it is set otherwise
2303
     * plugin.tx_solr.search.grouping.numberOfResultsPerGroup
2304
     *
2305
     * @param string $groupName
2306
     * @param int $defaultIfEmpty
2307
     * @return int
2308
     */
2309
    public function getSearchGroupingResultLimit($groupName, $defaultIfEmpty = 1)
2310
    {
2311
        $specificPath = 'plugin.tx_solr.search.grouping.groups.' . $groupName . 'numberOfResultsPerGroup';
2312
        $specificResultsPerGroup = $this->getValueByPathOrDefaultValue($specificPath, null);
2313
2314
        if ($specificResultsPerGroup !== null) {
2315
            return (int) $specificResultsPerGroup;
2316
        }
2317
2318
        $commonPath = 'plugin.tx_solr.search.grouping.numberOfResultsPerGroup';
2319
        $commonValue = $this->getValueByPathOrDefaultValue($commonPath, null);
2320
        if ($commonValue !== null) {
2321
            return (int) $commonValue;
2322
        }
2323
2324
        return $defaultIfEmpty;
2325
    }
2326
2327
    /**
2328
     * Returns everything that is configured for the groups (plugin.tx_solr.search.grouping.groups.)
2329
     *
2330
     * plugin.tx_solr.search.grouping.groups.
2331
     *
2332
     * @param array $defaultIfEmpty
2333
     * @return array
2334
     */
2335
    public function getSearchGroupingGroupsConfiguration($defaultIfEmpty = [])
2336
    {
2337
        return $this->getObjectByPathOrDefault('plugin.tx_solr.search.grouping.groups.', $defaultIfEmpty);
2338
    }
2339
2340
    /*
2341
     * Applies the stdWrap if it is configured for the path, otherwise the unprocessed value will be returned.
2342
     *
2343
     * @param string $valuePath
2344
     * @param mixed $value
2345
     * @return mixed
2346
     */
2347
    protected function renderContentElementOfConfigured($valuePath, $value)
2348
    {
2349
        $configurationPath = $valuePath . '.';
2350
        $configuration = $this->getObjectByPath($configurationPath);
2351
2352
        if ($configuration == null) {
2353
            return $value;
2354
        }
2355
2356
        return $this->contentObjectService->renderSingleContentObject($value, $configuration);
2357
    }
2358
}
2359