Blog

WooCommerce provides a flexible platform for customizing your online store. One useful customization is adding a custom fee to the checkout process based on the product category in the cart. This can be particularly useful if you need to charge extra for certain types of products, such as those in a “custom fee” category.

In this blog post, we will guide you through the steps to add a custom fee to the WooCommerce checkout if a product from the “custom fee” category is in the cart. We will include the necessary code snippets and explanations to help you implement this feature.

Step 1: Add the Custom Fee Function

First, we need to add a function that checks if there are any products from the “custom fee” category in the cart and then adds the custom fee accordingly. Place this code in your theme’s functions.php file or a custom plugin.

// Add a custom fee if a product from the "custom fee" category is in the cart
add_action( 'woocommerce_cart_calculate_fees', 'add_custom_fee_based_on_category' );

function add_custom_fee_based_on_category() {
    global $woocommerce;

    // Define the category for which the custom fee should be applied
    $custom_fee_category = 'custom fee';

    // Define the custom fee amount
    $custom_fee_amount = 10; // Change this to the desired fee amount

    // Check if any product from the defined category is in the cart
    $category_found = false;
    foreach ( WC()->cart->get_cart() as $cart_item ) {
        $product = wc_get_product( $cart_item['product_id'] );
        if ( has_term( $custom_fee_category, 'product_cat', $product->get_id() ) ) {
            $category_found = true;
            break;
        }
    }

    // If a product from the category is found, add the custom fee
    if ( $category_found ) {
        WC()->cart->add_fee( __( 'Custom Fee', 'woocommerce' ), $custom_fee_amount );
    }
}

Step 2: Customize the Fee Amount and Category

In the code snippet above, you can customize the following parameters:

• $custom_fee_category: Set this variable to the slug of the product category for which you want to apply the custom fee.
• $custom_fee_amount: Set this variable to the amount you want to charge as a custom fee.

Step 3: Add the Custom Fee Label Translation

To ensure the custom fee label is translatable, wrap the label in the __() function, as shown in the code above. You can replace 'Custom Fee' with any other label that suits your needs.

Step 4: Testing the Custom Fee

After adding the code to your functions.php file or custom plugin, it’s important to test the functionality:

1. Add a Product from the “Custom Fee” Category: Add a product that belongs to the “custom fee” category to the cart.
2. Proceed to Checkout: Go to the checkout page and verify that the custom fee is applied correctly.
3. Remove the Product: Remove the product from the cart and ensure that the custom fee is no longer applied.

Conclusion

By following these steps, you can easily add a custom fee to the WooCommerce checkout process based on the product category. This customization can help you manage additional charges for specific products and improve your store’s functionality.

Feel free to modify the code to fit your specific requirements. Happy customizing!

WooCommerce is a powerful and flexible e-commerce platform built on WordPress. Customizing it to suit your specific needs can be a game-changer for your online business. One such customization is creating custom email notifications to send to your vendors. This can be useful for order notifications, updates, or any specific information that needs to be communicated to your vendors.

In this blog post, we will walk through the steps to create a custom email in WooCommerce to send to a vendor. We will cover the following:

1. Setting up the custom email class.
2. Registering the custom email with WooCommerce.
3. Triggering the email based on specific events.

Step 1: Setting Up the Custom Email Class

The first step is to create a custom email class. This class will define the content and behavior of the email. Place this code in your theme’s functions.php file or a custom plugin.

if ( ! class_exists( 'WC_Vendor_Email' ) ) {
    class WC_Vendor_Email extends WC_Email {

        public function __construct() {
            $this->id = 'wc_vendor_email';
            $this->title = 'Vendor Email';
            $this->description = 'This email is sent to the vendor when a new order is placed.';
            $this->heading = 'New Order Notification';
            $this->subject = 'New Order Received';

            $this->template_html  = 'emails/vendor-email.php';
            $this->template_plain = 'emails/plain/vendor-email.php';

            add_action( 'woocommerce_order_status_completed_notification', array( $this, 'trigger' ) );

            parent::__construct();
        }

        public function trigger( $order_id ) {
            if ( ! $order_id ) return;

            $this->object = wc_get_order( $order_id );
            $this->recipient = '[email protected]'; // Replace with the vendor's email address

            if ( ! $this->is_enabled() || ! $this->get_recipient() ) {
                return;
            }

            $this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() );
        }

        public function get_content_html() {
            return wc_get_template_html( $this->template_html, array(
                'order'         => $this->object,
                'email_heading' => $this->get_heading(),
                'sent_to_admin' => false,
                'plain_text'    => false,
                'email'         => $this,
            ) );
        }

        public function get_content_plain() {
            return wc_get_template_html( $this->template_plain, array(
                'order'         => $this->object,
                'email_heading' => $this->get_heading(),
                'sent_to_admin' => false,
                'plain_text'    => true,
                'email'         => $this,
            ) );
        }

    }
}

Step 2: Registering the Custom Email with WooCommerce

Next, we need to register our custom email with WooCommerce. This will make WooCommerce aware of the new email class we just created. Add the following code to the same file where you defined the custom email class.

add_filter( 'woocommerce_email_classes', 'register_vendor_email' );
function register_vendor_email( $email_classes ) {
    $email_classes['WC_Vendor_Email'] = include( 'path/to/WC_Vendor_Email.php' ); // Adjust the path as needed
    return $email_classes;
}

Step 3: Triggering the Email Based on Specific Events

In our custom email class, we added a trigger to send the email when an order is completed. This is done using the woocommerce_order_status_completed_notification hook. If you want to trigger the email based on different events, you can change the hook accordingly.

For example, to trigger the email when an order is placed, you can use the woocommerce_thankyou hook.

add_action( 'woocommerce_thankyou', 'trigger_vendor_email', 10, 1 );
function trigger_vendor_email( $order_id ) {
    $email = WC()->mailer()->emails['WC_Vendor_Email'];
    $email->trigger( $order_id );
}

Customizing the Email Template

Finally, you need to create the email templates. Place the HTML and plain text templates in your theme’s WooCommerce email directory (your-theme/woocommerce/emails/).

HTML Template (vendor-email.php):

<?php
if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly

echo $email_heading . "\n\n";

echo '<p>Dear Vendor,</p>';
echo '<p>You have received a new order. Here are the details:</p>';

// Include order details template
wc_get_template( 'emails/email-order-details.php', array( 'order' => $order ) );

echo '<p>Best regards,</p>';
echo '<p>Your Company</p>';

echo $email_footer;
?>

Plain Text Template (plain/vendor-email.php):

<?php
if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly

echo $email_heading . "\n\n";

echo "Dear Vendor,\n";
echo "You have received a new order. Here are the details:\n\n";

// Include order details template
wc_get_template( 'emails/plain/email-order-details.php', array( 'order' => $order ) );

echo "Best regards,\n";
echo "Your Company\n";

echo $email_footer . "\n";
?>

Conclusion

By following these steps, you can create a custom email in WooCommerce to send notifications to your vendors. This customization can improve communication and streamline processes in your e-commerce store. Remember to test your custom email thoroughly to ensure it works as expected.

Feel free to modify the code and templates to fit your specific needs. Happy coding!

In WooCommerce, there are times when you might want to automatically add an additional product to the cart when a specific product is added. This is often referred to as a “forced sell.” In this blog post, we will walk you through how to achieve this using WooCommerce hooks and custom code.

Step-by-Step Guide

Prerequisites

• A running WooCommerce store.
• Basic knowledge of PHP and WordPress/WooCommerce hooks.

Step 1: Identify Product IDs

First, you need to know the IDs of both the primary product and the additional product you want to add to the cart. You can find the product IDs by going to the WooCommerce Products page and hovering over the product names.

Step 2: Add Custom Code to Your Theme

We will add the custom code to the functions.php file of your active theme. You can access this file via the WordPress admin dashboard or using FTP.

Step 3: Write the Code

Below is the code to automatically add an additional product to the cart when a specific product is added:

// Add additional product to the cart if a certain product is present
function add_forced_sell_product( $cart_item_data, $product_id, $variation_id ) {
    // Set the product ID of the primary product
    $target_product_id = 123; // Replace 123 with your primary product ID

    // Set the product ID of the additional product
    $additional_product_id = 456; // Replace 456 with your additional product ID

    // Check if the primary product is being added to the cart
    if ( $product_id == $target_product_id ) {
        // Check if the additional product is already in the cart
        $found = false;
        foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
            if ( $cart_item['product_id'] == $additional_product_id ) {
                $found = true;
                break;
            }
        }

        // If the additional product is not found, add it to the cart
        if ( ! $found ) {
            WC()->cart->add_to_cart( $additional_product_id );
        }
    }

    return $cart_item_data;
}
add_filter( 'woocommerce_add_cart_item_data', 'add_forced_sell_product', 10, 3 );

Step 4: Save and Test

After adding the code, save the functions.php file and test your WooCommerce store:

1. Add the primary product (with the ID you specified) to your cart.
2. Check the cart to see if the additional product is automatically added.

Explanation of the Code

• Hooking into the Cart Process: We use the woocommerce_add_cart_item_data filter to hook into the process of adding items to the cart.
• Product IDs: We set the target product ID (the product that triggers the addition) and the additional product ID (the product to be added).
• Cart Check: When the target product is added to the cart, we check if the additional product is already in the cart.
• Add Product: If the additional product is not already in the cart, we add it using the add_to_cart method.

Conclusion

By following these steps, you can easily set up a forced sell in WooCommerce, where adding a specific product to the cart automatically adds another product. This approach can be customized further to meet various business requirements, such as adding multiple products, applying conditions, or modifying quantities.

Feel free to leave a comment below if you have any questions or need further assistance!

Happy coding!

Adding custom shipping methods to the WooCommerce checkout process can be essential for tailoring shipping options to specific products. This blog post will guide you through the process of adding a custom shipping method when a particular product is in the cart using WooCommerce hooks and filters.

Step-by-Step Guide

Prerequisites

• A running WooCommerce store.
• Basic knowledge of PHP and WordPress/WooCommerce hooks.

Step 1: Identify the Product ID

First, you need to know the ID of the product for which you want to add custom shipping. You can find the product ID by going to the WooCommerce Products page and hovering over the product name.

Step 2: Add Custom Code to Your Theme

We will add the custom code to the functions.php file of your active theme. You can access this file via the WordPress admin dashboard or using FTP.

Step 3: Write the Code

Below is the code to add a custom shipping method when a specific product is in the cart:

// Add custom shipping method for specific product in WooCommerce
function add_custom_shipping_method( $available_methods ) {
    global $woocommerce;

    // Set the product ID for which the custom shipping should be applied
    $target_product_id = 123; // Replace 123 with your product ID

    // Loop through the cart items
    foreach ( $woocommerce->cart->get_cart() as $cart_item_key => $cart_item ) {
        if ( $cart_item['product_id'] == $target_product_id ) {
            // Define the custom shipping method
            $custom_shipping_method = array(
                'custom_shipping' => array(
                    'id'    => 'custom_shipping',
                    'label' => __( 'Custom Shipping', 'woocommerce' ),
                    'cost'  => '10.00', // Set the custom shipping cost
                ),
            );

            // Merge custom shipping method with available methods
            $available_methods = array_merge( $available_methods, $custom_shipping_method );
            break; // No need to add the shipping method more than once
        }
    }

    return $available_methods;
}
add_filter( 'woocommerce_package_rates', 'add_custom_shipping_method' );

Step 4: Save and Test

After adding the code, save the functions.php file and test your WooCommerce checkout process:

1. Add the specific product (with the ID you specified) to your cart.
2. Proceed to the checkout page.
3. You should see the custom shipping method applied to the order.

Explanation of the Code

• Hooking into the Shipping Methods: We use the woocommerce_package_rates filter to add our custom shipping method to the available shipping methods.
• Product ID and Shipping Cost: We set the target product ID and the custom shipping cost.
• Cart Loop: We loop through the cart items to check if the target product is in the cart.
• Define Custom Shipping Method: If the target product is found, we define the custom shipping method with its ID, label, and cost.
• Merge Shipping Methods: We merge the custom shipping method with the existing available shipping methods.

Conclusion

By following these steps, you can easily add a custom shipping method to the WooCommerce checkout process for specific products. This approach can be extended and customized further to meet various business requirements, such as applying different shipping methods based on product categories, quantities, or customer locations.

Feel free to leave a comment below if you have any questions or need further assistance!

Happy coding!

Adding custom fees to the WooCommerce checkout process can be a powerful way to handle additional charges for specific products. This blog post will guide you through adding a custom fee when a particular product is in the cart using WooCommerce hooks and filters.

Step-by-Step Guide

Prerequisites

• A running WooCommerce store.
• Basic knowledge of PHP and WordPress/WooCommerce hooks.

Step 1: Identify the Product ID

First, you need to know the ID of the product for which you want to add a custom fee. You can find the product ID by going to the WooCommerce Products page and hovering over the product name.

Step 2: Add Custom Code to Your Theme

We will add the custom code to the functions.php file of your active theme. You can access this file via the WordPress admin dashboard or using FTP.

Step 3: Write the Code

Below is the code to add a custom fee when a specific product is in the cart:

// Add custom fee for specific product in WooCommerce
function add_custom_fee_for_specific_product( $cart ) {
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    // Set the product ID for which the custom fee should be applied
    $target_product_id = 123; // Replace 123 with your product ID
    $fee_amount = 10; // Set the custom fee amount

    // Loop through the cart items
    foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
        // Check if the target product is in the cart
        if ( $cart_item['product_id'] == $target_product_id ) {
            // Add the custom fee
            $cart->add_fee( __( 'Custom Fee', 'woocommerce' ), $fee_amount );
            break; // No need to add the fee more than once
        }
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'add_custom_fee_for_specific_product' );

Step 4: Save and Test

After adding the code, save the functions.php file and test your WooCommerce checkout process:

1. Add the specific product (with the ID you specified) to your cart.
2. Proceed to the checkout page.
3. You should see the custom fee applied to the order.

Explanation of the Code

• Hooking into the Checkout Process: We use the woocommerce_cart_calculate_fees hook to add our custom fee logic during the cart calculation.
• Admin Check: The code first checks if the current request is an admin request and not an AJAX request to avoid unnecessary execution.
• Product ID and Fee Amount: We set the target product ID and the custom fee amount.
• Cart Loop: We loop through the cart items to check if the target product is in the cart.
• Add Fee: If the target product is found, we add the custom fee using the add_fee method.

Conclusion

By following these steps, you can easily add a custom fee to the WooCommerce checkout process for specific products. This approach can be extended and customized further to meet various business requirements, such as applying different fees based on product categories, quantities, or customer roles.

Feel free to leave a comment below if you have any questions or need further assistance!

Happy coding!