{"id":15326,"date":"2016-02-04T11:00:16","date_gmt":"2016-02-04T17:00:16","guid":{"rendered":"https:\/\/getflywheel.com\/?p=15326"},"modified":"2024-10-02T11:18:45","modified_gmt":"2024-10-02T16:18:45","slug":"how-to-publish-your-first-wordpress-plugin","status":"publish","type":"resource","link":"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/","title":{"rendered":"How to Publish Your First WordPress Plugin"},"content":{"rendered":"\n

Releasing a WordPress plugin can seem like a daunting task that only super talented PHP developers are capable of. But releasing a plugin doesn’t have to be as scary as you may believe! In fact, publishing a new plugin to the WordPress Plugin Directory<\/a> can be fairly simple.<\/p>\n\n\n\n

This article won\u2019t necessarily go into the details of creating plugins, rather it will cover the steps needed to actually get your plugin launched and available in the WordPress.org directory for the benefit of every WordPress site in the world. For reference, this example used the WordPress Plugin Boilerplate<\/a> as a starting point for the plugins and they were open sourced using GitHub<\/a> (definitely recommended).<\/p>\n\n\n\n

Readme.txt<\/h2>\n\n\n\n

The first thing you need to have in order for WordPress to accept your plugin is a Readme.txt file. It contains all of the information related to your plugin and is what WordPress uses to generate pages for your plugin on the WordPress.org directory (like the Description, Installation, and Screenshots tabs).<\/p>\n\n\n\n

The format for the Readme looks like this:<\/p>\n\n\n\n

=== Plugin Name ===\n\nContributors: yourname\n\nDonate link: http:\/\/yoursite.com\n\nTags: business, directory\n\nRequires at least: 4.3\n\nTested up to: 4.3\n\nStable tag: 4.3\n\nLicense: GPLv2 or later\n\nLicense URI: http:\/\/www.gnu.org\/licenses\/gpl-2.0.html\nA simple description\n== Description ==\nA longer description with a\n- list\n\n- of\n\n- features\n== Installation ==\nThis section describes how to install the plugin and get it working.\n1. Upload [`plugin-name`](link-to-github.zip) to the `\/wp-content\/plugins\/` directory\n\n2. Activate the plugin through the 'Plugins' menu in WordPress\n== Frequently Asked Questions ==\n= Is this a cool plugin? =\nYes\n== Screenshots ==\n1. Desktop view\n2. Mobile view\n== Changelog ==\n= v1.0.0 =\n\n* Initial release<\/code><\/pre>\n\n\n\n
A full example can be found here<\/a>. A handy validator<\/a> is also available to check if your Readme is up to par.<\/p>\n\n\n\n
Changelog and Versioning<\/h2>\n\n\n\n
It\u2019s important to keep the version number of your plugin up to date so, if nothing else, users can be notified when there are updates to it. Updating the changelog is as simple as adding a new entry to the changelog section in the Readme. There are a few different outlooks on versioning and what should constitute as a major or minor release; I like to consult the Semantic Versioning 2.0.0 site<\/a> for reference on that.<\/p>\n\n\n\n
As an example, let\u2019s say you ship your plugin at version 1.0.0. Then the next day you fix a little bug or add a little functionality that you forgot when you first published the plugin. Before you\u2019d deploy the plugin to the WordPress directory (more on how to do that later), you\u2019d update the changelog section in the Readme to something like this:<\/p>\n\n\n\n
== Changelog ==\n= v1.0.1 =\n\n* Fix a thing that allows users to do a thing\n= v1.0.0 =\n\n* Initial release<\/code><\/pre>\n\n\n\n
Then<\/b> (this is important), you need to update the version number in the plugin bootstrap file. You should be familiar with the bootstrap file if you\u2019re writing a plugin, but for reference it\u2019s the file that gives WordPress information about the entire plugin via the comment block at the top.<\/p>\n\n\n\n
\"screenshot
The comment block of the plugin bootstrap file.<\/figcaption><\/figure>\n\n\n\n
Submit to WordPress.org<\/h2>\n\n\n\n
With a Readme in place and extensive testing done, you\u2019re ready to submit the plugin to WordPress! This is the easiest part of the whole process. Simply go to https:\/\/wordpress.org\/plugins\/add\/<\/a>, log in with your WordPress account (or create one), and fill out the short form.<\/p>\n\n\n\n
\"form
WordPress plugin submission form.<\/a><\/figcaption><\/figure>\n\n\n\n
Be careful that you don\u2019t use the name \u201cWordPress\u201d in the name of the plugin. They will reject the plugin if you do so. They will also reject the plugin if you include the name of a trademarked product or if your plugin starts with the name of another plugin. For example, when attempting to submit a plugin that extends Ninja Forms, if you included “Ninja Forms” in the name in any capacity, you’d receive an email like this:<\/p>\n\n\n\n
\n
We’re no longer accepting plugins that include a trademarked product name or term as the name or slug of a plugin. Nor are we accepting plugins that include the name of another plugin at the beginning of the name\/slug.<\/p>\n<\/blockquote>\n\n\n\n
Make sure you take the time to write a lovely description and then drop the link to your plugin in a ZIP file in the last field. Using GitHub for plugin development makes it really easy to have a publicly available ZIP.<\/p>\n\n\n\n
\"screenshot
Copy the URL of the \u201cDownload ZIP\u201d plugin from your GitHub repo.<\/figcaption><\/figure>\n\n\n\n
Once you submit the plugin, sit back and wait! Both of my plugins were accepted within about two days. You\u2019ll get an email with information on the new SVN repository if it\u2019s accepted. Which brings us to the next step – deploying!<\/p>\n\n\n\n
Deploy with SVN<\/h2>\n\n\n\n
Once the plugin is accepted, it\u2019s still not live yet. You have to actually upload the files to the SVN repository WordPress provides you with. This article<\/a> walks you through getting logged in through the terminal pretty quickly. Basically, you create a folder on your computer, check out the SVN repo, copy your plugin files into the newly created \/trunk<\/code> folder, and push it back up.<\/p>\n\n\n\n
For the best deployment process and maintainability, it\u2019s important to use releases or tags whenever you deploy. Just as you update the version number in your plugin file and changelog, you should also be issuing new releases in GitHub. It\u2019s actually required to do this in order to use Ship<\/a>.<\/p>\n\n\n\n
Finally, once you get signed up with Ship and select your repo to hook up to it, you can deploy your first release (make sure the name matches the release name in GitHub). After that, as long as you fill in the form under the WordPress Details heading, Ship will just deploy whenever a new release is issued in GitHub.<\/p>\n\n\n\n
\"publish-wordpress-plugin-ship\"
Ship\u2019s repository settings UI.<\/figcaption><\/figure>\n\n\n\n
Screenshots and Banner Images<\/h2>\n\n\n\n
Displaying screenshots of your plugin is super important to help people visually see what it looks like and to give them an idea of how it works. These screenshots will show up on the WordPress.org plugin directory page (here\u2019s a calendar plugin\u2019s screenshot page<\/a>, for example) and when a user adds a plugin on their site through the Plugins page.<\/p>\n\n\n\n
Banner images aren\u2019t as important as screenshots, but they make your plugin look a little more impressionable. The banner image is the big image that\u2019s shown at the top of the WordPress.org plugin directory page.<\/p>\n\n\n\n
\"Plugin
The dark blue gradient here is the banner.<\/figcaption><\/figure>\n\n\n\n
To get these images to show, you have to place them in the \/assets<\/code> directory of your SVN repo. Unfortunately, you can\u2019t use Ship for this as it only deploys the \/trunk<\/code> folder, so you\u2019ll have to consult this article<\/a> again to get logged in to your SVN repo.<\/p>\n\n\n\n
To keep things simple, stick to naming your screenshots screenshot-#.png<\/code> (where `#` is the number). Doing it this way allows you to easily reference the images in the Readme to give them a description.<\/p>\n\n\n\n
== Screenshots ==\n1. Desktop view\n2. Mobile view<\/code><\/pre>\n\n\n\n
For example, the description \u201cDesktop view\u201d from the Screenshot section in the Readme will match up to screenshot-1.png<\/code> in the \/assets<\/code> folder.<\/p>\n\n\n\n
For the banner, you actually need two versions of the same image – one for normal screens and one for retina screens. The names of the banner images should be banner-1544x500.png<\/code> and banner-772x250.png<\/code>.<\/p>\n\n\n\n
The end<\/h2>\n\n\n\n
That\u2019s it! If you followed along, hopefully your code was accepted and you\u2019re ready to start getting the word out about your awesome new plugin. Just remember to always update the Readme, changelog, and issue releases whenever you update the plugin.<\/p>\n\n\n\n
To ensure every element of your site performs at an optimal level, choose a hosting solution specifically designed for WordPress,<\/a> like WP Engine, because all of our offerings are designed with WordPress in mind!<\/p>\n","protected":false},"excerpt":{"rendered":"
Releasing a WordPress plugin can seem like a daunting task that only super talented PHP developers are capable of. But releasing a plugin doesn’t have to be as scary as you may believe! In fact, publishing a new plugin to the WordPress Plugin Directory can be fairly simple. This article won\u2019t necessarily go into the…<\/span><\/span><\/p>\n","protected":false},"author":1,"featured_media":142526,"template":"","resource-topic":[908,901],"resource-role":[896,906],"resource-type":[916],"class_list":["post-15326","resource","type-resource","status-publish","has-post-thumbnail","hentry"],"yoast_head":"\nHow to Publish Your First WordPress Plugin<\/title>\n<meta name=\"description\" content=\"If you want to build your skillset and become a plugin developer, this guide will help you through the plugin publication process!\" \/>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Publish Your First WordPress Plugin\" \/>\n<meta property=\"og:description\" content=\"If you want to build your skillset and become a plugin developer, this guide will help you through the plugin publication process!\" \/>\n<meta property=\"og:url\" content=\"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/\" \/>\n<meta property=\"og:site_name\" content=\"WP Engine\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/wpengine\" \/>\n<meta property=\"article:modified_time\" content=\"2024-10-02T16:18:45+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2016\/02\/plugin.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1100\" \/>\n\t<meta property=\"og:image:height\" content=\"500\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:title\" content=\"How to Publish Your First WordPress Plugin\" \/>\n<meta name=\"twitter:description\" content=\"If you want to build your skillset and become a plugin developer, this guide will help you through the plugin publication process!\" \/>\n<meta name=\"twitter:image\" content=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2016\/02\/plugin.png\" \/>\n<meta name=\"twitter:site\" content=\"@wpengine\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/\",\"url\":\"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/\",\"name\":\"How to Publish Your First WordPress Plugin\",\"isPartOf\":{\"@id\":\"https:\/\/wpengine.com\/case-studies\/#website\"},\"datePublished\":\"2016-02-04T17:00:16+00:00\",\"dateModified\":\"2024-10-02T16:18:45+00:00\",\"description\":\"If you want to build your skillset and become a plugin developer, this guide will help you through the plugin publication process!\",\"breadcrumb\":{\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/wpengine.com\/case-studies\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Resources\",\"item\":\"https:\/\/wpengine.com\/case-studies\/resources\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"How to Publish Your First WordPress Plugin\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#website\",\"url\":\"https:\/\/wpengine.com\/case-studies\/\",\"name\":\"WP Engine\",\"description\":\"Managed Hosting for WordPress\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/wpengine.com\/case-studies\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/f5301455463371a10d1fc290e9ad0085\",\"name\":\"WP Engine\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/d8770fe9625ca7c4601f13d9d0ab86565a6dac8cd6a77bfe2ada6d83c6837870?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/d8770fe9625ca7c4601f13d9d0ab86565a6dac8cd6a77bfe2ada6d83c6837870?s=96&d=mm&r=g\",\"caption\":\"WP Engine\"},\"sameAs\":[\"https:\/\/wpengine.com\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to Publish Your First WordPress Plugin","description":"If you want to build your skillset and become a plugin developer, this guide will help you through the plugin publication process!","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"How to Publish Your First WordPress Plugin","og_description":"If you want to build your skillset and become a plugin developer, this guide will help you through the plugin publication process!","og_url":"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/","og_site_name":"WP Engine","article_publisher":"https:\/\/www.facebook.com\/wpengine","article_modified_time":"2024-10-02T16:18:45+00:00","og_image":[{"width":1100,"height":500,"url":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2016\/02\/plugin.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_title":"How to Publish Your First WordPress Plugin","twitter_description":"If you want to build your skillset and become a plugin developer, this guide will help you through the plugin publication process!","twitter_image":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2016\/02\/plugin.png","twitter_site":"@wpengine","twitter_misc":{"Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/","url":"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/","name":"How to Publish Your First WordPress Plugin","isPartOf":{"@id":"https:\/\/wpengine.com\/case-studies\/#website"},"datePublished":"2016-02-04T17:00:16+00:00","dateModified":"2024-10-02T16:18:45+00:00","description":"If you want to build your skillset and become a plugin developer, this guide will help you through the plugin publication process!","breadcrumb":{"@id":"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/wpengine.com\/case-studies\/resources\/how-to-publish-your-first-wordpress-plugin\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/wpengine.com\/case-studies\/"},{"@type":"ListItem","position":2,"name":"Resources","item":"https:\/\/wpengine.com\/case-studies\/resources\/"},{"@type":"ListItem","position":3,"name":"How to Publish Your First WordPress Plugin"}]},{"@type":"WebSite","@id":"https:\/\/wpengine.com\/case-studies\/#website","url":"https:\/\/wpengine.com\/case-studies\/","name":"WP Engine","description":"Managed Hosting for WordPress","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/wpengine.com\/case-studies\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/f5301455463371a10d1fc290e9ad0085","name":"WP Engine","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/d8770fe9625ca7c4601f13d9d0ab86565a6dac8cd6a77bfe2ada6d83c6837870?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/d8770fe9625ca7c4601f13d9d0ab86565a6dac8cd6a77bfe2ada6d83c6837870?s=96&d=mm&r=g","caption":"WP Engine"},"sameAs":["https:\/\/wpengine.com"]}]}},"acf":[],"grid_image_url":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2016\/02\/plugin-grid.png","media-type":{"term_id":916,"name":"Article","slug":"article"},"role":"<strong>Roles:<\/strong> Developer, Entrepreneur","topic":"<strong>Topics:<\/strong> Entrepreneurship, WordPress","_links":{"self":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource\/15326","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource"}],"about":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/types\/resource"}],"author":[{"embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/users\/1"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/media\/142526"}],"wp:attachment":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/media?parent=15326"}],"wp:term":[{"taxonomy":"resource-topic","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-topic?post=15326"},{"taxonomy":"resource-role","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-role?post=15326"},{"taxonomy":"resource-type","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-type?post=15326"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}