Download the PHP package umc/module-crud without Composer
On this page you can find all versions of the php package umc/module-crud. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download umc/module-crud
More information about umc/module-crud
Files in umc/module-crud
Package module-crud
Short Description Magento 2 module for reducing the CRUD boilerplate
License MIT
Informations about the package module-crud
Umc_Crud Magento 2 module
Purpose:
This module is intended for Magento 2 developers, in order to reduce the boilerplate code when creating a CRUD extension.
Compatibility
- 2.4.6
- 2.4.5
- 2.4.4
- 2.4.3
- 2.4.2
- 2.4.1
- 2.4.0
- 2.3.5
- 2.3.4
- probably works for versions before 2.3.4, but it's not guaranteed.
What it does:
It provides a set of classes and interfaces that can be configured, composed or prerenced in order to avoid writing the same code over and over again.
Example:
(Almost) every Save
controller for an entity does the following:
- retrieves the data from POST.
- may or may not transform the data received via POST
- creates a new entity or retrieves a requested entity from the database
- assigns the data to the entity from the point above
- persists the entity
- redirects "somewhere" with a success or an error message.
And the only variables here are
- the entity being added / modified
- the way the data is processed before attaching it to the entity
This module provides a general admin Save
controller that has as dependencies a set of other classes / interfaces that have only one of the responsibilities above
- an Entity manager responsible for retrieving the data from db or instantiating a new entity
- a data processor (interface) that processes the data
- an entity config class will contain the details about the entity being processed.
- side objects: a data persistor (which is basically the session) to save the data submitted in case there is an error and you need to redirect back to the form with the previously submitted data prefilled.
All of these can be configured via di.xml
for each entity you want to manage.
This module also adds a few more code generators (similar to the core ones for factory or proxy for example) that will autogenerate repository classes and a few others.
Target audience
- this module is intended for experienced Magento 2 developers that are tired of writing the same thing over and over again.
- this is not intended for junior developers.
- In order to use this you have to have good knowledge of ...
- how a magento CRUD module works
- what is a virtual type
- how DI works in Magento
Advantages in using this module
- less code to write, which means less code to test and less code that can malfunction
- your copy/paste analyzer will stop complaining you have classes that look the same.
- decrease development time. (hopefully)
- you will have a standard way of writing all your CRUD modules (no matter if it's good or bad, at least it is consistent)
- This covers most of the cases you will encounter in your development process. If one of your cases is not covered by this module you can choose not to extend or compose the classes in this module and use your own.
Disadvantages of using this module
- there is a lot more configuration you need to write (YEAH....xmls).
- makes debugging a little harder.
- adds a new abstractization layer ... or 7. Just kidding. it's 1.
-
you add a new dependency to your project and all your CRUD module will depend on this module.
Installation:
- Via composer (recommended)
composer require "umc/module-crud=*"
- Manual install
- download a copy from
https://github.com/UltimateModuleCreator/umc-crud
and all the files inapp/code/Umc/Crud
.
After installation
- run
php bin/magento setup:upgrade [--keep-generated]
- check if this file exists
app/etc/crud/di.xml
. If it does not exist, run the commandbin/magento umc:crud:deploy
. If you get an error you can copy it fromvendor/umc/module-crud/etc/crud/di.xml
toapp/etc/crud/di.xml
.
Documentation
For more details about how this extension should work, visit https://github.com/UltimateModuleCreator/umc-crud/wiki
Donations
If you really like this and get the hang of it and it saves you a lot of development time, consider a small (or large - I won't mind) donation via PayPal
All versions of module-crud with dependencies
magento/module-backend Version *
magento/module-config Version *
magento/module-ui Version *
magento/framework Version *