Flipbooks elegantes
no seu site WordPress

O que o plugin adiciona ao seu site — e o que não adiciona

Um plugin entra na sua própria instalação, então é justo perguntar o que ele traz junto. Este é pequeno de propósito. No front-end, ele gera um único <div> com um <iframe> dentro, marcado com loading="lazy": um flipbook mais abaixo em uma página longa só é carregado quando o leitor chega até ele.

Ele não carrega folha de estilo nem JavaScript no front-end. Não cria tabelas no banco de dados nem adiciona menus ao painel. Não envia dados para casa, não conta nada e não pede chave de API. Tudo o que faz o flipbook funcionar roda dentro do iframe, do nosso lado — e é também por isso que sua pontuação de velocidade não se mexe quando você adiciona um.

Desativá-lo é igualmente tranquilo: o shortcode deixa de ser reconhecido, então [toombler id="…"] passa a aparecer como texto normal no post até você removê-lo. Nada fica para trás no banco de dados, porque nada foi colocado lá.

A versão em texto, e por que vale a pena ativá-la

Um flipbook é uma imagem das suas páginas. Funciona bem para quem enxerga e usa mouse, e não serve para nada a um leitor de tela, que encontra uma moldura e nada para ler. Adicionando text="1" ao shortcode, aparece abaixo do livro um painel recolhível Read the text version, preenchido com a camada de texto real do seu PDF.

A coleta acontece no seu servidor, não no navegador do visitante, e o resultado fica armazenado em um transient do WordPress: doze horas quando foi encontrado texto, uma hora quando não — assim, um flipbook cujo texto ainda está sendo extraído o recebe pouco depois, e não no dia seguinte. São armazenados no máximo 60 000 caracteres, mais do que um folheto comum, e o suficiente para impedir que um manual de quatrocentas páginas encha sua tabela de opções.

Há um segundo motivo, menos nobre mas real: esse texto está na sua página, no seu HTML, sob o seu domínio. Um mecanismo de busca que lê o post vê o que o documento realmente diz, em vez de uma moldura onde não consegue entrar. Se você publica catálogos ou newsletters que quer que sejam encontrados, esse único atributo faz mais do que tudo o resto nesta página.

Só funciona com PDFs que contenham texto de verdade. Uma digitalização sem OCR não tem camada de texto e, nesse caso, o painel não aparece em vez de abrir vazio.

Requisitos, versões e licença

O plugin precisa do WordPress 5.8 ou mais recente e do PHP 7.4 ou mais recente, e é testado com a versão atual do WordPress. Esses requisitos são baixos de propósito: o código não usa nada de exótico e, por isso, continua funcionando em hospedagens alguns anos defasadas.

Como é um shortcode comum, ele funciona no editor de blocos, no editor clássico, em um widget de texto e em construtores de páginas como Elementor, Divi, Beaver Builder e Bricks — em qualquer lugar onde os shortcodes sejam processados. O bloco do Gutenberg é uma comodidade a mais, não uma exigência.

É software livre sob a GPL, versão 2 ou posterior, a mesma licença do próprio WordPress. Você pode lê-lo, alterá-lo e rodar sua própria versão nos seus próprios sites.

Como ele lida com o que você digita

Tudo o que acaba no HTML de uma página merece um olhar desconfiado, então veja o que acontece com seus atributos. O ID do arquivo precisa corresponder a [A-Za-z0-9_-] e ter entre dez e sessenta caracteres; todo o resto é recusado com uma mensagem visível em vez de ser colado em uma URL. A largura e a altura passam por absint(), então uma letra perdida resulta no valor padrão em vez de quebrar o layout. A URL montada é escapada antes de chegar ao src.

Tem uma coisa que vale a pena saber porque pega as pessoas de surpresa: o WordPress descarta silenciosamente os atributos de shortcode que não conhece. Escreva hight="600" e nada quebra — você simplesmente fica com a altura padrão, sem nenhum aviso. Se uma opção parece não fazer nada, confira primeiro a grafia na tabela acima.

O plugin faz exatamente uma requisição do seu servidor para o nosso, e só quando text="1" está ativado: ele pede o texto desse flipbook. Nada sobre seus visitantes é enviado, porque ele não sabe nada sobre eles.

Bloco ou shortcode?

Os dois geram o mesmo HTML, então é uma questão de como você gosta de trabalhar. O bloco oferece uma pré-visualização ao vivo no editor e uma barra lateral com as opções como controles de verdade, o que é mais cômodo enquanto você testa tamanhos. O shortcode é texto, o que facilita copiá-lo entre posts, colá-lo em um construtor de páginas e procurá-lo mais tarde quando quiser encontrar todos os flipbooks do site.

Se você gerencia o site para outra pessoa, o shortcode tem uma vantagem prática: sobrevive a uma troca de tema, a uma troca de editor e a uma migração para um construtor de páginas sem precisar ser refeito. Para uma comparação do plugin com as outras três formas de incorporar — iframe simples, trecho de JavaScript e oEmbed — veja o guia sobre incorporar um PDF no WordPress.