Hanson.xyz Dev
56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# 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
|