mform - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #android #machine-learning #rust #deep-learning #linux #macos #java #kubernetes #awesome-list #vue #mcp #open-source

mform

(★ 84)

Spielend einfach umfangreiche Modul-Input-Formulare erzeugen.

파일 탐색기

최종 버전 다운로드 (.zip)

- - publish-to-redaxo.yml
  - static-analysis.yml
- copilot-instructions.md
- - docs.css
  - flex-repeater.css
  - formbuilder.css
  - imglist.css
  - list-widget.css
  - mform.css
- - customlink.js
  - docs.js
  - flex-repeater.js
  - formbuilder.js
  - imglist.js
  - list-widget.js
  - sortable.min.js
- - toggle.css
  - toggle.js
- mform.js
- 00_whats_new.md
- 01_basics.md
- 02_redaxo.md
- 03_customlink.md
- 04_imagelist.md
- 05_wrapper.md
- 06_advanced.md
- 07_repeater.md
- 08_mblock_migration.md
- 09_templates.md
- 10_outside_modules.md
- 11_tutorial_modul.md
- 12_checkbox_group.md
- 13_api_reference.md
- 14_fragments_output.md
- 15_mform_output.md
- ROADMAP_9.1_ISSUES.md
- - mform_base.php
  - mform_default.php
  - mform_input.php
  - mform_select.php
  - mform_textarea.php
  - mform_wrapper.php
- de_de.lang
- en_gb.lang
- es_es.lang
- fr_fr.lang
- pt_br.lang
- sv_se.lang
- - ResolveLinkApi.php
- - MFormElements.php
- - TemplateInterface.php
  - TemplateRegistry.php
- - var_custom_link.php
  - var_custom_link_multi.php
  - var_custom_linklist.php
  - var_custom_medialist.php
  - var_imglist.php
- MForm.php
- demo.demo_base.php
- demo.demo_community.php
- demo.demo_expert.php
- demo.demo_extended.php
- demo.demo_layout_preview.php
- demo.demo_renderer_parity.php
- demo.demo_repeater.php
- demo.demo_rexform.php
- demo.demo_wrapper.php
- docs.php
- formbuilder.php
- index.php
- info.php
- migration.php
- - value.color_swatch.tpl.php
  - value.custom_link.tpl.php
  - value.custom_link_multi.tpl.php
  - value.imagelist.tpl.php
  - value.linklist.tpl.php
  - value.medialist.tpl.php
- - value.custom_link.tpl.php
  - value.custom_link_multi.tpl.php
  - value.imagelist.tpl.php
  - value.linklist.tpl.php
  - value.medialist.tpl.php
.gitignore
.php-cs-fixer.dist.php
boot.php
CHANGELOG.md
install.php
LICENSE
package.yml
README.de.md
README.md
SECURITY.md
update.php

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MForm – REDAXO Addon

[![Static Analysis](https://github.com/FriendsOfREDAXO/mform/actions/workflows/static-analysis.yml/badge.svg?branch=main)](https://github.com/FriendsOfREDAXO/mform/actions/workflows/static-analysis.yml)
[![PHP](https://img.shields.io/badge/PHP-8.1%20%7C%208.2%20%7C%208.3%20%7C%208.4-777BB4?logo=php&logoColor=white)](https://github.com/FriendsOfREDAXO/mform/actions/workflows/static-analysis.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/FriendsOfREDAXO/mform/main/LICENSE)

![Poster](https://github.com/FriendsOfREDAXO/mform/blob/assets/screen_mform8.png?raw=true?2)

MForm takes the pain out of building REDAXO module inputs. Instead of writing raw HTML form markup, everything gets defined in clean PHP — from a simple text field to fully nested, copy-paste-capable repeaters with conditional logic.

Not just for modules: MForm also extends **YForm** and **rex_form** with custom widgets like the custom link field, image lists, or the ColorSwatch picker.

## What MForm does

- Builds module input forms via a fluent PHP API (`MForm::factory()->addTextField(...)->...->show()`)
- Provides a **Flex Repeater** for dynamically repeatable form rows — supporting nesting, copy/paste, and per-item enable/disable
- Keeps dropdown-based controls usable inside the **Flex Repeater** by allowing open menus to overflow their item wrapper when needed
- Ships reusable form logic via a **Template API** (`registerTemplate`, `fromTemplate`, `applyTemplate`)
- Adds helper classes for Repeater output: `MFormRepeaterHelper::decode()`, `filterByField()`, `sortByField()`, `groupByField()`, `limitItems()`
- Adds YForm value types: `custom_link`, `custom_link_multi`, `color_swatch`
- Resolves readable labels for stored dataset links like `rex-<table>://<id>` in the custom link widget when possible
- Offers a growing library of **installable demo modules** directly from the REDAXO backend

## Quick example

```php
use FriendsOfRedaxo\MForm;

echo MForm::factory()
    ->addTabElement('Content', MForm::factory()
        ->addTextField(1, ['label' => 'Headline'])
        ->addColorSwatchField(2, [
            '#ffffff' => 'White',
            '#111111' => 'Black',
            '.bg-primary' => ['label' => 'Primary', 'preview' => '#0d6efd'],
        ], ['label' => 'Background'])
    )
    ->addTabElement('Items', MForm::factory()
        ->addRepeaterElement(3, MForm::factory()
            ->addTextField('title', ['label' => 'Title'])
            ->addMediaField('image', ['label' => 'Image'])
        , true, true, ['min' => 1, 'max' => 10, 'copy_paste' => true])
    )
    ->show();
```

## Documentation & Tutorial

The full documentation is available directly inside the REDAXO backend under **MForm → Docs**.

For a step-by-step introduction, check out the **[FOR Tutorial](https://friendsofredaxo.github.io/tricks/)** section on MForm.

MBlock users looking to migrate should start with [docs/08_mblock_migration.md](docs/08_mblock_migration.md).

For component-driven frontend output, see [docs/14_fragments_output.md](docs/14_fragments_output.md).

## Installation

Install directly via the REDAXO Installer — search for `mform`, download and activate.

## License

[MIT License](LICENSE.md)

## Credits

**Project Lead**

[Joachim Dörr](https://github.com/joachimdoerr)

[Thomas Skerbis](https://github.com/skerbis)

---

Thanks to all [contributors](https://github.com/FriendsOfREDAXO/mform/graphs/contributors) who helped shape MForm over the years!

**Top contributors**

| | Contributor |
|---|---|
| 1 | [ynamite](https://github.com/ynamite) |
| 2 | [marcohanke](https://github.com/marcohanke) |
| 3 | [eaCe](https://github.com/eaCe) |
| 4 | [schuer](https://github.com/schuer) |
| 5 | [dtpop](https://github.com/dtpop) |
| 6 | [IngoWinter](https://github.com/IngoWinter) |
| 7 | [thorol](https://github.com/thorol) |
| 8 | [DanielWeitenauer](https://github.com/DanielWeitenauer) |

A big thank you also to [interweave-media](https://github.com/interweave-media), [olien](https://github.com/olien), [elricco](https://github.com/elricco), [staabm](https://github.com/staabm), [ascky-thorben](https://github.com/ascky-thorben), [dpf-dd](https://github.com/dpf-dd), [nandes2062](https://github.com/nandes2062), [dgrothaus-mc](https://github.com/dgrothaus-mc), [lexplatt](https://github.com/lexplatt), [danspringer](https://github.com/danspringer), [Geri2017](https://github.com/Geri2017), [omphteliba](https://github.com/omphteliba), [bitshiftersgmbh](https://github.com/bitshiftersgmbh), [TobiasKrais](https://github.com/TobiasKrais), [VIEWSION](https://github.com/VIEWSION), [christophboecker](https://github.com/christophboecker), [cukabeka](https://github.com/cukabeka) and [philippparth](https://github.com/philippparth).

**A [Friends Of REDAXO](https://github.com/FriendsOfREDAXO) project**