WordPress.org

Plugin Directory

NIF (Num. de Contribuinte Português) para WooCommerce

NIF (Num. de Contribuinte Português) para WooCommerce

Descrição

Este plugin adiciona o NIF/NIPC Português como um novo campo na finalização de compras do WooCommerce e aos detalhes da encomenda, se a morada de facturação do cliente for de Portugal.

Funcionalidades:

  • Adiciona o campo NIF / NIPC aos campos de facturação na finalização da encomenda do WooCommerce, campos de gestão da encomenda em backoffice, emails da encomenda e página “Obrigado pela sua encomenda”;
  • É possível editar o NIF/NIPC de cliente em “A minha conta – Morada de facturação” e no ecrã de edição do utilizador no wp-admin.
  • Validação do check digit no NIF/NIPC (se activado via filtro, ou opção no bloco)
  • Compatível com o Armazenamento de encomendas de alto desempenho (HPOS)
  • Compatível com a Finalização de compras baseada em blocos (em beta)

Já emite facturas automáticas na sua loja WooCommerce?

Se não, conheça o nosso novo plugin: Facturação com InvoiceXpress no WooCommerce

Já conhece os nossos outros plugins WooCommerce (premium)?

Instalação

  • Use a funcionalidade de instalação automática na área de plugins do WordPress e pesquise por “NIF WooCommerce”.

Perguntas frequentes

Como fazer o campo NIF obrigatório?

Finalização de compras clássica – Adicione isto ao functions.php do seu tema ou plugin de code snippets:

add_filter( 'woocommerce_nif_field_required', '__return_true' );

Finalização de compras com blocos – Active a opção “Obrigatório” no bloco de NIF.

É possível validar o check digit para assegurar que um NIF/NIPC Português válido é introduzido pelo cliente?

Sim, é!

Finalização de compras clássica – Adicione isto ao functions.php do seu tema ou plugin de code snippets:

add_filter( 'woocommerce_nif_field_validate', '__return_true' );

Finalização de compras com blocos – Active a opção “Validar” no bloco de NIF.

Só recomendamos validar o NIF se a sua loja vender exclusivamente para Portugal.

Como modificar a posição do campo de NIF na finalização de compras?

Finalização de compras clássica – Adicione isto ao functions.php do seu tema ou plugin de code snippets:

add_filter( 'woocommerce_nif_field_priority', function( $priority) {
    // Default is 120 - Adjust the number to move the field up (lower number) or down (higher number)
    return 120;
} );

Finalização de compras com blocos – Por agora, o bloco está fixo depois da morada de facturação e antes das opções de envio. Estamos a trabalhar para que seja possível mover o bloco para onde quiser.
Instruções futuras para a finalização de compras com blocos – Mova o bloco do NIF para cima ou para baixo como pretendido. Não recomendamos que mova este campo acima das moradas de facturação e envio, pois a sua visibilidade pode depender do país seleccionado.

Este plugin é compatível com o Regulamento Geral de Proteção de Dados (RGPD)?

Primeiro que tudo, é responsabilidade do proprietário do website fazer com que todo ele seja compatível porque nenhuma informação pessoal é passada para nós, os desenvolvedores do plugin.
De qualquer forma, podemos ajudar-te a documentar como é que este plugin trata os dados recolhidos:
* O NIF/NIPC é recolhido na finalização de compras e guardado como um valor meta na encomenda, junto com todos os outros campos de encomendas do WooCommerce;
* O NIF/NIPC também pode ser definido em “A minha conta – Morada de facturação” e nesse caso é guardado como valor meta do utilizador, junto com todos os outros campos de utilizadores do WordPress e WooCommerce;
* O NIF/NIPC é mostrado e editável no ecrã de gestão da encomenda e utilizador no backoffice, pelo proprietário da loja;
* O NIF/NIPC é mostrado nos emails transaccionais da encomenda;

Necessito ajuda, posso obter suporte técnico?

Este é um plugin gratuito. É a nossa maneira de dar de volta à fantástica comunidade WordPress.

Existe uma aba de suporte no topo desta página, onde pode pedir ajuda à comunidade. Tentamos estar atentos aos fóruns, mas não podemos prometer responder a pedidos de suporte.

Se nos contactar por email ou qualquer outra forma directa, vamos assumir que necessita de suporte urgente, premium, e claro, pago.

Onde reporto vulnerabilidades de segurança encontradas neste plugin?

Pode reportar bugs de segurança encontrados no código fonte deste plugin através do Patchstack Vulnerability Disclosure Program. A equipa do Patchstack irá ajudar com a verificação, atribuição de CVE e tratará de nos notificar.

Avaliações

15 Dezembro, 2022 1 reply
Marco is a great person and developer with a big impact on the Wordpress Portuguese scene
3 Dezembro, 2020 4 replies
Avaliação actualizada em Dez 2020 🙂 ** Quando for possível tornar o NIF campo obrigatório através de uma “checkbox” e fazer a sua validação automática darei 5 *****… 🙂 Até lá vou usar outro plugin que faz mais ou menos o mesmo. Actualizar os ficheiros do tema como proposto nas FAQs é pouco recomendável, como se sabe. Criar um child theme só para isto, não vale a pena…
28 Novembro, 2018
Faz o que promete de forma simples e eficaz ——————————————- Do what it says just fast and beautifully
Ler todas as 10 avaliações

Contribuidores e programadores

“NIF (Num. de Contribuinte Português) para WooCommerce” é software de código aberto. As seguintes pessoas contribuíram para este plugin:

Contribuidores

“NIF (Num. de Contribuinte Português) para WooCommerce” foi traduzido para 1 locale. Obrigado aos tradutores pelas suas contribuições.

Traduza o “NIF (Num. de Contribuinte Português) para WooCommerce” para o seu idioma.

Interessado no desenvolvimento?

Consulte o código, consulte o repositório SVN, ou subscreva o registo de alterações por RSS.

Registo de alterações

6.3 – 2024-03-27

  • [DEV] Set Requires Plugins tag to woocommerce
  • [DEV] Tested with WordPress 6.5-RC3-57875 and WooCommerce 8.8.0-beta.1

6.2 – 2024-02-18

  • [DEV] Simplify block build process and implement SVG accessibility attributes
  • [DEV] Tested with WordPress 6.5-beta1-57650 and WooCommerce 8.6.0

6.1 – 2024-02-01

  • [FIX] Correctly load block i18n on the block javascript files
  • [DEV] Declare cart anc checkout blocks compatibility (just in case)
  • [DEV] Tested with WordPress 6.5-alpha-57505 and WooCommerce 8.6-0-beta.1

6.0 – 2024-01-30

  • [NEW] Block-based Checkout compatibility (in beta)
  • [TWEAK] Improve filters_examples.php
  • [DEV] Requires WordPress 5.6 and WooCommerce 6.0
  • [DEV] Tested with WordPress 6.5-alpha-57378 and WooCommerce 8.5.2

5.6 – 2024-01-10

  • Fix checkout validation feedback on WooCommerce 8.5 and above
  • Tested with WordPress 6.5-alpha-57258 and WooCommerce 8.5

5.5 – 2023-11-17

  • Tested with WordPress 6.5-alpha-57114 and WooCommerce 8.3.0

5.4 – 2023-09-07

  • Do not accept “000000000” as NIF number, if validation is active
  • Fixed HTML markup on the “Thank You” page
  • Tested with WordPress 6.4-alpha-56530 and WooCommerce 8.1.0-rc.1

5.3 – 2023-04-18

  • Fixed a bug introduced on version 5.2 when using the woocommerce_nif_field_validate filter to validate the Portuguese NIF

5.2 – 2023-04-17

  • WordPress Coding Standards
  • Tested with WordPress 6.3-alpha-55644 and WooCommerce 7.6.0

5.1 – 2022-11-10

  • Tested and confirmed WooCommerce HPOS compatibility
  • Requires WooCommerce 5.0
  • Tested with WordPress 6.2-alpha-54748 and WooCommerce 7.1

5.0.0 – 2022-09-20

  • If NIF validation is active by using the woocommerce_nif_field_validate filter, the field will be set as invalid om the checkout form when the validation is performed and fails
  • Removed all WooCommerce pre 3.0 code
  • Requires WooCommerce 4.0
  • Tested with WordPress 6.1-alpha-54043 and WooCommerce 6.9.2

4.3.0 – 2022-06-29

  • New brand: PT Woo Plugins 🥳
  • Requires WordPress 5.0, WooCommerce 3.0 and PHP 7.0
  • Tested with WordPress 6.1-alpha-53556 and WooCommerce 6.7.0-beta.2

4.2.6 – 2022-02-23

  • Check if the is_checkout function exists before calling it
  • Tested with WordPress 6.0-alpha-52790 and WooCommerce 6.3.0-rc.1

4.2.5 – 2021-03-10

  • Tested with WordPress 5.8-alpha-50516 and WooCommerce 5.1.0

4.2.4.2

  • Tested with WordPress 5.6-alpha-49064 and WooCommerce 4.6.0-beta.1

4.2.4.1

  • Tested with WooCommerce 4.0.0

4.2.4

  • Changes on the InvoiceXpress banner
  • Tested with WordPress 5.3.3-alpha-46995 and WooCommerce 3.9.0-rc.2

4.2.3

  • Hide the InvoiceXpress nag if the invoicing is already installed and active
  • Tested with WordPress 5.3.1-alpha-46798 and WooCommerce 3.8.1

4.2.2

  • Change InvoiceXpress nag interval from 30 to 90 days
  • Tested with WordPress 5.2.4-alpha-46074 and WooCommerce 3.8.0-beta.1
  • Requires PHP 5.6

4.2.1

  • NIF field on Subscriptions via the admin order screen (thanks @ptravassos)
  • Tested with WooCommerce 3.6.5 and WordPress 5.2.2

4.2

  • Add NIF to the WooCommerce REST orders and customers endpoints

4.1.3

  • Fixed a fatal error when the woocommerce_nif_field_validate was set to true and the customer doesn’t have a country associated yet
  • Tested with WooCommerce 3.5.5 and WordPress 5.0.3

4.1.2

  • Tested with WooCommerce 3.5.2
  • Bumped WC tested up tag
  • Bumped Requires at least tag

4.1.1

  • Tested with WooCommerce 3.5
  • Bumped WC tested up tag
  • Bumped Requires at least tag

4.1

  • Using WC()->customer->get_billing_country() instead of WC()->customer->get_country() on WooCommerce 3.0 and above

4.0

  • Toggle the NIF field via javascript on the checkout page by default – if you need to get back to the old mechanism, you should false on the woocommerce_nif_use_javascript filter
  • New woocommerce_nif_show_all_countries to show the field for all countries instead of only to portuguese customers (not recommended)
  • Tested with WooCommerce 3.3
  • Filters examples updated
  • Improved the FAQ

3.3

  • Experimental javascript toggle of the NIF field on the checkout page, so that the field is shown or hidden depending on the billing country selection (by returning true on the woocommerce_nif_use_javascript filter) – this will probably be default on a later version, after heavy user testing
  • GDPR information
  • Improved the FAQ

3.2

  • Fixed a bug where if the validation is active but the field is not required, the checkout wouldn’t go ahead if the client didn’t fill the field
  • Validation of the field on the “My Account – Billing Address” form
  • Bumped Tested up to and WC tested up to tags
  • Better code formatting standards
  • Improved the FAQ

3.1

  • Removed the translation files from the plugin lang folder (the translations are now managed on WordPress.org’s GlotPress tool and will be automatically downloaded from there)
  • Tested with WooCommerce 3.2
  • Added WC tested up to tag on the plugin main file
  • Bumped Tested up to tag

3.0

  • It’s now possible to validate the Portuguese NIF/NIPC check digit entered by the customer (by returninig true on the woocommerce_nif_field_validate filter)
  • Tested with WooCommerce 3.0.0-rc.2
  • Changed version tests from 2.7 to 3.0
  • New autocomplete parameter set to ‘on’
  • New priority parameter set to ‘120’
  • New maxlength parameter set to ‘9’
  • New filters to manipulate the field label, placeholder, required, class, clear, autocomplete and maxlength parameters (check filters_examples.php)
  • Bumped Tested up to tag

2.1

  • WooCommerce 2.7 compatibility
  • NIF/NIPC is also shown and editable, in admin, on the user edit screen (alongside with other Billing Address fields)

2.0.2

  • Fix typos in the readme.txt file (Thanks Daniel Matos)

2.0.1

  • Bumped Tested up to and Requires at least tags

2.0

  • Completely rewritten
  • NIF/NIPC is added to the Billing Address fields on the Checkout (as long as the customer country is Portugal)
  • You can also edit the user NIF/NIPC on the “My Account – Billing Address” form
  • NIF/NIPC is also shown and editable on the order screen (alongside with other Billing Address fields)
  • NIF/NIPC is added to the Customer Details section on Emails and Thank You page.

1.3

  • Adds the field to the My Acccount / Edit Billing Address form

1.2.2

  • The value is now auto-filled with the last one used

1.2.1

  • Small fix to avoid php notices

1.2

  • WordPress Multisite support

1.1.1

  • Forgot to update version number on the php file.

1.1

  • Bug fix after WooCommerce 2.1 changes.

1.0

  • Initial release.