|
| 1 | +Modules extend your site functionality beyond Drupal core. |
| 2 | + |
| 3 | +WHAT TO PLACE IN THIS DIRECTORY? |
| 4 | +-------------------------------- |
| 5 | + |
| 6 | +Placing downloaded and custom modules in this directory separates downloaded and |
| 7 | +custom modules from Drupal core's modules. This allows Drupal core to be updated |
| 8 | +without overwriting these files. |
| 9 | + |
| 10 | +DOWNLOAD ADDITIONAL MODULES |
| 11 | +--------------------------- |
| 12 | + |
| 13 | +Contributed modules from the Drupal community may be downloaded at |
| 14 | +https://www.drupal.org/project/project_module. |
| 15 | + |
| 16 | +ORGANIZING MODULES IN THIS DIRECTORY |
| 17 | +------------------------------------ |
| 18 | + |
| 19 | +You may create subdirectories in this directory, to organize your added modules, |
| 20 | +without breaking the site. Some common subdirectories include "contrib" for |
| 21 | +contributed modules, and "custom" for custom modules. Note that if you move a |
| 22 | +module to a subdirectory after it has been enabled, you may need to clear the |
| 23 | +Drupal cache so it can be found. |
| 24 | + |
| 25 | +There are number of directories that are ignored when looking for modules. These |
| 26 | +are 'src', 'lib', 'vendor', 'assets', 'css', 'files', 'images', 'js', 'misc', |
| 27 | +'templates', 'includes', 'fixtures' and 'Drupal'. |
| 28 | + |
| 29 | +MULTISITE CONFIGURATION |
| 30 | +----------------------- |
| 31 | + |
| 32 | +In multisite configurations, modules found in this directory are available to |
| 33 | +all sites. You may also put modules in the sites/all/modules directory, and the |
| 34 | +versions in sites/all/modules will take precedence over versions of the same |
| 35 | +module that are here. Alternatively, the sites/your_site_name/modules directory |
| 36 | +pattern may be used to restrict modules to a specific site instance. |
| 37 | + |
| 38 | +MORE INFORMATION |
| 39 | +---------------- |
| 40 | + |
| 41 | +Refer to the “Developing for Drupal” section of the README.txt in the Drupal |
| 42 | +root directory for further information on extending Drupal with custom modules. |
0 commit comments