Order Line Item Status Plugin Documentation

Table Of Content

    The Order Line Item Status plugin enables WooCommerce store administrators to configure order statuses for individual products. It gives store owners flexibility by allowing them to set different statuses for each item in the order and use customizable variables like product name, quantity, and item status. This plugin makes it easier to manage orders by enabling more granular control over item-level statuses.

    Features

    • Multiple Order Status Options: Customize statuses for Pending payment, Processing, On hold, Completed, Cancelled, Refunded, Failed, and Draft.

    • Product-Specific Statuses: Set order statuses for each product in the cart individually, offering better control.

    • Dynamic Variables for Customization: Use variables like {product_name}, {product_quantity}, and {item_status} for dynamic content in order line items.
    • Backend Settings: Enable or disable individual statuses for the order line items directly from the settings page.
    • Product-Level Control: Apply individual order statuses at the product level for more precise tracking.

    Benefits of the Order Line Item Status Plugin

    1. Granular Control Over Order Statuses: The plugin provides control over each individual product’s status within an order, improving order management.
    2. Improved Order Tracking: Easily track the status of specific products, rather than entire orders, for more detailed insights.
    3. Customization: Use dynamic variables to display product-specific details like name, quantity, and status within the order details.
    4. Increased Efficiency: Helps improve customer support and order fulfillment by clearly identifying the status of each item in an order.
    5. Product-Specific Order Handling: Apply unique statuses to each product, allowing for customized workflows and handling.

    Installation Guide

    Step 1: Download the Plugin

    1. Download the Order Line Item Status plugin ZIP file from the source.

    Step 2: Install the Plugin

    1. Log in to your WordPress admin panel.
    2. Go to Plugins > Add New.
    3. Click Upload Plugin and select the ZIP file you downloaded.
    4. Click Install Now and then activate the plugin.

    Step 3: Activate the Plugin

    1. Once installed, click the Activate button to activate the plugin.

    Step 4: Confirm Activation

    1. After activation, you will see Order Line Item Status in the WooCommerce > Settings menu.

    Configuration

    Backend Settings

    The Order Line Item Status plugin allows you to configure individual statuses for each product. Each order item can have a separate status, making it easier to track the progress of items within a single order.

    1. Pending Payment Status
      • Enable or disable the pending payment status for order line items. This status applies to items waiting for payment.
    2. Processing Status
      • Enable or disable the processing status for order line items. This status applies to items that are being processed.
    3. On Hold Status
      • Enable or disable the on-hold status for order line items. This status applies to items that are on hold, possibly due to stock issues or customer request.
    4. Completed Status
      • Enable or disable the completed status for order line items. This status applies to items that have been completed and shipped.
    5. Cancelled Status
      • Enable or disable the cancelled status for order line items. This status applies to items that have been cancelled.
    6. Refunded Status
      • Enable or disable the refunded status for order line items. This status applies to items that have been refunded.
    7. Failed Status
      • Enable or disable the failed status for order line items. This status applies to items whose payment has failed.
    8. Draft Status
      • Enable or disable the draft status for order line items. This status applies to items that are in draft mode and have not yet been finalized.

    Product Level Settings

    Each setting can also be applied at the product level, allowing store administrators to set specific statuses for individual products within an order. This flexibility helps manage orders at a granular level and improves the customer experience.

    Variable Usage

    The plugin supports the use of variables for dynamic content. You can use the following variables in the order line item settings:

    • {product_name}: Displays the name of the product.
    • {product_quantity}: Displays the quantity of the product.
    • {item_status}: Displays the current status of the product in the order.

    Scenario: Using Order Line Item Status for Backordered Items

    Imagine you sell products that sometimes go on backorder. You want to use the On Hold status for these items while the rest of the order is processed.

    Here’s how you can set it up:

    1. In the Backend Settings:
      • Enable the On Hold Status for items that are backordered.
      • Disable the Processing Status for backordered items to prevent them from moving to processing until they are available.
    2. At the Product Level:
      • For the specific backordered product(s), set the status to On Hold.
      • Use the variable {item_status} in the order email to indicate that the product is on hold.
    3. Using Variables:
      • In the email message for order updates, include a note such as:
        “Your order contains {product_quantity} of {product_name} which is currently {item_status}. We will notify you once it’s available for shipment.”

    This setup helps your customers understand that certain products in their order are backordered, and the rest of the items will be processed as usual.

    Frequently Asked Questions (FAQs)

    1. Can I apply the same order status for all products in an order?

    Yes, you can apply the same order status globally by enabling or disabling the settings for each status type at the product level.

    2. How do I use the variables like {product_name}, {product_quantity}, and {item_status}?

    You can use these variables in the product status settings to display product-specific details dynamically. For example, you can configure the order status email to include the product name and quantity.

    3. Is this plugin compatible with other WooCommerce extensions?

    Yes, the Order Line Item Status plugin is fully compatible with WooCommerce and can be used alongside other extensions.