Referência dos hooks usados para ajustar frete, assets e apresentação do checkout.
Endereço e frete
wc_smart_checkout_should_use_friendly_delivery_date
Controla onde a data de entrega amigável substitui a saída original do plugin de frete. Por padrão, isso acontece somente no checkout quando a configuração está ativa.
add_filter( 'wc_smart_checkout_should_use_friendly_delivery_date', function( $should_use, $enabled, $is_checkout ) {
// Aplicar também no carrinho, somente quando a configuração estiver ativa.
return $enabled && ( $is_checkout || is_cart() );
}, 10, 3 );
| Parâmetro | Tipo | Descrição |
|---|---|---|
$should_use |
bool | Decisão padrão para o contexto atual |
$enabled |
bool | Estado da configuração “Data de entrega amigável” |
$is_checkout |
bool | Resultado de is_checkout(), incluindo o AJAX do checkout |
A normalização da meta de prazo continua disponível em outros contextos sem alterar o label.
wc_smart_checkout_restrict_address_fields_length
Controla a restrição de tamanho dos campos número e complemento.
add_filter( 'wc_smart_checkout_restrict_address_fields_length', '__return_false' );
wc_smart_checkout_economic_express_selected_rates
Altera as taxas escolhidas para representar as opções econômica e expressa.
add_filter( 'wc_smart_checkout_economic_express_selected_rates', function( $rates, $package ) {
return $rates;
}, 10, 2 );
Conteúdo e assets
wc_smart_checkout_after_header
Insere conteúdo depois do cabeçalho.
add_action( 'wc_smart_checkout_after_header', function() {
echo '<div class="checkout-message">Frete grátis acima de R$ 200</div>';
} );
wc_smart_checkout_head
Insere conteúdo no <head> do checkout.
add_action( 'wc_smart_checkout_head', function() {
echo '<meta name="robots" content="noindex">';
} );
wc_smart_checkout_custom_style_url
Carrega um CSS adicional no checkout.
add_filter( 'wc_smart_checkout_custom_style_url', function() {
return 'https://example.com/checkout.css';
} );
wc_smart_checkout_custom_script_url
Carrega um JavaScript adicional no checkout.
add_filter( 'wc_smart_checkout_custom_script_url', function() {
return 'https://example.com/checkout.js';
} );
wc_smart_checkout_main_style_url
Substitui o arquivo de estilos principal do checkout.
add_filter( 'wc_smart_checkout_main_style_url', function( $url ) {
return $url;
} );
wc_smart_checkout_load_font
Desativa a fonte carregada pelo plugin para usar a fonte do tema.
add_filter( 'wc_smart_checkout_load_font', '__return_false' );
wc_smart_checkout_order_items_thumbnail
Altera a imagem de um item no resumo do pedido.
add_filter( 'wc_smart_checkout_order_items_thumbnail', function( $image, $cart_item, $cart_item_key ) {
return $image;
}, 100, 3 );
Extensões do Customizer
As seções do Customizer expõem pares de filtros terminados em _fields e _sections:
wc_smart_checkout_customize_general_fieldse_sections;wc_smart_checkout_customize_advanced_fieldse_sections;wc_smart_checkout_customize_login_fieldse_sections;wc_smart_checkout_customize_testimonials_fieldse_sections;wc_smart_checkout_customize_urgency_fieldse_sections;wc_smart_checkout_customize_buttons_fieldse_sections;wc_smart_checkout_customize_footer_fieldse_sections;wc_smart_checkout_customize_header_fieldse_sections;wc_smart_checkout_customize_columns_fieldse_sections;wc_smart_checkout_customize_order_bump_fieldse_sections;wc_smart_checkout_customize_widgets_fieldse_sections;wc_smart_checkout_customize_texts_fieldse_sections.
Exemplo:
add_filter( 'wc_smart_checkout_customize_general_fields', function( $fields ) {
$fields['minha_opcao'] = array(
'type' => 'text',
'label' => 'Minha opção',
'section' => 'smart_checkout_general',
);
return $fields;
} );
Veja também Snippets úteis para receitas de CSS, JavaScript e sobrescrita de templates.