A Comprehensive Guide to Resolving File Permissions and Theme Issues

Running a WordPress website can sometimes feel like navigating a labyrinth of plugins, themes, and configurations. Even experienced webmasters encounter roadblocks that require methodical troubleshooting. Recently, we faced a puzzling issue on a client’s website, where file permissions and theme-related errors halted our site management. What had happened was that their Plesk powered domain name “all of a sudden” developed permission issues (obviously it wasn’t all f a sudden because I suspect human error to a great degree but that’s by the way). So when we first accessed the server, we couldn’t make any kind of changes to the wp-config or any other critical files for that matter. Here’s a detailed guide on how we resolved these issues, ensuring their website remained up-to-date and functional.

The Problem

We encountered several challenges:

1. File Permission Errors: Plugins and themes displayed error messages, indicating insufficient read/write permissions.
2. Theme Issues: Switching between themes, particularly to the Twenty Twenty-One theme, revealed backend errors.
3. Backup Restoration Concerns: Restoring a backup while retaining the latest posts and database updates posed a significant challenge.

Step-by-Step Solution

1. Diagnosing Permission Issues

Initial Symptoms:

• Error messages indicating lack of necessary permissions.
• Inability to delete or move files within the WordPress directory.

Solution: Using SSH, we connected to the server to update directory and file permissions:

sudo find /var/www/vhosts/your-domain/httpdocs -type d -exec chmod 755 {} \;
sudo find /var/www/vhosts/your-domain/httpdocs -type f -exec chmod 644 {} \;

Outcome: Ensuring correct permissions allowed plugins to function properly and resolved the initial errors.

2. Updating Ownership

Identification:

• The user associated with the domain was your-plesk-user.

Action: Updating ownership using the correct user:

sudo chown -R your-plesk-user:psacln /var/www/vhosts/your-domain/httpdocs

Verification: Listing the directory contents to confirm ownership:

ls -la /var/www/vhosts/your-domain/httpdocs

3. Switching Themes via phpMyAdmin

Challenges:

• The Twenty Twenty-One theme displayed errors that required a switch back to our original theme.

Solution: Updating the theme settings directly in the database:

Using SQL in phpMyAdmin:

UPDATE `wp_options` SET `option_value` = 'your-original-theme' WHERE `option_name` = 'template';
UPDATE `wp_options` SET `option_value` = 'your-original-theme' WHERE `option_name` = 'stylesheet';

4. Safely Restoring a Backup

Concerns:

• Ensuring the restoration of file system backups without losing recent posts and database updates.

Steps:

1. Backup Current Database:
   • Using phpMyAdmin to export the current database.
2. Restore Files from OneDrive:
   • Utilizing Plesk’s restore function to selectively restore file backups.
3. Re-import Database:
   • If necessary, re-importing the current database to ensure all posts remain up-to-date.

Comprehensive Insights and Tips

Understanding File Permissions and Ownership:

• Permissions ensure that WordPress and its plugins can read and write necessary files.
• Correct ownership ensures that the appropriate user has control over the files, preventing unauthorized access or modifications.

Switching Themes:

• phpMyAdmin is a powerful tool for directly modifying the WordPress database, allowing theme changes even when the WordPress dashboard is inaccessible.

Backup Strategies:

• Regular backups are crucial. Keep both file and database backups up-to-date to ensure easy restoration without data loss.
• Use hosting solutions like Plesk to simplify backup and restoration processes.

Clearing Caches:

• After major changes, clearing WordPress and server caches ensures that new configurations are reflected without old data causing conflicts.

Conclusion

By meticulously updating permissions, changing ownership, and strategically managing backups, we successfully resolved the issues on their domain. This experience underscores the importance of understanding server management, database operations, and WordPress intricacies. We hope this guide helps others navigate similar challenges with confidence and ease. While this is highly useful for WordPress applications running on Plesk, it can work for sites not powered by Plesk too.