TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:28 +02:00
commit 3a4ca58ca1
90 changed files with 9646 additions and 0 deletions
@@ -0,0 +1,128 @@
+:navigation-title: Export
+
+..  include:: /Includes.rst.txt
+..  _export:
+
+==========================================
+Exporting content from TYPO3 to XML or T3D
+==========================================
+
+The export functionality is only available for admin users and backend
+users for which the Page TSconfig option
+:ref:`options.impexp.enableExportForNonAdminUser
+<t3tsref:useroptions-impexp-enableExportForNonAdminUser>` has been enabled.
+
+..  attention::
+
+    Exporting content may expose sensitive data or allow unwanted file access.
+    Review the :ref:`security considerations regarding exports <security>`
+    before using this functionality.
+
+..  _export-open-module:
+
+Open the export module
+======================
+
+In the page tree, right-click the page from which you want to start the
+export (1) and select :guilabel:`More options ...  > Export` (2).
+
+..  include:: /Images/AutomaticScreenshots/ContextMenuExport.rst.txt
+
+..  _export-configure-settings:
+
+Configure the export settings
+=============================
+
+On the first tab of the export module you can fine-tune the export (1).
+
+-   If you want to export all data of the selected page including its
+    subpages, select the "Infinite" option in the :guilabel:`Levels`
+    selection box.
+
+-   Under :guilabel:`Include tables` you can limit the types of records to
+    be exported.
+
+-   Under :guilabel:`Include relations to tables` you specify which
+    relations of the records should be included in the export file. The
+    related records will be included even if they are outside the pages
+    selected for export.
+
+-   Under :guilabel:`Use static relations for tables` you select which
+    relations should be included without including the related record. This
+    is useful if the related record already exists in the target TYPO3
+    instance.
+
+-   If the same table is selected in both :guilabel:`Include relations to
+    tables` and :guilabel:`Use static relations for tables`, the relation
+    is treated as static.
+
+-   The :guilabel:`Exclude disabled elements` checkbox excludes records
+    that are disabled according to their TCA configuration. This is checked
+    by default.
+
+Apply your changes via the :guilabel:`Update` button and repeat this step
+until the preview meets your expectations.
+
+..  include:: /Images/AutomaticScreenshots/ConfigureExport.rst.txt
+
+..  _export-review-records:
+
+Review the records to be exported
+=================================
+
+All pages selected for export are listed in the upper part of the dialog
+(1).
+
+Below this is a detailed list of all data to be exported (2). Here you
+can exclude individual records or manually make them editable, if
+supported.
+
+If the relation to records is lost, an orange exclamation mark will be
+shown. This happens if records are stored outside the export page tree
+or if excluded tables break relations.
+
+Apply your changes by pressing the :guilabel:`Update` button and repeat
+this step as needed until the preview matches your expectations (3).
+
+Then switch to the :guilabel:`Advanced Options` tab (4).
+
+..  include:: /Images/AutomaticScreenshots/CheckExport.rst.txt
+
+..  _export-advanced-options:
+
+Optionally select advanced export options
+=========================================
+
+In the third tab of the export module you can specify further export
+options (1).
+
+Checking :guilabel:`Save files in extra folder ..` saves linked files
+in a separate folder instead of embedding them in the export file. This
+is mandatory for :ref:`distributions <t3coreapi:distribution>` or
+useful when handling large file sets that would otherwise bloat the
+export file and potentially exhaust memory. The folder is named
+"{filename}.files".
+
+Apply your changes via the :guilabel:`Update` button (2) and then switch
+to the :guilabel:`File & Preset` tab (3) to proceed.
+
+..  include:: /Images/AutomaticScreenshots/SelectAdvancedExportOptions.rst.txt
+
+..  _export-perform:
+
+Perform the export
+==================
+
+In the second tab of the export module you can specify the metadata for
+the export (1) before starting the export process.
+
+You can then either:
+
+-   Download the export file (2.a), or
+-   Save it on the server (2.b).
+
+Saving on the server is currently required if you have enabled saving
+related files in a separate folder (see
+:ref:`export-advanced-options`).
+
+..  include:: /Images/AutomaticScreenshots/DownloadExport.rst.txt