Code Dump

.github/workflows/lint-check-spa.yml

@@ -0,0 +1,74 @@
+name: "JS Lint Checker: Installer Module"
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - "src/**/*.js"
+      - "src/**/*.scss"
+  pull_request:
+    types: [opened, edited, reopened, ready_for_review]
+    paths:
+      - "src/**/*.js"
+      - "src/**/*.scss"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event_name == 'pull_request' && github.head_ref || github.sha }}
+  cancel-in-progress: true
+
+jobs:
+  lint-check-spa:
+    name: Run Lint Checks
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      # Install Node and npm
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 16.x
+          cache: 'npm'
+
+      # Checks if node_modules exists in the cache.
+      - name: Cache node_modules directory
+        id: cache
+        uses: actions/cache@v3
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: ${{ runner.os }}-node-
+
+      - name: Setup Registry
+        run: printf "@newfold-labs:registry=https://npm.pkg.github.com/\n//npm.pkg.github.com/:_authToken=${{ secrets.NPM_TOKEN }}" > .npmrc
+        if: steps.cache.outputs.cache-hit != 'true'
+
+      # Installs @wordpress/scripts for lint checks if it does not exist in the cache.
+      - name: Install dependencies
+        run: npm i @wordpress/[email protected] @newfold-labs/js-utility-ui-analytics --legacy-peer-deps
+        if: steps.cache.outputs.cache-hit != 'true'
+
+      # Gets the files changed wrt to trunk and filters out the js files.
+      - uses: technote-space/get-diff-action@v6
+        with:
+          PATTERNS: |
+            +(src)/**/*.js
+
+      # Runs wp-scripts for checking JS coding issues.
+      - name: Run JS Lint
+        id: js-lint
+        run: npx wp-scripts lint-js ${{ env.GIT_DIFF }}
+        if: "!! env.GIT_DIFF"
+
+      # Gets the files changed wrt to trunk and filters out the SASS files.
+      - uses: technote-space/get-diff-action@v6
+        with:
+          PATTERNS: |
+            +(src)/**/*.scss
+        if: ${{ success() || steps.js-lint.conclusion == 'failure' }}
+
+      # Runs wp-scripts for checking SASS coding issues.
+      - name: Run SASS Lint
+        id: sass-lint
+        run: npx wp-scripts lint-style ${{ env.GIT_DIFF }}
+        if: ${{ (!! env.GIT_DIFF) && (success() || steps.js-lint.conclusion == 'failure') }}

bootstrap.php

@@ -1,7 +1,9 @@
 <?php
 
-use NewfoldLabs\WP\Module\Installer\Installer;
 use NewfoldLabs\WP\ModuleLoader\Container;
+use NewfoldLabs\WP\Module\Installer\Installer;
+use NewfoldLabs\WP\Module\Installer\Data\Constants;
+
 use function NewfoldLabs\WP\ModuleLoader\register;
 
 if ( function_exists( 'add_action' ) ) {
@@ -15,11 +17,7 @@ function () {
 					'name'     => 'installer',
 					'label'    => __( 'Installer', 'newfold-installer-module' ),
 					'callback' => function ( Container $container ) {
-
-						if ( ! defined( 'NFD_INSTALLER_VERSION' ) ) {
-							define( 'NFD_INSTALLER_VERSION', '1.1.5' );
-						}
-
+						new Constants( $container );
 						new Installer( $container );
 					},
 					'isActive' => true,

includes/Data/Constants.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace NewfoldLabs\WP\Module\Installer\Data;
+
+use NewfoldLabs\WP\ModuleLoader\Container;
+
+/**
+ * Manages all the constants for the module.
+ */
+class Constants {
+	/**
+	 * Constructor for the Constants class.
+	 *
+	 * @param Container $container The module container.
+	 */
+	public function __construct( $container ) {
+		if ( ! defined( 'NFD_INSTALLER_VERSION' ) ) {
+			define( 'NFD_INSTALLER_VERSION', '1.1.5' );
+		}
+		if ( ! defined( 'NFD_INSTALLER_BUILD_DIR' ) && defined( 'NFD_INSTALLER_VERSION' ) ) {
+			define( 'NFD_INSTALLER_BUILD_DIR', dirname( __DIR__, 2 ) . '/build/' . NFD_INSTALLER_VERSION );
+		}
+		if ( ! defined( 'NFD_INSTALLER_BUILD_URL' && defined( 'NFD_INSTALLER_VERSION' ) ) ) {
+			define( 'NFD_INSTALLER_BUILD_URL', $container->plugin()->url . '/vendor/newfold-labs/wp-module-pls/build/' . NFD_INSTALLER_VERSION );
+		}
+	}
+}

includes/Installer.php

@@ -33,6 +33,10 @@ public function __construct( Container $container ) {
 
 		new TaskManager();
 
+		if ( Permissions::rest_is_authorized_admin() ) {
+			new WPAdmin();
+		}
+
 	}
 
 }

includes/WPAdmin/Listeners/DataAttrListener.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace NewfoldLabs\WP\Module\Installer\WPAdmin\Listeners;
+
+/**
+ * Manages all the data-* listening related functionalities for the module.
+ */
+class DataAttrListener {
+	/**
+	 * Constructor for the DataAttrListener class.
+	 */
+	public function __construct() {
+		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_data_attr_listener' ) );
+	}
+
+	/**
+	 * Enqueues the data-* attribute listener script.
+	 *
+	 * @return void
+	 */
+	public function enqueue_data_attr_listener() {
+		$asset_file = NFD_INSTALLER_BUILD_DIR . '/dataAttrListener.asset.php';
+
+		if ( is_readable( $asset_file ) ) {
+
+			$asset = include $asset_file;
+
+			wp_register_script(
+				'nfd-installer-data-attr-listener',
+				NFD_INSTALLER_BUILD_URL . '/dataAttrListener.js',
+				array_merge( $asset['dependencies'], array() ),
+				$asset['version'],
+				true
+			);
+
+			wp_add_inline_script(
+				'nfd-installer-data-attr-listener',
+				'var nfdInstallerDataAttrListener =' . wp_json_encode(
+					array(
+						'restUrl' => \get_home_url() . '/index.php?rest_route=',
+					)
+				) . ';',
+				'before'
+			);
+
+			wp_enqueue_script( 'nfd-pls-data-attr-installer' );
+		}
+	}
+}

includes/WPAdmin/WPAdmin.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace NewfoldLabs\WP\Module\Installer\WPAdmin;
+
+use NewfoldLabs\WP\Module\PLS\WPAdmin\Listeners\DataAttrListener;
+
+/**
+ * Manages all the wp-admin related functionalities for the module.
+ */
+class WPAdmin {
+	/**
+	 * Constructor for the WPAdmin class.
+	 */
+	public function __construct() {
+		new DataAttrListener();
+	}
+}

package.json

@@ -1,10 +1,18 @@
 {
+  "version": "1.0.0",
   "name": "@newfold-labs/wp-module-installer",
   "description": "An installer for WordPress plugins and themes.",
   "license": "GPL-2.0-or-later",
   "private": true,
   "author": {
     "name": "Micah Wood",
     "email": "[email protected]"
+  },
+  "devDependencies": {
+    "@wordpress/scripts": "^26.10.0"
+  },
+  "scripts": {
+    "build": "wp-scripts build ./src/ ./src/Scripts/dataAttrListener.js",
+    "start": "wp-scripts start ./src/ ./src/Scripts/dataAttrListener.js"
   }
 }

src/Scripts/dataAttrListener.js

@@ -0,0 +1,11 @@
+import domReady from '@wordpress/dom-ready';
+import apiFetch from '@wordpress/api-fetch';
+
+import { installerAPI } from '../constants';
+
+domReady( () => {
+	const domObserver = new window.MutationObserver( ( mutationList ) => {
+	} );
+
+	domObserver.observe( document.body, { childList: true, subtree: true } );
+} );

src/constants.js

@@ -0,0 +1,3 @@
+export const wpRestURL = window.nfdInstallerDataAttrListener?.restUrl;
+export const dataRestRoute = 'newfold-installer/v1';
+export const installerAPI = `${ wpRestURL }/${ dataRestRoute }/events`;

webpack.config.js

@@ -0,0 +1,14 @@
+const path = require( 'path' );
+const { merge } = require( 'webpack-merge' );
+const wpScriptsConfig = require( '@wordpress/scripts/config/webpack.config' );
+const version = require( './package.json' ).version; // never require full config!
+
+const nfdSurveyWebpackConfig = {
+	output: {
+		path: path.resolve( process.cwd(), `build/${ version }` ),
+		library: [ 'newfold', 'Survey', '[name]' ],
+		libraryTarget: 'window',
+	},
+};
+
+module.exports = merge( wpScriptsConfig, nfdSurveyWebpackConfig );