Table of Contents
Problem Description #
Some users observe that after configuring rename settings (e.g. convert characters, lowercase, remove accents) and saving, the settings seem lost: after reload, checkboxes are unchecked or reverted.
Common symptoms #
- After pressing “Save Changes,” the rename options appear saved, but after revisiting the settings page they are unset. The plugin behaves as if rename on upload is disabled. WordPress.org
- New uploads use original filenames, not sanitized ones, even though rename settings were selected.
Cause #
This can be caused by a conflict with the active theme or another plugin interfering with settings storage, or possibly a bug affecting specific PHP/MySQL versions (some users report issue on certain server environments). The forum thread notes the problem could be environment-specific.WordPress.org
Solution (step‑by‑step) #
- After changing settings, save and then refresh the settings page, ensure options remain checked.
- If they revert, try switching temporarily to a default WordPress theme (e.g. Twenty Twenty‑One) and disable other plugins, to rule out conflict.
- If the issue persists, check server error logs / debug.log for PHP errors after save attempt. Share logs with plugin support if needed. This helps identify environment‑specific issues.
- As a workaround: set rename rules in code, if plugin supports filters (frou_sanitize_file_name or others) so renaming is always applied. See plugin docs for hook usage. WordPress.org+1
- Ensure your WordPress + PHP version is compatible (plugin tested up to WP 6.8 recently). WordPress.org+1
Prerequisites #
- WP and plugin versions compatible; access to theme/plugin toggling for testing.
- Optionally, ability to view PHP error logs or enable WP debugging.
Additional Notes #
- Encourage users to test after changing settings; avoid bulk uploads until settings confirmed.
Keep a record of working configuration (document rename rules).
