Introduction

The General Settings page is your control center for AIPersonalize360. This guide explains every setting and helps you configure the plugin for optimal performance.

Access settings by navigating to AIPersonalize360 → Settings in your WordPress dashboard.

AI Engine Settings

AI Engine Dropdown

  • Location: First setting at top of page
  • Options:
    • “Select one” – No AI, uses WooCommerce data only
    • “Recombee” – AI-powered personalized recommendations
  • Default: “Select one”
  • Description: “Select AI Engine. If not select any AI engine then it will display personalized product recommendations on your site based on ratings, total sales, and on-sale items.”

When to Use Each Option

  • “Select one” (No AI):
    • New stores testing the plugin
    • Small catalogs (under 50 products)
    • Don’t want to use external services
    • Want immediate results without setup
  • “Recombee” (AI):
    • Want personalized recommendations per user
    • Have registered user base
    • Larger product catalogs (50+ products)
    • Want to maximize conversions

Recombee Settings

These settings appear when “Recombee” is selected as AI Engine:

Database Name

  • Description: Your Recombee database identifier
  • Where to Find: Recombee Dashboard → Database Settings → Database ID
  • Format: Alphanumeric string (e.g., “mystore-dev”)
  • Help Text: “Enter your production or development database here. You can get database name, private token and region from here. All the required information you will find from your Recombee Dashboard Database Settings section.”

Private Token

  • Description: API key for server-side usage
  • Where to Find: Recombee Dashboard → Settings → API ID & Tokens
  • Format: Long alphanumeric token
  • Security: Keep private, never share publicly
  • Help Text: “API ID for usage at server side. You can get database name, private token and region from here. All the required information you will find from your Recombee Dashboard Database Settings section.”

Region

  • Description: Server region for your Recombee database
  • Where to Find: Recombee Dashboard → Database Settings
  • Common Values:
    • us-west (US West Coast)
    • us-east (US East Coast)
    • eu-west (Europe)
    • ap-se (Asia-Pacific)
  • Help Text: “Server region. You can get database name, private token and region from here. All the required information you will find from your Recombee Dashboard Database Settings section.”
Important

All three Recombee fields (Database Name, Private Token, Region) must be filled correctly for AI integration to work. Incorrect values will result in connection errors.

Display Settings

Title

  • Description: Heading displayed above recommendations block
  • Default: “Recommended Products” (or similar)
  • Help Text: “Product Recommendations Block Heading”
  • Examples:
    • “You May Like”
    • “Featured Products”
    • “Trending Now”
    • “Handpicked for You”
  • Can Override: Yes, using shortcode title attribute

Description

  • Description: Optional text displayed below title
  • Default: Empty or default description
  • Help Text: “Show Description Below Heading Block”
  • Examples:
    • “Based on your browsing”
    • “Customers also bought”
    • “Popular in your area”
    • “Limited time offers”
  • Can Override: Yes, using shortcode description attribute

Show Number of Items

  • Description: How many products to display in recommendations block
  • Default: 3
  • Help Text: “How many items you want to show in recommendations block”
  • Recommended Range: 3-6 products
  • Considerations:
    • Too few (1-2): Limited choices
    • Optimal (3-6): Good balance
    • Too many (10+): Overwhelming, slow loading

Shortcode Reference

The settings page displays available shortcodes:

[aipers_product_recommendations]

Description: “Use the above shortcode to any posts, page or page template. You can pass Title and Description for this shortcode as a shortcode attribute like this [aipers_product_recommendations title=”Write your title here” description=”Write your description here”]”

Description: “Use the above shortcode for the related products recommendations inside single product template. You can pass Title and Description for this shortcode as a shortcode attribute like this [aipers_related_product_recommendations title=”Write your title here” description=”Write your description here”]”

Saving Settings

  1. Review all your changes
  2. Scroll to bottom of page
  3. Click Save Changes button
  4. Wait for success message
  5. Changes take effect immediately
Settings Saved

You’ll see a confirmation message when settings are saved successfully.

Testing Your Configuration

  1. Save your settings
  2. Add shortcode to a test page:
    [aipers_product_recommendations]
  3. View the page
  4. Verify:
    • Title displays correctly
    • Description shows if set
    • Correct number of products display
    • Products are relevant (AI) or based on ratings/sales (no AI)

Troubleshooting

Settings not saving

  • Check you’re logged in as Administrator
  • Verify browser JavaScript is enabled
  • Try a different browser
  • Check for PHP errors in debug log

Recombee connection failing

  • Double-check Database Name
  • Verify Private Token is complete and correct
  • Ensure Region matches your Recombee database
  • Test connection in Recombee dashboard

Recommendations not updating

  • Clear page cache if using caching plugin
  • Refresh page in browser
  • Check that “Show Number of Items” is greater than 0
  • Verify WooCommerce has published products

Advanced Tips

Development vs Production

Use separate Recombee databases for:

  • Development: Testing and experimentation
  • Production: Live site with real customer data

Dynamic Titles Per Page

Override default title using shortcode attributes on different pages:

  • Home: [aipers_product_recommendations title="Trending"]
  • Product: [aipers_related_product_recommendations title="Similar"]

Seasonal Adjustments

  • Update title/description for holidays
  • Adjust number of items for promotions
  • Remember to change back after season