feat: run snippets from files

.github/workflows/playwright-test.yml

@@ -0,0 +1,116 @@
+name: Playwright Test Runner
+
+on:
+  workflow_call:
+    inputs:
+      test-mode:
+        required: true
+        type: string
+        description: 'Test mode: default or file-based-execution'
+      project-name:
+        required: true
+        type: string
+        description: 'Playwright project name to run'
+
+jobs:
+  playwright-test:
+    name: Playwright tests (${{ inputs.test-mode == 'default' && 'Default Mode' || 'File-based Execution' }})
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout source code
+        uses: actions/checkout@v4
+
+      - name: Set up PHP
+        uses: codesnippetspro/setup-php@v2
+        with:
+          php-version: "8.1"
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .node-version
+          cache: 'npm'
+
+      - name: Compute dependency hash
+        id: deps-hash
+        run: |
+          set -euo pipefail
+          tmpfile=$(mktemp)
+          for f in src/composer.lock package-lock.json; do
+            if [ -f "$f" ]; then
+              cat "$f" >> "$tmpfile"
+            fi
+          done
+          if [ -s "$tmpfile" ]; then
+            deps_hash=$(shasum -a 1 "$tmpfile" | awk '{print $1}' | cut -c1-8)
+          else
+            deps_hash=$(echo "${GITHUB_SHA:-unknown}" | cut -c1-8)
+          fi
+          echo "deps_hash=$deps_hash" >> "$GITHUB_OUTPUT"
+
+      - name: Get build cache
+        id: deps-cache
+        uses: actions/cache/restore@v4
+        with:
+          path: |
+            node_modules
+            src/vendor
+          key: ${{ runner.os }}-deps-${{ steps.deps-hash.outputs.deps_hash }}
+          restore-keys: |
+            ${{ runner.os }}-deps-
+
+      - name: Install workflow dependencies (wp-env, playwright)
+        if: steps.deps-cache.outputs.cache-hit != 'true'
+        run: npm run prepare-environment:ci && npm run bundle
+
+      - name: Save vendor and node_modules cache
+        if: steps.deps-cache.outputs.cache-hit != 'true'
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            src/vendor
+            node_modules
+          key: ${{ runner.os }}-deps-${{ steps.deps-hash.outputs.deps_hash }}
+
+      - name: Start WordPress environment
+        run: |
+          npx wp-env start
+
+      - name: Activate code-snippets plugin
+        run: npx wp-env run cli wp plugin activate code-snippets
+
+      - name: WordPress debug information
+        run: |
+          npx wp-env run cli wp core version
+          npx wp-env run cli wp --info
+
+      - name: Install playwright/test
+        run: |
+          npx playwright install chromium
+
+      - name: Restart WordPress environment for file-based execution
+        if: inputs.test-mode == 'file-based-execution'
+        run: |
+          echo "Restarting WordPress to clear opcache..."
+          npx wp-env stop
+          npx wp-env start
+
+      - name: Run Playwright tests
+        run: npm run test:playwright -- --project=${{ inputs.project-name }}
+
+      - name: Verify file-based execution enabled
+        if: always() && inputs.test-mode == 'file-based-execution'
+        run: |
+          npx wp-env run cli wp eval 'echo file_exists(WP_CONTENT_DIR . "/code-snippets/flat-files-enabled.flag") ? "ENABLED" : "DISABLED";'
+
+      - name: Stop WordPress environment
+        if: always()
+        run: npx wp-env stop
+
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-test-results-${{ inputs.test-mode }}
+          path: test-results/
+          if-no-files-found: ignore
+          retention-days: 2

.github/workflows/playwright.yml

@@ -23,107 +23,31 @@ concurrency:
   cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 
 jobs:
-  Playwright:
-    name: Playwright test on PHP 8.1
-    runs-on: ubuntu-22.04
+  playwright-default:
     if: github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'run-tests')
-    steps:
-      - name: Checkout source code
-        uses: actions/checkout@v4
-
-      - name: Set up PHP
-        uses: codesnippetspro/setup-php@v2
-        with:
-          php-version: "8.1"
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: .node-version
-          cache: 'npm'
-
-      - name: Compute dependency hash
-        id: deps-hash
-        run: |
-          set -euo pipefail
-          # concatenate existing lock files (src/composer.lock and package-lock.json)
-          tmpfile=$(mktemp)
-          for f in src/composer.lock package-lock.json; do
-            if [ -f "$f" ]; then
-              cat "$f" >> "$tmpfile"
-            fi
-          done
-          if [ -s "$tmpfile" ]; then
-            deps_hash=$(shasum -a 1 "$tmpfile" | awk '{print $1}' | cut -c1-8)
-          else
-            # no lock files found, fall back to short commit sha
-            deps_hash=$(echo "${GITHUB_SHA:-unknown}" | cut -c1-8)
-          fi
-          echo "deps_hash=$deps_hash" >> "$GITHUB_OUTPUT"
-
-      - name: Get build cache
-        id: deps-cache
-        uses: actions/cache/restore@v4
-        with:
-          path: |
-            node_modules
-            src/vendor
-          key: ${{ runner.os }}-deps-${{ steps.deps-hash.outputs.deps_hash }}
-          restore-keys: |
-            ${{ runner.os }}-deps-
-
-      - name: Install workflow dependencies (wp-env, playwright)
-        if: steps.deps-cache.outputs.cache-hit != 'true'
-        run: npm run prepare-environment:ci && npm run bundle
-
-      - name: Save vendor and node_modules cache
-        if: steps.deps-cache.outputs.cache-hit != 'true'
-        uses: actions/cache/save@v4
-        with:
-          path: |
-            src/vendor
-            node_modules
-          key: ${{ runner.os }}-deps-${{ steps.deps-hash.outputs.deps_hash }}
-
-      - name: Start WordPress environment
-        run: |
-          npx wp-env start
+    uses: ./.github/workflows/playwright-test.yml
+    with:
+      test-mode: 'default'
+      project-name: 'chromium-db-snippets'
 
-      - name: Activate code-snippets plugin
-        run: npx wp-env run cli wp plugin activate code-snippets
-
-      - name: WordPress debug information
-        run: |
-          npx wp-env run cli wp core version
-          npx wp-env run cli wp --info
-
-      - name: Install playwright/test
-        run: |
-          npx playwright install chromium
-
-      - name: Run Playwright tests
-        run: npm run test:playwright
-
-      - name: Stop WordPress environment
-        if: always()
-        run: npx wp-env stop
-
-      - uses: actions/upload-artifact@v4
-        if: always()
-        with:
-          name: playwright-test-results
-          path: test-results/
-          if-no-files-found: ignore
-          retention-days: 2
+  playwright-file-based-execution:
+    if: github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'run-tests')
+    uses: ./.github/workflows/playwright-test.yml
+    with:
+      test-mode: 'file-based-execution'
+      project-name: 'chromium-file-based-snippets'
 
   test-result:
-    needs: [Playwright]
-    if: always() && (needs.Playwright.result != 'skipped')
+    needs: [playwright-default, playwright-file-based-execution]
+    if: always() && (needs.playwright-default.result != 'skipped' || needs.playwright-file-based-execution.result != 'skipped')
     runs-on: ubuntu-22.04
-    name: Playwright - Test Results
+    name: Playwright - Test Results Summary
     steps:
-      - name: Test status
-        run: echo "Test status is - ${{ needs.Playwright.result }}"
-      - name: Check Playwright status
-        if: ${{ needs.Playwright.result != 'success' && needs.Playwright.result != 'skipped' }}
-        run: exit 1
+      - name: Test status summary
+        run: |
+          echo "Default Mode: ${{ needs.playwright-default.result }}"
+          echo "File-based Execution: ${{ needs.playwright-file-based-execution.result }}"
+
+      - name: Check overall status
+        if: ${{ (needs.playwright-default.result != 'success' && needs.playwright-default.result != 'skipped') || (needs.playwright-file-based-execution.result != 'success' && needs.playwright-file-based-execution.result != 'skipped') }}
+        run: exit 1

src/php/class-plugin.php

@@ -77,6 +77,13 @@ class Plugin {
 	 */
 	public Licensing $licensing;
 
+	/**
+	 * Handles snippet handler registration.
+	 *
+	 * @var Snippet_Handler_Registry
+	 */
+	public Snippet_Handler_Registry $snippet_handler_registry;
+
 	/**
 	 * Class constructor
 	 *
@@ -130,6 +137,18 @@ public function load_plugin() {
 		// Cloud List Table shared functions.
 		require_once $includes_path . '/cloud/list-table-shared-ops.php';
 
+		// Snippet files.
+		$this->snippet_handler_registry = new Snippet_Handler_Registry( [
+			'php'  => new Php_Snippet_Handler(),
+			'html' => new Html_Snippet_Handler(),
+		] );
+
+		$fs = new WordPress_File_System_Adapter();
+
+		$config_repo = new Snippet_Config_Repository( $fs );
+
+		( new Snippet_Files( $this->snippet_handler_registry, $fs, $config_repo ) )->register_hooks();
+
 		$this->front_end = new Front_End();
 		$this->cloud_api = new Cloud_API();
 

src/php/class-snippet.php

@@ -189,7 +189,7 @@ public static function get_type_from_scope( string $scope ): string {
 	 *
 	 * @return string The snippet type – will be a filename extension.
 	 */
-	protected function get_type(): string {
+	public function get_type(): string {
 		return self::get_type_from_scope( $this->scope );
 	}
 

src/php/evaluation/class-evaluate-content.php

@@ -4,6 +4,9 @@
 
 use Code_Snippets\DB;
 use Code_Snippets\Snippet;
+use Code_Snippets\Settings;
+use Code_Snippets\Snippet_Files;
+use function Code_Snippets\code_snippets;
 
 /**
  * Class for evaluating content snippets.
@@ -40,8 +43,13 @@ public function __construct( DB $db ) {
 	 * Initialise class functions.
 	 */
 	public function init() {
-		add_action( 'wp_head', [ $this, 'load_head_content' ] );
-		add_action( 'wp_footer', [ $this, 'load_footer_content' ] );
+		if ( Snippet_Files::is_active() ) {
+			add_action( 'wp_head', [ $this, 'load_head_content_from_flat_files' ] );
+			add_action( 'wp_footer', [ $this, 'load_footer_content_from_flat_files' ] );
+		} else {
+			add_action( 'wp_head', [ $this, 'load_head_content' ] );
+			add_action( 'wp_footer', [ $this, 'load_footer_content' ] );
+		}
 	}
 
 	/**
@@ -77,4 +85,46 @@ public function load_head_content() {
 	public function load_footer_content() {
 		$this->print_content_snippets( 'footer-content' );
 	}
+
+	public function load_head_content_from_flat_files() {
+		$this->load_content_snippets_from_flat_files( 'head-content' );
+	}
+
+	public function load_footer_content_from_flat_files() {
+		$this->load_content_snippets_from_flat_files( 'footer-content' );
+	}
+
+	private function populate_active_snippets_from_flat_files() {
+		$handler = code_snippets()->snippet_handler_registry->get_handler( 'html' );
+		$dir_name = $handler->get_dir_name();
+		$ext = $handler->get_file_extension();
+
+		$scopes = [ 'head-content', 'footer-content' ];
+		$all_snippets = Snippet_Files::get_active_snippets_from_flat_files( $scopes, $dir_name );
+
+		foreach ( $all_snippets as $snippet ) {
+			$scope = $snippet['scope'];
+
+			// Add file path information to the snippet for later use
+			$table_name = Snippet_Files::get_hashed_table_name( $snippet['table'] );
+			$base_path = Snippet_Files::get_base_dir( $table_name, $dir_name );
+			$snippet['file_path'] = $base_path . '/' . $snippet['id'] . '.' . $ext;
+
+			$this->active_snippets[ $scope ][] = $snippet;
+		}
+	}
+
+	private function load_content_snippets_from_flat_files( string $scope ) {
+		if ( is_null( $this->active_snippets ) ) {
+			$this->populate_active_snippets_from_flat_files();
+		}
+
+		if ( ! isset( $this->active_snippets[ $scope ] ) ) {
+			return;
+		}
+
+		foreach ( $this->active_snippets[ $scope ] as $snippet ) {
+			require_once $snippet['file_path'];
+		}
+	}
 }