Extend models of tt_address

If an additional field should be added to the Address model, there are several ways to achive this. This documentation prefers the usage of the extension extender (https://extensions.typo3.org/extension/extender/) by Sebastian Fischer.

This documentation is divided into the following sections:

• Setup extension
• Make the field available in backend
• Configuration of EXT:extender
• Use the field in frontend

Setup extension

To extend an extension, you need to create an extension. In this example, the extension key will be called address_field and the vendor name will be GeorgRinger.

Create the directory address_field inside typo3conf/ext/address_field.

Create the following files and install the extension in the extension manager.

ext_emconf.php

<?php

$EM_CONF[$_EXTKEY] = [
    'title' => 'Extend tt_address',
    'description' => 'New field in tt_address',
    'category' => 'plugin',
    'state' => 'alpha',
    'clearCacheOnLoad' => true,
    'version' => '1.0.0',
    'constraints' => [
        'depends' => [
            'extender' => '6.6.0-6.99.99',
            'tt_address' => '4.0.0-4.99.99'
        ],
        'conflicts' => [],
        'suggests' => [],
    ],
];

ext_tables.sql

# Extend table structure for table 'tt_address'
CREATE TABLE tt_address (
 quote text NOT NULL,
);

Note

If you are using composor, don’t forget to add the following entry to the PSR-4 section: “GeorgRinger\AddressField": “web/typo3conf/ext/address_field/Classes”, and use composer dump-autoload.

Make the field available in backend

Create the following files

Configuration/TCA/Overrides/tt_address.php

<?php
defined('TYPO3_MODE') or die();

$columns = [
    'quote' => [
        'label' => 'A quote',
        'config' => [
            'default' => '',
            'type' => 'text',
        ]
    ]
];
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addTCAcolumns('tt_address', $columns);
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addToAllTCAtypes('tt_address', 'quote', '', 'after:description');

Important

Don’t forget to clear the caches (preferred in Install Tool) to make the field available in backend. The field should appear after the field Description.

Configuration of EXT:extender

Create the following files

Classes/Domain/Model/Address.php

The extension “extender” merges with the one of tt_address. Be aware that it is only possible to extend the model by new properties and methods but not to change existing ones!

<?php

namespace GeorgRinger\AddressField\Domain\Model;

class Address extends \FriendsOfTYPO3\TtAddress\Domain\Model\Address
{

    /** @var string */
    protected $quote = '';

    /**
     * @return string
     */
    public function getQuote()
    {
        return $this->quote;
    }

    /**
     * @param string $quote
     */
    public function setQuote($quote)
    {
        $this->quote = $quote;
    }
}

ext_localconf.php

<?php

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['tt_address']['extender'][\FriendsOfTYPO3\TtAddress\Domain\Model\Address::class]['ext_ttaddress']
    = 'EXT:address_field/Classes/Domain/Model/Address.php';

Use the field in frontend

After clearing the caches again, the new field is now available in the frontend in any template by using {address.quote};