FluentCart E-Commerce Setup

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:
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:
4. Click Publish

Step 4: Configure Payment Gateways

1. Go to FluentCart > Settings > Payment
2. Enable payment methods:
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 > Header > Primary Header > Enable Cart Icon

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 > Header > Primary Header

Setting	Options	Default
Enable Cart Icon	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	800×800
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
2. Use comment system
3. Third-party integration

How do I organize products by category?

1. Go to FluentCart > Categories
2. Create new category (e.g., “Electronics”)
3. When creating/editing product:
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 > Header > Primary Header
2. Verify Enable Cart Icon 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

• Header Cart Icon – Configure cart display
• Sidebar Layouts – Product page sidebars
• Page Templates – Full-width layouts

Additional Resources

• FluentCart Documentation – Official docs
• FluentCart HOOKS Reference – Developer hooks
• FluentCart README – Technical details

---

Need Help?

• Visit our Documentation Portal
• Contact Support at support@wbcomdesigns.com