chore: add tools/fresh-setup-mu-plugin for clean LocalWP recreation
Helper for resetting the dev environment by deleting the LocalWP site and
creating a fresh one (cleaner than wiping pages/options/transients in place).
tools/fresh-setup-mu-plugin.php
Drop into wp-content/mu-plugins/ of a brand-new LocalWP install named
"Asterion 2026". On first hit it:
- sets siteurl/home to http://localhost:10004 (override AV_TARGET_HOME
if LocalWP allocates a different port)
- sets pretty permalinks (/%postname%/)
- timezone Europe/Paris
- activates the Bricks parent + asterion-bricks child theme (assumes
the Junction has been re-made and the Bricks ZIP unpacked)
- activates WPML core
- sets Bricks Builder Access postTypes to page/post/case_study/scenario
- flushes rewrite rules
- self-deletes
tools/README.md
Step-by-step procedure for the LocalWP delete → recreate → junction →
unpack ZIPs → drop mu-plugin → first-hit flow. Plus the manual follow-up
for Bricks license, WPML wizard, Bricks Theme Styles.
This file path (tools/) is a deliberate sibling of content-source/ and
ThirdParty/, all of them used during setup or migration but never loaded
by the site at runtime.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
37
tools/README.md
Normal file
37
tools/README.md
Normal file
@@ -0,0 +1,37 @@
|
||||
# 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 :
|
||||
|
||||
1. Delete the old LocalWP site (right-click → Delete site, optionally move folder to trash).
|
||||
2. Create a new LocalWP site named "Asterion 2026", mode `localhost`, default credentials.
|
||||
3. Note the allocated port — likely `10004` again. **If different, edit `AV_TARGET_HOME` in `fresh-setup-mu-plugin.php` first.**
|
||||
4. Junction the child theme into the new site:
|
||||
```powershell
|
||||
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"
|
||||
```
|
||||
5. Extract the Bricks parent theme: `Expand-Archive ThirdParty\bricks.2.3.4.zip "<NEW_SITE>\app\public\wp-content\themes\"`
|
||||
6. Extract WPML: `Expand-Archive ThirdParty\sitepress-multilingual-cms.4.9.3.zip "<NEW_SITE>\app\public\wp-content\plugins\"`
|
||||
7. Copy `tools/fresh-setup-mu-plugin.php` → `<NEW_SITE>\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:
|
||||
- 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)
|
||||
Reference in New Issue
Block a user