phpcs.xml.dist

<?xml version="1.0"?>
<ruleset name="CDCF">
  <description>
    PHP_CodeSniffer configuration for the CDCF WordPress plugin and theme.

    Codacy detects this file at the repo root and uses it INSTEAD of its
    default coding standard for this repository's PHP analysis. The
    config is intentionally minimal:

    1. Codacy's default standard bundles file-inclusion sniffs (e.g.
       "Avoid Including Files Dynamically" and "Avoid insecure file
       inclusion") that flag `require_once __DIR__ . '/...'` — the
       canonical WordPress plugin entry-loading pattern — as though
       the path operand were user-controlled. Both operands are
       compile-time constants (a magic constant and a string literal),
       so the pattern is safe by inspection. Pulling in PSR12 or a
       similar full standard would replace the noise with a different
       kind of noise (camelCase function naming, line-length, doc-block
       requirements that don't match WordPress plugin conventions).

    2. The three Generic sniffs below are universal good practice and
       do not conflict with WordPress: Unix line endings, no PHP short
       open tags, and no error-silencing `@` operator.

    To add stricter checks later, prefer per-rule `<rule ref="Generic.X.Y" />`
    over `<rule ref="PSR12" />` so the WP-friendly function/file
    conventions remain valid.
  </description>

  <!-- Analyse only the plugin and theme PHP under wordpress/. -->
  <file>wordpress/plugins/cdcf-redis-translations</file>
  <file>wordpress/themes/cdcf-headless</file>

  <!-- Exclude infrastructure paths PHPCS shouldn't touch. -->
  <exclude-pattern>*/vendor/*</exclude-pattern>
  <exclude-pattern>*/tests/*</exclude-pattern>
  <exclude-pattern>*/.phpunit.cache/*</exclude-pattern>

  <!-- Minimum-signal sniffs that don't conflict with WP plugin idioms. -->
  <rule ref="Generic.Files.LineEndings">
    <properties>
      <property name="eolChar" value="\n" />
    </properties>
  </rule>
  <rule ref="Generic.PHP.DisallowShortOpenTag" />
  <rule ref="Generic.PHP.NoSilencedErrors" />
</ruleset>