Guia Definitivo de Plugins para o WooCommerce com Explicações Detalhadas do Código: Desde a Instalação até o Desenvolvimento Personalizado

Instalação e Configuração Básica do WooCommerce

O processo de instalação do WooCommerce é simples, mas uma configuração inicial correta é a base para a construção de um site de comércio eletrônico estável. Primeiramente, você precisa de um ambiente de servidor que esteja executando o PHP 7.4 ou uma versão mais recente e que tenha o WordPress instalado. Através da página “Plugins” > “Instalar Plugins” no painel administrativo do WordPress, procure por “WooCommerce” e clique para instalar e ativar o plugin. Após a ativação, o sistema iniciará automaticamente um “Guia de Configuração” que o orientará no processo de definição das configurações básicas da sua loja.

No guia de configuração, você precisa realizar as seguintes etapas sequencialmente: definir a localização da loja, a moeda e as unidades de medida; configurar os métodos de pagamento (como PayPal, Stripe ou transferência bancária); definir as regras de cálculo dos custos de envio (como entrega gratuita, custo fixo ou tarifas em tempo real com base no peso ou no endereço); e é recomendável instalar extensões essenciais, como o WooCommerce Payments ou plugins de localização. Após concluir o guia, você será levado para o painel de configurações principais do WooCommerce. Existem algumas partes-chave que precisam ser configuradas com atenção: nas opções “Geral”, você pode definir os locais de venda e o cálculo dos impostos; nas opções “Produtos”, você pode definir as unidades de medida, as avaliações dos produtos e o gerenciamento de estoque; a página de “Pagamento” é onde você configura todos os gateways de pagamento e o processo de finalização de compra; as opções de “Entrega” são usadas para gerenciar as áreas de envio, os métodos de entrega e a embalagem dos produtos.

Um passo frequentemente negligenciado, mas de extrema importância, é a configuração dos links permanentes. No WordPress, vá em “Configurações” > “Links Permanentes” e certifique-se de não usar a estrutura “Pura”. É recomendado utilizar a estrutura “Nome do Artigo” ou uma estrutura personalizada, o que é benéfico para o SEO das páginas de produtos. Além disso, na página de configurações avançadas do WooCommerce, você precisa atribuir as páginas correspondentes do WordPress para várias funcionalidades do site (como carrinho de compras, finalização de compra, minha conta, etc.). Essas páginas são criadas automaticamente ao instalar o plugin.

Leitura recomendada Guia de Desenvolvimento Personalizado para o WooCommerce: Um Tutorial Prático Completo, do Início ao Avançado。

Configurações de informações básicas da loja

As configurações básicas da loja são principalmente realizadas no Personalizador do WordPress e nas configurações padrão do WooCommerce. Você precisa garantir que o endereço da loja, o e-mail do atendimento ao cliente e os números de telefone estejam corretos, pois essas informações serão exibidas em notificações de pedidos, faturas e no rodapé da página. Além disso, na seção “Opções de Moeda” das configurações padrão, é possível definir o formato da moeda, como Renminbi (¥123,00) ou Dólar ($123,00).

Hospedagem para sites WordPress da UltraHost

Garantia de reembolso em 30 dias, largura de banda ilimitada e banco de dados, proteção contra DDoS gratuita; desconto de 50% na compra de 3 anos (planos de 4 TB a 10 TB).

página de acesso

Integração de gateways de pagamento e entrega

O gateway de pagamento é a vida dos negócios online. O WooCommerce vem com várias opções de pagamento integradas, como… WC_Gateway_BACS(Transferência bancária)WC_Gateway_CHEQUE(Pagamento por cheque) e WC_Gateway_COD(Pagamento ao receber a mercadoria). Para ativar gateways avançados como o Stripe ou o PayPal, geralmente é necessário instalar plugins independentes e configurar as chaves de API. Por exemplo, ao configurar o Stripe, você precisa inserir a chave pública e a chave privada disponibilizadas na página de configurações correspondente.

As configurações de entrega também são cruciais. Você pode criar regras de custo de envio separadas para diferentes países ou regiões na seção “Áreas de Entrega”. Por exemplo, você pode criar uma área para a China Continental e adicionar opções como “Entrega Gratuita”, “Tarifa Fixa” e “Retirada Local”. Ao utilizar essas configurações, você consegue personalizar as condições de entrega de acordo com as necessidades dos seus clientes em cada região. woocommerce_shipping_init Os desenvolvedores também podem criar classes de métodos de entrega totalmente personalizadas.

Funções principais e gestão de dados

O WooCommerce integra todos os dados de comércio eletrônico nos tipos de artigo e na estrutura de categorias personalizados do WordPress. Os produtos são armazenados como… product Os tipos de artigos correspondem aos tipos de produtos, enquanto os pedidos (ordens) representam as solicitações de compra feitas pelos clientes. shop_order Tipo de artigo. Compreender esse modelo de dados é um pré-requisito para realizar desenvolvimentos personalizados avançados.

A gestão de produtos é o elemento central de qualquer sistema de vendas online. O WooCommerce suporta quatro tipos de produtos:simple(Produtos simples)grouped(Produtos agrupados)external(Produtos externos/associados) e variable(Produtos Variáveis). Os produtos variáveis permitem que você defina diferentes atributos (como cor, tamanho) para o mesmo produto, bem como os respectivos preços, estoques e códigos de produto (SKU – Stock Keeping Unit). Ao editar um produto no backend, você utilizará uma série de caixas de metadados para gerenciar o SKU do estoque, os preços, o status do estoque, as informações de entrega e a galeria de imagens associada ao produto.

Leitura recomendada O que é o WooCommerce e sua arquitetura principal。

O backend de gerenciamento de pedidos fornece uma visão geral completa das vendas. Cada pedido contém uma grande quantidade de metadados. shop_order O post registra informações do cliente, produtos adquiridos, preços, status de pagamento e o histórico de observações do pedido. A gestão do status é de extrema importância; os status padrão incluem… pending(Aguardando pagamento)processing(Em processo)on-hold(Pausa) E completed(Concluído). Você pode usar. wc_get_order_statuses A função obtém todos os estados e, em seguida, os processa através de… woocommerce_register_shop_order_post_statuses Registro de status personalizado para os filtros.

Gerenciamento de Tipos e Atributos de Produtos

As propriedades dos produtos são uma ferramenta essencial para organizar catálogos de produtos complexos. Você pode criar propriedades globais, como “cor” ou “tamanho”, em “Produtos” > “Propriedades”. Em seguida, ao editar produtos variáveis, utilize essas propriedades para criar “combinações de propriedades” e defina dados de variantes independentes para cada combinação (por exemplo, “vermelho-grande”). No nível do código, isso pode ser realizado através de… WC_Product_Variable Classes e seus… get_available_variations() Métodos para obter e operar todas as informações sobre as variantes.

Tratamento de dados de pedidos e clientes

O WooCommerce usa WC_Order Uma classe é utilizada para encapsular os dados do pedido. Com essa classe, é possível criar ou atualizar pedidos de forma programática. Por exemplo, o código a seguir mostra como criar um novo pedido e adicionar produtos a ele:

hospedagem compartilhada da hosting.com

Alto desempenho com CPUs AMD EPYC, armazenamento SSD NVMe e LiteSpeed, suporte interno especializado 24 horas por dia, 7 dias por semana, medidas de segurança avançadas, incluindo SSL, força bruta, malware e proteção contra DDoS, economia de até 73%

página de acesso

// 创建一个新订单对象
$order = wc_create_order();

// 通过商品ID获取商品对象并添加到订单中
$product = wc_get_product(123);
$order->add_product($product, 2); // 数量为2

// 设置客户地址
$order->set_address(array(
    'first_name' => '张',
    'last_name'  => '三',
    'email'      => '[email protected]',
    'phone'      => '13800138000',
), 'billing');

// 计算总额并保存
$order->calculate_totals();
$order->save();

Os dados dos clientes estão relacionados aos usuários do WordPress.WP_User）Vinculação profunda. O WooCommerce utiliza… wc_get_customer_order_count e wc_get_customer_total_spent Funções como essas expandem as capacidades dos usuários.

Integração de temas e sobreposição de modelos

A integração do WooCommerce com o tema determina a experiência do usuário no front-end da loja. O sistema utiliza um poderoso sistema de templates, e todos os arquivos de exibição no front-end (como listas de produtos, páginas de produtos individuais, carrinhos de compras) estão localizados no diretório de plugins. /templates/ Estes modelos estão localizados em uma pasta. Para personalizá-los sem alterar os arquivos principais dos plugins, você precisa substituí-los pelo seu próprio conteúdo no tema (theme) que está utilizando.

O método correto é: no diretório de temas da sua atividade, criar um arquivo com o nome… woocommerce O arquivo do modelo do WooCommerce que você deseja modificar deve ser copiado do diretório dos plugins para esta nova pasta, e então as alterações devem ser feitas nessa cópia. Por exemplo, se você quiser modificar a estrutura de uma única página de produto, você precisará copiar o arquivo correspondente e fazer as alterações nele. plugins/woocommerce/templates/single-product.php Chegar themes/your-theme/woocommerce/single-product.phpO WooCommerce carrega prioritariamente os arquivos de template contidos no tema escolhido.

Leitura recomendada Guia Definitivo para Construir um Site com o WooCommerce: Crie o seu Império de Comércio Eletrônico do Zero。

Além de cobrir todo o arquivo, você também pode usar Ganchos de Ação (Action Hooks) e Ganchos de Filtro (Filter Hooks) para inserir ou modificar conteúdo em posições específicas. Por exemplo,woocommerce_before_single_product_summary O gancho é acionado antes das informações resumidas do produto, sendo a posição ideal para adicionar anúncios em faixa personalizados.

Estrutura do arquivo de modelo personalizado

Os arquivos de template do WooCommerce possuem uma estrutura hierárquica clara. Por exemplo, no caso do ciclo de produtos (product loop),archive-product.php É um modelo para a página principal de uma loja; ele irá ser chamado (ou executado) automaticamente. content-product.php Para renderizar cada produto, basta substituir esses arquivos. Dessa forma, você pode alterar completamente a forma como os produtos são exibidos na lista: por exemplo, mudar o layout para uma grade ou uma lista, ou adicionar emblemas personalizados.

Hospedagem Compartilhada InterServer

Hospedagem compartilhada $2.50 USD por mês, primeiro mês $0.1 USD código promocional tryinterserver, 461 scripts de aplicativos em nuvem, instalação com um clique.

página de acesso

Utilizar ganchos (hooks) para a expansão de funcionalidades

Os “ganchos” (hooks) são a espinha dorsal das extensões para o WooCommerce. Os ganchos de ação (action hooks) permitem que você execute códigos, por exemplo, para adicionar uma caixa de informações personalizada após a tabela do carrinho de compras:

add_action('woocommerce_after_cart_table', 'my_custom_cart_message');
function my_custom_cart_message() {
    echo '<div class="custom-notice">Compras acima de 500 reais, frete grátis!</div>';
}

Os ganchos (hooks) dos filtros permitem que você “modifique” os dados. Por exemplo, ao usá-los… woocommerce_add_to_cart_fragments Os filtros podem atualizar dinamicamente o conteúdo do carrinho de compras em miniatura:

add_filter('woocommerce_add_to_cart_fragments', 'update_mini_cart_count');
function update_mini_cart_count($fragments) {
    $fragments['div.cart-count'] = '<div class="cart-count">' . WC()-&gt;cart-&gt;get_cart_contents_count() . '</div>';
    return $fragments;
}

Práticas avançadas de personalização e desenvolvimento

Quando as funções integradas e os mecanismos disponíveis não são suficientes para atender às necessidades, é necessário realizar um desenvolvimento personalizado mais aprofundado. Isso inclui a criação de tipos de produtos personalizados, a programação de gateways de pagamento ou entrega exclusivos, bem como a integração com sistemas externos através de APIs REST.

Criar tipos de produtos personalizados requer a realização de extensões. WC_Product Primeiro, você precisa definir uma nova classe que herde características de uma classe existente e, em seguida, registrar esse novo tipo de produto. Por exemplo, crie uma classe de produto chamada “Reserva”:

class WC_Product_Booking extends WC_Product {
    public function __construct($product) {
        parent::__construct($product);
        $this->product_type = 'booking';
    }
    // 在这里添加自定义方法和属性，如 get_booking_dates()
}
// 将新类注册到工厂
add_filter('woocommerce_product_class', 'register_booking_product_class', 10, 2);
function register_booking_product_class($classname, $product_type) {
    if ($product_type == 'booking') {
        $classname = 'WC_Product_Booking';
    }
    return $classname;
}

O WooCommerce REST API oferece uma interface poderosa para aplicativos móveis ou sistemas de gestão externos. Você pode usar o API para gerenciar produtos, pedidos, clientes e quase todos os outros tipos de dados. Para acessar o API, é necessário ativar a funcionalidade e criar uma chave de API (Consumer Key & Consumer Secret) em “WooCommerce” > “Configurações” > “Avançado” > “APIs Antigas” no lado do servidor. Em seguida, você pode fazer chamadas usando endpoints semelhantes aos seguintes:GET /wp-json/wc/v3/products Venha obter a lista de produtos.

Desenvolver um gateway personalizado

Um gateway de pagamento personalizado é uma extensão de… WC_Payment_Gateway Você precisa criar uma classe em PHP para um gateway. Nessa classe, você deve definir o ID do gateway, o título, a descrição, os campos de pagamento e implementar as funcionalidades necessárias. process_payment Métodos para implementar a lógica de pagamento. Após a conclusão do desenvolvimento, é necessário… woocommerce_payment_gateways O filtro adiciona-o à lista de gateways disponíveis.

Integração de API com serviços externos

O WooCommerce oferece uma grande variedade de “ganchos” (hooks) para integração com sistemas ERP, CRM ou de logística. Por exemplo, quando o status de um pedido é alterado para “Concluído”, um evento é acionado automaticamente. woocommerce_order_status_completed Gancho de ação. Você pode conectar uma função a este gancho para enviar os dados do pedido para o seu sistema de gestão de estoque:

add_action('woocommerce_order_status_completed', 'sync_order_to_erp');
function sync_order_to_erp($order_id) {
    $order = wc_get_order($order_id);
    $data = array(
        'order_id' => $order->get_id(),
        'total'    => $order->get_total(),
        // ... 准备其他数据
    );
    // 使用 wp_remote_post 将 $data 发送到外部 API
}

resumos

O WooCommerce não é apenas um plugin, mas também um framework de desenvolvimento de comércio eletrônico completo e altamente extensível. Desde a instalação e configuração simples até o desenvolvimento personalizado avançado, ele oferece infinitas possibilidades aos desenvolvedores através de um sistema de templates claro, uma ampla gama de ganchos (Actions & Filters) e um modelo de dados orientado a objetos. A chave para construir com sucesso uma loja no WooCommerce é: uma configuração de base sólida que garanta o funcionamento estável da loja; um entendimento profundo de seus modelos de dados de produtos e pedidos; o uso hábil de templates e ganchos para personalizações no front-end; e a capacidade de integrar recursos personalizados, gateways e APIs para atender às necessidades específicas do negócio. Seguindo essas melhores práticas, você será capaz de criar uma loja online poderosa, eficiente e que corresponda plenamente à lógica do seu negócio.

Perguntas frequentes Perguntas frequentes

Como modificar a descrição do botão “Adicionar ao carrinho”?

Você pode usar o woocommerce_product_add_to_cart_text Filtro ou woocommerce_product_single_add_to_cart_text Use filtros para modificar o texto dos botões. Por exemplo, o código a seguir altera o texto dos botões na página de um produto para “Comprar agora”:

add_filter('woocommerce_product_single_add_to_cart_text', 'change_single_add_to_cart_text');
function change_single_add_to_cart_text() {
    return '立即购买';
}

Para a página de arquivos (lista de produtos), por favor use… woocommerce_product_add_to_cart_text É necessário um filtro, e dentro da função, deve-se determinar o tipo do produto.

Como adicionar campos personalizados para uma categoria específica de produtos?

Você precisa usar em conjunto os ganchos de categorização de produtos do WooCommerce e a API de metadados de termos do WordPress. Primeiro, utilize… product_cat_add_form_fields e product_cat_edit_form_fields As ações são exibidas nos campos da página de adição/edição da categoria. Em seguida, elas são utilizadas… created_term e edit_term Ação para salvar o valor do campo… term_metaPor fim, você pode usar isso no arquivo de template. get_term_meta Obtenha e exiba esse valor.

Por que as alterações que fiz no meu modelo personalizado não entraram em vigor?

Por favor, siga os passos abaixo para realizar a verificação: Primeiramente, confira se você copiou o arquivo de template para o caminho correto do tema.your-theme/woocommerce/ A estrutura do diretório deve ser a mesma que a do modelo do plugin original. Em seguida, limpe todos os caches, incluindo os caches do navegador, os caches de objetos do WordPress e quaisquer caches do lado do servidor (como o OPcache). Por fim, verifique o seu tema. functions.php A declaração de suporte ao WooCommerce foi feita corretamente?add_theme_support('woocommerce');Se o problema persistir, tente alternar temporariamente para o tema padrão (como o Storefront) para eliminar possíveis problemas de compatibilidade entre os temas.

Como criar um produto variável no WooCommerce de forma programática?

Você precisa usar… WC_Product_Variable Classe. Os passos básicos são: criar um objeto de produto e definir suas propriedades fundamentais; criar e adicionar propriedades globais (como cores); criar combinações específicas para essas propriedades (ou seja, variantes); e, finalmente, criar objetos independentes para cada uma dessas variantes. WC_Product_Variation Objeto: Defina seus atributos exclusivos, como preço e estoque, e associe-o ao produto principal. Este é um processo de várias etapas que geralmente envolve… wp_set_object_terms, set_attributes, e save métodos, entre outros.