Latest technology news, trends and developers guide for business application. Visit this space for more tech updates.

Let’s work on your exciting new project together!

Custom Module in Drupal 8 in just 8 easy steps

Tech Blog, drupal 8, News, Tech Trends

Drupal 8 module works differently compared to Drupal 7 as Drupal guys have made it awesomely simple now, Drupal 8 requires just 8 steps to create cool modules, these are:

1: File Structure

In Drupal 8, custom or contributed modules are kept under modules folder in the root directory.
Given that our choice of machine name (module name) is “sa_module”, start the module by creating a folder within your Drupal installation at the path: sites/all/modules/custom/sa_module.

2: Create .install file

A Drupal schema definition is an array structure representing one or more tables and their related keys and indexes. A schema is defined by hook_schema(), which must live in the modulename.install file. hook_schema() should return an array mapping ‘tablename’ => array(table definition) for each table that the module defines. The following keys in the table definition are processed during table creation:

3: Create .info.yml file

You need to create an info yml file to tell Drupal that your module exists. This is similar to creating a .info file in Drupal 7. This will be which code is mentioned below. Enable that module by following the path http://YOUR_HOST/admin/modules OR Click on Extend from Menu.

4: Create .routing.yml file

In this step we are going to create routing file which help us to navigate into Drupal module by specifying different controller action.

  • sa_module.list: In Drupal8 we should define route as a module_name.route_name ‘module_name => sa_module’ ‘route_name => list’
  • path: We can specify the path of module where user will be redirected once he will go to that module. Ideally this would be the URL to the route which has to have leading forward slash “\”.
  • defaults: In default we can specify multiple things. In our case we have introduced _controller and _form.
  • _controller: The _controller references a method on the AdminController class.
  • _form: A _form define classes which need to be introduced in order to define forms in our module. i.e AddForm, EditForm, DeleteForm
  • requirements: Under requirements, we specify the permission which will check user needs to have to be able to view the page. In our case we have captured “Add, Edit, Delete and access” content permission which is common for other content section.

5: Create .module file

In Drupal 8, hook_menu() is used to define menu items only. If we have hook_menu(), we need to make sure that the route and path in sa_module. Module should match exactly with the route and path which in written in sa_module.routing.yml.

In module creation we are using ‘admin/content/sa_module’ in sa_module.module file. This should be the same path: ’ /admin/list/sa_module’ in sa_module.routing.yml.

6: Create Controller Class

We have to create our AdminController.php according to the PSR-4 naming standard. Create a folder “modules/custom/sa_module/src/Controller”. In this folder, create a file named “AdminController.php”.

7: Create Model Class and Forms

We are going to introduce utility / model class in order to fetch data from Database and communicate it with AdminController which we built for this module.
In our case we have created SaUserInfo.php as a Model class and that helps to define methods like getAll(), add(), update(), delete() etc.

├── SaUserInfo.php
[Code for]
To create add/edit/delete feature, below are the forms with its code,
Form │ ├── AddForm.php
[Code for]
Form │ ├── EditForm.php
[Code for]
Form │ ├── DeleteForm.php
[Code for]

8: Create Menu on Admin

These are the execution steps to display our module as a menu. We can put menu link parallel to Top Menu or any of the descended menu like Admin -> Content as a Tab.
We have to create a file which will define Menu at the Top and set routing from there to load Module listing page.

By performing all above steps carefully we are in position to launch our own module from Drupal8 Admin panel.
Please log into Drupal Admin panel and follow the path. If you are installing the module first time clear your cache first and then follow Extend > List > CUSTOM (Accordion) to enable your module. If you have already installed it, then first uninstall the module, clear your cache and reinstall it by following above path.

Hope you find this Drupal 8 Custom Module helpful. To get latest tech updates don’t forget to subscribe our blog.

Top 3 Factors that makes NativeScript An Ideal Framework for Mobile App development

NativeScript is a cross-platform app development framework for rapid app development with its write once...

How Internet of Things Concept Transforms Mobile App Development

IoT is indeed the Next Big Thing. It is also one of the most fascinating...

What to Keep in Mind while Planning Mobile App Strategy

The recent report on the number of smartphone users has predicted that by 2021, over...

We are always happy to hear from you - Share your business requirements. Our business experts will reach you shortly


Select Your Requirement

Secure : We'll ensure, all the information provided by you will not be shared with anyone and your details are completely safe.

We respect your privacy. *Privacy Policy

Select Your Requirement

Secure : We'll ensure, all the information provided by you will not be shared with anyone and your details are completely safe.

We respect your privacy. *Privacy Policy