Aaima Theme Documentation
🛒
📝
đŸĸ
🎨
⚡
⭐ WordPress Theme v1.5.7

Aaima Theme

A powerful, multi-purpose WooCommerce WordPress theme inspired by Amazon's design. Perfect for e-commerce stores, blogs, magazines, and corporate websites. Includes 12 pre-built demo variations and 18 premium bundled plugins worth $300+!

🎭 12 Demo Variations 🎨 3 Header Layouts 📐 5 Footer Layouts đŸ—ī¸ 28+ Homepage Sections 🧩 8 Elementor Widgets 🛒 WooCommerce Ready đŸ“Ļ 18 Bundled Plugins 🚀 One-Click Demo Import 🔍 Built-in SEO

📑 Table of Contents

🚀 Getting Started

  • â€ĸ System Requirements
  • â€ĸ Installation Guide
  • â€ĸ Theme Activation
  • â€ĸ Quick Setup

🎭 12 Demo Variations

  • â€ĸ E-Commerce, Travel, Auto
  • â€ĸ Restaurant, Real Estate
  • â€ĸ Medical, Fitness, Education
  • â€ĸ Beauty, Corporate, Hotel, Construction

đŸ“Ļ Demo Import

  • â€ĸ One-Click Import
  • â€ĸ 12 Blog Posts
  • â€ĸ 36 WooCommerce Products
  • â€ĸ Categories & Pages

🎨 Header Layouts (3)

  • â€ĸ E-Commerce (Amazon Style)
  • â€ĸ Blog / Magazine
  • â€ĸ Corporate / Business
  • â€ĸ Location Selector

🏠 Homepage Builder

  • â€ĸ 28+ Section Types
  • â€ĸ About Section (All Demos)
  • â€ĸ Portfolio Section
  • â€ĸ Drag & Drop Ordering

🛒 WooCommerce

  • â€ĸ Shop Page Layouts
  • â€ĸ Sidebar Filters
  • â€ĸ Product Compare
  • â€ĸ Wishlist & Quick View

🔍 SEO Settings

  • â€ĸ Meta Descriptions
  • â€ĸ Open Graph Tags
  • â€ĸ Schema Markup
  • â€ĸ Social Media Links

đŸ“Ļ Bundled Plugins (18)

  • â€ĸ One-Click Installation
  • â€ĸ Auto Account, Fly Cart
  • â€ĸ POS System, SMS
  • â€ĸ And 15 more plugins!

System Requirements

Minimum requirements to run the theme

đŸ“Ļ

WordPress

5.8+
🐘

PHP

7.4+
đŸ—„ī¸

MySQL

5.6+
💾

Memory

256MB+
🛒

WooCommerce

6.0+
🧩

Elementor

Optional

Key Features

Everything you need to build stunning websites

🎭

12 Demo Variations

E-Commerce, Travel, Automotive, Restaurant, Real Estate, Medical, Fitness, Education, Beauty, Corporate, Hotel, and Construction - each with unique design and industry-specific sections.

🎨

3 Header Layouts

E-Commerce (Amazon-style with location selector), Blog/Magazine (centered), and Corporate/Business (professional) header designs with full customization.

đŸ—ī¸

28+ Homepage Sections

Hero slider, featured products, categories, testimonials, team, stats, newsletter, blog posts, About section, Portfolio, Rooms, and many more drag & drop sections.

🛒

Full WooCommerce

Shop layouts (Grid/List), Amazon-style sidebar filters (Category, Rating, Attributes, Price), AJAX cart, wishlist, product compare, and color swatches.

đŸ“Ļ

One-Click Demo Import

Import 12 blog posts with topic-related images, 36 products (simple & variable), categories, and pages with a single click. See your site come to life instantly!

🔍

Built-in SEO

Auto-generated meta descriptions, Open Graph tags, Schema markup, social media integration, and search engine verification codes.

🧩

8 Elementor Widgets

Custom Elementor widgets for product carousel, flash deals, bestsellers, categories grid, mini cart, and more.

📱

Fully Responsive

Mobile-first design that looks perfect on all devices. Touch-friendly navigation and optimized layouts.

⚡

Performance Optimized

Lazy loading, minified assets, clean code. Options to disable emojis and embeds for faster page loads.

Installation Guide

Get started in minutes

đŸ“Ļ Method 1: WordPress Admin

  • 1

    Go to Appearance → Themes

  • 2

    Click Add New → Upload Theme

  • 3

    Choose aaima.zip file

  • 4

    Click Install Now

  • 5

    Click Activate

📁 Method 2: FTP Upload

  • 1

    Extract aaima-package.zip

  • 2

    Connect to server via FTP/SFTP

  • 3

    Navigate to /wp-content/themes/

  • 4

    Upload aaima and plugins folders

  • 5

    Activate in Appearance → Themes

✅

After Activation: Visit Aaima Settings in your WordPress admin to configure theme options and install bundled plugins from Aaima → Recommended Plugins.

đŸ“Ļ One-Click Demo Import

Get a professional-looking site instantly with demo content

📝

12 Blog Posts

With images & categories

đŸ›ī¸

18 Simple Products

With prices & stock

👕

18 Variable Products

Size, color options

📁

Categories

Blog & Product

📄

Pages

Home, About, Contact

🤝

Partner Logos

6 LogoIpsum logos

đŸ–ŧī¸

Images

Auto-downloaded

Demo Content Details

What's included in the demo import

💡

How to Import: Go to Aaima → Demo Import, select a demo style, and click "Import". The process takes 2-3 minutes.

📝 12 Blog Posts

Post Title Category
10 Essential Tips for Online Shopping SuccessTips & Tricks
The Future of E-Commerce: Trends to Watch in 2025Technology
How to Choose the Perfect Gift for Any OccasionLifestyle
New Season Collection: What's Trending NowNews
5 Ways to Style Your Home on a BudgetLifestyle
Customer Success Story: From Browser to Loyal FanNews
Understanding Product Quality: What to Look ForTips & Tricks
Seasonal Sale: Best Deals You Can't MissNews
Behind the Scenes: How We Select Our ProductsNews
Tech Gadgets That Make Life EasierTechnology
Self-Care Sunday: Products for RelaxationLifestyle
Shipping and Delivery: Everything You Need to KnowTips & Tricks

Blog Categories Created: News, Tips & Tricks, Lifestyle, Technology

đŸ›ī¸ 18 Simple Products

Product Category Status
Classic Leather WalletAccessoriesSale
Wireless Bluetooth EarbudsElectronicsIn Stock
Organic Cotton Throw BlanketHome & LivingSale
Stainless Steel Water BottleAccessoriesIn Stock
Smart LED Desk LampElectronicsSale
Ceramic Plant Pot SetHome & LivingOut of Stock
Premium Yoga MatAccessoriesIn Stock
Portable Power Bank 20000mAhElectronicsSale
Scented Candle Gift SetHome & LivingIn Stock
Minimalist WatchAccessoriesSale
Wireless Charging PadElectronicsOut of Stock
Bamboo Cutting Board SetHome & LivingSale
Mechanical KeyboardElectronicsSale
Aromatherapy DiffuserHome & LivingIn Stock
Travel Duffel BagAccessoriesSale
Smart Fitness TrackerElectronicsOut of Stock
French Press Coffee MakerHome & LivingIn Stock
Leather Laptop SleeveAccessoriesSale

👕 18 Variable Products

Product Attributes Category
Classic Cotton T-ShirtSize (S-XXL), Color (4)Clothing
Slim Fit JeansSize (28-36), Color (3)Clothing
Hooded SweatshirtSize (S-XL), Color (4)Clothing
Running SneakersSize (7-12), Color (3)Clothing
Leather Crossbody BagColor (4)Accessories
Polarized SunglassesColor (4)Accessories
Decorative Throw PillowSize (3), Color (4)Home & Living
Smartphone CaseModel (5), Color (4)Electronics
Linen Bed Sheet SetSize (4), Color (4)Home & Living
Casual Button-Down ShirtSize (5), Color (4)Clothing
USB-C Hub AdapterType (3), Color (2)Electronics
Knit Beanie HatColor (6)Clothing
Canvas BackpackSize (2), Color (4)Accessories
Wool Blend ScarfColor (5)Accessories
Fitness Resistance Bands SetSize (4)Accessories
Ceramic Coffee Mug SetColor (4)Home & Living
Cotton Jogger PantsSize (5), Color (4)Clothing
Wireless Gaming MouseColor (3)Electronics

Product Categories Created: Clothing, Electronics, Home & Living, Accessories

Variable Features: Multiple variations per product, mixed stock status, some with sale prices

🤝 6 Partner Logos

Professional placeholder logos included in theme. Located in /assets/images/ folder. Replace with your actual partner logos.

243.svg
244.svg
245.svg
246.svg
247.svg
248.svg

Location: /wp-content/themes/aaima/assets/images/

Quick Setup Workflow

Get your site ready in 6 simple steps

đŸ“Ļ

1. Install Theme

Upload & activate

🛒

2. Install WooCommerce

If needed for shop

đŸ“Ĩ

3. Import Demo

One-click content

🔌

4. Install Plugins

Bundled plugins

🎨

5. Customize

Colors & layouts

🚀

6. Go Live!

Launch your site

🎭 12 Demo Variations

Pre-built designs for every industry - One-click import with industry-specific sections

🛒 E-Commerce

  • â€ĸ Amazon-style dark header
  • â€ĸ Product categories grid
  • â€ĸ Deals & featured products
  • â€ĸ Full shop functionality

âœˆī¸ Travel & Tourism

  • â€ĸ Destinations showcase
  • â€ĸ Tour packages section
  • â€ĸ Booking CTA buttons
  • â€ĸ Travel hero slider

🚗 Automotive

  • â€ĸ Featured vehicles gallery
  • â€ĸ Vehicle specifications
  • â€ĸ Auto hero section
  • â€ĸ Dealer services

đŸŊī¸ Restaurant

  • â€ĸ Menu sections
  • â€ĸ Reservation CTA
  • â€ĸ Chef & team showcase
  • â€ĸ Food gallery

🏠 Real Estate

  • â€ĸ Property listings
  • â€ĸ Agent profiles
  • â€ĸ Property search
  • â€ĸ Location maps

đŸĨ Medical & Healthcare

  • â€ĸ Services & departments
  • â€ĸ Doctor profiles
  • â€ĸ Appointment booking
  • â€ĸ Health statistics

đŸ’Ē Fitness & Gym

  • â€ĸ Class schedules
  • â€ĸ Trainer profiles
  • â€ĸ Membership plans
  • â€ĸ Fitness programs

📚 Education

  • â€ĸ Course categories
  • â€ĸ Instructor showcase
  • â€ĸ Popular courses
  • â€ĸ Student stats

💅 Beauty & Spa

  • â€ĸ Services & treatments
  • â€ĸ Specialists team
  • â€ĸ Pricing tables
  • â€ĸ Booking options

đŸĸ Corporate

  • â€ĸ Professional header with CTA
  • â€ĸ Services showcase
  • â€ĸ Portfolio section
  • â€ĸ Team members

🏨 Hotel & Hospitality

  • â€ĸ Room types & amenities
  • â€ĸ Booking integration
  • â€ĸ Gallery showcase
  • â€ĸ Guest testimonials

đŸ—ī¸ Construction

  • â€ĸ Project portfolio
  • â€ĸ Services offered
  • â€ĸ Team & expertise
  • â€ĸ Request quote CTA
💡

How to Switch Demos: Go to Aaima → Demo Import, select your desired demo variation, and click "Import". Each demo includes optimized homepage sections, color schemes, and industry-specific content.

🔍 SEO Settings

Built-in search engine optimization

💡

Access: Go to Aaima → Theme Settings → SEO tab. These features are automatically disabled if you use Yoast SEO or Rank Math.

📝 Meta Descriptions

  • â€ĸ

    Homepage: Custom meta description field

  • â€ĸ

    Posts/Pages: Auto-generated from excerpt or content

  • â€ĸ

    Products: Uses short description

  • â€ĸ

    Categories: Uses term description

  • â€ĸ

    Length: Auto-truncated to 160 characters

📊 Schema Markup

  • â€ĸ

    WebSite: Site name, URL, search action

  • â€ĸ

    Organization: Name, URL, logo

  • â€ĸ

    BreadcrumbList: Navigation breadcrumbs

  • â€ĸ

    Article: Blog post structured data

  • â€ĸ

    Product: WooCommerce product schema

🌐 Open Graph Tags

  • â€ĸ

    og:title: Page/post title

  • â€ĸ

    og:description: Excerpt or auto-generated

  • â€ĸ

    og:image: Featured image

  • â€ĸ

    Twitter Cards: Large image summary

  • â€ĸ

    Product tags: Price, currency, availability

🔗 Social & Verification

  • â€ĸ

    Social Links: Facebook, Twitter, Instagram, LinkedIn, YouTube, TikTok

  • â€ĸ

    Google: Search Console verification

  • â€ĸ

    Bing: Webmaster Tools verification

  • â€ĸ

    Canonical URLs: Prevent duplicate content

  • â€ĸ

    Robots meta: Index/noindex control

✅

Smart Detection: If Yoast SEO or Rank Math is active, theme SEO features are automatically disabled to prevent conflicts and duplicate meta tags.

Header Layouts

Choose from 3 professional header designs

E-Commerce (Default)

Amazon-inspired with search bar, mega menu, and account dropdown

Blog / Magazine

Centered logo with clean navigation, perfect for blogs

Corporate / Business

Professional design with top bar and CTA button

đŸŽ›ī¸ Header Features & Options

  • Sticky Header: Fixed header on scroll with shadow effect
  • Top Bar: Contact info, social links, and custom text
  • Logo Upload: Custom logo with retina support
  • Search Bar: Product search with category filter
  • Account Menu: Login/Register with personalized greeting
  • Mini Cart: AJAX cart dropdown with product preview
  • Wishlist Icon: Heart icon with count badge (E-Commerce header)
  • Compare Icon: Compare button with count badge (E-Commerce header)
  • CTA Button: Customizable call-to-action (Corporate header)
  • 7 Color Pickers: Full control over header colors
  • Toggle Controls: Enable/disable each header element individually

📍 Amazon-Style Location Selector

Dynamic delivery location feature just like Amazon - shows "Deliver to [City]" in header with smart detection and manual entry.

  • Auto-Detect Location: IP-based geolocation detects user's city, country, and postal code automatically
  • Location Modal: Click header location to open professional popup with options
  • Manual Entry: Country dropdown (all WooCommerce countries) + city + postal code inputs
  • Saved Addresses: Logged-in users can use their WooCommerce billing address with one click
  • Cookie Storage: Location persists for 30 days across visits
  • Dynamic Header: Header updates instantly when location changes
  • Admin Controls: Toggle ON/OFF and set default location text in Aaima → Header Settings
How it works:
  1. User clicks "Deliver to [Location]" in header
  2. Modal opens with auto-detect button or manual form
  3. User selects location method and confirms
  4. Header updates and location saves to cookie

Footer Layouts

5 footer designs to complete your site

Classic 4-Column

Widget columns with copyright bar

Centered

Centered logo and social links

Minimal

Simple copyright with inline links

đŸĻļ Footer Features

  • Footer Logo: Separate logo upload for footer (optional)
  • Widget Areas: 4 widget columns for menus, content, etc.
  • Social Links: Facebook, Twitter, Instagram, YouTube, LinkedIn
  • Copyright Text: Customizable with dynamic year
  • Payment Icons: Show accepted payment methods
  • Back to Top: Smooth scroll button

Homepage Builder

Drag & drop sections to build your landing page

💡

Access: Go to Aaima → Homepage Builder in your WordPress admin panel.

🏠

Hero Section

Title, subtitle, CTA buttons with image or gradient background. Multiple style options.

⭐

Featured Products

Showcase featured WooCommerce products in a beautiful grid layout.

đŸ”Ĩ

Deals of the Day

Sale products with countdown timer. Create urgency and boost sales.

📁

Categories

Product categories grid with images. Help customers find what they need.

đŸ’Ŧ

Testimonials

Customer reviews with ratings, avatars, and company info.

📊

Statistics

Animated counter stats. Show customers, products, years, etc.

đŸ“ĸ

Call to Action

CTA banner with title, subtitle, and button. Drive conversions.

📧

Newsletter

Email subscription form. Build your mailing list.

📝

Blog Posts

Latest posts grid. Keep your site fresh with content.

đŸ“Ļ All Available Sections (28+)

  • E-Commerce: Hero, Featured Products, New Arrivals, Bestsellers, Deals, Categories, Recently Viewed, Brands
  • Blog: Featured Posts, Latest Posts, Post Categories, Authors Grid
  • General: About (all demos), Portfolio, Banner, Services, Testimonials, Team, Stats, Newsletter, CTA, Custom Shortcode, Gallery
  • Industry: Travel Hero, Destinations, Tours, Auto Hero, Featured Vehicles, Rooms (Hotel)

✨ NEW: About Section

Professional About section available for all 12 demo variations with industry-specific content.

  • Customizable Title & Description: Edit via Homepage Builder
  • Image Upload: Featured image with rounded corners
  • Highlights with Icons: 4 feature boxes with custom icons
  • Statistics: Counter stats (years, clients, projects, etc.)
  • Call-to-Action Button: Customizable button text and URL

✨ NEW: Portfolio Section

Showcase your work with a beautiful portfolio grid.

  • Grid Layout: Responsive masonry-style grid
  • Hover Effects: Overlay with project details on hover
  • Category Filtering: Filter projects by category
  • Lightbox: Full-screen image viewing
  • Links: Link to project pages or external URLs

WooCommerce Integration

Full e-commerce support with extensive options

đŸĒ Shop Page Settings

  • â€ĸ

    Products Per Page: 4-48 products

  • â€ĸ

    Columns: 2-6 columns

  • â€ĸ

    Default View: Grid or List toggle

  • â€ĸ

    Sidebar: Left, Right, or No Sidebar

  • â€ĸ

    View Toggle: Let customers switch views

  • â€ĸ

    Sidebar Filters: Category, Rating, Attributes, Availability, Price

đŸ“Ļ Single Product

  • â€ĸ

    Gallery: Vertical/Horizontal thumbnails

  • â€ĸ

    Image Zoom: Hover zoom with icon

  • â€ĸ

    Lightbox: Full-screen gallery

  • â€ĸ

    Sticky Add to Cart: Fixed bar on scroll

  • â€ĸ

    Color Swatches: Visual attribute selection

👕 Variable Products

  • â€ĸ

    Color Swatches: Circle color pickers

  • â€ĸ

    Size Buttons: Clickable size options

  • â€ĸ

    Stock Status: Per-variation availability

  • â€ĸ

    Out of Stock: Strikethrough styling

  • â€ĸ

    Price Updates: Dynamic price display

🛒 Cart & Checkout

  • â€ĸ

    AJAX Cart: Update without reload

  • â€ĸ

    Mini Cart: Header dropdown cart

  • â€ĸ

    Free Shipping Bar: Progress indicator

  • â€ĸ

    Checkout Layouts: Default, Two Column

  • â€ĸ

    Trust Badges: Security icons

🔍 Shop Sidebar Filters

Amazon-style product filtering in shop sidebar. Each filter can be individually enabled/disabled in Aaima → Catalog → Shop Sidebar Filters.

📁 Category Filter

Hierarchical category tree with expand/collapse and product counts

⭐ Customer Rating

Filter by star ratings (4 & Up, 3 & Up, etc.)

🎨 Product Attributes

Color, Size, Model - collapsed by default, expandable

đŸ“Ļ Availability

Filter by In Stock or On Sale status

💰 Price Range

Min/Max price input fields with Apply button

Product Badges & Features

Highlight products and boost conversions

đŸˇī¸ Product Badges

  • Sale badge with percentage
  • New arrival badge (configurable days)
  • Out of stock badge
  • Featured product badge
  • Custom badge colors

🛒 Add to Cart

  • AJAX add to cart
  • Quantity buttons (+/-)
  • Add to cart animation
  • Mini cart notification
  • Variable product support

â¤ī¸ Wishlist & Compare

  • Add to wishlist button
  • Wishlist page
  • Product comparison
  • Compare page with table
  • AJAX functionality

🔍 Quick View

  • Modal product preview
  • Product gallery
  • Add to cart from modal
  • Quantity selector
  • View full product link

18 Bundled Plugins

Premium plugins included - worth $300+!

💡

One-Click Install: Go to Aaima → Recommended Plugins and click "Install" next to any plugin. After installation, click "Activate" to enable.

🛒 Super Modern Fly Cart Pro Bundled

Beautiful slide-out AJAX cart sidebar.

  • Slide-out cart panel
  • AJAX update quantities
  • Cross-sells display
  • Mobile optimized

👤 Super Auto Account Pro Bundled

Auto-create accounts at checkout.

  • Guest to account conversion
  • Custom account rules
  • Email notifications
  • Password generation

đŸ’ģ Super POS System Bundled

Point of Sale for retail stores.

  • Barcode scanning
  • Quick product search
  • Multiple payment methods
  • Receipt printing

📱 Super SMS Bundled

SMS notifications for orders.

  • Order status SMS
  • Shipping notifications
  • Marketing messages
  • Multiple gateways

📧 Super Customer Email Marketing Bundled

Email marketing automation.

  • Automated campaigns
  • Customer segmentation
  • Email templates
  • Analytics dashboard

🎁 Super Gift By Cart Pro Bundled

Free gift promotions.

  • Cart total triggers
  • Product-based gifts
  • Customer conditions
  • Multiple gift rules

🚚 Super Delivery & Pickup Bundled

Scheduling at checkout.

  • Date/time picker
  • Delivery zones
  • Pickup locations
  • Slot management

🔔 Super Desktop Notification Bundled

Browser push notifications.

  • Order notifications
  • Sale alerts
  • Custom messages
  • Subscription management

đŸˇī¸ Super Catalog Mode Pro Bundled

Hide prices and disable cart.

  • Hide prices
  • Disable add to cart
  • Request quote
  • Role-based visibility

đŸĒ Super Cookie Notice Pro Bundled

GDPR cookie consent.

  • Customizable banner
  • Cookie categories
  • Consent logging
  • Multiple layouts

đŸ–¨ī¸ Super Smart Print Order Bundled

Print invoices and packing slips.

  • Invoice templates
  • Packing slips
  • Delivery notes
  • Bulk printing

🌴 Super Store Vacation Pro Bundled

Schedule store closures.

  • Vacation mode
  • Custom notices
  • Disable checkout
  • Date ranges

đŸ“Ļ All 18 Bundled Plugins

  • Account & Users: Super Auto Account Pro
  • Cart & Checkout: Super Modern Fly Cart Pro, Super Delivery & Pickup
  • Marketing: Super Customer Email Marketing Pro, Super SMS, Super Desktop Notification Pro
  • Products: Super Product Options Pro, Super Quantity Buttons Pro, Super Product Menu Layouts Pro
  • Promotions: Super Gift By Cart Pro, Super Catalog Mode Pro
  • Operations: Super POS System, Super Smart Print Order, Super Store Vacation Pro
  • Compliance: Super Cookie Notice Pro
  • Communication: Super Mailer Pro
  • Localization: Super WP Translator Pro
  • Booking: Super Restaurant Reservations Pro

Elementor Widgets

Custom widgets for WooCommerce

🎠
Product Carousel
đŸ”Ĩ
Flash Deals
⭐
Best Sellers
📁
Categories Grid
🛒
Mini Cart
🔍
Product Search
đŸ‘ī¸
Recently Viewed
đŸˇī¸
Product Badges

Colors & Typography

Customize your brand appearance

🎨 Default Color Palette

Primary#ff9900
Secondary#232f3e
Accent#146eb4
Success#067d62
Warning#f59e0b
Danger#c45500

🔤 Typography Options

  • Body Font: System Default, Inter, Roboto, Open Sans, Lato, Poppins, Montserrat, Nunito, Source Sans Pro
  • Heading Font: Same options as body font
  • Base Font Size: 12px - 24px
  • Heading Weight: Normal, Medium, Semi-bold, Bold

📝 Blog Settings

Multiple layouts for your content

📐 Archive Layouts

  • Grid layout (2-4 columns)
  • List layout (horizontal)
  • Masonry layout
  • Sidebar: Left, Right, None

📄 Single Post

  • Featured image display
  • Author box with avatar
  • Related posts section
  • Post navigation
  • Social share buttons

📊 Post Features

  • Reading time estimate
  • Post views counter
  • Category display
  • Tags cloud
  • Comments system

â™ŋ Accessibility Features

Built for everyone

đŸˇī¸

ARIA Labels

All interactive elements have proper aria-labels for screen readers. Buttons announce their purpose clearly.

âŒ¨ī¸

Keyboard Navigation

Full keyboard support for menus, modals, and interactive elements. Tab through the site easily.

🎨

Color Contrast

Colors meet WCAG guidelines for readability. Text is always legible against backgrounds.

📱

Focus Indicators

Clear focus states for all interactive elements. Users always know where they are on the page.

🔗

Skip Links

Skip to main content link for keyboard users. Jump past navigation quickly.

📝

Semantic HTML

Proper heading hierarchy, landmarks, and semantic elements throughout the theme.

Troubleshooting Guide

Common issues and solutions

❌ Theme not installing

Upload fails or times out

Solution: Increase PHP upload_max_filesize to 64M. Use FTP method instead.

❌ Styles not loading

CSS appears broken

Solution: Clear browser cache. Clear any caching plugin. Check theme files uploaded correctly.

âš ī¸ Demo import failed

Import stops or times out

Solution: Increase PHP max_execution_time to 300. Try importing one step at a time.

âš ī¸ Plugin install failed

Bundled plugin won't install

Solution: Ensure plugins folder is uploaded to /wp-content/themes/plugins/. Check file permissions.

â„šī¸ Header colors not changing

Colors stay default

Solution: Clear cache after saving. Check you're editing the correct header layout settings.

âš ī¸ Products not showing

Homepage products empty

Solution: Ensure WooCommerce is active and products exist. Check section is enabled in Homepage Builder.

â„šī¸ SEO tags not appearing

Meta description missing

Solution: Check if Yoast/Rank Math is active (theme SEO auto-disables). Add homepage description in SEO settings.

â„šī¸ Settings not saving

Changes don't persist

Solution: Check browser console for errors. Try disabling other plugins temporarily.

Frequently Asked Questions

Common questions answered

Q: Is WooCommerce required?

No, WooCommerce is optional. The theme works perfectly without it for blogs and corporate sites. Install WooCommerce only if you need e-commerce functionality.

Q: How do I import demo content?

Go to Aaima → Demo Import, select your preferred demo style, and click "Import". The process creates 12 blog posts, 36 products (18 simple + 18 variable), categories, and pages automatically.

Q: Do I need an SEO plugin?

The theme includes built-in SEO features (meta descriptions, Open Graph, Schema markup). For advanced SEO, you can use Yoast or Rank Math - the theme automatically disables its SEO to prevent conflicts.

Q: How do I install the bundled plugins?

Upload the entire package (including the /plugins folder) via FTP to /wp-content/themes/. Then go to Aaima → Recommended Plugins and click "Install" next to any plugin you want.

Q: Can I use Elementor with this theme?

Yes! Aaima is fully compatible with Elementor and includes 8 custom WooCommerce widgets. You can use Elementor to build any page.

Q: Is the theme translation ready?

Yes, Aaima is fully translation-ready with RTL support. Compatible with WPML, Polylang, and Loco Translate. All strings are internationalized.

Q: How do variable products work?

Variable products display color swatches and size buttons. Out-of-stock variations show with strikethrough. The price updates dynamically when selecting options.

Q: Can I customize the shop sidebar position?

Yes! Go to Aaima → Shop Settings → Catalog tab. You can choose Left Sidebar, Right Sidebar, or No Sidebar for the shop page.

Q: Are updates free?

Yes, all future updates are free for customers who purchased the theme. You'll receive notifications when updates are available.

Q: Do the bundled plugins receive updates?

Yes, bundled plugins are updated regularly and included in theme update packages.

Changelog

Version history

v1.5.7 (January 10, 2026)

  • 🐛 FIXED: Quantity input undefined variable warning in WooCommerce template

v1.5.6 (January 10, 2026)

  • 🐛 FIXED: Compare page fatal error when product has string attributes instead of objects
  • 🔧 IMPROVED: Product attributes handling with proper type checking

v1.5.5 (January 10, 2026)

  • 🐛 FIXED: Blog/Magazine header icon colors invisible on light background
  • 🐛 FIXED: Corporate header search, cart, and account icon colors
  • 🔧 IMPROVED: All Blog/Corporate header elements now use explicit dark colors (#333333)

v1.5.3 (January 10, 2026)

  • 🐛 FIXED: Header toggle settings not hiding elements when disabled
  • 🔧 IMPROVED: Boolean setting function now properly handles unchecked checkboxes
  • 🔧 IMPROVED: Wishlist, Compare, Search, Location, Account, Cart toggles now work correctly

v1.5.2 (January 10, 2026)

  • ✨ NEW: Compare button added to E-Commerce header
  • 🐛 FIXED: Cart badge styling and positioning
  • 🔧 IMPROVED: Header action buttons consistency

v1.5.1 (January 10, 2026)

  • ✨ NEW: 144 topic-related blog post images from Unsplash
  • 🔧 IMPROVED: Demo import now uses industry-specific images for all 12 demos
  • 🔧 IMPROVED: Each demo variation has unique blog post imagery

v1.5.0 (January 10, 2026)

  • ✨ NEW: Hotel & Hospitality demo variation with rooms section
  • ✨ NEW: Construction demo variation with project portfolio
  • ✨ NEW: Rooms section for hotel bookings
  • 🔧 IMPROVED: Now 12 complete demo variations available

v1.4.2 (January 10, 2026)

  • ✨ NEW: Portfolio section for showcasing projects
  • ✨ NEW: Portfolio grid with hover effects
  • ✨ NEW: Category filtering for portfolio items

v1.4.1 (January 10, 2026)

  • ✨ NEW: About sections now fully editable in admin panel
  • 🔧 IMPROVED: Section editor integration for About sections
  • 🔧 IMPROVED: Admin settings registration for all About variations

v1.4.0 (January 10, 2026)

  • ✨ NEW: About section added to all 10 demo variations
  • ✨ NEW: Industry-specific About content for each demo
  • ✨ NEW: About section with highlights, stats, and images

v1.3.0 (January 10, 2026)

  • 🔧 IMPROVED: Modularized admin settings architecture
  • 🔧 IMPROVED: Separated AJAX and sanitization into traits
  • 🐛 FIXED: Admin menu showing in wrong position

v1.2.0 (January 08, 2026)

  • ✨ NEW: Amazon-Style Location Selector with auto-detect via IP geolocation
  • ✨ NEW: Location modal with country dropdown, city, and postal code inputs
  • ✨ NEW: Use saved WooCommerce billing address for logged-in users
  • ✨ NEW: Cookie-based location persistence (30 days)
  • ✨ NEW: Shop Sidebar Filters - Category with hierarchical tree
  • ✨ NEW: Customer Rating filter (5 & Up, 4 & Up, etc.) with star display
  • ✨ NEW: Product Attributes filters (Color, Size, Model) - collapsed by default
  • ✨ NEW: Availability filter (In Stock, On Sale)
  • ✨ NEW: Price Range filter with min/max inputs
  • ✨ NEW: Individual admin toggles for each sidebar filter
  • 🔧 IMPROVED: Demo import creates global product attributes (pa_size, pa_color, pa_model)
  • 🔧 IMPROVED: Auto-conversion of local attributes to global taxonomies
  • 🔧 IMPROVED: E-Commerce header background color admin control
  • 🐛 FIXED: Attribute filter titles not showing in sidebar
  • 🐛 FIXED: Rating stars all showing 1 star instead of correct count

v1.1.0 (January 07, 2026)

  • ✨ NEW: Comprehensive Demo Import (12 blog posts, 36 products)
  • ✨ NEW: SEO Settings tab with meta descriptions, Open Graph, Schema
  • ✨ NEW: Social media links and verification codes
  • ✨ NEW: Shop page sidebar layouts (Left/Right/None)
  • ✨ NEW: Grid/List view toggle with admin default setting
  • ✨ NEW: Product gallery zoom icon
  • ✨ NEW: Variable product color swatches
  • ✨ NEW: Recommended Plugins page with one-click installation
  • ✨ NEW: Footer Logo option (separate from header)
  • ✨ NEW: 18 bundled premium plugins
  • 🔧 IMPROVED: Accessibility with ARIA labels on all buttons
  • 🔧 IMPROVED: Blog/Magazine header top bar with all settings
  • 🔧 IMPROVED: Header color controls for all layouts
  • 🔧 IMPROVED: Admin UI with card-based layout selectors
  • 🐛 FIXED: List view CSS specificity issues
  • 🐛 FIXED: Right sidebar appearing on left
  • 🐛 FIXED: View mode blink on page refresh
  • 🐛 FIXED: Header settings not saving correctly

v1.0.9 (December 18, 2025)

  • 🐛 FIXED: Blog/Magazine top bar not showing all settings
  • 🐛 FIXED: Top bar centering issues
  • ✨ NEW: Contact info (phone, email, hours) in blog header

v1.0.8 (March 23, 2025)

  • 🐛 FIXED: Header background color not applying
  • 🐛 FIXED: CSS variables for header elements
  • 🔧 IMPROVED: All header elements use dynamic colors

v1.0.5 (January 31, 2025)

  • ✨ NEW: Card-based header layout selector
  • ✨ NEW: Header color controls (7 color pickers)
  • ✨ NEW: Card-based blog archive layout selector
  • ✨ NEW: Masonry blog layout option

v1.0.3 (January 03, 2025)

  • ✨ NEW: Blog sections in Homepage Builder
  • ✨ NEW: Featured Posts section
  • ✨ NEW: Authors Grid section
  • ✨ NEW: Post Categories section

v1.0.0 (December 25, 2024)

  • 🎉 Initial release

Need Help?

Get support and stay updated with the latest features

📧 Contact Support 📖 View Full Docs