meilisearch/Classes/ContentObject/Classification.php
2021-04-17 21:20:54 +02:00

118 lines
4.6 KiB
PHP

<?php
namespace WapplerSystems\Meilisearch\ContentObject;
/***************************************************************
* Copyright notice
*
* (c) 2017 Timo Hund <timo.hund@dkd.de>
* All rights reserved
*
* This script is part of the TYPO3 project. The TYPO3 project is
* free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (at your option) any later version.
*
* The GNU General Public License can be found at
* http://www.gnu.org/copyleft/gpl.html.
*
* This script is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/
use WapplerSystems\Meilisearch\Domain\Index\Classification\Classification as ClassificationItem;
use WapplerSystems\Meilisearch\Domain\Index\Classification\ClassificationService;
use InvalidArgumentException;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Frontend\ContentObject\AbstractContentObject;
/**
* A content object (cObj) to classify content based on a configuration.
*
* Example usage:
*
* keywords = SOLR_CLASSIFICATION # supports stdWrap
* keywords {
* field = __meilisearch_content # a comma separated field. instead of field you can also use "value"
* classes {
* 1 {
* patterns = smartphone, mobile, mobilephone # list of patterns that need to match to assign that class
* class = mobilephone # class that should be assigned when a pattern matches
* }
* }
* }
*/
class Classification extends AbstractContentObject
{
const CONTENT_OBJECT_NAME = 'SOLR_CLASSIFICATION';
/**
* Executes the SOLR_CLASSIFICATION content object.
*
* Returns mapped classes when the field matches on of the configured patterns ...
*
* @inheritDoc
*/
public function render($conf = [])
{
if (!is_array($conf['classes.'])) {
throw new InvalidArgumentException('No class configuration configured for SOLR_CLASSIFICATION object. Given configuration: ' . serialize($conf));
}
$configuredMappedClasses = $conf['classes.'];
unset($conf['classes.']);
$data = '';
if (isset($conf['value'])) {
$data = $conf['value'];
unset($conf['value']);
}
if (!empty($conf)) {
$data = $this->cObj->stdWrap($data, $conf);
}
$classifications = $this->buildClassificationsFromConfiguration($configuredMappedClasses);
/** @var $classificationService ClassificationService */
$classificationService = GeneralUtility::makeInstance(ClassificationService::class);
return serialize($classificationService->getMatchingClassNames((string)$data, $classifications));
}
/**
* Builds an array of Classification objects from the passed classification configuration.
*
* @param array $configuredMappedClasses
* @return ClassificationItem[]
*/
protected function buildClassificationsFromConfiguration($configuredMappedClasses) : array
{
$classifications = [];
foreach ($configuredMappedClasses as $class) {
if ( (empty($class['patterns']) && empty($class['matchPatterns'])) || empty($class['class'])) {
throw new InvalidArgumentException('A class configuration in SOLR_CLASSIFCATION needs to have a pattern and a class configured. Given configuration: ' . serialize($class));
}
// @todo deprecate patterns configuration
$patterns = empty($class['patterns']) ? [] : GeneralUtility::trimExplode(',', $class['patterns']);
$matchPatterns = empty($class['matchPatterns']) ? [] : GeneralUtility::trimExplode(',', $class['matchPatterns']);
$matchPatterns = $matchPatterns + $patterns;
$unMatchPatters = empty($class['unmatchPatterns']) ? [] : GeneralUtility::trimExplode(',', $class['unmatchPatterns']);
$className = $class['class'];
$classifications[] = GeneralUtility::makeInstance(
ClassificationItem::class,
/** @scrutinizer ignore-type */ $matchPatterns,
/** @scrutinizer ignore-type */ $unMatchPatters,
/** @scrutinizer ignore-type */ $className
);
}
return $classifications;
}
}