Drupal 7 Module Development

Chapter 2
Creating the module directory
Now that we know that our modules should go in /sites/default/modules, we
can create a new module there.
Modules can be organized in a variety of ways, but the best practice is to create a
module directory in /sites/default/modules, and then place at least two files
inside the directory: a .info (pronounced "dot-info") file and a .module ("dotmodule")
file.
The directory should be named with the machine-readable name of the module.
Similarly, both the .info and .module files should use the machine-readable name.
We are going to name our first module with the machine-readable name first,
since it is our first module. Thus, we will create a new directory, /sites/default/
modules/first, and then create a first.info file and a first.module file:
Those are the only files we will need for our module.
For permissions, make sure that your webserver can read both the .info and
.module files. It should not be able to write to either file, though.
In some sense, the only file absolutely necessary for a module is the
.info file located at a proper place in the system. However, since
the .info file simply provides information about the module, no
interesting module can be built with just this file.
Next, we will write the contents of the .info file.
Writing the .info file
The purpose of the .info file is to provide Drupal with information about a
module—information such as the human-readable name, what other modules
this module requires, and what code files this module provides.
A .info file is a plain text file in a format similar to the standard INI configuration
file. A directive in the .info file is composed of a name, and equal sign, and a value:
name = value
[ 29 ]