Appearance
Install the theme
The theme installs like any other WordPress theme. If you're replacing an older version, use Replace current with uploaded — settings and content are preserved.
Download
Steps
1. Upload the theme
Appearance → Themes → Add New → Upload Theme → pick dankcave-theme.zip → Install Now.
If a Dankcave theme is already active, WordPress will detect it and prompt with a Replace current with uploaded button — click that. Your customizer settings, menu assignments, and page content are all preserved.
2. Activate
After the upload finishes, click Activate. The theme is now live.
3. Flush permalinks
Settings → Permalinks → Save Changes (once). Even if you don't change anything, the save triggers a rewrite flush. This is required for the /my-account/wishlist/ endpoint to resolve.
4. Clear Autoptimize
Admin bar → Autoptimize → Delete Cache. Critical — Autoptimize aggressively caches CSS/JS, and a stale cache can show the old theme's styles even after activation.
5. Assign the primary menu
Appearance → Menus — assign your menu to the Primary location so it renders in the header.
6. Set the home + blog pages
Settings → Reading:
- "Your homepage displays" = A static page
- Homepage =
Home(or leave blank — theme usesfront-page.phpeither way) - Posts page =
Blog(create the page first if it doesn't exist)
Pages the theme expects
Most of these already exist on live. If starting from scratch:
| Slug | Title | Template |
|---|---|---|
/ | Home | (none — theme uses front-page.php) |
/shop/ | Shop | (none — WC handles) |
/cart/ | Cart | (none — WC handles) |
/checkout/ | Checkout | (none — WC handles) |
/my-account/ | My account | (none — WC handles) |
/about-us-3/ | About us | Landing (full-bleed) |
/contact-us/ | Contact us | Landing (full-bleed) |
/shipping/ | Shipping | Landing (full-bleed) |
/returns/ | Returns | Landing (full-bleed) |
/privacy-policy/ | Privacy Policy | Landing (full-bleed) |
/terms/ | Terms of Service | Landing (full-bleed) |
/blog/ | Blog | (none) |
Run the migrator plugin (first-time deploy only)
The theme ships alongside a companion plugin — dankcave-migrator.zip — that cleans up state from the previous theme (WoodMart, Elementor Pro theme-builder templates, WooCommerce checkout settings). It's a one-shot, safe to run once and delete.
Plugins → Add New → Upload Plugin → pick dankcave-migrator.zip → Install Now → Activate.
A green notice appears listing what changed:
- Elementor edit_mode meta cleared
- Elementor Pro theme-builder templates moved to Trash
- WooCommerce guest checkout enabled
- WooCommerce ship-to-billing enabled
- Rewrite rules flushed
- Theme_mods defaults seeded
Every change is backed up to wp_options.dankcave_migrator_backup before it runs. If anything looks off, the same notice has an Undo migration button that reverses everything.
Once satisfied, click Deactivate & delete this plugin.