Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 461c80d75d |
71
README.md
71
README.md
@@ -1,43 +1,52 @@
|
|||||||
# Contao Dummy Copier (Scaffold)
|
# Contao Dummy Copier
|
||||||
|
|
||||||
Dieses Bundle stellt ein Backend-Modul `Dummy Copier` bereit, um bestehende Dummyseiten, Inhalte, Module und Verzeichnisse zu kopieren und Referenzen automatisiert umzubiegen.
|
Dieses Bundle stellt ein Backend-Modul `Dummy Copier` bereit, um bestehende Dummydaten in Contao kontrolliert zu vervielfaeltigen und interne Referenzen auf die neuen Zielobjekte umzubiegen.
|
||||||
|
|
||||||
## Enthaltene Funktionen
|
## Funktionsumfang
|
||||||
|
|
||||||
- Rekursives Kopieren von Seitenbaeumen (`tl_page`)
|
- rekursives Kopieren von Seitenbaeumen aus `tl_page`
|
||||||
- Optionales Kopieren von Artikeln und Content (`tl_article`, `tl_content`)
|
- optionales Kopieren von Artikeln und verschachtelten Inhaltselementen aus `tl_article` und `tl_content`
|
||||||
- Optionales Kopieren von Modulen (`tl_module`)
|
- optionales Kopieren von Modulen aus `tl_module`
|
||||||
- Automatisches Umstellen von:
|
- optionales Kopieren von Newsarchiven samt Newsbeitraegen aus `tl_news_archive` und `tl_news`
|
||||||
- Content-Elementen vom Typ `module` auf kopierte Modul-IDs
|
- optionales Kopieren von Kalendern samt Events aus `tl_calendar` und `tl_calendar_events`
|
||||||
- `jumpTo` in kopierten Seiten/Modulen/Content auf kopierte Seiten, falls vorhanden
|
- optionales Spiegeln von Verzeichnissen im Dateisystem
|
||||||
- Optionales Kopieren von Verzeichnissen (Dateisystem-Mirror)
|
- Dry-Run zur Vorschau ohne Schreibzugriffe
|
||||||
- Dry-Run Modus ohne Schreibzugriff
|
|
||||||
|
## Automatische Referenzanpassungen
|
||||||
|
|
||||||
|
- `jumpTo` in kopierten Seiten, Modulen, Content-Elementen, Newsarchiven, News, Kalendern und Events
|
||||||
|
- Modulreferenzen in Content-Elementen vom Typ `module`
|
||||||
|
- Alias-Referenzen in verschachtelten Content-Elementen (`cteAlias`)
|
||||||
|
- Archiv-Zuordnungen in kopierten Modulen (`news_archives`, `cal_calendar`)
|
||||||
|
- Reader-Module in kopierten Modulen (`news_readerModule`, `cal_readerModule`)
|
||||||
|
- verwandte News (`related`), sofern die referenzierten News ebenfalls mitkopiert wurden
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
1. Bundle in dein Contao-Projekt legen (oder als VCS-Paket einbinden).
|
Installation ueber Packagist:
|
||||||
2. `composer install` oder `composer update acme/contao-dummy-copier`
|
|
||||||
3. Cache leeren.
|
|
||||||
4. Backend-Modul `Dummy Copier` unter `System` oeffnen.
|
|
||||||
|
|
||||||
## Bedienung (aktueller Stand)
|
```bash
|
||||||
|
composer require webfarben/contao-dummy-copier
|
||||||
|
```
|
||||||
|
|
||||||
- Quellobjekte werden ueber Mehrfachauswahlfelder ausgewaehlt (Seiten, Module, Content, Verzeichnisse).
|
Danach wie ueblich:
|
||||||
- Seiten und Verzeichnisse werden in Baumdarstellung (Einrueckung nach Hierarchie) angezeigt.
|
|
||||||
- Alle Mehrfachauswahlfelder haben Live-Filter sowie `Alle`/`Keine` Buttons.
|
|
||||||
- Ziel-Elternseite wird per Auswahlfeld gesetzt.
|
|
||||||
|
|
||||||
Bei kompatibler Contao-Umgebung nutzt das Modul native `pageTree`/`fileTree` Widgets fuer Seiten und Verzeichnisse.
|
```bash
|
||||||
Falls die Widget-Initialisierung versionsbedingt fehlschlaegt, wird automatisch auf die Select-Fallbacks gewechselt.
|
php vendor/bin/contao-setup
|
||||||
- Setze optional Zielverzeichnis, Zielartikel-ID und Praefix.
|
php vendor/bin/console contao:migrate
|
||||||
- Aktiviere Optionen nach Bedarf (`inkl. Content`, `Module kopieren`, `Verzeichnisse kopieren`, `Dry-Run`).
|
```
|
||||||
|
|
||||||
Hinweis: Das Modul akzeptiert weiterhin CSV-Werte als Fallback, falls du Felder per POST automatisiert befuellst.
|
Das Backend-Modul `Dummy Copier` erscheint anschliessend unter `System`.
|
||||||
|
|
||||||
## Wichtige Hinweise
|
## Bedienung
|
||||||
|
|
||||||
- Nach Verzeichnis-Kopien ggf. `contao:filesync` ausfuehren, damit DBAFS konsistent ist.
|
- Quellobjekte werden ueber Mehrfachauswahlfelder ausgewaehlt.
|
||||||
- Dieses Grundgeruest ist bewusst pragmatisch und kann erweitert werden um:
|
- Seiten, Module, Newsarchive, Kalender und Verzeichnisse koennen separat kombiniert werden.
|
||||||
- PageTree/FileTree Picker statt CSV
|
- Alle Mehrfachauswahlfelder besitzen Live-Filter sowie `Alle`/`Keine` Buttons.
|
||||||
- Feldspezifisches Mapping fuer News/Event/Archive-Felder in `tl_module`
|
- Inhaltselemente von Seiten werden bei aktiver Option automatisch mitkopiert.
|
||||||
- Job-Queue via Messenger bei sehr grossen Kopierlaeufen
|
- Ueber ein Praefix lassen sich Titel, Namen und Aliase der Kopien kenntlich machen.
|
||||||
|
|
||||||
|
## Hinweise
|
||||||
|
|
||||||
|
- Nach Dateikopien ggf. `php vendor/bin/console contao:filesync` ausfuehren, damit die DBAFS-Daten synchronisiert werden.
|
||||||
|
- Das Bundle ist fuer pragmatische Redaktions- und Setup-Workflows gedacht. Projektspezifische Sonderfelder oder Referenzen koennen bei Bedarf erweitert werden.
|
||||||
|
|||||||
6
public/icon.svg
Normal file
6
public/icon.svg
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
|
||||||
|
<rect x="4" y="5" width="11" height="9" rx="2" stroke="#1f2937" stroke-width="2"/>
|
||||||
|
<rect x="17" y="5" width="11" height="9" rx="2" stroke="#1f2937" stroke-width="2" opacity="0.55"/>
|
||||||
|
<rect x="4" y="18" width="11" height="9" rx="2" stroke="#1f2937" stroke-width="2" opacity="0.55"/>
|
||||||
|
<path d="M19 19h9m-4-4 4 4-4 4" stroke="#0f766e" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 485 B |
Reference in New Issue
Block a user