[wp-trac] [WordPress Trac] #14808: Add Editor Documentation Functions URL for theme-defined functions

WordPress Trac noreply at wordpress.org
Tue Jul 19 17:24:47 UTC 2022

#14808: Add Editor Documentation Functions URL for theme-defined functions
 Reporter:  GamajoTech                           |       Owner:  exthilion
     Type:  enhancement                          |      Status:  assigned
 Priority:  normal                               |   Milestone:  Future
                                                 |  Release
Component:  Themes                               |     Version:
 Severity:  normal                               |  Resolution:
 Keywords:  good-first-bug has-patch needs-      |     Focuses:
  refresh changes-requested                      |
Changes (by desrosj):

 * keywords:  good-first-bug has-patch needs-refresh => good-first-bug has-
     patch needs-refresh changes-requested
 * milestone:   => Future Release


 Just did some testing, and looks like this issue still exists today.

 Personally, I think any hooks that help developers provide better
 documentation are great additions. Though I definitely don't like the idea
 of someone replacing a php.net or wordpress.org documentation URL with
 their own, there could be scenarios where this is beneficial.

 I don't think [attachment:"filter-https.diff"] is the right approach.
 There is one button output to navigate the user to the correct location
 based on the option selected. This patch would specify one URL for all
 functions if filtered.

 I think a better solution would be to change the `<option>` tag's `value`
 attribute to a full URL when someone wishes to override or supply their
 own documentation URL. The JavaScript should then be updated to use the
 `value` of the selected item if it is determined to be a URL.

 @exthilion I know that it's been a long time. But would you be interested
 in creating a patch?

Ticket URL: <https://core.trac.wordpress.org/ticket/14808#comment:12>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform

More information about the wp-trac mailing list