Como criar uma chave API do Yelp para o plugin «Reviews», desde a criação de uma conta de programador no Yelp até à cópia da chave.
Gostaria que as suas avaliações do Yelp fossem atualizadas com mais frequência ou que fossem apresentadas mais de cinco fontes do Yelp?
Neste guia, vamos mostrar-lhe quando precisa de uma chave API do Yelp, como criá-la e como adicioná-la ao Reviews Feed. Basta ter uma conta no Yelp e um plano para a API Places do Yelp.
Antes de começar, certifique-se de que a versão mais recente do Reviews Feed está instalada e ativada no seu site WordPress.
- Precisa de uma chave API do Yelp?
- Criar a sua chave API do Yelp
- Adicionar a chave ao feed de comentários
- Perguntas mais frequentes
Precisa de uma chave API do Yelp?
A chave API é opcional. Os teus feeds do Yelp funcionam mesmo sem ela.
Para ligar uma fonte do Yelp, basta o link para a página da empresa no Yelp. O Reviews Feed estabelece então a ligação ao Yelp por si. Devido aos preços da API do Yelp, as suas avaliações do Yelp são atualizadas uma vez por semana.
Quando adiciona uma fonte do Yelp sem uma chave, o Reviews Feed confirma a programação semanal logo após a adição da fonte.

Ao adicionar a sua própria chave, ocorrem duas alterações:
- Atualizações mais rápidas: as tuas avaliações no Yelp são atualizadas com uma frequência superior a uma vez por semana.
- Mais fontes: pode ligar mais de cinco fontes do Yelp.
Na versão paga do Reviews Feed, pode ligar até cinco fontes do Yelp sem uma chave. Quando tenta adicionar uma sexta, o Reviews Feed indica o limite e sugere que adicione uma chave.

Na versão gratuita do Reviews Feed, pode ligar uma fonte sem necessidade de uma chave, do Google ou do Yelp. O Reviews Feed obtém as dez últimas avaliações dessa fonte uma única vez. Para obter mais avaliações, ou para as obter novamente, adicione uma chave API ou atualize para uma licença paga.
As fontes do Google têm o seu próprio limite e utilizam a sua própria chave. Se também apresentar avaliações do Google, consulte o nosso guia sobre como criar uma chave da API do Google.
Se a atualização semanal for adequada para o seu site e se apresentar cinco ou menos fontes do Yelp, não precisa de nenhuma chave. O nosso guia sobre como utilizar as avaliações do Google e do Yelp sem uma chave API aborda os limites aplicáveis.
Se pretender atualizações mais frequentes ou mais de cinco fontes do Yelp, a secção seguinte explica-lhe como criar uma chave.
Criar a sua chave API do Yelp
Para começar, vamos criar a sua chave no site de programadores do Yelp. Os passos abaixo seguem o próprio guia do Yelp, intitulado «Yelp Places Authentication».
O Yelp atribui-lhe uma chave quando cria uma aplicação para a sua API Places. Primeiro, escolha um plano que se adapte às suas necessidades.
O Yelp cobra pela utilização da API. A sua página «Yelp Places API» apresenta os planos e preços atuais.
Em seguida, preencha o formulário de criação de uma nova aplicação com as informações relativas à sua aplicação. Depois, aceite os Termos de Utilização e os Requisitos de Exibição da API do Yelp. Por fim, clique em «Enviar».
O Yelp mostra agora a tua chave API. Também a podes encontrar mais tarde na página «Gerir Aplicação» do Yelp. Como vais precisar dela no teu site WordPress daqui a pouco, copia-a.
Nota: Trate a sua chave API como uma palavra-passe e não a partilhe publicamente. Se alguma vez for divulgada, clique em «Atualizar a minha chave API» na página «Gerir aplicação» para a substituir por uma nova.
É tudo o que precisas do Yelp. A seguir, volta ao teu site do WordPress.
Adicionar a chave ao feed de comentários
Pode adicionar a sua chave na página «Definições do Feed de Avaliações» ou diretamente na janela de limite da fonte mencionada anteriormente. Ambas as opções guardam a mesma chave.
Assim que a chave for guardada, os teus feeds do Yelp passarão a utilizá-la. São atualizados com uma frequência superior a uma vez por semana. Também podes ligar mais de cinco fontes do Yelp.
A mesma chave aplica-se a todas as fontes do Yelp no plugin. Não será necessário introduzi-la novamente para cada fonte que adicionar.
Primeiro, vamos adicionar a chave na página «Definições».
Adicionar a chave nas definições
No painel de controlo do WordPress, aceda a Feed de comentários » Definições.

No separador «Geral», desça até à secção «Gerir chaves API». Em seguida, clique no ícone do lápis no cartão do Yelp.

Na janela que se abre, cole a sua chave no campo. Em seguida, clique em «Atualizar» para a guardar.

O Reviews Feed verifica a chave à medida que a guarda. Se o Yelp não aceitar a chave, o Reviews Feed não a guarda e indica que a chave é inválida. Nesse caso, copie novamente a chave do Yelp. Em seguida, cole-a no campo.
As suas chaves do Google e do TripAdvisor devem ser introduzidas no mesmo local, tal como indicado na secção «Gerir chaves API» da nossa referência de definições.
A secção seguinte mostra como adicionar a mesma chave a partir da janela de limites de origem.
Adicionar a chave a partir da janela «Limite de origem»
Se atingir o limite de cinco fontes ao adicionar uma fonte do Yelp, não precisa de sair da janela.
Na janela «Limites», clique em «Adicionar uma chave API», conforme ilustrado acima.
A janela «Adicionar chaves API» abre-se. Na linha «Yelp», cole a sua chave no campo. Em seguida, clique em «Adicionar».

O Feed de Avaliações verifica esta chave da mesma forma. Não guarda uma chave que o Yelp recuse.
E pronto! Agora já sabes quando precisas de uma chave API do Yelp, como criá-la e como adicioná-la ao Feed de Avaliações. A seguir, consulta o nosso guia sobre como apresentar o teu feed de avaliações para tirares o máximo partido das avaliações no teu site.
Perguntas mais frequentes
A seguir, respondemos a algumas das perguntas mais frequentes sobre as chaves API do Yelp no Feed de Avaliações.
Preciso de uma chave API do Yelp para apresentar as avaliações do Yelp?
Não. Sem uma chave, o Reviews Feed liga-se ao Yelp por si e atualiza as suas avaliações do Yelp uma vez por semana. Só precisa de uma chave se quiser atualizações mais frequentes ou mais de cinco fontes do Yelp.
Porque é que não consigo adicionar outra fonte do Yelp?
Na versão paga, pode ligar até cinco fontes do Yelp sem necessidade de uma chave. Na versão gratuita, pode ligar uma fonte no total. Para ligar mais fontes, crie uma chave API do Yelp. Em seguida, adicione-a ao Reviews Feed.
A chave da API do Yelp tem algum custo?
O Yelp cobra pela utilização da sua API Places. O preço depende do plano que escolher. Pode consultar os planos e preços atuais na página da API Places do Yelp.
Preciso de uma chave separada para as avaliações do Google?
Sim. O Reviews Feed mantém uma chave para cada plataforma. A sua chave do Yelp abrange apenas as fontes do Yelp. Para adicionar uma chave para o Google, consulte o nosso guia sobre como criar uma chave da API do Google.
Por que é que o «Feeds de Avaliações» indica que a minha chave API não é válida?
O «Reviews Feed» verifica a chave quando a guardas. Esta mensagem significa que a chave foi recusada. Copia novamente a chave a partir da página «Gerir Aplicação» do Yelp. Se atualizaste a tua chave no Yelp, a antiga já não funciona. Cola a nova, em vez disso.
O que acontece se o Yelp deixar de aceitar a minha chave?
O feed de avaliações apresenta um erro relativo a essa fonte. O seu feed continua a mostrar as avaliações que já foram guardadas. Para resolver este problema, verifique a sua aplicação na página «Gerir Aplicação» do Yelp. Em seguida, adicione a sua chave atual no lugar da antiga.