WordPress.org Plugin Compliance

SkillDev tools

Reviews plugin code for WordPress.org compliance and trialware violations. Use when checking premium features, upsells, or license keys before submission.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the WordPress.org Plugin Compliance skill

What this skill tells your AI

The instructions your AI receives, as published by bonny/wordpress-simple-history in .claude/skills/wordpress-org-compliance/SKILL.md and read by ahel’s review.

Ensures WordPress.org compliance for free vs premium code and upselling.

Core Rule: No Locked Code

Golden Rule: All code in WordPress.org plugins must be free and fully functional.

  • Every feature works completely without a license key
  • No trial periods or usage limits
  • No features requiring payment to unlock

Quick Reference

Not Allowed

  • Trial periods or time limits
  • Usage quotas or artificial limits
  • License keys for local features
  • Disabled features requiring payment
  • Intrusive nag screens

Allowed

  • Informational upselling (non-intrusive)
  • Separate premium plugin from your site
  • Feature detection (not restriction)
  • Comparison tables and teasers
  • Disabled form previews for premium-only features

Key Patterns

// ❌ WRONG: Feature Restriction
if ( ! $this->is_premium() ) {
    echo 'Premium required';
    return;
}

// ✅ CORRECT: Feature Detection
$this->show_basic_export();
if ( $this->has_premium_addon() ) {
    do_action( 'sh_premium_export_options' );
}

// ❌ WRONG: Artificial Limits
$limit = $this->is_premium() ? 10000 : 100;

// ✅ CORRECT: No Artificial Limits
$limit = apply_filters( 'sh_event_limit', 10000 );

Compliance Checklist

  • All features work without license key
  • No trial periods or time limits
  • No usage quotas
  • Upselling is informational, not obstructive
  • Free version provides real value

Detailed Information

Resources

The Simple Rule: If it's in the WordPress.org version, it must work completely without payment.

Signals

GitHub stars
317
Forks
74
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
wordpress-org-compliance
Source
github.com/bonny/wordpress-simple-history