v4.0.0 Migration Guide

This guide is for users upgrading from Nazmart v3.x or earlier to v4.0.0 or later. This is a major system update with significant changes to the website design system, Page Builder structure, and purchase & payment flow.

🔴 Before You Update

Please make sure to complete these steps before upgrading:

• Take a full backup of your website files and database
• Ensure you can restore your previous version if needed

🔧 After Update – Troubleshooting

Website Not Opening / Server Error

Problem: Your website shows a server error or won't load at all after updating.

Solution:

• Contact your hosting provider and update PHP to 8.3 or higher (PHP 8.4 recommended)
• Verify the PHP version is correct before proceeding

Website Design Broken / Not Loading Properly

Problem: The website loads but the design is broken, styles are missing, or pages don't display correctly.

Solution:

1. Go to: Admin Panel → General Settings → Cache Settings
2. Click Clear Cache
3. Refresh your browser and check if the issue is resolved

If the issue persists:

• Manually delete the cache directory: /core/bootstrap/cache/*
• Refresh your browser again

Frontend Broken but Admin Panel Works

Problem: The admin panel works fine, but the customer-facing website is broken.

Why: We introduced a completely new Page Builder system in v4.0.0, so old pages built with the previous builder are not compatible with the new one.

Solution (Required):

1. Login to the Admin Panel
2. Go to Pages
3. Open each page one by one (Home, About, Contact, etc.)
4. Remove all old content
5. Rebuild the page using the new Page Builder widgets
6. Click Save for each page

This manual rebuild is necessary for all existing pages.

Homepage Doesn't Match Demo

Problem: Your homepage looks different from the demo website.

Solution: The demo uses the new Page Builder system with updated widgets and sections. To match the demo:

1. Recreate your homepage using the new Page Builder sections
2. Use the updated widgets available in v4.0.0+
3. Follow the new layout structure shown in the demo

Payment / Purchase Issues

Problem: Payment processing is not working or purchase flow is broken.

Solution:

1. Clear the cache from the admin panel (Admin Panel → General Settings → Cache Settings → Clear Cache)
2. Refresh your browser
3. Try the purchase flow again

If the issue persists, contact support with details about the error message.

✅ Recommended Update Process

Follow these steps carefully to ensure a smooth upgrade:

1. Backup your system

   • Create a full backup of all files (via FTP/File Manager)
   • Create a database backup (via phpMyAdmin or your hosting provider)

2. Upload new update files

   • Download the v4.0.0+ update package
   • Upload all files to your server (via FTP, SFTP, or File Manager)
   • Overwrite existing files when prompted

3. Visit your website

   • Navigate to your website URL to trigger any necessary initialization

4. Login to Admin Panel

   • Login with your admin credentials

5. Click "Update Database" (if available)

   • Some versions may show an "Update Database" button on first login
   • Click it to apply any database schema changes

6. Clear cache

   • Go to Admin Panel → General Settings → Cache Settings
   • Click Clear Cache

7. Rebuild pages using the new builder

   • Go to Pages section
   • Rebuild each page with the new Page Builder
   • Save each page

💡 Important Notes

• Old page designs are NOT compatible with the new Page Builder
• Manual page rebuilding is required — there is no automatic conversion
• This is expected in this major version upgrade
• The new Page Builder is more powerful and flexible than the previous one
• Take time to familiarize yourself with the new builder before going live

Need Help?

If you encounter issues not covered in this guide:

• Check the Changes Logs for detailed release notes
• Visit the Installation Process page for setup help
• Contact Xgenious support with detailed information about your issue