phpcs.xml

<?xml version="1.0"?>
<ruleset name="WordPress Plugin Coding Standards">
    <description>WordPress coding standards</description>

    <!-- Files to check -->
    <file>.</file>

    <!-- Exclude patterns -->
    <exclude-pattern>*/vendor/*</exclude-pattern>
    <exclude-pattern>*/.private/*</exclude-pattern>
    <exclude-pattern>*/node_modules/*</exclude-pattern>
    <exclude-pattern>*/tests/*</exclude-pattern>
    <exclude-pattern>*/.git/*</exclude-pattern>
    <exclude-pattern>*/.github/*</exclude-pattern>
    <exclude-pattern>*/build/*</exclude-pattern>
    <exclude-pattern>*/dist/*</exclude-pattern>
    <exclude-pattern>*/css/*</exclude-pattern>
    <exclude-pattern>*/js/*</exclude-pattern>
    <exclude-pattern>*/stubs/*</exclude-pattern>
    <exclude-pattern>*.css</exclude-pattern>
    <exclude-pattern>*.js</exclude-pattern>

    <!-- Use WordPress-Extra coding standards (includes WordPress-Core) -->
    <rule ref="WordPress-Extra">
        <!-- Allow short array syntax [] instead of array() -->
        <exclude name="Generic.Arrays.DisallowShortArraySyntax"/>

        <!-- Allow longer lines for readability -->
        <exclude name="Generic.Files.LineLength"/>

        <!-- Allow direct database queries when using $wpdb properly -->
        <exclude name="WordPress.DB.DirectDatabaseQuery"/>
    </rule>

    <!-- WordPress documentation standards -->
    <rule ref="WordPress-Docs"/>

    <!-- Disabled: these rules enforce spaces instead of tabs, which conflicts with WordPress standards. -->
    <!-- WordPress standards require tabs for indentation, not spaces. -->
    <!--
    <rule ref="Generic.WhiteSpace.DisallowTabIndent">
    </rule>
    <rule ref="Generic.WhiteSpace.ScopeIndent">
        <properties>
            <property name="indent" value="4"/>
            <property name="tabIndent" value="false"/>
        </properties>
    </rule>
    -->

    <!-- Disabled: space-indent flagging is not needed with tab indentation. -->
    <!--
    <rule ref="Generic.WhiteSpace.DisallowSpaceIndent">
        <exclude name="Generic.WhiteSpace.DisallowSpaceIndent"/>
    </rule>

    <rule ref="Generic.WhiteSpace.DisallowSpaceIndent.SpacesUsed">
        <exclude name="Generic.WhiteSpace.DisallowSpaceIndent.SpacesUsed"/>
    </rule>
    -->

    <!-- Disabled: WordPress allows tabs for indentation. -->
    <!--
    <rule ref="Universal.WhiteSpace.DisallowInlineTabs">
    </rule>
    -->

    <!-- Additional WordPress-specific spacing rules -->
    <rule ref="WordPress.WhiteSpace.ControlStructureSpacing"/>
    <rule ref="WordPress.WhiteSpace.OperatorSpacing"/>

    <!-- Enforce WordPress indentation standards -->
    <rule ref="WordPress.Arrays.ArrayIndentation"/>
    <rule ref="WordPress.Arrays.MultipleStatementAlignment"/>

    <!-- WordPress function call formatting -->
    <rule ref="PEAR.Functions.FunctionCallSignature">
        <properties>
            <property name="allowMultipleArguments" value="false"/>
        </properties>
    </rule>

    <!-- WordPress class and method formatting -->
    <rule ref="PSR2.Classes.ClassDeclaration"/>
    <rule ref="PSR2.Methods.MethodDeclaration"/>

    <!-- File formatting -->
    <rule ref="Generic.Files.ByteOrderMark"/>
    <rule ref="Generic.Files.LineEndings">
        <properties>
            <property name="eolChar" value="\n"/>
        </properties>
    </rule>

    <!-- WordPress security and best practices -->
    <rule ref="WordPress.Security"/>

    <!-- WooCommerce registers this capability when active. -->
    <rule ref="WordPress.WP.Capabilities">
        <properties>
            <property name="custom_capabilities" type="array">
                <element value="manage_woocommerce"/>
                <element value="edit_product"/>
            </property>
        </properties>
    </rule>

    <!-- WordPress internationalization configuration -->
    <rule ref="WordPress.WP.I18n">
        <properties>
            <!-- Set the text domain for internationalization -->
            <property name="text_domain" type="array">
                <element value="optimizations-ace-mc"/>
            </property>
        </properties>
    </rule>

    <!-- WordPress naming conventions (snake_case) -->
    <rule ref="WordPress.NamingConventions.ValidFunctionName"/>
    <rule ref="WordPress.NamingConventions.ValidVariableName"/>
    <rule ref="WordPress.NamingConventions.ValidHookName"/>

    <!-- WordPress PHP compatibility -->
    <rule ref="PHPCompatibilityWP">
        <include-pattern>*\.php$</include-pattern>
    </rule>

    <!-- PHPCSExtra standards for additional code quality checks -->
    <rule ref="Modernize">
        <exclude name="Modernize.FunctionCalls.Dirname.Nested"/>
    </rule>

    <!-- Allow PHP short array syntax. -->
    <rule ref="Universal.Arrays.DisallowShortArraySyntax">
        <severity>0</severity>
    </rule>

    <rule ref="NormalizedArrays">
        <exclude name="Universal.Arrays.DisallowShortArraySyntax"/>
    </rule>

    <!-- Set minimum WordPress version for deprecated function checks -->
    <config name="minimum_wp_version" value="6.8"/>
    <config name="testVersion" value="8.2-"/>

    <!-- Show progress -->
    <arg value="p"/>

    <!-- Show sniff codes in all reports -->
    <arg value="s"/>

    <!-- Use colors in output -->
    <arg name="colors"/>

</ruleset>