From 56616d084c2c9841d484c1f3518ada9e407123a1 Mon Sep 17 00:00:00 2001 From: root Date: Wed, 27 May 2026 17:16:47 +0200 Subject: [PATCH] fix: add Dashboard/Homepage translations and OPcache troubleshooting to README --- README.md | 31 +++++++++++++++++++++++++++++++ lang/nl.json | 3 ++- 2 files changed, 33 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2152048..e331fd3 100755 --- a/README.md +++ b/README.md @@ -428,6 +428,37 @@ Auto-detects: **Linux, Windows IIS, XAMPP, WAMP, Apache, Nginx** --- +## Troubleshooting + +### 500 Error After `php artisan optimize` + +If you get a 500 error after running `php artisan optimize`, PHP OPcache is likely caching stale files. Fix: + +```bash +# Disable OPcache in your FPM configuration: +# Edit /etc/php/8.x/fpm/conf.d/99-opcache.ini +opcache.enable=0 + +# Then restart PHP-FPM: +sudo systemctl restart php8.x-fpm +``` + +Alternatively, keep OPcache enabled but restart PHP-FPM after every `php artisan optimize`: + +```bash +php artisan optimize +sudo systemctl restart php8.x-fpm +``` + +### Filament Translations Not Working + +If Filament navigation labels or resource names aren't translating (e.g., Dashboard shows in English instead of Dutch): + +1. Add the missing key to `lang/vendor/filament/{locale}/resources.php` (navigations section) or `lang/{locale}.json` +2. Clear the cache: `php artisan optimize:clear` (then restart PHP-FPM if OPcache is on) + +--- + ## Performance Optimizations | Optimization | Description | diff --git a/lang/nl.json b/lang/nl.json index 26381d1..2543daf 100755 --- a/lang/nl.json +++ b/lang/nl.json @@ -347,5 +347,6 @@ "radio.wizard.test_not_run": "Nog niet getest.", "radio.wizard.test_connection_fail": "Kon de test niet uitvoeren: ", "radio.wizard.error": "Fout", - "radio.wizard.unknown_error": "Onbekende fout" + "radio.wizard.unknown_error": "Onbekende fout", + "Homepage": "Homepage" }