Using the link wizard in a Typo3 backend module

Question

I'm pulling my hair out over this.

I created a T3-Extension - backend module - using Extension Builder. Now I want to provide the user with the link-wizard, so she/he can select an internal link from the T3-Tree.

I created a TCA-Entry for this:

'url' => [
        'label' => 'Link',
        'exclude' => 1,
        'config' => [
            'type'  => 'input',
            'size'  => '50',
            'max'   => '256',
            'eval'  => 'trim',
            'renderType' => 'inputLink',
            'fieldControl' => [
                'linkPopup' => [
                    'options' => [
                        'blinkLinkOptions' => 'mail,page,spec,url,folder',
                        'blindLinkFields' => 'class,params,target,title',
                        'allowedExtensions' => 'html,php'
                    ],
                ],
            ],
            'fieldWizard' => [
                'localizationStateSelector' => [
                    'disabled' => false,
                ]
            ]
        ],
    ],

In the fluid-template (the view) I'm simply using this:

<f:form.textfield property="url" />

According to the docs, the TCA-config should add a button after the input field.

But that's not the case.

Am I doing something wrong or is this simply not working?

I also tried using flux in my templates (which has a link-browser view helper), but when I use <flux:...> nothing is rendered in the form.

Using Typo3 8.7

Swissdude Swissdude · Accepted Answer · 2018-11-06T12:44:15

I finally found a solution for this.

This is in the controller of my extension

$options = [
        'renderType' => 'inputLink',
        'tableName' => 'myTable',
        'fieldName' => 'url',
        'databaseRow' => [
            'uid' => $myModel->getUid(),
            'pid' => 0
        ],
        'parameterArray' => [
            'fieldConf' => [
                'label' => 'URL',
                'config' => [
                    'eval' => 'trim',
                    'size' => 1024,
                ],
            ],
            'itemFormElValue' => $myModel->getUrl(),
            'itemFormElName' => 'data[myTable][editform][url]',
            'itemFormElID' => 'data[mytable][editform][url]',
            'field' => 'url',
            'fieldChangeFunc' => [
                'TBE_EDITOR_fieldChanged' => "TBE_EDITOR.fieldChanged('mytable','editform','url','data[mytable][editform][url]');"
                ],

        ]
    ];

        $nodeFactory = new NodeFactory();
        $linkField = new InputLinkElement($nodeFactory, $options);
        $urlField = $linkField->render();

        $this->view->assign('renderedUrlField', $urlField['html']);

Where «mytable» is the table the controller uses, «editform» is the form-name and «url» is the database-field that's been used to store the value.

For some reason, you need to name your form «editform», since a sysext-JS refers to that.

You need to add this to your controller to make this working:

use TYPO3\CMS\Backend\Form\Element\InputLinkElement;
use TYPO3\CMS\Backend\Form\NodeFactory;

And in the fluid-template, you have to use:

<f:format.raw>{renderedUrlField}</f:format.raw>

because it returns html-code.

Now initialize the FormEngine

Add this to your Default.html in the section <f:be.container...>:

includeJsFiles="{
        1:'/typo3/sysext/backend/Resources/Public/JavaScript/jsfunc.tbe_editor.js',
3:'/typo3/sysext/backend/Resources/Public/JavaScript/jsfunc.inline.js',
        4:'/typo3/sysext/backend/Resources/Public/JavaScript/backend.js'
    }"

            includeRequireJsModules="{
        0:'{f:uri.resource(path:\'JavaScript/ckeditor/ckeditor.js\')}',
        4:'TYPO3/CMS/Backend/FormEngine',
        5:'TYPO3/CMS/Backend/FormEngineValidation',
        7:'TYPO3/CMS/Backend/ContextMenu',
        8:'TYPO3/CMS/Backend/FormEngineReview',
        9:'{f:uri.resource(path:\'JavaScript/main.js\')}'
      }"

I included ckeditor as well here.

And now, you need to initialize the FormEngine. I did this in main.js:

TYPO3.settings.FormEngine = {"formName":"editform"};

define(['jquery', 'TYPO3/CMS/Backend/FormEngine'], function($){
    'use strict';

    $(function(){
        TYPO3.FormEngine.initialize();
    });
});

The first line is important, otherwise, the JS will throw an error.

Hope this helps somebody.

Using the link wizard in a Typo3 backend module

2 Answers