WPML

Os grupos de campos repetíveis ajudam você a criar sites avançados facilmente. Mais importante ainda, eles facilitam o gerenciamento do conteúdo sem o risco de quebrar o design do front-end.

O que são os grupos de campos repetíveis


Um campo personalizado permite que você adicione uma informação a um post, página ou tipo de post personalizado. Um grupo de campos repetíveis permite que você adicione listas de informações. Você pode pensar nos grupos de campos repetíveis como uma tabela, contendo linhas para cada um dos itens e colunas para seus diferentes campos.

Por exemplo, aqui está um grupo de campos repetíveis, que configuramos para exibir uma galeria no front-end.

Neste exemplo, a “galeria” é a lista e cada um dos itens na galeria precisa de várias informações para ser exibido (uma imagem, descrição e link opcional).

Como os grupos de campos repetíveis ajudam a criar sites


Quando você usa grupos de campos repetíveis, você separa completamente a edição do conteúdo e como o conteúdo aparece no front-end. Os editores usarão a estrutura de tabela no painel de administração do WordPress, que mostra os diferentes campos para cada item. O grupo de campos repetíveis é exibido no front-end usando um template.

Isso produz uma série de grandes vantagens:

  • Os editores podem adicionar, modificar e remover itens sem que você se preocupe em quebrar o site no front-end.
  • Você pode exibir exatamente a mesma informação, ou partes dela, de maneiras diferentes.
  • É muito mais fácil traduzir. Seus tradutores editam apenas os textos, sem tocar em designs delicados.

Plugins que criam grupos de campos repetíveis


O WordPress não tem grupos de campos repetíveis. No entanto, existem plugins que os criarão para você.

Logotipo do Advanced Custom FieldsO plugin mais conhecido para configurar grupos de campos repetíveis é o ACF (Advanced Custom Fields). A versão gratuita não oferece grupos de campos repetíveis, mas você pode comprar o complemento de campos repetidores.

Logotipo do ToolsetOs grupos de campos repetíveis também estão chegando ao Toolset (atualmente disponíveis em versões beta). O Toolset vem da mesma equipe que desenvolve o WPML, então tudo o que você cria com o Toolset é Multilingual Ready (preparado para ser multilíngue) por design.

Como configurar e usar grupos de campos repetíveis


Os grupos de campos repetíveis no Toolset e no ACF parecem muito semelhantes no painel de administração do WordPress.

Veja como você configuraria um grupo de campos repetíveis no Toolset e o usaria para editar o conteúdo:

Como exibir grupos de campos repetíveis em páginas e templates


Depois de criar os grupos de campos repetíveis no painel de administração do WordPress, você provavelmente vai querer exibi-los no front-end do site.

Quando você projeta como o grupo de campos repetíveis aparece no front-end, você cria um template, que o WordPress usará para todos os itens repetíveis. Não há necessidade de duplicar seu design para cada item do grupo.

O ACF e o Toolset também adotam abordagens muito diferentes para isso.

O ACF fornece uma rica API PHP para adicionar campos aos templates. Você precisará editar o template responsável pelo tipo de post e chamar as funções que exibem os grupos de campos. Para fazer isso, você precisa ter um conhecimento básico de PHP e HTML. Veja a seção ‘Template Usage’ na página do Repeater Field do ACF para ver exemplos.

O Toolset também tem uma API PHP que você pode usar, mas o grande atrativo do Toolset é que você pode criar templates sem escrever PHP, usando blocos ou shortcodes. No Toolset, você precisará criar uma View que exibirá o grupo de campos repetíveis. Você pode adicionar esta View a qualquer página ou template.

Exibição dinâmica para grupos de campos repetíveis


Como você está exibindo o grupo de campos repetíveis com algum código, você pode criar exibições dinâmicas para ele. Por exemplo, você pode adicionar filtros, paginação e lógica condicional.

Digamos que nosso exemplo de galeria deva incluir links para os itens, mas eles sejam opcionais. Quando um item da galeria tiver um URL de destino, exibiremos um link. Se o criarmos com o ACF, escreveremos um código PHP que verifica esse campo e exibe o link condicionalmente. O Toolset torna isso muito mais fácil, usando o seu bloco condicional. Dessa forma, podemos examinar os valores dos campos no grupo e exibir elementos de acordo com as condições.

Como traduzir grupos de campos repetíveis


Tanto o ACF quanto o Toolset são compatíveis com o WPML. Para o ACF, criamos um plugin de integração chamado ACFML (ACF Multilingual). Você pode aprender a usá-lo em nossa página de documentação do ACF Multilingual.

O Toolset é compatível com o WPML pronto para usar, sem plugins de integração adicionais. Nós escrevemos um guia completo sobre como traduzir sites do Toolset com o WPML. Há também uma página curta que ensina como traduzir grupos de campos repetíveis.

Como estamos exibindo os grupos de campos repetíveis no front-end dinamicamente, tudo o que precisamos é traduzir os seus valores. O resultado será construído “automaticamente”. Ele mostrará os originais se não houver tradução, ou os textos traduzidos assim que os traduzirmos.

Escrito por Amir · Última atualização em 18 de outubro de 2024