Spa Salon Pro Documentation

1) Server & WordPress Requirements

• WordPress: Latest stable version
• PHP: 7.4+ (recommended 8.x)
• MySQL: 5.7+ or MariaDB equivalent
• HTTPS/SSL: recommended for production

Before installation, ensure WordPress is working properly and you can login to /wp-admin.

2) Theme Installation

1. Go to Dashboard → Appearance → Themes → Add New → Upload Theme.
2. Upload the theme zip, click Install Now, then Activate.
3. After activation, check frontend once to confirm theme is loaded.

3) Recommended Plugins

Install only the plugins you need for your project:

• WooCommerce Required for Products section
• Contact Form 7 (if using contact forms in widgets/pages)

Plugin install path: Dashboard → Plugins → Add New

4) Basic WordPress Setup

4.1 Create Essential Pages

• Home
• Blog
• Contact
• Any service/inner pages as per your business

4.2 Set Static Homepage

1. Go to Dashboard → Settings → Reading
2. Select A static page
3. Homepage = Home, Posts page = Blog
4. Save changes

4.3 Permalinks

Go to Dashboard → Settings → Permalinks, select Post name, then save.

5) Home 1 Setup (Main Layout)

All major Home 1 controls are available in Customizer.

Open: Dashboard → Appearance → Customize

5.1 General Path

• Customizing → Homepage 1 Settings
• Customizing → General Configuration

5.2 Home 1 Sections You Can Manage

5.3 Reorder Home 1 Sections

Use section sequence control to change display order as per client preference.

Path: Customizer → Homepage 1 Settings → Section Sequence

6) Custom Post Types Content Setup

6.1 Services (our-services)

• Add service title, featured image, description/excerpt.
• Keep all service featured images same ratio for better layout.

6.2 Team (our-team)

• Add member name, featured image, bio/excerpt.
• Fill custom fields: designation, email, social links (Facebook, Twitter, YouTube, LinkedIn).

6.3 Testimonials (our-testimonial)

• Add testimonial text in content editor.
• Use featured image for client avatar.
• Add subtitle/designation in testimonial meta field.

6.4 Spa Packages (spa_package)

• Create categories in spa_package_category (these appear as left tabs).
• Add package posts and assign category.
• Fill package meta fields: Old Price and Current Price.

6.5 Gallery (our-gallery)

• Add gallery items with featured image.
• Use square images (recommended) for best grid look.

6.6 FAQs (our-faq)

• Question in post title.
• Answer in post content.

7) Shortcodes Guide

Available shortcodes in this theme:

• [TEAMLIST]
• [TESTIMONIALS]
• [SERVICES]
• [FAQS]
• [GALLERY]

7.1 Suggested Attributes

7.2 Shortcode Colors Setup

Path: Customizer → General Configuration → Color Setting For Shortcode Pages

All new shortcode color options are already mapped for:

• Services shortcode cards
• Team shortcode cards/socials
• Testimonials shortcode cards
• Gallery shortcode heading/overlay/icon/caption
• FAQ shortcode heading/item/question/answer/icon

8) Footer & Widget Setup

Footer is widget-driven (classic widgets compatible).

Path: Dashboard → Appearance → Widgets

8.1 Footer Widget Areas

• Footer Brand
• Footer One
• Footer Two
• Footer Three
• Footer Four
• Footer Bottom Right

8.2 Footer Colors and Copyright

Path: Customizer → Homepage 1 Settings → Footer

• Footer background color
• Show/hide upper widget area
• Copyright text

9) Header, Menu & Logo Setup

9.1 Logo

Path: Customizer → Site Identity

9.2 Main Menu

1. Create menu in Dashboard → Appearance → Menus
2. Assign it to theme location: My Custom Menu

10) WooCommerce Setup (Optional)

Required only if using Shop/Product section.

1. Install and activate WooCommerce.
2. Complete WooCommerce onboarding (currency, pages, shipping, etc.).
3. Add products with proper product image size consistency.

11) Troubleshooting

Issue: Section not visible on homepage

• Check section enable toggle in Home 1 Customizer.
• Check section sequence/order.
• Ensure required content exists (CPT posts/categories/products).

Issue: Empty tabs in Spa Packages

• Create at least one spa_package_category.
• Assign each package to a category.

Issue: Product section empty

• Install WooCommerce.
• Add and publish products.

Issue: Shortcode style not matching

• Check shortcode color options in General Configuration.
• Clear cache/minification plugins and browser cache.

12) Support & Maintenance

• Always keep WordPress, theme, and plugins updated.
• Take full backup before updates.
• Use staging site for major design/content changes.

For client handover, share this document together with admin login, plugin list, and branding assets folder.