ListiScore – Listing Health Score for GeoDirectory

ListiScore adds a gamified completeness score to every listing in your GeoDirectory directory. Admins get an at-a-glance view of which listings need attention; listing owners get a clear, prioritized checklist of what to fix next for the biggest score gain.

Source code and development happen in the open on GitHub.

Features

• 0-100 health score for every listing, calculated from a weighted set of criteria: featured image, logo, description length, opening hours, phone, email, website, social links, photo gallery, review count, and freshness (how recently the listing was updated).
• Admin column: a sortable, color-coded Health column on every GeoDirectory post type’s admin list table, so admins can spot and sort by low-scoring listings instantly.
• Admin filter + bulk recalculate: filter any listing type’s admin list table by health band (Good / Needs improvement / Poor), and recalculate the score for any selection via the “Recalculate Health Score” bulk action.
• Owner-facing widget / shortcode / block: [listiscore_health] (also available as a widget and a Gutenberg block) shows a “complete your listing” checklist: percent-complete progress bar and a recommendations list sorted by potential score percentage gain, so owners know exactly what to fix first. Visible only to the listing owner and site admins.
• Settings tab inside GeoDirectory’s own settings UI: enable or disable individual criteria, reweight them, and tune scaling targets (description length, photo/review/social counts, freshness decay window) and the score-band thresholds, all without touching code.
• Automatic recalculation: scores update when a listing is saved, when reviews are added or change status, and via a daily batched cron job so freshness decay stays accurate even without new activity. Changing settings automatically invalidates and lazily recalculates affected scores.
• Developer-friendly: every scaling target, threshold, and the criteria list itself are filterable; a listiscore_score_updated action fires whenever a score changes.
• Free, no upsells: the full feature set is free. No premium tier, no license key, no nags.

Requirements

• GeoDirectory v2 or later must be installed and active. ListiScore does nothing without it.