Repository navigation
Releases
v1.0.0 — Meta Description Checker (stripped open-source version)
Release notes — Altus Meta Description Checker v1.0.0 (stripped open-source version)
First public release of the Altus Meta Description Checker as a free WordPress plugin.
What it does
Score any page's meta description out of 100 — length, pixel-width fit, keyword use and call to action — with a live desktop and mobile Google snippet preview, cut exactly where Google would cut it. Fetch a live URL or paste your own text.
In this release
- Two ways in: "Check a live URL" (paste any public page URL — the tool fetches the page and reads its title and meta description) or "Write your own" (paste a draft title, description and optional target keyword).
- Score out of 100 with plain-English grades: Excellent (85+), Good (65+), Needs work (40+), Poor.
- Live desktop and mobile Google SERP previews, with the description truncated at Google's pixel width (~920 px desktop, ~680 px mobile) and a note when it was cut.
- 8 description checks (present, length, pixel-width fit, keyword placement, unique vs title, call to action, no shouting, clean ending) and 4 title checks (present, length ~600 px, keyword, no shouting) — each pass/warn/fail with a plain-English explanation and fix.
- Live character counters as you type (description out of 155).
- Copy my report and Download report (.txt) buttons.
- Pixel widths are honest estimates from Arial glyph metrics, calibrated so a typical 155-character description lands near Google's ~920 px desktop cut-off. Google renders snippets dynamically, so the preview is a close approximation, not a guarantee.
The public-URL fetch, stated plainly
When a visitor enters a public URL, the server fetches that page to read its <title> and meta description. That fetch is guarded: private and reserved IP ranges are blocked before the fetch and again after DNS resolution, localhost and internal hostnames are refused, it is rate-limited to 5 fetches per IP per hour, the response is capped at 200 KB, and nothing fetched is stored. The scoring itself runs entirely in the visitor's browser.
What was removed vs the Altus hosted version
This is the stripped open-source copy: the email-gate form, lead storage (no database table) and all email sending were removed. The full report is shown on screen and can be copied or downloaded. The version hosted on altuswebsolutions.com may offer email delivery; this open-source version does not.
Testing
php -lclean;node --checkclean on both JavaScript files.- The scoring logic passed a 57-test Node harness (width estimation, word-boundary truncation, caps/CTA/keyword helpers, description + title analysis, scoring, grade bands, report text); the PHP meta extraction passed an 11-test harness.
- Fresh WordPress 7.1.4 test site (SQLite-backed, PHP 8.3.6): Plugin Check FULL v2.2.0 — 0 errors / 0 warnings. First run found 3 errors / 1 warning (strip_tags, parse_url, unsanitized input); all fixed in source, retest clean.
- Smoke test on the fresh site: shortcode renders, both tabs / fetch button / check button present, no email form; live fetch of https://altuswebsolutions.com/ returned its real page through the sandbox proxy (a Cloudflare challenge page — title extracted correctly, no description on it); the SSRF guard refused a localhost URL; the 5-per-hour rate limit was confirmed by the 6th fetch being refused; database still only the 12 standard WordPress tables after activation (no lead table).
Install
Download altus-meta-description-checker-v1.0.0.zip below → WordPress → Plugins → Add New → Upload Plugin → Install Now → Activate → add [altus_meta_checker] to any page.
Disclaimer
Free, "as is", WITHOUT warranty — see the README. Pixel widths are estimates, not guarantees, and Google may rewrite any meta description regardless of its score. Back up your site before installing any plugin and test on staging where possible.
Licence: GPLv2 or later.