Magento 2 Areas vs Modules
In this article, we will talk about Magento 2 Areas and Modules.
What is an Area in Magento 2?
An area can be understood as a logical component that can help you organizes code in order to optimize the processing of the request. Areas are usually used to streamline web service calls. This can be done by loading only the dependent code for a particular area. Each of the default areas which are defined by Magento can include totally different code for process URLs and requests. For instance, when you invoke a REST web service call, you can identify a separate area that loads the code that its scope is limited to answering REST calls.
6 Magento area types
1. Magento Admin: adminhtml
index.php
or pub/index.php
is the entry point for the adminhtml
area. All the code which are needed for managing the store will be included in this Admin panel area. If you want to view all the code for components which you will see while working in the Admin panel, you can access the /app/design/adminhtml
directory.
2. Storefront: frontend
The entry point for the Storefront
area is index.php
or pub/index.php
. To define your storefront appearance, you can find the template and layout files in this area.
3. Basic: base
You can use Basic as a replacement for files which are absent in adminhtml
and frontend
areas.
4. Cron: crontab
The crontab
area will always be loaded by the \Magento\Framework\App\Cron
class in cron.php
5. Web API REST
To entry the Web API REST (webapi_rest) area, you can find its entry point which is index.php
or pub/index.php
. This area has a front controller which can understand the way to do URL lookups for REST-based URLs.
6. Web API SOAP: webapi_soap
The entry point for the Web API SOAP area is index.php
or pub/index.php
.
In addition, it’s essential to diffirentiate all these types of Magento 2 areas. It’s not only for you to understand correctly each type of areas but also helpful to identify some files from Basic (base) that can be used in admnhtml and frontend. Learning each type of areas to address the differences between them is what you can do next. But remember one thing they have in common is their structure.
How areas and modules working together?
Areas vs modules
The resources that are visible and accessible in an area and the area’s behavior will be defined by Modules. Several areas can be influenced by the same module. For example, parts of the RMA module will be represented in the adminhtml
and the frontend area.
If your module works in different areas, make sure that it needs to have individual behavior and view components for each area.
Each of the areas will declare itself in a module. Besides, all the resources for an area will also be located in the same module.
Moreover, you also have the ability to enable or disable an area within a module. Once a module has been enabled, it would inject the routers of an area into the general routing process of application. On the contrary, of the module is disabled, the area’s routers will not be loaded. Consequently, an area’s resources and specific functionality will not be available.
Facts:
- Other areas of modules should not influence modules.
- When you disable an area, it will not lead to the modules related to that area is disabled.
- Areas will be registered in the file called Dependency Injection framework di.xml.
Example of frontend area
In this guide, we will show you how to create a frontend theme as frontend area.
Theme Folder structure
app/design/frontend/mageplaza/
├── ultimate/
│ ├── etc/
│ │ ├── view.xml
│ ├── web/
│ │ ├── images
│ │ │ ├── logo.svg
│ ├── registration.php
│ ├── theme.xml
│ ├── composer.json
Create a app/design/frontend/mageplaza/theme.xml
file like this:
<theme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../lib/internal/Magento/Framework/Config/etc/theme.xsd">
<title>Mageplaza Ultimate</title>
<parent>Magento/blank</parent>
</theme>
Declare your theme
Now we have folder app/design/frontend/mageplaza/ultimate
, now create a file named theme.xml
that define basic information about theme such as: Name, parent theme (in case your theme inherits from an existing theme), preview image
<theme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Config/etc/theme.xsd">
<title>Mageplaza Ultimate</title> <!-- your theme's name -->
<parent>Magento/blank</parent> <!-- the parent theme, in case your theme inherits from an existing theme -->
<media>
<preview_image>media/preview.jpg</preview_image> <!-- the path to your theme's preview image -->
</media>
</theme>
Create Register file
You can add the following content to registration.php
the theme to Magento 2
File: app/design/frontend/mageplaza/registration.php
<?php
\Magento\Framework\Component\ComponentRegistrar::register(
\Magento\Framework\Component\ComponentRegistrar::THEME,
'frontend/mageplaza/ultimate',
__DIR__
);
You should change Mageplaza Ultimate to your vendor, theme name.
Wrap up
In this article, I have provided you with a comprehensive introduction to areas and modules in Magento 2 as well as how they work with each other.
I hope that the information above is helpful for you. Thanks for reading!
Enjoyed the tutorial? Spread it to your friends!