It looks like doxygen has some problems with such code, but… There are some solutions… You can use INPUT_FILTERs for that. After doxygen docs: The INPUT_FILTER tag can be used to specify a program that doxygen should invoke to filter for each input file. Doxygen will invoke the filter program by executing (via popen()) the … Read more
Is there a script to collect all hooks and filters provided by a plugin?
Yes, it is, but you’ll have to use get_author_posts_url() (see Codex). The example in the Codex is (not my code): <a href=”https://wordpress.stackexchange.com/questions/337513/<?php echo get_author_posts_url( get_the_author_meta(“ID’ ), get_the_author_meta( ‘user_nicename’ ) ); ?>”><?php the_author(); ?></a> You could add your own title=”My Better Title” in that <a> tag to make it say whatever you like: <a href=”https://wordpress.stackexchange.com/questions/337513/<?php echo … Read more
Skimming the available WP-CLI commands I guess there is not something like that. You may create a feature request in the WP-CLI GitHub repo but I doubt that this will gain much attention without you explaining the actual necessity of such command. Normally when developing, you use your IDE to get hold of those information. … Read more
No, WordPress does not pass any arguments to the hook’s callbacks. And you can use that hook to display something after the embed excerpt is displayed. But this is of course, if the theme is using the default embed template for post embeds — with custom template, you could, if you want to, display the … Read more
I would say the section Constants in the WordPress: PHP Documentation Standards is pretty clear. It should look like this: /** * Summary. * * @since x.x.x (if available) * @var type $var Description. */ define( ‘MY_CONST’, ‘Hello’ );
The documentation is wrong. Check the source. There are two telling comments. First there is: // Get the nav menu based on the theme_location And after which there is another comment that reads: // get the first menu that has items if we still can’t find a menu Following that last comment the code runs … Read more
I believe the practice of including additional data within PHP code comments is typically called annotations. WordPress core makes no use of annotations technique for any code runtime tasks and doesn’t have an API for such purpose. In number of context it will read file headers to extract meta data, such as main plugin files … Read more
The codex is some kind of a mess. General behavior is to let users (re)write it and then go over it and change what they (whoever this is) think. Ex. The Codex lacks a lot of functions in the function reference. On some places you already got the 3.1 explanations, on other completely outdated stuff. … Read more
Plugin developer automated documentation