matzeeable / wp-hookdoc Goto Github PK

The @param tag is ignored partial. If a parameter is provided it is only visible in the apply_filter('', $...) arguments list but there is no parameters table with param description and type.

When referencing namespaced objects, instead of generating a row for the parameter, the table has an empty row:

I tried a bunch of things but I'm afraid none work:

• {\\GV\\Template_Context}
• {\GV\Template_Context}
• {%5GV%5Template_Context}

Then these work, but they show the quotes, which I don't want:

• {'\GV\Template_Context'}
• {"\GV\Template_Context"}

Here's an example docblock:

/**
 * Modify the reserved embed slugs that trigger a warning.
 *
 * @hook gravityview/rewrite/reserved_slugs
 * @since 2.5
 *
 * @param {array} $reserved_slugs An array of strings, reserved slugs.
 * @param {\GV\Template_Context} $gravityview The context.
 *
 * @returns {array}
 */

I understand that you're simulating @class by replacing @hook with @class and that JS doesn't have that PHP namespace notation, but I'd appreciate guidance!

First: I love what you've done with this repo. It's gotten us very close to a solution. This issue is one of the missing pieces.

The parser misses these functions for some reason: https://developer.wordpress.org/reference/functions/apply_filters_ref_array/

Any thoughts?

I noticed that in the screenshot included in the README, the do_action example generated by