[documentation] [task] Documentation for hook_install
drewish
drupal-docs at drupal.org
Tue Feb 14 22:48:53 UTC 2006
Issue status update for
http://drupal.org/node/48722
Post a follow up:
http://drupal.org/project/comments/add/48722
Project: Documentation
Version: <none>
Component: Developer Guide
Category: tasks
Priority: normal
Assigned to: Anonymous
Reported by: drewish
Updated by: drewish
Status: patch (code needs review)
Attachment: http://drupal.org/files/issues/document_install_hook_0.patch (1.99 KB)
drumm, I added the {} to the MySQL case and a node that all tables need
the curly braces so prefixing works correctly. You're right that we
don't use the HEREDOC format much but it really makes it easier to
paste in the SQL and to read it.
Jaza, you're right that this should be documented, but in the docs for
end users, not developers. I think most people who'll be using the
prefixes will set those up before downloading and enabling contrib
modules. At that point all the tables created will have the proper
prefixes. If a user need to change them later, they can open up the
.install file, look at the module_install() function and see a list of
the tables created.
drewish
Previous comments:
------------------------------------------------------------------------
Thu, 09 Feb 2006 20:32:41 +0000 : drewish
Attachment: http://drupal.org/files/issues/document_install_hook.patch (1.88 KB)
Here's some initial docs for the newly committed hook install [1].
[1] http://drupal.org/node/46422
------------------------------------------------------------------------
Thu, 09 Feb 2006 22:06:59 +0000 : drumm
the mysql is missing the {} and I'm not so sure about the heredoc
strings, we don't really use those anywhere now.
------------------------------------------------------------------------
Tue, 14 Feb 2006 22:28:46 +0000 : Jaza
My only concern is site admins dealing with complex multisite setups,
where multiple database prefixes are involved. This documentation needs
to include a comment to such people, that if they want the tables
created by hook_install() to use a prefix other than the default one,
they must specify this in the relevant settings.php file *before*
enabling the new module.
Perhaps we should also recommend that module developers list all tables
in their module's installation instructions, along with instructions for
custom prefixing.
More information about the documentation
mailing list