Add helper functions for retrieving post relationships

.github/_typos.toml

@@ -1,4 +1,13 @@
 [default.extend-words]
 # Add words that should be ignored (define them as themselves)
 Tung = "Tung"  # Example: Don't correct the surname "Tung"
-curent = "curent"  # Intentionally preserving misspelling to avoid breaking changes
+curent = "curent"  # Intentionally preserving misspelling to avoid breaking changes
+
+[type.php]
+extend-ignore-re = [
+    # spellchecker:disable-line:
+    "(?Rm)^.*//\\s*@spellchecker:disable-line(\\b.*)?$",
+
+    # spellchecker:<on|off>:
+    "//\\s*@spellchecker:off\\s*\\n.*\\n\\s*//\\s*@spellchecker:on"
+]

.github/workflows/test-php.yml

@@ -0,0 +1,55 @@
+name: Test PHP
+
+env:
+  COMPOSER_VERSION: "2"
+  COMPOSER_CACHE: "${{ github.workspace }}/.composer-cache"
+
+on:
+  push:
+    branches:
+      - develop
+      - trunk
+  pull_request:
+    branches:
+      - develop
+
+permissions:
+  contents: read
+
+jobs:
+  test-php:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out our repo source code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Set standard 10up cache directories
+        run: |
+          composer config -g cache-dir "${{ env.COMPOSER_CACHE }}"
+
+      - name: Prepare composer cache
+        uses: actions/cache@d4323d4df104b026a6aa633fdb11d772146be0bf # v4.2.2
+        with:
+          path: ${{ env.COMPOSER_CACHE }}
+          key: composer-${{ env.COMPOSER_VERSION }}-${{ hashFiles('**/composer.lock') }}
+          restore-keys: |
+            composer-${{ env.COMPOSER_VERSION }}-
+
+      - name: Set PHP version
+        uses: shivammathur/setup-php@9e72090525849c5e82e596468b86eb55e9cc5401 # v2.32.0
+        with:
+          php-version: '8.2'
+          extensions: :php-psr
+          coverage: none
+
+      - name: Install Node dependencies
+        run: npm ci --omit=optional
+
+      - name: Install dependencies
+        run: composer install --ignore-platform-reqs
+
+      - name: Setup Tests
+        run: npm run test:setup
+
+      - name: Run Tests
+        run: npm run test:all

.gitignore

@@ -1,3 +1,6 @@
+.phpunit.result.cache
+test-results/
+
 # Version Control
 .svn
 

.nvmrc

@@ -0,0 +1 @@
+20

.wp-env.json

@@ -0,0 +1,15 @@
+{
+	"core": "WordPress/WordPress#master",
+	"phpVersion": "8.2",
+	"plugins": [
+		"."
+	],
+	"mappings": {
+		"wp-content/plugins/wp-content-connect": "."
+	},
+	"config": {
+		"WP_DEBUG": true,
+		"SCRIPT_DEBUG": true
+	}
+}
+

composer.json

@@ -18,7 +18,7 @@
     ],
     "minimum-stability": "dev",
     "require": {
-        "composer/installers": "^1.2"
+        "php": "^7.4|^8.0"
     },
     "autoload": {
         "psr-4": {
@@ -31,7 +31,15 @@
         ]
     },
     "require-dev": {
-        "phpunit/phpunit": "^5.7",
-        "10up/wp_mock": "0.2.0"
+        "10up/wp_mock": "^0.3.0",
+        "phpunit/phpunit": "^9.6",
+        "yoast/phpunit-polyfills": "^1.1"
+    },
+    "config": {
+        "sort-packages": true,
+        "optimize-autoloader": true,
+        "allow-plugins": {
+            "composer/installers": true
+        }
     }
 }