PHPackages                             heimrichhannot/contao-entity\_import - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. heimrichhannot/contao-entity\_import

ActiveContao-module[Database & ORM](/categories/database)

heimrichhannot/contao-entity\_import
====================================

A backend only module, to migrate items from one database into another (experts only).

1.4.3(6y ago)0574LGPL-3.0+PHPPHP ~5.4 || ~7.0

Since Sep 1Pushed 6y ago8 watchersCompare

[ Source](https://github.com/heimrichhannot/contao-entity_import)[ Packagist](https://packagist.org/packages/heimrichhannot/contao-entity_import)[ Docs](https://github.com/heimrichhannot/contao-entity_import)[ RSS](/packages/heimrichhannot-contao-entity-import/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (58)Used By (0)

Entity Import
=============

[](#entity-import)

A backend only module, to migrate items from one database into another (experts only).

Features
--------

[](#features)

- image support
- enclosure support
- tidy text replace (format to fit contao tinymce setting)
- foreignKey reference for values
- import from api

Configuration
-------------

[](#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
-----

[](#usage)

### Fieldmapping

[](#fieldmapping)

#### Types

[](#types)

TypeDescriptionsourceCopy of the source valueforeignKeyforeignKey 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)valueResult of entry in value rowsqlDevelopers
----------

[](#developers)

### Field explanation "External Source"

[](#field-explanation-external-source)

FieldExplanationfieldMappingMap 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.externalImportExceptionsConfigure 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.externalImportExclusionsConfigure rules for which a source data will not be imported.### Hooks

[](#hooks)

NameArgumentsExpected return valueDescriptionentityImportRunAfterSaving$objItem, $objSourceItem, $this$objItemTriggered after saving entityinitEntityImportPalettes$objEntityImportConfig, $arrDca-Modify the palettes of an entity import configurationmodifySourceItem$sourceItem$sourceItemModify the source data.modifyItemBeforeSave$item, $sourceItem, $this->objModel-Modify item attributes before imported item is saved### Inserttags

[](#inserttags)

NameUsagefile\_uuidConverts 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\_binConverts binary uuid to uuid string.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 75% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~29 days

Recently: every ~138 days

Total

56

Last Release

2309d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/28ad3224d8727b622ebd229840eea6b9dbcb83eb0bd609e6ce65b614830ff538?d=identicon)[digitales@heimrich-hannot.de](/maintainers/digitales@heimrich-hannot.de)

---

Top Contributors

[![koertho](https://avatars.githubusercontent.com/u/12064642?v=4)](https://github.com/koertho "koertho (3 commits)")[![Defcon0](https://avatars.githubusercontent.com/u/1485098?v=4)](https://github.com/Defcon0 "Defcon0 (1 commits)")

---

Tags

importcontao

### Embed Badge

![Health badge](/badges/heimrichhannot-contao-entity-import/health.svg)

```
[![Health](https://phpackages.com/badges/heimrichhannot-contao-entity-import/health.svg)](https://phpackages.com/packages/heimrichhannot-contao-entity-import)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)