9 Códigos úteis para o functions.php do seu site WordPress

Se você gerencia um site em WordPress, sabe o quanto o arquivo functions.php pode ser um grande aliado na personalização e otimização de funcionalidades. Reunimos aqui uma seleção de trechos de código extremamente úteis — desde esconder avisos administrativos até melhorar a experiência de compra no WooCommerce.

✅ 1. Remover o seletor de idioma da tela de login

add_filter('login_display_language_dropdown', '__return_false');

Essa função remove o seletor de idiomas na tela de login, deixando a interface mais limpa, principalmente em sites que usam apenas um idioma.

🔕 2. Ocultar notificações de atualizações (core, plugins e temas)

function remove_core_updates(){
    global $wp_version;
    return (object) array('last_checked'=> time(), 'version_checked'=> $wp_version);
}
add_filter('pre_site_transient_update_core','remove_core_updates');
add_filter('pre_site_transient_update_plugins','remove_core_updates');
add_filter('pre_site_transient_update_themes','remove_core_updates');

Ideal para ambientes onde atualizações são gerenciadas manualmente ou em sites de clientes que não devem ver alertas de atualização.

🚫 3. Ocultar notificações administrativas no painel

function pr_disable_admin_notices() {
    global $wp_filter;
    if ( is_user_admin() ) {
        if ( isset( $wp_filter['user_admin_notices'] ) ) {
            unset( $wp_filter['user_admin_notices'] );
        }
    } elseif ( isset( $wp_filter['admin_notices'] ) ) {
        unset( $wp_filter['admin_notices'] );
    }
    if ( isset( $wp_filter['all_admin_notices'] ) ) {
        unset( $wp_filter['all_admin_notices'] );
    }
}
add_action( 'admin_print_scripts', 'pr_disable_admin_notices' );

Essa função esconde alertas que aparecem no painel administrativo — útil para evitar distrações em ambientes de produção.

🛒 4. Alterar textos do WooCommerce

function change_woocommerce_strings( $translated_text, $text, $domain ) {
    if ( $domain === 'woocommerce' ) {
        switch ( $translated_text ) {
            case 'Continuar para a finalização de compra':
                $translated_text = 'Finalizar compra';
                break;
        }
    }
    return $translated_text;
}
add_filter( 'gettext', 'change_woocommerce_strings', 20, 3 );

Personalize mensagens padrão do WooCommerce para melhor se adequar ao seu público.

📦 5. Mover descrição da categoria no WooCommerce

remove_action( 'woocommerce_archive_description', 'woocommerce_taxonomy_archive_description', 10 ); 
add_action( 'woocommerce_after_shop_loop', 'woocommerce_taxonomy_archive_description', 100 );

Ideal para exibir a descrição da categoria após os produtos, ao invés de antes.

🧹 6. Adicionar botão “Limpar Carrinho”

function custom_woocommerce_clear_cart_button() {
    echo '<a href="' . esc_url( add_query_arg( 'clear-cart', 'yes', wc_get_cart_url() ) ) . '" class="button">Limpar Carrinho</a>';
}
add_action( 'woocommerce_cart_actions', 'custom_woocommerce_clear_cart_button', 10 );

add_action( 'wp_loaded', 'custom_woocommerce_clear_cart_action', 20 );
function custom_woocommerce_clear_cart_action() {
    if ( isset( $_GET['clear-cart'] ) && 'yes' === sanitize_text_field( wp_unslash( $_GET['clear-cart'] ) ) ) {
        if ( WC()->cart->is_empty() ) {
            wc_add_notice( 'O carrinho já está vazio.', 'error' );
        } else {
            WC()->cart->empty_cart();
            wc_add_notice( 'O carrinho foi limpo com sucesso.', 'success' );
        }
        wp_safe_redirect( wc_get_cart_url() );
        exit;
    }
}

Essa funcionalidade permite ao cliente limpar o carrinho com um clique — simples e direto.

💳 7. Adicionar botão “Efetuar Pagamento” no histórico de pedidos

function add_change_payment_button($order_id) {
    $order = wc_get_order($order_id);
    if ($order && 'pending' === $order->get_status() && !is_wc_endpoint_url('order-received')) {
        echo '<a href="' . esc_url(add_query_arg('change_payment', 'true', $order->get_checkout_payment_url())) . '" class="button">Efetuar Pagamento</a>';
    }
}
add_action('woocommerce_view_order', 'add_change_payment_button');

Facilite o pagamento de pedidos pendentes com esse botão adicional.

🆘 8. Adicionar botão “Preciso de Ajuda” no pedido

function add_help_button($order_id) {
    $order = wc_get_order($order_id);
    if ($order && 'completed' === $order->get_status()) {
        $email_link = 'mailto:[email protected]?subject=' . rawurlencode('Preciso de ajuda com o pedido ' . $order_id) .
                      '&body=' . rawurlencode("Olá, meu pedido é o número $order_id, preciso de ajuda por este motivo:\n\nDescreva o seu problema abaixo desta linha............");

        echo '<a href="' . esc_url($email_link) . '" class="button">Preciso de Ajuda</a>';
    }
}
add_action('woocommerce_view_order', 'add_help_button');

Oferece suporte rápido ao cliente diretamente da página do pedido finalizado.

🛍️ 9. Alterar o texto do botão “Buy Now” via JavaScript

add_action('wp_footer', 'customize_buy_now_button_text');
function customize_buy_now_button_text() {
    ?>
    <script type="text/javascript">
        jQuery(document).ready(function($) {
            $('.ux-buy-now-button').text('Checkout');
        });
    </script>
    <?php
}

Modifica dinamicamente o texto do botão “Buy Now” para “Checkout”, ideal para temas com botões customizados.

Sempre que for editar o functions.php, tenha um backup ou utilize um plugin como Code Snippets para adicionar os trechos com mais segurança.

O arquivo functions.php é uma poderosa ferramenta de personalização para quem usa WordPress. Com os códigos úteis apresentados neste post, você pode otimizar funções, melhorar a experiência do usuário e facilitar a gestão do seu site. Seja para ocultar avisos, ajustar textos ou personalizar o WooCommerce, cada snippet pode fazer a diferença. Lembre-se sempre de testar as alterações com cuidado e manter um backup. Continue explorando o potencial do functions.php com mais códigos úteis em nosso blog!

Se quiser mais dicas como essa, continue acompanhando nosso blog! 🚀