Como escolher um módulo Drupal 7 para visualizar PDFs

Este artigo explica como escolher um módulo Drupal 7 para visualizar PDFs. Inclui uma avaliação de vários módulos potenciais.

Defina o que você deseja

Imagine que um cliente peça a você para adicionar um novo recurso ao site Drupal da empresa: exibir arquivos PDF no navegador. Conforme você navega pelas opções em drupal.org, você percebe que existem algumas opções para você escolher.

O primeiro passo é definir o que você deseja. Em geral, esses são requisitos razoavelmente padrão que você espera.

• A capacidade de visualizar arquivos PDF em um navegador da web, semelhante a este exemplo
  instagram viewer
  . O cliente carregaria PDFs do boletim informativo da empresa e os visitantes poderiam lê-los facilmente.
• O site é Drupal 7, então o módulo precisaria corresponder àquele versão principal. (O Drupal 7 já foi lançado há algum tempo, então se um desenvolvedor de módulo ainda não lançou uma versão do Drupal 7, provavelmente não vai.)
• Você também pode querer evitar depender de um serviço de terceiros. Para vídeos, você pode ficar feliz em postar o conteúdo no YouTube ou Vimeo e, em seguida, incorporá-lo em um site Drupal, mas para PDFs, não achamos que a possível exposição extra superaria o potencial incômodo, quebra e despesa.
• Você provavelmente desejará manter o módulo o mais leve e específico possível. Você pode estar procurando por algo mais como Caixa de Cores, que amplia as imagens para melhor visualização, mas permanece completamente independente de como você escolhe gerenciar os arquivos de imagem.
• Como de costume, queremos seguir as diretrizes gerais para a escolha de um módulo Drupal. Basicamente, escolha um módulo que já esteja em uso por alguns milhares de pessoas (se possível) por um tempo, com um mínimo de dependências, que parece ser mantido por um desenvolvedor ativo que planeja continuar apoiando o projeto no futuro e não requer um licenciamento taxa.

Pesquise no Drupal.org

Com esses objetivos em mente, a próxima etapa foi um pesquisa simples em Drupal.org. É hora de pular no poço de bolinhas do Módulo Bondade.

Página de 'comparação' para módulos PDF

Minha primeira parada foi (ou deveria ter sido), esta página: a Comparação de módulos visualizadores de PDF. Drupal.org tem uma excelente tradição de páginas de documentação que descrevem os prós e os contras de vários módulos no mesmo espaço. Há um lista central de páginas de comparação, mas também estão espalhados por todo o site.

A página de comparação de PDF inclui quatro módulos de visualização de PDF. Vamos cobri-los aqui, bem como alguns outros que encontramos na pesquisa. Começaremos com os candidatos que decidimos ignorar.

Agora, vamos nos aprofundar nos detalhes de por que esses módulos funcionaram (ou não funcionaram na maioria das vezes) para este projeto.

Formatador de arquivo do Visualizador do Google

Formatador de arquivo do Visualizador do Google é o que parece: uma maneira de usar o Google Docs para incorporar exibições de arquivos em sua página da web. Embora gostássemos da versatilidade do Google Docs, um de nossos objetivos era permanecer independente de qualquer serviço de terceiros.

Além disso, este módulo teve menos de 100 instalações.

Visualizador de Documento Ajax

Embora "AJAX" seja um termo Javascript geral, Visualizador de Documento Ajax acabou por depender de um serviço de terceiros específico. Apenas cerca de 100 instalações. Se movendo...

Scald PDF

Scald PDF teve apenas 40 instalações, mas tivemos que dar uma olhada, pois era claramente parte de um projeto maior chamado (sim) Escaldar. Como a página do projeto Scald explicou: "Scald é uma abordagem inovadora sobre como lidar com Átomos de mídia no Drupal. "

Essa frase levantou duas grandes bandeiras vermelhas: "abordagem inovadora" e a palavra "Mídia" emparelhada com "Atom". "Atom" era obviamente uma palavra adaptada para "coisa", o que a tornava uma bandeira vermelha por si só. O Drupal tem uma queda por esses tipos de palavras de caixa vazia: nó, entidade, característica... Quanto mais geral a palavra, mais abrangentes podem ser as mudanças.

Você lerá afirmações empolgantes de como o Scald basicamente reinventará a forma como você lida com a mídia em seu site.

Agora, a verdade é que o tratamento de mídia do Drupal poderia ser reinventado. Scald não é o único projeto ambicioso neste espaço.

Escald pode ser o próximo Visualizações. Isso seria demais. Mas também pode ser abandonware, com uma (pequena) trilha de sítios quebrados deixados para chorar.

Caixa de sombra

Caixa de sombra nos surpreendeu: alegou ser uma solução única para exibir todos os tipos de mídia, de PDFs a imagens e vídeos. Isso não era tão abrangente quanto Scald, uma vez que se concentraria apenas em exibindo mídia sem introduzir conceitos totalmente novos como "átomos de mídia". Mas já gostamos do Colorbox, como mencionamos.

No entanto, notamos (com um gemido interno) que com mais 16,000 instalações, o Shadowbox pode ser uma alternativa mais poderosa no mesmo espaço. Nós teve dar uma olhada.

O módulo Shadowbox Drupal é basicamente uma ponte para uma biblioteca Javascript, Shadowbox.js, então verificamos o site da biblioteca. Lá, descobrimos dois motivos para seguir em frente:

• A biblioteca requer uma taxa de licença para uso comercial. A taxa era razoável, mas tentamos evitar software de código aberto que não seja gratuito.
• Uma pesquisa cuidadosa no FAQ revelou que, ao contrário da descrição na página do módulo Drupal, PDFs são não 100% suportado pela biblioteca Shadowbox. Opa.

Os dois concorrentes: 'PDF' e 'PDF Reader'

Tendo eliminado o resto, chegamos agora aos dois contendores óbvios: PDF e Leitor de PDF

Esses dois projetos tinham semelhanças importantes:

• Ambos tiveram quase 3.000 instalações, muito mais do que as alternativas (exceto Shadowbox).
• Ambos usaram a mesma biblioteca Javascript externa, pdf.js.

E quanto às diferenças?

Leitor de PDF também tinha a opção de integração com o Google Docs.

Enquanto isso, PDF foi marcado como "Procurando co-mantenedor (es)." Isso pode ser um sinal de que o desenvolvedor em breve abandonaria o projeto, mas por outro lado, o commit mais recente foi há uma semana, então pelo menos o desenvolvedor ainda estava ativo.

Por outro lado, Leitor de PDF foi marcado como "Mantido ativamente", mas o commit mais recente foi há um ano.

Sem um vencedor claro, decidimos testar os dois.

Testando os concorrentes

Testamos os dois módulos em uma cópia de nosso site ativo. (Não importa o quão sólido e inócuo um módulo pareça, nunca tente primeiro em um site ativo. Você pode destruir todo o seu site.)

Estávamos inclinados a Leitor de PDF porque parecia ter mais opções (como o Google Docs) do que PDF. Então decidimos tentar PDF primeiro, para tirá-lo do caminho.

Falha no PDF: Compilação necessária?

No entanto, quando instalamos PDF e ler "README.txt", descobrimos um problema que vimos, mas ignoramos na página do projeto. Por alguma razão, este módulo parece exigir que você compile o pdf.js manualmente. Embora a página do projeto sugerisse que isso não era necessariamente necessário, README.txt sugeria que sim.

Desde a Leitor de PDF usaria exatamente a mesma biblioteca sem exigir esta etapa, decidimos tentar primeiro, afinal. Se não funcionasse, poderíamos sempre voltar para PDF e tente compilar manualmente o pdf.js.

Leitor de PDF: Sucesso! Tipo de

Então, finalmente, tentamos Leitor de PDF. Este módulo fornece um novo widget para exibir um Arquivo campo. Você adiciona um campo de arquivo ao seu tipo de conteúdo e definir o tipo de widget para Leitor de PDF. Em seguida, você cria um nó desse tipo e carrega seu PDF. O PDF aparece embutido em uma "caixa" na página.

Você pode tentar diferentes opções de exibição editando o tipo de conteúdo novamente e alterando as configurações de exibição do campo.

Descobrimos que cada opção de exibição tem prós e contras:

• O documentos Google O leitor funcionou bem como uma incorporação, mas quando clicamos nele para ir para tela inteira, acabamos em uma página do Google Docs que se desculpou por nosso limite de taxa ter sido excedido. Opa. Talvez isso fosse mais confiável se conectássemos o módulo a uma conta paga do Google Apps, mas não nos importamos em descobrir.
• O pdf.js opção funcionou maravilhosamente... no Firefox e no Chrome. Mas quando abrimos o Internet Explorer, a caixa parecia vazia. Aparentemente, este é um problema com o próprio pdf.js, não o Leitor de PDF módulo. Supomos que isso era de se esperar, visto que o pdf.js é desenvolvido pela Mozilla e o Internet Explorer é... ele mesmo. Ainda assim, é decepcionante que não tenhamos pensado em confirmar se o pdf.js funcionava de maneira confiável em todos os navegadores em primeiro lugar.
• O Embutir opção era a mais confiável. Na verdade, ele executava o Adobe Reader em uma caixa na página da web. O Firefox ainda preferia executar o pdf.js, mas achamos que essa era uma configuração do navegador. De qualquer maneira, contanto que o visitante tivesse o Firefox ou um visualizador de PDF como o Adobe Reader, o PDF seria exibido.

Assim, no final, nossa solução é usar o Leitor de PDF com o Embutir opção de exibição. Esta opção permitirá que você anexe um PDF a um nó do Drupal e o exiba de forma confiável em uma página da web do Drupal.

Infelizmente, às vezes "confiável" não é suficiente.