Introduction
This guide helps you fix the Userpreference is missing error, which typically appears when installing Easy8 plugins on an outdated version of Redmine. The error occurs during rendering views due to missing or incompatible code in the core Redmine version.
Target Audience
- Administrator
Prerequisites
- Access to your Easy8 instance and server
- Knowledge of the current Redmine version you are using
- Backup of your data and configuration (recommended before upgrade)
How to Fix the Userpreference is missing Error
Step 1: Recognize the Error
The error log may look like this:
ActionView::Template::Error (undefined method `default_users_hide_mail?' for #This typically occurs after installing plugins such as:
- Easy Gantt (PRO)
- Resource Management
- Easy WBS
on an older Redmine installation.
Step 2: Understand the Cause
The error occurs because:
- Your Redmine version is too old and lacks the required internal classes or methods (like
UserPreference#default_users_hide_mail?) expected by newer plugins. - Plugins rely on core methods introduced in newer Redmine versions.
Step 3: Upgrade to the Current Redmine Version
To resolve the issue:
- Visit the Easy8 Client Zone.
- Download the latest Easy8 package.
- Follow the official upgrade instructions provided with the package or documentation.
- Clear cache and restart the application server after the upgrade:
bundle exec rake tmp:cache:clear tmp:sessions:clear
bundle exec rake easyproject:install RAILS_ENV=production
sudo service puma@your.domain.name restartTip: Always make a full backup of your database and files before upgrading.
Step 4: Verify the Fix
After upgrade:
- Open the interface where the error occurred.
- The page should now render without errors.
- Plugin features should now work as expected.
Conclusion
You have successfully resolved the Userpreference is missing error. The root cause was an outdated Redmine version not compatible with modern plugins. Keeping your Easy8 updated ensures stability and plugin compatibility.
