如何在WooCommerce中按地域分配订单权限？多门店经理配置指导

Hey there! Let's figure out how to let each branch manager only view and handle orders from their assigned region on your WooCommerce site. Here's a practical, step-by-step solution that balances code flexibility and usability:

First, you'll want a dedicated role for branch managers that has limited permissions (not as broad as an admin or shop manager). You can add this role using a simple snippet in your theme's functions.php file or a custom plugin:

// Add custom branch manager role
add_action('init', 'create_branch_manager_role');
function create_branch_manager_role() {
    add_role(
        'branch_manager',
        'Branch Manager',
        array(
            'read' => true,
            'edit_posts' => false,
            'manage_woocommerce' => false,
            'view_woocommerce_reports' => false,
            'edit_shop_orders' => true,
            'read_shop_orders' => true,
            'edit_others_shop_orders' => false,
            'publish_shop_orders' => false,
            'delete_shop_orders' => true, // Adjust based on if you want them to delete orders
        )
    );
}

This gives them basic order management permissions without letting them modify other site settings.

Next, you need a way to assign a region to each branch manager. Let's add a dropdown field to the user edit page where you can select their assigned region:

// Add region selection to user profile
add_action('show_user_profile', 'add_region_field_to_profile');
add_action('edit_user_profile', 'add_region_field_to_profile');
function add_region_field_to_profile($user) {
    // Only show this to admins and branch managers (adjust as needed)
    if (current_user_can('manage_options') || in_array('branch_manager', $user->roles)) {
        $selected_region = get_user_meta($user->ID, 'assigned_region', true);
        ?>
        <h3>Branch Manager Region Assignment</h3>
        <table class="form-table">
            <tr>
                <th><label for="assigned_region">Assigned Region</label></th>
                <td>
                    <select name="assigned_region" id="assigned_region">
                        <option value="">-- Select Region --</option>
                        <option value="North" <?php selected($selected_region, 'North'); ?>>North Region</option>
                        <option value="South" <?php selected($selected_region, 'South'); ?>>South Region</option>
                        <option value="East" <?php selected($selected_region, 'East'); ?>>East Region</option>
                        <option value="West" <?php selected($selected_region, 'West'); ?>>West Region</option>
                        <!-- Add more regions as needed -->
                    </select>
                    <p class="description">Select the region this manager is responsible for.</p>
                </td>
            </tr>
        </table>
        <?php
    }
}

// Save region meta when user is updated
add_action('personal_options_update', 'save_region_field');
add_action('edit_user_profile_update', 'save_region_field');
function save_region_field($user_id) {
    if (!current_user_can('edit_user', $user_id)) return;
    if (isset($_POST['assigned_region'])) {
        update_user_meta($user_id, 'assigned_region', sanitize_text_field($_POST['assigned_region']));
    } else {
        delete_user_meta($user_id, 'assigned_region');
    }
}

You can customize the region options to match your actual branch locations (e.g., countries, states, or custom regions).

Now the core part: filtering orders so each branch manager only sees orders from their region. First, ensure your orders have a region associated with them—this could be based on the customer's shipping/billing country/state, or a custom order meta field if you have a region picker at checkout.

Assuming you're using the shipping country as the region, here's how to filter the order list:

// Filter orders for branch managers by their assigned region
add_action('pre_get_posts', 'restrict_branch_manager_orders');
function restrict_branch_manager_orders($query) {
    global $pagenow, $post_type;
    
    // Only apply this to the WooCommerce orders admin page
    if (is_admin() && $pagenow === 'edit.php' && $post_type === 'shop_order' && current_user_can('branch_manager')) {
        $user_id = get_current_user_id();
        $assigned_region = get_user_meta($user_id, 'assigned_region', true);
        
        if (!empty($assigned_region)) {
            // Adjust the meta key based on what you use to store region (e.g., _shipping_country, _shipping_state, or custom meta)
            $query->set('meta_query', array(
                array(
                    'key' => '_shipping_country', // Replace with your actual region meta key
                    'value' => $assigned_region,
                    'compare' => '='
                )
            ));
        }
    }
}

// Prevent branch managers from accessing orders outside their region directly
add_filter('map_meta_cap', 'block_branch_manager_access_to_other_regions', 10, 4);
function block_branch_manager_access_to_other_regions($caps, $cap, $user_id, $args) {
    if (($cap === 'edit_shop_order' || $cap === 'read_shop_order' || $cap === 'delete_shop_order') && current_user_can('branch_manager')) {
        $order_id = $args[0];
        $order = wc_get_order($order_id);
        $assigned_region = get_user_meta($user_id, 'assigned_region', true);
        
        // Get the order's region (match the meta key from above)
        $order_region = $order->get_meta('_shipping_country');
        
        if ($order_region !== $assigned_region) {
            $caps = array('do_not_allow');
        }
    }
    return $caps;
}

Important notes here:

• Replace _shipping_country with the actual meta key you use to store the order's region. If you have a custom region field at checkout, use that meta key instead.
• If your regions are states/provinces, use _shipping_state instead.

If you don't want to work with code, you can use WooCommerce-compatible permission management plugins. Look for tools that let you:

• Create custom user roles
• Assign meta fields (like regions) to users
• Filter order access based on user meta values
  Many popular WooCommerce extensions offer this functionality out of the box, so you won't have to write any code.

Once you set this up, create a test branch manager user, assign them a region, then place test orders from that region and a different one. Log in as the test manager and verify they can only see orders from their assigned region.

Hope this gets you sorted! If you need to adjust the code for your specific region setup (like custom order fields or different role permissions), feel free to tweak the snippets above.

内容的提问来源于stack exchange，提问作者Nishu Nath