Merge branch 'develop' into trunk

Author: dkotter

.eslintignore

@@ -3,5 +3,5 @@ node_modules
 tests/*
 vendor/*
 bin/*
-hookdocs/*
+wp-hooks-docs/*
 docs/*

.gitattributes

@@ -5,7 +5,7 @@
 /.vscode export-ignore
 /bin export-ignore
 /docs export-ignore
-/hookdocs export-ignore
+/wp-hooks-docs export-ignore
 /node_modules export-ignore
 /release export-ignore
 /src export-ignore
@@ -21,7 +21,6 @@
 /composer.lock export-ignore
 /CONTRIBUTING.md export-ignore
 /CREDITS.md export-ignore
-/hookdoc-conf.json export-ignore
 /LICENSE.md export-ignore
 /package-lock.json export-ignore
 /package.json export-ignore
@@ -32,3 +31,4 @@
 /README.md export-ignore
 /tsconfig.json export-ignore
 /webpack.config.js export-ignore
+/wp-hooks-doc.json export-ignore

.github/hookdoc-tmpl/README.md

@@ -0,0 +1,42 @@
+name: Build Developer Docs
+
+on:
+  push:
+    branches:
+    - trunk
+
+jobs:
+  release:
+    name: Push (merge) to trunk
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+    - name: Setup proper PHP version
+      uses: shivammathur/setup-php@9e72090525849c5e82e596468b86eb55e9cc5401 # v2.32.0
+      with:
+        php-version: 8.3
+
+    - name: Setup node
+      uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e # v4.3.0
+      with:
+        node-version-file: .nvmrc
+
+    - name: Install dependencies and build assets
+      run: |
+        npm install
+        npm run build
+        npm run makepot
+        composer install --no-dev -o
+
+    - name: Build docs
+      run: |
+        npm run build:docs
+
+    - name: Deploy docs update
+      uses: peaceiris/actions-gh-pages@4f9cc6602d3f66b9c108549d475ec49e8ef4d45e # v4.0.0
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: './docs/build'

.github/hookdoc-tmpl/layout.tmpl

@@ -48,7 +48,7 @@ jobs:
       run: |
         npx mochawesome-merge ./tests/cypress/reports/*.json -o tests/cypress/reports/mochawesome.json
         rm -rf ./tests/cypress/reports/mochawesome-*.json
-        npx mochawesome-json-to-md -p ./tests/cypress/reports/mochawesome.json -o ./tests/cypress/reports/mochawesome.md
+        npx mochawesome-json-to-md -p ./tests/cypress/reports/mochawesome.json -o ./tests/cypress/reports/mochawesome.md -t ./tests/cypress/template.md
         npx mochawesome-report-generator tests/cypress/reports/mochawesome.json -o tests/cypress/reports/
         cat ./tests/cypress/reports/mochawesome.md >> $GITHUB_STEP_SUMMARY
 

.github/hookdoc-tmpl/static/styles-10up.css

@@ -52,17 +52,3 @@ jobs:
           git checkout $HEAD_REF
           ./vendor/bin/phpcs-changed -s --git --git-base origin/${{ github.base_ref }} ${{ steps.changed-files.outputs.all_changed_files }}
 
-  vipcs:
-    name: vipcs
-    runs-on: ubuntu-latest
-
-    steps:
-    - name: Checkout
-      uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-
-    - name: VIPCS check
-      uses: 10up/wpcs-action@4b2d47a70e3a0a9c08b40a4a90bc3ccbbdc12b3f # v1.7.0
-      with:
-        enable_warnings: true
-        standard: 'WordPress-VIP-Go'
-        excludes: 'tests'

.github/workflows/build-docs.yml

@@ -37,4 +37,5 @@ jobs:
           build-dir: ${{ github.event.repository.name }}
           exclude-checks: 'plugin_readme,plugin_updater' # Plugin isn't on .org so excluding these for now.
           exclude-directories: 'assets,dist,vendor'
+          ignore-codes: 'PluginCheck.CodeAnalysis.DiscouragedFunctions.load_plugin_textdomainFound' # Plugin isn't on .org so we load the textdomain manually.
           ignore-warnings: true

.github/workflows/cypress.yml

@@ -39,11 +39,3 @@ jobs:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         MESSAGE: 'Release: ({sha}) {msg}'
 
-    - name: Build docs
-      run: npm run build:docs
-
-    - name: Deploy docs update
-      uses: peaceiris/actions-gh-pages@4f9cc6602d3f66b9c108549d475ec49e8ef4d45e # v4.0.0
-      with:
-        github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: './docs'