.. include:: /Includes.rst.txt
.. _soft-references:
Soft References
^^^^^^^^^^^^^^^
"Soft References" are references to database elements, files, email
addresses, URLs etc. which are found inside text fields. The
:code:`` tag found in bodytext fields is an example of this.
The Soft Reference parsers are used by the system to find these
references and process them accordingly in import/export actions and
copy operations. Also, the soft references are used by integrity
checking functions.
.. _soft-references-default-parsers:
Default soft reference parsers
""""""""""""""""""""""""""""""
The `TYPO3\\CMS\\Core\\Database\\SoftReferenceIndex`
class contains generic parsers for the most well-known types
which are default for most TYPO3 installations. This
is the list of the possible keys:
.. _soft-references-default-parsers-substitute:
substitute
~~~~~~~~~~
.. container:: table-row
softref key
substitute
Description
A full field value targeted for manual substitution (for import
/export features)
.. _soft-references-default-parsers-notify:
notify
~~~~~~
.. container:: table-row
softref key
notify
Description
Just report if a value is found, nothing more.
.. _soft-references-default-parsers-images:
images
~~~~~~
.. container:: table-row
softref key
images
Description
HTML :code:`` tags for RTE images / images from :file:`fileadmin/`.
.. _soft-references-default-parsers-typolink:
typolink
~~~~~~~~
.. container:: table-row
softref key
typolink
Description
References to page id or file, possibly with anchor/target, possibly
comma-separated list.
.. _soft-references-default-parsers-typolink-tag:
typolink\_tag
~~~~~~~~~~~~~
.. container:: table-row
softref key
typolink\_tag
Description
As typolink, but searching for a :code:`` tag encapsulating it.
.. _soft-references-default-parsers-tsconfig:
TSconfig
~~~~~~~~
.. container:: table-row
softref key
TSconfig
Description
References to files.
.. _soft-references-default-parsers-tstemplate:
TStemplate
~~~~~~~~~~
.. container:: table-row
softref key
TStemplate
Description
Free text references to "fileadmin/" files. HTML resource links like
:code:``, :code:``, :code:`