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:

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:

# 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

1.9 KiB Raw Blame History