owlstacks · alihesari · Mar 7, 2026 · Mar 7, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.1] - 2025-07-25
+
+### Fixed
+- Added PHPCS inline directives (`phpcs:disable`) to all source, example, and test files for WordPress Plugin Check compatibility
+- Framework-agnostic library files now pass WordPress coding standards when bundled as a vendor dependency in WordPress plugins
+- Suppressed `WordPress.Security.EscapeOutput.ExceptionNotEscaped` — exceptions are not WordPress output in this library
+- Suppressed `WordPress.WP.AlternativeFunctions` — native PHP functions (cURL, json_encode, file_get_contents) are required for framework independence
+- Suppressed `WordPress.PHP.DiscouragedPHPFunctions` — base64_encode/urlencode required for OAuth and API operations
+- Suppressed `WordPress.PHP.NoSilencedErrors` — @unlink used for temporary file cleanup in HttpClient
+- Suppressed `Universal.Operators.DisallowShortTernary` — short ternary intentionally used for concise null/empty handling
+
+## [1.0.0]
+
 ### Added
 - Framework-agnostic PHP core for social media publishing
 - Platform abstractions with `PlatformInterface` and `PlatformResponseInterface`

diff --git a/composer.json b/composer.json
@@ -27,7 +27,9 @@
         "ext-json": "*"
     },
     "require-dev": {
-        "phpunit/phpunit": "^10.0|^11.0"
+        "dealerdirect/phpcodesniffer-composer-installer": "^1.2",
+        "phpunit/phpunit": "^10.0|^11.0",
+        "wp-coding-standards/wpcs": "^3.3"
     },
     "autoload": {
         "psr-4": {
@@ -42,6 +44,9 @@
     "minimum-stability": "stable",
     "prefer-stable": true,
     "config": {
-        "sort-packages": true
+        "sort-packages": true,
+        "allow-plugins": {
+            "dealerdirect/phpcodesniffer-composer-installer": true
+        }
     }
 }
diff --git a/examples/mock/01_creating_posts.php b/examples/mock/01_creating_posts.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/02_media_handling.php b/examples/mock/02_media_handling.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/03_formatting.php b/examples/mock/03_formatting.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/04_platform_config.php b/examples/mock/04_platform_config.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/05_platform_registry.php b/examples/mock/05_platform_registry.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/06_publishing.php b/examples/mock/06_publishing.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/07_error_handling.php b/examples/mock/07_error_handling.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/08_events.php b/examples/mock/08_events.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/09_support_utilities.php b/examples/mock/09_support_utilities.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/10_auth_oauth.php b/examples/mock/10_auth_oauth.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/11_delivery_status.php b/examples/mock/11_delivery_status.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/12_full_workflow.php b/examples/mock/12_full_workflow.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/platform_discord.php b/examples/mock/platform_discord.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/platform_instagram.php b/examples/mock/platform_instagram.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/platform_pinterest.php b/examples/mock/platform_pinterest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/platform_reddit.php b/examples/mock/platform_reddit.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/examples/mock/platform_slack.php b/examples/mock/platform_slack.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Slack Platform Integration Example

diff --git a/examples/mock/platform_tumblr.php b/examples/mock/platform_tumblr.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Tumblr Platform Integration Example

diff --git a/examples/mock/platform_whatsapp.php b/examples/mock/platform_whatsapp.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * WhatsApp Platform Integration Example

diff --git a/examples/real/helpers.php b/examples/real/helpers.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Shared helpers for real API examples.

diff --git a/examples/real/platform_discord.php b/examples/real/platform_discord.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Discord — Real API Example

diff --git a/examples/real/platform_facebook.php b/examples/real/platform_facebook.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Facebook — Real API Example

diff --git a/examples/real/platform_instagram.php b/examples/real/platform_instagram.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Instagram — Real API Example

diff --git a/examples/real/platform_linkedin.php b/examples/real/platform_linkedin.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * LinkedIn — Real API Example

diff --git a/examples/real/platform_pinterest.php b/examples/real/platform_pinterest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Pinterest — Real API Example

diff --git a/examples/real/platform_reddit.php b/examples/real/platform_reddit.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Reddit — Real API Example

diff --git a/examples/real/platform_slack.php b/examples/real/platform_slack.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Slack — Real API Example

diff --git a/examples/real/platform_telegram.php b/examples/real/platform_telegram.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Telegram — Real API Example

diff --git a/examples/real/platform_tumblr.php b/examples/real/platform_tumblr.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Tumblr — Real API Example

diff --git a/examples/real/platform_twitter.php b/examples/real/platform_twitter.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Twitter/X — Real API Example

diff --git a/examples/real/platform_whatsapp.php b/examples/real/platform_whatsapp.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * WhatsApp — Real API Example

diff --git a/src/Auth/OAuthHandler.php b/src/Auth/OAuthHandler.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Auth;
 
 use Owlstack\Core\Auth\Contracts\OAuthProviderInterface;

diff --git a/src/Config/ConfigValidator.php b/src/Config/ConfigValidator.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Config;
 
 use Owlstack\Core\Exceptions\OwlstackException;

diff --git a/src/Config/PlatformCredentials.php b/src/Config/PlatformCredentials.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Config;
 
 /**

diff --git a/src/Http/HttpClient.php b/src/Http/HttpClient.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic HTTP client; uses native cURL/file functions for portability.
+// phpcs:disable WordPress.PHP.DiscouragedPHPFunctions -- base64_encode/urlencode required for multipart encoding.
+// phpcs:disable WordPress.PHP.NoSilencedErrors.Discouraged -- @unlink used for temp file cleanup.
+
 namespace Owlstack\Core\Http;
 
 use Owlstack\Core\Http\Contracts\HttpClientInterface;

diff --git a/src/Platforms/Discord/DiscordPlatform.php b/src/Platforms/Discord/DiscordPlatform.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Platforms\Discord;
 
 use Owlstack\Core\Content\Post;

diff --git a/src/Platforms/Facebook/FacebookPlatform.php b/src/Platforms/Facebook/FacebookPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+
 namespace Owlstack\Core\Platforms\Facebook;
 
 use Owlstack\Core\Content\Post;

diff --git a/src/Platforms/Instagram/InstagramPlatform.php b/src/Platforms/Instagram/InstagramPlatform.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+
 namespace Owlstack\Core\Platforms\Instagram;
 
 use Owlstack\Core\Config\PlatformCredentials;

diff --git a/src/Platforms/LinkedIn/LinkedInPlatform.php b/src/Platforms/LinkedIn/LinkedInPlatform.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+// phpcs:disable WordPress.PHP.DiscouragedPHPFunctions -- urlencode required for URN encoding in API calls.
+
 namespace Owlstack\Core\Platforms\LinkedIn;
 
 use Owlstack\Core\Content\Post;

diff --git a/src/Platforms/Pinterest/PinterestPlatform.php b/src/Platforms/Pinterest/PinterestPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+
 namespace Owlstack\Core\Platforms\Pinterest;
 
 use Owlstack\Core\Config\PlatformCredentials;

diff --git a/src/Platforms/PlatformRegistry.php b/src/Platforms/PlatformRegistry.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Platforms;
 
 use Owlstack\Core\Platforms\Contracts\PlatformInterface;

diff --git a/src/Platforms/Reddit/RedditPlatform.php b/src/Platforms/Reddit/RedditPlatform.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Platforms\Reddit;
 
 use Owlstack\Core\Content\Post;

diff --git a/src/Platforms/Slack/SlackPlatform.php b/src/Platforms/Slack/SlackPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+
 namespace Owlstack\Core\Platforms\Slack;
 
 use DateTimeImmutable;

diff --git a/src/Platforms/Telegram/TelegramPlatform.php b/src/Platforms/Telegram/TelegramPlatform.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+
 namespace Owlstack\Core\Platforms\Telegram;
 
 use Owlstack\Core\Content\Media;

diff --git a/src/Platforms/Tumblr/TumblrPlatform.php b/src/Platforms/Tumblr/TumblrPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+
 namespace Owlstack\Core\Platforms\Tumblr;
 
 use Owlstack\Core\Config\PlatformCredentials;

diff --git a/src/Platforms/Twitter/TwitterPlatform.php b/src/Platforms/Twitter/TwitterPlatform.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+// phpcs:disable WordPress.PHP.DiscouragedPHPFunctions -- base64_encode required for OAuth HMAC-SHA1 signature and media upload.
+
 namespace Owlstack\Core\Platforms\Twitter;
 
 use Owlstack\Core\Content\Media;

diff --git a/src/Platforms/WhatsApp/WhatsAppPlatform.php b/src/Platforms/WhatsApp/WhatsAppPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+
 namespace Owlstack\Core\Platforms\WhatsApp;
 
 use Owlstack\Core\Config\PlatformCredentials;

diff --git a/tests/Unit/Platforms/Discord/DiscordFormatterTest.php b/tests/Unit/Platforms/Discord/DiscordFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 

diff --git a/tests/Unit/Platforms/Discord/DiscordPlatformTest.php b/tests/Unit/Platforms/Discord/DiscordPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
-Original file line number
+Diff line change
@@ Expand Up / @@ -2,6 +2,8 @@ @@
     declare(strict_types=1);
+    // phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
     namespace Owlstack\Core\Config;
     /**
@@ Expand Down @@