O Guia Completo para o WordPress códigos de acesso
antes do editor de bloco WordPress, os códigos de acesso WordPress foram uma das melhores coisas para atingir o editor WordPress para tornar mais fácil adicionar plugin e funções de tema para páginas, posts e outras seções de um site WordPress.
Com a mudança para o editor de bloco, o que isso significa para a maioria dos plugins mais antigos e sites que ainda estão cheios de códigos de acesso? Será Que os códigos de acesso WordPress ainda funcionam? Há uma maneira de se mover facilmente de usar códigos de acesso WordPress para blocos WordPress? vamos descobrir. Neste guia, vamos explorar códigos de acesso WordPress na era do editor de bloco WordPress.
o Que São Shortcodes do WordPress?
um shortcode WordPress é um bit reusável e dinâmico de código enrolado em . Os códigos de acesso permitem que você insira facilmente funções específicas do WordPress em si ou de um plugin ou tema em qualquer post, página, Tipo de post personalizado ou widget. Pense em códigos WordPress como “atalhos” ou como macros em seu site.
Você pode usar códigos de acesso WordPress para exibir conteúdo estático que é muito tedioso para manter a codificação e repetição. E você também pode usar códigos de Acesso para exibir conteúdo dinâmico, como galerias de imagens, Leitores de áudio para podcasts, calendários de eventos ou mudanças estatísticas para certos dados.
Shortcode Formato
Quando se trata de inserir códigos de acesso, o formato básico pode ser estendido de várias formas, permitindo-lhe personalizar ou adicionar informações de definições de chamadas de atributos. Além disso, atalhos podem embrulhar texto (ou HTML) ou até mesmo ser aninhado dentro de outro shortcode.
Por exemplo, um shortcode pode ter os seguintes formatos:
Some text
<a href="http://mysite.com/">HTML content</a>
Some text more text
This is a custom icon
Shortcode Atributos
códigos de acesso são também flexíveis, pois eles podem ser estendidas através de atributos. Com atributos, os códigos de acesso oferecem personalização adicional simplesmente adicionando excertos de código extra dentro do shortcode.
Plugins e temas oferecem guias e rubricas extras para ajudar os usuários a usar os excertos de códigos curtos corretos para adicionar ou remover certos elementos na saída.
Aqui estão alguns exemplos de códigos de acesso com atributos.
]
Posts Heading
Built-in Shortcodes do WordPress
o WordPress vem com vários built-in shortcodes para o processamento de determinados tipos de conteúdo.
]
o código de áudio permite-lhe incorporar ficheiros de áudio e reproduzi-los de volta.
]
usado principalmente com imagens individuais, o código de Legendas permite que você enrole as legendas em torno do conteúdo.
]
o shortcode da galeria permite adicionar uma ou mais galerias de imagem às suas publicações e páginas.
]
o código curto embutido permite-lhe embrulhar itens incorporados com uma largura e altura máxima (mas não fixa).
]
o shortcode da lista de reprodução implementa a funcionalidade de exibir uma coleção de arquivos de áudio ou vídeo WordPress em uma postagem.
]
o shortcode vídeo permite-lhe incorporar ficheiros de vídeo e reproduzi-los de volta.
Plugin & Tema de códigos de acesso
Específico de temas do WordPress e plugins shortcodes para a direita fora da caixa que você pode inserir no post ou página do editor e vai renderizar o resultado no front-end. Até esta data, muitos temas e plugins ainda estão usando códigos de acesso.
Por exemplo, os códigos de acesso são frequentemente usados em plugins comuns para calendários, formulários, tabelas, adesões, cronómetros de contagem decrescente ou citações. Mesmo plugins shortcode existem que permitem que você crie códigos de Acesso para qualquer coisa.
temas WordPress também podem utilizar códigos de Acesso para tornar determinado conteúdo dinâmico que é pré-estilizado ou fornecido por eles.
códigos de acesso personalizados
a maioria dos desenvolvedores especialistas optam por criar seus próprios códigos de acesso, essencialmente reduzindo o tempo que leva para codificar algo que é repetitivo. Basta um arquivo adicional simples em seu diretório de arquivos para criar os códigos de acesso personalizados.ficheiro php. Se você quiser aprender as cordas de códigos de acesso personalizados, aqui está um guia sobre a criação de códigos de acesso personalizados.
O WordPress Shortcode API
Para os desenvolvedores criarem suas próprias shortcodes, o WordPress Shortcode API fornece um simples conjunto de funções para a criação de WordPress shortcodes para usar em posts e páginas.
a API Shortcode ajuda os desenvolvedores de plugins a criar conteúdo dinâmico que os usuários podem adicionar às páginas ou posts, adicionando o código short correspondente na área de conteúdo. Felizmente, a API lida com toda a análise complicada, eliminando a necessidade de escrever uma expressão regular personalizada para cada shortcode. Além disso, funções auxiliares são incluídas para definir e obter atributos de shortcode padrão.
os Desenvolvedores podem o WordPress Shortcode documentação da API para saber mais sobre:
- Manipulação de atributos
- Saída
- Encerrando vs auto-fechamento de códigos de acesso
- referência de Função
- Limitações
- sintaxe Formal
códigos de acesso no Clássico Editor
No passado, códigos de acesso que foram inseridos no clássico editor de qualquer post ou página, como este:
o Que São WordPress Blocos?
Os códigos de acesso foram os primeiros … mas depois veio a edição em bloco. Com a introdução do WordPress 5.0 veio a implementação do editor Gutenberg há muito planejado ou editor de bloco WordPress como a página principal e editor de post para o WordPress, substituindo o editor clássico WordPress baseado em texto que tem sido em torno de anos.
aqui está um olhar para o editor de conteúdo antes do WordPress 5.5 (ah, esses foram os dias!)
O editor de Gutenberg foi anunciado pela primeira vez em versões anteriores do WordPress, mas permaneceu opcional até WordPress 5.0 quando ele se tornou o editor padrão.
não há nada inerentemente errado com o novo editor bloqueado. Na verdade, a maioria dos usuários como o melhorado e mais limpo, menos intimidante, olhar para a parte de trás do WordPress.
Mas com o WordPress editor de bloco veio WordPress blocos. Longe estão as opções de formatação no topo que são reminiscentes de aplicações de processamento de texto como o Microsoft Word. Em vez disso, as opções de formatação foram substituídas pelas opções da barra lateral direita para cada bloco.
o WordPress blocos são, essencialmente, o conteúdo dos recipientes. Há muitos blocos diferentes para diferentes tipos de conteúdo—imagens, vídeos, textos, cabeçalhos, galerias—você o nome.
Há até um bloco WordPress para formatação, espaçador e divisor, e eles são casualmente dispostos em categorias para fácil acesso.
Todas as opções e controles que estavam no topo agora residem no lado direito da página/editor de postagem, com abas na parte superior, indicando, se você quiser ver as opções para o bloco atual sozinho ou todo o documento.
O editor de blocos é mais fácil e rápido e mais fácil de usar. Além disso, os desenvolvedores de temas e plugins também estão fazendo seus próprios blocos que adicionam mais opções de bloco para os blocos WordPress padrão.
Reutilizáveis Blocos vs. Shortcodes
A antiga maneira de salvar um conjunto de saída pré-definida no WordPress clássico editor, foi através da criação de seus próprios códigos de acesso. Este método foi substituído por blocos reutilizáveis.
a capacidade de salvar blocos pré-definidos e pré-personalizados também tornou mais fácil para salvar o layout e design de um determinado bloco e usá-lo em outro. Muito parecido com um modelo de página.
Por exemplo, se você adicionar um bloco de botão e Estilo-lo com uma determinada cor, efeitos de hover, etc., você não gostaria de continuar fazendo isso em cada página que você adiciona esse botão. Se você alterá-lo para um bloco reutilizável, o botão é salvo em seu site WordPress e se torna seu próprio bloco que você pode usar em outras páginas ou posts.
pode também actualizar estes blocos convertendo-os em blocos regulares, gravando-os como um novo (com um novo nome), ou actualizando o desenho existente do bloco.
Blocos de Grupo
No WordPress 5.3 veio também a introdução de blocos de grupo e modelos.
essencialmente, é-lhe dada a capacidade de agrupar certos blocos juntos e movê-los ou atualizá-los todos juntos. Isto eventualmente deu origem a padrões de blocos. Padrões de bloco tornaram a edição de conteúdo mais fácil, uma vez que os usuários preferem escolher um padrão, e atualizar o conteúdo em vez de começar a partir de uma tela em branco.
opções de estilo em bloco
com cada tema vem diferentes opções de estilo. E normalmente o estilo do conteúdo que você adiciona em cada site é predeterminado pelo seu tema.
com o editor de blocos, você tem a opção de atualizar o estilo de cada bloco individualmente, tanto para se destacar, ou para torná-los mais visíveis.
blocos & Edição Completa do Site
com todos estes avanços e mudanças na forma como criamos e construímos páginas sobre WordPress vem a ideia e eventual transição para o que é chamado de Edição Completa do Site.
na pasta, a maioria dos usuários só poderia atualizar o corpo real de um post ou página. Alguns aspectos do site, como o cabeçalho, rodapé, barras laterais e widgets, ainda dependem em grande parte do tema. Isso, é claro, fez à procura do tema perfeito com a quantidade certa de opções a luta final para os desenvolvedores e usuários do WordPress.
com a Edição Completa do Site e a introdução do Construtor de blocos, a tendência é fazer tiquetaque para tornar todas as seções de uma página ou pós editáveis, de uma forma, usando blocos.
Por exemplo, o mais recente vinte WordPress tema segue Este padrão, dando aos criadores e proprietários de sites um maior controle sobre o seu site e como eles gostariam que ele fosse.
olhando para a frente, plugin e desenvolvedores de temas terá que adotar uma abordagem diferente ao desenvolver seu software para se adaptar à nova edição completa do site e experiência de construção de páginas do editor de blocos WordPress. Enquanto a aplicação completa disto ainda está no horizonte, é uma mudança positiva que provavelmente veremos mais cedo do que mais tarde.
o novo bloco de código Short
antes do editor de blocos, códigos shortcodes foram inseridos diretamente na página ou editor de páginas. Agora, o editor de bloco WordPress inclui um novo bloco de código curto.
O bloco de código curto torna mais fácil continuar a usar códigos de acesso legados dentro de uma mensagem ou página e mantém a integridade da saída de código curto. Nota: Inserir um shortcode em um bloco de parágrafo pode nem sempre funcionar, então você pode precisar usar o bloco de shortcode em vez disso.
o bloco de código curto pode ser adicionado a uma página ou post, clicando no botão Adicionar Bloco. Alternativamente, você pode digitar / shortcode e pressione enter.
Você vai notar que ao contrário de outros blocos comuns, o shortcode bloco não inclui quaisquer definições específicas no bloco da barra de ferramentas ou editor da barra lateral, provavelmente devido ao fato de que os códigos de acesso podem ser personalizadas usando seus atributos.
o que significa o editor de bloco para os códigos de acesso WordPress?
o editor de bloco WordPress tem grandes implicações para os códigos de acesso. Vamos cobrir algumas das coisas mais importantes a notar sobre os códigos de acesso WordPress na era do editor de bloco.1. O editor de bloco WordPress muda fundamentalmente a necessidade e propósito dos códigos de Acesso para a maioria dos Plugins e temas. Com um sistema de edição baseado em blocos, cada “elemento” na página tem seu próprio bloco, ao invés de ser contido em um editor editável WYSIWYG.
porque o editor de blocos é uma abordagem totalmente diferente para compor uma publicação ou página, As partes mais dinâmicas de uma página que são geradas por códigos de acesso podem existir como blocos que podem ser adicionados individualmente.2. Blocos podem agora tomar o lugar da maioria dos códigos de acesso, removendo a necessidade de os usuários aprenderem a usar códigos de acesso. O conceito e o formato dos códigos de acesso podem ter uma curva de aprendizagem íngreme para alguns usuários, de modo que a abordagem de bloco pode ser mais fácil.
por exemplo, tome o plugin Gravity Forms. Antes do editor de bloco, o processo para inserir um formulário em um post ou página era diferente. Do editor clássico, você teve que usar um botão para inserir um formulário em seu conteúdo.
Após seleccionar a sua forma, o formulário shortcode foi adicionado ao seu conteúdo. Dependendo das opções que você selecionou, o shortcode continha os atributos para título e descrição.
Now, the Gravity Forms plugin offers a forms block embed block. No editor de blocos, seleccione o bloco de formulários.
uma Vez que você selecionou o formulário, você verá uma melhor visualização de como o formulário vai olhar na sua página. A configuração do formulário pode ser encontrada na configuração do bloco.
3. Os desenvolvedores de temas e plugins precisam decidir sobre o futuro de suas implementações de shortcode e converter seus códigos de Acesso para blocos. Como mencionado acima, centenas de temas, plugins e desenvolvedores ainda usam códigos de acesso em seus sites e aplicações. A adoção em bloco pode ser lenta, mas à medida que os usuários se familiarizam com o novo editor de bloco, é provável que os usuários solicitem uma opção de bloco.
para aqueles desenvolvedores que ainda estão a milhas de adotar o sistema de edição de bloco WordPress, o conceito de edição de Site completo pode andar de mãos dadas com seus códigos de acesso. Plugins como revisão e classificação plugins, audio players, tickers de data, galerias, formulários de contato, e mais qualquer outra coisa que ainda usar códigos de acesso estão ainda “no jogo.”
4. Os códigos de acesso não vão desaparecer tão cedo. É provavelmente por isso que o editor de bloco WordPress oferece o bloco de shortcode para ajudar a manter o uso de shortcode. Porque os códigos de acesso tiveram um uso tão amplo e implementação antes do WordPress 5.0 e do editor de bloco, é importante que as futuras versões do WordPress ainda suportam códigos de acesso.5. Os códigos de acesso podem ser convertidos para um bloco. Tem um tema ou plugin favorito que usa códigos de acesso? É provável que esses códigos sejam convertidos para um bloco em algum momento. Se você é um desenvolvedor de um plugin ou tema, ou você construir sites WordPress e usado códigos de acesso em um tema personalizado, é possível repensar códigos de acesso como blocos.
na próxima seção, vamos brevemente cobrir como converter códigos de acesso WordPress para blocos WordPress.
como converter códigos de acesso WordPress para blocos WordPress
assim como você pode adicionar códigos de acesso personalizados e blocos reutilizáveis, você também pode facilmente converter códigos de acesso WordPress personalizados para blocos WordPress.
siga os primeiros passos deste guia personalizado shortcode.
tome este exemplo básico das formas Caldera:
<?php/** * Handler for shortcode * * @param $atts * * @return string */function caldera_learn_basic_blocks_post_title_shortcode_handler($atts){$atts = shortcode_atts(, $atts, 'cl_post_title');return caldera_learn_basic_blocks_post_title($atts, $atts);}/** * Output the post title wrapped in a heading * * @param int $post_id The post ID * @param string $heading Allows : h2,h3,h4 only * * @return string */function caldera_learn_basic_blocks_post_title($post_id, $heading){if (!in_array($heading, )) {$heading = 'h2';}$title = get_the_title(absint($post_id));return "<$heading>$title</$heading>";}/** * Register Shortcode */add_shortcode('cl_post_title', 'caldera_learn_basic_blocks_post_title_shortcode_handler');este código toma o código de post ID e um nível de cabeçalho (h2, h3, he) e emite o título do post embrulhado no HTML para o título.
Uma vez que isso está feito e você testou que o código está funcionando, você então tem que registrar o shortcode como um bloco. Aqui está o Guia Passo a passo para converter um shortcode WordPress para um bloco Gutenberg como um exemplo.
mais recursos na criação de blocos WordPress
Existem inúmeros plugins e recursos disponíveis on-line que o ajudariam a chegar a esse passo, incluindo a documentação oficial do WordPress ao escrever o seu primeiro tipo de bloco. Você pode verificar o post de Igor Benic, bem como sobre como criar um bloco para exibir posts.
Depois de ler estes guias, você será capaz de descobrir como criar seus próprios blocos WordPress usando seus códigos de acesso personalizados.
o veredicto para os códigos de acesso WordPress
os códigos de acesso WordPress são e ainda serão uma das partes mais importantes do WordPress. Os códigos de acesso têm ajudado muitos desenvolvedores de plugins a tornar seus plugins mais amigáveis e muitos desenvolvedores de temas estendem as funcionalidades de seus temas. Os códigos de acesso também reduziram o número de dores de cabeça um monte de criadores de Conteúdo e proprietários de sites têm depois de criar seus códigos de acesso personalizados quando se trata de adicionar e atualizar repetidamente as coisas que eles querem.
com isso dito, não há dúvida de que o editor de bloco é o futuro da experiência de edição WordPress, então espere ver mais Desenvolvedores contribuir para torná-lo melhor e ainda mais, cheio de recursos, incluindo aqueles que ainda estão usando códigos de acesso. Olhando para a frente, esperamos que mais desenvolvedores irão passar a usar e adicionar blocos WordPress em vez de códigos de acesso WordPress.
esperamos que você tenha aprendido muito sobre a importância dos códigos de acesso WordPress, o que eles são para e quando usá-los. Com sorte, você pode começar a criar seus próprios códigos de acesso personalizados e, eventualmente, seus próprios blocos, que certamente não estão indo embora tão cedo.
Share via: