wordpress-org-compliance

Detect trialware and premium-lock violations in WordPress.org plugins.

316|74|Updated Apr 15, 2013
One-click install
npx skills add https://github.com/bonny/WordPress-Simple-History --skill wordpress-org-compliance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wordpress-org-compliance
Source: https://github.com/bonny/WordPress-Simple-History/tree/main/.claude/skills/wordpress-org-compliance
Command: npx skills add https://github.com/bonny/WordPress-Simple-History --skill wordpress-org-compliance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps ensure WordPress.org freemium plugins stay compliant with official guidelines, avoiding locked features, intrusive upsells, or trialware, and guiding compliant upgrade patterns.

Core Features & Use Cases

  • No premium locking: Enforces the rule that all free features must work without a license key.
  • Informational upsells: Encourages non-intrusive teasers and separate premium plugins rather than gating functionality.
  • Compliance checklist: Provides a pre-submission review framework and questions to avoid common violations.

Quick Start

  • Review your plugin’s free vs premium distinctions
  • Replace any license-locked features with feature detection or add-on patterns
  • Add non-intrusive upsell notes and teaser UI, not blocked functionality
  • Use the provided checklist and review questions before WordPress.org submission

Frequently Asked Questions about wordpress-org-compliance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ensure my WordPress.org plugin meets freemium compliance guidelines?

WordPress.org freemium compliance requires that all free features work without a license key, upsells are non-intrusive, and premium functionality is offered as separate add-ons rather than locked within the free version. Use a compliance checklist to review your plugin's free vs. premium distinctions and replace any license-locked features with feature detection or add-on patterns before submission.

What's the difference between compliant and non-compliant upselling in WordPress plugins?

Compliant upselling uses informational teasers and non-intrusive upgrade notes without blocking functionality. Non-compliant approaches include trial limits, quota restrictions, feature gates requiring license keys, or intrusive upgrade prompts. WordPress.org requires separate premium plugins for additional features, never locked code or trialware within the free version.

Can I add a trial period or feature restrictions to my free WordPress plugin?

No. WordPress.org compliance prohibits trials, quotas, and feature restrictions in free versions. All free features must be fully functional without a license key. Premium functionality should be offered as separate add-on plugins with clear, non-intrusive upsell messaging only.

How do I structure premium features in a WordPress freemium plugin?

Structure premium features as separate paid add-on plugins rather than gating them with license checks in the free version. Use informational teasers to guide users toward premium offerings without blocking access to free functionality. This pattern keeps the free plugin compliant while maintaining a clear upgrade path.

What should I check before submitting my plugin to WordPress.org?

Before submission, verify that your plugin has no premium locking, no license key requirements for free features, no trials or quotas, and uses only non-intrusive upsell messaging. Use the compliance checklist to review free vs. premium distinctions, code patterns, and upgrade UI. Address any violations to avoid rejection.