Como traduzir comunidades do BuddyPress e do BuddyBoss no WordPress

Antes de começar

Instale e ative estes plugins:

• BuddyBoss Platform ou BuddyPress. Se você estiver usando o BuddyPress 12.0 ou posterior, ative também o complemento BP Classic.
• WPML e WPML Tradução de Strings.
• WPML Multilingual for BuddyPress and BuddyBoss (o complemento de integração que esta página abrange).

Primeiro, crie sua comunidade no idioma de origem. Crie as páginas que o BuddyBoss gera: Groups, Members, News Feed e quaisquer páginas personalizadas. Defina seus tipos de perfil e tipos de grupo no painel de administração do BuddyBoss. Registre seus campos personalizados de perfil. Configure seus fóruns e tópicos de atividade. Você pode editar depois e enviar atualizações para tradução a qualquer momento.

O Traduzir tudo automaticamente cuida disso para você

Se o seu site tiver o Traduzir tudo automaticamente ativado, você não precisará enviar cada parte da comunidade para tradução manualmente. O WPML detecta o conteúdo novo e atualizado da comunidade junto com o restante do seu site. Ele traduz tudo em segundo plano.

As etapas de configuração abaixo ainda se aplicam: formato de URL, tornar os fóruns traduzíveis e seletor de idiomas. A etapa de tradução é automática. O restante desta página descreve o caminho manual para sites configurados com a opção Traduzir uma parte: você escolhe o que traduzir.

Defina seu formato de URL como “Idiomas diferentes em diretórios”

O WPML Multilingual for BuddyPress and BuddyBoss exige o formato de URL Idiomas diferentes em diretórios (por exemplo, example.com/fr/). Vá para WPML → Configurações → URLs e SEO e confirme a configuração Formato de URL do idioma.

Traduza as páginas padrão da sua comunidade

O BuddyPress e o BuddyBoss geram um conjunto de páginas padrão: Groups, Members, News Feed e quaisquer páginas da comunidade que você tenha adicionado. Traduza-as pelo Painel de tradução:

1. Vá para WPML → Traduções → Painel.
2. Expanda a seção Páginas.
3. Marque as páginas da comunidade.
4. Escolha um método de tradução. PTC (recomendado), seu tradutor ou Traduzir eu mesmo.
5. Clique em Traduzir.

Traduza os fóruns

Os fóruns são um tipo de post personalizado. Torne-os traduzíveis primeiro e, em seguida, traduza-os:

1. Vá para WPML → Configurações → Tradução de tipos de post.
2. Defina Fóruns como Traduzível e clique no botão Salvar.
3. Volte para WPML → Traduções → Painel e traduza o conteúdo do fórum a partir da seção Fóruns.

Você também pode criar fóruns separados por idioma. Por exemplo, um fórum em inglês Best Breakfast Ideas (Melhores ideias para o café da manhã) junto com um fórum em francês Idées de petit-déjeuner (Ideias para o café da manhã). Isso dá aos membros em diferentes mercados seus próprios tópicos de discussão, para que seus feeds não misturem idiomas. Crie-os como fóruns separados e traduza cada um pelo mesmo fluxo de trabalho.

Traduza os tipos de perfil e tipos de grupo

Os tipos de perfil são os Member Types (Tipos de membro) do BuddyPress, como Student (Estudante), Instructor (Instrutor) ou Mentor (Mentor). Os tipos de grupo são os Group Types (Tipos de grupo) do BuddyBoss, como Cohort (Turma), Chapter (Capítulo) ou Region (Região). Ambos são traduzidos pelo Gerenciamento de tradução:

1. Vá para WPML → Traduções → Painel.
2. Os tipos de perfil aparecem na seção BuddyPress Profile Type. Os tipos de grupo aparecem na seção BuddyBoss Group Type.
3. Selecione os itens, escolha um método de tradução e clique em Traduzir.

Traduza os campos personalizados de perfil e os filtros de pesquisa de perfil

Todo campo personalizado de perfil que você registra no painel de administração do BuddyBoss é traduzido pela WPML Tradução de Strings. O mesmo acontece com os filtros de pesquisa de perfil que os membros usam para encontrar uns aos outros.

1. Vá para WPML → Traduções → Painel.
2. Role até Outros textos (Strings).
3. Pesquise os rótulos e valores de opção dos seus campos.
4. Selecione-os e envie para tradução.

Traduza os grupos do BuddyBoss

Os nomes, descrições e hierarquias de grupos do BuddyBoss são traduzidos por dois caminhos.

Pelo Painel de tradução:

1. Vá para WPML → Traduções → Painel.
2. Role até Outros textos (Strings).
3. Pesquise os nomes dos grupos.
4. Selecione-os e envie para tradução.

Pelo frontend:

Qualquer usuário com a função correta pode mudar para um idioma secundário e editar um grupo. A edição se aplica apenas àquele idioma. O idioma de origem permanece intacto. Ao editar um grupo traduzido, as opções do grupo pai são exibidas no idioma em que você está editando. As hierarquias permanecem preservadas por idioma.

Traduza os tópicos de atividade, álbuns de mídia e pastas

Os tópicos de atividade são os tópicos definidos pelo administrador que organizam o News Feed. Os álbuns de mídia e pastas são uploads de membros dentro de grupos. Todos os três são traduzidos pelo mesmo caminho:

1. Vá para WPML → Traduções → Painel.
2. Role até Outros textos (Strings).
3. Pesquise o nome do tópico, álbum ou pasta.
4. Selecione e envie para tradução.

Mantenha sua BuddyBoss Platform na versão atual para que esses recursos detectem as strings traduzidas.

Traduza os textos do tema

Os textos de tema do BuddyBoss e do BuddyPress abrangem o formulário de cadastro, formulário de login, configurações da conta, página de mensagens, rótulos de perfil, abas de navegação e rótulos de botões. Eles são traduzidos pela WPML Tradução de Strings:

1. Vá para WPML → Traduções → Painel.
2. Role até Outros textos (Strings).
3. Selecione as strings do tema.
4. Envie para tradução.

Se uma string do tema não aparecer em Outros textos (Strings), visite a página que a contém no frontend. Mude o idioma e navegue pela página. O WPML descobre a string automaticamente e a adiciona à lista na próxima atualização do painel de administração.

Adicione um seletor de idiomas

Os membros precisam de uma maneira óbvia de mudar de idioma. O WPML coloca um no rodapé por padrão. Para adicionar um aos seus menus:

1. Vá para WPML → Configurações → Seletores de idiomas.
2. Role até Seletor de idiomas de menu e clique em Adicionar um novo seletor de idiomas a um menu.
3. Configure a aparência e salve.

BuddyBoss App – Dois caminhos de tradução distintos

Se você distribui um aplicativo nativo para iOS ou Android criado com o BuddyBoss App, o fluxo de trabalho multilíngue se divide em dois caminhos distintos.

Strings de interface do aplicativo – gerenciadas no painel de administração do BuddyBoss (não pelo WPML). Botões, rótulos, avisos e menus no aplicativo nativo são gerenciados em BuddyBoss App → Translations no WordPress. Adicione idiomas a partir dos 29 pacotes de idiomas integrados. Edite as traduções padrão no painel ou via exportação e importação de CSV. Adicionar um novo idioma requer uma nova compilação do aplicativo. Para o procedimento completo, consulte a documentação multilíngue do aplicativo do BuddyBoss (abre em uma nova aba).

Conteúdo do aplicativo – traduzido pelo WPML no lado do WordPress. Páginas, posts, cursos e eventos que o aplicativo extrai do WordPress são traduzidos pelo WPML. Use o mesmo fluxo de trabalho que você usaria para qualquer conteúdo baseado em post. Traduza o conteúdo uma vez no WordPress. O aplicativo mostra a versão no idioma correto de acordo com o idioma escolhido pelo membro. O BuddyBoss confirma isso em seu próprio FAQ do aplicativo: “for post-based content (pages, posts, courses, events), you may use WPML Plugin that is integrated with BuddyBoss.” (para conteúdo baseado em posts (páginas, posts, cursos, eventos), você pode usar o plugin WPML que é integrado ao BuddyBoss).

Traduza o restante da stack da sua comunidade

Uma comunidade do BuddyBoss geralmente é combinada com um LMS, um plugin de eventos, fóruns e um plugin de pagamento. Cada plugin complementar compatível com o WPML tem seu próprio caminho de tradução:

• LearnDash LMS. Consulte a compatibilidade do LearnDash com o WPML.
• Tutor LMS Pro. Apenas a versão Pro é suportada. Consulte a compatibilidade do Tutor LMS Pro com o WPML.
• The Events Calendar. Consulte a compatibilidade do The Events Calendar com o WPML.
• Modern Events Calendar Lite ou Pro. Consulte a compatibilidade do Modern Events Calendar com o WPML.
• bbPress com a integração bbPress Multilingual. Consulte a compatibilidade do bbPress com o WPML.
• WooCommerce com o WPML for WooCommerce para assinaturas pagas e checkout. Consulte o WPML for WooCommerce.

Todos os plugins desta lista estão na relação de compatibilidade certificada do WPML. Criar uma comunidade multilíngue em uma stack verificada evita surpresas.

Problemas comuns

A plataforma BuddyBoss é enorme e poderosa. Ela abrange o site e os aplicativos nativos para iOS e Android, com centenas de recursos e dezenas de integrações. As equipes do WPML e do BuddyBoss trabalham em estreita colaboração para manter a integração multilíngue alinhada a cada versão.

Quando algo não é traduzido da maneira que você espera, geralmente é uma lacuna temporária. Uma das duas equipes normalmente já está acompanhando o problema e lançará uma correção.

Para obter a lista atual de problemas conhecidos com o BuddyBoss e o WPML e suas resoluções, consulte a página de compatibilidade do BuddyBoss no wpml.org. Cada problema é listado lá com seu status atual, e os resolvidos mostram a versão que os corrige.