Incluir imagens em massa em coleção

[Barbara_Freire]

Olá! Gostaria do auxílio para fazer upload em massa de fotografias vinculadas a itens de uma coleção. Importei os itens em massa em ‘Importar itens’ por planilha CSV para uma coleção, em seguida tentei incluir as imagens em massa ‘Adicionar itens em massa’, mas não consegui vincular as imagens aos itens já inseridos. Poderia me orientar como faço essa compatibilização?

Para esse “link” entre itens e fotografias criamos dois metadados nos itens: 1- Fotografia Frente e 2- Fotografia Verso. Nesse metadado preenchemos com a informação do título da fotografia em questão. Cada fotografia tem uma sigla e número específico que a identifica. Exemplo: pkmuza-007B-003-371_1 (Imagem frente) pkmuza-007B-003-371_2 (imagem verso).

[mateus.m.luna]

Olá @Barbara_Freire, tudo bem?

O fluxo do “Adicionar itens em massa” é para se criar itens. Para cada imagem que você envia ele cria um novo item rascunho. A partir dali você pode editá-los de diferentes formas. Se a quantidade de itens for na casa das dezenas, eu diria que é um bom caminho:

1. Usar o “Adicionar itens em massa” para criar itens rascunho já com as mídias e daí usar tanto a Edição em Massa quanto a Edição em Sequência.
2. Caso seus dados estejam em planilha, exporte estes itens recém criados via Exportador CSV e então alimente a planilha com os dados desejados, mantendo a coluna `special_item_id` que vai ter vindo com a exportação. Com esta coluna você vai poder atualizar os itens ao invés de criar novos;

Agora caso estejamos falando de centenas de itens, o melhor caminho é enviá-los primeiro para algum local online. Isso pode ser um servidor FTP ou mesmo seu próprio WordPress via galeria de mídias, desde que depois você se lembre de apagar eles. Nas colunas `special_document` para a frente (se lembrando neste caso do prefixo `file:`) e `special_attachments` para o verso. Você irá colocar a URL pública para estes arquivos nestas colunas. Daí sim pode realizar a importação já com os dados direto via importador CSV.

[Barbara_Freire]

Entendi. Talvez esteja tentando incluir da forma errada. Irei te explicar o que gostaria de fazer e se há uma funcionalidade que consigo fazer “em massa” ou somente um a um. Criamos uma planilha no Exel com vários objetos e consegui importar em massa corretamente. Dentre dois dos metadados da planilha são: 1- Fotografia Frente e 2-Fotografia, Verso, Lateral direita, Lateral esquerda e Outros. Nos campos dos objetos referente as fotografias inserimos o Título da Imagem, cada fotografia tem uma sigla e número específico que a identifica. Exemplo: pkmuza-007B-003-371_1 (Imagem frente) pkmuza-007B-003-371_2 (imagem verso). Gostaria de saber se há como incluir todas imagens de todos objetos e “reconhecer” a imagem pelo número incluído nos metadados na planilha (1- Fotografia Frente e 2-Fotografia, Verso, Lateral direita, Lateral esquerda e Outros)? Ou o que recomendaria? Obrigada!

[mateus.m.luna]

Olá @Barbara_Freire!

Pelo número não porque este é um conceito de vocês, o plugin não vai saber relacionar ele. Mas ele vai saber relacionar se vocês importarem antes os documentos usando os campos descritos na planilha acima (`special_document` e `special_attachments`). Em algum momento este “mapeamento” precisa ser feito, nem que seja na linha da planilha, entende? O que eu recomendaria seria tentar este procedimento:

@mateus.m.luna

Agora caso estejamos falando de centenas de itens, o melhor caminho é enviá-los primeiro para algum local online. Isso pode ser um servidor FTP ou mesmo seu próprio WordPress via galeria de mídias, desde que depois você se lembre de apagar eles. Nas colunas special_document para a frente (se lembrando neste caso do prefixo file:) e special_attachments para o verso. Você irá colocar a URL pública para estes arquivos nestas colunas. Daí sim pode realizar a importação já com os dados direto via importador CSV.

A `special_attachments` pode receber várias fotos, inclusive as laterais, não só a de fundo. Neste caso você separaria as URLs por “|”. Vocês tem alguma dúvida sobre como seria o funcionamento dele?

[Barbara_Freire]

Na comunidade teria um passo a passo ou texto de orientação para me auxiliar?

[andre_benedito]

Olá, Barbara_Freire, não temos um passo a passo formal para esse processo, mas vou descrever aqui uma forma de fazer. Caso você tenha dúvidas em alguma das etapas, podemos seguir conversando e ajustando juntos. Se puder, envie também alguns links de exemplo conforme for montando, e a própria planilha que você estiver usando — isso ajuda bastante na validação.

Vamos lá, passo a passo.

1. Primeiro, exporte a base atual do Tainacan. Essa exportação é importante para recuperar o special_item_id de cada item e a sigla. A sigla será utilizada para cruzar com o endereço da foto. O campo special_item_id é o que informa ao sistema que a planilha não está criando novos itens, mas atualizando itens que já existem.

2. Suba suas imagens via FTP para uma pasta pública do seu WordPress. Um caminho comum é /wp-content/uploads/. Dentro dela, você pode criar uma pasta com o nome do projeto, por exemplo: /wp-content/uploads/nomedoprojeto/nomedoarquivo.jpg.

Como a URL raiz do site é padrão, você pode remontar os links na planilha combinando o endereço base com o nome do arquivo. Normalmente, o WordPress organiza automaticamente em /uploads/ano/mês/, então, ao subir várias imagens, você já consegue prever esse padrão (por exemplo: /wp-content/uploads/2025/12/nomedoarquivo.jpg).

Um ponto importante é testar essas URLs antes de montar a planilha. Após subir as imagens, acesse diretamente os links no navegador para verificar se estão funcionando corretamente. Isso evita erros na importação.

Se não tiver acesso ao FTP ou não souber utilizá-lo, você pode subir as imagens pela própria interface do WordPress. Nesse caso, recomenda-se apagar depois para evitar duplicações desnecessárias. Após o upload, copie o endereço das imagens na Biblioteca de Mídia.

Exemplo de URL:
http://biologiavegetal.com.br/wp-content/uploads/2025/12/nomedoarquivo.jpg

Com os endereços das imagens em mãos, você pode montar a planilha de atualização mantendo:

special_item_id de cada objeto, para que o Tainacan entenda que se trata de uma atualização
special_document com file: seguido da URL, que define a imagem principal
special_attachments para os anexos; caso haja mais de uma imagem, separar por ||

Exemplo de special_attachments:
http://biologiavegetal.com.br/wp-content/uploads/2025/12/pkmuza-007B-003-371_2.jpg||http://biologiavegetal.com.br/wp-content/uploads/2025/12/pkmuza-007B-003-371_3.jpg||http://biologiavegetal.com.br/wp-content/uploads/2025/12/pkmuza-007B-003-371_4.jpg

3. De posse da planilha, você pode realizar a atualização dos dados em Importar itens (importar itens de fontes externas), seguindo o mesmo fluxo utilizado na importação inicial. Como a planilha contém o special_item_id e os campos special_document e special_attachments, o Tainacan irá interpretar que se trata de uma atualização de itens existentes, e não da criação de novos itens.

Recomenda-se testar primeiro com um número pequeno de itens. Se quiser, você pode compartilhar a planilha aqui para avaliarmos juntos antes de rodar a importação completa.