includes

Name		Name	Last commit message	Last commit date
parent directory ..
abstracts		abstracts
admin		admin
blocks		blocks
cli		cli
customizer		customizer
data-stores		data-stores
emails		emails
export		export
gateways		gateways
import		import
integrations/maxmind-geolocation		integrations/maxmind-geolocation
interfaces		interfaces
legacy		legacy
libraries		libraries
log-handlers		log-handlers
payment-tokens		payment-tokens
queue		queue
rest-api		rest-api
shipping		shipping
shortcodes		shortcodes
theme-support		theme-support
tracks		tracks
traits		traits
walkers		walkers
wccom-site		wccom-site
widgets		widgets
README.md		README.md
class-wc-ajax.php		class-wc-ajax.php
class-wc-api.php		class-wc-api.php
class-wc-auth.php		class-wc-auth.php
class-wc-autoloader.php		class-wc-autoloader.php
class-wc-background-emailer.php		class-wc-background-emailer.php
class-wc-background-updater.php		class-wc-background-updater.php
class-wc-breadcrumb.php		class-wc-breadcrumb.php
class-wc-cache-helper.php		class-wc-cache-helper.php
class-wc-cart-fees.php		class-wc-cart-fees.php
class-wc-cart-session.php		class-wc-cart-session.php
class-wc-cart-totals.php		class-wc-cart-totals.php
class-wc-cart.php		class-wc-cart.php
class-wc-checkout.php		class-wc-checkout.php
class-wc-cli.php		class-wc-cli.php
class-wc-comments.php		class-wc-comments.php
class-wc-countries.php		class-wc-countries.php
class-wc-coupon.php		class-wc-coupon.php
class-wc-customer-download-log.php		class-wc-customer-download-log.php
class-wc-customer-download.php		class-wc-customer-download.php
class-wc-customer.php		class-wc-customer.php
class-wc-data-exception.php		class-wc-data-exception.php
class-wc-data-store.php		class-wc-data-store.php
class-wc-datetime.php		class-wc-datetime.php
class-wc-deprecated-action-hooks.php		class-wc-deprecated-action-hooks.php
class-wc-deprecated-filter-hooks.php		class-wc-deprecated-filter-hooks.php
class-wc-discounts.php		class-wc-discounts.php
class-wc-download-handler.php		class-wc-download-handler.php
class-wc-emails.php		class-wc-emails.php
class-wc-embed.php		class-wc-embed.php
class-wc-form-handler.php		class-wc-form-handler.php
class-wc-frontend-scripts.php		class-wc-frontend-scripts.php
class-wc-geo-ip.php		class-wc-geo-ip.php
class-wc-geolite-integration.php		class-wc-geolite-integration.php
class-wc-geolocation.php		class-wc-geolocation.php
class-wc-https.php		class-wc-https.php
class-wc-install.php		class-wc-install.php
class-wc-integrations.php		class-wc-integrations.php
class-wc-log-levels.php		class-wc-log-levels.php
class-wc-logger.php		class-wc-logger.php
class-wc-meta-data.php		class-wc-meta-data.php
class-wc-order-factory.php		class-wc-order-factory.php
class-wc-order-item-coupon.php		class-wc-order-item-coupon.php
class-wc-order-item-fee.php		class-wc-order-item-fee.php
class-wc-order-item-meta.php		class-wc-order-item-meta.php
class-wc-order-item-product.php		class-wc-order-item-product.php
class-wc-order-item-shipping.php		class-wc-order-item-shipping.php
class-wc-order-item-tax.php		class-wc-order-item-tax.php
class-wc-order-item.php		class-wc-order-item.php
class-wc-order-query.php		class-wc-order-query.php
class-wc-order-refund.php		class-wc-order-refund.php
class-wc-order.php		class-wc-order.php
class-wc-payment-gateways.php		class-wc-payment-gateways.php
class-wc-payment-tokens.php		class-wc-payment-tokens.php
class-wc-post-data.php		class-wc-post-data.php
class-wc-post-types.php		class-wc-post-types.php
class-wc-privacy-background-process.php		class-wc-privacy-background-process.php
class-wc-privacy-erasers.php		class-wc-privacy-erasers.php
class-wc-privacy-exporters.php		class-wc-privacy-exporters.php
class-wc-privacy.php		class-wc-privacy.php
class-wc-product-attribute.php		class-wc-product-attribute.php
class-wc-product-download.php		class-wc-product-download.php
class-wc-product-external.php		class-wc-product-external.php
class-wc-product-factory.php		class-wc-product-factory.php
class-wc-product-grouped.php		class-wc-product-grouped.php
class-wc-product-query.php		class-wc-product-query.php
class-wc-product-simple.php		class-wc-product-simple.php
class-wc-product-variable.php		class-wc-product-variable.php
class-wc-product-variation.php		class-wc-product-variation.php
class-wc-query.php		class-wc-query.php
class-wc-rate-limiter.php		class-wc-rate-limiter.php
class-wc-regenerate-images-request.php		class-wc-regenerate-images-request.php
class-wc-regenerate-images.php		class-wc-regenerate-images.php
class-wc-register-wp-admin-settings.php		class-wc-register-wp-admin-settings.php

README.md

WooCommerce `includes` files

This directory contains WooCommerce legacy code. Ideally, the code in this folder should only get the minimum required changes for bug fixing, and any new code should go in the src directory instead.

Interacting with the `src` folder

Whenever you need to get an instance of a class from the src directory, please don't instantiate it directly, but instead use the container. To get an instance of the container itself you can use the wc_get_container function, for example:

$container = wc_get_container();
$service = $container->get( \Automattic\WooCommerce\TheNamespace\TheService::class );
$service->do_something();

The exception to this rule might be data-only classes that could be created the old way (using a plain new statement); but in general, all classes in the src directory are registered in the container and should be resolved using it.

Adding new actions and filters

Please take a look at the considerations for creation new hooks in src code, as they apply for includes code as well. The short version is that new hooks should be introduced only if they provide a valuable extension point for plugins, and not with the purpose of driving WooCommerce's internal logic.

Writing unit tests

As it's the case for the src folder, writing unit tests is generally mandatory if you are a WooCommerce team member or a contributor from another Automattic team, and encouraged if you are an external contributor. Tests should cover any new code (although as mentioned, adding new code in includes should be rare) and any modifications to existing code.

In order to make it easier to write unit tests, there are a couple of mechanisms in place that you can use:

The code hacker. Pros: you don't need to do any special changes to your code to make it testable. Cons: it's a hack, the tested code is being actually modified while being loaded by the PHP engine, so not an ideal solution.
The legacy proxy and the related helper methods in WC_Unit_Test_case: although these are intended in principle for writing tests for code in the src directory, they can be used for includes code as well. Pros: a clean approach, no hacks involved. Cons: you need to modify your code to use the proxy whenever you need to call a function or static method that makes the code difficult to test.

It's up to you as a contributor to decide which mechanism to use in each case. Choose wisely.

Files

includes

Directory actions

More options

Directory actions

More options

Latest commit

History

includes

Folders and files

parent directory