O diretório de blocos do WordPress: o guia essencial
Publicados: 2020-10-23O diretório de blocos do WordPress é uma nova maneira que os usuários do WordPress podem descobrir, instalar e testar blocos do WordPress de terceiros a partir do editor de blocos do WordPress. Introduzido no WordPress 5.5, o diretório de blocos do WordPress torna mais fácil encontrar o bloco do WordPress que melhor se adapta às suas necessidades.

Se você ainda não ouviu falar do diretório de blocos do WordPress, você não está sozinho. Neste guia, cobriremos tudo o que você precisa saber sobre o novo diretório de bloco. Também explicaremos como começar a usar o Block Director para agilizar seu fluxo de trabalho de conteúdo.
O que é o diretório de blocos do WordPress?
O WordPress Block Directory é uma categoria de plug-ins gratuitos do WordPress que fornecem blocos do WordPress de terceiros para uso no editor de blocos do WordPress.
O novo diretório de blocos do WordPress é integrado ao editor de blocos, para que você possa instalar novos tipos de blocos em seu site sem nunca sair do editor. O diretório de blocos é projetado para tornar mais fácil para os usuários pesquisar e instalar blocos do WordPress diretamente do editor de blocos, para que você possa adicionar rapidamente o tipo de bloco de que precisa ao seu conteúdo.
Para pesquisar o diretório de blocos do WordPress, use o ícone “+” no canto superior esquerdo da página para usar o novo insersor de bloco e pesquise os blocos disponíveis.

Aqui estão algumas coisas importantes a serem observadas sobre o diretório de blocos do WordPress:
- A funcionalidade de pesquisa de diretório de bloqueio está disponível apenas para funções de usuário do WordPress que têm permissão para adicionar ou instalar plug-ins.
- Se você adicionar um bloco de terceiros do diretório de blocos, o plug-in WordPress correspondente será instalado em seu site. Portanto, se você vir um novo plug-in instalado em seu site e não se lembrar de instalá-lo, verifique se o plug-in é um plug-in de bloco do WordPress.
- O diretório de blocos do WordPres puxa os blocos padrão embutidos do WordPress e plug-ins de blocos do WordPress de terceiros para que você possa instalá-los diretamente de seu editor de página / postagem.
- Os resultados da pesquisa de plug-ins de bloqueio de terceiros dependem de alguns requisitos que os desenvolvedores devem atender (abordados com mais detalhes posteriormente neste artigo).
História do diretório de blocos do WordPress
O diretório de blocos do WordPress é o resultado de discussões centrais do WordPress sobre como os plug-ins de bloco precisam ser diferenciados de outros plug-ins gratuitos disponíveis no diretório de plug-ins do WordPress.org.
O esforço do diretório de blocos do WordPress foi um esforço de desenvolvimento entre equipes que envolveu atualizações importantes em:
- Os processos de atualização do plugin do WordPress
- O repositório de plugins do WordPress
- Integração com o Inserter do editor de blocos do WordPress
A versão 8.4 do plugin Gutenberg WordPress em destaque foi quando o diretório de bloco foi mesclado com o núcleo do WordPress; em 11 de agosto de 2020 no WordPress 5.5.
O objetivo do diretório de blocos do WordPress
O novo diretório de blocos do WordPress é separado do diretório principal de plug-ins do WordPress.org, então você está navegando em plug-ins normais do WordPress ou plug-ins de bloco único.

O diretório de bloco é projetado para ajudar a distinguir os plug-ins de bloco, que são somente javascript e registram apenas blocos do WordPress, em comparação com os plug-ins tradicionais do WordPress que têm mais funcionalidade.
O que são blocos do WordPress?
Os blocos do WordPress são elementos de página que você pode usar no editor de blocos do WordPress para ajudar a organizar e projetar o conteúdo das postagens e páginas do seu blog. De imagens a citações a listas e incorporações de mídia, há um bloco WordPress para quase tudo.

Blocos padrão embutidos do WordPress
O WordPress vem com uma biblioteca de blocos padrão integrados. Aqui está uma tabela de alguns dos blocos mais usados. Esta tabela inclui alguns dos blocos padrão do WordPress incluídos no WordPress no novo editor de blocos.
Bloco WordPress | Descrição |
---|---|
Áudio | Incorpore um reprodutor de áudio simples. |
Botões | Promova conversões com botões bonitos. |
Categorias | Exibe uma lista de todas as categorias. |
Clássico | Use o editor clássico do WordPress |
Código | Exibir trechos de código que respeitem seu espaçamento e tabulações. |
Colunas | Adicione um bloco que exibe conteúdo em várias colunas e, em seguida, adicione os blocos de conteúdo que desejar. |
Cobrir | Adicione uma imagem ou vídeo com uma sobreposição de texto - ótimo para cabeçalhos. |
Embutir | Incorpore vídeos, imagens, tweets, áudio e outros conteúdos de fontes externas. |
Arquivo | Adicione um link para um arquivo para download. |
Galeria | Exiba várias imagens em uma galeria rica. |
Cabeçalho | Apresente novas seções e organize o conteúdo para ajudar os visitantes (e os mecanismos de pesquisa) a entender a estrutura do seu conteúdo. |
Imagem | Insira uma imagem para fazer uma declaração visual. |
Última postagem | Exibe uma lista de suas postagens mais recentes. |
Lista | Crie uma lista com marcadores ou numerada. |
Parágrafo | O bloco de construção de toda narrativa. |
Puxar citação | Dê um interesse visual especial a uma citação de seu texto. |
Citar | Dê ênfase visual ao texto citado. |
Mais | Adiciona um elemento “Leia mais” |
Separador | Crie uma pausa entre ideias ou seções com um separador horizontal. |
Código curto | Insira elementos personalizados adicionais com códigos de acesso do WordPress. |
Espaçador | Adicione espaço em branco entre os blocos e personalize a altura. |
Quando você faz o login em seu painel de administração (supondo que você está usando WordPress 5.0 ou superior) e clica para escrever uma nova postagem, você notará imediatamente um painel para edição de conteúdo baseado em bloqueios.
Anteriormente, esta seção de seu editor de postagem era um grande campo de conteúdo que continha controles de formatação de texto padrão.
Ao comparar a versão antiga do editor com a nova versão baseada em bloco, esta foi uma grande atualização para os usuários.
A experiência geral de edição na nova versão é muito mais simplificada e livre de distrações. Dá a você uma visibilidade clara da sua “tela” principal, sem outros elementos que eram quase sempre desnecessários.
O que é um plugin de bloco do WordPress?
UMA Plug-in de bloco do WordPress é um plug-in WordPress relativamente pequeno e simples que fornece um único bloco WordPress. O plugin é o bloco, essencialmente.
O diretório de blocos do WordPress ajuda a organizar os plug-ins de blocos de terceiros em uma categoria separada dos plug-ins tradicionais do WordPress para que sejam mais fáceis de pesquisar e instalar.
Como você usa blocos WordPress?
Ao começar a trabalhar em um novo conteúdo para o seu site, seja uma nova página ou uma postagem de blog, você perceberá que cada parte do conteúdo incluído (como uma imagem ou um parágrafo de texto) é convertido em seu próprio bloco.
Basicamente, você pode pensar em um bloco como um invólucro que é colocado ao redor de cada parte do conteúdo que você inclui em sua postagem ou página. Mas o sistema de bloqueio não muda nada sobre as peças de conteúdo individualmente, ou como elas aparecem em seu site. Uma imagem ainda é uma imagem e não parece diferente para o usuário final.

Você descobrirá que criar conteúdo com blocos é altamente intuitivo. Quando você começa a criar uma nova página ou postagem, o WordPress o convida a escolher o tipo de bloco ou começar a escrever um texto.
Ao completar um parágrafo de texto, pressione Enter e o WordPress fará a transição automaticamente para um novo bloco.
Quando você quiser adicionar um bloco diferente além de um parágrafo de texto, basta clicar no ícone “+”, localizado dentro do editor de bloco no canto superior esquerdo.
Cada tipo de bloco disponível para você escolher é altamente personalizável de várias maneiras. Com um pouco de tempo e experimentação, você será capaz de fazer com que qualquer bloco fique exatamente como você imaginou.
Benefícios do Editor de Bloco
A introdução do editor baseado em bloco trouxe uma série de benefícios para os criadores de conteúdo do WordPress.
Primeiro, você pode reorganizar seus blocos com muito mais facilidade em cada página do que o editor anterior permitia. Cada bloco possui controles individuais que permitem mover o bloco para cima ou para baixo em um ponto. Você também pode usar a função arrastar e soltar para mover os blocos manualmente.
Nos editores anteriores do WordPress, mover o conteúdo era uma dor. Primeiro, você tinha que cortar e colar o conteúdo nas áreas em que queria colocá-lo. Freqüentemente, fazer isso causava muitos problemas de formatação; embora mais com alguns editores de texto do que com outros. Às vezes, os usuários perdiam seções inteiras de conteúdo antes de movê-las, porque acidentalmente as copiavam para a área de transferência.

Esses não são problemas que você enfrentará com bloqueios e também são muito mais fáceis de manobrar.
Como faço para usar o diretório de blocos do WordPress?
Agora que discutimos o que são blocos do WordPress, vamos dar uma olhada no novo diretório de blocos do WordPress.
A ideia por trás do diretório de blocos não é tão complicada. Mas é altamente útil para desenvolvedores e designers de sites, uma vez que eles entendam como utilizar a ferramenta de maneira adequada.
Quando um usuário do WordPress deseja usar um bloco que não está disponível nos blocos padrão do WordPress disponíveis localmente em seu editor, ele pode acessar o campo de pesquisa do Inserter e digitar uma palavra-chave, como “menu” ou “equipe”.

Nos bastidores, o sistema intuitivo primeiro executa uma pesquisa no site local do usuário. Se não conseguir encontrar o bloco específico que está sendo pesquisado, ele começa a pesquisar o diretório do bloco: uma parte designada do repositório geral de plug-ins do WordPress que hospeda plug-ins de bloco único.

Quando o sistema encontra blocos que correspondem ao termo de pesquisa atual, esses blocos são exibidos no Inserter, com uma seção de visualização disponível para o usuário revisar.
Neste ponto, o designer decide qual bloco deseja utilizar e, a seguir, clica no botão “Adicionar Bloco”. Isso faz com que um plugin de bloco único seja instalado e ativado, enquanto o designer continua criando a postagem ou página.
Se a seleção do primeiro bloco não foi a melhor escolha, o usuário pode voltar e procurar um bloco diferente que também pode ser instalado. Isso permite aos usuários uma maneira rápida e fácil de testar diferentes elementos de bloco em seus projetos.
Lembre-se de que o diretório de bloqueio só pode ser acessado por criadores de conteúdo que tenham todos os direitos e privilégios do site para instalar e ativar plug-ins do WordPress.
Procurando por blocos do WordPress
A função de pesquisa funciona muito bem. O único problema é a falta de plug-ins no repositório. É importante lembrar que o diretório de blocos ainda é muito novo e sua funcionalidade geral não foi finalizada.
Os designers Steven Dufresne e Enrique Sanchez (junto com outros) têm explorado ativamente diferentes considerações e variações do fluxo de pesquisa, seleção e instalação de plug-ins de bloco dentro do editor.

Por exemplo, o que acontece quando um usuário executa uma pesquisa e um plugin de bloco aparece no Inserter que o usuário já instalou em seu editor? Deve exibir “Desativar bloco” para esse resultado de pesquisa específico?
E se o resultado da pesquisa exibir um plugin de bloqueio que o usuário instalou, mas desativou? Deve exibir “Ativar bloco” para este resultado?
Como você pode ver, há muitas perguntas que permanecem no ar em relação às buscas em blocos e como elas são realizadas.
A discussão continua com os designers e desenvolvedores.
Fatores de desempenho de pesquisa de diretório de blocos do WordPress
Para que o diretório de blocos do WordPress funcione, existem vários fatores que precisam estar perfeitamente alinhados.
Primeiro, o diretório deve ter uma seção exclusiva designada apenas para plug-ins de bloco único para preencher a pesquisa. Existem muitos plug-ins com dois ou mais blocos que não podem ser exibidos no feed de pesquisa do diretório de bloco.

Depois disso, o recurso de pesquisa de diretório deve retornar seus resultados em um formato que pode ser exibido no Inserter.
O editor de bloco deve então executar um processo que pesquisa o diretório do plug-in do WordPress por meio da API REST. Em seguida, o Inserter requer um método que permitirá a instalação e ativação de plug-ins do site.
Para fazer isso, ele deve ser capaz de considerar os privilégios de site do usuário atual. Apenas os administradores do site podem instalar e ativar plug-ins.
WordPress Block Directory Search Results: Requisitos
Para que um autor de plug-in faça parte do diretório de blocos, ele deve fornecer um arquivo block.json e uma imagem a ser exibida nos resultados da pesquisa. Também é importante que os autores de plug-ins lembrem que os usuários precisarão de informações adicionais sobre o plug-in, na área de visualização, antes de decidirem fazer o download.
Na maioria dos casos, o usuário desejará ver um plugin:
- Avaliações do usuário
- Informação sobre o autor
- Data da última atualização do plugin
Isso ajuda a impulsionar o processo de tomada de decisão dos usuários que tentam decidir quais blocos usar em seu site. Afinal, muitas pessoas não decidem as coisas com base apenas em sua aparência. Eles também querem saber o que está por baixo do capô.
Para o editor de blocos, seria uma boa ideia (embora seja uma proposição extremamente difícil que sem dúvida exigirá muitos ajustes posteriores) monitorar automaticamente os plug-ins descartados e certificar-se de que os blocos não utilizados sejam desinstalados do site após salvar o publicar.
Também é importante evitar a possibilidade de um “cemitério de blocos” dentro do local. Com um Block Manager atualizado, este problema deve ser resolvido. Ele foi falado no ano passado por Mel Choyce-Dawn como parte dos designs de diretório de bloco inicial. Mas não fez parte do lançamento inicial.
Lista de plug-ins de bloco único do WordPress
Se você for ao repositório de plug-ins do WordPress, poderá navegar pelos plug-ins de blocos do WordPress que alimentarão seus resultados de pesquisa no editor de blocos do WordPress.
No momento da redação deste artigo, havia apenas seis páginas de resultados disponíveis para navegar. E, na realidade, apenas cerca de metade dos que aparecem na pesquisa do repositório de plug-ins estarão realmente visíveis no editor de bloco por meio do Inserter.
Com uma verificação rápida, parece que muitos deles estão perdendo completamente os arquivos block.json necessários. Nesses casos, os plug-ins não estarão visíveis nos resultados de pesquisa do editor de blocos do WordPress, mas você os verá no repositório de plug-ins do WordPress.
Isso parece estar melhorando no último mês, no entanto, à medida que os requisitos finais foram documentados de forma mais completa e as principais diretrizes publicadas. Muitos outros autores de plug-ins estão começando a atualizar seus plug-ins para garantir que sejam 100% pesquisáveis no editor de bloco.
Alguns exemplos de plug-ins de bloco único atuais totalmente testados no diretório de bloco incluem:
- Bloco de eventos por Automattic
- Bloqueio de perfil de usuário por Ham.works
- Apple Maps bloco por 10up
- Bloco de login TWST
TWST é um plugin de bloco único simples, mas genial, que permite inserir um formulário de login em qualquer lugar em um post ou página.
Como instalar novos blocos de WordPress
O processo de instalação em bloco deve ser contínuo e intuitivo para o usuário. Pelo menos deveria ser em teoria.
Basicamente, tudo o que o usuário precisa fazer é clicar no botão “Adicionar bloco” sem nunca sair do editor de bloco. O novo bloco desejado torna-se imediatamente disponível.

Você provavelmente descobrirá que, em alguns casos, receberá uma mensagem de erro que solicitará que você tente instalar novamente. Mas antes de fazer isso, certifique-se de verificar se o plugin realmente foi instalado e se o bloco está disponível para uso.
Em muitos casos, parece que a mensagem de erro é, por si só, um erro e o bloco está pronto para ser executado. Conforme o tempo passa, mais desses pequenos bugs serão resolvidos e esse novo recurso útil chamado diretório de blocos do WordPress estará funcionando perfeitamente.
Diretrizes do autor do plugin de diretório de bloco
Perto do final de 2019, o líder da equipe Meta Alex Sheils publicou um rascunho inicial das diretrizes de plug-in de bloco do WordPress para quem deseja ter um plug-in adicionado ao diretório de bloco. Desde então, foi atualizado com requisitos mais detalhados apenas alguns meses atrás.
Para resumir os pontos-chave, os plug-ins no diretório do bloco devem ter estas características específicas:
- Contém apenas um único bloco
- Não tem IU fora do editor de postagem
- Tenha uma quantidade mínima de código do lado do servidor
- Deve ser estruturado de acordo com certas especificações e incluir um arquivo readme.txt
Algumas regras adicionais que governaram o primeiro lançamento do diretório de blocos foram recebidas com alguma controvérsia pelos autores de plug-ins, devido ao quão rígidas as regras eram. No entanto, as restrições no diretório não tinham como objetivo sufocar os criadores de plug-ins.
O objetivo é manter os tipos de blocos que retornam ao editor de blocos restritos a um protocolo e tipo específicos.
Isso foi especialmente importante no lançamento inicial, onde não era um caso em que mais resultados seriam melhores. Os resultados precisam ser muito específicos dentro do Inserter.
Sabendo disso, essas regras adicionais se aplicam a todos os autores de plug-ins que desejam obter seu plug-in no diretório de blocos do WordPress:
- Plug-ins de bloco são criados para usar no Editor de bloco
- Os plug-ins de bloco devem ser blocos separados
- O título do plugin deve refletir o título do bloco
- O plugin deve incluir um arquivo block.json específico
- O autor do plugin não pode cobrar uma taxa ou exigir o pagamento pela funcionalidade. Contas pagas também não são permitidas
- O plugin deve ser capaz de funcionar de forma independente
- Não pode, de forma alguma, promover outros plug-ins, temas ou blocos
Pense no diretório de blocos como uma planta imatura que você acabou de colocar no solo. Você sabe que precisa vigiá-lo e protegê-lo para que cresça e se torne uma versão maior e melhor de si mesmo.
O diretório do bloco não é diferente.
À medida que a equipe de design e desenvolvimento continua a observar, ouvir e resolver problemas, o diretório começará a evoluir para um lugar onde os autores e usuários de plug-ins encontram muito valor.
Se você é um autor de plug-in e seu plug-in ainda não atende aos requisitos para estar no diretório de bloco, lembre-se de que ele ainda é bem-vindo no diretório normal de plug-ins do WordPress.
O futuro do diretório de blocos do WordPress
O diretório de blocos tem o potencial de realmente estender a funcionalidade de design da plataforma WordPress. Ele oferece aos criadores de conteúdo uma maneira rápida e simplificada de estender seus recursos de criação de conteúdo com acesso na ponta dos dedos a dezenas de blocos únicos úteis.
Mesmo com as partes em movimento contínuo, o primeiro lançamento do diretório de blocos é um marco importante que deve ser celebrado pelos criadores de conteúdo e autores de plug-ins.
Aqueles de vocês que estão lendo isto na época de sua publicação estão na vanguarda do diretório de blocos e no que ele se tornará. Agora é um ótimo momento para você considerar algum treinamento adicional do WordPress que mostrará outras áreas do WordPress, como o diretório de blocos, que você ainda não descobriu.
Com tudo no lugar, seu site pode continuar a crescer e evoluir, assim como o diretório de blocos do WordPress.
Kristen tem escrito tutoriais para ajudar os usuários do WordPress desde 2011. Normalmente, você pode encontrá-la trabalhando em novos artigos para o blog do iThemes ou desenvolvendo recursos para o #WPprosper. Fora do trabalho, Kristen gosta de fazer um diário (ela escreveu dois livros!), Fazer caminhadas e acampar, cozinhar e aventuras diárias com sua família, na esperança de viver uma vida mais presente.
