Troubleshooting in Recurio

Overview

This guide provides complete troubleshooting in Recurio to help you quickly identify and resolve common issues with subscriptions, payments, emails, and analytics. Whether you’re a store owner or a site administrator, this resource will help you maintain a smooth subscription management experience.

Common Issues and Solutions

Issue 1: Recurio Menu Appears but Dashboard is Empty

Symptoms:

• Recurio loads, but no data appears on the dashboard.
• “No subscriptions found” message displays.

Possible Causes:

• WooCommerce is deactivated.
• Database tables not created.

Solutions:

1. Ensure WooCommerce is installed and active.
2. Reactivate Recurio to recreate database tables.
3. Check PHP version (must be 7.4+).
4. Go to Tools → Site Health → Info → Database to confirm tables like wp_recurio_subscriptions exist.

Issue 2: Customer Portal Not Displaying

Symptoms:

• Shortcode visible but no content.
• My Account tab missing.

Possible Causes:

• Portal not enabled or shortcode incorrect.

Solutions:

1. Go to Recurio → Settings → General and enable Customer Portal.
2. Use correct shortcode: recurio_customer_portal.
3. For WooCommerce My Account integration, re-save permalinks via Settings → Permalinks → Save Changes.
4. Ensure customer is logged in.

💡 Tip: Add show_cancelled="yes" in shortcode to display cancelled subscriptions.

Issue 3: Payments Not Processing Automatically

Symptoms:

• Renewal dates pass without charges.
• Payments only process manually.

Possible Causes:

• Cron job not running.
• Tokenized payment method not saved.

Solutions:

1. Enable auto-renewal: Recurio → Settings → Billing → Auto-Renewal: ON.
2. Verify WP-Cron is active: define('DISABLE_WP_CRON', false); in wp-config.php.
3. Check cron job: install WP Crontrol and run recurio_process_payments manually.
4. Ensure Stripe/PayPal tokens are valid.

⚠️ If on shared hosting, set up a real server cron job for reliability.

Issue 4: Email Notifications Not Sending

Symptoms:

• Customers don’t receive welcome or renewal emails.
• Other WordPress emails work.

Possible Causes:

• Notifications disabled.
• SMTP misconfiguration.

Solutions:

1. Go to Recurio → Settings → Emails and toggle notifications ON.
2. Verify sender details (From Name & From Email).
3. Install WP Mail SMTP and send a test email.
4. Check spam/junk folder.
5. If using an SMTP service, ensure correct authentication.

🧠 Tip: Use domain-based sender email (e.g., [email protected]) to improve deliverability.

Issue 5: Subscriptions Created but No Orders

Symptoms:

• Subscription record exists in Recurio.
• WooCommerce order not created.

Possible Causes:

• WooCommerce hook failed.
• Plugin conflict.

Solutions:

1. Verify WooCommerce version (must be 8.0+).
2. Temporarily disable other plugins to find conflicts.
3. Recreate the subscription manually and link order.
4. Enable debug logging and check /wp-content/debug.log for related errors.

Issue 6: Database Table Missing or Corrupted

Symptoms:

• Error: “Table wp_recurio_subscriptions doesn’t exist.”

Solutions:

1. Deactivate and reactivate Recurio to rebuild tables.
2. If issue persists, manually import the schema from /includes/database-schema.sql.
3. Verify your database user has CREATE TABLE permissions.

Issue 7: Analytics or Dashboard Charts Not Loading

Symptoms:

• Blank graphs or loading spinner persists.

Possible Causes:

• Cached data not refreshing.
• JavaScript conflict.

Solutions:

1. Clear browser and site cache.
2. Check for JavaScript errors in Developer Console.
3. Disable conflicting admin plugins temporarily.
4. Ensure Vue.js assets are loading correctly from assets/vue-dashboard/.

Debug Mode in Recurio

If you can’t identify the issue, enable debug mode to log system events.

Steps:

1. Edit your wp-config.php file and add: define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false);
2. Perform the action that causes the issue.
3. Open /wp-content/debug.log to view the latest log entries.
4. Look for lines containing [Recurio].

🧠 Tip: Disable debug mode afterward by setting define('WP_DEBUG', false);

Getting Help

If the above troubleshooting steps don’t resolve your issue, you can get help from official support channels.

Free Version Support

• WordPress.org Support Forum
• Recurio Documentation and FAQs

Pro Version Support

• Support: https://portal.hasthemes.com
• Response Time: 24–48 hours
• Priority and emergency support available for critical issues.

Best Practices for Troubleshooting in Recurio

• Always keep WordPress, WooCommerce, and Recurio updated.
• Test plugin conflicts using a staging site.
• Use SMTP for reliable email delivery.
• Run WP-Cron regularly for automated renewals.
• Monitor debug logs weekly for early issue detection.

Conclusion

Effective troubleshooting in Recurio ensures your subscription system runs smoothly without interruptions. By following this guide, you can identify and fix most issues related to payments, notifications, analytics, and database operations — keeping your WooCommerce subscription business running seamlessly.