Post2pdf: ofereça arquivos PDF em seu blog

O formato .PDF é um formato de arquivos muito difundido hoje em dia e conhecido por praticamente todos os usuários de computadores. Atualmente encontramos facilmente diversos tipos de conteúdo disponibilizados sob o formato, como por exemplo e-books, cursos, manuais, tutoriais, apresentações, etc.

Praticamente todo computador possui um leitor de arquivos PDF instalado, e o formato oferece inúmeras vantagens tanto para quem fornece o conteúdo quanto para quem precisa manipular tais arquivos.

Sobre o plugin

O “post2pdf” é um plugin para Wordpress ainda em versão beta, desenvolvido por Antonello Cicchese, que gera arquivos .PDF a partir de seus posts, páginas e categorias, de forma rápida e simples. Trata-se de uma funcionalidade muito interessante e útil a quem disponibiliza algum tipo de conteúdo, e através do post2pdf qualquer visitante poderá gerar e baixar PDF’s a partir dos posts, páginas e/ou todo o conteúdo de uma determinada categoria de seu blog.

Instalação

A instalação do plugin não requer nenhum tipo de configuração adicional. Basta seguir os procedimentos básicos de upload da pasta do plugin para a pasta /wp-content/plugins/ e então ativá-lo em sua lista de plugins. Você pode também, caso sinta alguma dificuldade, dar uma conferida em nosso tutorial a respeito da instalação de plugins no Wordpress, acessível através do menu “Inicie agora“.

Existem algumas poucas opções que podem ser alteradas em um arquivo de configuração do plugin, e estas você poderá conferir abaixo.

Utilizando o plugin

Após a instalação e ativação do plugin, será exibido automaticamente no rodapé de todos os seus posts e páginas um link para a geração do arquivo .PDF. O link é exibido tanto na página inicial quanto na visualização de um único post e/ou página de seu blog:

Além disso, é possível gerar um PDF contendo todos os posts pertencentes a uma categoria em especial. Após a instalação, é exibido um pequeno ícone à direita do nome de cada categoria. Ao clicar neste link, é oferecido ao visitante um arquivo para download que contém todos os PDF’s presentes na categoria em questão.

Observe que o plugin insere automaticamente nos PDF’s gerados a url e o nome de seu blog, além do e-mail do administrador. Ele também numera automaticamente as páginas e insere ao final o endereço completo para o(s) post(s) em questão (exceto na geração do PDF para as categorias).

Configurando

Na verdade, pode-se configurar pouquíssimas opções no plugin, dada a sua natureza, e ele não possui nenhum tipo de configuração acessível através da área de administração do Wordpress. Caso você deseje alterar algumas das opções disponíveis, deve editar um de seus arquivos, conforme explicações abaixo.

O arquivo que deve ser alterado é o config.inc.php, localizado na pasta do plugin. Segue abaixo o conteúdo original do mesmo, a título de exemplo:

<?php
/*
Default action once the plugin was activated:
1 to enable automatic exportation for all posts except those with the exclude tag
0 to disable it and let export only post with the export tag placed inside
*/

$default_post_action = 1;

/*
Enable or disable category exportation
0 to disable
1 to enable
*/

$export_category = 1;

$exclude_tag = “<!–post2pdf_exclude–>”;
$export_tag = “<!–post2pdf_export–>”;
$html_text = “convert this post to pdf.”;
$html_post_code = “<span class=\”post2pdf_span\” style=\”border: 1px solid gray; width: 160px; text-align: left; \”><a href=\”##SITEURL##/wp-content/plugins/post2pdf/generate.php?post=##GLOBALID##\” rel=\”nofollow\”><img src=\”##SITEURL##/wp-content/plugins/post2pdf/icon/pdf.png\” width=\”16px\” height=\”16px\” />”.$html_text.”</a></span>”;
$html_category_code = ” <a href=’##SITEURL##/wp-content/plugins/post2pdf/generate.php?category=##CATEGORYID##&name=##CATEGORYNAME##’ rel=’nofollow’ title=’Export category ##CATEGORYNAME## as pdf’>(<img src=’##SITEURL##/wp-content/plugins/post2pdf/icon/pdf.png’ width=’10px’ height=’10px’/>)</a>”;

?>

Seguem abaixo maiores detalhes a respeito das modificações que são possíveis:

• default_post_action: ativa ou desativa a exibição automática do link para geração dos PDF’s ao final de cada post/página. A opção vem ativa por default (1), e você pode, caso deseje, alterá-la para “0“, e assim, fazer com que o link para geração dos PDF’s só seja inserido naqueles post/páginas onde você inserir manualmente a tag de exportação (veja abaixo).
• export_category: ativa ou desativa a função de exportação dos posts contidos em uma determinada categoria. Esta opção vem ativa por default (1), e você pode desabilitá-la caso deseje (0).
• html_text: aqui você pode definir o texto que deseja que apareça ao final de cada post e página. Trata-se do link para geração do PDF, e você pode escolher um texto de sua preferência. Por exemplo, você pode deixar esta linha exatamente da maneira abaixo:

$html_text = “Clique aqui para gerar um arquivo PDF.”;

Você pode, é claro, utilizar o texto de sua preferência entre os parênteses.

Vale ressaltar que você pode também eliminar a exibição do link para a geração dos PDF’s de qualquer post ou página, através da inserção nos mesmos da tag <!–post2pdf_exclude–>. Além disso, caso decida por não ativar a exibição automática do link para a geração dos PDF’s, você pode inserir a tag <!–post2pdf_export–> em qualquer post ou página, e o link será então exibido.

Finalizando

Acredito que o post2pdf seja um plugin muito útil a qualquer blog, além de ser bem fácil de ser instalado. Apesar de não possuir nenhuma opção disponível através da área de administração do Wordpress, as poucas opções disponíveis podem ser facilmente alteradas, conforme vimos acima. E com tantos pontos positivos, por que não efetuarmos um “upgrade” na maneira como oferecemos nosso conteúdo, através deste excelente plugin?

Informações adicionais

Versão atual:

0.4 beta

Site oficial do plugin:

http://www.antonellocicchese.com/post2pdf-wordpress-plugin

Página do plugin no diretório de plugins do Wordpress.org:

http://wordpress.org/extend/plugins/post2pdf/#post-1737

Site do desenvolvedor:

http://www.antonellocicchese.com