1. Home
  2. Docs
  3. Appsero User Guide
  4. Push to Deploy

Push to Deploy

Automatically release a new version of your Plugin or Theme from GitHub or Bitbucket. Push your project tags to GitHub or Bitbucket to create a new release in Appsero and the user will get an automatic update from Appsero.

Connect With GitHub or Bitbucket

To connect your profile with GitHub or Bitbucket go to the Integrations page.

  • It’s important that you only connect Github or Bitbucket. Not both for your free plugin.
Integrations

Then click on the Connect button of your project Git repository manager.

GITHUB

Now go to your specific project’s Integrations page and select the repository for your Plugin or Theme.

Integrations

Make Sure You Are Connected with Your WordPress.org Account

Go to the Appsero Dashboard’s Integration page. Make sure you have connected your WordPress.org account with Appsero.

Push to Deploy 1


Install dependencies

To install dependencies your repository must contain both composer.json and composer.lock files. If these two files are present then Appsero will automatically run composer install for you.

Remove Files or Folder From Production

Add a JSON file in the root directory called appsero.json and add an array with exclude key.

{
    "exclude": [
        "README.md",
        "appsero.json",
        "composer.json",
        "composer.lock",
        ".gitignore",
        "assets/src"
    ]
}

Custom Directory Name

By default we use project slug for your Plugin or Theme directory name, But you have option to change it. Add directory name with key name in appsero.json file.

{
    "name": "push-to-deploy"
}

Give Proper Changelog, Update Readme & Main function file

  • Add a changelog in tag message. Don’t add -m flag in your tag command. Please look at the example below.
Code
  • Update your readme file with the latest version tag. If you are pushing version 1.6, make sure it’s reflected on your readme.md/readme.txt file
  • Update your main function file with the proper version tag. If you are pushing version 1.6, make sure it’s the same on your main function file.

Deploy to WordPress.org from Git Account

You can deploy directly from your Git account to WordPress.org by running the following command.

$ git tag -a "v1.2.3"

Then you will need to push the tag to your branch (which you selected while configuring push to deploy).

$ git push origin master  
$ git push origin {tag name}

Watch the Terminal Video to Know How it Works

A success or failed email will send to your email address after processing the project files.

Video Tutorial

Here’s a video tutorial that shows how you can deploy a plugin/theme from your Git account to WordPress.org

Was this article helpful to you? Yes No

How can we help?