heimrichhannot / contao-entity_import
A backend only module, to migrate items from one database into another (experts only).
Installs: 574
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 9
Forks: 0
Open Issues: 0
Type:contao-module
Requires
- php: ~5.4 || ~7.0
- contao-community-alliance/composer-plugin: ~2.4 || ~3.0
- contao/core-bundle: ^3.5.1 || ~4.1
- heimrichhannot/contao-haste_plus: ^1.6
- heimrichhannot/contao-multi_column_editor: ^1.2
- wa72/htmlpagedom: ^1.3
- dev-master
- 1.4.3
- 1.4.2
- 1.4.1
- 1.4.0
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.23
- 1.2.22
- 1.2.21
- 1.2.20
- 1.2.19
- 1.2.18
- 1.2.17
- 1.2.16
- 1.2.15
- 1.2.14
- 1.2.13
- 1.2.12
- 1.2.11
- 1.2.10
- 1.2.9
- 1.2.8
- 1.2.7
- 1.2.6
- 1.2.5
- 1.2.4
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.19
- 1.0.18
- 1.0.17
- 1.0.16
- 1.0.15
- 1.0.14
- 1.0.13
- 1.0.12
- 1.0.11
- 1.0.10
- 1.0.9
- 1.0.8
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- dev-contao3
This package is auto-updated.
Last update: 2025-02-21 21:30:05 UTC
README
A backend only module, to migrate items from one database into another (experts only).
Features
- image support
- enclosure support
- tidy text replace (format to fit contao tinymce setting)
- foreignKey reference for values
- import from api
Configuration
- Importing is done either through one of the supplied classes inheriting from Importer or through a custom class also inheriting from Importer
- The palettes of an entity import configuration can be modified by the Hook "initEntityImportPalettes"; one is already set and could be easily removed if necessary
Usage
Fieldmapping
Types
| Type | Description |
|---|---|
| source | Copy of the source value |
| foreignKey | foreignKey reference for values (Set for example in value field : id=tl_videobox.youtube_id (id = foreign primary key, tl_videobox = foreign key table, youtube_id = column value that should return) |
| value | Result of entry in value row |
| sql |
Developers
Field explanation "External Source"
| Field | Explanation |
|---|---|
| fieldMapping | Map the fields from the source entity to the ones in the target entity. If your source has multilevel parameters enter the path to that parameter in the source field. The different levels are seperated by "->" (e.g. level_1->level_2->level_3). Otherwise you can modify the source data in the modifySourceItem-Hook. If you enter something in the value field the import will ignore anything you set in the source field. It will set the given value in the target field of the target entity. |
| externalImportExceptions | Configure exceptional rules for the import. E.g. source field value equals x, than set target field to target value. Each rule stands for it's own. They are not concatenated. |
| externalImportExclusions | Configure rules for which a source data will not be imported. |
Hooks
| Name | Arguments | Expected return value | Description |
|---|---|---|---|
| entityImportRunAfterSaving | $objItem, $objSourceItem, $this | $objItem | Triggered after saving entity |
| initEntityImportPalettes | $objEntityImportConfig, $arrDca | - | Modify the palettes of an entity import configuration |
| modifySourceItem | $sourceItem | $sourceItem | Modify the source data. |
| modifyItemBeforeSave | $item, $sourceItem, $this->objModel | - | Modify item attributes before imported item is saved |
Inserttags
| Name | Usage |
|---|---|
| file_uuid | Converts uuid string to binary uuid string. This can be used when you want to set a default value for the singleSRC field of an entity. |
| file_bin | Converts binary uuid to uuid string. |