manifest / analytics / searcherries-wordpress-plugin

Searcherries

Official Searcherries plugin for WordPress: AI visibility score, mentions by AI platform, competitors, cited domains and action plan inside wp-admin

by Searcherries · github.com/eduardmur/searcherries-wordpress-plugin · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/eduardmur/searcherries-wordpress-plugin/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/eduardmur/searcherries-wordpress-plugin ↗

Searcherries for WordPress

The official Searcherries plugin for the WordPress.org directory. It shows the AI visibility of a Searcherries project inside wp-admin: the visibility score and its change, mentions by AI platform, named share, top competitors, top cited domains, connected-source status and the prioritized action plan, plus a dashboard widget with the score and the next three actions.

The plugin reads the Searcherries REST API with a personal access token. It is read-only, sends requests only on an administrator's own page loads and button clicks, caches responses for one hour, and adds nothing to the public site. See readme.txt for the directory listing, the external-service disclosure and the FAQ.

Layout

searcherries.php          Plugin header and bootstrap
uninstall.php             Removes options and transients
includes/                 API client, cache, settings, data layer, admin screens, widget
admin/views/              Settings page, AI Visibility page, dashboard widget
admin/css/admin.css       Admin styles (native WordPress look)
languages/                searcherries.pot
.wordpress-org/           Directory assets (icons, banners) and their SVG source
bin/                      Development scripts (test site, Plugin Check, POT, zip, assets)
tests/                    PHPUnit tests and API fixtures taken from the OpenAPI spec

Development

Requires PHP 7.4+ (8.2+ for the dev tools), Composer, Node 18+ for the assets. No MySQL and no Docker: the test site runs on SQLite.

composer install            # PHPCS (WordPress-Extra + Docs + PHPCompatibility) and PHPUnit
composer test:setup         # downloads WordPress + the SQLite drop-in + Plugin Check into .wp-test/
composer test               # PHPUnit against the real WordPress HTTP API, mocked with pre_http_request
composer lint               # phpcs (composer lint:fix runs phpcbf)
composer lint:php           # php -l on every file
composer plugin-check       # WordPress.org Plugin Check (static + runtime) on the built plugin
composer make-pot           # regenerates languages/searcherries.pot
composer build              # build/searcherries.zip without dev files (.distignore)
npm install && npm run assets   # renders .wordpress-org/*.png from .wordpress-org/src/icon.svg

bin/serve.sh previews the plugin at http://localhost:8787/wp-admin against a mock of the API that serves the test fixtures (token demo-token; paid-required and rate-limited reproduce the 403 and 429 notices).

Releasing to WordPress.org

See SUBMISSION.md.

License

GPL-2.0-or-later. See LICENSE.