Troubleshooting

Solutions to common issues you might encounter when using Classerna.

Installation Issues

"Classerna requires WooCommerce" error

Problem: Error message appears when trying to activate the plugin.

Solution:

1. Go to Plugins > Installed Plugins.
2. Ensure WooCommerce is installed and activated.
3. If WooCommerce isn't installed, install it from Plugins > Add New.
4. Activate WooCommerce first, then activate Classerna.

Plugin doesn't appear in the admin menu

Problem: After activation, Classerna menu isn't visible.

Solutions:

• Check user role - Only Administrators see the full menu
• Clear cache - Refresh the page or clear browser cache
• Check for conflicts - Deactivate other plugins temporarily to test
• Verify activation - Go to Plugins and confirm Classerna shows as "Active"

"Cannot redeclare function" error

Problem: PHP fatal error about redeclaring functions when activating.

Cause: Multiple copies of the plugin are installed (e.g., "classerna" and "classerna-1" folders).

Solution:

1. Deactivate all copies of Classerna.
2. Via FTP or File Manager, go to /wp-content/plugins/.
3. Delete any duplicate Classerna folders (keep only one).
4. Reactivate the plugin.

Course Display Issues

Course page shows 404 error

Problem: Course pages return "Page not found."

Solution: Flush permalink rules:

1. Go to Settings > Permalinks.
2. Click "Save Changes" (no changes needed).
3. Try accessing the course again.

Courses display without styling

Problem: Courses appear unstyled or with broken layout.

Solutions:

• Clear cache - Clear any caching plugins and browser cache
• Check for CSS conflicts - Theme CSS may be overriding plugin styles
• Verify file permissions - CSS files need to be readable
• Check browser console - Look for 404 errors on CSS files

Dark text on dark background

Problem: Text is unreadable on dark-themed sites.

Solution: Classerna includes a light-background wrapper. If issues persist, add this CSS to your theme:

Registration Issues

Registration button not working

Problem: Clicking "Register" does nothing or shows an error.

Solutions:

• Link a WooCommerce product - Ensure a product is selected in Course Details
• Check product status - The linked product must be published and in stock
• Verify JavaScript - Check browser console for JS errors
• Test with default theme - Switch to Twenty Twenty-Four to rule out theme conflicts

Registration questions not saving

Problem: Student answers to registration questions aren't recorded.

Solutions:

• Check browser console - Look for JavaScript errors
• Verify WooCommerce version - Ensure WooCommerce is up to date
• Test with fewer questions - Try with just one question to isolate the issue

"No sessions found" when generating sessions

Problem: Session generation preview shows no sessions.

Solutions:

• Check date range - End date must be after start date
• Select class days - At least one day (Mon, Tue, etc.) must be checked
• Verify dates include selected days - If you selected "Monday" but your date range doesn't include any Mondays, no sessions will generate

Payment Issues

Price showing as $0 or wrong price

Problem: Course displays incorrect pricing.

Solutions:

• Check WooCommerce product - Verify the linked product has the correct price set
• For variable products - Ensure all variations have prices set
• Clear cache - Price data may be cached

Students not enrolled after payment

Problem: Payment completed but student doesn't have course access.

Solutions:

• Check order status - Order must be "Completed" for enrollment to trigger
• Verify product link - Ensure the WooCommerce product is linked to the course
• Check user account - Student must be logged in to see enrolled courses

Email Issues

Enrollment emails not sending

Problem: Students don't receive enrollment confirmation emails.

Solutions:

• Check spam folder - Emails may be marked as spam
• Verify email settings - Check From Email in Classerna Settings
• Use SMTP plugin - Install a plugin like WP Mail SMTP for reliable delivery
• Test email - Use the "Send Test Email" button in Settings

Test email fails to send

Problem: "Send Test Email" shows an error.

Solutions:

• Check PHP mail function - Your host may block PHP mail()
• Install SMTP plugin - Use a dedicated email plugin
• Check email address - Verify the admin email is valid

Performance Issues

Admin pages loading slowly

Problem: Course editor or settings pages are slow.

Solutions:

• Reduce sessions per course - Very many sessions can slow the editor
• Check other plugins - Disable plugins one by one to identify conflicts
• Increase PHP memory - Add to wp-config.php: define('WP_MEMORY_LIMIT', '256M');

Frontend pages loading slowly

Problem: Course archive or single course pages load slowly.

Solutions:

• Enable caching - Use a caching plugin
• Optimize images - Compress course featured images
• Use CDN - Serve static files from a CDN
• Limit courses per page - Reduce the number in Settings

Import/Export Issues

Import fails with error

Problem: Course import doesn't complete.

Solutions:

• Verify JSON format - Ensure the file is valid JSON
• Check file size - Very large files may hit upload limits
• Increase upload limit - Modify php.ini or .htaccess
• Check error messages - The toast notification should indicate the issue

Exported course missing data

Problem: Imported course is missing some information.

Note: The following are intentionally NOT exported:

• WooCommerce product links
• Actual file attachments (only metadata)
• Enrolled students
• Featured image (only URL reference)

Still Having Issues?

If you've tried these solutions and still have problems:

1. Check for plugin conflicts - Deactivate all plugins except WooCommerce and Classerna, test, then reactivate one by one.
2. Test with default theme - Switch to Twenty Twenty-Four temporarily to rule out theme conflicts.
3. Check error logs - Enable WP_DEBUG in wp-config.php and check the debug.log file.
4. Contact support - Email support@insightdezign.com with details about the issue, steps to reproduce, and any error messages.