Cart Conflict Resolution Manager Documentation

    Overview

    Documentation for WebMe Cart Conflict Resolution Manager.

    User Documentation: WebMe Cart Conflict Resolution Manager

    Table of Contents

    1. Installation
    2. Setup
    3. Workflows
    4. FAQ

    Installation

    1. Install and activate WooCommerce.
    2. Install and activate Cart Conflict Resolution Manager.
    3. In wp-admin, open WooCommerce -> Cart Conflicts.

    Setup

    1. Start with a template or add a blank rule.
    2. Choose Pairwise for two-group conflicts or Exclusive for products that must ship alone.
    3. Enter comma-separated IDs for products, categories, tags, or shipping classes.
    4. Set the rule priority. Lower numbers win first.
    5. Customize the customer-facing message and optional suggestion.
    6. Save rules.

    Workflows

    • Create a pickup-only split rule

      1. Add the pickup-only template.
      2. Put pickup shipping classes in Group A.
      3. Put standard shipping classes in Group B.
      4. Save and test sample product IDs.

    • Force a product to be purchased alone

      1. Add the exclusive-product template.
      2. Enter one or more exclusive product IDs in Group A.
      3. Leave Group B unused.
      4. Save, then verify in the rule tester.

    • Move rules between stores

      1. Copy the export JSON from the admin screen.
      2. Paste it into another store's import box.
      3. Run import and confirm the success notice.

    Troubleshooting

    • Rule does not trigger: confirm IDs are correct and the rule is enabled.
    • Wrong message shows first: check priority values; lower numbers run first.
    • Variation handling seems off: the engine normalizes variation items against both variation and parent product IDs.
    • Menu missing: confirm your user can manage_woocommerce.

    FAQ

    Scale & Performance

    • Q: Will this add background jobs or heavy indexing?
    • A: No background queue or custom table exists in current code. Rule checks happen inline during WooCommerce cart validation and work against the current cart plus the saved rule option.

    Data & Footprint

    • Q: What data does the plugin store?
    • A: One WordPress option named webme_ccrm_rules containing schema version and normalized rule arrays.

    Lifecycle & Uninstallation

    • Q: What happens to my rules if I uninstall the plugin?
    • A: No uninstall routine is present in the current code, so removal behavior is not explicitly defined by the plugin.

    Compatibility & Conflicts

    • Q: Does this require WooCommerce?

    • A: Yes. If WooCommerce is unavailable, the plugin does not boot its rule UI or validation layer and instead shows an admin notice.

    • Q: Does it support HPOS?

    • A: Yes. The plugin declares custom_order_tables compatibility.

    Best Practices

    • Prefer shipping classes or categories for broad policy rules.
    • Use product IDs for exceptional one-off restrictions.
    • Keep messages short and use suggestion text for next-step guidance.
    • Test draft rules with real sample product IDs before saving to production.