From af0ed66122f8bd6090e47e9d35aabd2c52441116 Mon Sep 17 00:00:00 2001 From: "j.foucher" Date: Sat, 9 May 2026 14:41:43 +0200 Subject: [PATCH] docs(tools): clarify that Bricks is a theme, not a plugin MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Bricks ZIP cannot be installed via WP admin → Plugins → Add New → Upload (it returns "No valid plugins were found"). Update tools/README.md to make the distinction explicit and provide both PowerShell and admin paths for each install. Co-Authored-By: Claude Opus 4.7 (1M context) --- tools/README.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/tools/README.md b/tools/README.md index 027cd0e..a3274e3 100644 --- a/tools/README.md +++ b/tools/README.md @@ -17,8 +17,17 @@ Quick recap : -Path "C:\Users\j_foucher\Local Sites\asterion-2026\app\public\wp-content\themes\asterion-bricks" ` -Target "C:\ASTERION\GIT\WP2026\wp-content\themes\asterion-bricks" ``` -5. Extract the Bricks parent theme: `Expand-Archive ThirdParty\bricks.2.3.4.zip "\app\public\wp-content\themes\"` -6. Extract WPML: `Expand-Archive ThirdParty\sitepress-multilingual-cms.4.9.3.zip "\app\public\wp-content\plugins\"` +5. Extract the Bricks parent **theme** into `wp-content/themes/`. Bricks is a theme (not a plugin) — installing the ZIP via WP admin → Plugins → Add New will fail with "No valid plugins were found". + ```powershell + $site = "C:\Users\j_foucher\Local Sites\asterion-2026\app\public\wp-content" + Expand-Archive "C:\ASTERION\GIT\WP2026\ThirdParty\bricks.2.3.4.zip" "$site\themes\" -Force + ``` + (Or via WP admin → Appearance → Themes → Add New Theme → Upload Theme.) +6. Extract WPML **plugin** into `wp-content/plugins/`: + ```powershell + Expand-Archive "C:\ASTERION\GIT\WP2026\ThirdParty\sitepress-multilingual-cms.4.9.3.zip" "$site\plugins\" -Force + ``` + (Or via WP admin → Plugins → Add New → Upload Plugin.) 7. Copy `tools/fresh-setup-mu-plugin.php` → `\app\public\wp-content\mu-plugins\fresh-setup-mu-plugin.php` 8. Visit `http://localhost:10004/` once. The plugin runs at `init` priority 50, configures everything, and self-deletes after success. 9. Verify by hitting `http://localhost:10004/wp-admin` — login, then check that: