Author: briantest

  • What the classic editor left behind

    What the classic editor left behind

    WordPress has shipped a content REST API in core since version 4.7, released on 6 December 2016. Any post, page or registered custom type can be read and written over HTTP under /wp-json/wp/v2/, with no plugin involved. That single fact is what makes an external tool able to edit a site it does not host.

    An application password is a per-application credential, separate from the account password, which can be revoked on its own without locking the person out. WordPress 5.6 added them on 8 December 2020, and they only work over HTTPS. Before that release, editing a self-hosted site over the API meant installing an authentication plugin or writing one.

    Two more releases matter to anything that reads a site from the outside. WordPress 5.0 replaced the classic editor with the block editor on 6 December 2018, which is why post content now arrives wrapped in HTML comments that mark where each block starts and ends. WordPress 5.5 added an XML sitemap at /wp-sitemap.xml on 11 August 2020, so most sites now advertise their own URLs without a plugin.

    The sharpest limit is one the documentation states plainly and people still meet by surprise. A meta field whose key begins with an underscore is treated as protected, and WordPress does not expose it through the REST API unless a plugin registers it with show_in_rest. A page builder that stores its layout under a key like _elementor_edit_mode is therefore invisible to an API client, even though the site renders from it.

    The practical consequence is that reading post_content is not the same as reading the page.

    • Pretty permalinks, or /wp-json/ answers 404 and only ?rest_route= works.
    • HTTPS, which application passwords require.
    • A user with edit_posts, since the API maps capabilities per post type.

    Read the full guide

  • Publishing to WordPress over the REST API

    What the REST API can and cannot reach

    WordPress has shipped a content REST API in core since version 4.7, released on 6 December 2016. Any post, page or registered custom type can be read and written over HTTP under /wp-json/wp/v2/, with no plugin involved. That single fact is what makes an external tool able to edit a site it does not host.

    An application password is a per-application credential, separate from the account password, which can be revoked on its own without locking the person out. WordPress 5.6 added them on 8 December 2020, and they only work over HTTPS. Before that release, editing a self-hosted site over the API meant installing an authentication plugin or writing one.

    Two more releases matter to anything that reads a site from the outside. WordPress 5.0 replaced the classic editor with the block editor on 6 December 2018, which is why post content now arrives wrapped in HTML comments that mark where each block starts and ends. WordPress 5.5 added an XML sitemap at /wp-sitemap.xml on 11 August 2020, so most sites now advertise their own URLs without a plugin.

    The sharpest limit is one the documentation states plainly and people still meet by surprise. A meta field whose key begins with an underscore is treated as protected, and WordPress does not expose it through the REST API unless a plugin registers it with show_in_rest. A page builder that stores its layout under a key like _elementor_edit_mode is therefore invisible to an API client, even though the site renders from it.

    The practical consequence is that reading post_content is not the same as reading the page.

    • Pretty permalinks, or /wp-json/ answers 404 and only ?rest_route= works.
    • HTTPS, which application passwords require.
    • A user with edit_posts, since the API maps capabilities per post type.
    How an answer engine reads a page
    The read is whole-page, not keyword-by-keyword.

    SignalWeight
    Dated statisticsHigh
    Named comparisonsHigh
    Brand adjectivesLow

    See it on your own site

    A short walkthrough on your top twenty pages, no account needed.

  • Thrive fixture

    Most teams still write for a reader who arrives from a list of blue links. That reader is becoming the minority. An answer engine reads the whole page, decides which claims it can stand behind, and then reproduces a version of your argument without ever sending the visit. The page still did its job, but nothing in your analytics says so.

    What survives that process is unglamorous. Specific numbers with a date attached. Definitions written plainly enough to lift. Comparisons that name the alternatives instead of gesturing at them. The prose that reads best to a human skimming on a phone is often the prose a model discards first, because it carries no facts it can attribute.

    The practical consequence is that refreshing a page is no longer a matter of adding keywords. It is a matter of making the claims you already believe legible: pulling the figure out of the paragraph, giving the definition its own sentence, and saying when the number was true. None of that requires a redesign, and all of it requires touching the words rather than the layout.

    That distinction is the whole reason this rig exists. A refresh that improves the words and destroys the layout has not helped anyone, and a publish that reports success while changing nothing a visitor sees is worse than no publish at all.Enter your text here…

  • Hello world!

    Welcome to WordPress. This is your first post. Edit or delete it, then start writing!