j.foucher/AsterionWP2026

Files

j.foucher af0ed66122 docs(tools): clarify that Bricks is a theme, not a plugin

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) <noreply@anthropic.com>

2026-05-09 14:41:43 +02:00

fresh-setup-mu-plugin.php

chore: add tools/fresh-setup-mu-plugin for clean LocalWP recreation

2026-05-09 14:38:33 +02:00

README.md

docs(tools): clarify that Bricks is a theme, not a plugin

2026-05-09 14:41:43 +02:00

README.md

Tools

One-shot scripts and helpers used during project setup or migrations. They are NOT part of the published site.

fresh-setup-mu-plugin.php

Drop into wp-content/mu-plugins/ of a freshly created LocalWP site to auto-configure WordPress for the Asterion VR project. Read its inline header for the full procedure.

Quick recap :

Delete the old LocalWP site (right-click → Delete site, optionally move folder to trash).
Create a new LocalWP site named "Asterion 2026", mode localhost, default credentials.
Note the allocated port — likely 10004 again. If different, edit AV_TARGET_HOME in fresh-setup-mu-plugin.php first.

Junction the child theme into the new site:

New-Item -ItemType Junction `
  -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"

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".
```
$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.)

Extract WPML plugin into wp-content/plugins/:

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.)

Copy tools/fresh-setup-mu-plugin.php → <NEW_SITE>\app\public\wp-content\mu-plugins\fresh-setup-mu-plugin.php
Visit http://localhost:10004/ once. The plugin runs at init priority 50, configures everything, and self-deletes after success.
Verify by hitting http://localhost:10004/wp-admin — login, then check that:
- Theme : Asterion Bricks active (parent: Bricks)
- Plugins : WPML active
- Settings → Permalinks : Post name (/%postname%/)
- Bricks → Settings → Builder access : Page + Post + case_study + scenario checked

Then activate the Bricks license (Bricks → License) and run the WPML setup wizard manually — those need your license keys and an interactive choice flow that's safer to do in admin.

What's missing — manual follow-up after fresh setup

Bricks license key activation (Bricks → License)
WPML setup wizard (WPML → Setup) : EN default + FR secondary, URL strategy = "Different languages in directories"
Bricks → Theme Styles : align colors with tokens.css (Brand Navy #0B1F3A, Brand Gold #C9A45A, etc.)
Build the Header and Footer Bricks Templates (per RESTART-PLAN.md Phase 4)