#102

Author: spelkey-ucd

composer.json

@@ -16,7 +16,7 @@
       }
     ],
     "require": {
-      "timber/timber": "2.3.0",
+      "timber/timber": "2.3.1",
       "apereo/phpcas" : "^1.6.1",
       "elasticsearch/elasticsearch": "~7.0"
     },

devops/Dockerfile

@@ -4,16 +4,16 @@ ARG PLUGIN_ROOT="$WP_SRC_ROOT/wp-content/plugins"
 ARG WP_LOG_ROOT=/var/log/wordpress
 ARG PLUGINS_BUCKET=wordpress-general/plugins
 ARG NODE_VERSION=20
-ARG PLUGIN_ACF="advanced-custom-fields-pro-6.3.11.zip"
+ARG PLUGIN_ACF="advanced-custom-fields-pro-6.3.12.zip"
 ARG PLUGIN_BROKEN_LINK_CHECKER="broken-link-checker-2.4.2.zip"
-ARG PLUGIN_DEFENDER="defender-pro-4.11.zip"
-ARG PLUGIN_FORMINATOR="forminator-pro-1.37.1.zip"
-ARG PLUGIN_HUMMINGBIRD="hummingbird-pro-3.9.4.zip"
+ARG PLUGIN_DEFENDER="defender-pro-5.1.1.zip"
+ARG PLUGIN_FORMINATOR="forminator-pro-1.41.1.zip"
+ARG PLUGIN_HUMMINGBIRD="hummingbird-pro-3.12.zip"
 ARG PLUGIN_LIGHTBOX="gallery-block-lightbox-1.15.zip"
-ARG PLUGIN_REDIRECTION="redirection-5.5.1.zip"
+ARG PLUGIN_REDIRECTION="redirection-5.5.2.zip"
 ARG PLUGIN_SMTP_MAILER="smtp-mailer-1.11.17.zip"
-ARG PLUGIN_SMUSH="smush-pro-3.16.9.zip"
-ARG PLUGIN_USER_ROLE_EDITOR="user-role-editor-4.64.2.zip"
+ARG PLUGIN_SMUSH="smush-pro-3.18.zip"
+ARG PLUGIN_USER_ROLE_EDITOR="user-role-editor-4.64.4.zip"
 ARG PLUGIN_WPMUDEV_UPDATES="wpmu-dev-dashboard-4.11.28.zip"
 ARG UCDLIB_THEME_WP_NODE_IMAGE
 ARG UCDLIB_WP_PLUGINS_NODE_IMAGE
@@ -53,7 +53,7 @@ RUN gsutil cp gs://${PLUGINS_BUCKET}/advanced-custom-fields-pro/${PLUGIN_ACF} .
 
 FROM ${UCDLIB_THEME_WP_NODE_IMAGE} AS ucdlib-theme-wp
 FROM ${UCDLIB_WP_PLUGINS_NODE_IMAGE} AS ucdlib-wp-plugins
-FROM wordpress:6.7.1 AS wordpress
+FROM wordpress:6.7.2 AS wordpress
 
 ARG WP_SRC_ROOT
 ENV WP_SRC_ROOT=${WP_SRC_ROOT}

readme.md

@@ -1,11 +1,50 @@
 # Main Wordpress Website Docker Config
 
-This repo contains the Dockerfile and code (as git submodules) for running the
+This repo contains the Dockerfiles and custom utilities for running the
 main UC Davis Library website.
 
-## PHP Composer Dependencies
-Both theme and plugin php dependencies should go in the `composer.json`, which
-will be installed in `/var/www/html/vendor` in the container.
+Most src code will be found in either the [theme](https://github.com/UCDavisLibrary/ucdlib-theme-wp) or [plugins](https://github.com/UCDavisLibrary/ucdlib-wp-plugins).
+
+## Basic Maintenance
+
+Basic maintenance will need to be performed every few months to ensure that all dependencies stay up-to-date and patched.
+
+### Timber
+Timber is a framework that organizes Wordpress into a more object-oriented approach, and enables the use of the twig templating language.
+To update, find most [recent release](https://github.com/timber/timber/releases), and update `composer.json` file.
+
+### Worpdress Core, Apache, PHP
+Apache, PHP, and Wordpress versions are all controlled by the [official WP docker image](https://hub.docker.com/_/wordpress). Generally, not specifying the Apache/PHP version is fine, e.g. `wordpress:6.7.1`.
+
+In `devops/Dockerfile`, update the Wordpress stage of the build: `FROM wordpress:6.7.1 AS wordpress`
+
+### Third-party Plugins
+All third-party plugins are stored in Google Cloud Storage in the [wordpress-general bucket](https://console.cloud.google.com/storage/browser/wordpress-general;tab=objects?project=digital-ucdavis-edu&prefix=&forceOnObjectsSortingFiltering=false) in the digital-ucdavis-edu project.
+
+You will need to go through each item in the table below, and:
+1. Check if there has been an update
+2. Download the new version
+3. Rename the file if necessary
+4. Upload to corresponding directory in bucket
+5. Update `devops/Dockerfile` with new version number
+
+| Plugin | Download Website |
+| ------ | -------- |
+| ACF Pro | https://www.advancedcustomfields.com/my-account/view-licenses/ |
+| Broken Link Checker | https://wordpress.org/plugins/broken-link-checker/ |
+| Defender Pro | https://wpmudev.com/project/wp-defender/ |
+| Forminator Pro | https://wpmudev.com/project/forminator-pro/ |
+| Hummingbird Pro | https://wpmudev.com/project/wp-hummingbird/ |
+| Gallery Block Lightbox | https://wordpress.org/plugins/gallery-block-lightbox/ |
+| Redirection | https://wordpress.org/plugins/redirection/ |
+| SMTP Mailer | https://wordpress.org/plugins/smtp-mailer/ |
+| Smush Pro | https://wpmudev.com/project/wp-smush-pro/ |
+| User Role Editor | https://wordpress.org/plugins/user-role-editor/ |
+| WPMU DEV Dashboard | https://wpmudev.com/project/wpmu-dev-dashboard/ |
+
+The login credentials for wpmudev can be found in [Google Cloud Secret Manager](https://console.cloud.google.com/security/secret-manager/secret/wpmudev-account/versions?project=digital-ucdavis-edu).
+
+After downloading, you will have to rebuild your local images to see the updates.
 
 ## Deployment
 See the