Paid Memberships Pro – Import Users from CSV Add On

Importando Membros com o Paid Memberships Pro: A Adição Valiosa

O Paid Memberships Pro Import Users from CSV Add On é uma ferramenta poderosa que permite que você crie e atualize usuários facilmente através da importação de um arquivo CSV simples. Essa funcionalidade é especialmente útil para quem está migrando de outras plataformas ou mesmo de sistemas offline, já que permite preservar informações de pagamento e assinaturas ativas.

Como Funciona a Importação de Membros

Preparação do Arquivo CSV

Para começar, você precisa preparar seu arquivo CSV. É fundamental utilizar um modelo adequado para garantir que todas as informações sejam importadas corretamente. O ideal é baixar um template de exemplo que sirva de base para os seus dados. No WordPress, você pode navegar até Usuários > Importar Membros e encontrar um link para baixar um arquivo CSV de exemplo.

A lista de campos obrigatórios e opcionais para a importação está disponível na documentação do plugin. É crucial lembrar que ao importar, você deve incluir pelo menos um identificador único, como user_id, user_login ou user_email, para que o sistema consiga atualizar as informações de usuários existentes.

Processando a Importação

Após preparar seu arquivo, você está pronto para a importação. Acesse novamente Usuários > Importar Membros e ajuste as configurações de importação conforme necessário. Você deve selecionar seu arquivo CSV e pode optar por notificar os novos membros com um e-mail que incluirá suas informações de login. Além disso, é altamente recomendado marcar a opção de atualizar usuários existentes caso um nome de usuário ou e-mail correspondente seja encontrado.

A opção de Processar com AJAX é útil especialmente para listas maiores, pois permite que a importação seja feita em lotes, melhorando a eficiência do processo.

Dicas de Segurança

Antes de executar a importação em larga escala, recomenda-se realizar testes com uma amostra dos dados. Isso ajuda a garantir que o formato do seu arquivo CSV está correto e que os dados desejados estão sendo importados adequadamente. Para arquivos CSV maiores, a opção de processamento por AJAX é a melhor escolha, pois isso divide a importação em partes menores, facilitando o gerenciamento.

Estrutura do Arquivo CSV

Quando se trata dos campos que você pode incluir no seu CSV, existem muitos, e eles podem ser categorizados em diferentes seções.

Colunas de Usuário do WordPress

Para informações básicas do usuário, você deve incluir:

• user_login: Nome de usuário único.
• user_email: Endereço de e-mail único.
• first_name: Primeiro nome do usuário.
• last_name: Sobrenome do usuário.
• display_name: Nome que será mostrado no site.
• role: Função do usuário (recomenda-se usar “subscriber” para novos usuários).

Além desses, você pode incluir outros campos personalizados que deseja mapear.

Colunas de Nível de Assinatura do PMPro

Para gerenciar os níveis de assinatura, pelo menos o membership_id é necessário. Ao importá-lo, você pode definir o preço da assinatura e outros detalhes relevantes, como:

• membership_initial_payment: Pagamento inicial.
• membership_billing_amount: Valor da cobrança.
• membership_cycle_number: Número do ciclo de cobrança, como mensal ou anual.

É importante mencionar que, se você fornecer um membership_id como “0”, isso resultará no cancelamento de todas as assinaturas ativas do usuário.

Importando Múltiplos Níveis de Assinatura

Caso você deseje importar múltiplos níveis de assinatura para o mesmo usuário, basta duplicar as linhas correspondentes no seu CSV. Contudo, tenha em mente que isso só é possível se os grupos de níveis permitirem múltiplos níveis simultaneamente.

Uma estratégia eficiente é realizar duas importações separadas: a primeira com os dados dos usuários e a segunda com as informações de assinatura. Na segunda importação, você pode simplificar a quantidade de dados, mantendo apenas os campos essenciais para identificar o usuário.

Preservando Assinaturas Ativas

Para aqueles que desejam manter as assinaturas ativas durante o processo de migração, é imprescindível incluir os campos membership_subscription_transaction_id e membership_gateway. Sem essas informações, as integrações de gateway do PMPro não conseguirão associar adequadamente as novas mensagens de entrada ao usuário correto.

Colunas de Assinatura do PMPro

Essas colunas são essenciais para garantir que as assinaturas existentes sejam mantidas:

• membership_subscription_transaction_id: ID da transação de assinatura, que é necessário para continuar ou atualizar uma assinatura existente.
• membership_gateway: Identificação do gateway de pagamento correspondente à assinatura do usuário.

Importando Campos Personalizados

Uma das vantagens do Paid Memberships Pro é a capacidade de importar campos personalizados. Use chaves exclusivas (meta_key) que você definiu em seu site WordPress para mapeá-los no arquivo CSV.

Importação de Endereços de Membros

Embora a versão atual do PMPro não armazene informações de endereço de cobrança na meta de usuário, você ainda pode incluir essas informações usando colunas personalizadas no seu arquivo de importação. Exemplos de campos que você pode criar incluem member_address_firstname, member_address_lastname, entre outros.

Ação e Ganchos de Filtro

O Paid Memberships Pro oferece uma série de filtros e ações que você pode usar para adaptar o processo de importação às suas necessidades específicas. Por exemplo:

• apply_filters('pmproiucsv_required_import_headers', array('user_email')): Define os cabeçalhos obrigatórios.
• apply_filters('pmprocsv_ajax_import_batch', 50): Altera o número de importações por iteração.

Essas opções permitem que você ative ou desative características específicas durante o processo de importação.

Considerações Finais

Utilizar o Paid Memberships Pro Import Users from CSV Add On é uma excelente maneira de gerenciar sua base de membros de forma eficiente e organizada. Se você está pensando em migrar de uma plataforma, esse add-on pode facilitar muito o processo, garantindo que seus usuários e informações de assinatura sejam preservados.

Com a abordagem correta e seguindo as diretrizes mencionadas, você poderá realizar uma importação tranquila e sem complicações, consolidando sua comunidade ou associação em um sistema mais robusto e gerenciável.