[task] Multi-file Modules Should Go in Subdirectories

Project:      User experience
Version:      <none>
Component:    other
Category:     tasks
Priority:     normal
Assigned to:  Anonymous
Reported by:  jhriggs
Updated by:   adrian
Status:       active

I myself always keep my modules under modules/ in their original cvs
directories (so that i can update them directly into the directory ..
and copy over whatever i need.


I move towards placing all the modules in a subdir , including the base
module (which should go under modules/system. I would like to have a
case where the .install file is found in the same directory as the
.module that requires is .. as to keep them together and not perhaps
try to install older modules with newer installs and the like.




adrian



Previous comments:
------------------------------------------------------------------------

February 23, 2004 - 22:05 : jhriggs

Modules that use multiple files (.module, images, .inc files, etc.)
should be installed by placing all necessary files in a subdirectory
for the module, i.e. modules/mod_name/.  Currently Project.module and
Textile.module do this, as do others, I am sure.  Several, though, use
misc/ for images and the like.  It seems to me that a module should be
self-contained (as much as possible), not affecting other parts of the
Drupal install.  For example, the sample images that come with
Smileys.module should go not in misc/smileys, but rather in
modules/smileys/images or something similar.

Thoughts/questions/concerns (just brainstorming...please jump in):

* This will make installation much easier, but the fact that modules
can be installed in a subdirectory should be better documented.  I have
had several users get confused with Textile.module.

* Should all modules be installed in a subdirectory (even if it is just
the single .module file) for consistency's sake and to avoid
confusion?

* When Adrian's installation API goes in, keeping all resources in one
location will likely be a must.

* If my proposed multisite changes that include site-specific themes
and modules (http://drupal.org/node/view/5942) go in, modules will need
a function to determine where they are installed so that they can
create correct paths to their resources, images, etc.

--
View: http://drupal.org/node/view/6019
Edit: http://drupal.org/project/comments/add/6019