Skip to main content

Updating WordPress Core, Themes, and Plugins

When updating software on our platform, we follow a strict procedure and document what updates are being made. This is the procedure.

Document the Process​

Create a Blog Post on our team site at https://digitalchurch.team to document the update process as you go. It will be an .mdx file with the following naming convention: YYYY-MM-DD-updates.mdx

---
title: Updates on Feb 26, 2024
authors:
  name: Mark Tenney
  title: Founder
  url: https://github.com/marktenney
  image_url: https://avatars.githubusercontent.com/u/29559053?v=4
tags: [updates]
---

# Software Updates

## Themes

| name    | old_version | new_version | status  |
| :- | :- | :- | :- |
| astra           | 4.6.2       | 4.6.5       | Updated |

## Plugins

| name | old_version | new_version | status  |
| :- | :- | :- | :- |
| admin-menu-editor-pro       | active-network | 2.22.1        | 2.23.3         |

## Core

Include notes on Core Update here.

Generate a Report of Available Updates​

Enter the CLI via terminal on the server you wish to update and navigate to the site directory. Generate a report using the CLI command below, and paste it into the team blog post documentation.

Theme Updates​

via wp-cli
wp theme update --all --dry-run
via GridPane
gp wp digitalchurch.app theme update --all --dry-run
via Docker
docker-compose exec wordpress wp theme update --all --allow-root --dry-run

Plugin Updates​

via wp-cli
wp plugin update --all --dry-run
via GridPane
gp wp digitalchurch.app plugin update --all --dry-run
via Docker
docker-compose exec wordpress wp plugin update --all --allow-root --dry-run

Core Update​

check version
gp wp digitalchurch.app core version --extra
check for updates
gp wp digitalchurch.app core check-update
Update Core via GridPane
gp wp digitalchurch.app core update
Update Core via Docker
docker-compose exec wordpress wp core update --allow-root

Clear the Caches​

gp wp digitalchurch.app beaver clearcache
gp fix cached

Testing​

If you completed a core update, you'll need to run through a database upgrade for the network here: https://digitalchurch.app/wp-admin/network/upgrade.php

Once you've run all the updates and cleared all the caches, it's time to do some tests to make sure nothing broke in the process. Refer to the document: Post Update Testing