BuddyX
Get BuddyX Pro

FluentCart E-Commerce Setup

Free & Pro

BuddyX Pro provides complete FluentCart integration, turning your WordPress site into a modern e-commerce platform with native theme styling, cart functionality, and seamless checkout experience.

What is FluentCart?

FluentCart is a lightweight e-commerce plugin for WordPress. Combined with BuddyX Pro, you get:

  • Product catalog with categories and brands
  • Shopping cart with real-time updates
  • Secure checkout process
  • Order management
  • Payment gateway integration
  • Digital and physical product support
  • Subscription products (with FluentCart Pro)
  • Header cart icon with live count
  • Mobile-optimized shopping experience

Requirements

Requirement Minimum Recommended
FluentCart 1.2.4 Latest
PHP 8.0 8.2+
WordPress 6.0 Latest

Optional: FluentCart Pro for subscriptions, memberships, and advanced features.

Installation & Setup

Step 1: Install FluentCart

  1. Go to Plugins > Add New
  2. Search for "FluentCart"
  3. Click Install Now then Activate

Step 2: Run Setup Wizard

  1. FluentCart setup wizard launches automatically
  2. Configure basic settings:
    • Store name and location
    • Currency settings
    • Checkout pages (auto-created)
  3. Click through wizard steps
  4. Finish setup

Step 3: Add Your First Product

  1. Navigate to FluentCart > Products
  2. Click Add New Product
  3. Enter product details:
    • Product name
    • Description
    • Price
    • Product image
    • Inventory
  4. Click Publish

Step 4: Configure Payment Gateways

  1. Go to FluentCart > Settings > Payment
  2. Enable payment methods:
    • Stripe
    • PayPal
    • Other gateways
  3. Enter API credentials
  4. Test payment processing
  5. Save settings

What You Can Do

Product Management

Feature Description
Create Products Add unlimited products with images
Product Variants Size, color, style options
Product Categories Organize by category
Product Brands Filter by brand
Digital Products Sell downloads
Physical Products Manage inventory and shipping
Pricing Options Regular, sale, subscription pricing
Product Gallery Multiple product images

Store Features

Feature Description
Shop Page Main product catalog
Category Pages Browse by category
Brand Pages Browse by brand
Product Search Find products quickly
Product Filters Filter by price, category, etc.
Cart Drawer Slide-out shopping cart
Checkout Page Secure purchase process
Order Confirmation Receipt and order details

Customer Experience

Feature Description
Guest Checkout Buy without account
User Accounts Save addresses, view orders
Order History Past purchase tracking
Cart Persistence Cart saved between visits
Real-time Cart Updates Instant cart count changes
Mobile Responsive Optimized for all devices

BuddyX Pro Theme Features

Header Cart Icon

BuddyX Pro integrates a cart icon directly into your site header:

Feature Description
Cart Icon Shopping cart icon in header menu
Live Count Badge Shows number of items in cart
Cart Drawer Toggle Click to open FluentCart drawer
Real-time Updates Badge updates when cart changes
Mobile Optimized Responsive on all screen sizes

Enable/Disable: Customize > Site Header > Site Cart

Shop Page Styling

Layout Element Description
Full Width Layout Product grid spans full width
Product Grid Responsive card-based layout
Category Filters Styled filter sidebar
Search Bar Custom search interface
Breadcrumbs Navigation path
Sort Options Price, name, date sorting

Single Product Pages

Component BuddyX Pro Enhancement
Product Gallery Responsive image gallery with zoom
Product Info Clean price, description layout
Add to Cart Button Styled call-to-action
Product Meta Category, brand, SKU display
Related Products "You May Also Like" section
Product Tabs Description, specs, reviews

Checkout Experience

Feature Description
Clean Layout Full-width checkout template
Step Indicators Visual checkout progress
Form Styling Styled checkout fields
Order Summary Cart review sidebar
Payment Options Styled payment method selection
No Distractions Header/footer simplified

Customizer Settings

Navigate to Appearance > Customize to configure FluentCart integration.

Cart Icon Setting

Location: Customize > Site Header

Setting Options Default
Site Cart Yes/No Yes

Note: Cart icon only appears when WooCommerce and SureCart are not active.

Product Sidebar Setting

Location: Customize > Sidebar > Sidebar Layout

Setting Options Default
Single Product Sidebar Right, Left, Both, None None

Layout Options:

  • None - Full-width product display (recommended)
  • Right - Product content with right sidebar
  • Left - Product content with left sidebar
  • Both - Product content with two sidebars

Available Widget Areas

Widget Area Description
FluentCart Left Sidebar Appears on product pages with left sidebar
FluentCart Right Sidebar Appears on product pages with right sidebar

Recommended Sidebar Widgets

Product Sidebar:

  • Product Search
  • Product Categories
  • Popular Products
  • Recent Products
  • Product Tags

Page Templates

BuddyX Pro automatically applies optimal templates for FluentCart pages:

Shop Pages

Page Type Template Used Layout
Main Shop archive-fluent-products.php Full width
Category Archive taxonomy-product-categories.php Full width
Brand Archive taxonomy-product-brands.php Full width
Single Product FluentCart default + theme styling Customizable sidebar

Special Pages

Page Auto-Applied Template Customizable
Checkout Full Width Yes
Cart Full Width Yes
Receipt Full Width Yes

To change page template:

  1. Edit the page
  2. Find Page Attributes box
  3. Select Template dropdown
  4. Choose desired template
  5. Update page

FluentCart Settings

Configure FluentCart at FluentCart > Settings.

General Settings

Setting Description Default
Store Name Your shop name Site title
Store Address Business location (empty)
Currency Price currency USD
Currency Position Before/after price Before

Product Settings

Setting Description Default
Products Per Page Shop page display count 12
Product Image Size Gallery dimensions 800x800
Enable Reviews Product reviews No
Stock Management Inventory tracking Yes

Checkout Settings

Setting Description Default
Guest Checkout Allow non-registered purchases Yes
Account Creation Create account during checkout Optional
Checkout Fields Required customer info Name, email, address
Terms & Conditions Require acceptance No

Cart Settings

Setting Description Default
Enable Cart Shopping cart functionality Yes
Cart Persistence Save cart between sessions Yes
Empty Cart Button Clear all items option Yes
Continue Shopping URL Return to shop link Shop page

Recommended Configurations by Use Case

Digital Products Store

Best For: Courses, ebooks, software, memberships

Settings:

  • Product sidebar: None (full width)
  • Products per page: 16
  • Guest checkout: Yes (faster conversions)
  • Inventory management: Off (digital products)
  • Cart icon: Enabled

Homepage Setup:

  1. Use page builder for hero section
  2. Add product grid shortcode
  3. Feature bestsellers
  4. Include testimonials

Physical Products Store

Best For: Retail, merchandise, handmade goods

Settings:

  • Product sidebar: Right (categories widget)
  • Products per page: 12
  • Guest checkout: Yes
  • Stock management: On
  • Shipping zones: Configured

Features to Enable:

  • Product variations (size, color)
  • Shipping calculator
  • Tax settings by region
  • Low stock notifications

Membership/Subscription Site

Best For: Recurring products, clubs, services

Requirements: FluentCart Pro required

Settings:

  • Product sidebar: None
  • Subscription products: Enabled
  • Recurring payments: Configured
  • Account creation: Required

Integration:

  • Connect with LearnDash for course access
  • Use BuddyPress for member community
  • Enable FluentCart subscription features

Hybrid Content + Commerce

Best For: Blog/magazine with shop section

Settings:

  • Product sidebar: Right (blog-style)
  • Products per page: 9
  • Cart icon: Enabled (prominent)
  • Featured products: On homepage

Setup:

  • Create shop menu item
  • Add product widget to blog sidebar
  • Feature products in blog posts
  • Use shortcodes in content

FluentCart vs WooCommerce

If you're familiar with WooCommerce, here are key differences:

Feature WooCommerce FluentCart
Plugin Size Large (many features) Lightweight, focused
Performance Can be heavy Fast, optimized
Setup Complexity More options Simpler setup
Extensions Massive ecosystem Growing marketplace
BuddyX Pro Support Full support Full support
Cart Experience Page-based Drawer-based
Admin Interface WordPress native Custom React UI

When to Use FluentCart:

  • You want lightweight, fast e-commerce
  • You're starting a new store
  • You need simple, focused features
  • You prefer modern drawer-based cart

When to Use WooCommerce:

  • You need extensive third-party plugins
  • You have complex requirements
  • You're migrating existing WooCommerce store
  • You need specific WooCommerce extensions

Common Questions

Does the cart icon work on mobile?

Yes! The cart icon is fully responsive and works on all devices. On mobile, it remains in the mobile header menu.

Can I customize product layouts?

Yes. BuddyX Pro provides:

  • Sidebar options via Customizer
  • Full-width or sidebar layouts per product
  • Custom CSS for styling
  • Child theme for template overrides

How do I change the number of products displayed?

  1. Go to FluentCart > Settings > Products
  2. Find Products Per Page setting
  3. Enter desired number (e.g., 12, 16, 20)
  4. Save settings

Can I hide the cart icon?

Yes:

  1. Go to Appearance > Customize
  2. Navigate to Header > Primary Header
  3. Find Enable Cart Icon setting
  4. Toggle to No
  5. Click Publish

Why is my checkout page full width?

BuddyX Pro automatically applies full-width template to checkout for optimal experience. This is intentional and recommended.

To change:

  1. Edit checkout page
  2. Find Page Attributes
  3. Select different template
  4. Update page (not recommended)

Can I add product reviews?

FluentCart doesn't include reviews by default. Options:

  1. Use review plugin
    • Install "FluentCart Reviews" (if available)
    • Or use generic WordPress review plugin
  2. Use comment system
    • Enable WordPress comments on products
    • Style via custom CSS
  3. Third-party integration
    • Integrate Judge.me or similar service

How do I organize products by category?

  1. Go to FluentCart > Categories
  2. Create new category (e.g., "Electronics")
  3. When creating/editing product:
    • Find Product Categories box
    • Check desired categories
  4. Save product

Category pages: Automatically created at /product-categories/category-name/

Can I integrate with BuddyPress?

Yes! FluentCart works alongside BuddyPress:

  • Members can view their order history
  • Purchase notifications appear in activity
  • Orders link to member profiles
  • Group leaders can sell to members

Why aren't related products showing?

Requirements:

  1. Products must share same category or tag
  2. Must have at least 2+ products published
  3. Related products feature must be enabled

To enable:

  1. Go to FluentCart > Settings > Products
  2. Find Related Products option
  3. Set to Enabled
  4. Configure number to display
  5. Save settings

How do I create product variations?

  1. Edit or create product
  2. Select Product Type: Variable Product
  3. Add Attributes (e.g., Size: Small, Medium, Large)
  4. Go to Variations tab
  5. Click Add Variation
  6. Set price/SKU for each variation
  7. Save product

Can I sell subscriptions?

Yes, with FluentCart Pro:

  1. Install FluentCart Pro
  2. Create new product
  3. Select Product Type: Subscription
  4. Configure billing cycle (weekly, monthly, yearly)
  5. Set subscription price
  6. Save product

Troubleshooting

Cart Icon Not Appearing

Problem: Cart icon missing from header.

Solutions:

  1. Go to Customize > Site Header
  2. Verify Site Cart is set to Yes
  3. Ensure WooCommerce/SureCart are not active (conflict)
  4. Clear browser and server cache
  5. Check that FluentCart is active

Products Not Displaying

Problem: Shop page empty or products missing.

Solutions:

  1. Verify products are published (not drafts)
  2. Check product visibility settings
  3. Flush permalinks (Settings > Permalinks > Save)
  4. Ensure shop page is configured correctly
  5. Check for theme conflicts

Checkout Page Errors

Problem: Checkout doesn't load or shows errors.

Solutions:

  1. Verify checkout page exists and has FluentCart shortcode
  2. Check that payment gateway is configured
  3. Enable WordPress debug to see error messages
  4. Test with default theme to rule out theme conflict
  5. Clear all caching

Cart Count Not Updating

Problem: Badge shows wrong number or doesn't update.

Solutions:

  1. Clear browser cache
  2. Check for JavaScript errors in console
  3. Ensure FluentCart JS is loading
  4. Disable conflicting plugins
  5. Re-save theme customizer settings

Sidebar Not Showing on Products

Problem: Product pages missing sidebar even when enabled.

Solutions:

  1. Add widgets to FluentCart sidebar widget areas
  2. Check Customize > Sidebar product setting
  3. Verify sidebar isn't set to "None"
  4. Ensure widgets are in correct widget area
  5. Clear theme cache

Payment Gateway Not Working

Problem: Cannot process payments.

Solutions:

  1. Verify gateway credentials are correct
  2. Check that gateway is enabled
  3. Test with Stripe/PayPal test mode first
  4. Review gateway documentation
  5. Check for SSL certificate (required for live payments)

Performance Optimization

Speed Recommendations

  • Use caching: Enable WordPress object cache
  • Optimize images: Compress product images
  • CDN: Use CDN for product gallery
  • Lazy loading: Enable for product images
  • Minify assets: Combine CSS/JS files

Best Practices

  • Limit products per page to 12-20
  • Use appropriately sized product images
  • Enable browser caching
  • Use lazy load for product galleries
  • Optimize database regularly

Related Settings

Additional Resources

Got a question? We're a friendly team - happy to help.