Woocommerce Backend Dev

WooCommerce Backend Development

This skill provides guidance for developing WooCommerce backend PHP code according to project standards and conventions.

When to Use This Skill

ALWAYS invoke this skill before:

• Writing new PHP unit tests (*Test.php files)
• Creating new PHP classes
• Modifying existing backend PHP code
• Adding hooks or filters

Instructions

Follow WooCommerce project conventions when adding or modifying backend PHP code:

1. Creating new code structures: See file-entities.md [blocked] for conventions on creating classes and organizing files (but for new unit test files see unit-tests.md [blocked]).
2. Naming conventions: See code-entities.md [blocked] for naming methods, variables, and parameters
3. Coding style: See coding-conventions.md [blocked] for general coding standards and best practices
4. Type annotations: See type-annotations.md [blocked] for PHPStan-aware PHPDoc annotations
5. Working with hooks: See hooks.md [blocked] for hook callback conventions and documentation
6. Dependency injection: See dependency-injection.md [blocked] for DI container usage
7. Data integrity: See data-integrity.md [blocked] for ensuring data integrity when performing CRUD operations
8. Writing tests: See unit-tests.md [blocked] for unit testing conventions

Key Principles

• Always follow WordPress Coding Standards
• Use class methods instead of standalone functions
• Place new internal classes in src/Internal/ by default
• Use PSR-4 autoloading with Automattic\WooCommerce namespace
• Write comprehensive unit tests for new functionality
• Run linting and tests before committing changes

Version Information

To determine the next WooCommerce version number for @since annotations:

• Read the $version property in includes/class-woocommerce.php on the trunk branch
• Remove the -dev suffix if present
• Example: If trunk shows 10.4.0-dev, use @since 10.4.0
• Note: When reviewing PRs against trunk, the version in trunk is correct even if it seems "future" relative to released versions