From 17a5d2f7418364ea425993a1d6e858828b089ab9 Mon Sep 17 00:00:00 2001
From: Dennis Dornon <dennisdornon@users.noreply.github.com>
Date: Thu, 13 Mar 2025 14:06:30 -0400
Subject: [PATCH] Update code reference documentation

---
 .DS_Store                         | Bin 0 -> 6148 bytes
 .github/.DS_Store                 | Bin 0 -> 6148 bytes
 .github/workflows/update-docs.yml |  46 +++++++++++++++++++
 .gitignore                        |  10 +++++
 build.sh                          |  71 ++++++++++++++++++++++++++++++
 source/.DS_Store                  | Bin 0 -> 6148 bytes
 source/mainwp                     |   1 +
 source/mainwp-child               |   1 +
 tools/.DS_Store                   | Bin 0 -> 6148 bytes
 tools/code-reference              |   1 +
 10 files changed, 130 insertions(+)
 create mode 100644 .DS_Store
 create mode 100644 .github/.DS_Store
 create mode 100644 .github/workflows/update-docs.yml
 create mode 100644 .gitignore
 create mode 100755 build.sh
 create mode 100644 source/.DS_Store
 create mode 160000 source/mainwp
 create mode 160000 source/mainwp-child
 create mode 100644 tools/.DS_Store
 create mode 160000 tools/code-reference

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..738182242704ee1e5b72f6df11b84efceecc5e50
GIT binary patch
literal 6148
zcmeHKJ5B>J5FIB=K2VS%1qH=k07Pn<C0b693q<)SK}xg{Nvbp}Iy!13qyXYmP*Bm+
za2N!4;EipFoevd42+c_L^Ll1HZ=bSuOhl?WZdHg%L{vay4A#*tG4^v?u#BB40~N2)
z>r`sZq(4}QlnGHl6!?n@@V6V#E_LXLM&9?U%CD}kpTu#amozYk%^=;seSSIc{Vmr&
zxtjA2y3XE^nIe_)pLMBAV`_NSY5Q$4!sRf?JxuRRjk$ID$&AVBD31^AF`pteDWMj%
zX$O6Rr=ib@gO)|Pyq-?a&hHJcCF{A|zK`_z>B>18g4LLg!L02vD@;x<5#jk=PVik=
zPIECcrB=nbJc^r-Ok|Bl;E_<z*C!ia^RL74&T)9ZF}ipW9)l$jZv7x%=lWtlqX5oq
zw!(%%=|uriKos~=fcJ+GjWM#A8q`|{I(-EI2AI}{G2bOPC$tz@Obx;VQzjK?QkA`8
zD3gx)(8fg;Q-da*l&*|*Y-MF{C`wnye5k`oMFyo81w;W~fvkBf@%ewa`u^`H$&)A`
z3j8YtR1nwVDqhK+tqU*5XKjd9M`Po-)Sym5XOCk&;G=j8O&fe64}g)y)F5VH@<%|+
LAe|`is|tJoOns>;

literal 0
HcmV?d00001

diff --git a/.github/.DS_Store b/.github/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..dc3dc1a6fb75fcc490d8bdef0cd00c61ced9ed1e
GIT binary patch
literal 6148
zcmeHKO-e&C5T4PusC3h%%Uq#1h~;^LUZAu^1z$-~#BHF5@f>b?7LU<yev}p?xDXMU
zf#jRaPm=eQW)dRe+0%MTG$Eo9njnkP5HUAhXCB-ES?9Q+feJm-<8a%U=r5XN?-$r{
zp$EFBqy10ktFqbJmb<rh)TZ?Pawto9K~UYjyzZ~Qid=s)a(j2YvivR~!9Xw&3<Lwg
zz>hM3nk_OK8%7@t1Ovgq2Lp0GBs9V7SPk{)K&MXtpj@L>pzEC#n8X0gj@1wr2wN)9
zQrVvvZ0WEkkIRnL(9(%@Wz6F%zdv5sZ_J!DoH!ds9}ENorwp9ia3b~p8h@qcBmXod
zM!`TZ@Xr|FuAlcae3aMLPoF2XHlZ!hL?o_?0)eij7^tNf135=7)oK1DI{ewO8p<qU
R*K}Z91eB2If`MOP-~gp9F<Afr

literal 0
HcmV?d00001

diff --git a/.github/workflows/update-docs.yml b/.github/workflows/update-docs.yml
new file mode 100644
index 0000000..4a64060
--- /dev/null
+++ b/.github/workflows/update-docs.yml
@@ -0,0 +1,46 @@
+name: Update Documentation
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 0 * * *'  # Run daily at midnight
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+        with:
+          submodules: recursive
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.0'
+          extensions: dom, curl, json
+
+      - name: Clone MainWP repositories
+        run: |
+          mkdir -p source
+          git clone https://github.com/mainwp/mainwp.git source/mainwp
+          git clone https://github.com/mainwp/mainwp-child.git source/mainwp-child
+
+      - name: Install code-reference
+        run: |
+          mkdir -p tools
+          git clone https://github.com/woocommerce/code-reference.git tools/code-reference
+          cd tools/code-reference
+          composer install
+
+      - name: Build documentation
+        run: |
+          ./build.sh
+
+      - name: Commit and push changes
+        run: |
+          git config --global user.name 'GitHub Action'
+          git config --global user.email 'action@github.com'
+          git add docs
+          git commit -m "Update documentation" || echo "No changes to commit"
+          git push
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..2f8ea5a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,10 @@
+# Ignore temporary build files
+tools/code-reference/build/
+
+# Ignore composer files in tools
+tools/code-reference/vendor/
+tools/code-reference/composer.lock
+
+# Ignore source repositories (we don't want to commit these to mainwp.dev)
+source/mainwp/.git/
+source/mainwp-child/.git/
\ No newline at end of file
diff --git a/build.sh b/build.sh
new file mode 100755
index 0000000..64e11fe
--- /dev/null
+++ b/build.sh
@@ -0,0 +1,71 @@
+#!/bin/bash
+
+# Directory setup - all relative to the script location
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+CODE_REF_DIR="$SCRIPT_DIR/tools/code-reference"
+MAINWP_DIR="$SCRIPT_DIR/source/mainwp"
+MAINWP_CHILD_DIR="$SCRIPT_DIR/source/mainwp-child"
+OUTPUT_DIR="$SCRIPT_DIR/code-docs"
+
+# Create output directory if it doesn't exist
+mkdir -p "$OUTPUT_DIR"
+
+# Function to build documentation for a repo
+build_docs() {
+  REPO_NAME=$1
+  REPO_PATH=$2
+  IGNORE_PATTERNS=$3
+  
+  echo "Building documentation for $REPO_NAME..."
+  
+  # Navigate to code reference tool
+  cd "$CODE_REF_DIR"
+  
+  # Update phpdoc.xml to point to the correct repository
+  sed -i '' "s|<directory>.*</directory>|<directory>$REPO_PATH</directory>|" phpdoc.xml
+  
+  # Update ignore patterns if provided
+  if [ ! -z "$IGNORE_PATTERNS" ]; then
+    # Remove existing ignore-patterns section
+    sed -i '' '/<ignore-patterns>/,/<\/ignore-patterns>/d' phpdoc.xml || true
+    
+    # Add new ignore-patterns section before the closing </phpdocumentor> tag
+    sed -i '' "s|</phpdocumentor>|<ignore-patterns>\n$IGNORE_PATTERNS\n</ignore-patterns>\n</phpdocumentor>|" phpdoc.xml
+  fi
+  
+  # Build the documentation - using a placeholder version since we're not downloading
+  ./deploy.sh --source-version "1.0.0" --github-repo "mainwp/$REPO_NAME" --build-only --no-download
+  
+  # Copy the built files to the output directory
+  if [ -d "$CODE_REF_DIR/build/api" ]; then
+    echo "Copying files to $OUTPUT_DIR/$REPO_NAME"
+    mkdir -p "$OUTPUT_DIR/$REPO_NAME"
+    cp -R "$CODE_REF_DIR/build/api/"* "$OUTPUT_DIR/$REPO_NAME/"
+  else
+    echo "Error: Build directory not found"
+    exit 1
+  fi
+}
+
+# Define ignore patterns for each repository
+MAINWP_IGNORES="<ignore>*/tests/*</ignore>\n<ignore>*/node_modules/*</ignore>\n<ignore>*/vendor/*</ignore>"
+MAINWP_CHILD_IGNORES="<ignore>*/tests/*</ignore>\n<ignore>*/node_modules/*</ignore>\n<ignore>*/vendor/*</ignore>\n<ignore>*/assets/*</ignore>\n<ignore>*/libs/external/*</ignore>"
+
+# Update repositories to the latest version
+echo "Updating MainWP repositories..."
+cd "$MAINWP_DIR" && git pull origin master
+cd "$MAINWP_CHILD_DIR" && git pull origin master
+
+# Build documentation for MainWP Dashboard
+build_docs "mainwp" "$MAINWP_DIR" "$MAINWP_IGNORES"
+
+# Build documentation for MainWP Child
+build_docs "mainwp-child" "$MAINWP_CHILD_DIR" "$MAINWP_CHILD_IGNORES"
+
+# Commit changes to mainwp.dev
+cd "$SCRIPT_DIR"
+git add .
+git commit -m "Update code reference documentation"
+git push origin main
+
+echo "Documentation build complete!"
\ No newline at end of file
diff --git a/source/.DS_Store b/source/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..f2d8f0799e91812460cd05188f03356d1256b819
GIT binary patch
literal 6148
zcmeHKu};H447E!|gUXPR1t|zthW<gQ!WZ-hpsmy*B_s=Cy&vF1`WJLTV&ivUKs?`>
zHfbm@Awag|dl#R5ao$C7Ohi1qnGT3zB8s4bojnX6h^&jYq@xyDWWUEPRrzc%nv_M=
z@;1Y7WI)btmkPS1E4rqQ^Xs|g;pTc#X4yC|$FN5ycSp~Q<-=LqXZod2HDA9cz1Mqe
zLHqSQ=#(ZjM^-sa8}HQ1!hPmj&+oB+{GQ*|y^C_4>v#O?d2{?Ed7Bsm#(**K*BC&}
z7K!=+Z8Qdq0b^jrfP5bks9>t-0{Tw}2HyezyD)pfTzUzKNfc8>7Z58D4xzvh%GzRZ
z2!}mUzf{o$4B^Due6Ze`wL@WlckG{dcj7dljmCg6&}3jIT*gxW&$svg%^<rn28@A!
z#Q=A+Q8vUQX>DyioYdL`dI1#?KNoNnf{8E1@Rd@00QCZUA`@V$=mNq5u^$0XgAK;O
Hk23HEm3LdR

literal 0
HcmV?d00001

diff --git a/source/mainwp b/source/mainwp
new file mode 160000
index 0000000..f573279
--- /dev/null
+++ b/source/mainwp
@@ -0,0 +1 @@
+Subproject commit f573279fef7feb371c0d94d3df9da3c19aba00cc
diff --git a/source/mainwp-child b/source/mainwp-child
new file mode 160000
index 0000000..52b8e66
--- /dev/null
+++ b/source/mainwp-child
@@ -0,0 +1 @@
+Subproject commit 52b8e66a5f89ff2291d7d2da6313f21d851d2b32
diff --git a/tools/.DS_Store b/tools/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..28b436ee278d1fa7c654c96fb055a95f52e1450c
GIT binary patch
literal 6148
zcmeHKOG*Pl5Unx;4hWK^%f5h%+@KAU6J#%v%&3bb69Vpg?+vmSyoQ^c#HHTBS6yXv
za3EQUNEKAS{?zO4c`)5wM8xBVdPFoNq7p91Qt2`2?j1U@-~z~bj!W85L$~lv&qRN*
zOZI+Fb84x^uD|cUp%wa@#ocH+Z<lM?{GfWgJ`}%ft7^7rXNW6zZ?D_um)+H2PQB+K
z_WkJy&iejqU&Uzz&CL~X1zZ7Fz!f-30o>VQ<(Z<Fu7E4x3hWh-^C7?mqhV6aM+b_W
z0s!S1oeg!#C4>_UqhV6S2#l2qR4QAF!AeJeu()WL6qQbF$p_oYpUDg7)iHm_;lxqV
zOIN@Z=qfPK=1}hc34WR0B)?1XmMh>2{4)i(sHW8zA7yvzkI$34Ho$M-ViK360z<v?
k2tY&5k&8U2<3Z|(i-t*2W|96(2l_)G3*v<<@Cyoj0Q(?0X#fBK

literal 0
HcmV?d00001

diff --git a/tools/code-reference b/tools/code-reference
new file mode 160000
index 0000000..af0f472
--- /dev/null
+++ b/tools/code-reference
@@ -0,0 +1 @@
+Subproject commit af0f472c5196c19e181e27eb80fe7cded668da6e