Initial commit - Typo3 11.5.41

typo3conf/ext/tt_address/Classes/Domain/Model/Address.php

@@ -0,0 +1,674 @@
+<?php
+declare(strict_types=1);
+
+namespace FriendsOfTYPO3\TtAddress\Domain\Model;
+
+/**
+ * This file is part of the "tt_address" Extension for TYPO3 CMS.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+
+use FriendsOfTYPO3\TtAddress\Utility\PropertyModification;
+use TYPO3\CMS\Extbase\Domain\Model\Category;
+use TYPO3\CMS\Extbase\Domain\Model\FileReference;
+use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
+use TYPO3\CMS\Extbase\Persistence\ObjectStorage;
+
+/**
+ * The domain model of a Address
+ */
+class Address extends AbstractEntity
+{
+    /**
+     * Hidden
+     *
+     * @var bool
+     */
+    protected $hidden = false;
+
+    /**
+     * @var string
+     */
+    protected $gender = '';
+
+    /**
+     * @var string
+     */
+    protected $name = '';
+
+    /**
+     * @var string
+     */
+    protected $firstName = '';
+
+    /**
+     * @var string
+     */
+    protected $middleName = '';
+
+    /**
+     * @var string
+     */
+    protected $lastName = '';
+
+    /**
+     * @var \DateTime|null
+     */
+    protected $birthday;
+
+    /**
+     * @var string
+     */
+    protected $title = '';
+
+    /** @var string */
+    protected $titleSuffix = '';
+
+    /**
+     * @var string
+     */
+    protected $address = '';
+
+    /**
+     * @var float
+     */
+    protected $latitude = 0;
+
+    /**
+     * @var float
+     */
+    protected $longitude = 0;
+
+    /**
+     * @var string
+     */
+    protected $building = '';
+
+    /**
+     * @var string
+     */
+    protected $room = '';
+
+    /**
+     * @var string
+     */
+    protected $phone = '';
+
+    /**
+     * @var string
+     */
+    protected $fax = '';
+
+    /**
+     * @var string
+     */
+    protected $mobile = '';
+
+    /**
+     * @var string
+     */
+    protected $www = '';
+
+    /**
+     * @var string
+     */
+    protected $slug = '';
+
+    /**
+     * @var string
+     */
+    protected $skype = '';
+
+    /**
+     * @var string
+     */
+    protected $twitter = '';
+
+    /**
+     * @var string
+     */
+    protected $facebook = '';
+
+    /**
+     * @var string
+     */
+    protected $instagram = '';
+
+    /**
+     * @var string
+     */
+    protected $tiktok = '';
+
+    /**
+     * @var string
+     */
+    protected $linkedin = '';
+
+    /**
+     * @var string
+     */
+    protected $email = '';
+
+    /**
+     * @var string
+     */
+    protected $company = '';
+
+    /**
+     * @var string
+     */
+    protected $position = '';
+
+    /**
+     * @var string
+     */
+    protected $city = '';
+
+    /**
+     * @var string
+     */
+    protected $zip = '';
+
+    /**
+     * @var string
+     */
+    protected $region = '';
+
+    /**
+     * @var string
+     */
+    protected $country = '';
+
+    /**
+     * @var \TYPO3\CMS\Extbase\Persistence\ObjectStorage<\TYPO3\CMS\Extbase\Domain\Model\FileReference>
+     */
+    protected $image;
+
+    /**
+     * @var string
+     */
+    protected $description = '';
+
+    /**
+     * @var \TYPO3\CMS\Extbase\Persistence\ObjectStorage<Category>
+     */
+    protected $categories;
+
+    public function __construct()
+    {
+        $this->image = new ObjectStorage();
+        $this->categories = new ObjectStorage();
+    }
+
+    public function setHidden($hidden): void
+    {
+        $this->hidden = $hidden;
+    }
+
+    public function getHidden(): bool
+    {
+        return $this->hidden;
+    }
+
+    public function setGender(string $gender): void
+    {
+        $this->gender = $gender;
+    }
+
+    public function getGender(): string
+    {
+        return $this->gender;
+    }
+
+    public function setName(string $name): void
+    {
+        $this->name = $name;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function setFirstName(string $firstName): void
+    {
+        $this->firstName = $firstName;
+    }
+
+    public function getFirstName(): string
+    {
+        return $this->firstName;
+    }
+
+    public function setMiddleName(string $middleName): void
+    {
+        $this->middleName = $middleName;
+    }
+
+    public function getMiddleName(): string
+    {
+        return $this->middleName;
+    }
+
+    public function setLastName(string $lastName): void
+    {
+        $this->lastName = $lastName;
+    }
+
+    public function getLastName(): string
+    {
+        return $this->lastName;
+    }
+
+    public function setBirthday(?\DateTime $birthday = null): void
+    {
+        $this->birthday = $birthday;
+    }
+
+    public function getBirthday(): ?\DateTime
+    {
+        return $this->birthday;
+    }
+
+    public function setTitle(string $title): void
+    {
+        $this->title = $title;
+    }
+
+    public function getTitle(): string
+    {
+        return $this->title;
+    }
+
+    /**
+     * @return string
+     */
+    public function getTitleSuffix(): string
+    {
+        return $this->titleSuffix;
+    }
+
+    /**
+     * @param string $titleSuffix
+     */
+    public function setTitleSuffix(string $titleSuffix): void
+    {
+        $this->titleSuffix = $titleSuffix;
+    }
+
+    public function setAddress(string $address): void
+    {
+        $this->address = $address;
+    }
+
+    public function getAddress(): string
+    {
+        return $this->address;
+    }
+
+    public function setLatitude(float $latitude): void
+    {
+        $this->latitude = $latitude;
+    }
+
+    public function getLatitude(): float
+    {
+        return $this->latitude;
+    }
+
+    public function setLongitude(float $longitude): void
+    {
+        $this->longitude = $longitude;
+    }
+
+    public function getLongitude(): float
+    {
+        return $this->longitude;
+    }
+
+    public function setBuilding(string $building): void
+    {
+        $this->building = $building;
+    }
+
+    public function getBuilding(): string
+    {
+        return $this->building;
+    }
+
+    public function setRoom(string $room): void
+    {
+        $this->room = $room;
+    }
+
+    public function getRoom(): string
+    {
+        return $this->room;
+    }
+
+    public function setPhone(string $phone): void
+    {
+        $this->phone = $phone;
+    }
+
+    public function getPhone(): string
+    {
+        return $this->phone;
+    }
+
+    public function getCleanedPhone(): string
+    {
+        return PropertyModification::getCleanedNumber($this->phone);
+    }
+
+    public function setFax(string $fax): void
+    {
+        $this->fax = $fax;
+    }
+
+    public function getFax(): string
+    {
+        return $this->fax;
+    }
+
+    public function getCleanedFax(): string
+    {
+        return PropertyModification::getCleanedNumber($this->fax);
+    }
+
+    public function setMobile(string $mobile): void
+    {
+        $this->mobile = $mobile;
+    }
+
+    public function getMobile(): string
+    {
+        return $this->mobile;
+    }
+
+    public function getCleanedMobile(): string
+    {
+        return PropertyModification::getCleanedNumber($this->mobile);
+    }
+
+    public function setWww(string $www): void
+    {
+        $this->www = $www;
+    }
+
+    public function getWww(): string
+    {
+        return $this->www;
+    }
+
+    public function getWwwSimplified(): string
+    {
+        return PropertyModification::getCleanedDomain($this->www);
+    }
+
+    public function setSlug(string $slug): void
+    {
+        $this->slug = $slug;
+    }
+
+    public function getSlug(): string
+    {
+        return $this->slug;
+    }
+
+    public function setSkype(string $skype): void
+    {
+        $this->skype = $skype;
+    }
+
+    public function getSkype(): string
+    {
+        return $this->skype;
+    }
+
+    public function setTwitter(string $twitter): void
+    {
+        if ($twitter[0] !== '@') {
+            throw new \InvalidArgumentException('twitter name must start with @', 1357530444);
+        }
+
+        $this->twitter = $twitter;
+    }
+
+    public function getTwitter(): string
+    {
+        return $this->twitter;
+    }
+
+    public function setFacebook(string $facebook): void
+    {
+        if ($facebook[0] !== '/') {
+            throw new \InvalidArgumentException('Facebook name must start with /', 1357530471);
+        }
+
+        $this->facebook = $facebook;
+    }
+
+    public function getFacebook(): string
+    {
+        return $this->facebook;
+    }
+
+    public function setInstagram(string $instagram): void
+    {
+        $this->instagram = $instagram;
+    }
+
+    public function getInstagram(): string
+    {
+        return $this->instagram;
+    }
+
+    public function setTiktok(string $tiktok): void
+    {
+        $this->tiktok = $tiktok;
+    }
+
+    public function getTiktok(): string
+    {
+        return $this->tiktok;
+    }
+
+    public function setLinkedin(string $linkedin): void
+    {
+        $this->linkedin = $linkedin;
+    }
+
+    public function getLinkedin(): string
+    {
+        return $this->linkedin;
+    }
+
+    public function setEmail(string $email): void
+    {
+        $this->email = $email;
+    }
+
+    public function getEmail(): string
+    {
+        return $this->email;
+    }
+
+    public function setCompany(string $company): void
+    {
+        $this->company = $company;
+    }
+
+    public function getCompany(): string
+    {
+        return $this->company;
+    }
+
+    public function setPosition(string $position): void
+    {
+        $this->position = $position;
+    }
+
+    public function getPosition(): string
+    {
+        return $this->position;
+    }
+
+    public function setCity(string $city): void
+    {
+        $this->city = $city;
+    }
+
+    public function getCity(): string
+    {
+        return $this->city;
+    }
+
+    public function setZip(string $zip): void
+    {
+        $this->zip = $zip;
+    }
+
+    public function getZip(): string
+    {
+        return $this->zip;
+    }
+
+    public function setRegion(string $region): void
+    {
+        $this->region = $region;
+    }
+
+    public function getRegion(): string
+    {
+        return $this->region;
+    }
+
+    public function setCountry(string $country): void
+    {
+        $this->country = $country;
+    }
+
+    public function getCountry(): string
+    {
+        return $this->country;
+    }
+
+    public function addImage(FileReference $image): void
+    {
+        $this->image->attach($image);
+    }
+
+    public function removeImage(FileReference $imageToRemove): void
+    {
+        $this->image->detach($imageToRemove);
+    }
+
+    /**
+     * @return \TYPO3\CMS\Extbase\Persistence\ObjectStorage<\TYPO3\CMS\Extbase\Domain\Model\FileReference>
+     */
+    public function getImage(): ?ObjectStorage
+    {
+        return $this->image;
+    }
+
+    public function getFirstImage(): ?FileReference
+    {
+        $images = $this->getImage();
+        if ($images) {
+            foreach ($images as $image) {
+                return $image;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param ObjectStorage<FileReference> $image
+     */
+    public function setImage(ObjectStorage $image): void
+    {
+        $this->image = $image;
+    }
+
+    public function setDescription(string $description): void
+    {
+        $this->description = $description;
+    }
+
+    public function getDescription(): string
+    {
+        return $this->description;
+    }
+
+    /**
+     * @return ObjectStorage<Category>
+     */
+    public function getCategories(): ObjectStorage
+    {
+        return $this->categories;
+    }
+
+    /**
+     * @param ObjectStorage<Category> $categories
+     */
+    public function setCategories(ObjectStorage $categories): void
+    {
+        $this->categories = $categories;
+    }
+
+    public function getSysLanguageUid(): int
+    {
+        return $this->_languageUid;
+    }
+
+    /**
+     * Get full name including title, first, middle and last name
+     *
+     * @return string
+     */
+    public function getFullName(): string
+    {
+        $list = [
+            $this->getTitle(),
+            $this->getFirstName(),
+            $this->getMiddleName(),
+            $this->getLastName(),
+        ];
+
+        $name = implode(' ', array_filter($list));
+        if ($this->titleSuffix) {
+            $name .= ', ' . $this->titleSuffix;
+        }
+        return $name;
+    }
+
+    /**
+     * Gets the first category
+     *
+     * @return \TYPO3\CMS\Extbase\Domain\Model\Category|null the first category
+     */
+    public function getFirstCategory(): ?Category
+    {
+        $categories = $this->getCategories();
+        if (!is_null($categories)) {
+            $categories->rewind();
+            return $categories->current();
+        }
+
+        return null;
+    }
+
+    public function getAddressInOneLine(): string
+    {
+        return implode(', ', array_filter([
+            str_replace(chr(10), ',', $this->address),
+            $this->city,
+            $this->region,
+            $this->country,
+        ]));
+    }
+}

typo3conf/ext/tt_address/Classes/Domain/Model/Dto/Demand.php

@@ -0,0 +1,165 @@
+<?php
+declare(strict_types=1);
+
+namespace FriendsOfTYPO3\TtAddress\Domain\Model\Dto;
+
+/**
+ * This file is part of the "tt_address" Extension for TYPO3 CMS.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+class Demand
+{
+    /** @var array */
+    protected $pages = [];
+
+    /** @var string */
+    protected $sortBy = '';
+
+    /** @var string */
+    protected $sortOrder = '';
+
+    /** @var string */
+    protected $categories = '';
+
+    /** @var bool */
+    protected $includeSubCategories = false;
+
+    /** @var string */
+    protected $categoryCombination = '';
+
+    /** @var string */
+    protected $singleRecords = '';
+
+    /** @var bool */
+    protected $ignoreWithoutCoordinates = false;
+
+    /**
+     * @return array
+     */
+    public function getPages(): array
+    {
+        return $this->pages;
+    }
+
+    /**
+     * @param array $pages
+     */
+    public function setPages(array $pages)
+    {
+        $this->pages = $pages;
+    }
+
+    /**
+     * @return string
+     */
+    public function getSortBy(): string
+    {
+        return $this->sortBy;
+    }
+
+    /**
+     * @param string $sortBy
+     */
+    public function setSortBy(string $sortBy)
+    {
+        $this->sortBy = $sortBy;
+    }
+
+    /**
+     * @return string
+     */
+    public function getSortOrder(): string
+    {
+        return $this->sortOrder;
+    }
+
+    /**
+     * @param string $sortOrder
+     */
+    public function setSortOrder(string $sortOrder)
+    {
+        $this->sortOrder = $sortOrder;
+    }
+
+    /**
+     * @return string
+     */
+    public function getCategories(): string
+    {
+        return $this->categories;
+    }
+
+    /**
+     * @param string $categories
+     */
+    public function setCategories(string $categories)
+    {
+        $this->categories = $categories;
+    }
+
+    /**
+     * @return bool
+     */
+    public function getIncludeSubCategories(): bool
+    {
+        return $this->includeSubCategories;
+    }
+
+    /**
+     * @param bool $includeSubCategories
+     */
+    public function setIncludeSubCategories(bool $includeSubCategories)
+    {
+        $this->includeSubCategories = $includeSubCategories;
+    }
+
+    /**
+     * @return string
+     */
+    public function getCategoryCombination(): string
+    {
+        return $this->categoryCombination;
+    }
+
+    /**
+     * @param string $categoryCombination
+     */
+    public function setCategoryCombination(string $categoryCombination)
+    {
+        $this->categoryCombination = $categoryCombination;
+    }
+
+    /**
+     * @return string
+     */
+    public function getSingleRecords(): string
+    {
+        return $this->singleRecords;
+    }
+
+    /**
+     * @param string $singleRecords
+     */
+    public function setSingleRecords(string $singleRecords)
+    {
+        $this->singleRecords = $singleRecords;
+    }
+
+    /**
+     * @return bool
+     */
+    public function getIgnoreWithoutCoordinates(): bool
+    {
+        return $this->ignoreWithoutCoordinates;
+    }
+
+    /**
+     * @param bool $ignoreWithoutCoordinates
+     */
+    public function setIgnoreWithoutCoordinates(bool $ignoreWithoutCoordinates)
+    {
+        $this->ignoreWithoutCoordinates = $ignoreWithoutCoordinates;
+    }
+}

typo3conf/ext/tt_address/Classes/Domain/Model/Dto/Settings.php

@@ -0,0 +1,71 @@
+<?php
+declare(strict_types=1);
+
+namespace FriendsOfTYPO3\TtAddress\Domain\Model\Dto;
+
+/**
+ * This file is part of the "tt_address" Extension for TYPO3 CMS.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+use TYPO3\CMS\Core\Configuration\ExtensionConfiguration;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+
+/**
+ * Class Settings
+ */
+class Settings
+{
+    /** @var string */
+    protected $telephoneValidationPatternForPhp = '/[^\d\+\s\-]/';
+
+    /** @var string */
+    protected $telephoneValidationPatternForJs = '/[^\d\+\s\-]/g';
+
+    /** @var bool */
+    protected $newPagination = false;
+
+    /**
+     */
+    public function __construct()
+    {
+        $settings = $this->getSettings();
+
+        if (!empty($settings)) {
+            $this->newPagination = (bool)($settings['newPagination'] ?? false);
+
+            if ($settings['telephoneValidationPatternForPhp'] ?? '') {
+                $this->telephoneValidationPatternForPhp = (string)$settings['telephoneValidationPatternForPhp'];
+            }
+            if ($settings['telephoneValidationPatternForJs'] ?? '') {
+                $this->telephoneValidationPatternForJs = (string)$settings['telephoneValidationPatternForJs'];
+            }
+        }
+    }
+
+    /**
+     * @return string
+     */
+    public function getTelephoneValidationPatternForPhp(): string
+    {
+        return $this->telephoneValidationPatternForPhp;
+    }
+
+    /**
+     * @return string
+     */
+    public function getTelephoneValidationPatternForJs(): string
+    {
+        return $this->telephoneValidationPatternForJs;
+    }
+
+    protected function getSettings(): array
+    {
+        try {
+            return GeneralUtility::makeInstance(ExtensionConfiguration::class)->get('tt_address');
+        } catch (\Exception $e) {
+            return [];
+        }
+    }
+}

typo3conf/ext/tt_address/Classes/Domain/Repository/AddressRepository.php

@@ -0,0 +1,192 @@
+<?php
+declare(strict_types=1);
+
+namespace FriendsOfTYPO3\TtAddress\Domain\Repository;
+
+/**
+ * This file is part of the "tt_address" Extension for TYPO3 CMS.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+use FriendsOfTYPO3\TtAddress\Domain\Model\Dto\Demand;
+use FriendsOfTYPO3\TtAddress\Service\CategoryService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Persistence\Exception\InvalidQueryException;
+use TYPO3\CMS\Extbase\Persistence\Generic\Storage\Typo3DbQueryParser;
+use TYPO3\CMS\Extbase\Persistence\Generic\Typo3QuerySettings;
+use TYPO3\CMS\Extbase\Persistence\QueryInterface;
+use TYPO3\CMS\Extbase\Persistence\QueryResultInterface;
+use TYPO3\CMS\Extbase\Persistence\Repository;
+
+/**
+ * The repository for the domain model Address
+ */
+class AddressRepository extends Repository
+{
+    /**
+     * override the storagePid settings (do not use storagePid) of extbase
+     */
+    public function initializeObject()
+    {
+        $this->defaultQuerySettings = GeneralUtility::makeInstance(Typo3QuerySettings::class);
+        $this->defaultQuerySettings->setRespectStoragePage(false);
+    }
+
+    /**
+     * @param Demand $demand
+     * @return QueryResultInterface
+     * @throws InvalidQueryException
+     */
+    public function findByDemand(Demand $demand)
+    {
+        $query = $this->createDemandQuery($demand);
+        return $query->execute();
+    }
+
+    /**
+     * @param Demand $demand
+     * @return QueryInterface
+     * @throws InvalidQueryException
+     */
+    protected function createDemandQuery(Demand $demand): QueryInterface
+    {
+        $query = $this->createQuery();
+
+        // sorting
+        $sortBy = $demand->getSortBy();
+        if ($sortBy && $sortBy !== 'singleSelection' && $sortBy !== 'default') {
+            $order = strtolower($demand->getSortOrder()) === 'desc' ? QueryInterface::ORDER_DESCENDING : QueryInterface::ORDER_ASCENDING;
+            $query->setOrderings([$sortBy => $order]);
+        }
+
+        $constraints = [];
+        $pages = $demand->getPages();
+        if (!empty($pages)) {
+            $constraints['pages'] = $query->in('pid', $pages);
+        }
+        $categories = $demand->getCategories();
+        if ($categories) {
+            $categoryConstraints = $this->createCategoryConstraint($query, $categories, $demand->getIncludeSubCategories());
+            if ($demand->getCategoryCombination() === 'or') {
+                $constraints['categories'] = $query->logicalOr(...$categoryConstraints);
+            } else {
+                $constraints['categories'] = $query->logicalAnd(...$categoryConstraints);
+            }
+        }
+
+        if ($demand->getIgnoreWithoutCoordinates()) {
+            $constraints['coordinatesLat'] = $query->logicalNot(
+                $query->logicalOr(
+                    $query->equals('latitude', null),
+                    $query->equals('latitude', 0.0)
+                )
+            );
+            $constraints['coordinatesLng'] = $query->logicalNot(
+                $query->logicalOr(
+                    $query->equals('longitude', null),
+                    $query->equals('longitude', 0.0)
+                )
+            );
+        }
+
+        if (!empty($constraints)) {
+            $query->matching($query->logicalAnd(...array_values($constraints)));
+        }
+        return $query;
+    }
+
+    /**
+     * Returns the database query to get the matching, see findByDemand()
+     *
+     * @param Demand $demand
+     * @return string
+     * @throws InvalidQueryException
+     */
+    public function getSqlQuery(Demand $demand): string
+    {
+        $query = $this->createDemandQuery($demand);
+        $queryParser = GeneralUtility::makeInstance(Typo3DbQueryParser::class);
+
+        $queryBuilder = $queryParser->convertQueryToDoctrineQueryBuilder($query);
+        $queryParameters = $queryBuilder->getParameters();
+        $params = [];
+        foreach ($queryParameters as $key => $value) {
+            // prefix array keys with ':'
+            $params[':' . $key] = (\is_numeric($value)) ? $value : "'" . $value . "'"; //all non numeric values have to be quoted
+            unset($params[$key]);
+        }
+        // replace placeholders with real values
+        $query = strtr($queryBuilder->getSQL(), $params);
+        return $query;
+    }
+
+    /**
+     * @param Demand $demand
+     * @return array|QueryResultInterface
+     * @throws InvalidQueryException
+     */
+    public function getAddressesByCustomSorting(Demand $demand)
+    {
+        $idList = GeneralUtility::intExplode(',', $demand->getSingleRecords(), true);
+        $sortBy = $demand->getSortBy();
+
+        if ($sortBy && $sortBy !== 'default' && $sortBy !== 'singleSelection') {
+            $query = $this->createQuery();
+
+            $order = strtolower($demand->getSortOrder()) === 'desc' ? QueryInterface::ORDER_DESCENDING : QueryInterface::ORDER_ASCENDING;
+            $query->setOrderings([$sortBy => $order]);
+
+            $constraints = [
+                $query->in('uid', $idList)
+            ];
+
+            $query->matching($query->logicalAnd(...$constraints));
+            return $query->execute();
+        }
+
+        if ($demand->getSortOrder() === 'DESC') {
+            $idList = array_reverse($idList);
+        }
+
+        $list = [];
+        foreach ($idList as $id) {
+            $item = $this->findByIdentifier($id);
+            if ($item) {
+                $list[] = $item;
+            }
+        }
+
+        return $list;
+    }
+
+    /**
+     * Returns a category constraint created by
+     * a given list of categories and a junction string
+     *
+     * @param QueryInterface $query
+     * @param string $categories
+     * @param bool $includeSubCategories
+     * @return array
+     * @throws InvalidQueryException
+     */
+    protected function createCategoryConstraint(QueryInterface $query, string $categories, bool $includeSubCategories = false): array
+    {
+        $constraints = [];
+
+        if ($includeSubCategories) {
+            $categoryService = GeneralUtility::makeInstance(CategoryService::class);
+            $allCategories = $categoryService->getChildrenCategories($categories);
+            if (!\is_array($allCategories)) {
+                $allCategories = GeneralUtility::intExplode(',', $allCategories, true);
+            }
+        } else {
+            $allCategories = GeneralUtility::intExplode(',', $categories, true);
+        }
+
+        foreach ($allCategories as $category) {
+            $constraints[] = $query->contains('categories', $category);
+        }
+        return $constraints;
+    }
+}