Download the PHP package webfarben/contao-news-import without Composer
On this page you can find all versions of the php package webfarben/contao-news-import. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download webfarben/contao-news-import
More information about webfarben/contao-news-import
Files in webfarben/contao-news-import
Package contao-news-import
Short Description Contao 5 bundle to import legacy news from an external database
License proprietary
Homepage https://github.com/webfarben/contao_news_import
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package contao-news-import
ContaoImport
Contao-5-Bundle zum Import von Legacy-News aus einer externen Datenbank.
Ziele
- Import der News-Archive aus
tl_news_archive - Import der News-Metadaten aus
tl_news - Import der News-Inhalte aus
tl_content(ptable = tl_news) - Import der Datei-Referenzen (UUIDs) aus
tl_filesdirekt aus der alten Datenbank (empfohlen für konsistente Migration) - Optional: Import der Datei-Referenzen aus Exportdateien (CSV/JSON)
Was wird importiert?
tl_news_archive(Archive/Kategorien)tl_news(News-Metadaten)tl_content(Inhaltselemente der News,ptable = tl_news)tl_files(Datei-Referenzen inkl. UUIDs, direkt aus alter DB oder per Datei)
Installation
- Bundle in ein Contao-5-Projekt einbinden (z. B. als Pfad-Repository oder VCS-Repository).
-
Abhängigkeiten installieren:
- Legacy-DB in der
.env.localdes Contao-Projekts konfigurieren:
Import ausführen
Import im Backend
Nach der Installation erscheint im Contao-Backend unter System das Modul News-Import.
Dort kannst du den Import ohne Konsole ausführen:
- Zugangsdaten der Quelldatenbank (Host, Port, Datenbank, Benutzer, Passwort)
- optionales Speichern der Zugangsdaten in
localconfig.php - Archive-ID-Liste (kommagetrennt, optional)
- Seit/Bis (YYYY-MM-DD oder Timestamp, optional)
- Dry-Run
- News/Inhalte vorab leeren
- optional auch Archive leeren
Nach dem Lauf wird die Tabelle mit Insert/Update/Skip-Werten direkt angezeigt.
Hinweis: Fuer den Import ueber das Backend ist keine LEGACY_DATABASE_URL in .env.local mehr notwendig, sofern die Quelldatenbank im Formular eingetragen wird.
Optionen:
--dry-run: Nur simulieren, keine Daten schreiben.--truncate: Vor dem Importtl_newsund News-bezogenetl_content-Datensätze löschen.--truncate-archives: Nur zusammen mit--truncate; löscht zusätzlichtl_news_archive.--archive-id=ID: Nur bestimmte Archive importieren (mehrfach nutzbar).--since=YYYY-MM-DD|TIMESTAMP: Nur News ab Datum importieren.--until=YYYY-MM-DD|TIMESTAMP: Nur News bis Datum importieren.
Beispiel Dry-Run:
Beispiel nur fuer zwei Archive und Datumsbereich:
Mapping konfigurieren
Das Bundle kann Legacy-Spalten auf Zielspalten mappen. Dazu in der konsumierenden App (nicht im Vendor-Ordner) z. B. in config/services.yaml konfigurieren:
Feste Werte pro Tabelle koennen ebenfalls gesetzt werden:
Idempotenz
Beim ersten echten Lauf erzeugt der Importer die Tabelle tl_contao_import_map.
- Speichert Zuordnung
source_table + source_id -> target_id - Speichert pro Datensatz einen Hash
- Ueberspringt bei unveraenderten Daten den Schreibvorgang
So bleiben wiederholte Importe schnell und stabil.
GitHub Packages
Wenn du das Bundle ueber GitHub bereitstellen willst, siehe docs/GITHUB_PACKAGES.md.
Wichtiger Hinweis zu Bildern
Alle in den News referenzierten Bilddateien (z. B. für singleSRC, multiSRC, enclosure) müssen vor dem Import manuell und mit korrekter Ordnerstruktur in das Zielverzeichnis files/ der Contao-Installation kopiert werden. Die Erweiterung übernimmt keine automatische Dateikopie!
Fehlende Dateien führen dazu, dass die Bildreferenzen in den importierten News leer bleiben.
