Eine eigene TYPO3 Extension (Extbase/Fluid) mit System Kategorien erstellen (Teil 2)

In diesem Teil verknüpfen wir unsere TYPO3 Extension, die wir in Teil 1 der Reihe erstellt haben, mit den System Kategorien von TYPO3.

Der Extension Builder hat unsere Extension, die wir in Teil 1 erstellt haben, in dem Verzeichnis
„typo3conf -> ext“
abgespeichert. In unserem Fall ist der Ordnername der Extension „ha_kategorieext“ analog zu unserem angegebenen Extension Key. Folgende Struktur hat uns der Extension Builder darin angelegt:

• Classes
• Configuration
• Documentation.tmpl (kann gelöscht werden)
• Resources
• Tests (kann gelöscht werden)
• ext_emconf.php
• ext_icon.gif
• ext_localconf.php
• ext_tables.php
• ext_tables.sql
• ExtensionBuilder.json (kann gelöscht werden)

TYPO3 System Kategorien integrieren

Jetzt wird es Zeit unsere TYPO3 Extension zu bearbeiten.

NeuerInhaltController.php (Classes -> Controller)

Aktueller Code:

public function listAction() {
        $neuerInhalts = $this->neuerInhaltRepository->findAll();
        $this->view->assign('neuerInhalts', $neuerInhalts);
    }

Ersetzen durch:

public function listAction() {
        $demand = $this -> createDemandObjectFromSettings($this -> settings);
        $entries = $this -> neuerInhaltRepository -> findDemanded($demand);
        $this -> view -> assign('neuerInhalts', $entries);
    }

Und zusätzlich hinzufügen:

protected function createDemandObjectFromSettings($settings) {
        $demand = $this->objectManager->get('Vekategorieext\\HaKategorieext\\Domain\\Model\\NeuerInhalt'); // Neuer Inhalt ist der Dateiname vom Domain Modell -> Classes -> Domain -> Model
        $demand->setCategories($settings['categories']);
        return $demand;
    }

NeuerInhalt.php (Classes -> Domain -> Model)

Aktueller Code:

public function setCategories(\TYPO3\CMS\Extbase\Persistence\ObjectStorage $categories) {
        $this->categories = $categories;
    }

Ändern in:

public function setCategories($categories) {
        $this->categories = $categories;
    }

NeuerInhaltRepository.php (Classes -> Domain -> Repository)

Aktueller Code:

protected $defaultOrderings = array(
        'sorting' => \TYPO3\CMS\Extbase\Persistence\QueryInterface::ORDER_ASCENDING
    );

Ersetzen durch:

public function findDemanded($demand) {
        $query = $this -> createQuery();
        $query -> getQuerySettings() -> setRespectStoragePage(FALSE);
        $query -> setOrderings($this -> createOrdering());
        $constraints = $this -> createConstraintsFromDemand($query, $demand);
        if (!empty($constraints)) {
            $query -> matching(
            $query -> logicalAnd($constraints)
        );
        }
        return $query -> execute();
    }
        
        
    protected function createConstraintsFromDemand(\TYPO3\CMS\Extbase\Persistence\QueryInterface $query, $demand) {
        $constraints = array();
        
        $categories = $demand -> getCategories();
        if ((!empty($categories))) {
            $categoryConstraints = array();
            $categories = \TYPO3\CMS\Core\Utility\GeneralUtility::intExplode(',', $categories, TRUE);
            foreach ($categories as $category) {
                $categoryConstraints[] = $query -> contains('categories', $category);
            }
            $constraints = $query -> logicalOr($categoryConstraints);
        }
        return $constraints;
    }
        
    protected function createOrdering() {
        $orderings = array('sorting' => \TYPO3\CMS\Extbase\Persistence\QueryInterface::ORDER_DESCENDING);
        return $orderings;
    }

Flexform hinzufügen

ext_tables.php

Am Ende hinzufügen:

$extensionName = strtolower(\TYPO3\CMS\Core\Utility\GeneralUtility::underscoredToUpperCamelCase($_EXTKEY));
$pluginName = strtolower('Fekategorieext');
$pluginSignature = $extensionName.'_'.$pluginName;

$TCA['tt_content']['types']['list']['subtypes_excludelist'][$pluginSignature] = 'layout,recursive,select_key,pages';
$TCA['tt_content']['types']['list']['subtypes_addlist'][$pluginSignature] = 'pi_flexform';
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addPiFlexFormValue($pluginSignature, 'FILE:EXT:'.$_EXTKEY . '/Configuration/FlexForms/flexform.xml');

FlexForms Ordner erstellen (Configuration -> FlexForms)

Im FlexForms Ordner eine flexform.xml erstellen (Configuration -> FlexForms -> flexform.xml)

Inhalt:

<T3DataStructure>
    <meta>
        <langDisable>1</langDisable>
    </meta>
    <sheets>
        <sDEF>
            <ROOT>
                <TCEforms>
                    <sheetTitle>title</sheetTitle>
                </TCEforms>
                <type>array</type>
                <el>
                    <settings.categories>
                        <TCEforms>
                          <exclude>1</exclude>
                          <label>Kategorien:</label>
                          <config>
                            <type>select</type>
                            <autoSizeMax>50</autoSizeMax>
                            <foreign_table>sys_category</foreign_table>
                            <foreign_table_where> AND sys_category.sys_language_uid IN (-1, 0) ORDER BY sys_category.title ASC</foreign_table_where>
                            <maxitems>9999</maxitems>
                            <renderMode>tree</renderMode>
                            <size>10</size>
                            <treeConfig>
                                <appearance>
                                    <expandAll>1</expandAll>
                                    <showHeader>1</showHeader>
                                </appearance>
                                <parentField>parent</parentField>
                            </treeConfig>
                          </config>
                        </TCEforms>
                    </settings.categories>
                </el>
            </ROOT>
        </sDEF>
    </sheets>
</T3DataStructure>

setup.txt (Configuration -> TypoScript)

Das komplette CSS_DEFAULT_STYLE kann gelöscht werden

Aktueller Code:

plugin.tx_hakategorieext_fekategorieext {
    view {
        templateRootPaths.0 = {$plugin.tx_hakategorieext_fekategorieext.view.templateRootPath}
        partialRootPaths.0 = {$plugin.tx_hakategorieext_fekategorieext.view.partialRootPath}
        layoutRootPaths.0 = {$plugin.tx_hakategorieext_fekategorieext.view.layoutRootPath}
    }
    persistence {
        storagePid = {$plugin.tx_hakategorieext_fekategorieext.persistence.storagePid}
    }
}

Ändern zu:

plugin.tx_hakategorieext_fekategorieext {
    view {
        templateRootPaths.0 = {$plugin.tx_hakategorieext_fekategorieext.view.templateRootPath}
        partialRootPaths.0 = {$plugin.tx_hakategorieext_fekategorieext.view.partialRootPath}
        layoutRootPaths.0 = {$plugin.tx_hakategorieext_fekategorieext.view.layoutRootPath}
    }
    persistence {
        storagePid = {$plugin.tx_hakategorieext_fekategorieext.persistence.storagePid}
    }
    mvc {
        callDefaultActionIfActionCantBeResolved = 1
    }
}

Extension aktivieren

That’s it! Zum Schluß müssen wir nur noch unsere TYPO3 Extension im Extension Manager aktivieren. Das Statische TypoScript einbinden und schon kann man die System internen Kategorien von TYPO3 nutzen.