Configure chaves de API para acessar bibliotecas de imagens e vídeos gratuitos diretamente no editor de blocos do WordPress.
Visão geral
O ZenBlocks permite que você busque e insira mídias de serviços externos sem sair do editor. Para isso, é necessário configurar chaves de API para cada serviço que você deseja utilizar.
O que é uma chave de API
Uma chave de API (API key) é um código de autenticação exclusivo que permite ao ZenBlocks se comunicar com serviços externos de mídia. Cada serviço exige sua própria chave, que você obtém ao se cadastrar na plataforma do serviço.
Serviços compatíveis
| Serviço | Tipo de mídia | Licença | Cadastro necessário |
|---|---|---|---|
| Unsplash | Imagens | Gratuita (com atribuição) | Sim |
| Pexels | Imagens e vídeos | Gratuita (CC0) | Sim |
| Pixabay | Imagens e vídeos | Gratuita (CC0) | Sim |
Diferenças entre os serviços
- Unsplash é focado em fotografias de alta qualidade. As imagens são gratuitas, mas exigem atribuição ao fotógrafo.
- Pexels oferece tanto imagens quanto vídeos. Todo o conteúdo é licenciado como CC0, sem necessidade de atribuição.
- Pixabay também disponibiliza imagens e vídeos com licença CC0, com um acervo amplo e variado.
Você pode configurar um ou mais serviços, conforme sua necessidade.
O que é CC0
CC0 (Creative Commons Zero) é uma licença que coloca a obra em domínio público. Isso significa que você pode usar, modificar e distribuir o conteúdo livremente, inclusive em projetos comerciais, sem necessidade de atribuição ao autor original.
Como configurar
- Acesse Configurações > ZenBlocks no painel do WordPress e selecione a aba API Settings.
- Escolha o serviço que deseja configurar (Unsplash, Pexels ou Pixabay).
- Acesse o site do serviço, crie uma conta de desenvolvedor e gere sua chave de API.
- Cole a chave de API no campo correspondente na aba API Settings.
- Clique em Save para salvar as configurações.
Relação entre imagens e vídeos
Alguns serviços, como Pexels e Pixabay, oferecem tanto imagens quanto vídeos com uma única chave de API. Ao configurar a chave, ambos os tipos de mídia ficam disponíveis automaticamente na busca do editor. O Unsplash oferece apenas imagens.
Pontos de verificação
Após concluir a configuração, confirme os seguintes itens:
- A chave de API foi salva sem erros na aba API Settings.
- A busca de mídia no editor retorna resultados do serviço configurado.
- As imagens e/ou vídeos são inseridos corretamente nos blocos.
Observações importantes
- Cada serviço possui limites de requisições por hora ou por dia. Consulte a documentação do serviço para conhecer os limites do seu plano.
- As chaves de API são armazenadas nas configurações do WordPress. Mantenha-as em segurança e não as compartilhe publicamente.
- Se você remover uma chave de API, as mídias já inseridas nos seus conteúdos não serão afetadas. Apenas novas buscas serão desabilitadas para aquele serviço.
Solução de problemas
- A busca não retorna resultados: verifique se a chave de API foi inserida corretamente e se não há espaços extras antes ou depois da chave.
- Erro de autenticação: acesse o painel do serviço e confirme que sua chave de API está ativa e não expirou.
- Limite de requisições atingido: aguarde o período de reset do serviço ou considere fazer upgrade no plano do desenvolvedor.
- Imagens não carregam no editor: verifique sua conexão com a internet e certifique-se de que o site consegue acessar URLs externas (sem bloqueio de firewall ou proxy).
Como escolher o serviço ideal
- Se você precisa de fotografias de alta qualidade e não se importa com atribuição, o Unsplash é uma excelente escolha.
- Se você busca imagens e vídeos sem necessidade de atribuição, o Pexels ou o Pixabay são ideais.
- Você pode configurar todos os serviços simultaneamente e alternar entre eles conforme a necessidade do seu projeto.