Aggiungere personalizzazioni a POP con il plugin Code Snippets

Obiettivo

Aggiungere una piccola personalizzazione (es. modificare un filtro POP) senza toccare functions.php del tema e senza creare un plugin dedicato.

Prerequisiti

• Accesso amministratore a wp-admin.
• Uno snippet PHP valido da inserire (scritto da te o fornito dal supporto POP).

Passi

1. Installa il plugin gratuito Code Snippets da wp-admin > Plugin > Aggiungi nuovo, poi attivalo.
2. Nel menu laterale, apri Snippets > Aggiungi nuovo.
3. Assegna un titolo descrittivo (es. “POP - disabilita numero fattura per pagamento X”).
4. Incolla il codice PHP nell’area dedicata. Non inserire il tag <?php: è già incluso automaticamente e duplicarlo causa un errore fatale.
5. Se ci sono errori di sintassi, l’editor li segnala prima del salvataggio.
6. Lascia attiva l’opzione “Esegui lo snippet ovunque” per gli hook lato server (add_filter, add_action) usati dal plugin POP.
7. Salva e attiva lo snippet.
8. Verifica il comportamento sul sito (es. in sandbox, se lo snippet tocca la generazione fatture).

Esempi di hook POP reali su cui si interviene di solito

Questi filtri esistono nel codice del plugin e sono pensati per essere personalizzati via snippet, senza modificare i file del plugin:

• wc_el_inv-disabled_set_invoice_number — per impedire l’assegnazione del numero fattura in condizioni specifiche (es. un metodo di pagamento particolare).
• wc_el_inv-invoice_create_xml_by_order_status — per cambiare lo stato ordine che genera l’XML (default completed).
• wc_el_inv-stamp_duty_name — per rinominare la voce “Imposta di Bollo” in fattura.
• wc_el_inv-options-capability — per cambiare la capability WordPress richiesta per accedere alle impostazioni POP (default quella di amministrazione/gestione WooCommerce).

Verifica

Dopo aver attivato lo snippet, riproduci lo scenario che volevi modificare (es. genera un ordine di test) e controlla che il comportamento sia quello atteso.

Errori comuni

• Errore fatale dopo il salvataggio — quasi sempre per aver incluso <?php di nuovo, o per una virgola/parentesi mancante: l’editor segnala la riga.
• Lo snippet non ha effetto — controlla che sia impostato su “Esegui ovunque” (non solo admin o solo frontend, a seconda di dove serve l’hook) e che sia effettivamente attivo (non solo salvato).
• Non sai se un filtro esiste ancora dopo un aggiornamento — verifica nel changelog del plugin, i nomi degli hook possono cambiare tra major version.

Configurazione correlata

Per i nomi dei campi di checkout su cui questi snippet spesso agiscono, vedi checkout-field-names.