0byt3m1n1
Path:
/
data
/
applications
/
aps
/
typo3
/
4.2.1-6
/
standard
/
htdocs
/
typo3
/
sysext
/
impexp
/
[
Home
]
File: locallang_csh.xml
<?xml version="1.0" encoding="utf-8" standalone="yes" ?> <T3locallang> <meta type="array"> <description>Native Import/Export</description> <type>CSH</type> <csh_table>xMOD_tx_impexp</csh_table> </meta> <data type="array"> <languageKey index="default" type="array"> <label index=".alttitle">Import/Export</label> <label index=".description">Native Import/Export module for TYPO3 data. Can export single records, content of tables, single pages or whole branches of the page tree. Includes attached media like image and preserves relations between records. Exports only to TYPO3 specific format, either a binary format (.T3D) or XML. The format is meant for exchange between TYPO3 systems.</label> <label index="_.image">EXT:impexp/cshimages/impexp.png</label> <label index=".image_descr">Example of the preview display during export configuration of a page. Notice how records on the page are include plus how references inside the record is found and included as well (bottom of screen).</label> <label index="export.alttitle">Exporting records from TYPO3</label> <label index="export.description">To export TYPO3 T3D/XML files you click any record icon or page in the page tree (including the root page!), select "More options" (requires the extensions "extra_page_cm_options" to be installed) and then "Export to .t3d". This will bring up the export interface where you can configure options for your export session.</label> <label index="export.details">There are a number of methods by which you can export data from TYPO3: - Export a single page or branch of the page tree (use page icon context menu) - Export a single record from any page (use record icon context menu) - Export all records from a specific table on a specific page (using the Web>List module) - Export an arbitrary selection of records from the clipboard (using the Web>List module) The export format observes all TYPO3s methods for relations between the records in the export file. But you will have to configure how these relations are maintained, at least to some degree. Sometimes you would want to include records referred to, at other times you surely want to keep the original mapping. That depends on your objectives with the export. Regardless of your configuration for export you will always see a complete reflection of all chosen records and their internal relations in the preview display found in the bottom of the export module page. <b>Error messages:</b> Remember to consult the Message-tab before exporting if there are any error messages there!</label> <label index="_export.seeAlso">xMOD_tx_impexp:import</label> <label index="_export.image">EXT:impexp/cshimages/export.png, EXT:impexp/cshimages/export1.png, EXT:impexp/cshimages/export2.png</label> <label index="export.image_descr">To export a page or record, simply click the icon and select "Export" from the context menu. With the Web>List module you can also export all records from a table by first clicking the table title to see only this table, then next to the CSV export you will find the export button for a T3D export of the table. You can export the contents of the clipboard as well by simply selecting "Export" in the menu.</label> <label index="pageTreeCfg.alttitle">Configuration of page tree export</label> <label index="pageTreeCfg.description">Here you configure how a page or a branch of the page tree should be exported. Using the selector box you can set the number of levels of subpages to include in the export. By default all records belonging to a page is included when a page is exported.</label> <label index="_pageTreeCfg.image">EXT:impexp/cshimages/pagetreecfg.png</label> <label index="pageTreeDisplay.alttitle">Page Tree</label> <label index="pageTreeDisplay.description">Based on the levels selected for page tree export this will show the structure that is about to be exported. If any pages are specifically excluded by the exclude option they are not shown either.</label> <label index="pageTreeMode.alttitle">Levels</label> <label index="pageTreeMode.description">Here you select how deeply in the page tree from the current starting point to go for this export.</label> <label index="pageTreeMode.details">If you select "Expanded tree" it will base the export on the currently expanded levels of the page tree. Another special option is "Tables on this page" which will not include the page record itself but only include records from tables on the page, depending on the table configuration of course.</label> <label index="_pageTreeMode.image">EXT:impexp/cshimages/impexp_misc.png</label> <label index="pageTreeRecordLimit.alttitle">Include tables</label> <label index="pageTreeRecordLimit.description">When you export a page all records on the page is included by default. By this selector you can pick which tables to include exclusively if there are certain records you are not interested in seeing included.</label> <label index="pageTreeRecordLimit.details">In the box "Max number of records" you can set a limit to how many records are selected from a single table. This is a runaway brake in case you have an unusual large amount of records from a table.</label> <label index="singleRecord.alttitle">Export single record</label> <label index="singleRecord.description">This overview tells you which independent records has been independently selected for export.</label> <label index="_singleRecord.image">EXT:impexp/cshimages/singlerecord.png, EXT:impexp/cshimages/export2.png</label> <label index="singleRecord.image_descr">The way to export multiple records like this is using the clipboard like shown below.</label> <label index="tableList.alttitle">Table export</label> <label index="tableList.description">Export of all records on a page from a specific table. This is configured from the Web>List module where you will have to select table-only view and click a button in the top of the page.</label> <label index="tableList.details">Tip: You can select multiple table lists by simply saving each selecting as a preset and finally load/merge the selections together.</label> <label index="_tableList.image">EXT:impexp/cshimages/tablelist.png, EXT:impexp/cshimages/export1.png</label> <label index="tableList.image_descr">Here two tables from different pages are selected. This is done by first selecting the one, saving it as a preset, then select the other and merge with the saved preset. Here you see how to use the Web>List module to export all records from a table on a page.</label> <label index="tableListMaxNumber.alttitle">Max number to export</label> <label index="tableListMaxNumber.description">Run-away brake that will make sure a large amount of records does not halt the interface. Default is 100, but you can change it to anything you like of course.</label> <label index="inclRelations.alttitle">Include relations</label> <label index="inclRelations.description">Configure the tables from which you want to include records that are found as relations in the main export configuration.</label> <label index="inclRelations.details">Background: When you export a record in TYPO3 it might contain relations to other records in the system. You have to tell the export interface what to do with these relations. Basically there are three scenarios: - If relations are found between records that are all in the export configuration, there is no problem: The relations are automatically mapped to the new id's of those records when imported. - If the records related to are not included the relation will be lost (indicated with an error message in the preview) unless you a) either select that table in this selector box in which case all relations to that table will be included or b) if you set the table as a static table (in which case the relation is untouched and imported as-is - but which will of course break if no record with that UID is found in the import system). <b>Soft References:</b> Soft references are when a record contains pointers to external files or records but in fields where there are no formal relation configured. Examples of this is when a content element contains a "&lt;link 123&gt;" tag that represents a link to the page 123. This is not picked up formally as a reference, but is found anyhow as a "soft reference". The same goes for &lt;img&gt; tags with images from eg. "fileadmin/". By default soft references pointing to records or files will act as normal references; either including the referenced item or showing an error. However you can also choose to exclude the handling of individual soft references or maybe set the value as "editable" upon import. This is done with a selector box in the export preview.</label> <label index="_inclRelations.image">EXT:impexp/cshimages/references.png, EXT:impexp/cshimages/references1.png, EXT:impexp/cshimages/references2.png</label> <label index="inclRelations.image_descr">This example shows tree examples of references; a) an image attached to a content element, b) a relation to a frontend usergroup UID, and c) a soft reference found in the bodytext field of a record, here it is the link-tag pointing to the page with UID 1. Notice in the previous image how the relation to the frontend user group was lost. This has been corrected in this screenshot where the fe_group table has been selected in the list of table for which to include relations. The result is that the frontend usergroup is included as a record outside the exported pagetree. If you wanted to keep the relation but not include the usergroup you have to set "fe_groups" as a static table instead. See below. This example shows a TypoScript Template Record where multiple soft references has been found. The first one is an email address. Here it is configured to be editable. This means that upon import the user will have a chance to edit the value before the import is actually done. This is very useful when exported files are used as templates. Another example includes a PHP script which we don't want to include in the export and therefore we have selected the exclude option for the soft reference.</label> <label index="staticRelations.alttitle">Set static tables</label> <label index="staticRelations.description">Select which tables in addition to the static TYPO3 tables to keep relations untouched for. Takes precedence over "Include relations" configured tables.</label> <label index="staticRelations.details">By default all relations to static tables in TYPO3 are kept untouched. Of course those static tables should be present in the import system in order for this to work correctly. However there might be circumstances where you move information between two systems where theoretically non-static tables should just keep relations untouched. Examples could be "sys_languages" or TemplaVoila data structures / template objects where two systems might contain the same set of records in those tables while you are importing pages and content elements freely.</label> <label index="_staticRelations.image">EXT:impexp/cshimages/static.png, EXT:impexp/cshimages/static1.png</label> <label index="staticRelations.image_descr">In this example you see how a number of records are pointing to a System Language record which will become lost relations when imported because the record is not included in the export. However; in the target system the System Languages are exactly the same and therefore you just want a static mapping of the relations. The static mapping is obtained by selecting the "sys_language" table as a static template meaning that the relations are kept at their current values assuming that they will be exactly the same in the target system when imported.</label> <label index="excludedElements.alttitle">Excluded elements</label> <label index="excludedElements.description">By the "Exclude" checkbox you can exclude specific records from the preview display of the export. Which records has been picked for specific exclusion is listed here. You can also clear the exclusion configuration.</label> <label index="_excludedElements.image">EXT:impexp/cshimages/excludebox.png</label> <label index="htmlCssResources.alttitle">Exclude resources from HTML and CSS files</label> <label index="htmlCssResources.description">When an HTML or CSS file is found as a soft reference the files are parsed for references to external media (such as images) and if any are found they are also exported. If you don't want this behaviour, click this option.</label> <label index="htmlCssResources.details">Notice: Resources found inside an HTML or CSS file are not analysed further. For instance it means that any CSS files referred to from within an HTML will not be traversed - but CSS files referred to inside the Setup or Constant field of a TypoScript template record will be!</label> <label index="_htmlCssResources.image">EXT:impexp/cshimages/htmlcss.png</label> <label index="htmlCssResources.image_descr">In this example you can see that a soft reference has been found pointing to an HTML file inside fileadmin/ Since it was an HTML file it was parsed and further a number of files were found referenced inside it and now included with the export. This feature is specifically created to support export of template configurations where external HTML files play a role.</label> <label index="extensionDependencies.alttitle">Extension Dependencies</label> <label index="extensionDependencies.description">Select which extensions should be installed in the import system in order for your exported content to work correctly. Examples could be "templavoila" for templating, "css_styled_content" for the template, "tt_news" for a news archive etc.</label> <label index="extensionDependencies.details">During import warnings will appear for all selected extensions from this list which were not installed.</label> <label index="_extensionDependencies.image">EXT:impexp/cshimages/extdep.png</label> <label index="presets.alttitle">Configuration presets</label> <label index="presets.description">Enables you to save an export configuration for later re-use. Useful if you need to export the same configuration with regular intervals.</label> <label index="presets.details">In the "Select preset" box you can select any previously saved preset to load. If you are exporting a page the presets listed will be those found for the start page ID. For records, any preset can be loaded. To load a preset, select it in the selector and press "Load". If you press "Merge" instead the settings from the preset will be merged with the current configuration. This is meaningful in cases where you select multiple individual tables or records. To save a preset, simply enter a title in the title box and press "Save". This will create a new preset. If you press save while having selected an existing preset you will overwrite it. To delete old presets, simply select it and press "Delete". The checkbox "Public" can be set if you want to share your preset with other users of the system. Otherwise they are personal to you. In the Taskcenter you can see a list of your presets and jump directly to them.</label> <label index="_presets.image">EXT:impexp/cshimages/impexp_misc1.png, EXT:impexp/cshimages/impexp_misc2.png</label> <label index="presets.image_descr">The preset selector in the export interface. Presets from the task center.</label> <label index="metadata.alttitle">Meta data setting</label> <label index="metadata.description">Set meta data for the export. This is highly encouraged if your exported content goes into eg. a template collection of sorts.</label> <label index="metadata.details">The meta data will help users of your exported files to know what they can expect to be inside and what things they should be aware of and take into account during import. The "Title" and "Description" should contain the basic information about the export. The "Notes" field can be used for additional details, especially remarks about intensions or requirements that apply. The thumbnail field is used for thumbnails if you need that for your export. This is very useful when export files are used as page templates where the template selector can take advantage of the thumbnail. The format should be a web-format like jpg, gif or png and the dimensions should fit exactly the final display dimensions intended; so don't upload very large images!</label> <label index="_metadata.image">EXT:impexp/cshimages/metadata.png</label> <label index="fileFormat.alttitle">File format options</label> <label index="fileFormat.description">You can export your records to a TYPO3 specific binary format (serialized PHP array) called "T3D". Alternatively you can select a plain-text XML export which potentially can be imported by other applications written to support this format. However the schema of the XML is TYPO3 specific.</label> <label index="fileFormat.details">Generally you should use the T3D format, preferably compressed. The T3D compressed format normally yields a size about 10 times less than the XML format which is bloaded due to the plain-text nature of the format. With "Max size of files to include" you can set a limit to the size of attached files to records. This is useful if you have large PDF files or videoclips attached to records which you do not desire (or do desire!) to include; then with this limit you can adjust whether they are allowed in or not. Entering a file name to save to makes it possible to write your export directly to a file (pressing "Save to filename") instead of downloading it (pressing "Download export"). The correct file extensions depending on file format is automatically applied. Files are saved in a proper filemount in "fileadmin/". This is shown to you upon saving. Existing files are overwritten.</label> <label index="_fileFormat.image">EXT:impexp/cshimages/fileformat.png</label> <label index="import.alttitle">Importing TYPO3 records</label> <label index="import.description">To import TYPO3 T3D/XML files into the page tree you click any page in the page tree (including the root page!), select "More options" (requires the extensions "extra_page_cm_options" to be installed) and then "Import from .t3d". This will bring up the import interface where you can select a file to import or upload a new one.</label> <label index="import.details"><b>Tip: Import into a Sys Folder</b> To make sure that no records are lost during the import, you can make yourself safe by importing into a SysFolder you create first. After the import you can move all records to the final destinations. An example of such a scenario is if you configured the export to include relations; In that case a number of records may follow the export outside the page tree structure you are exporting. To make sure that all of these external records are written to the database, importing into a SysFolder is a good idea. <b>Error messages:</b> Remember to consult the Message-tab before/after importing to see if there are any error messages there!</label> <label index="_import.seeAlso">xMOD_tx_impexp:export</label> <label index="_import.image">EXT:impexp/cshimages/import.png</label> <label index="importFile.alttitle">Select file to import</label> <label index="importFile.description">The files displayed are those with an extension T3D or XML from fileadmin/, fileadmin/export/ and your "TEMP" folder (if any).</label> <label index="_importFile.seeAlso">xMOD_tx_impexp:fileFormat</label> <label index="_importFile.image">EXT:impexp/cshimages/import_selectfile.png</label> <label index="update.alttitle">Update instead of Insert</label> <label index="update.description">By default the import operation inserts new records in the system. Using this option will update existing records.</label> <label index="update.details">There are certain requirements you have to meet if you want the "Update" process to work. The main thing is that the records updated are those with the SAME uid as the uid in the export file. Thus an update operation only makes real sense if the export and import systems are somehow related and the same UIDs can be expected in both ends. Otherwise it will be a mess! When you update page structures the import operation will automatically try to rearrange records so they also appear in the same hierarchy and order as in the export file. This can be disabled by checking the option "Ignore PID differences globally". In any case you can set individual records to Ignore/Respect the PID with a selectorbox in the preview. In the preview display you can also select if individual records should be flatly ignored during import or if you want them created as new records instead of being updates. As a help for managing updates the preview display will inform you about the path where the existing element with that UID is found. Use this to verify that you get what you expect! <b>Forcing the UID:</b> If you intend to update a system and some elements from the import are not mappable to a UID already (ei. does not exist) you can choose in the preview display to force the UID during creation. This is an unorthodox thing to do since UIDs are normally created automatically by the database. The option makes most sense if you are trying to "synchronize" a copy of another system. The option may mess up certain database internals and the feature is therefore only available for admins.</label> <label index="_update.image">EXT:impexp/cshimages/impexp_misc4.png, EXT:impexp/cshimages/update.png</label> <label index="update.image_descr">In Update mode you can select various settings for each record. You will also be able to see a diff-view where the differences between the existing record and the one from the import is shown.</label> <label index="options.alttitle">Import options</label> <label index="options.description">Various options for import.</label> <label index="options.details"><b>Do not show differences in records</b> When a structure has been imported you will see a difference view of all records which tells you whether the written content matched the import data or if not, what changed. In many cases content <i>should</i> change (eg. relations and file references) so it is not an error if you see red and green values. Basically the difference view is a feature you can use for visual validation of the import success. It brings piece-of-mind to those who is enlightened to understand what it tells... :-) Green strings represent the actual written data while red represents the original value from the import file and black represents data that is the same. <b>Allow to write banned file extensions (eg. PHP scripts), if any</b> Also an option for admins-only; Allows PHP-files (for example from soft references in TypoScript templates) to be written to the system. This is normally not allowed behavior for security reasons.</label> <label index="_options.image">EXT:impexp/cshimages/impexp_misc3.png, EXT:impexp/cshimages/phpext.png</label> <label index="options.image_descr">Options for import. Here you are told that this PHP file cannot be allowed - because you didn't select the option "Allow to write banned file extensions (eg. PHP scripts), if any"</label> <label index="action.alttitle">Import Action</label> <label index="action.description">Press "Preview" to see the content of the import file or update the preview display according to changed configurations. Press "Import"/"Update" if you want to perform the actual import. Before importing make sure you change any editable soft references that are shown in the preview data.</label> <label index="_action.image">EXT:impexp/cshimages/diffview.png</label> <label index="action.image_descr">Example of the result view after importing. As you can see the RTE attached images (soft references) has been written to new file names and the difference view tells you that the names changed in the bodytext content.</label> <label index="enableLogging.alttitle">Enable System Logging</label> <label index="enableLogging.description">If you set this the system backend log will be filled with entries for all the actions that the import actually performs. By default this is left out for the sake of clarity.</label> <label index="upload.alttitle">Upload import file</label> <label index="upload.description">Select a file to import from your local computer and upload it here. If the upload completes succesfully you can immediately see its content displayed in the preview display.</label> <label index="upload.details">Notice that there are usually limits set by the server (PHP) to the size of uploaded files at around 2 MB in which case nothing will happen.</label> </languageKey> </data> </T3locallang>