CategoryMenuUtility.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Frontend\ContentObject\Menu;

use TYPO3\CMS\Core\Utility\GeneralUtility;

class CategoryMenuUtility {
    protected static $sortingField;

    public function collectPages($selectedCategories, $configuration, $parentObject) {
        $selectedPages = array();
        $categoriesPerPage = array();
        // Determine the name of the relation field
        $relationField = '';
        if (isset($configuration['relation.'])) {
            $relationField = $parentObject->parent_cObj->stdWrap(
                $configuration['relation'],
                $configuration['relation.']
            );
        } elseif (isset($configuration['relation'])) {
            $relationField = $configuration['relation'];
        }
        // Get the pages for each selected category
        $selectedCategories = GeneralUtility::intExplode(',', $selectedCategories, TRUE);
        foreach ($selectedCategories as $aCategory) {
            $collection = \TYPO3\CMS\Frontend\Category\Collection\CategoryCollection::load(
                $aCategory,
                TRUE,
                'pages',
                $relationField
            );
            $categoryUid = $collection->getUid();
            // Loop on the results, overlay each page record found
            foreach ($collection as $pageItem) {
                $parentObject->getSysPage()->versionOL('pages', $pageItem, TRUE);
                if (is_array($pageItem)) {
                    $selectedPages[$pageItem['uid']] = $parentObject->getSysPage()->getPageOverlay($pageItem);
                    // Keep a list of the categories each page belongs to
                    if (!isset($categoriesPerPage[$pageItem['uid']])) {
                        $categoriesPerPage[$pageItem['uid']] = array();
                    }
                    $categoriesPerPage[$pageItem['uid']][] = $categoryUid;
                }
            }
        }
        // Loop on the selected pages to add the categories they belong to, as comma-separated list of category uid's)
        // (this makes them available for rendering, if needed)
        foreach ($selectedPages as $uid => $pageRecord) {
            $selectedPages[$uid]['_categories'] = implode(',', $categoriesPerPage[$uid]);
        }

        // Sort the pages according to the sorting property
        self::$sortingField = isset($configuration['sorting.']) ? $parentObject->getParentContentObject()->stdWrap($configuration['sorting'], $configuration['sorting.']) : $configuration['sorting'];
        $order = isset($configuration['order.']) ? $parentObject->getParentContentObject()->stdWrap($configuration['order'], $configuration['order.']) : $configuration['order'];
        $selectedPages = $this->sortPages($selectedPages, $order);

        return $selectedPages;
    }

    protected function sortPages($pages, $order) {
        // Perform the sorting only if a criterion was actually defined
        if (!empty(self::$sortingField)) {
            // Check that the sorting field exists (checking the first record is enough)
            $firstPage = current($pages);
            if (isset($firstPage[self::$sortingField])) {
                // Make sure the order property is either "asc" or "desc" (default is "asc")
                if (!empty($order)) {
                    $order = strtolower($order);
                    if ($order != 'desc') {
                        $order = 'asc';
                    }
                }
                uasort(
                    $pages,
                    array(
                        '\TYPO3\CMS\Frontend\ContentObject\Menu\CategoryMenuUtility',
                        'sortPagesUtility'
                    )
                );
                // If the sort order is descending, reverse the sorted array
                if ($order == 'desc') {
                    $pages = array_reverse($pages, TRUE);
                }
            }
        }
        return $pages;
    }

    static public function sortPagesUtility($pageA, $pageB) {
        return strnatcasecmp($pageA[self::$sortingField], $pageB[self::$sortingField]);
    }
}