[documentation] [task] Documentation for hook_install
drewish
drupal-docs at drupal.org
Wed Feb 15 20:42:06 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)
+Status: fixed
This has been committed. The file was renamed as drumm suggested.
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.
------------------------------------------------------------------------
Tue, 14 Feb 2006 22:48:52 +0000 : drewish
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.
------------------------------------------------------------------------
Wed, 15 Feb 2006 03:45:48 +0000 : drumm
Looks good.
Whenever this happens go ahead and cvs rm update.php, mv update.php
install.php, cvs add install.php.
More information about the documentation
mailing list