Skip to content

Latest commit

 

History

History
162 lines (119 loc) · 5.61 KB

README.md

File metadata and controls

162 lines (119 loc) · 5.61 KB
Raw

WP Doc Generator

WordPress Doc Generator is a tool to automatically extract data about the actions, filters and shortcodes of your WordPress theme or plugin.

Table of contents

Getting Started

Installation

Install it with composer

composer require dudo1985/wpdocgen --dev

Command Line Usage

First parameter is the input directory, second is the output file, e.g.

vendor/bin/wp-doc-gen . hooks.md

This will parse all the files in the current directory (.) and write a file called hooks.md

Optional params

--shortcodes or -s

By default, WPDocGen search for hooks apply_filters and do_actions. However, if you use the --shortcodes or -s will search for add_shortcode function instead.

vendor/bin/wp-doc-gen . shortcodes.md -s

--exclude or -e

Exclude the specified folders, e.g.

vendor/bin/wp-doc-gen . hooks.md --exclude vendor node_modules

Another example, if you're launching the script from another dir:

vendor bin/wp-doc-gen.php ../my-plugin/ docs/hooks.md --exclude vendor node_modules --prefix yasr

There is no need to include the full paths of the excluded dirs, it is automatically ../my-plugin/vendor and ../my-plugin/node_modules

--prefix or -p

Only parse hooks or shortcodes starting with the specified prefixes.

vendor/bin/wp-doc-gen . hooks.md --exclude vendor node_modules --prefix prefix_1 prefix_2

Real life Examples

Generated markdown files

Composer script

Notes

To make the parser work fine, the comment must be a valid phpDocBlock, e.g.

/**
* Use this action to add tabs inside shortcode creator for tinymce
*/
do_action('yasr_add_tabs_on_tinypopupform');

will generate this code

do_action('yasr_add_tabs_on_tinypopupform')

Source: ../yet-another-stars-rating/admin/editor/YasrEditorHooks.php, line 219

Use this action to add tabs inside shortcode creator for tinymce

or, another example with tags

/**
* Use this action to add content inside shortcode creator
*
* @param int $n_multi_set
* @param string $multi_set the multiset name
*/
do_action('yasr_add_content_on_tinypopupform', $n_multi_set, $multi_set);

will generate this code with table

do_action('yasr_add_content_on_tinypopupform')

Source: ../yet-another-stars-rating/admin/editor/YasrEditorHooks.php, line 235

Use this action to add content inside shortcode creator


| Argument     | Type   | Description       |
|--------------|--------|-------------------|
| $n_multi_set | int    |                   |
| $multi_set   | string | the multiset name |

But, if you use the type after the argument, e.g.

/**
* @param $n_multi_set int
*/

this will insert the type (int and string in this example) inside the "Description" column:

| Argument     | Type | Description              |
|--------------|------|--------------------------|
| $n_multi_set |      | int                      |

Alternatives

Here is a list of alternatives that I found. However, none of these satisfied my needs

Links