Troubleshooting

Possible causes and solutions:

• Check cart template: Ensure you are using the bs5_default template in VirtueMart. The plugin only works with this template.
  • Go to Components → VirtueMart → Configuration → Templates
  • Verify that bs5_default is selected as the cart template
  • If not, change it to bs5_default and save
• Clear cache: Clear your Joomla cache:
  • Go to System → Clear Cache
  • Clear all cache and also clear your browser cache
• Check plugin status: Verify the plugin is enabled:
  • Go to Extensions → Plugins
  • Search for "Multi-Step Checkout"
  • Make sure the status is set to "Enabled"

Possible causes and solutions:

• Check compatibility: Verify your Joomla and VirtueMart versions:
  • Joomla: Must be version 4.x or 5.x
  • VirtueMart: Must be version 4.0.x - 4.4.x
  • Check versions in System → System Information
• Check file permissions: Ensure the plugin files have correct permissions:
  • Plugin files should be readable (644 for files, 755 for directories)
  • Check /plugins/vmcustom/multistepcheckout/ directory
• PHP version: Make sure you're using PHP 7.4 or higher (recommended: PHP 8.0+)
• Try manual installation: If automatic installation fails, try extracting the ZIP file and uploading via FTP to the appropriate Joomla directories

Possible causes and solutions:

• Template compatibility: Make sure you're using bs5_default template (see above)
• JavaScript conflicts: Check for JavaScript errors in browser console:
  • Press F12 to open developer tools
  • Go to Console tab
  • Look for any red error messages
  • Disable other plugins temporarily to check for conflicts
• CSS conflicts: Some custom CSS might interfere. Try:
  • Disable custom CSS temporarily
  • Check if the default VirtueMart styling is applied correctly

Possible causes and solutions:

• Language files: Check if language files are installed correctly:
  • Verify language files exist in plugins/vmcustom/multistepcheckout/language/[lang-code]/
  • For example: plugins/vmcustom/multistepcheckout/language/en-GB/en-GB.plg_vmcustom_multistepcheckout.ini
• Clear cache: Clear Joomla and browser cache (see above)
• Check browser compatibility: Make sure you're using a modern browser (Chrome, Firefox, Edge, Safari - latest versions)

Possible causes and solutions:

• Bootstrap 5: Ensure Bootstrap 5 is properly loaded in your Joomla template
• Responsive CSS: Check if your custom CSS is overriding responsive styles
• Template compatibility: Some templates might interfere with Bootstrap 5 responsive classes