Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Restrukturierung der Docs #319

Merged
merged 1 commit into from
Apr 15, 2024
Merged

Restrukturierung der Docs #319

merged 1 commit into from
Apr 15, 2024

Conversation

alxndr-w
Copy link
Member

@alxndr-w alxndr-w commented Apr 6, 2024

  • Neustrukturierung der Reihenfolge
  • Umbau in formatierte Markdown-Dokumente (und damit einfachere Pflege / Handhabung möglich)
  • Anhaben der Docs in die erste Menüebene
  • Verschieben von bestimmten Code-Beispielen und Anleitungen aus README.md in die Docs
  • Verteilen von Experten-Beispielen an passende Stelle
  • Entfernen der ehemaligen Seiten pages/mform_demo*

image

Diese Struktur bietet die Grundlage für weitere Beiträge meinerseits, bspw. Screenshots der Elemente oder fertige Kombinationen von MForm-Modulen, bspw. einen Text-mit-Bild-Modul, etc.

Was mir an MForm gefällt ist dieses Kopieren-Anpassen-Fertig-Prinzip, das würde ich gerne weiter verbessern.

Umbau der Docs.

* Neustrukturierung der Reihenfolge
* Umbau in formatierte Markdown-Dokumente (und damit einfachere Pflege / Handhabung möglich)
* Anhaben der Docs in die erste Menüebene
* Verschieben von bestimmten Code-Beispielen und Anleitungen aus README.md in die Docs
* Verteilen von Experten-Beispielen an passende Stelle
* Entfernen der ehemaligen Seiten pages/mform_demo*
@alxndr-w alxndr-w requested a review from skerbis April 6, 2024 11:02
@alxndr-w alxndr-w self-assigned this Apr 6, 2024
@alxndr-w alxndr-w changed the base branch from master to develop April 6, 2024 11:02
@skerbis skerbis requested review from joachimdoerr and removed request for skerbis April 9, 2024 08:23
@skerbis
Copy link
Member

skerbis commented Apr 9, 2024

Gefällt mir. @joachimdoerr was denkst du?

@skerbis skerbis added this to the 8.0.0 milestone Apr 12, 2024
@alxndr-w
Copy link
Member Author

@joachimdoerr - wenn das angenommen würde, würde ich mir noch Gedanken um einen Bereich "Migration" machen, wie man MForm 7.x zu 8.x möglichst schnell geändert bekommt.

@joachimdoerr
Copy link
Member

Für mich ist das OK, macht einfach. Ich habe leider aktuell keine Zeit um mich zu kümmern.

@alxndr-w alxndr-w merged commit 6f50dff into develop Apr 15, 2024
@alxndr-w alxndr-w deleted the develop-docs branch April 15, 2024 10:29
@alxndr-w
Copy link
Member Author

@skerbis ich bräuchte dann als nächstes grundlegende Beispiele für den Repeater und auch, was sich von 7 auf 8 noch ändert.

Mir schwebt vor, fertige Beispiele für "Suchen und Ersetzen" zu liefern, mit denen man auf einen Schlag alle Module aktualisieren könnte - wo es möglich ist.

@skerbis
Copy link
Member

skerbis commented Apr 16, 2024

Ich habe aktuell nur ein einziges Beispiel

Bin selbst nicht ganz auf dem Laufenden. (sollte ich aber langsam mal wieder)

<?php

$mform = MForm::factory()
    ->addTextField(1, ['label' => 'test rex value 1'])
    ->addRepeaterElement(2,
        MForm::factory()->addFieldsetArea('fieldset1',
            MForm::factory()
                ->addTextField('test1', ['label' => 'test1'])
                ->addMediaField('media1', ['label' => 'media1'])
                ->addCustomLinkField('link1', ['label' => 'link1'])
                ->addTextAreaField('text1', ['class' => 'cke5-editor', 'data-profile' => 'light'])

//                ->addImagelistField('imagelist1', ['label' => 'Image List1'])
                ->addFieldsetArea('Select elements', MForm::factory()
                    // some select fields
                    ->addSelectField("selectfield11", [1 => 'test-1', 2 => 'test-2', 3 => 'test-3', 4 => 'test-4'], ['label' => 'Select optgroup11'])
                    ->addSelectField("selectfield12", ['group 1' => [1 => 'test-1', 2 => 'test-2'], 'group 2' => [3 => 'test-3', 4 => 'test-4']], ['label' => 'Select optgroup12'])
                )
                // add second fieldset area
                ->addFieldsetArea('Multiselect elements', MForm::factory()
                    // some multiple selects fields
                    ->addMultiSelectField("selectfield13", [1 => 'test-1', 2 => 'test-2', 3 => 'test-3', 4 => 'test-4'], ['label' => 'Select optgroup13'])
                    ->addMultiSelectField("selectfield14", ['group 1' => [1 => 'test-1', 2 => 'test-2'], 'group 2' => [3 => 'test-3', 4 => 'test-4']], ['label' => 'Select optgroup14'])
                )

                // add fieldset area
                ->addFieldsetArea('Checkbox element', MForm::factory()
                    // some checkbox elements
                    ->addCheckboxField('checkbox1', [1 => 'test-1'], ['label' => 'Checkbox1'])
                    ->addToggleCheckboxField('togglecheckbox1', [1 => 'Toggle test-1'], ['label' => 'Toggle Checkbox1'])
                )
                // add second fieldset area
                ->addFieldsetArea('Radio buttons element', MForm::factory()
                    // radio element
                    ->addRadioField('radio1', [1 => 'test-1', 2 => 'test-2'], ['label' => 'Radio1'])
                )

                ->addRepeaterElement('fields1',
                    MForm::factory()->addFieldsetArea('fieldset',
                        MForm::factory()

//                            ->addImagelistField('imagelist2', ['label' => 'Image List2'])
                            ->addFieldsetArea('Select elements', MForm::factory()
                                // some select fields
                                ->addSelectField("selectfield21", [1 => 'test-1', 2 => 'test-2', 3 => 'test-3', 4 => 'test-4'], ['label' => 'Select optgroup21'])
                                ->addSelectField("selectfield22", ['group 1' => [1 => 'test-1', 2 => 'test-2'], 'group 2' => [3 => 'test-3', 4 => 'test-4']], ['label' => 'Select optgroup22'])
                            )
                            // add second fieldset area
                            ->addFieldsetArea('Multiselect elements', MForm::factory()
                                // some multiple selects fields
                                ->addMultiSelectField("selectfield23", [1 => 'test-1', 2 => 'test-2', 3 => 'test-3', 4 => 'test-4'], ['label' => 'Select optgroup23'])
                                ->addMultiSelectField("selectfield24", ['group 1' => [1 => 'test-1', 2 => 'test-2'], 'group 2' => [3 => 'test-3', 4 => 'test-4']], ['label' => 'Select optgroup24'])
                            )

                            ->addFieldsetArea('Checkbox element', MForm::factory()
                                // some checkbox elements
                                ->addCheckboxField('checkbox2', [1 => 'test-1'], ['label' => 'Checkbox2'])
                                ->addToggleCheckboxField('togglecheckbox2', [1 => 'Toggle test-1'], ['label' => 'Toggle Checkbox2'])
                            )
                            // add second fieldset area
                            ->addFieldsetArea('Radio buttons element', MForm::factory()
                                // radio element
                                ->addRadioField('radio2', [1 => 'test-1', 2 => 'test-2'], ['label' => 'Radio2'])
                            )

                            ->addTextField('test2', ['label' => 'test2'])
                            ->addMediaField('media2', ['label' => 'media2'])
                            ->addCustomLinkField('link2', ['label' => 'link2'])
                            ->addLinkField('link3', ['label' => 'link3'])
                            ->addTextAreaField('text2', ['class' => 'cke5-editor', 'data-profile' => 'light'])
                            ->addTabElement('test1',MForm::factory()
                                ->addTextField('test3', ['label' => 'fields1 test1'])
                                ->addCustomLinkField('link4', ['label' => 'link2'])
                            ,true)
                            ->addTabElement('test2',MForm::factory()->addTextField('test4', ['label' => 'fields1 test2']))
                )
            )
            ->addRepeaterElement('fields2',
                MForm::factory()
                    ->addTextField('test0', ['label' => 'fields2 test0'])
                , ['hidden_button' => false, 'button_text' => 'add Fields 2']
            )
        )
    );


echo MForm::factory()
    ->addTabElement('tab test1',$mform,true)
    ->addTabElement('tab test2',MForm::factory()->addTextField('test1', ['label' => 'fields1 test2']))
    ->show();


//echo MForm::factory()
//    ->addTabElement('test1',MForm::factory()->addTextField('test1', ['label' => 'fields1 test1']),true)
//    ->addTabElement('test2',MForm::factory()->addTextField('test1', ['label' => 'fields1 test2']))
//    ->show();

@alxndr-w alxndr-w restored the develop-docs branch April 29, 2024 09:41
@alxndr-w alxndr-w deleted the develop-docs branch April 29, 2024 15:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants