The Modern WooCommerce Developer Workflow

In today’s episode, the conversation moves into the fast-evolving world of WooCommerce development. As building for WooCommerce rapidly changes with the introduction of blocks, AI-assisted coding, and new workflows. Our hosts James Kemp and Katie Keith are joined by Woo developer advocate Brian Coords. They look at what it takes to build modern, scalable stores. Whether you’re just starting out or looking to update your toolkit, we’ll explore the tools, best practices, and strategies shaping WooCommerce development today.

Thanks to our sponsor

If you’re building stores on WordPress, WooCommerce gives you the flexibility and control to do it right. Own your stack, own your data, and build exactly what your clients need. Learn more at woo.com/dothewoo


Takeaways

  • Developer Advocate Role: Brian described his job as a developer advocate at Woo, acting as a bridge between WooCommerce engineers and the broader developer community, supporting builders of stores, agencies, and extension authors by gathering feedback and addressing developer needs 01:23.
  • Most Active Communication Channels: Brian noted that X (Twitter) is probably the most popular interaction channel for developers right now, but LinkedIn is also strong due to WooCommerce’s business focus; Woo community Slack and Reddit were also mentioned as active spaces 02:57.
  • Preferred Local Development Tools: Brian uses WordPress Playground for quick testing, WordPress Studio for local site setups, and primarily Herd (a Laravel-based tool) for most WordPress/WooCommerce development due to its strong PHP/JS handling and features like DB and email tracking 04:30. James also highlighted quick site spin-ups using Raycast shortcuts linked to Playground 06:15.
  • Beta Tester Plugin and Feature Flags: Both Brian and James emphasized the WooCommerce beta tester plugin as valuable for trying new or upcoming Woo features, toggling feature flags, and safely testing experimental changes before they’re merged into core 07:09. They explained how feature flags transition from experimental to ready-for-production, encouraging developers to avoid building significant functionality on experimental features 10:20.
  • Safe Extension Practices: Brian recommended starting with WooCommerce developer documentation, relying on public functions, filters, and hooks instead of modifying the database directly or editing core/plugin files, advocating safe, maintainable extension methods that align with WordPress standards 14:01.
  • Adapting to Blocks and React: The “block era” changes how WooCommerce is extended. Brian advised using available block filters, template parts, and custom blocks if needed, but noted a shift as WooCommerce adopts a React/Interactivity API approach for extensibility, which is still evolving 16:26.
  • Openness to Developer Feedback: James and Brian both encouraged reaching out if developers encounter limitations with extensibility, highlighting openness to requests and help through Slack and direct communication channels 19:01.
  • AI and Agent Skills: James referenced the Woo GitHub repo’s agent skills to support AI-assisted development and streamline code-related tasks; Brian noted agents can help with documentation, PRs, and issues, provided the codebase stays clean and up to date 20:17.
  • PHP to React Settings Page Transition: Brian discussed the new system in Woo 10.9+ for automatically converting PHP-based settings pages into React-based components—if developers follow Woo’s recommended setup, the transition can be as simple as adding a line of code 23:06.
  • Custom Block Building Approaches: Brian said developers can now build blocks with only PHP (no JavaScript required), but those familiar with React/JS can leverage AI’s strength in writing React. He also noted that agent skills can occasionally help, especially for complex or less-documented areas 28:28.
  • AI’s Transformational Impact: For local development or store-building tasks, Brian described how agents and AI tools can manage tasks like spinning up sites, generating test data, or running browser/CLI commands, but stressed the need for human oversight—especially for visual/design fidelity and nuanced problem-solving 33:21.
  • Theme and Pattern Use for Design Consistency: Rather than having AI reinvent design from scratch, Brian recommended using robust block themes like Ollie and leveraging predefined patterns, noting this leads to better design consistency and helps merchants and agencies stick to strong brand guidelines 35:28.
  • Automated and Manual Testing Necessity: On shipping code, Brian urged merchants and developers to employ automated testing (like Woo’s QIT suite for extensions) and maintain robust staging environments, as testing is vital given the huge variety of plugin, theme, and hosting combinations 45:23. He also highlighted that Automattic carefully rolls out updates in stages and monitors for issues before fully releasing new WooCommerce versions 48:37.
  • Version Control Is Essential: James and Brian agreed that Git and code backups are essential for custom WooCommerce work, enabling safe rollbacks and structured releases. Brian advocated using trusted extensions, especially for critical functions, over custom “vibe coding” for business-critical stores 50:19.
  • Community and Support Resource Accessibility: Brian concluded that Woo is becoming increasingly open and accessible, pointing listeners to the developer blog, GitHub issues, community Slack, and local meetups as the best places to get help, insights, and engage with the Woo team and engineers 53:32.

Questions Asked in this Episode

Q: What are the best tools and workflows for setting up local WooCommerce development environments?
A: According to Brian Coords, developers can use tools like WordPress Playground and WordPress Studio for quick site setups, with Herd (a Laravel tool) highly recommended for robust local development due to its handling of PHP, JavaScript, database, and email tracking. These tools make spinning up a new WooCommerce site fast and reliable, enabling easy testing and development.

Q: How should developers safely extend WooCommerce without causing issues during updates?
A: Brian Coords and James Kemp emphasized using WooCommerce’s documented functions, filters, and hooks—never editing the core files or directly manipulating the database. This ensures that updates remain safe and your customizations won’t break with future WooCommerce releases, as extensions should be built using public APIs and wrapper classes.

Q: What are WooCommerce feature flags and how should developers use them when building or testing new features?
A: Feature flags in WooCommerce allow developers to toggle experimental or in-development features. Brian Coords advises using these flags to test and provide feedback, but warns against building production-dependent features on anything marked as “experimental” as such features may change significantly before their full release.

Q: How can AI tools and coding agents help with WooCommerce and WordPress development workflows?
A: AI tools like Codex and coding agents can assist with coding, testing, and even running command-line tasks in local environments. Brian Coords notes these tools are particularly good at working with React and PHP, automating repetitive tasks, and helping navigate complex codebases as long as the developer provides good context and double-checks the results.

Q: What’s the recommended approach to building custom blocks for WooCommerce, especially for developers with a PHP background?
A: Brian Coords highlighted that with recent WordPress updates, developers can now write many blocks in PHP, making it easier for those less familiar with JavaScript and React. For more advanced customizations, AI can help generate React code, and leveraging core blocks and patterns is encouraged for design consistency and easier maintenance.

Q: How is the WooCommerce team making it easier to modernize admin settings pages with React?
A: WooCommerce is rolling out a system that converts existing PHP-based settings pages to modern React-powered interfaces without requiring extensive rewrites. If developers have built settings pages using WooCommerce’s recommended classes, they can adopt the new UI with minimal code changes, benefiting from a unified and updated interface.

Q: What are the best practices for testing WooCommerce changes, especially for critical workflows like checkout and payments?
A: The podcast stresses always testing on a staging environment before updating WooCommerce or extensions, especially for stores handling real transactions. Automated tools are used by the WooCommerce team to test against various plugin and theme combinations, but merchants should maintain their own backup and testing routines to ensure nothing breaks during updates.

Q: How can developers and merchants get support or give feedback about WooCommerce development?
A: Brian Coords recommends joining the WooCommerce Community Slack, using the developer blog at developer.woo.com, and filing issues or PRs on GitHub. These channels enable direct communication with the Woo engineering team and broader community, facilitating feedback, support, and awareness of ongoing changes.

Audio Timestamps

  • 00:00 Role of a Developer Advocate
  • 04:30 Tools for WordPress Development
  • 07:09 WooCommerce beta tester plugin usage
  • 11:06 Developing and testing experimental features
  • 14:35 Safe plugin and database practices
  • 17:36 Front-end interactivity with APIs
  • 23:06 Updating WooCommerce with React
  • 25:54 Custom React Components in WooCommerce
  • 29:04 PHP blocks and AI with React
  • 32:05 Developing and customizing with WordPress
  • 35:28 Benefits of using block themes
  • 39:09 AI and WordPress block editor challenges
  • 42:56 Optimizing WooCommerce for Simplicity
  • 46:26 Testing plugins and site updates
  • 48:37 Managing WooCommerce Releases at Automattic
  • 52:02 Replacing SaaS with custom solutions
  • 54:11 Promoting community engagement platforms

Mentioned Links

WooCommerce Beta Tester Plugin (Testing Future Releases & Feature Flags) – A plugin that lets you test upcoming WooCommerce releases and toggle feature flags in a user-friendly UI.
🔗 https://wordpress.org/plugins/woocommerce-beta-tester/

Developer Woo Blog (Official Announcements & Dev Resources) – The official WooCommerce developer blog for feature announcements, testing calls, and the plugin roadmap.
🔗 https://developer.woo.com/

WordPress Playground (Fast, Disposable Test Sites) – Instantly spin up WordPress & WooCommerce test sites in your browser for quick prototyping and troubleshooting.
🔗 https://playground.wordpress.net/

WordPress Studio (Local WordPress Development App) – A desktop app for setting up local WordPress sites with easy integration and a built-in coding agent.
🔗 https://wordpress.com/studio/

Ollie Theme (Block Theme for Woo Stores) – A block-based WordPress theme with patterns and layouts designed for WooCommerce stores.
🔗 https://olliewp.com/

WooCommerce Marketplace (Selling WooCommerce Plugins) – The official marketplace for distributing and selling WooCommerce plugins and extensions.
🔗 https://woocommerce.com/products/

Woo Meetups (Local Developer & Merchant Events) – Find and join WooCommerce-focused meetups and WordPress events for networking and learning.
🔗 https://developer.woo.com/meetups/

Transcript

Discover more from Do the Woo

Subscribe now to keep reading and get access to the full archive.

Continue reading