claude-plugins/wordpress/skills/woocommerce/SKILL.md

name, description, author, version, user_invocable, tags, desk_task, allowed-tools, category, quality_score, updated

name	description	author	version	user_invocable	tags	desk_task	allowed-tools	category	quality_score	updated
woocommerce	WooCommerce store development and optimization. Customizes checkout, integrates Portuguese payment gateways (Multibanco, MB Way, IfthenPay), develops custom features and optimizes performance. Use when developing WooCommerce stores, customizing checkout, integrating payments, optimizing ecommerce performance, or when user mentions "woocommerce", "checkout", "payment gateway", "multibanco", "mb way", "ifthen pay", "ecommerce", "online store", "shop optimization".	Descomplicar® Crescimento Digital	1.1.0	true	wordpress woocommerce ecommerce checkout payments multibanco	1479	Read, Write, Edit, Bash, mcp__ssh-unified__ssh_execute, mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments	dev	75	2026-02-04T18:00:00Z

/woocommerce - WooCommerce Development

Desenvolvimento e optimização de lojas WooCommerce.

Quando Usar

• Configurar loja WooCommerce
• Personalizar checkout
• Integrar gateways de pagamento PT
• Desenvolver funcionalidades custom
• Optimizar performance

Hooks WooCommerce Essenciais

Actions

// Before/after cart
add_action('woocommerce_before_cart', 'show_cart_notice');
add_action('woocommerce_after_cart', 'show_shipping_info');

// Checkout
add_action('woocommerce_before_checkout_form', 'show_checkout_notice');
add_action('woocommerce_checkout_order_processed', 'after_order', 10, 3);

// Product
add_action('woocommerce_before_single_product', 'show_product_notice');
add_action('woocommerce_after_add_to_cart_button', 'add_custom_button');

// Admin
add_action('woocommerce_admin_order_data_after_billing_address', 'show_admin_meta');
add_action('woocommerce_process_product_meta', 'save_product_meta');

Filters

// Modificar preço
add_filter('woocommerce_cart_item_price', 'custom_price', 10, 2);
add_filter('woocommerce_get_price_html', 'custom_price_html', 10, 2);

// Checkout fields
add_filter('woocommerce_checkout_fields', 'custom_checkout_fields');
add_filter('woocommerce_billing_fields', 'custom_billing_fields');

// Cart
add_filter('woocommerce_add_cart_item_data', 'add_cart_item_data', 10, 2);
add_filter('woocommerce_cart_item_name', 'custom_cart_item_name', 10, 3);

// Emails
add_filter('woocommerce_email_subject_new_order', 'custom_email_subject', 10, 2);

Gateways Portugal

Gateway	Plugin	Notas
MB Way	IfthenPay / Eupago	Pagamento instantâneo
Multibanco	IfthenPay / Eupago	Referências MB
Stripe	Stripe for WooCommerce	Cartões + Apple/Google Pay
PayPal	WooCommerce PayPal	Standard e Express

Configuração IfthenPay

// Webhook para confirmação automática
add_action('woocommerce_api_ifthenpay_webhook', 'handle_ifthenpay_callback');

function handle_ifthenpay_callback() {
    $order_id = $_GET['order_id'] ?? null;
    $status = $_GET['status'] ?? null;

    if ($status === 'success') {
        $order = wc_get_order($order_id);
        $order->payment_complete();
    }
}

Customização Checkout

// Adicionar campo NIF
add_filter('woocommerce_checkout_fields', function($fields) {
    $fields['billing']['billing_nif'] = [
        'label' => 'NIF',
        'required' => true,
        'class' => ['form-row-wide'],
        'validate' => ['validate_nif']
    ];
    return $fields;
});

// Validar NIF
add_action('woocommerce_checkout_process', function() {
    if (empty($_POST['billing_nif'])) {
        wc_add_notice('NIF é obrigatório', 'error');
    }
});

// Guardar NIF
add_action('woocommerce_checkout_update_order_meta', function($order_id) {
    if (!empty($_POST['billing_nif'])) {
        update_post_meta($order_id, '_billing_nif', sanitize_text_field($_POST['billing_nif']));
    }
});

REST API

// Endpoint custom
add_action('rest_api_init', function() {
    register_rest_route('wc/v3', '/products/featured', [
        'methods' => 'GET',
        'callback' => function() {
            $args = [
                'status' => 'publish',
                'featured' => true,
                'limit' => 10
            ];
            $products = wc_get_products($args);
            return rest_ensure_response($products);
        }
    ]);
});

WP-CLI WooCommerce

# Listar produtos
wp wc product list --user=1 --format=table

# Criar produto
wp wc product create --name="Produto Teste" --regular_price=99.99 --user=1

# Listar pedidos
wp wc order list --status=processing --user=1

# Actualizar stock
wp wc product update 123 --stock_quantity=50 --user=1

# Limpar transients
wp transient delete --all

Integrações

Moloni (Facturação)

// Auto-criar factura após pedido pago
add_action('woocommerce_order_status_completed', 'create_moloni_invoice');

function create_moloni_invoice($order_id) {
    $order = wc_get_order($order_id);
    // Chamar API Moloni via MCP
    // mcp__moloni__create_invoice(...)
}

CTT Tracking

// Adicionar tracking number
add_action('woocommerce_order_status_processing', 'add_tracking_number');

function add_tracking_number($order_id) {
    $tracking = generate_ctt_tracking($order_id);
    update_post_meta($order_id, '_tracking_number', $tracking);
}

Performance WooCommerce

// Desactivar scripts desnecessários
add_action('wp_enqueue_scripts', function() {
    // Desactivar em páginas que não são WooCommerce
    if (!is_woocommerce() && !is_cart() && !is_checkout()) {
        wp_dequeue_style('woocommerce-general');
        wp_dequeue_style('woocommerce-layout');
        wp_dequeue_style('woocommerce-smallscreen');
        wp_dequeue_script('wc-cart-fragments');
    }
}, 100);

// Optimizar queries
add_filter('woocommerce_product_query', function($q) {
    $q->set('no_found_rows', true); // Se não precisar paginação
});

Checklist Nova Loja

[ ] WordPress + WooCommerce instalados
[ ] Tema compatível configurado
[ ] Páginas: Shop, Cart, Checkout, My Account, Terms
[ ] Gateways de pagamento activos e testados
[ ] Shipping zones Portugal configuradas
[ ] Taxas IVA: 23% (Continental), 13% (Madeira), 6% (Açores)
[ ] Emails transaccionais personalizados
[ ] SSL instalado e forçado
[ ] RGPD: Política Privacidade, Cookies
[ ] Teste de compra completo (real + teste)

Datasets Dify

Dataset	ID	Prioridade
Wordpress	9da0b2b9-5051-4b99-b9f6-20bf35067092	1
WooCommerce	(disponível)	1
E-commerce	(disponível)	2

Como Consultar

# PRIMARIO: NotebookLM (Gemini 2.5 RAG)
# mcp__notebooklm__notebook_query({notebook_id: "5be0d1a6-00f2-4cd9-b835-978cb7721601", query: "<tema>"})  // WordPress e Elementor
# FALLBACK: Dify KB (se NotebookLM insuficiente)

// Hooks e customizações WooCommerce
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "9da0b2b9-5051-4b99-b9f6-20bf35067092",
  query: "woocommerce hooks checkout cart filters"
})

---

Versão: 1.0.0 | Autor: Descomplicar®