allowing to insert help tab in specific position

[tfnab]

this enhancement of add_help_tab() would allow plugin developers to insert help tabs on existing screens at an arbitrary position, e.g. place it on the "Writing Settings" screen's help tab between the "Overview" and "Press This" tabs

the patch attached includes the bugfix from #19827, but this enhancement can be rewritten to work independently

[nacin]

It would probably be best to implement a priority system.

[helen]

Seems like a fairly standalone patch exploration.

[dustyf]

Patch dds priority argument for help tabs and method to sort by argument

[dustyf]

Patch submitted adding a priority argument for the help tabs and a method to sort the tabs before display. By default, tabs will have a priority of 10 and priorities can be passed in with the default $args when adding new tabs.

[OriginalEXE]

Refreshed patch (4.3) for 4.4

[OriginalEXE]

Hi, submitted the refreshed patch based on @dustyf patch provided 10 months ago.

[swissspidy]

Almost perfect. Will add some unit tests / adjust the existing one.

[swissspidy]

What 19828.2.diff​ does:

• Makes the _sort_help_tabs callback method protected, to match other sort callbacks in core.
• Uses uasort to preserve the array keys
• Adjusts the test_get_help_tabs unit test
• Adds a new test_help_tabs_priority test.

[DrewAPicture]

A few docs notes on 19828.2.diff​:

• We'll need a changelog entry for get_help_tabs() for the introduction of priorities
• Two newlines should be added before the second sentence in the summary for _sort_help_tabs() (it's the description)
• No new line between the @param block and @return in _sort_help_tabs()
• Need a changelog entry for the new argument in add_help_tab(). I suggest:

  * @since 4.4.0 The `$priority` argument was added.
  

[swissspidy]

This patch addresses the issues mentioned by @DrewAPicture

[DrewAPicture]

19828.3.diff​ looks good. Thanks @swissspidy :-)

[wonderboymusic]

In 33985:

Implement a priority system for Help Tabs to add them at specific positions.

Adds unit tests.

Props swissspidy.
Fixes #19828.