Changeset 38832 for trunk/src/wp-includes/option.php

Timestamp:

10/20/2016 02:54:12 AM (9 years ago)

Author:

rachelbaker

Message:

REST API: Introduce the Content API endpoints.

REST API endpoints for your WordPress content. These endpoints provide machine-readable external access to your WordPress site with a clear, standards-driven interface, allowing new and innovative apps for interacting with your site. These endpoints support all of the following:

• Posts: Read and write access to all post data, for all types of post-based data, including pages and media.
• Comments: Read and write access to all comment data. This includes pingbacks and trackbacks.
• Terms: Read and write access to all term data.
• Users: Read and write access to all user data. This includes public access to some data for post authors.
• Meta: Read and write access to metadata for posts, comments, terms, and users, on an opt-in basis from plugins.
• Settings: Read and write access to settings, on an opt-in basis from plugins and core. This enables API management of key site content values that are technically stored in options, such as site title and byline.

Love your REST API, WordPress! The infrastructure says, "Let's do lunch!" but the content API endpoints say, "You're paying!"

Props rmccue, rachelbaker, danielbachhuber, joehoyle, adamsilverstein, afurculita, ahmadawais, airesvsg, alisspers, antisilent, apokalyptik, artoliukkonen, attitude, boonebgorges, bradyvercher, brianhogg, caseypatrickdriscoll, chopinbach, chredd, christianesperar, chrisvanpatten, claudiolabarbera, claudiosmweb, cmmarslender, codebykat, coderkevin, codfish, codonnell822, daggerhart, danielpunkass, davidbhayes, delphinus, desrosj, dimadin, dotancohen, DrewAPicture, Dudo1985, duncanjbrown, eherman24, eivhyl, eliorivero, elyobo, en-alis, ericandrewlewis, ericpedia, evansobkowicz, fjarrett, frozzare, georgestephanis, greatislander, guavaworks, hideokamoto, hkdobrev, hubdotcom, hurtige, iandunn, ircrash, ironpaperweight, iseulde, Japh, jaredcobb, JDGrimes, jdolan, jdoubleu, jeremyfelt, jimt, jjeaton, jmusal, jnylen0, johanmynhardt, johnbillion, jonathanbardo, jorbin, joshkadis, JPry, jshreve, jtsternberg, JustinSainton, kacperszurek, kadamwhite, kalenjohnson, kellbot, kjbenk, kokarn, krogsgard, kuchenundkakao, kuldipem, kwight, lgedeon, lukepettway, mantismamita, markoheijnen, matrixik, mattheu, mauteri, maxcutler, mayukojpn, michael-arestad, miyauchi, mjbanks, modemlooper, mrbobbybryant, NateWr, nathanrice, netweb, NikV, nullvariable, oskosk, oso96_2000, oxymoron, pcfreak30, pento, peterwilsoncc, Pezzab, phh, pippinsplugins, pjgalbraith, pkevan, pollyplummer, pushred, quasel, QWp6t, schlessera, schrapel, Shelob9, shprink, simonlampen, Soean, solal, tapsboy, tfrommen, tharsheblows, thenbrent, tierra, tlovett1, tnegri, tobych, Toddses, toro_unit, traversal, vanillalounge, vishalkakadiya, wanecek, web2style, webbgaraget, websupporter, westonruter, whyisjake, wonderboymusic, wpsmith, xknown, zyphonic.
Fixes #38373.

File:

• trunk/src/wp-includes/option.php (modified) (1 diff)

trunk/src/wp-includes/option.php

@@ -1709 +1709 @@
 
 /**
+ * Register default settings available in WordPress.
+ *
+ * The settings registered here are primarily useful for the REST API, so this
+ * does not encompass all settings available in WordPress.
+ *
+ * @since 4.7.0
+ */
+function register_initial_settings() {
+    register_setting( 'general', 'blogname', array(
+        'show_in_rest' => array(
+            'name' => 'title',
+        ),
+        'type'         => 'string',
+        'description'  => __( 'Site title.' ),
+    ) );
+
+    register_setting( 'general', 'blogdescription', array(
+        'show_in_rest' => array(
+            'name' => 'description',
+        ),
+        'type'         => 'string',
+        'description'  => __( 'Site description.' ),
+    ) );
+
+    register_setting( 'general', 'siteurl', array(
+        'show_in_rest' => array(
+            'name'    => 'url',
+            'schema'  => array(
+                'format' => 'uri',
+            ),
+        ),
+        'type'         => 'string',
+        'description'  => __( 'Site URL.' ),
+    ) );
+
+    register_setting( 'general', 'admin_email', array(
+        'show_in_rest' => array(
+            'name'    => 'email',
+            'schema'  => array(
+                'format' => 'email',
+            ),
+        ),
+        'type'         => 'string',
+        'description'  => __( 'This address is used for admin purposes. If you change this we will send you an email at your new address to confirm it. The new address will not become active until confirmed.' ),
+    ) );
+
+    register_setting( 'general', 'timezone_string', array(
+        'show_in_rest' => array(
+            'name' => 'timezone',
+        ),
+        'type'         => 'string',
+        'description'  => __( 'A city in the same timezone as you.' ),
+    ) );
+
+    register_setting( 'general', 'date_format', array(
+        'show_in_rest' => true,
+        'type'         => 'string',
+        'description'  => __( 'A date format for all date strings.' ),
+    ) );
+
+    register_setting( 'general', 'time_format', array(
+        'show_in_rest' => true,
+        'type'         => 'string',
+        'description'  => __( 'A time format for all time strings.' ),
+    ) );
+
+    register_setting( 'general', 'start_of_week', array(
+        'show_in_rest' => true,
+        'type'         => 'number',
+        'description'  => __( 'A day number of the week that the week should start on.' ),
+    ) );
+
+    register_setting( 'general', 'WPLANG', array(
+        'show_in_rest' => array(
+            'name' => 'language',
+        ),
+        'type'         => 'string',
+        'description'  => __( 'WordPress locale code.' ),
+        'default'      => 'en_US',
+    ) );
+
+    register_setting( 'writing', 'use_smilies', array(
+        'show_in_rest' => true,
+        'type'         => 'boolean',
+        'description'  => __( 'Convert emoticons like :-) and :-P to graphics on display.' ),
+        'default'      => true,
+    ) );
+
+    register_setting( 'writing', 'default_category', array(
+        'show_in_rest' => true,
+        'type'         => 'number',
+        'description'  => __( 'Default category.' ),
+    ) );
+
+    register_setting( 'writing', 'default_post_format', array(
+        'show_in_rest' => true,
+        'type'         => 'string',
+        'description'  => __( 'Default post format.' ),
+    ) );
+
+    register_setting( 'reading', 'posts_per_page', array(
+        'show_in_rest' => true,
+        'type'         => 'number',
+        'description'  => __( 'Blog pages show at most.' ),
+        'default'      => 10,
+    ) );
+}
+
+/**
  * Register a setting and its data.
  *