# Mformdescription Mform Addon Development Skill Use When Working

> Du arbeitest im REDAXO-Addon MForm. Use when this capability is needed.

- Skill: `tomevault-io/mformdescription-mform-addon-development-skill-use-when-work` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/mformdescription-mform-addon-development-skill-use-when-work`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/mformdescription-mform-addon-development-skill-use-when-work/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/mformdescription-mform-addon-development-skill-use-when-work

---


# MForm Development Skill

Du arbeitest im REDAXO-Addon MForm.

MForm ist ein API-getriebenes Formular-Addon mit vielen produktiv genutzten Einstiegspunkten. Arbeite kompatibel, lokal und dokumentationsbewusst.

## Kernziele

- Öffentliche MForm-APIs stabil halten
- Bestehende Modul-Inputs und gespeicherte Werte nicht brechen
- Repeater-, Widget- und Editor-Kompatibilität sichern
- YForm- und rex_form-Integrationen mitdenken
- Änderungen immer mit Qualitätscheck und Doku-Pflege abschließen

## Wo du was findest

### Einstieg und Struktur

- `package.yml` – Version, Anforderungen, Backend-Seiten
- `boot.php` – Asset-Registrierung und YForm-Integration
- `install.php` / `update.php` – Install-/Update-Verhalten

### Öffentliche Doku

- `README.md` – öffentliche englische Doku
- `README.de.md` – öffentliche deutsche Doku
- `CHANGELOG.md` – Release-Historie
- `docs/00_whats_new.md` – Übersicht neuer Features
- `docs/05_wrapper.md` – Wrapper wie Modal, Collapse, Tabs
- `docs/07_repeater.md` – Flex-Repeater, Ausgabe, Vergleich, Optionen
- `docs/08_mblock_migration.md` – Migration und Kompatibilität mit MBlock
- `docs/10_outside_modules.md` – Nutzung z. B. mit rex_form/YForm

### PHP-Kerncode

- `lib/MForm.php` – Hauptklasse und API-Einstieg
- `lib/MForm/Elements*` bzw. Klassen unter `lib/MForm/` – Felddefinitionen und Bausteine
- `lib/MForm/Parser/` – Parser- und Renderlogik
- `lib/MForm/FlexRepeater/` – Flex-Repeater-Renderer und Builder
- `lib/Widget/` – Widget-nahe Logik
- `lib/yform/` – YForm-Value-Types und Integration
- `fragments/` – HTML-Struktur der Ausgabe
- `ytemplates/` – YForm-Templates für bootstrap/classic

### Assets

- `assets/mform.js` – allgemeines MForm-JS
- `assets/js/flex-repeater.js` – Kernlogik des Flex-Repeaters
- `assets/js/customlink.js` – Custom-Link-Widget
- `assets/js/list-widget.js`, `imglist.js` – Widget-Logik
- `assets/css/` – Styles für Widgets und Repeater

## Kritische Bereiche

### Öffentliche API

Änderungen an diesen APIs nur sehr vorsichtig:

- `addRepeaterElement()`
- `addModalElement()`
- `addCustomLinkField()`
- `addCustomLinkMultipleField()`
- `addConditionalFieldsetArea()`
- `addColorSwatchField()`
- `MFormRepeaterHelper::*`
- `MFormOutputHelper::*`

### Kompatibilität

Besonders sensibel sind:

- Repeater-Speicherformat und Hidden-Value-Synchronisierung
- `__disabled`-Handling für Online/Offline im Repeater
- Nested Repeater
- Modal-IDs innerhalb von Repeatern
- TinyMCE-, MarkdownEditor- und klassische Widget-Kompatibilität
- MBlock-Migration und `useCustomLinkForClassicWidgets(true)`
- YForm-Value-Types und Listenansicht im Manager
- Nutzung außerhalb klassischer Module, z. B. rex_form oder YForm

## Arbeitsweise

1. Finde den kleinsten Codepfad, der das Verhalten kontrolliert.
2. Ändere nur diesen Bereich.
3. Prüfe sofort danach den engsten sinnvollen Check.
4. Aktualisiere anschließend Doku, README und Changelog, wenn Nutzerverhalten betroffen ist.

## Qualitätschecks

### PHP / REDAXO

Nach relevanten Änderungen immer statische Analyse ausführen:

(Pfede können je nach Setup variieren)

```bash
docker exec -it coreweb bash -c "cd /var/www/html/public && php redaxo/bin/console rexstan:analyze redaxo/src/addons/mform/"
```

### Manuelle/verhaltensnahe Checks

Wenn betroffen, mindestens gedanklich oder praktisch prüfen:

- Repeater add/remove/sort/copy/paste
- Nested Repeater
- Modal im Repeater
- Widget-Popup und Wertübernahme
- YForm-/rex_form-Integration
- Ausgabehilfen wie `decode()`, `filterByField()`, `sortByField()`

## Doku-Pflege

Bei geänderten Features, APIs, Kompatibilitätsregeln oder Nutzungshinweisen immer diese Dateien prüfen und aktualisieren:

- `CHANGELOG.md`
- `README.md`
- `README.de.md`
- passende Dateien unter `docs/`

### Zuordnung

- Neue Nutzerfeatures: `docs/00_whats_new.md`
- Wrapper/Modal/Collapse: `docs/05_wrapper.md`
- Repeater: `docs/07_repeater.md`
- MBlock-Kompatibilität/Migration: `docs/08_mblock_migration.md`
- Nutzung außerhalb von Modulen: `docs/10_outside_modules.md`

## README-Regel

Halte die deutsche und englische README inhaltlich synchron, soweit es um Features, Credits, Einordnung und Nutzung geht.

## Entscheidungsregel bei Unsicherheit

Wenn eine Änderung zwischen Modernisierung und Kompatibilität abwägen muss, entscheide standardmäßig für Kompatibilität.

---
> Source: [FriendsOfREDAXO/mform](https://github.com/FriendsOfREDAXO/mform) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-22 -->