Maintainers: The WPForms team

License: GPLv2 any later version.
License URI: http://www.gnu.org/licenses/gpl-2.0.html

WPForms coding standards are based on the WordPress Coding Standards and the PHPCompatibility Coding Standards and help create strict and high-quality code.

composer require awesomemotive/wpforms-phpcs --dev 

Create the .phpcs.xml or phpcs.xml file at the root of your project:

<?xml version="1.0"?> <ruleset name="WPForms CS">	<description>The WPForms coding standard.</description>	<exclude-pattern>\vendor/*</exclude-pattern>	<exclude-pattern>\.github/*</exclude-pattern>	<config name="testVersion" value="7.2-"/>	<config name="multi_domains" value="true"/>	<config name="minimum_supported_wp_version" value="5.5"/>	<rule ref="WPForms"/>	<rule ref="WPForms.PHP.ValidateDomain">	<properties>	<property name="wpforms-lite" value="wpforms"/>	<property name="wpforms" value="wpforms/pro/,wpforms/src/Pro/"/>	</properties>	</rule> </ruleset>

The WPForms.PHP.ValidateDomain sniff validates that you are using the correct text domain for i18n functions such as __(), _e(), _n(), etc.

By default, this sniff works for one domain in the project. We get a directory name based on the vendor directory or the location of the phpcs.xml/.phpcs.xml file.

You can install our package to the plugins directory and enable the multi-domain mode. in this case, the text domain will be the next folder name in the path. Structure:

../wp-content/plugins/ # → Root ├── wpforms/ # → `wpforms` domain. └── wpforms-stripe/ # → `wpforms-stripe` domain. 

In your config you should enable the multi_domains property:

<?xml version="1.0"?> <ruleset name="WPForms CS"> <!-- ... -->	<config name="multi_domains" value="true"/> <!-- ... --> </ruleset>

If you have different domains for directories inside your project (for example, for free and paid versions) and want to redefine the text domain for some paths:

../wp-content/plugins/ # → Root ├── wpforms/ # → `wpforms-lite` domain. │ ├── pro/ # → `wpforms` domain. │ └── src/ # → `wpforms-lite` domain. │ ├── Admin/ # → `wpforms-lite` domain. │ └── Pro/ # → `wpforms` domain. └── wpforms-stripe/ # → `wpforms-stripe` domain. 

In this case, you should add to the config file the property with name as a text domain and value as a path. If a domain has several paths, then list them via commas.

<?xml version="1.0"?> <ruleset name="WPForms CS"> <!-- ... -->	<config name="multi_domains" value="true"/>	<rule ref="WPForms.PHP.ValidateDomain">	<properties>	<property name="wpforms-lite" value="wpforms"/>	<property name="wpforms" value="wpforms/pro/,wpforms/src/Pro/"/>	</properties>	</rule> <!-- ... --> </ruleset>