[wp-trac] [WordPress Trac] #37335: Standardized API for themes to add info/links to the customizer

[WordPress Trac]

#37335: Standardized API for themes to add info/links to the customizer
-------------------------------------------------+-------------------------
 Reporter:  celloexpressions                     |       Owner:
     Type:  enhancement                          |      Status:  new
 Priority:  normal                               |   Milestone:  Awaiting
Component:  Customize                            |  Review
 Severity:  normal                               |     Version:
 Keywords:  needs-patch ui-feedback ux-feedback  |  Resolution:
                                                 |     Focuses:  ui
-------------------------------------------------+-------------------------

Comment (by celloexpressions):

 @karmatosed this is based on the TRT decision to allow themes to add
 upsell links to the top level of the customizer:
 https://make.wordpress.org/themes/2016/05/03/may-3rd-meeting-notes/.
 Unfortunately, most are doing_it_wrong both in terms of code (injecting
 markup with JS, which will break whenever core changes things) and
 usability (throwing links in places not relevant to themes, with bad
 text). The slack conversation linked above includes an example that I just
 noticed as well as a potential way that would be more acceptable in terms
 of working with core UI.

 I'm now thinking that adding a `do_action` to the top-level themes section
 (soon to be panel) heading would be the best option all around. Then, the
 TRT can allow only links added via that action, which would ensure that
 the placement is appropriate and won't break if core markup changes. I'm
 hesitant to do more than that, such as forcing the UI to be a link, since
 it would be more complexity for core and overly restrictive for themes.
 However, I think the TRT should probably adopt some guidelines for what's
 added with this hook in term of UI, such as not allowing links to be
 styled as buttons.

 I'll attach the images I shared in #themereview of a theme that's doing it
 wrong, and how it should probably be doing it instead.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/37335#comment:4>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform