Filtro wcsp_package_name

O filtro wcsp_package_name controla o título exibido pra cada pacote de vendedor no checkout. Por padrão, esse título é o nome da loja do vendedor (ex: "Loja do João"). Use o filtro pra customizar — adicionar prefixo, mudar o formato, traduzir.

Assinatura

apply_filters( 'wcsp_package_name', $name, $vendor_id, $package, $index );

Retorno: string — título a exibir.

Quando o filtro é chamado

Em todo render do checkout, pra cada pacote de vendedor. O resultado vai pro hook nativo woocommerce_shipping_package_name do WooCommerce, então fica integrado ao layout padrão do tema.

Exemplo 1 — adicionar prefixo "Envio de"

Em vez de "Loja do João" no checkout, mostrar "Envio de Loja do João":

add_filter( 'wcsp_package_name', function( $name ) {
    return 'Envio de ' . $name;
} );

Exemplo 2 — incluir cidade do vendedor

Mostrar "Loja do João — São Paulo/SP" pra dar contexto pro cliente:

add_filter( 'wcsp_package_name', function( $name, $vendor_id, $package ) {
    $cep = $package['wcsp_vendor_postcode'] ?? '';
    if ( empty( $cep ) ) {
        return $name;
    }

    // Buscar cidade pelo CEP (use sua função favorita; aqui é ilustrativo)
    $cidade = minha_funcao_de_cep_para_cidade( $cep );
    return sprintf( '%s — %s', $name, $cidade );
}, 10, 3 );

Exemplo 3 — numerar os pacotes

Útil quando você tem muitos vendedores e quer destacar a separação:

add_filter( 'wcsp_package_name', function( $name, $vendor_id, $package, $index ) {
    return sprintf( '#%d — %s', $index + 1, $name );
}, 10, 4 );

Exemplo 4 — adicionar emoji/ícone

add_filter( 'wcsp_package_name', function( $name ) {
    return '📦 ' . $name;
} );

Onde o filtro é aplicado no código

/includes/class-split-shipping.php

Filtros relacionados

• wcsp_vendor_postcode — customizar o CEP de origem.
• woocommerce_shipping_package_name — filtro nativo do WooCommerce que recebe o resultado deste.