Fragmentos de código - FooSales Help Center

Se trata de un A nivel de desarrollador documento. Si no está familiarizado con el código/plantillas y la resolución de posibles conflictos, póngase en contacto con un desarrollador que esté familiarizado con FooSales y/o WooCommerce. Estos fragmentos se proporcionan como cortesía y están pensados como punto de partida para ayudar a cualquier necesidad específica de personalización. No podemos ofrecer soporte para personalizaciones bajo nuestra plataforma Condiciones de uso.

Capturar las tasas Square al completar un pedido #

Si está utilizando un plugin de exportación de terceros para exportar sus pedidos y está procesando pagos con Square, es posible que desee incluir las tasas que Square deduce del pago en su exportación de ventas. Este documento de ayuda contenía anteriormente un fragmento de código que capturaba las comisiones de procesamiento de Square como metadatos al finalizar el pedido. Sin embargo, este fragmento de código no era compatible con los pagos fraccionados y, dado que la estructura del plugin 1.40.0+ ha sido completamente revisada, el fragmento de código ya no funcionará. La funcionalidad contenida en el fragmento de código se ha añadido a la funcionalidad principal del complemento, que también admite pagos divididos y varios estados de envío de pedidos en la versión 1.40.2 del complemento.

Atención que si previamente ha añadido el fragmento de código a su archivo functions.php, usted debe quitarlo para evitar errores críticos al enviar pedidos a través de FooSales.

Puede obtener más información sobre cómo se recaudan las tasas Square en nuestro Square Documento de ayuda sobre la integración de pagos.

Añadir la nota de pedido de FooSales a los correos electrónicos de administración de WooCommerce #

Añada el siguiente fragmento de código al tema funciones.php si desea que la "Nota de pedido" que ha añadido al pedido en FooSales aparezca en los correos electrónicos de administración de WooCommerce.

add_action( 'woocommerce_email_order_meta', 'woo_add_order_notes_to_email', 10, 4 );

function woo_add_order_notes_to_email($order, $sent_to_admin, $plain_text, $email) {

	if ( isset($post-&gt;ID) )
		$id = $post-&gt;ID;
	si no
		$id = $order-&gt;ID;


	if ($sent_to_admin &amp;&amp; 'foosales_app' === get_post_meta($id, '_foosales_order_source', true)) {
		$args = array(
			'order_id' =&gt; $id,
			'type' =&gt; ''
		);
		
		$notes = wc_get_order_notes( $args );
		
		echo '<h2>' . __( 'Notas de pedido', 'woocommerce' ) . '</h2>';

		echo '<ul class="order_notes">';

		if ( $notes ) {
				?&gt;
				<li>
					<div class="note_content">
						content ) ) ); ?&gt;
					</div>
				</li>
				&lt;?php } else { echo &#039;<li>' . __( 'Aún no hay notas para este pedido.', 'woocommerce' ) . '</li>';
		}

		echo '</ul>';
	}
}

Enviar detalles del pedido desde FooSales, y correo electrónico completado desde el sitio web #

Añada el siguiente fragmento de código al tema funciones.php archivo si deseas enviar automáticamente el correo electrónico con los detalles del pedido cuando se realice un pedido a través de FooSales, y enviar el correo electrónico de confirmación cuando se realice un pedido a través de la interfaz de tu sitio web.

add_filter( 'woocommerce_email_enabled_customer_completed_order', 'is_foosales', 9999, 2 );

function is_foosales($enabled, $order ) {
	if ( ! empty( $order ) && 'foosales_app' === $order->get_meta( '_foosales_order_source', true ) ) {
		return false;
	}
	return $enabled;
}

add_action( 'woocommerce_order_status_completed', 'send_invoice_on_completed' );
function send_invoice_on_completed( $order_id ) {
	$wc_order = wc_get_order($order_id);
	if ( ! empty( $wc_order ) && 'foosales_app' === $wc_order->get_meta( '_foosales_order_source', true ) ) {
		$emails = WC()->mailer()->get_emails();
    	$emails['WC_Email_Customer_Invoice']->trigger( $order_id );
	}
    
}

Implement partial use for coupon codes #

Añada el siguiente fragmento de código al tema funciones.php file if you want to enable the partial use of coupon codes. This means that if the coupon code amount is more than the total price of the items being purchased, then the amount owed would be 0 and the total price will be deducted from the coupon code amount so that there is credit left to be used in the future.

// 1. Process coupon adjustments on active order completion/processing
add_action( 'woocommerce_order_status_processing', 'adjust_partially_used_coupon_amount', 10, 1 );
add_action( 'woocommerce_order_status_completed', 'adjust_partially_used_coupon_amount', 10, 1 );

function adjust_partially_used_coupon_amount( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return;
    }

    // Prevent code from running multiple times on the same order
    if ( $order->get_meta( '_coupon_amount_adjusted' ) ) {
        return;
    }

    $coupons = $order->get_coupons();
    
    foreach ( $coupons as $item ) {
        $code   = $item->get_code();
        $coupon = new WC_Coupon( $code );
        
        // Only target fixed cart discount coupons
        if ( $coupon->get_id() && $coupon->is_type( 'fixed_cart' ) ) {
            $coupon_original_amount = (float) $coupon->get_amount();
            $discount_used          = (float) $item->get_discount();

            if ( $coupon_original_amount > $discount_used ) {
                // PARTIAL USE: Reduce balance and restore 1 usage count so it stays active
                $remaining_balance = $coupon_original_amount - $discount_used;
                $coupon->set_amount( $remaining_balance );
                
                $usage_count = $coupon->get_usage_count();
                if ( $usage_count > 0 ) {
                    $coupon->set_usage_count( $usage_count - 1 );
                }
                
                $coupon->save();
            } elseif ( $coupon_original_amount > 0 && abs( $coupon_original_amount - $discount_used ) < 0.001 ) {
                // FINAL USE: Full remaining balance spent. Set balance to 0.
                // Leave usage_count alone so WooCommerce natural limits apply.
                $coupon->set_amount( 0 );
                $coupon->save();
            }
        }
    }

    // Mark order as processed so status changes don't re-trigger this logic
    $order->update_meta_data( '_coupon_amount_adjusted', 'yes' );
    $order->save();
}

// 2. Restore coupon balance if order is cancelled, refunded, or failed
add_action( 'woocommerce_order_status_cancelled', 'restore_partially_used_coupon_amount', 10, 1 );
add_action( 'woocommerce_order_status_refunded', 'restore_partially_used_coupon_amount', 10, 1 );
add_action( 'woocommerce_order_status_failed', 'restore_partially_used_coupon_amount', 10, 1 );

function restore_partially_used_coupon_amount( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return;
    }

    // Only attempt restoration if the coupon was previously deducted on this order
    if ( ! $order->get_meta( '_coupon_amount_adjusted' ) ) {
        return;
    }

    // Prevent double-restoration if status changes between cancelled/refunded
    if ( $order->get_meta( '_coupon_amount_restored' ) ) {
        return;
    }

    $coupons = $order->get_coupons();

    foreach ( $coupons as $item ) {
        $code   = $item->get_code();
        $coupon = new WC_Coupon( $code );

        if ( $coupon->get_id() && $coupon->is_type( 'fixed_cart' ) ) {
            $current_balance  = (float) $coupon->get_amount();
            $discount_applied = (float) $item->get_discount();

            if ( $discount_applied > 0 ) {
                $restored_balance = $current_balance + $discount_applied;
                $coupon->set_amount( $restored_balance );

                // If coupon was completely depleted (0) and is now restored, reduce usage count so it reactivates
                if ( $current_balance == 0 && $restored_balance > 0 ) {
                    $usage_count = $coupon->get_usage_count();
                    if ( $usage_count > 0 ) {
                        $coupon->set_usage_count( $usage_count - 1 );
                    }
                }

                $coupon->save();
            }
        }
    }

    // Mark order meta as restored
    $order->update_meta_data( '_coupon_amount_restored', 'yes' );
    $order->save();
}

Hide WooCommerce Point of Sale Settings #

Añada el siguiente fragmento de código al tema funciones.php file if you want to hide the Point of Sale settings added by WooCommerce as of version 11.

// Remove the built-in WooCommerce Point of Sale settings tab.
add_filter( 'woocommerce_settings_tabs_array', 'remove_wc_pos_settings_tab', 999, 1 );
function remove_wc_pos_settings_tab( $tabs ) {
    if ( isset( $tabs['point-of-sale'] ) ) {
        unset( $tabs['point-of-sale'] );
    }

    return $tabs;
}

// Remove the All Sales Channels filter on the Orders page.
add_action( 'admin_head', 'hide_sales_channel_order_filter' );
function hide_sales_channel_order_filter() {
    $screen = get_current_screen();
    // Target the WooCommerce orders listing screen
    if ( isset( $screen->id ) && ( $screen->id === 'woocommerce_page_wc-orders' || $screen->id === 'edit-shop_order' ) ) {
        echo '<style>
            select[name="_created_via"],
            #sales_channel { 
                display: none !important; 
            }
        </style>';
    }
}

Artículos

FooSales Orden Meta Actualizaciones

Temas