Snippet di codice - Centro assistenza FooSales

Questo è un A livello di sviluppatore documento. Se non si ha dimestichezza con il codice/template e con la risoluzione di potenziali conflitti, si consiglia di rivolgersi a uno sviluppatore che abbia familiarità con l'FooSales e/o l'WooCommerce. Questi snippet sono forniti a titolo di cortesia e sono intesi come punto di partenza per assistere qualsiasi esigenza di personalizzazione specifica. Non siamo in grado di fornire supporto per le personalizzazioni effettuate nell'ambito del nostro Termini di servizio.

Acquisizione delle tariffe Square durante il completamento di un ordine #

Se si utilizza un plugin di esportazione di terze parti per esportare gli ordini e si elaborano i pagamenti con Square, si potrebbe voler includere le commissioni che Square detrae dal pagamento nell'esportazione delle vendite. Questo documento di aiuto conteneva in precedenza uno snippet di codice che catturava le commissioni di elaborazione di Square come meta-dati al completamento dell'ordine. Tuttavia, questo non supportava i pagamenti frazionati e poiché la struttura del plugin 1.40.0+ è stata completamente rivista, lo snippet di codice non funzionerà più. La funzionalità contenuta nello snippet di codice è stata aggiunta alla funzionalità principale del plugin, che supporta anche i pagamenti frazionati e i vari stati di invio degli ordini nella versione 1.40.2 del plugin.

Si prega di notare Se in precedenza si è aggiunto lo snippet di codice al file functions.php, è possibile deve essere rimosso per evitare errori critici durante l'invio degli ordini tramite FooSales.

Per saperne di più su come vengono percepite le tariffe Square, consultare il nostro sito Documento di aiuto sull'integrazione dei pagamenti Square.

Aggiungete la nota d'ordine dell'FooSales alle e-mail di amministrazione dell'WooCommerce. #

Aggiungete il seguente frammento di codice alla cartella del vostro tema functions.php se si desidera che la "Nota dell'ordine" aggiunta all'ordine nell'FooSales venga visualizzata nelle e-mail di amministrazione dell'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) {

	se ( isset($post-&gt;ID) )
		$id = $post-&gt;ID;
	altrimenti
		$id = $order-&gt;ID;


	se ($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>' . __( 'Note dell'ordine', '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>' . __( 'Non ci sono ancora note per questo ordine', 'woocommerce' ) . '</li>';
		}

		echo '</ul>';
	}
}

Inviare i dettagli dell'ordine da FooSales e l'e-mail di completamento dal sito web #

Aggiungete il seguente frammento di codice alla cartella del vostro tema functions.php se si desidera inviare automaticamente l'e-mail con i dettagli dell'ordine quando viene effettuato un ordine tramite FooSales e inviare l'e-mail di completamento quando viene effettuato un ordine tramite il front-end del sito 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 #

Aggiungete il seguente frammento di codice alla cartella del vostro tema functions.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 #

Aggiungete il seguente frammento di codice alla cartella del vostro tema functions.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>';
    }
}

Articoli

Aggiornamenti della meta dell'ordine FooSales

Argomenti