..  include:: /Includes.rst.txt
..  _tca_property_fieldControl_linkPopup:

..  _tca_field_control_link_popup:

=========
linkPopup
=========

..  confval:: linkPopup

   :Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']
   :type: array
   :Scope: fieldControl
   :RenderTypes: inputLink

   The link browser control is typically used with `type='input'` with `renderType='inputLink'` adding a button
   which opens a modal to select an internal link to a page, an external link or a mail address.

   **Example:**

   ..  code-block:: php

      'aField' => [
          'config' => [
              'fieldControl' => [
                  'linkPopup' => [
                      'options' => [
                          'blindLinkOptions' => 'file,folder',
                      ],
                  ],
              ],
          ],
      ],

   **Options:**

   allowedExtensions (string, list)
      Comma separated list of allowed file extensions. By default, all extensions are allowed.

   blindLinkFields (string, list)
      Comma separated list of link fields that should not be displayed. Possible values are
      `class`, `params`, `target` and `title`. By default, all link fields are displayed.

   blindLinkOptions (string, list)
      Comma separated list of link options that should not be displayed. Possible values are
      `file`, `folder`, `mail`, `page`, `telephone` and `url`. By default, all link options are displayed.

   title (string or LLL reference)
      Allows to set a different 'title' attribute to the popup icon, defaults
      to :code:`LLL:EXT:lang/Resources/Private/Language/locallang_core.xlf:labels.link`