RankX AI for WordPress

The site-side connector for RankX AI. It lets a WordPress site be read and written by the RankX AI platform: publishing approved content, writing SEO metadata through whichever SEO plugin the site runs, emitting structured data, and serving the machine-readable documents that AI assistants look for.

The plugin generates nothing on its own. Everything it applies is produced and approved in a RankX AI account, which is a paid service. The plugin is free and GPLv2 or later.

Status: not released

This repository is scaffolding. There is no plugin here yet, and nothing is published on WordPress.org. What exists today is the toolchain — coding standards, the Plugin Check workflow, and the local WordPress environment — stood up before any PHP is written, so the first line of code is checked by the same rules the WordPress.org review runs.

Do not install this. There is nothing to install.

Two things that will not change

Recorded here because they are the reasons to trust the plugin with write access to a live site, and because writing them down first makes them harder to quietly drop later.

It is an enhancement, never a requirement. RankX AI works on a WordPress site with no plugin installed, over the REST API and an Application Password, and will continue to. The plugin removes that setup step and unlocks capabilities the REST API cannot express. Nothing in the product will require it. Agencies frequently cannot install plugins on a client's site, and that is a constraint to design around rather than argue with.

It holds no business logic. It exposes capabilities and does nothing clever with them. Every rule about what may be written, how content is preserved, and whether a write succeeded lives in the platform, where it is fixed by a deploy — not in code installed on thousands of sites that cannot be rolled back. A plugin that decides things is a plugin whose decisions are frozen at whatever version each site happens to run.

Development

Requires Docker (for the local WordPress environment) and Composer.

composer install      # coding standards toolchain
composer run lint     # PHPCS, WordPress standards + PHP 7.4 compatibility
npx wp-env start      # WordPress at http://localhost:8888 with this plugin active

composer run lint runs against PHP 7.4 and 8.3 in CI. 7.4 is the declared floor and is in the matrix deliberately: WordPress.org will install on 7.4 hosts, where an 8.0 syntax feature is a fatal error on activation rather than a warning.

npx wp-env start boots PHP 7.4 for the same reason, with 8.3 in the tests environment.

Reporting a security issue

Email support@rankxai.com rather than opening a public issue. See SECURITY.md, which also lists the things this plugin deliberately never does — the quickest way to rule a class of report in or out.

License

GPLv2 or later. See LICENSE.txt.