[wp-trac] [WordPress Trac] #31605: Action Omnibus: assorted useful actions and filters

WordPress Trac noreply at wordpress.org
Thu Mar 12 15:01:21 UTC 2015


#31605: Action Omnibus: assorted useful actions and filters
-----------------------------+------------------------------
 Reporter:  tellyworth       |       Owner:
     Type:  enhancement      |      Status:  new
 Priority:  normal           |   Milestone:  Awaiting Review
Component:  General          |     Version:  trunk
 Severity:  normal           |  Resolution:
 Keywords:  has-patch close  |     Focuses:
-----------------------------+------------------------------
Changes (by DrewAPicture):

 * keywords:  has-patch => has-patch close


Comment:

 Hi @tellyworth, thanks for the patch. Some notes on [attachment:action-
 omnibus-1.diff]:

 * Any new parameters added to hooks need corresponding changelog entries
 in the hook docs, e.g. addition `@since` entries for the current version
 mentioning that the parameter was added
 * `@since` versions should use the 3-digit, x.x.x style
 * Parameter descriptions should end with a period
 * Parameter types, variables, and descriptions should be vertically
 aligned with spaces, each section separated by a single space and wrapped
 at the 80-120 character mark, no tabs inside of the DocBlocks
 * There should be a blank line directly before a hook doc if the line
 above is equally indented
 * Hooks should be only have a corresponding DocBlock in one location, with
 duplicate comments pointing to the file where the original is located
 (even if it's in the same file), e.g. `/** This filter|action is
 documented in path/to/file.php`
 * Hook lines should follow core coding standards for spacing

 All that said, realistically, these actions and filters should be
 submitted via individual tickets since they span several different files
 and components.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/31605#comment:1>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list