Major improvements to shop URL routing and vendor landing page system:
## Landing Page System
- Add template field to ContentPage model for flexible landing page designs
- Create 4 landing page templates: default, minimal, modern, and full
- Implement smart root handler to serve landing pages or redirect to shop
- Add create_landing_page.py script for easy landing page management
- Support both domain/subdomain and path-based vendor access
- Add comprehensive landing page documentation
## Route Fixes
- Fix duplicate /shop prefix in shop_pages.py routes
- Correct product detail page routing (was /shop/shop/products/{id})
- Update all shop routes to work with router prefix mounting
- Remove unused public vendor endpoints (/api/v1/public/vendors)
## Template Link Corrections
- Fix all shop template links to include /shop/ prefix
- Update breadcrumb 'Home' links to point to vendor root (landing page)
- Update header navigation 'Home' link to point to vendor root
- Correct CMS page links in footer navigation
- Fix account, cart, and error page navigation links
## Navigation Architecture
- Establish two-tier navigation: landing page (/) and shop (/shop/)
- Document complete navigation flow and URL hierarchy
- Support for vendors with or without landing pages (auto-redirect fallback)
- Consistent breadcrumb and header navigation behavior
## Documentation
- Add vendor-landing-pages.md feature documentation
- Add navigation-flow.md with complete URL hierarchy
- Update shop architecture docs with error handling section
- Add orphaned docs to mkdocs.yml navigation
- Document multi-access routing patterns
## Database
- Migration f68d8da5315a: add template field to content_pages table
- Support template values: default, minimal, modern, full
This establishes a complete landing page system allowing vendors to have
custom marketing homepages separate from their e-commerce shop, with
flexible template options and proper navigation hierarchy.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
5.1 KiB
5.1 KiB
🧪 Landing Pages Test Guide
✅ Setup Complete!
Landing pages have been created for three vendors with different templates.
📍 Test URLs
1. WizaMart - Modern Template
Landing Page:
Shop Page:
What to expect:
- Full-screen hero section with animations
- "Why Choose Us" feature grid
- Gradient CTA section
- Modern, animated design
2. Fashion Hub - Minimal Template
Landing Page:
Shop Page:
What to expect:
- Ultra-simple centered design
- Single "Enter Shop" button
- Clean, minimal aesthetic
- No distractions
3. The Book Store - Full Template
Landing Page:
Shop Page:
What to expect:
- Split-screen hero layout
- Stats section (100+ Products, 24/7 Support, ⭐⭐⭐⭐⭐)
- 4-feature grid
- Multiple CTA sections
- Most comprehensive layout
🧪 Test Scenarios
Test 1: Landing Page Display
- Visit each vendor's landing page URL
- Verify the correct template is rendered
- Check that vendor name, logo, and theme colors appear correctly
Test 2: Navigation
- Click "Shop Now" / "Enter Shop" button on landing page
- Should navigate to
/shop/(product catalog) - Click logo or "Home" in navigation
- Should return to landing page
Test 3: Theme Integration
- Each vendor uses their theme colors
- Logo should display correctly
- Dark mode toggle should work
Test 4: Responsive Design
- Resize browser window
- All templates should be mobile-friendly
- Navigation should collapse on mobile
Test 5: Fallback Behavior (No Landing Page)
To test fallback:
# Delete a landing page
python -c "
from app.core.database import SessionLocal
from models.database.content_page import ContentPage
db = SessionLocal()
page = db.query(ContentPage).filter(ContentPage.vendor_id == 1, ContentPage.slug == 'landing').first()
if page:
db.delete(page)
db.commit()
print('Landing page deleted')
db.close()
"
Then visit: http://localhost:8000/vendors/wizamart/
- Should automatically redirect to: http://localhost:8000/vendors/wizamart/shop/
🎨 Change Templates
Want to try a different template? Run:
python scripts/create_landing_page.py
Or programmatically:
from scripts.create_landing_page import create_landing_page
# Change WizaMart to default template
create_landing_page('wizamart', template='default')
# Change to minimal
create_landing_page('wizamart', template='minimal')
# Change to full
create_landing_page('wizamart', template='full')
# Change back to modern
create_landing_page('wizamart', template='modern')
📊 Current Setup
| Vendor | Subdomain | Template | Landing Page URL |
|---|---|---|---|
| WizaMart | wizamart | modern | http://localhost:8000/vendors/wizamart/ |
| Fashion Hub | fashionhub | minimal | http://localhost:8000/vendors/fashionhub/ |
| The Book Store | bookstore | full | http://localhost:8000/vendors/bookstore/ |
🔍 Verify Database
Check landing pages in database:
sqlite3 letzshop.db "SELECT id, vendor_id, slug, title, template, is_published FROM content_pages WHERE slug='landing';"
Expected output:
8|1|landing|Welcome to WizaMart|modern|1
9|2|landing|Fashion Hub - Style & Elegance|minimal|1
10|3|landing|The Book Store - Your Literary Haven|full|1
🐛 Troubleshooting
Landing Page Not Showing
- Check database:
SELECT * FROM content_pages WHERE slug='landing'; - Verify
is_published=1 - Check vendor ID matches
- Look at server logs for errors
Wrong Template Rendering
- Check
templatefield in database - Verify template file exists:
app/templates/vendor/landing-{template}.html - Restart server if needed
Theme Not Applied
- Verify vendor has theme:
SELECT * FROM vendor_themes WHERE vendor_id=1; - Check theme middleware is running (see server logs)
- Inspect CSS variables in browser:
var(--color-primary)
404 Error
- Ensure server is running:
python main.pyormake run - Check middleware is detecting vendor (see logs)
- Verify route registration in startup logs
✅ Success Checklist
- WizaMart landing page loads (modern template)
- Fashion Hub landing page loads (minimal template)
- Book Store landing page loads (full template)
- "Shop Now" buttons work correctly
- Theme colors and logos display
- Mobile responsive design works
- Dark mode toggle works
- Navigation back to landing page works
- Fallback redirect to /shop/ works (when no landing page)
🎉 Next Steps
Once testing is complete:
- Create Landing Pages via Admin Panel (future feature)
- Build Visual Page Builder (Phase 2)
- Add More Templates as needed
- Customize Content for each vendor
For now, use the Python script to manage landing pages:
python scripts/create_landing_page.py
Happy testing! 🚀