Enviar recibos automatizados e personalizáveis em PDF para os membros

O PDF é um formato de documento popular que oferece uma experiência de exibição consistente em muitas plataformas. Criamos um plug-in complementar para o MemberMouse que envia recibos por e-mail aos seus membros com um recibo em PDF anexado no estilo padrão, permitindo que eles retenham facilmente cópias para seus registros.

This plugin allows you to draft a billing receipt email with PDF attachment that is sent to members when initial and rebill payments are received. You can customize the Header and Footer(s) on the attached PDF. You can also allow your members to add custom billing details to the receipt and choose to ‘cc’ an additional recipient. There is functionality to resend a previous receipt and translation support. You’ll find documentation for all these elements in this article.

Requisitos do plug-in

O MemberMouse 2.4.0 ou superior é necessário para utilizar essa extensão.

The plugin also requires some additional server software components. Typically, these options are included with most hosting, but if you find that other site emails (like welcome emails) are being received but PDF receipts are not (after checking the SPAM folder), ask your host to verify that the following versions/extensions are active on your server.

• PHP 7.1+ is required.
  
• PHP dom
  
• Mbstring
  
• GD
  
• O Imagick ou o Gmagick também são recomendados

Instalando o plug-in

1. Click here to download the latest version of Recibos em PDF do MemberMouse
   
2. Abra o painel administrativo do WordPress
   
3. Na coluna da esquerda, selecione Plug-ins > Adicionar novo
   
4. Clique no botão Plug-in de upload na parte superior da tela
   
5. Clique em Selecionar arquivo e selecione o arquivo que você baixou
   
6. Clique em Instalar agora
   
7. Quando a instalação estiver concluída, clique em Ativar

Aplicação da configuração padrão

Quando ativado, o MemberMouse PDF Receipts não começa imediatamente a enviar seus recibos. Você deve primeiro configurar a extensão para que ela comece a funcionar. Você pode acessar o painel de configuração clicando em Configurar na lista de plug-ins em seu site ou selecionando MM PDF Receipts na coluna da esquerda.

Há duas seções: Configuração de PDF e Modelo de e-mail. As configurações padrão estão incluídas para ambos, e você pode preencher previamente os campos de configuração clicando no botão Definir o padrão... na parte superior de cada seção. Em seguida, é possível modificar a seção conforme desejado, mas observe que será necessário clicar no botão Salvar na parte inferior da seção para aplicar suas alterações.

Como alternativa, você pode ativar a extensão imediatamente com os padrões, clicando em cada um dos Use o padrão... links no cabeçalho:

Cada link aplica e salva simultaneamente os padrões de sua seção. Depois que a configuração tiver sido aplicada, a extensão se tornará ativa e começará imediatamente a enviar recibos em resposta aos eventos de pagamento inicial e de cobrança.

Configuração do arquivo PDF

Esta seção permite personalizar parte do conteúdo do arquivo PDF gerado. Há suporte para HTML básico.

Informações comerciais

O Informações comerciais fields are where you would place your company’s business details. These will be centered and displayed at the top of the PDF file, and the automatically generated receipt is placed in underneath. Note that HTML <br/> são necessárias após cada linha de um endereço com várias linhas.

Etiqueta de imposto comercial e ID fiscal da empresa são campos opcionais que só aparecerão se forem inseridos.

Configurações de design

O Configurações de design permite adicionar um logotipo ou uma imagem na parte superior do anexo do PDF. Isso estará localizado acima das Informações comerciais que você preencheu na seção anterior.

No Logotipo/Imagem do cabeçalho area, you’ll generate a Data URI for your logo and paste it into the field provided. 

Para fazer isso, clique no link para Gerar um URI de dados (https://ezgif.com/image-to-datauri) e siga as etapas simples fornecidas para criar o URI de dados. 

1. Click ‘Choose File’ to locate the image you want to upload, and then select ‘Upload’.

2. After uploading, select ‘Nothing’ from the Incluir tags para dropdown menu and click on ‘Generate Data URI’.

3. Click ‘Select All’ to select all the text in the ‘Output Data URI code’ box. Copy that text.

4. Volte para a interface do PDF Receipts Plugin e cole o código no campo fornecido.

Se, depois de visualizar a imagem, você quiser redimensioná-la. Esse mesmo site pode ser usado para redimensionar: https://ezgif.com/resize

O Alinhamento do logotipo/imagem do cabeçalho permite que você escolha o posicionamento do logotipo.

O Cor da borda permitirá que você escolha a cor da linha que separa a imagem do logotipo das Informações comerciais na seção Cabeçalho. Se não quiser que uma linha apareça, você pode escolher Branco (#ffffff) como a cor. 

Rodapé da fatura

O Rodapé da fatura consiste em duas áreas. Se essas áreas estiverem vazias, essa área do recibo será deixada em branco.

Área 1 aparece imediatamente abaixo da fatura e, por padrão, é alinhado ao lado esquerdo do documento, como um parágrafo normal. É útil para informações de contato, isenções de responsabilidade, declarações sobre faturamento e assim por diante. 

Área 2 é centralizado e exibido na parte inferior do documento. É útil para uma assinatura final ou linha de tag. 

Detalhes de faturamento personalizados

O Detalhes de faturamento inseridos manualmente is an optional section that you would use to include a member’s custom billing details in the ‘Bill To’ area of the receipt. 

As informações padrão exibidas são Nome, E-mail e Endereço de cobrança (se incluído). No entanto, pode ser desejável exibir informações alternativas ou adicionais, como, por exemplo, se seus membros precisarem incluir um ID de IVA ou imposto com seus detalhes de cobrança.

In order to use this section, you’ll first need to have a space where your members can add that custom information. This is done through Campos personalizados do MemberMouse. Você pode create a ‘Long Text’ campo personalizado e escolha a opção para 'Mostrar na página Minha conta' para coletar essas informações. 

Então, se você selecionar esse campo personalizado no menu suspenso dessa seção, a extensão usará essas informações no recibo no lugar de o nome, o e-mail e o endereço de cobrança do pedido. 

Portanto, será necessário deixar claro para seus membros que eles devem incluir todas as suas informações in the Custom Field, just as they’d like it displayed on their receipt.

Depois de personalizar o modelo de acordo com suas preferências, clique em Salvar configuração de PDF.

As configurações padrão gerarão o seguinte conteúdo:

Configuração do modelo de e-mail

Sua fatura em PDF será enviada como anexo de e-mail e, nessa seção, você pode criar o e-mail ao qual a extensão anexará o arquivo. Se você tiver criado anteriormente um e-mail Notificação por pushSe você tiver uma experiência de trabalho com a Internet, verá que esse processo lhe é familiar. Há suporte para HTML. Para facilitar a composição, os caracteres de nova linha são automaticamente traduzidos em quebras de linha HTML.

"Endereço "From

O De drop-down permite que você defina o endereço de e-mail do qual o e-mail será enviado. Você pode escolher qualquer um de seus Contas de funcionários, and if you’d like the email to come from an address that is not listed, you can click Gerenciar funcionários e Criar uma conta de funcionário.

"Endereço "CC

O ‘CC’ area is an optional section that allows you to add a cc’d recipient for the receipt email. If this is not configured or if there is no ‘cc’ information available for the account, then the email receipt will be sent only to the email address associated with the member account.

In order to use this section, you’ll need to create a ‘Short Text’ campo personalizado para manter as informações adicionais do endereço de e-mail. Em seguida, selecione esse campo personalizado no menu suspenso dessa seção.

Em seguida, você pode optar por adicione isso diretamente em seu site, como na página Minha contapara que seus membros possam adicionar as informações por conta própria. Ou você pode simplesmente adicionar as informações manualmente, conforme necessário, individualmente, acessando a seção Detalhes do membro > Campos personalizados guia.

Linha de assunto e texto do e-mail

Nas próximas duas seções, você pode compor a linha de assunto e o corpo do e-mail. Por padrão, nosso O modelo de recibo de pedido é pré-preenchido. Observe o uso de SmartTags™ para inserir dinamicamente informações sobre o membro e o pedido.

Quando estiver satisfeito com o e-mail, clique em Salvar modelo de e-mail.

As configurações padrão gerarão um e-mail com a seguinte aparência:

Uso de SmartTags™ no modelo de e-mail

Uma variedade de SmartTags™ são compatíveis com o conteúdo dinâmico:

Link de conteúdo Link da página principal Link de membro Link para compra

Dados de conteúdo Dados do campo personalizado Dados do funcionário Dados do membro Dados do pedido

Decisão de acesso Decisão do membro Ordem Decisão

Quando o MemberMouse envia o e-mail, Link e Dados As SmartTags™ são automaticamente substituídas por informações apropriadas para seu site ou para o membro destinatário.

Você pode cercar seções do seu e-mail com Decisão SmartTags™ para controlar se o conteúdo será enviado ou não.

Observe que o Link de conteúdo, Dados de conteúdoe Decisão de acesso As SmartTags™ exigem que você forneça o ID de uma página ou publicação específica.

Testando a extensão

Once you’ve configured the PDF Content and Email Template, you’ll notice that the header changes to indicate that the extension is active and displays additional tabs – Enviar teste, Reenviar recibo, Informações e Ajuda.




It’s recommended that you preview the results by sending yourself a test invoice. You can do this by going to the Guia Enviar teste e digite seu endereço de e-mail no campo de entrada. Em seguida, clique em Enviar teste.

As informações para criar o e-mail de teste e o pdf são obtidas do pedido mais recente feito.

Emails are sent using standard WordPress functionality, so if the message is not received, or ends up in your spam folder, it’s typically due to issues with the email services offered by your hosting provider. Please see our article on Os e-mails não estão sendo enviados para obter mais informações, e considere a possibilidade de instalar um plug-in de terceiros para melhorar a capacidade de entrega de e-mails.

Reenviar um recibo

Periodicamente, você pode receber uma solicitação de um membro para enviar outra cópia de um recibo anterior. Esta seção permite que você pesquise o histórico de pedidos anteriores e envie um recibo de qualquer transação anterior.

In the interface, you’ll digite o número do pedido associado à transação que precisa do envio de um recibo duplicado.

Se você não souber o número do pedido, clique no botão ‘Lookup Order #’ button abrirá o Procurar transações para que você possa localizar esse número.

Once you’ve entered the Order Number, clique em Preview to confirm the information that’s being sent and to whom.

The preview will show the Recipient Information, allow you to enter an additional ‘cc’ email address and display the basic Order Information. Once you’re sure this is the correct transaction for the receipt you want to send, click on Confirm & Send Receipt.

Quando você reenviar um recibo, ele será registrado no Registro de atividades para o membro associado, da mesma forma que um recibo normal sendo enviado é registrado.

Suporte para tradução de elementos de recibos em PDF

O plug-in MemberMouse PDF Receipts vem com suporte de tradução padrão para os seguintes idiomas:

Alemão, francês, húngaro, espanhol, espanhol mexicano e português do Brasil.

Isso significa que, se você tiver um desses idiomas selecionado no menu WordPress Configurações gerais > Idioma do site setting, then the headers on the PDFs that you send out (such as ‘Date Paid’ and ‘Order Number’) will be translated into that language.

Se você quiser alterar essas traduções padrão, alterar o texto nos cabeçalhos ou traduzi-los para um idioma diferente, siga as etapas listadas na seção Traduzir MemberMouse - Básico article. The only difference would be that when you are choosing the plugin to alter, you would choose ‘MemberMouse PDF Receipts’ and not ‘MemberMouse’.