Phase 6: WebP image conversion - Converter for Media plugin with Nginx rewrite rules

2025-11-28 17:16:24 -06:00
parent 91de533da4
commit 78a744ef06
260 changed files with 21138 additions and 5 deletions
@@ -0,0 +1,55 @@
+# HomeProz Server Dependencies
+
+This document tracks server-side dependencies required for the HomeProz WordPress site.
+
+## PHP Extensions
+
+| Extension | Purpose | Status |
+|-----------|---------|--------|
+| `gd` | Image manipulation, WebP conversion | Pre-installed |
+| `imagick` | Image manipulation, WebP conversion (alternative to GD) | Pre-installed |
+
+Both extensions include WebP support, verified with:
+```bash
+php -r "echo 'GD WebP: ' . (function_exists('imagewebp') ? 'Yes' : 'No') . PHP_EOL;"
+php -r "echo 'Imagick WebP: ' . (in_array('WEBP', Imagick::queryFormats()) ? 'Yes' : 'No') . PHP_EOL;"
+```
+
+## Nginx Configuration
+
+### WebP Serving Rules
+
+Added to `/etc/nginx/sites-available/default` on 2025-11-28:
+
+```nginx
+# WebP Converter for Media - serve WebP when available
+location ~ /wp-content/(?<path>.+)\.(?<ext>jpe?g|png|gif|webp)$ {
+    add_header Vary Accept;
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+    access_log off;
+
+    if ($http_accept !~* "image/webp") {
+        break;
+    }
+    try_files /wp-content/uploads-webpc/$path.$ext.webp $uri =404;
+}
+```
+
+**Purpose:** When a browser requests an image from wp-content and sends `Accept: image/webp`, Nginx checks for a WebP version in `/wp-content/uploads-webpc/` and serves it instead. Falls back to original if WebP not available.
+
+**After changes:** Run `nginx -t && service nginx reload`
+
+## WordPress Plugins (Image Processing)
+
+| Plugin | Version | Purpose |
+|--------|---------|---------|
+| Converter for Media | 6.3.2 | Converts uploaded images to WebP locally using PHP GD/Imagick |
+
+The plugin stores converted WebP files in `/wp-content/uploads-webpc/` mirroring the structure of `/wp-content/uploads/`.
+
+## Notes
+
+- No external APIs or services are used for image processing
+- All image conversion happens locally on the server
+- WordPress core handles thumbnail generation for all registered image sizes