Afform - provide easy way to add navigation menu from the form

[colemanw]

Overview

Allows admin to create a navigation menu entry while editing an Afform.

Before

Navigation menu can be created manually.

After

Navigation menu can be created automatically, very similar to the way it works in CiviReport.

Comments

One cool thing I added here was insta-refresh, so as soon as you save the Afform you'll see the navigation menu update without a page reload needed.

[civibot]

(Standard links)

• If this is your first pull-request for CiviCRM, please browse CONTRIBUTING.md for information about the development and testing processes.
• If you are reviewing this pull-request, you may wish to consult the test sites and the Review Standards (long template, short template).

[eileenmcnaughton]

It works well in my testing - there is a question around the fact the reset doesn't happen after single create/updates (which most BAOs do, if needed) but that is pre-existing & I can see the performance advantage

[mattwire]

Nice! Thankyou @colemanw

[colemanw]

Thanks @eileenmcnaughton - just to be clear, APIv4 always calls the plural functions writeRecords and deleteRecords even when it's only working with 1 item.

But yea, I left the legacy v3 and direct BAO stuff alone because there's a pre-existing expectation that you have to flush caches manually after using those (which I guess is better for performance but it's sucky DX).