From ea83b936bc33dc3787de11218b7798530091a6d7 Mon Sep 17 00:00:00 2001 From: Jon Beaumont-Pike Date: Fri, 20 Oct 2023 12:21:07 +0100 Subject: [PATCH] README + CHANGELOG Updates --- CHANGELOG.md | 7 +++++++ README.md | 58 ++++++++++++++++++++++------------------------------ 2 files changed, 32 insertions(+), 33 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d1e75d1..3fb3ad9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,13 @@ This project adheres to [Semantic Versioning](http://semver.org/). +### 1.3.2: 20/10/2023 +* Maintanence mode commands to prevent the site being accessed during sync +* ENV Optimisations (merci @gmutschler) +* Custom uploads folder directory support (thanks @paintface) +* Composer stable stability + updated WP-CLI packages +* New folder structure ✨ + ### 1.3.1: 03/11/2020 * Added welcome and connection success messages diff --git a/README.md b/README.md index 814172f..6ef2e73 100644 --- a/README.md +++ b/README.md @@ -1,34 +1,22 @@ -

- WP-CLI Sync
WP-CLI Sync -

+# WP-CLI SyncWP-CLI Sync -

- - Packagist Latest Version - +[![Packagist Latest Version](https://img.shields.io/packagist/v/jonbp/wp-cli-sync)](https://packagist.org/packages/jonbp/wp-cli-sync) +[![Packagist Downloads](https://img.shields.io/packagist/dm/jonbp/wp-cli-sync)](https://packagist.org/packages/jonbp/wp-cli-sync) +[![GitHub Open Issues](https://img.shields.io/github/issues-raw/jonbp/wp-cli-sync)](https://github.com/jonbp/wp-cli-sync/issues) +[![GitHub Open Pull Requests](https://img.shields.io/github/issues-pr-raw/jonbp/wp-cli-sync)](https://github.com/jonbp/wp-cli-sync/pulls) - - Packagist Downloads - +## About - - GitHub Open Issues - +A WP-CLI command for syncing a live site to a development environment. - - GitHub Open Pull Requests - -

- -

A WP-CLI command for syncing a live site to a development environment

- -

- -

+This plugin is designed to be used with a [Roots Bedrock](https://github.com/roots/bedrock) based WordPress project. +![Screenshot](https://i.imgur.com/ugUhcuQ.gif) ## Requirements +You will need the following to use this plugin: + * A [bedrock](https://github.com/roots/bedrock) based WordPress project * SSH connection to live server * [WP-CLI](https://github.com/wp-cli/wp-cli) @@ -36,6 +24,8 @@ ## Installation +To install this plugin, follow these steps: + 1. Require the plugin by running: ```sh @@ -58,15 +48,6 @@ DEV_ACTIVATED_PLUGINS="" # Plugins deactivated on sync DEV_DEACTIVATED_PLUGINS="" - -# Dirs to exclude from sync -# Multiple dirs can be provided by separating with a comma -# Use dir names or paths relative to uploads dir -DEV_SYNC_DIR_EXCLUDES="" - -# DB Queries to run after sync -DEV_POST_SYNC_QUERIES="" - ``` 3. Run `wp sync` from the project root. @@ -82,4 +63,15 @@ wp db create wp core install --url=abc.xyz --title=abc --admin_user=abc --admin_password=abc --admin_email=abc@abc.xyz --skip-email ``` -It’s not necessary to edit the variables on the second line as the database is overwritten by the plugin during sync. The code is simply to give the plugin the requirements it needs to run without the real database installed. \ No newline at end of file +It’s not necessary to edit the variables on the second line as the database is overwritten by the plugin during sync. The code is simply to give the plugin the requirements it needs to run without the real database installed. + +## Extra Environment Variables + +Below is a list of extra environment variables that can be added to your `.env` file to customise the sync process. + +| Variable | Description | +| --- | --- | +| `DEV_POST_SYNC_QUERIES` | A comma seperated list of SQL queries to run after the sync has completed. | +| `DEV_SYNC_DIR_EXCLUDES` | A comma seperated list of directories within the uploads folder to exclude from the sync. | +| `DEV_TASK_DEBUG` | Set to `true` to show debug information about the commands being run. Useful for debugging if something isn't working as expected. | +| `UPLOAD_DIR` | The name of the uploads directory. Defaults to `app/uploads` where the uploads folder is located on a bedrock project. | \ No newline at end of file