[{"name":"The Word Widget","slug":"the-word-widget","version":"0.9","author":"Helmut Steeb","author_profile":"https://profiles.wordpress.org/hsteeb/","requires":"4.6","tested":"6.6.2","requires_php":"5.3","requires_plugins":[],"rating":100,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"downloaded":5911,"last_updated":"2024-07-17 10:38am GMT","added":"2014-02-20","homepage":"https://bible2.net/download/the-word-widget-for-wordpress/","sections":{"description":"

The plugin provides a widget which you can place into one of the widget areas provided by your theme (in the WordPress admin area: Appearance | Widgets).

The widget configuration retrieves the list of available Bible editions of the current year remotely from https://bible2.net and lets you select one Bible edition. On each day, the widget retrieves the two verses for the day from bible2.net and displays them.

Project Bible 2.0

Project Bible 2.0 collects cross-references between selected Bible verses, formats the verses nicely and publishes two cross-referenced verses for each day of the year in more than 20 languages, available for free download and as a remote service.

Bible Editions Available

Dated 2024-07-17 – for latest information, see https://bible2.net/download/bible-editions-available/.

For 2024, The Word is available in the following Bible editions and languages:

af Bybel in Afrikaans (1983-vertaling)
ar كتاب الحياة : الترجمة العربية الجديدة (Holy Bible, New Arabic Version, Ketab El Hayat)
cim Zimbrisch (German Cimbrian dialect), see https://bible2.net/cim
da Bibelen (Danish)
de Hoffnung für Alle (German)
de Leonberger Bibel (German)
de Neue Evangelistische Übersetzung (German)
de Schlachter 2000 (German)
en English Standard Version
en Free Bible Version (new 2023!)
es Reina-Valera 1995 (Spanish)
fr Segond 21 (French)
ga An Bíobla Naofa 1981 (Gaelic)
gr Νέα Μετάφραση Βάμβα (Greek)
he ספר הבריתות 2004 (Hebrew)
hu Karoli 1990 (Hungarian)
it Nuova Riveduta 1994 (Italian)
pfl-x-suedsaar Südsaarländisch (Southern Saarlandian, a kind of Pfälzisch = Palatinate), see https://bible2.net/pfl-x-suedsaar
pl Biblia Tysiąclecia (Polski Polish)
pt Bíblia Livre em português (Portuguese)
ro Cornilescu 2014 (Romanian), see https://bible2.net/ro
ru Юбилейная Библия Jubiläums-Bibel (русский Russian)
swg Bibel für Schwoba (Schwäbisch Swabian swg), see https://bible2.net/swg
th สมาคมพระคริสตธรรมไทย 1971 (Thai Holy Bible 1971)
tr Kutsal Kitap 2001
ur کِتابِ مُقادّس (Urdu Revised Version)
uz-Cyrl Ўзбек тилидаги Муқаддас Китоб 2012
uz-Latn O‘zbek tilidagi Muqaddas Kitob 2012
vi Vietnamese Bible (1934)
zh-Hans 中文标准译本(简化字) (Simplified Chinese)
zh-Hant 中文标准译本(繁體字) (Traditional Chinese)

System Requirements

PHP: tested with 7.4.
SimpleXML: the widget needs the “SimpleXML” PHP library. If it is not available, the widget configuration (see “Appearance | Widgets” in the Installation chapter) will show an error message.

Adapting the Layout

The widget output uses the following CSS classes which you may adapt in your stylesheet (CSS):

TheWord
TL
Parol
IL
L
SL

An example CSS file is included in the plugin zip file. It includes CSS to either show the verses with line breaks (on a wider display) or without the line breaks (on a smaller display). You may need to adapt the rules, depending on the actual width of your widget area.

Workaround: Adapt your Theme Stylesheet

If you have no idea how to adapt your stylesheet, the following workaround may help:

open your published WordPress page in a browser
inspect the page sources (via right mouse, menu item like “View page source”)
search for wp-content/themes, you should find it in a href attribute of an HTML element link
the href attribute value is an URL path to a stylesheet file of your WordPress theme\n
- typically, the URL path ends like .css?ver=1.2.3
\n
on your web server, open the file located at that path (omit the trailing ?ver=1.2.3)\n
- typically, the file does not contain line-breaks
\n
just navigate to the end of the file, add a line-break, then enter the desired styles (you may start with the contents of the above mentioned example CSS file).
save the file and reload the page in your browser.\n
- Now you should see the effect of the modified stylesheet.
\n

Note: keep a backup of the inserted styles – WordPress will likely overwrite the file when you update your WordPress version or the theme, so you’ll have to apply the changes again.

Workaround: Adapt the Plugin Output

Example: you want the Bible 2.0 logo to open the bible2.net page not in the same but in a new browser Tab.

Precondition: you have access to the installed plugin files on your webserver. (If available, you better test this on a WordPress instance on a local computer first.)

Steps (based on plugin version 0.9):

locate the file wp-content/plugins/the-word-widget/the-word-widget.php
for backup, copy the file to another place
locate the line\n
- # $theWord truthy
\n
after that line, insert the following line (modifying the HTML link “target” to “_blank”):\n
- $theWord = str_replace('target=\"_top\" class=\"b2-twd-start\"', 'target=\"_blank\" class=\"b2-twd-start\"', $theWord);
\n
save the file
in the browser, refresh your web page that displays The Word
click on the Bible 2.0 logo. This should now open the page in a new browser Tab.

By inspecting the page source in your browser, you may come up with other adaptations – like adding a specific CSS class or style.
\nEnsure you’re using correct PHP syntax, e.g. don’t use the outer single quotes unmasked within your replacement text.

Note: keep a backup of your change – WordPress will likely overwrite the file when you update your WordPress version or the theme, so you’ll have to apply the changes again.

Further Examples

Make the title line “The Word for…” a H2 instead of a P element:\n
- $theWord = preg_replace(\"/<p\\sclass='TL'>(.*?)<\\/p>/s\", \"<h2 class='TL'>$1</h2>\", $theWord);
\n
Avoid the line-breaks in the verses (override CSS white-space to normal):\n
- $theWord = preg_replace(\"/(<p\\sclass='L')>/\", \"$1 style='white-space: normal'>\", $theWord);
\n
Show the verse text in black color:\n
- $theWord = preg_replace(\"/(<p\\sclass='L')>/\", \"$1 style='color: black'>\", $theWord);
\n
Show the Bible reference text in black color:\n
- $theWord = preg_replace(\"/(<p\\sclass='SL')>/\", \"$1 style='color: black'>\", $theWord);
\n

For WordPress Developers

If you’re expert in the hottest WordPress development stuff like the “Block editor”, and you could imagine to maintain this plugin – you’re welcome!

I don’t follow new WordPress trends any more (I moved sites from WordPress to Symfony resp. Hugo).

So as of 2023-03, the WordPress admin dashboard supports configuring the plugin in “legacy” mode only. Maybe sometime they even obsolete this?

Plugin License

The WordPress plugin is licensed under GPLv2 or later.

License for Bible Texts (got remotely per day)

The license conditions for the Bible texts (verses) are defined by the publisher of the respective Bible edition. They are contained in the .twd XML files, and are also shown in https://bible2.net/copyright/.

License for Related Bible References (got remotely per day)

The project Bible 2.0 provides pairs of related Bible references.

The Word associates one pair of Bible references with a certain day, respectively.

The association of Bible references into pairs and of such pairs to days of a certain year is subject to

License “Creative Commons 4.0”\n<https://creativecommons.org/licenses/by-sa/4.0/>\n(Attribution, ShareAlike)\n

With each publication, the following statement with a link to https://bible2.net must be available for the user (e.g. by adding a link to the copyright page):

Association of Bible references by project Bible 2.0\n

\n","installation":"

unpack the zip file into your WordPress plugin folder /wp-content/plugins/;
in the WordPress admin area, in Plugins | Installed Plugins, activate the plugin;
in the WordPress admin area, in Appearance | Widgets, put the widget “The Word” into one of your widget areas;
within “The Word” widget, click into the box labelled “The Word”, a combobox shows up
in the combobox, select the desired Bible edition
to see a preview, click outside the area labelled “The Word” (e.g. right to the top toolbar)
to apply the change to your site, click the “Update” button (previously: “Save” button) top-right in the “Widgets” window.

\n","changelog":"

0.9

for use in a WP 5.8 Legacy Widget Block, moved the static method html from includes/admin-form.php into the-word-widget.php
dropped the empty the-word-widget-admin.php
tested with PHP 7.4.3 and WordPress 5.8 RC4

0.8

use anonymous function (available since PHP 5.3.0) instead of create_function (deprecated in PHP 7.2)
tested with PHP 7.2.15 and WordPress 5.1 RC2

0.7

use https protocol to access bible2.net
tested up to WordPress 4.8

0.6

if the SimpleXML module is missing, the widget configuration form shows a detailed info.

0.5

if the widget form (for admin) fails to retrieve the list of Bible editions from bible2.net, the form shows a detailed log of its actions, and some environment info (allow_url_fopen, php_version(), $wp_version, $required_php_version).

0.4

on restricted server configurations,
the plugin now falls back to a safer method to retrieve data from bible2.net
(if PHP setting allow_url_fopen=Off, simplexml_load_file fails,
then the plugin uses the WordPress method wg_remote_get)

0.3

the widget does not store a .twd file per year but uses the daily online service

0.2

the widget form (for admin) retrieves the list of Bible editions from bible2.net,
… lets admin select the Bible edition
… and retrieves The Word .twd file for the selected Bible edition from bible2.net.
the widget shows The Word from the Bible edition selected in the widget form.

0.1

initial version

\n","screenshots":"

$\"The$
The widget configuration
$\"The$
The widget in a wider widget area (line breaks preserved)
$\"The$
The widget in a small widget area (no line breaks)

"},"short_description":"Shows two Bible verses per day: "The Word" by project Bible 2.0, available in more than 20 languages, got remotely for each day","download_link":"https://downloads.wordpress.org/plugin/the-word-widget.zip","screenshots":{"1":{"src":"https://ps.w.org/the-word-widget/trunk/screenshot-1.jpg?rev=3120242","caption":"The widget configuration"},"2":{"src":"https://ps.w.org/the-word-widget/trunk/screenshot-2.jpg?rev=3120242","caption":"The widget in a wider widget area (line breaks preserved)"},"3":{"src":"https://ps.w.org/the-word-widget/trunk/screenshot-3.jpg?rev=3120242","caption":"The widget in a small widget area (no line breaks)"}},"tags":{"bibel":"bibel","bible":"bible","devotional":"devotional","losung":"losung","verse-of-the-day":"verse of the day"},"versions":{"0.3":"https://downloads.wordpress.org/plugin/the-word-widget.0.3.zip","0.4":"https://downloads.wordpress.org/plugin/the-word-widget.0.4.zip","0.5":"https://downloads.wordpress.org/plugin/the-word-widget.0.5.zip","0.6":"https://downloads.wordpress.org/plugin/the-word-widget.0.6.zip","0.7":"https://downloads.wordpress.org/plugin/the-word-widget.0.7.zip","0.8":"https://downloads.wordpress.org/plugin/the-word-widget.0.8.zip","0.9":"https://downloads.wordpress.org/plugin/the-word-widget.0.9.zip"},"donate_link":"","icons":{"1x":"https://ps.w.org/the-word-widget/assets/icon-128x128.png?rev=972478"}},{"name":"একাত্তর | ekattor","slug":"pbp-ekattor","version":"১.২","author":"প্রযুক্তি বাংলা","author_profile":"https://profiles.wordpress.org/projoktibangla/","requires":"3.1","tested":"4.2.38","requires_php":false,"requires_plugins":[],"rating":0,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"downloaded":898,"last_updated":"2015-04-19 3:37am GMT","added":"2015-04-15","homepage":"http://projoktibangla.net","sections":{"description":"","installation":"

‘একাত্তর | ekattor’ প্লাগইনটির প্রস্তুতকরণ প্রক্রিয়া একদমই সহজ। দুটি উপায়ে এটি করা যাবে।

স্বয়ংক্রিয়:

প্রথমে আপনার ওয়েবসাইটের Dashboard থেকে Plugins এ যান। সেখান থেকে Add new তে চাপুন।
এবার \\”একাত্তর / ekattor\\” লিখে সার্চ করুন।
এবার Install ও Active এ চাপুন।

নিজেরমতো করে:

প্রথমে \\”pbp-ekattor.zip\\” নামের প্লাগইন ফাইলটি Download করুন।
আপনার ওয়েবসাইটের Dashboard থেকে Plugins এ যান। সেখান থেকে Add new তে চাপুন।
এবার Upload Plugin এ চেপে পরবর্তীতে পাতায় যান।
এবার \\”pbp-ekattor.zip\\” ফাইলটি Upload করে Install ও Active করুন।

\n","faq":"","changelog":"

১.২

১৬-০৪-২০১৫
গুরুত্বপূর্ণ একটি ত্রুটি ঠিক করা হয়েছে

১.১

১৫-০৪-২০১৫
নতুন কিছু সুবিধা যুক্ত করা হয়েছে এবং ভুলত্রুটি ঠিক করা হয়েছে

১.০

১৪-০৪-২০১৫
প্রথম প্রকাশ

\n","screenshots":"

$\"‘একাত্তরের$
‘একাত্তরের এই দিনে’ সেবাটি Page ও Sidebar উভয়টিতে ব্যবহার করা হয়েছে
$\"‘একাত্তরের$
‘একাত্তরের বীর সেনানীরা’ সেবাটি Page এ ব্যবহার করা হয়েছে
$\"‘একাত্তরের$
‘একাত্তরের সেক্টরসমূহ’ সেবাটি Page এ ব্যবহার করা হয়েছে

"},"short_description":"মহান মুক্তিযুদ্ধের ইতিহাস নিয়ে বিশেষ টুলস","download_link":"https://downloads.wordpress.org/plugin/pbp-ekattor.zip","screenshots":{"1":{"src":"https://ps.w.org/pbp-ekattor/assets/screenshot-1.png?rev=1138320","caption":"‘একাত্তরের এই দিনে’ সেবাটি Page ও Sidebar উভয়টিতে ব্যবহার করা হয়েছে"},"2":{"src":"https://ps.w.org/pbp-ekattor/assets/screenshot-2.gif?rev=1138321","caption":"‘একাত্তরের বীর সেনানীরা’ সেবাটি Page এ ব্যবহার করা হয়েছে"},"3":{"src":"https://ps.w.org/pbp-ekattor/assets/screenshot-3.gif?rev=1138321","caption":"‘একাত্তরের সেক্টরসমূহ’ সেবাটি Page এ ব্যবহার করা হয়েছে"}},"tags":{"1971":"1971","%e0%a6%8f%e0%a6%95%e0%a6%be%e0%a6%a4%e0%a7%8d%e0%a6%a4%e0%a6%b0":"একাত্তর","%e0%a6%ae%e0%a7%81%e0%a6%95%e0%a7%8d%e0%a6%a4%e0%a6%bf%e0%a6%af%e0%a7%81%e0%a6%a6%e0%a7%8d%e0%a6%a7":"মুক্তিযুদ্ধ","%e0%a6%ae%e0%a7%81%e0%a6%95%e0%a7%8d%e0%a6%a4%e0%a6%bf%e0%a6%af%e0%a7%8b%e0%a6%a6%e0%a7%8d%e0%a6%a7%e0%a6%be":"মুক্তিযোদ্ধা","%e0%a6%b6%e0%a6%b9%e0%a7%80%e0%a6%a6":"শহীদ","%e0%a6%b8%e0%a7%8d%e0%a6%ac%e0%a6%be%e0%a6%a7%e0%a7%80%e0%a6%a8%e0%a6%a4%e0%a6%be-%e0%a6%af%e0%a7%81%e0%a6%a6%e0%a7%8d%e0%a6%a7":"স্বাধীনতা যুদ্ধ","%e0%a7%a7%e0%a7%af%e0%a7%ad%e0%a7%a7":"১৯৭১","bangladesh":"Bangladesh","ekattor":"ekattor","independent-war":"independent war","muktijuddho":"muktijuddho","shortcode":"shortcode","widget":"widget"},"versions":{"1.0":"https://downloads.wordpress.org/plugin/pbp-ekattor.1.0.zip","1.1":"https://downloads.wordpress.org/plugin/pbp-ekattor.1.1.zip"},"donate_link":"","icons":{"1x":"https://ps.w.org/pbp-ekattor/assets/icon-128x128.png?rev=1135381"}},{"name":"WordPress REST API (Version 2)","slug":"rest-api","version":"2.0-beta15","author":"WP REST API Team","author_profile":"https://profiles.wordpress.org/rmccue/","requires":"4.6","tested":"4.7.29","requires_php":false,"requires_plugins":[],"rating":84,"ratings":{"1":5,"2":0,"3":3,"4":0,"5":26},"num_ratings":34,"support_threads":0,"support_threads_resolved":0,"downloaded":519573,"last_updated":"2016-10-19 2:05pm GMT","added":"2009-04-25","homepage":"https://github.com/WP-API/WP-API","sections":{"description":"

WordPress is moving towards becoming a fully-fledged application framework, and we need new APIs. This project was born to create an easy-to-use, easy-to-understand and well-tested framework for creating these APIs, plus creating APIs for core.

This plugin provides an easy to use REST API, available via HTTP. Grab your site’s data in simple JSON format, including users, posts, taxonomies and more. Retrieving or updating data is as simple as sending a HTTP request.

Want to get your site’s posts? Simply send a GET request to /wp-json/wp/v2/posts. Update user with ID 4? Send a PUT request to /wp-json/wp/v2/users/4. Get all posts with the search term “awesome”? GET /wp-json/wp/v2/posts?filter[s]=awesome. It’s that easy.

The WordPress REST API exposes a simple yet easy interface to WP Query, the posts API, post meta API, users API, revisions API and many more. Chances are, if you can do it with WordPress, the API will let you do it.

The REST API also includes an easy-to-use JavaScript API based on Backbone models, allowing plugin and theme developers to get up and running without needing to know anything about the details of getting connected.

Check out our documentation for information on what’s available in the API and how to use it. We’ve also got documentation on extending the API with extra data for plugin and theme developers!

All tickets for the project are being tracked on GitHub. You can also take a look at the recent updates for the project.

\n","installation":"

Install the WP REST API via the plugin directory, or by uploading the files manually to your server.

For full-flavoured API support, you’ll need to be using pretty permalinks to use the plugin, as it uses custom rewrite rules to power the API.

Once you’ve installed and activated the plugin, check out the documentation for details on your newly available endpoints.

\n","changelog":"

2.0 Beta 15.0 (October 07, 2016)

\n
Introduce support for Post Meta, Term Meta, User Meta, and Comment Meta in
\ntheir parent endpoints.
\n
For your meta fields to be exposed in the REST API, you need to register
\nthem. WordPress includes a register_meta() function which is not usually
\nrequired to get/set fields, but is required for API support.
\n
To register your field, simply call register_meta and set the show_in_rest
\nflag to true. Note: register_meta must be called separately for each meta
\nkey.
\n
(props @rmccue, @danielbachhuber, @kjbenk, @duncanjbrown, #2765)
\n
\n
Introduce Settings endpoint.
\n
Expose options to the REST API with the register_setting() function, by
\npassing $args = array( 'show_in_rest' => true ). Note: WordPress 4.7 is
\nrequired. See changeset [38635][https://core.trac.wordpress.org/changeset/38635].
\n
(props @joehoyle, @fjarrett, @danielbachhuber, @jonathanbardo,
\n@greatislander, #2739)
\n
\n
Attachments controller, change permissions check to match core.
\n
Check for the upload_files capability when creating an attachment.
\n
(props @nullvariable, @adamsilverstein, #2743)
\n
\n
Add ?{taxonomy}_exclude= query parameter
\n
This mirrors our existing support for ?{taxonomy}= filtering in the posts
\ncontroller (which allows querying for only records with are associated with
\nany of the provided term IDs for the specified taxonomy) by adding an
\nequivalent _exclude variant to list IDs of terms for which associated posts
\nshould NOT be returned.
\n
(props @kadamwhite, #2756)
\n
\n
Use get_comment_type() when comparing updating comment status.
\n
Comments having a empty comment_type within WordPress bites us again.
\nFixes a bug where comments could not be updated because of bad comparison
\nlogic.
\n
(props @joehoyle, #2753)
\n

2.0 Beta 13.0 (March 29, 2016)

\n
BREAKING CHANGE: Fix Content-Disposition header parsing.
\n
Allows regular form submissions from HTML forms, as well as properly formatted HTTP requests from clients. Note: this breaks backwards compatibility, as previously, the header parsing was completely wrong.
\n
(props @rmccue, #2239)
\n
\n
BREAKING CHANGE: Use compact links for embedded responses if they are available.
\n
Introduces curies for sites running WordPress 4.5 or greater; no changes for those running WordPress 4.4.
\n
(props @joehoyle, #2412)
\n
\n
JavaScript client updates:
\n
- Support lodash, plus older and newer underscore: add an alias for _.contains
- Add args and options on the model/collection prototypes
- Rework category/tag mixins to support new API structure
- Add workaround for the null/empty values returned by the API when creating a new post * these values are not accepted for subsequent updates/saves, so explicitly excluding them. See https://github.com/WP-API/WP-API/pull/2393
- Better handling of the (special) me endpoint
- Schema parsing cleanup
- Introduce wp.api.loadPromise so developers can ensure api load complete before using
\n
(props @adamsilverstein, #2403)
\n
\n
Only adds alternate link header for publicly viewable CPTs.
\n
(props @bradyvercher, #2387)
\n
\n
Adds roles param for GET /wp/v2/users.
\n
(props @BE-Webdesign, #2372)
\n
\n
Declares password in user schema, but never displays it.
\n
(props @danielbachhuber, #2386)
\n
\n
Permits edit context for requests which can edit the user.
\n
(props @danielbachhuber, #2383)
\n
\n
Adds rest_pre_insert_{$taxonomy} filter for terms.
\n
(props @kjbenk, #2377)
\n
\n
Supports taxonomy collection args on posts endpoint.
\n
(props @joehoyle, #2287)
\n
\n
Removes post meta link from post response.
\n
(props @joehoyle, #2288)
\n
\n
Registers description attribute when registering args from schema.
\n
(props @danielbachhuber, #2362)
\n
\n
Uses $comment from the database with rest_insert_comment action.
\n
(props @danielbachhuber, #2349)
\n
\n
Removes unnecessary global variables from users controller.
\n
(props @claudiosmweb, #2335)
\n
\n
Ensures GET /wp/v2/categories with out of bounds offset doesn’t return results.
\n
(props @danielbachhuber, #2313)
\n
\n
Adds top-level support for date queries on posts and comments.
\n
(props @BE-Webdesign, #2266, #2291)
\n
\n
Respects show_avatars setting for comments.
\n
(props @BE-Webdesign, #2271)
\n
\n
Uses cached get_the_terms() for terms-for-post for better performance.
\n
(props @rmccue, #2257)
\n
\n
Ensures comments search is an empty string.
\n
(props @rmccue, #2256)
\n
\n
If no title is provided in create attachment request or file metadata, falls back to filename.
\n
(props @danielbachhuber, #2254)
\n
\n
Removes unused $img_url_basename variable in attachments controller.
\n
(props @danielbachhuber, #2250)
\n

2.0 Beta 12.0 (February 9, 2016)

\n
BREAKING CHANGE: Removes meta endpoints from primary plugin.
\n
If your project depends on post meta endpoints, please install WP REST API Meta Endpoints. For the gory history of meta, read #1425 and linked issues. At this time, we recommend using register_rest_field() to expose meta (docs).
\n
(props @danielbachhuber, #2172)
\n
\n
BREAKING CHANGE: Returns original resource when deleting PTCU.
\n
Now that all resources require the force param, we don’t need to wrap delete responses with the trash state.
\n
(props @danielbachhuber, #2163)
\n
\n
BREAKING CHANGE: Uses roles rather than role in the Users controller.
\n
Building the REST API gives us the opportunity to standardize on roles, instead of having both roles and role.
\n
(props @joehoyle, #2177)
\n
\n
BREAKING CHANGES: Moves to consistent use of context throughout controllers.
\n
Contexts limit the data present in the response. Here’s how to think of them: embed correlates with sidebar representation, view represents the primary public view, and edit is the data expected for an editor.
\n
(props @danielbachhuber, #2205, #2204, #2203, #2218, #2216, #2230, #2184, #2235)
\n
\n
BREAKING CHANGE: Removes post_* query param support for GET /wp/v2/comments.
\n
The proper pattern is to use GET /wp/v2/posts to fetch the post IDs to limit the request to.
\n
(props @danielbachhuber, #2165)
\n
\n
BREAKING CHANGE: Introduces rest_validate_request_arg()/rest_sanitize_request_arg().
\n
Dedicated functions means we can use them for validating / sanitizing query args too. Removes WP_REST_Controller::validate_schema_property() and WP_REST_Controller::sanitize_schema_property().
\n
(props @danielbachhuber, #2166, #2213)
\n
\n
Requires minimum value of 1 for page param.
\n
(props @danielbachhuber, #2241)
\n
\n
Introduces media_type and mime_type params for GET /wp/v2/media.
\n
(props @danielbachhuber, #2231)
\n
\n
Uses the term cache for post data.
\n
(props @rmccue, #2234)
\n
\n
Supports for querying comments where post=0.
\n
(props @danielbachhuber, #1865)
\n
\n
Exposes taxonomy and post type capabilities in context=edit.
\n
(props @danielbachhuber, #2216)
\n
\n
Errors early when user can’t GET types or taxonomies when context=edit.
\n
(props @danielbachhuber, #2218)
\n
\n
Passes original $request context to prepare_items_query.
\n
(props @danielbachhuber, #2211)
\n
\n
Adds parent and parent_exclude params to GET Comments.
\n
(props @danielbachhuber, #2206)
\n
\n
Enforces minimum 1 and maximum 100 values for per_page parameter.
\n
(props @danielbachhuber, #2209)
\n
\n
Adds author and author_exclude params to GET Posts and Comments.
\n
(props @danielbachhuber, #2200, #2200)
\n
\n
Adds menu_order param for GET Pages; support menu_order orderby.
\n
(props @danielbachhuber, #2193)
\n
\n
Only calls sanitize_text_field() when sanitizing type=string,format=email.
\n
(props @danielbachhuber, #2185)
\n
\n
Validates GET /wp/v2/comments private query params.
\n
Returns an error when user doesn’t have permission to use them, instead of silently discarding.
\n
(props @danielbachhuber, #2178)
\n
\n
Explicitly prevents uploading attachments to other attachments or revisions.
\n
(props @danielbachhuber, #2180)
\n
\n
Permits user urls to be edited through the API.
\n
(props @danielbachhuber, #2182)
\n
\n
Marks all Status, Type and Taxonomy fields as readonly.
\n
(props @danielbachhuber, #2181)
\n
\n
Adds validation callbacks to collection query params.
\n
(props @danielbachhuber, #2170, #2171, #2176, #2174, #2175)
\n
\n
Links taxonomy terms to the post type collections they support.
\n
(props @danielbachhuber, #2167)
\n
\n
Returns error when making a GET request with invalid context.
\n
(props @danielbachhuber, #2169)
\n
\n
Adds trash status to GET /wp/v2/statuses.
\n
(props @danielbachhuber, #2158)
\n
\n
Indicates when fields have HTML in schema.
\n
(props @joehoyle, #2159)
\n
\n
Permits viewing of User who has published any Public posts.
\n
(props @danielbachhuber, #2155)
\n
\n
Respects show_avatars option when adding avatars to Users.
\n
(props @nullvariable, #2151)
\n
\n
Controllers use $namespace and $rest_base class variables for easier subclassing.
\n
(props @danielbachhuber, #2119, #2130, #2131, #2132, #2133, #2134, #2139, #2141, #2142)
\n

2.0 Beta 11.0 (January 25, 2016)

\n
BREAKING CHANGE: Moves Post->Term relations to the Post Resource
\n
Previously, a client would fetch a Post’s Tags with GET /wp/v2/posts/<id>/tags.
\n
In Beta 11, an array of term ids is included on the Post resource.
\n
The collection of terms for a Post can be fetched with GET /wp/v2/tags?post=<id>.
\n
The WP_REST_Posts_Terms_Controller class no longer exists.
\n
(props @joehoyle, #2063)
\n
\n
BREAKING CHANGE: Adds latest JS client including a minified version.
\n
See pull request for a summarized changelog.
\n
(props @adamsilverstein, #1981)
\n
\n
BREAKING CHANGE: Changes featured_image attribute on Posts to featured_media.
\n
While featuring other attachment types isn’t yet officially supported, this makes it easier for us to introduce the possibility in the future.
\n
(props @danielbachhuber, #2044)
\n
\n
BREAKING CHANGE: Uses discrete schema title for categories and tags.
\n
If you’ve used register_rest_field( 'term' ), you’ll need to change 'term' to 'tag' and/or 'category'.
\n
(props @danielbachhuber, #2005)
\n
\n
BREAKING CHANGE: Makes many filters dynamic based on the controller type.
\n
If you were using the rest_prepare_term filter, you’ll need to change it to rest_prepare_post_tag or rest_prepare_category.
\n
If you were using rest_post_query or rest_terms_query, you’ll need update your use to rest_page_query, etc.
\n
If you were using rest_post_trashable, rest_insert_post or rest_delete_post, they are now dynamic based on the post type slug.
\n
(props @danielbachhuber, #2008, #2010, #2057, #2058)
\n
\n
Renames GET /wp/v2/comments user param to author to match resource attribute.
\n
Not a breaking change, because it didn’t work in the first place.
\n
(props @danielbachhuber, #2105)
\n
\n
Adds support for GET /wp/v2/pages parent=1,2,3.
\n
(props @danielbachhuber, #2101)
\n
\n
Persists image metadata title and caption when not present in the request.
\n
(props @danielbachhuber, #2079)
\n
\n
Add parent_exclude param to GET /wp/v2/posts.
\n
(props @danielbachhuber, #2077)
\n
\n
Adds slug param support for collections of Posts, Users, and Taxonomy Terms.
\n
(props @danielbachhuber, #2071, #2072, #2103)
\n
\n
When a comment is already trashed, returns 410:rest_already_trashed.
\n
(props @danielbachhuber, #2069)
\n
\n
Filter the responses by context after processing additional fields.
\n
(props @danielbachhuber, #2067)
\n
\n
Adds offset param support for collections of Posts, Users, Comments, and Taxonomy Terms.
\n
(props @danielbachhuber, #2061, #2062, #2064, #2076)
\n
\n
Adds rest_insert_{$taxonomy} and rest_delete_{$taxonomy} actions.
\n
(props @danielbachhuber, #2060)
\n
\n
Provides more helpful error message/code on Post Create/Update fail.
\n
(props @danielbachhuber, #2053)
\n
\n
Forces GET /wp/v2/media to be limited to 'status' => [ inherit, private, trash ]
\n
(props @danielbachhuber, #2026)
\n
\n
Uses more correct error code for Comment::delete permission check.
\n
(props @danielbachhuber, #2054)
\n
\n
Calls prepare_item_for_response() directly in create and update methods.
\n
This lets us pass the original request through, giving the method and its filter genuine context, and avoids an
\nunnecessary call to get_item().
\n
(props @danielbachhuber, #2038, #2040, #2041, #2043, #2042)
\n
\n
Moves permission check methods across controllers.
\n
Placing them above the method they’re supposed to check makes the code more readable.
\n
(props @danielbachhuber, #2030, #2029, #2034, #2036, #2037, #2035, #2039)
\n
\n
Requires force argument for DELETE /wp/v2/<taxonomy>/<id>.
\n
(props @danielbachhuber, #2028)
\n
\n
Conditionally requires and defines REST API classes and functions.
\n
(props @danielbachhuber, #2023, #2024)
\n
\n
Avoid a duplicate query for the comment count.
\n
(props @rmccue, #2015)
\n
\n
Parses $date if available in prepare_date_response()
\n
(props @adamsilverstein, #1951)
\n
\n
Abstracts POST /wp/v2/media permissions check.
\n
(props @danielbachhuber, #2003)
\n
\n
Adds exclude param to getting collections of Posts, Users, Comments, and Taxonomy Terms.
\n
(props @danielbachhuber, #1998, #1999, #2000, #2002)
\n
\n
Adds rest_comment_query for filtering GET /wp/v2/comments.
\n
(props @danielbachhuber, #2007)
\n
\n
Uses HTTP status code 500 for db_update_error when creating an attachment.
\n
(props @danielbachhuber, #1993)
\n
\n
Adds helpful description to force param across all DELETE registrations
\n
(props @danielbachhuber, #2004, #2027)
\n
\n
In GET /wp/v2/<taxonomy>, drops support for orderby=>term_id.
\n
Only one id is exposed through the REST API.
\n
(props @danielbachhuber, #1990)
\n

2.0 Beta 10.0 (January 11, 2016)

\n
SECURITY: Ensure media of private posts are private too.
\n
Reported by @danielbachhuber on 2016-01-08.
\n
\n
BREAKING CHANGE: Removes compatibility repo for WordPress 4.3.
\n
WordPress 4.4 is now the minimum supported WordPress version.
\n
(props @danielbachhuber, #1848)
\n
\n
BREAKING CHANGE: Changes link relation for types and taxonomies.
\n
In Beta 9, this link relation was introduced as item, which isn’t correct. The relation has been changed to https://api.w.org/items.
\n
(props @danielbachhuber, #1853)
\n
\n
BREAKING CHANGE: Introduces edit context for wp/v2/types and wp/v2/taxonomies.
\n
Some fields have moved into this context, which require edit_posts and manage_terms, respectively.
\n
(props @danielbachhuber, #1894, #1864)
\n
\n
BREAKING CHANGE: Removes post_format as a term _link for Posts.
\n
Post formats aren’t a custom taxonomy in the eyes of the REST API.
\n
(props @danielbachhuber, #1854)
\n
\n
Declares parent query param for Pages.
\n
(props @danielbachhuber, #1975)
\n
\n
Permits logged-in users to query for media.
\n
(props @danielbachhuber, #1973)
\n
\n
Removes duplicated query params from Terms controller.
\n
(props @danielbachhuber, #1963)
\n
\n
Adds include param to /wp/v2/posts, /wp/v2/users, /wp/v2/<taxonomy> and /wp/v2/comments.
\n
(props @danielbachhuber, #1961, #1964, #1968, #1971)
\n
\n
Ensures GET /wp/v2/posts respects order and orderby params.
\n
(props @danielbachhuber, #1962)
\n
\n
Fixes fatal by loading wp-admin/includes/user.php to expose wp_delete_user().
\n
(props @danielbachhuber, #1958)
\n
\n
Permits making a post sticky when also supplying an empty password.
\n
(props @westonruter, #1949)
\n
\n
Uses WP_REST_Request internally across controllers.
\n
(props @danielbachhuber, #1933, #1939, #1934, #1938)
\n
\n
Cleans up permissions checks in WP_REST_Terms_Controller.
\n
(props @danielbachhuber, #1941)
\n
\n
Uses show_in_rest to determine publicness for post types.
\n
(props @danielbachhuber, #1942)
\n
\n
Makes description strings available for translation.
\n
(props @danielbachhuber, #1944)
\n
\n
Checks assign_terms cap for taxonomy when managing post terms.
\n
(props @danielbachhuber, #1940)
\n
\n
Defer to edit_posts of the custom post type when accessing private query vars.
\n
(props @danielbachhuber, #1886)
\n
\n
Allows Terms collection params to be filtered.
\n
(props @rachelbaker, #1882)
\n
\n
Renames post terms create/delete permissions callback.
\n
(props @wpsmith, #1923)
\n
\n
Fixes invalid use of ‘uri’ as schema type.
\n
(props @wpsmith, #1913)
\n
\n
Casts integer with (int) over intval for speed.
\n
(props @wpsmith, #1907)
\n
\n
Fixes PHP Doc typo for validate_schema_property and sanitize_schema_property.
\n
(props @wpsmith, @danielbachhuber, #1909, #1910)
\n
\n
Adds a helpful description to the filter argument.
\n
(props @danielbachhuber, #1885)
\n
\n
Changes order of Users response to match schema order.
\n
(props @rachelbaker, #1879)
\n
\n
Adjusts Posts pagination headers for filter params.
\n
(props @rachelbaker, #1878)
\n
\n
Uses proper status code when failing to get comments of private post.
\n
(props @danielbachhuber, #1866)
\n
\n
Fixes invalid capability for comments get items permissions callback.
\n
manage_comments doesn’t exist; moderate_comments does.
\n
(props @danielbachhuber, #1866)
\n
\n
Permits creating comments without an assigned post.
\n
(props @danielbachhuber, #1857)
\n
\n
Prevents error notice when show_in_rest isn’t set for a post type.
\n
(props @danielbachhuber, #1852)
\n

2.0 Beta 9.0 (December 11, 2015)

\n
BREAKING CHANGE: Move tags and categories to top-level endpoints.
\n
Tags are now accessible at /wp/v2/tags, and categories accessible at /wp/v2/categories. Post terms reside at /wp/v2/posts/<id>/tags and /wp/v2/<id>/categories.
\n
(props @danielbachhuber, #1802)
\n
\n
BREAKING CHANGE: Return object for requests to /wp/v2/taxonomies.
\n
This is consistent with /wp/v2/types and /wp/v2/statuses.
\n
(props @danielbachhuber, #1825)
\n
\n
BREAKING CHANGE: Remove rest_get_timezone().
\n
json_get_timezone() was only ever used in v1. This function causes fatals, and shouldn’t be used.
\n
(props @danielbachhuber, #1823)
\n
\n
BREAKING CHANGE: Rename register_api_field() to register_rest_field().
\n
Introduces a register_api_field() function for backwards compat, which calls _doing_it_wrong(). However, register_api_field() won’t ever be committed to WordPress core, so you should update your function calls.
\n
(props @danielbachhuber, #1824)
\n
\n
BREAKING CHANGE: Change taxonomies’ post_type argument to type.
\n
It’s consistent with how we’re exposing post types in the API.
\n
(props @danielbachhuber, #1824)
\n
\n
Sync infrastructure with shipped in WordPress 4.4.
\n
- wp-includes/rest-api/rest-functions.php is removed, and its functions moved into wp-includes/rest-api.php.
- Send nocache headers for REST requests. #34832
- Fix handling of HEAD requests. #34837
- Mark WP_REST_Server::get_raw_data() as static. #34768
- Unabbreviate error string. #34818
\n
\n
Change terms endpoints to use term_id not tt_id.
\n
(props @joehoyle, #1837)
\n
\n
Standardize declaration of context param for GET requests across controllers.
\n
However, we’re still inconsistent in which controllers expose which params. Follow #1845 for further discussion.
\n
(props @danielbachhuber, #1795, #1835, #1838)
\n
\n
Link types / taxonomies to their collections, and vice versa.
\n
Collections link to their type / taxonomy with the about relation; types / taxonomies link to their colletion with the item relation, which is imperfect and may change in the future.
\n
(props @danielbachhuber, #1814, #1817, #1829. #1846)
\n
\n
Add missing ‘wp/v2’ in Location Response header when creating new Post Meta.
\n
(props @johanmynhardt, #1790)
\n
\n
Expose Post collection query params, including author, order, orderby and status.
\n
(props @danielbachhuber, #1793)
\n
\n
Ignore sticky posts by default.
\n
(props @danielbachhuber, #1801)
\n
\n
Include full image size in attachment sizes attribute.
\n
(props @danielbachhuber, #1806)
\n
\n
In text strings, use id instead of ID.
\n
ID is an implementation artifact. Our Resources use id.
\n
(props @danielbachhuber, #1803)
\n
\n
Ensure attachment.sizes[] use mime_type instead of mime-type.
\n
(props @danielbachhuber, #1809)
\n
\n
Introduce rest_authorization_required_code().
\n
Many controllers returned incorrect HTTP codes, which this also fixes.
\n
(props @danielbachhuber, #1808)
\n
\n
Respect core’s comment_registration setting.
\n
If it’s enabled, require users to be logged in to comment.
\n
(props @danielbachhuber, #1826)
\n
\n
Default to wildcard when searching users.
\n
(props @danielbachhuber, #1827)
\n
\n
Bring the wp-api.js library up to date for v2 of the REST API.
\n
(props @adamsilverstein, #1828)
\n
\n
Add rest_prepare_status filter.
\n
(props @danielbachhuber, #1830)
\n
\n
Make prepare_* filters more consistent.
\n
(props @danielbachhuber, #1831)
\n
\n
Add rest_prepare_post_type filter for post types.
\n
(props @danielbachhuber, #1833)
\n

2.0 Beta 8.0 (December 1, 2015)

\n
Prevent fatals when uploading attachment by including admin utilities.
\n
(props @danielbachhuber, #1756)
\n
\n
Return 201 status code when creating a term.
\n
(props @danielbachhuber, #1753)
\n
\n
Don’t permit requesting terms cross routes.
\n
Clients should only be able to request categories from the category route, and tags from the tag route.
\n
(props @danielbachhuber, #1764)
\n
\n
Set fields=>id when using WP_User_Query to fix large memory usage
\n
(props @joehoyle, #1770)
\n
\n
Fix Post _link to attached attachments.
\n
(props @danielbachhuber, #1777)
\n
\n
Add support for getting a post with a custom public status.
\n
(props @danielbachhuber, #1765)
\n
\n
Ensure post content doesn’t get double-slashed on update.
\n
(props @joehoyle, #1772)
\n
\n
Change ‘int’ to ‘integer’ for WP_REST_Controller::validate_schema_property()
\n
(props @wpsmith, #1759)
\n

2.0 Beta 7.0 (November 17, 2015)

\n
Sync infrastructure from WordPress core as of r35691.
\n
- Remove register_api_field() because it’s conceptually tied to WP_REST_Controller #34730
- Update the REST API header links to use api.w.org #34303
- Require the $namespace argument in register_rest_route() #34416
- Include enum and description in help data #34543
- Save preg_match iterations in WP_REST_Server #34488
- Don’t return route URL in WP_REST_Request:get_params() #34647
\n
\n
Restore register_api_field() within the plugin.
\n
(props @danielbachhuber, #1748)
\n
\n
Require admin functions for use of wp_handle_upload(), fixing fatal.
\n
(props @joehoyle, #1746)
\n
\n
Properly handle requesting terms where parent=0 and 0 is a string.
\n
(props @danielbachhuber, #1739)
\n
\n
Prevent PHP error notice when &filter isn’t an array.
\n
(props @danielbachhuber, #1734)
\n
\n
Change link relations to use api.w.org.
\n
(props @danielbachhuber, #1726)
\n

2.0 Beta 6.0 (November 12, 2015)

\n
Remove global inclusion of wp-admin/includes/admin.php
\n
For a long time, the REST API loaded wp-admin/includes/admin.php to make use of specific admin utilities. Now, it only loads those admin utilities when it needs them.
\n
If your custom endpoints make use of admin utilities, you’ll need to make sure to load wp-admin/includes/admin.php before you use them.
\n
(props @joehoyle, #1696)
\n
\n
Link directly to the featured image in a Post’s links.
\n
(props @rmccue, #1563, #1711)
\n
\n
Provide object type as callback argument for custom API fields.
\n
(props @jtsternberg, #1714)
\n
\n
Change users schema order to be order of importance instead of alpha.
\n
(props @rachelbaker, #1708)
\n
\n
Clarify documentation for date and modified attributes.
\n
(props @danielbachhuber, #1715)
\n
\n
Update the wp-api.js client from the client-js repo.
\n
(props @rachelbaker, #1709)
\n
\n
Fix the format enum to be an array of strings.
\n
(props @joehoyle, #1707)
\n
\n
Run revisions for collection through prepare_response_for_collection().
\n
(props @danielbachhuber, @rachelbaker, #1671)
\n
\n
Expose date_gmt for view context of Posts and Comments.
\n
(props @danielbachhuber, #1690)
\n
\n
Fix PHP and JS docblock formatting.
\n
(props @ahmadawais, #1699, #1699, #1701, #1700, #1702, #1703)
\n
\n
Include media_details attribute for attachments in embed context.
\n
For image attachments, media_details includes a sizes array of image sizes, which is useful for templating.
\n
(props @danielbachhuber, #1667)
\n
\n
Make WP_REST_Controller error messages more helpful by specifying method to subclass.
\n
(props @danielbachhuber, #1670)
\n
\n
Expose slug in embed context for Users.
\n
user_nicename is a public attribute, used in user URLs, so this is safe data to present.
\n
(props @danielbachhuber, #1666)
\n
\n
Handle falsy value from wp_count_terms(), fixing fatal.
\n
(props @joehoyle, #1641)
\n
\n
Correct methods in WP_REST_SERVER::EDITABLE description.
\n
(props @rachelbaker, #1601)
\n
\n
Add the embed context to Users collection query params.
\n
(props @rachelbaker, #1591)
\n
\n
Add Terms Controller collection args details.
\n
(props @rachelbaker, #1603)
\n
\n
Set comment author details from current user.
\n
(props @rmccue, #1580)
\n
\n
More hook documentation.
\n
(props @adamsilverstein, #1556, #1560)
\n
\n
Return the trashed status of deleted posts/comments.
\n
When a post or a comment is deleted, returns a flag to say whether it’s been trashed or properly deleted.
\n
(props @pento, #1499)
\n
\n
In WP_REST_Posts_Controller::update_item(), check the post ID based on the proper post type.
\n
(props @rachelbaker, #1497)
\n

2.0 Beta 5.0 (October 23, 2015)

\n
Load api-core as a compatibility library
\n
Now api-core has been merged into WordPress trunk (for 4.4) we should no longer load the infrastructure code when it’s already available. This also fixes a fatal error for users who were on trunk.
\n
(props @rmccue)
\n
\n
Switch to new mysql_to_rfc3339
\n
(props @rmccue)
\n
\n
Double-check term taxonomy
\n
(props @rmccue)
\n
\n
Load admin functions
\n
This was removed from the latest beta of WordPress in the REST API infrastructure, a more long term fix is planned.
\n
(props @joehoyle)
\n
\n
Add Add compat shim for renamed rest_mysql_to_rfc3339()
\n
(props @danielbachhuber)
\n
\n
Compat shim for wp_is_numeric_array()
\n
(props @danielbachhuber)
\n
\n
Revert Switch to register_post_type_args filter
\n
(props @joehoyle)
\n

2.0 Beta 4.0 (August 14, 2015)

\n
Show public user information through the user controller.
\n
In WordPress as of r32683 (scheduled for 4.3), WP_User_Query now has support for getting users with published posts.
\n
To match current behaviour in WordPress themes and feeds, we now expose this public user information. This includes the avatar, description, user ID, custom URL, display name, and URL, for users who have published at least one post on the site. This information is available to all clients; other fields and data for all users are still only available when authenticated.
\n
(props @joehoyle, @rmccue, @Shelob9, #1397, #839, #1435)
\n
\n
Send schema in OPTIONS requests and index.
\n
Rather than using separate /schema endpoints, the schema for items is now available through an OPTIONS request to the route. This means that full documentation is now available for endpoints through an OPTIONS request; this includes available methods, what data you can pass to the endpoint, and the data you’ll get back.
\n
This data is now also available in the main index and namespace indexes. Simply request the index with context=help to get full schema data. Warning: this response will be huge. The schema for single endpoints is also available in the collection’s OPTIONS response.
\n
⚠️ This breaks backwards compatibility for clients relying on schemas being at their own routes. These clients should instead send OPTIONS requests.
\n
Custom endpoints can register their own schema via the schema option on the route. This option should live side-by-side with the endpoints (similar to relation in WP’s meta queries), so your registration call will look something like:
\n
`php
\nregister_rest_route( ‘test-ns’, ‘/test’, array(
\narray(
\n ‘methods’ => ‘GET’,
\n ‘callback’ => ‘my_test_callback’,
\n),
\n
‘schema’ => ‘my_schema_callback’,
\n) );
\n `
\n
(props @rmccue, #1415, #1222, #1305)
\n
\n
Update JavaScript API for version 2.
\n
Our fantastic JavaScript API from version 1 is now available for version 2, refreshed with the latest and greatest changes.
\n
As a refresher: if you want to use it, simply make your script depend on wp-api when you enqueue it. If you want to enqueue the script manually, add wp_enqueue_script( 'wp-api' ) to a callback on wp_enqueue_scripts.
\n
(props @tlovett1, @kadamwhite, @nathanrice, #1374, #1320)
\n
\n
Embed links inside items in a collection.
\n
Previously when fetching a collection of items, you only received the items themselves. To fetch the links as well via embedding, you needed to make a request to the single item with _embed set.
\n
No longer! You can now request a collection with embeds enabled (try /wp/v2/posts?_embed). This will embed links inside each item, allowing you to build interface items much easier (for example, post archive pages can get featured image data at the same time).
\n
This also applies to custom endpoints. Any endpoint that returns a list of objects will automatically have the embedding applied to objects inside the list.
\n
(props @rmccue, #1459, #865)
\n
\n
Fix potential XSS vulnerability.
\n
Requests from other origins could potentially run code on the API domain, allowing cross-origin access to authentication cookies or similar.
\n
Reported by @xknown on 2015-07-23.
\n
\n
Move /posts WP_Query vars back to filter param.
\n
In version 1, we had internal WP_Query vars available via filter (e.g. filter[s]=search+term). For our first betas of version 2, we tried something different and exposed these directly on the endpoint. The experiment has now concluded; we didn’t like this that much, so filter is back.
\n
We plan on adding nicer looking arguments to collections in future releases, with a view towards being consistent across different collections. We also plan on opening up the underlying query vars via filter for users, comments, and terms as well.
\n
⚠️ This breaks backwards compatibility for users using WP Query vars. Simply change your x=y parameter to filter[x]=y.
\n
(props @WP-API, #1420)
\n
\n
Respect rest_base for taxonomies.
\n
⚠️ This breaks backwards compatibility by changing the /wp/v2/posts/{id}/terms/post_tag endpoint to /wp/v2/posts/{id}/tag.
\n
(props @joehoyle, #1466)
\n
\n
Add permission check for retrieving the posts collection in edit context.
\n
By extension of the fact that getting any individual post yields a forbidden context error when the context=edit and the user is not authorized, the user should also not be permitted to list any post items when unauthorized.
\n
(props @danielpunkass, #1412)
\n
\n
Ensure the REST API URL always has a trailing slash.
\n
Previously, when pretty permalinks were enabled, the API URL during autodiscovery looked like /wp-json, whereas the non-pretty permalink URL looked like ?rest_route=/. These are now consistent, and always end with a slash character to simplify client URL building.
\n
(props @danielpunkass, @rmccue, #1426, #1442, #1455, #1467)
\n
\n
Use wp_json_encode instead of json_encode
\n
Since WordPress 4.1, wp_json_encode has been available to ensure encoded values are sane, and that non-UTF8 encodings are supported. We now use this function rather than doing the encode ourselves.
\n
(props @rmccue, @pento, #1417)
\n
\n
Add role to schema for users.
\n
The available roles you can assign to a user are now available in the schema as an enum.
\n
(props @joehoyle, #1400)
\n
\n
Use the schema for validation inside the comments controller.
\n
Previously, the schema was merely a decorative element for documentation inside the comments controller. To bring it inline with our other controllers, the schema is now used internally for validation.
\n
(props @joehoyle, #1422)
\n
\n
Don’t set the Location header in update responses.
\n
Previously, the Location header was sent when updating resources due to some inadvertent copypasta. This header should only be sent when creating to direct clients to the new resource, and isn’t required when you’re already on the correct resource.
\n
(props @rachelbaker, #1441)
\n
\n
Re-enable the rest_insert_post action hook for WP_REST_Posts_Controller
\n
This was disabled during 2.0 development to avoid breaking lots of plugins on the json_insert_post action. Now that we’ve changed namespaces and are Mostly Stable ™, we can re-enable the action.
\n
(props @jaredcobb, #1427, #1424)
\n
\n
Fix post taxonomy terms link URLs.
\n
When moving the routes in a previous beta, we forgot to correct the links on post objects to the new correct route. Sorry!
\n
(props @rachelbaker, @joehoyle, #1447, #1383)
\n
\n
Use wp_get_attachment_image_src() on the image sizes in attachments.
\n
Since the first versions of the API, we’ve been building attachment URLs via str_replace. Who knows why we were doing this, but it caused problems with custom attachment URLs (such as CDN-hosted images). This now correctly uses the internal functions and filters.
\n
(props @joehoyle, #1462)
\n
\n
Make the embed context a default, not forced.
\n
If you want embeds to bring in full data rather than with context=edit, you can now change the link to specify context=view explicitly.
\n
(props @rmccue, #1464)
\n
\n
Ensure we always use the term_taxonomy_id and never expose term_id publicly.
\n
Previously, term_id was inadvertently exposed in some error responses.
\n
(props @jdolan, #1430)
\n
\n
Fix adding alt text to attachments on creation.
\n
Previously, this could only be set when updating an attachment, not when creating one.
\n
(props @joehoyle, #1398)
\n
\n
Throw an error when registering routes without a namespace.
\n
Namespaces should always be provided when registering routes. We now throw a doing_it_wrong error when attempting to register one. (Previously, this caused a warning, or an invalid internal route.)
\n
If you really need to register namespaceless routes (e.g. to replicate an existing API), call WP_REST_Server::register_route directly rather than using the convenience function.
\n
(props @joehoyle, @rmccue, #1355)
\n
\n
Show links on embeds.
\n
Previously, links were accidentally stripped from embedded response data.
\n
(props @rmccue, #1472)
\n
\n
Clarify insufficient permisssion error when editing posts.
\n
(props @danielpunkass, #1411)
\n
\n
Improve @return inline docs for rest_ensure_response()
\n
(props @Shelob9, #1328)
\n
\n
Check taxonomies exist before trying to set properties.
\n
(props @joehoyle, @rachelbaker, #1354)
\n
\n
Update controllers to ensure we use sanitize_callback wherever possible.
\n
(props @joehoyle, #1399)
\n
\n
Add more phpDoc documentation, and correct existing documentation.
\n
(props @Shelob9, @rmccue, #1432, #1433, #1465)
\n
\n
Update testing infrastructure.
\n
Travis now runs our coding standards tests in parallel, and now uses the new, faster container-based testing infrastructure.
\n
(props @ntwb, @frozzare, #1449, #1457)
\n

View all changes

2.0 Beta 3.0 (July 1, 2015)

\n
Add ability to declare sanitization and default options for schema fields.
\n
The arg_options array can be used to declare the sanitization callback,
\ndefault value, or requirement of a field.
\n
(props @joehoyle, #1345)
\n(props @joehoyle, #1346)
\n
\n
Expand supported parameters for creating and updating Comments.
\n
(props @rachelbaker, #1245)
\n
\n
Declare collection parameters for Terms of a Post.
\n
Define the available collection parameters in get_collection_params() and
\nallow Terms of a Post to be queried by term order.
\n
(props @danielbachhuber, #1332)
\n
\n
Improve the Attachment error message for an invalid Content-Disposition
\n
(props @danielbachhuber, #1317)
\n
\n
Return 200 status when updating Attachments, Comments, and Users.
\n
(props @rachelbaker, #1348)
\n
\n
Remove unnecessary handle_format_param() method.
\n
(props @danielbachhuber, #1331)
\n
\n
Add author_avatar_url field to the Comment response and schema.
\n
(props @rachelbaker #1327)
\n
\n
Introduce rest_do_request() for making REST requests internally.
\n
(props @danielbachhuber, #1333)
\n
\n
Remove unused DateTime class.
\n
(props @rmccue, #1314)
\n
\n
Add inline documentation for $wp_rest_server global.
\n
(props @Shelob9, #1324)
\n
View all changes
\n
2.0 Beta 2.0 (May 28, 2015)
\n
\n
\n
Load the WP REST API before the main query runs.
\n
The rest_api_loaded function now hooks into the parse_request action.
\nThis change prevents the main query from being run on every request and
\nallows sites to set WP_USE_THEMES to false. Previously, the main query
\nwas always being run (SELECT * FROM wp_posts LIMIT 10), even though the
\nresult was never used and couldn’t be cached.
\n
(props @rmccue, #1270)
\n
\n
Register a new field on an existing WordPress object type.
\n
Introduces register_api_field() to add a field to an object and
\nits schema.
\n
(props @joehoyle, @rachelbaker, #927)
\n(props @joehoyle, #1207)
\n(props @joehoyle, #1243)
\n
\n
Add endpoints for viewing, creating, updating, and deleting Terms for a Post.
\n
The new WP_REST_Posts_Terms_Controller class controller supports routes for
\nTerms that belong to a Post.
\n
(props @joehoyle, @danielbachhuber, #1216)
\n
\n
Add pagination headers for collection queries.
\n
The X-WP-Total and X-WP-TotalPages are now present in terms, comments,
\nand users collection responses.
\n
(props @danielbachhuber, #1182)
\n(props @danielbachhuber, #1191)
\n(props @danielbachhuber, @joehoyle, #1197)
\n
\n
List registered namespaces in the index for feature detection.
\n
The index (/wp-json by default) now contains a list of the available
\nnamespaces. This allows for simple feature detection. You can grab the index
\nand check namespaces for wp/v3 or pluginname/v2, which indicate the
\nsupported endpoints on the site.
\n
(props @rmccue,, #1283)
\n
\n
Standardize link property relations and support embedding for all resources.
\n
Change link properties to use IANA-registered relations. Also adds embedding
\nsupport to Attachments, Comments and Terms.
\n
(props @rmccue, @rachelbaker, #1284)
\n
\n
Add support for Composer dependency management.
\n
Allows you to recursively install/update the WP REST API inside of WordPress
\nplugins or themes.
\n
(props @QWp6t, #1157)
\n
\n
Return full objects in the delete response.
\n
Instead of returning a random message when deleting a Post, Comment, Term, or
\nUser provide the original resource data.
\n
(props @danielbachhuber, #1253)
\n(props @danielbachhuber, #1254)
\n(props @danielbachhuber, #1255)
\n(props @danielbachhuber, #1256)
\n
\n
Return programmatically readable error messages for invalid or missing
\nrequired parameters.
\n
(props @joehoyle, #1175)
\n
\n
Declare supported arguments for Comment and User collection queries.
\n
(props @danielbachhuber, #1211)
\n(props @danielbachhuber, #1217)
\n
\n
Automatically validate parameters based on Schema data.
\n
(props @joehoyle, #1128)
\n
\n
Use the show_in_rest attributes for exposing Taxonomies.
\n
(props @joehoyle, #1279)
\n
\n
Handle parent when creating or updating a Term.
\n
(props @joehoyle, #1221)
\n
\n
Limit fields returned in embed context User responses.
\n
(props @rachelbaker, #1251)
\n
\n
Only include parent in term response when tax is hierarchical.
\n
(props @danielbachhuber, #1189)
\n
\n
Fix bug in creating comments if type was not set.
\n
(props @rachelbaker, #1244)
\n
\n
Rename post_name field to post_slug.
\n
(props @danielbachhuber, #1235)
\n
\n
Add check when creating a user to verify the provided role is valid.
\n
(props @rachelbaker, #1267)
\n
\n
Add link properties to the Post Status response.
\n
(props @joehoyle, #1243)
\n
\n
Return 0 for parent in Post response instead of null.
\n
(props @danielbachhuber, #1269)
\n
\n
Only link author when there’s a valid author
\n
(props @danielbachhuber, #1203)
\n
\n
Only permit querying by parent term when tax is hierarchical.
\n
(props @danielbachhuber, #1219)
\n
\n
Only permit deleting posts of the proper type
\n
(props @danielbachhuber, #1257)
\n
\n
Set pagination headers even when no found posts.
\n
(props @danielbachhuber, #1209)
\n
\n
Correct prefix in rest_request_parameter_order filter.
\n
(props @quasel, #1158)
\n
\n
Retool WP_REST_Terms_Controller to follow Posts controller pattern.
\n
(props @danielbachhuber, #1170)
\n
\n
Remove unused accept_json argument from the register_routes method.
\n
(props @quasel, #1160)
\n
\n
Fix typo in sanitize_params inline documentation.
\n
(props @Shelob9, #1226)
\n
\n
Remove commented out code in dispatch method.
\n
(props @rachelbaker, #1162)
\n

View all changes

2.0 Beta 1.1

\n
Fix user access security vulnerability.
\n
Authenticated users were able to escalate their privileges bypassing the
\nexpected capabilities check.
\n
Reported by @kacperszurek on 2015-05-16.
\n

2.0 Beta 1 (April 28, 2015)

Partial rewrite and evolution of the REST API to prepare for core integration.

For versions 0.x through 1.x, see the legacy plugin changelog.

\n","faq":"\n

Installation Instructions

Install the WP REST API via the plugin directory, or by uploading the files manually to your server.

For full-flavoured API support, you’ll need to be using pretty permalinks to use the plugin, as it uses custom rewrite rules to power the API.

Once you’ve installed and activated the plugin, check out the documentation for details on your newly available endpoints.

\n\n"},"short_description":"Access your site's data through an easy-to-use HTTP REST API. (Version 2)","download_link":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta15.zip","screenshots":[],"tags":{"api":"api","json":"JSON","rest":"rest","rest-api":"rest-api"},"versions":{"2.0-beta10":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta10.zip","2.0-beta11":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta11.zip","2.0-beta12":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta12.zip","2.0-beta12.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta12.1.zip","2.0-beta13":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta13.zip","2.0-beta13.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta13.1.zip","2.0-beta14":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta14.zip","2.0-beta15":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta15.zip","2.0-beta3":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta3.zip","2.0-beta3.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta3.1.zip","2.0-beta4":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta4.zip","2.0-beta4.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta4.1.zip","2.0-beta5":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta5.zip","2.0-beta5.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta5.1.zip","2.0-beta6":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta6.zip","2.0-beta6.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta6.1.zip","2.0-beta7":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta7.zip","2.0-beta7.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta7.1.zip","2.0-beta8":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta8.zip","2.0-beta8.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta8.1.zip","2.0-beta9":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta9.zip","2.0-beta9.1":"https://downloads.wordpress.org/plugin/rest-api.2.0-beta9.1.zip","trunk":"https://downloads.wordpress.org/plugin/rest-api.zip"},"donate_link":"","icons":{"1x":"https://ps.w.org/rest-api/assets/icon-128x128.png?rev=1346297","2x":"https://ps.w.org/rest-api/assets/icon-256x256.png?rev=1346297"}}]

Project Bible 2.0

Bible Editions Available

System Requirements

Adapting the Layout

Workaround: Adapt your Theme Stylesheet

Workaround: Adapt the Plugin Output

Further Examples

For WordPress Developers

Plugin License

License for Bible Texts (got remotely per day)

License for Related Bible References (got remotely per day)

0.9

0.8

0.7

0.6

0.5

0.4

0.3

0.2

0.1

স্বয়ংক্রিয়:

নিজেরমতো করে:

১.২

১.১

১.০

2.0 Beta 15.0 (October 07, 2016)

2.0 Beta 13.0 (March 29, 2016)

2.0 Beta 12.0 (February 9, 2016)

2.0 Beta 11.0 (January 25, 2016)

2.0 Beta 10.0 (January 11, 2016)

2.0 Beta 9.0 (December 11, 2015)

2.0 Beta 8.0 (December 1, 2015)

2.0 Beta 7.0 (November 17, 2015)

2.0 Beta 6.0 (November 12, 2015)

2.0 Beta 5.0 (October 23, 2015)

2.0 Beta 4.0 (August 14, 2015)

2.0 Beta 3.0 (July 1, 2015)

2.0 Beta 2.0 (May 28, 2015)

2.0 Beta 1.1

2.0 Beta 1 (April 28, 2015)

Installation Instructions

1971

The Word Widget

একাত্তর | ekattor

WordPress REST API (Version 2)

Get New Themes & Resources