WordPress Abilities API: de grootste architectuurwijziging in jaren

Waarom WordPress een Abilities API nodig had

WordPress is meer dan 20 jaar organisch gegroeid. Dat is zowel de kracht als de zwakte van het platform.

"WordPress is twenty-plus years of people building whatever they want, in whatever way made sense at the time. That's its strength. But when you try to put an agent on top of it, you immediately feel the downside: there is no real unification."²

Neem een simpel voorbeeld: vertaalfunctionaliteit. In een typische WordPress-installatie kan dit verspreid zijn over:

• REST API endpoints van vertalingsplugins
• Custom AJAX handlers
• Losse PHPKeurigOnline zegtPHPPHP (Hypertext Preprocessor) is een populaire open-source scripttaal die speciaal is ontworpen voor webontwikkeling en server-side programmering.-functies in themes
• JavaScriptKeurigOnline zegtJavaScriptJavaScript is een programmeertaal die wordt gebruikt om interactieve en dynamische websites te maken. APIs in de editor

Er is geen gestandaardiseerde manier om te ontdekken wát een WordPress-site kan en hóe je die functionaliteit aanspreekt. Dit is geen probleem voor mensen — wij navigeren door menu's en interfaces. Maar voor machines? Voor AI-agents die autonome taken uitvoeren? Die lopen vast.

Het WPAI-verhaal

De oorsprong van de Abilities API ligt bij een kleine startup. Ongeveer drie jaar geleden probeerden James LePage en Greg Hunt met WPAI om AI-agents te bouwen die WordPress-sites konden beheren.²

Ze liepen tegen een muur aan: er was geen uniforme manier om te ontdekken wat WordPress kan. Elke plugin deed dingen op zijn eigen manier. Elke site was een unieke puzzel.

Na de overname door Automattic evolueerde dit inzicht naar een interne "Feature API". Maar die was Automattic-specifiek, niet ontworpen voor WordPress core. In 2025, met de oprichting van het WordPress Core AI Team, besloten ze de Feature API te deprecaten en vanaf nul te beginnen met de Abilities API.²

De Abilities API uitgelegd

Denk aan de Abilities API als een telefoonboek voor WordPress-functionaliteit. In plaats van overal te zoeken naar wat je site kan, vraag je gewoon het register: "Wat kan deze site allemaal?"

De drie componenten

De Abilities API bestaat uit drie kerncomponenten:¹

1. PHP API — Functies voor het registreren, beheren en uitvoeren van abilities
2. REST API Endpoints — Automatische exposure onder de wp-abilities/v1 namespace
3. Hooks — Nieuwe action/filter hooks voor integratie

Naming convention

Abilities volgen een strict namespaced formaat: namespace/ability-name. Dit voorkomt conflicten tussen plugins en maakt het duidelijk waar een ability vandaan komt.³

Best practices voor naamgeving:

• Gebruik alleen lowercase letters, cijfers, streepjes en forward slashes
• Kies actie-georiënteerde namen: process-payment, generate-report
• Wees beschrijvend maar beknopt

Een simpele ability registreren

Zo registreer je een basis ability in PHP:

add_action( 'wp_abilities_api_init', function() {
    wp_register_ability( 'mijn-plugin/vertaal-content', array(
        'label'               => 'Vertaal content',
        'description'         => 'Vertaalt tekst naar een opgegeven taal',
        'category'            => 'content',
        'input_schema'        => array(
            'type'       => 'object',
            'properties' => array(
                'text'   => array( 'type' => 'string' ),
                'target' => array( 'type' => 'string' ),
            ),
            'required'   => array( 'text', 'target' ),
        ),
        'output_schema'       => array(
            'type'       => 'object',
            'properties' => array(
                'translated' => array( 'type' => 'string' ),
            ),
        ),
        'execute_callback'    => 'mijn_vertaal_functie',
        'permission_callback' => function() {
            return current_user_can( 'edit_posts' );
        },
        'meta'                => array(
            'show_in_rest' => true,
        ),
    ) );
} );

De ability is nu beschikbaar via:

• PHP: wp_get_ability( 'mijn-plugin/vertaal-content' )
• REST API: GET /wp-json/wp-abilities/v1/abilities/mijn-plugin/vertaal-content
• Uitvoeren: POST /wp-json/wp-abilities/v1/abilities/mijn-plugin/vertaal-content/run

Abilities als onderdeel van het grotere AI-plaatje

De Abilities API staat niet op zichzelf. Het is één van vier "AI Building Blocks" die het WordPress Core AI Team in 2025 heeft geïntroduceerd.⁴

De vier bouwstenen

Waarom modulair?

Het WordPress-team had kunnen kiezen om AI-functionaliteit direct in core te bouwen. Ze kozen bewust voor een modulaire aanpak met adapters.

De reden: protocol-agnosticiteit. AI-protocollen evolueren snel. MCP (Model Context Protocol) is populair, maar er zijn ook WebMCP, UTCP en Google's A2A.⁵ Door core protocol-agnostisch te houden en adapters te gebruiken, voorkomt WordPress dat het vastloopt als het AI-landschap verandert.

Wat is MCP en waarom is het belangrijk?

Eén van de vier bouwstenen is de MCP Adapter. MCP staat voor Model Context Protocol — een open standaard ontwikkeld door Anthropic voor communicatie tussen AI-systemen en externe tools.⁴

Met MCP kan een AI-assistent (zoals Claude of ChatGPT) ontdekken wat een WordPress-site kan, en die functionaliteit aanroepen. De MCP Adapter vertaalt Abilities automatisch naar het MCP-formaat.

Waarom de REST API niet genoeg is voor AI

Je zou kunnen denken: WordPress heeft al een REST API. Waarom is dat niet voldoende voor AI-integratie?

Er zijn drie fundamentele problemen:

1. Stateless vs. context-aware — REST APIs zijn stateless: elke request staat op zichzelf. AI-agents werken met context over meerdere stappen. Ze moeten weten wat ze eerder gedaan hebben en wat er nog beschikbaar is.
2. Geen discovery-mechanisme — De REST API documenteert wat endpoints doen, maar een AI kan niet automatisch ontdekken welke acties zinvol zijn in een bepaalde context. Abilities bieden semantische metadata (labels, beschrijvingen, categorieën) die AI begrijpt.
3. Documentatie is gescheiden — Bij REST APIs moet documentatie apart gelezen worden. Abilities bevatten hun eigen documentatie in de registratie: input/output schemas, permissies, alles wat een AI nodig heeft om de functie te begrijpen en gebruiken.

Hoe je Abilities gebruikt voor AI

De Abilities APIKeurigOnline zegtAPIEen API (Application Programming Interface) is een set regels en protocollen waarmee softwareapplicaties met elkaar kunnen communiceren en gegevens uitwisselen. ondersteunt drie patronen voor AI-integratie, elk met eigen use cases en complexiteit.⁵

1. Single-shot actions

Het simpelste patroon: één knop, één ability, één resultaat.

Denk aan een "sparkle button" in de WordPress editor. Je selecteert tekst, klikt op het AI-icoon, en de tekst wordt vertaald. Achter de schermen:

1. Gebruiker klikt op knop
2. JavaScript roept de ability aan via REST API
3. Ability voert vertaling uit (mogelijk met AI-provider)
4. Resultaat wordt teruggestuurd en getoond

Dit patroon is ideaal voor gerichte taken waarbij de gebruiker expliciet om AI-hulp vraagt.

2. Agentic loops

Bij agentic loops draait een LLM in een loop en kiest zélf welke abilities aan te roepen om een taak te voltooien.

Het proces werkt als volgt:

1. Je geeft de agent een doel: "Optimaliseer de SEO van deze pagina"
2. De agent krijgt een lijst van beschikbare abilities (via wp_get_abilities())
3. De agent kiest een ability, voert deze uit, analyseert het resultaat
4. Dit herhaalt tot het doel bereikt is

Technisch gebruikt dit het FunctionDeclaration/FunctionCall/FunctionResponse patroon dat ook OpenAI en andere LLM-providers ondersteunen. Abilities kunnen automatisch geconverteerd worden naar FunctionDeclarations dankzij hun JSONKeurigOnline zegtJSONJSON is een lichtgewicht dataformaat voor het uitwisselen van gegevens tussen systemen. Schema definities.⁵

3. Deterministic workflows

Het derde patroon combineert voorspelbaarheid met AI-kracht: een vooraf gedefinieerde keten van abilities (A → B → C), waarbij sommige stappen AI gebruiken en andere puur deterministisch zijn.

Voorbeeld workflow voor content publicatie:

1. Fetch content (deterministisch) — Haal draft post op
2. Generate summary (AI) — Maak korte samenvatting
3. Check spelling (deterministisch) — Controleer spelling
4. Suggest images (AI) — Suggereer passende afbeeldingen
5. Publish (deterministisch) — Publiceer naar site

Dit patroon is krachtiger dan single-shot maar voorspelbaarder dan agentic loops. Je bepaalt de flow, maar AI kan binnen die flow creatief werk doen.

Aan de slag met de Abilities API

De Abilities API is beschikbaar in WordPress 6.9. Hier is hoe je ermee aan de slag gaat.

Installatiemethoden

Er zijn drie manieren om de API te gebruiken:⁷

1. WordPress 6.9+ — De API zit in core, geen actie nodig
2. ComposerKeurigOnline zegtComposerComposer is een dependency manager voor PHP die het beheer van externe bibliotheken en afhankelijkheden in projecten automatiseert. package — composer require wordpress/abilities-api
3. GitHubKeurigOnline zegtGithubGitHub is een cloudplatform voor versiebeheer en samenwerking aan softwareprojecten met Git. release — Download de plugin van de releases page

Backward compatibility check

Als je plugin ook oudere WordPressKeurigOnline zegtWordPressWordPress is een open-source contentmanagementsysteem (CMS) geschreven in PHP, waarmee je eenvoudig websites en blogs kunt bouwen en beheren. versies moet ondersteunen, controleer dan of de API beschikbaar is:

if ( function_exists( 'wp_register_ability' ) ) {
    // Abilities API is beschikbaar
    add_action( 'wp_abilities_api_init', 'register_mijn_abilities' );
} else {
    // Fallback voor oudere WordPress versies
}

REST API endpoints

De volgende endpoints zijn beschikbaar wanneer show_in_rest is ingeschakeld:¹

Testen met WP-CLI

WP-CLIKeurigOnline zegtWP-CLIWP-CLI is de command line interface voor WordPress waarmee ontwikkelaars WordPress beheren via de terminal. is handig om abilities te testen:

# Lijst alle abilities
wp abilities list

# Bekijk details van een ability
wp abilities get mijn-plugin/vertaal-content

# Voer een ability uit
wp abilities run mijn-plugin/vertaal-content --input='{"text":"Hello","target":"nl"}'

Wat we verwachten van WordPress als AI-platform

De Abilities API is pas het begin. Op basis van de officiële roadmap en onze analyse verwachten we de volgende ontwikkelingen.

WordPress 7.0: AI in core

Het WordPress Core AI Team heeft concrete plannen voor WordPress 7.0:⁶

• WP AI Client in core — De PHP AI Client SDK wordt onderdeel van core
• JavaScriptKeurigOnline zegtJavaScriptJavaScript is een programmeertaal die wordt gebruikt om interactieve en dynamische websites te maken. client — @wordpress/abilities package met executeAbility()
• Workflows API — Nieuwe API voor het koppelen van abilities
• Visuele workflow editor — Canonical editor voor het bouwen van workflows

Command Palette transformatie

We verwachten dat de WordPress Command Palette (die "quick actions" interface die je opent met Cmd+K) volledig op Abilities gaat draaien. Dit betekent dat elke ability automatisch als commando beschikbaar wordt — inclusief plugin-functionaliteit.

Het sneeuwbaleffect

Het WordPress-team spreekt expliciet over een verwacht sneeuwbaleffect:⁶

"The key to making this all work is a snowball effect: as developers create AI-powered features, hosts will be enticed to provide AI as part of their platform."

Onze inschatting: dit gaat inderdaad gebeuren. Grote hostingpartijen als WordPress.com en DreamHost implementeren al AI-providers voor de WP AI Client.⁶ Dit past in de bredere trend waarbij hosting steeds meer geïntegreerde diensten biedt — vergelijkbaar met hoe LiteSpeed hosting nu al server-level caching aanbiedt.

Van CMS naar applicatieplatform

De Abilities API markeert een fundamentele verschuiving in hoe we naar WordPress kijken. Het is niet langer alleen een content management systeem — het wordt een applicatieplatform waarop intelligente automatisering gebouwd kan worden. Dit past in de bredere AI-revolutie die we zien in de hele tech-industrie.

Vergelijk het met hoe smartphones evolueerden: eerst telefoons met apps, toen platformen waar apps het uitgangspunt werden. WordPress evolueert van "CMSKeurigOnline zegtCMSEen CMS is een platform om webcontent eenvoudig te creëren, beheren en publiceren zonder te coderen. met plugins" naar "platform met abilities".

Kritische kanttekening

Niet alles is rooskleurig. Er is terechte kritiek vanuit de community:¹

• De PHP AI Client mist nog functies zoals streaming support
• Sommige plugin-ontwikkelaars zien de directe waarde nog niet
• De AI-features zijn afhankelijk van third-party plugins, niet core

Onze inschatting: deze kritiek is terecht voor de huidige staat, maar de fundering is gelegd. De komende releases zullen veel van deze gaten opvullen.

Conclusie: wat dit voor jou betekent

De Abilities API maakt WordPress "intelligible" — begrijpelijk voor zowel mensen als machines. Het lost een 20 jaar oud probleem van fragmentatie op en bereidt WordPress voor op een toekomst waarin AI-agents een standaard onderdeel zijn van hoe we met websites werken.

Voor developers

Nu is het moment om te leren. Begin met het registreren van abilities voor je bestaande plugin-functionaliteit. Het is relatief weinig werk en maakt je plugins toekomstbestendig.

Voor site-eigenaren

Check of je hostingprovider klaar is voor AI-integratie. Providers die de WP AI Client ondersteunen, geven je toegang tot AI-features zonder extra configuratie. Overweeg ook professioneel WordPress onderhoud om je site up-to-date te houden met deze ontwikkelingen.

Voor bureaus en professionals

Dit is een strategische kans. Teams die nu investeren in Abilities-kennis hebben een voorsprong wanneer de markt vraagt om AI-geïntegreerde WordPress-oplossingen.

WordPress transformeert van een verzameling losse functies naar een geünificeerd, AI-klaar platform. De Abilities API is de fundamentele bouwsteen die dit mogelijk maakt.

Bronnen en referenties

Dit artikel is gebaseerd op officiële WordPress documentatie, first-hand accounts van het Core AI Team, en onafhankelijke analyse:

1. WordPress Core Team (november 2025) — Abilities API in WordPress 6.9: Officiële dev notes met technische specificaties, PHPKeurigOnline zegtPHPPHP (Hypertext Preprocessor) is een populaire open-source scripttaal die speciaal is ontworpen voor webontwikkeling en server-side programmering. functies, REST endpoints en hooks
2. James LePage (november 2025) — The Promise and History Of Abilities: First-hand account van de co-lead van het WordPress Core AI Team over de oorsprong en ontwikkeling van de API
3. Search Engine Journal (november 2025) — Why WordPress 6.9 Abilities API Is Consequential And Far-Reaching: Onafhankelijke industrie-analyse over de impact van de Abilities API
4. WordPress AI Team (juli 2025) — AI Building Blocks for WordPress: Strategisch overzicht van de vier AI-bouwstenen en de modulaire aanpak
5. James LePage (november 2025) — Using Abilities To Build AI in WordPress: Technische deep-dive in de drie AI-patronen met code voorbeelden
6. WordPress AI Team (december 2025) — Six Months of Core AI: Retrospectief met bereikte mijlpalen, productie-adoptie en WordPress 7.0 roadmap
7. WordPress Developer Blog (november 2025) — Introducing the WordPress Abilities API: Officiële introductiegids met installatie-instructies en praktische voorbeelden
8. WordPress AI Team (juli 2025) — Abilities API Overview: Officiële team pagina met design goals en roadmap

Let op: De WordPressKeurigOnline zegtWordPressWordPress is een open-source contentmanagementsysteem (CMS) geschreven in PHP, waarmee je eenvoudig websites en blogs kunt bouwen en beheren. Abilities APIKeurigOnline zegtAPIEen API (Application Programming Interface) is een set regels en protocollen waarmee softwareapplicaties met elkaar kunnen communiceren en gegevens uitwisselen. en gerelateerde tools zijn actief in ontwikkeling. Functies en APIs kunnen wijzigen tussen releases. Alle externe links zijn gecontroleerd op 23 januari 2026.