WordPress Setup
Configure WordPress and WooCommerce for WooNuxt
This section covers everything you need to configure on the WordPress side for WooNuxt to work properly.
Overview
WooNuxt requires a properly configured WordPress installation with WooCommerce and several plugins to function as a headless eCommerce backend.
Required Components
- WordPress 6.9.4+ - Core WordPress installation with proper permalinks
- WooCommerce 10.7.0+ - Fully configured with products, shipping, and payments
- WooNuxt Settings Plugin - Essential plugin that configures everything for you
- WPGraphQL 2.12.0+ - Exposes WordPress data via GraphQL (auto-installed)
- WooGraphQL 1.0.2+ - Adds WooCommerce support to WPGraphQL (auto-installed)
- Headless Login 0.4.4+ - Enables customer authentication (auto-installed)
Setup Process
Follow these guides in order:
- Initial Configuration - Set up WordPress basics and permalinks
- Plugin Setup - Install and configure WooNuxt Settings plugin (version 2.5.9+)
Quick Checklist
Before proceeding to frontend setup, ensure:
- Permalinks set to "Post name"
- At least one product published
- Product attributes created and assigned
- Shipping zones configured
- Payment method enabled
- WooNuxt Settings plugin installed
- Required plugins auto-installed
- Global attributes configured
- GraphQL endpoint accessible
- Test queries work in GraphiQL IDE
Why This Setup Works
- ⚡ Fast Performance: Static generation and optimized delivery
- 🎨 Design Freedom: Complete control over frontend appearance
- 🔒 Secure: WordPress admin hidden from public
- 📈 Scalable: Frontend can be deployed on CDN
- 🔧 Maintainable: Updates to WordPress don't break frontend
- 🌍 Multi-Platform: Same backend can power web, mobile, etc.