Ana Sayfa / Kod ve Scriptler / Freemium WordPress Plugin Boilerplate

Freemium WordPress Plugin Boilerplate

Bu geliştirici kiti; ayarlar, Pro uzantı kancası ve sürüm paketlemesi olan bir WordPress eklentisi iskeleti oluşturur.

  • Yayın tarihi9 Kasım 2026
  • Son güncelleme9 Kasım 2026
  • Canlı demoVar
Freemium WordPress Plugin Boilerplate

Overview

Ship a freemium plugin to WordPress.org without rebuilding the boring 80% every time. You run one command, get a complete activation-ready plugin, write your feature, and build the zip you submit.

What the scaffolder does. ./new-plugin.sh "Reading Time" readtime reading-time stamps out the whole plugin: PascalCase namespace from the name, READTIME_ constants, readtime_ option keys, text domain set to the slug. Every token is replaced. The lines only you can write - the author, the readme copy, your Pro sales page - stay as plain placeholder text, and the scaffolder prints each one with its file and line number when it finishes, so nothing is left half-filled by accident.

The freemium part is the part people get wrong. WordPress.org rejects a plugin that locks, limits or time-restricts its own features until someone pays - guideline 5, trialware - and locked code is rejected even when a Pro licence would unlock it. So the free plugin this kit builds is complete: everything in it works for everyone. is_pro() is used for exactly one thing, hiding the Get Pro links, and you sell a separate add-on that attaches to the free plugin's hooks. A test in the kit asserts that no form control is ever disabled for want of Pro.

What it does not include. There is no licence server and no key check. The add-on's licence check is yours to write; the kit gives you the filter it answers and a worked example of the add-on in the README. Saying that plainly is better than you finding out after you buy.

The build script reads a .distignore and leaves out the files Plugin Check rejects - .git, .github, .DS_Store, .env, shell scripts, archives, tests - so the zip you upload to wordpress.org contains only the plugin.

GPL-2.0-or-later, like WordPress itself. Use it in as many commercial plugins as you like.

Features

  • One-command scaffolder: namespace, constants, option keys, text domain and file names all derived from the name and prefix you give it
  • It refuses a prefix under 4 characters or a common word such as plugin, admin or custom, because Plugin Check ignores those and then reports every constant as unprefixed
  • Settings engine: one serialized option row, typed defaults, sanitized writes, nonce- and capability-checked save
  • A working settings screen wired to the engine, ready to copy for more screens
  • Freemium switch your Pro add-on turns on through a filter after its own licence check
  • wp.org-format readme.txt with the plugin name already filled in
  • build.sh + .distignore produce the submission zip with development files excluded
  • uninstall.php removes the plugin's option
  • 12 test scripts, including an end-to-end run against WordPress and a trialware test that proves the free plugin locks nothing
  • GPL-2.0-or-later. No licence key, no phone-home, no build step, no dependencies

Requirements

PHP 7.4 or newer, WordPress 6.5 or newer, for the plugins you build with it.

The scaffolder and build script are bash and need rsync and zip. They run on Linux and macOS.

No Composer, npm or build toolchain.