[wp-trac] [WordPress Trac] #29706: Settings API - term consitency

[WordPress Trac]

#29706: Settings API - term consitency
--------------------------------+-----------------------------
 Reporter:  Cleanshooter        |      Owner:
     Type:  enhancement         |     Status:  new
 Priority:  normal              |  Milestone:  Awaiting Review
Component:  Options, Meta APIs  |    Version:  4.0
 Severity:  normal              |   Keywords:
  Focuses:                      |
--------------------------------+-----------------------------
 Hey I've been working with the settings API quite a bit lately and I'm
 wondering if you can shed some light on why things are labeled the way
 they are.

 So why is it that in order to call up a "setting" I've registered with
 register_setting() I use a function called get_option() shouldn't this be
 get_setting()?

 And why does my registered "setting" get get updated by using a function
 called update_option()?  Should this too not be update_setting()?

 Basically it would be nice if you could stick to one term either call them
 settings or options.  Having 2 terms for the same thing is just confusing.

 Also do_settings_sections() sounds like it should allow you to display the
 fields from a section but no that's do_settings_fields().  The functions
 name just kind of implies that the parameter will be a section not a
 settings group/page.  do_settings_fields() is kind of goofy too because I
 always want to display fields when using either of these functions isn't
 that their implied task?  Wouldn't it make more sense if it was just
 do_settings() or do_settings_page() to display all of them.  Then
 do_settings_section() to be the one that displays just one?

 I'm probably just being picky with the last part but It would be helpful
 to at least have the consistency mention in the first half of this rant.

 Thanks for all your hard work on WordPress.  It's a great system and it
 keeps getting better all the time.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/29706>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform