Bundles

This comprehensive guide covers everything you need to know about managing bundles in your e-commerce system. From displaying bundles in order emails to handling bundle searches and managing orders, you'll find detailed instructions and examples for each functionality.

How to View a Bundle in Order Mail

Email notifications for orders containing bundles require special template configuration to properly display bundle information. Follow these steps to ensure proper bundle display in order confirmation emails:

  1. Navigate to your templates directory
  2. Locate and open the templates/new_order_letter.html file
  3. Update the template with the following code block
  4. Clear the templates_c directory to ensure the template changes take effect

The following code snippet creates a table row for each bundle in the order, displaying the quantity, name, unit price, and final price:

<{foreach key=key name=main from=$bundles item=currbund}>
    <tr>
        <td style="font-size: 11px; padding-left: 10px; border-bottom: 1px solid #B39964; font-family: Arial, Helvetica, sans-serif;">
            <{$currbund.quantity}>
        </td>
        <td style="font-size: 11px; border-bottom: 1px solid #B39964; font-family: Arial, Helvetica, sans-serif;">
            $<{$currbund.name}>
        </td>
        <td style="font-size: 11px; border-bottom: 1px solid #B39964; font-family: Arial, Helvetica, sans-serif;">
            $<{$currbund.unit_price|string_format:"%.2f"}>
        </td>
        <td style="font-size: 11px; border-bottom: 1px solid #B39964; font-family: Arial, Helvetica, sans-serif;">
            $<{$currbund.final_price|string_format:"%.2f"}>
        </td>
    </tr>
<{/foreach}>
Price Display Tip:When showing discounts, you have two options:
  • $discount_total: Shows the total discount including shipping
  • $discount: Shows only the discount applied to the product
Choose the appropriate variable based on your pricing display requirements.

Searching for Bundles

The site search functionality can be configured to include bundles in search results. This feature is particularly useful for customers looking for specific bundle offerings or trying to locate bundle deals.

To enable bundle search functionality, modify your search URL to include both products and bundles in the search index:

index=prodcat_products+bundles

The combined index allows customers to search across both individual products and bundles simultaneously, improving the shopping experience.

Viewing Bundles and Products

The system provides a comprehensive interface for viewing and managing bundles and products. Access this functionality through the bundle catalog URL:

http://www.yoursite.com/index.php?action=prodcatalogue&form_name=view_bundles_products

Customize the viewing experience using these URL parameters:

category_id (optional): Filter results by specific category. Useful for organizing large catalogs into manageable sections.

start (optional): Set the starting point for pagination. Particularly useful when dealing with large numbers of bundles.

per_page (optional): Control how many items appear per page. Adjust this based on your layout and user experience preferences.

order (optional): Specify how results should be sorted. Available sorting options include:

  • price: Sort by bundle price
  • name: Alphabetical sorting
  • tags: Sort by associated tags
  • date_created: Sort by creation date


Viewing Individual Bundles

Access detailed information about specific bundles using the bundle viewer URL structure. This view provides comprehensive information about a single bundle's contents, pricing, and details.

http://www.yoursite.com/index.php?action=prodcatalogue&form_name=view_bundle&bundle_id=9

Replace the bundle_id parameter with the appropriate identifier for the bundle you wish to view.

Bundle Reorder System

The reorder system allows customers to view and potentially reorder previous bundle purchases. Access order details using the order tracking URL:

http://www.yoursite.com/index.php?action=prodcatalogueorder&form_name=trackorders&order_id=26029
Important Security Note: Always validate user permissions before displaying order information to ensure customers can only access their own order details.

Best Practices