[drupal-devel] needed documentation for block module for 4.6
drumm at delocalizedham.com
Thu Jan 27 02:26:59 UTC 2005
On Tue, Jan 25, 2005 at 08:40:49AM +0100, Dries Buytaert wrote:
> Steven Wittens wrote:
> >>I ran into this exact thing in the last 48 hours or so working on a
> >>patch for the block module and looking at block hooks in general.
> >>A quick search shows that only block, forum and statistics core
> >>modules use 'configure' - so perhaps the rarity of its use kept it
> >>from being documented.
> >>But knowing that you can add configuration options to a block would
> >>certainly be helpful for module contributors.
> >IMO the update docs should instruct module authors to move block
> >settings into the "configure" page. It's best for consistency and
> >usability. Anyone have time to write the docs? ;)
> Neil once posted an explanation of the modified _block() hook. I
> believe it was part of his patch. Neil?
The documentation in hook_block() on drupaldocs.org should be fully
updated. Implementing the 'configure' op isn't strictly part of updating
a module. However, I do think it should be documented now. Bug me in IRC
/next/ week and I will do it myself if you catch me at a good time. I'm
a bit short on time for this week.
More information about the drupal-devel