Quem pode usar o Jim?

Qualquer pessoa ou equipe que tenha um site WordPress (6.0 ou mais, PHP 7.4 ou mais) e precise transformar documentos em páginas de leitura: blogs, revistas, jornalistas, escolas, associações, comunidades, pesquisadores e organizações. No painel, quem tem a permissão de enviar arquivos ( upload_files , por padrão administradores, editores e autores) converte documentos; as Configurações, incluindo a chave de IA, ficam só para quem administra o site. Quem visita as páginas não precisa de conta.

Posso usar o Jim em um projeto comercial?

Sim. O Jim é software livre, distribuído sob a GPL v2 ou posterior: você pode usá-lo em sites de clientes, em lojas e em projetos comerciais, e modificá-lo, desde que mantenha a licença se redistribuir o código. As bibliotecas que vêm junto têm as licenças listadas no readme.txt do plugin.

Em quais idiomas o Jim está disponível?

O código-fonte está em inglês, e o plugin traz traduções completas para português do Brasil, espanhol, francês, alemão, russo, chinês simplificado e hindi, escolhidas pelo idioma do site ou do usuário. Em Configurações, o botão Revisar tradução leva ao arquivo de cada idioma, para quem quiser corrigir um texto ou acrescentar uma língua. Cada documento também pode ter o seu idioma: ao importar, você escolhe a língua do texto, e leitores de tela, a voz da leitura em voz alta e os buscadores passam a usá-la.

Quais arquivos são aceitos?

PDF com texto selecionável, Word ( .docx ), Markdown ( .md ) e texto simples ( .txt ). Arquivos antigos do Word ( .doc ), .odt , .rtf , planilhas, apresentações e EPUB não são convertidos; a mensagem de erro diz o que fazer (por exemplo, salvar como .docx ). Os limites são mostrados na tela de importação: até 20 arquivos por envio, de 1 a 100 MB por arquivo (10 MB por padrão, ajustável em Configurações) e, para PDF, um teto calculado pela memória do servidor.

O Jim funciona com PDF escaneado?

Não. Um PDF formado só por imagens não tem texto para a conversão extrair, e o Jim não faz OCR. Ele recusa o arquivo com um aviso claro, em vez de publicar uma página vazia. A solução é passar o PDF por um OCR (no Acrobat ou no Google Drive, por exemplo) e enviar a versão com texto.

O plugin converte os arquivos em HTML real ou usa um leitor embutido (viewer ou iframe)?

HTML real. O texto do documento passa a ser o conteúdo de uma página do seu site: títulos, parágrafos, listas, tabelas e imagens (que vão para a Biblioteca de Mídia) estão no código da página, não dentro de um nem de um visualizador de PDF. É por isso que leitores de tela, o tema do site, a busca do WordPress e os buscadores enxergam o texto. O HTML gerado passa por wp_kses_post() antes de ser guardado, e o shortcode imprime esse conteúdo sem executar outros shortcodes que o arquivo tenha.

As páginas convertidas são editáveis?

Sim. Cada conversão fica guardada no banco do WordPress como um tipo de conteúdo próprio ( Custom Post Type ), com o editor, as revisões e o histórico do WordPress. Você corrige o texto, descreve imagens, ajusta títulos e muda o modo de exibição (leitor ou blog) sem enviar o arquivo de novo. A caixa de nota de SEO e a Revisão da conversão ajudam nessas correções, e o texto anterior fica nas revisões quando uma correção automática muda o conteúdo.

O plugin exige binários externos pesados na hospedagem ou usa parsers nativos em PHP?

Parsers em PHP. O Jim não precisa de Ghostscript, Poppler, LibreOffice, Java nem de qualquer programa instalado no servidor: a leitura de PDF usa a biblioteca smalot/pdfparser , a de DOCX usa phpoffice/phpword , e Markdown e TXT têm código próprio. As bibliotecas vão dentro do pacote. Só são necessárias extensões comuns do PHP: zlib , iconv e mbstring para PDF; zip , dom , xml e mbstring para DOCX. Se faltar alguma, o plugin diz qual antes de tentar converter, e a tabela "Requisitos do servidor" nas Configurações compara os limites do PHP com os recomendados.

O processamento de um lote é síncrono ou usa uma fila assíncrona, para evitar timeout e estouro de memória no PHP?

Os arquivos entram em uma fila e são convertidos um depois do outro. Cada arquivo é uma requisição própria, e a conversão de cada um é feita em passos de até cerca de 20 segundos que salvam onde pararam, então um livro longo não depende de uma única requisição e um 504 do servidor deixou de ser o fim da conversão. A tela mostra o andamento (página N de M) e precisa ficar aberta até o último arquivo terminar. Para não estourar a memória, o Jim calcula o maior PDF que o servidor consegue converter a partir do memory_limit do PHP (cerca de 42 MB com 256 MB), limita o número e o peso das imagens e interrompe com uma explicação se o tempo ou a memória acabarem. Um erro ou bloqueio em um arquivo não derruba os outros do lote. Não é uma fila em segundo plano com o WP-Cron: é uma fila conduzida pela tela aberta.

Preciso enviar meus documentos para outro serviço?

Não. A conversão acontece no próprio servidor do WordPress, sem API externa e sem custo por documento. A leitura em voz alta usa a voz do navegador de quem lê. A IA é opcional e só entra se você a ativar.

Preciso reconstruir a página depois da conversão?

Não. O documento convertido recebe um shortcode, [documento_acessivel id="123"] , que você pode colocar em qualquer página, post ou tipo de conteúdo. Ou, ao importar, use Publicar também em : o Jim cria o post ou a página já com o shortcode dentro, na hora ou agendado.

De que forma o conteúdo convertido impacta a indexação e o SEO nos mecanismos de busca?

Um PDF em download é um arquivo à parte, sem o contexto do seu site. Uma página com o texto de verdade dá ao buscador o que ele precisa: o texto no HTML, uma estrutura de títulos, descrição e título adequados aos resultados de busca, dados estruturados e o idioma do documento. O Jim cuida dessas partes na página que tem o shortcode. Ele não promete posição: o ranqueamento depende também do seu site, da qualidade do conteúdo e de quem aponta links para ele. Documentos muito longos (a partir de cerca de 350 KB) são entregues por partes, e cada parte tem um link comum que os buscadores conseguem seguir.

Como o Jim evita conteúdo duplicado se o PDF original continuar acessível no servidor?

Por padrão, o Jim também pede aos buscadores que não indexem os originais guardados: a pasta recebe um .htaccess que envia o cabeçalho X-Robots-Tag: noindex, nofollow. Isso vale onde o servidor lê .htaccess (Apache e LiteSpeed). No nginx a mesma regra precisa ser colocada na configuração do servidor, como descreve a documentação de segurança do projeto. A opção pode ser desligada em Configurações. O Jim não envia canonical para o arquivo guardado.

As páginas geradas criam dados estruturados (Schema.org) para artigos, livros ou documentos acadêmicos?

Criam um JSON-LD do tipo Article na página que tem o shortcode, com título, descrição, idioma, datas, número de palavras, tempo de leitura, autor, editor e imagem. Também declaram, nas propriedades de acessibilidade do schema.org ( accessMode , accessibilityFeature , accessibilityControl ), só o que a página realmente oferece: sumário quando há dois ou mais títulos, texto alternativo quando nenhuma imagem está sem descrição, controles de leitura no modo leitor. O tipo é sempre Article : o Jim não escolhe sozinho Book ou ScholarlyArticle . Com Yoast SEO, Rank Math, All in One SEO ou SEOPress ativo, ele não escreve o próprio bloco e entrega esses dados ao schema da página desses plugins.

O Jim substitui um plugin de SEO?

Não. Ele cuida só dos dados das páginas que mostram documentos e, se detecta Yoast SEO, Rank Math, All in One SEO ou SEOPress, deixa as tags para eles e apenas entrega a descrição e os dados de acessibilidade do documento. Um plugin de SEO continua sendo o lugar para sitemap, redirecionamentos e o resto do site.

Como o plugin audita a pontuação de SEO e acessibilidade em tempo real quando o arquivo enviado não tem metadados preenchidos?

A nota (0 a 100) é calculada no servidor a partir do documento, sem serviço externo, com 11 verificações: título claro, resumo para buscadores, autor, títulos e níveis, texto suficiente, legibilidade, imagens descritas, página publicada, indexável e etiquetas ligadas. Faltar o autor ou o resumo no arquivo só tira os pontos daquele item; o resto é avaliado normalmente. Para quando faltam metadados, o Jim tenta preencher: o resumo vem do primeiro parágrafo de texto corrido, o autor pode vir de uma linha como "Autor: …" do próprio texto, e a caixa de SEO do documento deixa digitar o autor (ou usar o seu nome), corrigir o título e o resumo, e usar Detectar a partir do texto . Cada salvamento recalcula a nota na hora, sem recarregar a página.

Como a ferramenta de Revisão da Conversão corrige linhas soltas e as transforma em cabeçalhos reais (H2/H3)?

A revisão lê o HTML do documento no navegador, sem alterar nada, e lista o que um leitor de tela erraria: parágrafos que só parecem títulos (em negrito, grandes, com classe de título ou começando com "Capítulo 1"), texto solto fora de parágrafo, títulos que guardam um parágrafo inteiro, uma frase quebrada em vários títulos, blocos vazios, quebras de linha usadas como espaçamento e pulos de nível (um H2 seguido de H4). Para cada problema há uma correção, e você escolhe aplicar uma ou todas. Para o caso das linhas de seção, a caixa de SEO tem ainda o botão Corrigir títulos automaticamente : ele transforma linhas numeradas ("1. Introdução", "2.1 Método"), "Capítulo N", linhas em maiúsculas e linhas curtas sem ponto que abrem um parágrafo longo em ou , e desiste se muitas linhas parecem título (versos, listas). O texto anterior fica nas revisões.

Como o rastreador de shortcodes identifica e mostra, na lista do wp-admin, a página exata onde cada documento está ativo?

O Jim guarda, em cada documento, a lista das páginas que o mostram ( _jimca_usado_em ) e, em cada página, os documentos que ela mostra. Essas listas são atualizadas quando você salva uma página ou post, ao mandar para a lixeira ou apagar, ao salvar pelo Elementor e quando o shortcode é exibido. A coluna Publicado em usa essas listas e mostra cada página, post ou tipo de conteúdo, com links para ver e para editar, ou "Não utilizado em nenhuma página". O ID é conferido por inteiro (o id="17" não é confundido com o id="179" ). Em um documento que existia antes disso, o Jim faz uma única busca no banco na primeira vez e guarda o resultado. Um documento que não aparece em nenhuma página publicada é marcado como órfão, porque os buscadores não conseguem encontrá-lo.

Como o Jim atende às diretrizes de acessibilidade (WCAG) para garantir navegação justa a leitores de tela e pessoas com deficiência visual?

O texto é HTML semântico (títulos, parágrafos, listas, regiões com nome), e a página de leitura tem links de atalho para pular ao conteúdo, aos controles e ao sumário, uma barra de ferramentas com nome, botões com nome e estado ( aria-pressed , aria-expanded ), avisos de status lidos em voz alta pelo leitor de tela ( aria-live ) e ícones escondidos da tecnologia assistiva. Imagens levam o texto alternativo escrito no Word, e as que não têm são sinalizadas para você descrever. O Jim é desenvolvido contra os critérios da WCAG 2.1 AA e tem testes automáticos para os critérios que ele controla (contraste, teclado, nomes e estados, foco visível, mensagens de status, alvos de toque, reflow, movimento reduzido); a documentação de testes do projeto lista também o que ainda exige verificação manual com leitores de tela e aparelhos reais. O resultado final depende também do conteúdo, do tema e do resto do site.

De que maneira a ferramenta assegura contraste adequado, redimensionamento de fontes e navegação por teclado na interface de leitura?

Contraste: quatro temas (claro, sépia, escuro e alto contraste), todos com texto de pelo menos 4,5:1; o alto contraste usa fundo preto, texto branco e destaques em amarelo (21:1 no texto). O anel de foco tem 3 px e contraste de pelo menos 3:1 em todos os temas. Tamanho do texto: botões para aumentar, diminuir e voltar ao padrão, com a escolha lembrada no navegador de quem lê; o layout reflui sem rolagem horizontal. Teclado: todos os controles são botões e links de verdade, sem tabindex positivo; os menus abrem, navegam e fecham com Esc devolvendo o foco ao botão. Os alvos de toque da barra têm 48 px de altura. Movimento: respeita a preferência de movimento reduzido do sistema.

A leitura em voz alta envia o áudio para algum servidor?

O Jim não envia nada: a leitura usa a voz já disponível no navegador de quem está lendo (a API Web Speech) e o idioma do próprio documento. Dependendo do navegador e da voz escolhida, o próprio navegador pode processar a fala nos servidores do fabricante; isso é do navegador, não do plugin.

O Jim garante conformidade total com a WCAG?

Não existe motivo para prometer isso como se uma ferramenta pudesse carimbar um site inteiro com “acessível” e ir embora. O Jim é desenvolvido e testado com critérios da WCAG 2.1 AA, cobrindo os aspectos da experiência que ele controla. A acessibilidade final também depende do conteúdo, do tema, do WordPress e de outras partes do site.

Como o sistema de upload impede a execução de scripts maliciosos (por exemplo, arquivos .php disfarçados de .pdf) com a verificação do tipo MIME real (finfo)?

O Jim aceita só quatro extensões (pdf, docx, txt e md) e confere, no servidor, se o conteúdo corresponde à extensão com wp_check_filetype_and_ext() , que lê o cabeçalho do arquivo (usa o finfo do PHP). Um .php renomeado para .pdf não passa: o conteúdo não é um PDF, e o envio é recusado com a explicação. Arquivos .md e .txt , que não têm assinatura própria, são conferidos como texto (sem bytes nulos) e continuam com a extensão de texto. Em camadas: o arquivo vai para uma pasta do plugin que recebe um .htaccess proibindo a execução de scripts e a listagem (vale em Apache e LiteSpeed; em nginx a regra equivalente precisa ser feita no servidor, e está na documentação de segurança do projeto); o original é apagado depois da conversão; e o HTML guardado passa por wp_kses_post() , então o texto de um documento não carrega scripts.

De que forma o plugin neutraliza tentativas de Path Traversal e de sobrescrita de arquivos nos diretórios do servidor?

O destino nunca é escolhido pelo arquivo: o Jim move o envio com wp_handle_upload() para uma pasta fixa dentro de uploads , e o nome passa por sanitize_file_name() , que tira barras, .. , acentos e caracteres especiais. O nome real do arquivo viaja codificado em um campo à parte e é limpo da mesma forma; o arquivo em si sobe com um nome neutro, o que também evita bloqueios de firewall. Para não sobrescrever, o nome guardado leva um sufixo aleatório: dois envios do mesmo arquivo nunca ocupam o mesmo lugar. Todas as ações exigem nonce e a permissão de enviar arquivos.

Onde as chaves de API de inteligência artificial são armazenadas e como o plugin impede o vazamento de credenciais no front-end?

A chave é cifrada com libsodium ( secretbox , com um número aleatório novo a cada vez que é salva) e guardada na opção jimca_ai , no banco; a chave de cifragem vem dos salts do wp-config.php , que não ficam no banco. Assim, um vazamento só do banco não revela a chave. No front-end, ela nunca aparece: a tela de Configurações mostra só os últimos 4 caracteres, a chave não vai para o JavaScript do leitor nem para o registro, é decifrada na memória só na hora de chamar o provedor (por HTTPS, a partir do servidor) e o leitor nunca vê o erro do provedor, só uma frase genérica; nos avisos para administradores a chave é mascarada. O que não é protegido está dito na documentação de segurança: um backup completo (arquivos e banco) ou um código malicioso rodando no WordPress. Use uma chave só para este site, com limite de gasto no provedor.

Quais são os mecanismos de proteção contra abuso de requisições e consumo excessivo de recursos no assistente de IA?

Limites de uso: por leitor (usuário logado ou IP, guardado só como hash) por hora, e para o site inteiro por dia. Por padrão, 20 perguntas por hora e 300 por dia, ajustáveis; ao passar do limite, o leitor recebe um aviso, e o registro anota quando o teto diário do site é atingido. Entrada pequena: pergunta de até 1.000 caracteres, histórico curto e limpo, e só trechos do documento aberto vão ao provedor. Nonce por documento: impresso só nas páginas em que o assistente aparece. Respostas guardadas: uma pergunta quase igual a outra já respondida para o mesmo documento usa a resposta salva, sem nova chamada (pode ser desligado). Desligado por padrão e sem efeito nenhum até você cadastrar uma chave. O limite por IP não impede alguém que troque de IP; o limite diário do site e o limite de gasto no provedor protegem o orçamento.

O Jim usa inteligência artificial?

Só se você quiser. O assistente de IA vem desligado: para ativá-lo, o administrador cadastra a própria chave de um provedor compatível (OpenRouter, Claude, OpenAI, Gemini ou DeepSeek), ou aponta para um serviço compatível com a API da OpenAI, inclusive um modelo no seu próprio servidor (Ollama, vLLM, LM Studio). A conversão e a leitura em voz alta nunca dependem de IA.

Como o plugin garante a conformidade com a LGPD no tratamento dos dados pessoais contidos nos documentos enviados?

Nenhum plugin “garante” a conformidade: quem responde pelos dados é você, que decide o que publica, por quê e com qual base legal. O Jim ajuda a manter o tratamento enxuto: a conversão acontece no seu servidor, sem enviar o arquivo a terceiros; o original é apagado por padrão; o registro de atividade guarda nomes de arquivo, horários e erros, nunca o texto do documento; e, ao excluir o plugin, os documentos convertidos e as imagens vinculadas são removidos. Se o documento tem dados pessoais, o que acontece com eles depois da publicação é o mesmo que acontece com qualquer página do seu site. Se você ligar o assistente de IA, trechos do documento vão ao provedor escolhido; veja a próxima pergunta. O plugin acrescenta ao guia de privacidade do WordPress (Configurações > Privacidade) um texto sugerido para a política de privacidade do site, que você revisa e adapta.

De que forma o Jim assegura que o assistente de IA respeite a privacidade e a proteção de dados dos usuários e leitores?

Nada é enviado enquanto ninguém faz uma pergunta. Quando um leitor pergunta, vão ao provedor que você escolheu a pergunta, os últimos turnos daquela conversa e os trechos do documento que mais combinam com a pergunta; o Jim não envia nome, e-mail nem dados da conta do leitor. O assistente é instruído a responder só com base no documento aberto. O Jim não guarda a conversa no servidor: as respostas repetidas ficam em cache por documento só como o peso das palavras da pergunta, sem o texto dela e sem nada que identifique quem perguntou, e o IP, quando existe, só entra como hash em um contador temporário de limite. O que o provedor faz com os dados segue a política dele, então escolha o provedor (ou um modelo local, que mantém tudo no seu servidor) e avise os leitores na sua política de privacidade.

O plugin armazena ou rastreia dados sensíveis dos visitantes durante a leitura das páginas?

Não. O Jim não usa cookies, não tem rastreamento nem análise de uso e não carrega scripts, fontes ou imagens de outros sites. As escolhas do leitor (tamanho do texto, tema, contraste, voz, velocidade) e os trechos que ele marca ficam só no armazenamento local do navegador dele, por documento, e não são enviados ao seu servidor. Os cartões e arquivos de texto que o leitor gera são feitos no próprio navegador.

Existem hooks e filtros (apply_filters) para estender o plugin e personalizar o pós-processamento?

Existem cinco filtros, para pontos específicos: jimca_seo_enabled : liga ou desliga as tags de SEO do Jim em uma página. jimca_frame_ancestors : define quem pode incorporar as páginas do Jim em um (o padrão é só o próprio site). jimca_destination_post_types : acrescenta ou tira tipos de conteúdo da lista de "Publicar também em". jimca_conversion_step_seconds : muda a duração de cada passo da conversão (útil em servidores com limite de tempo diferente). jimca_usage_documents_of : informa ao rastreador de shortcodes outros lugares onde uma página guarda o shortcode, como o campo de outro construtor de páginas. Ainda não há uma ação ou um filtro para alterar o HTML depois de convertido nem para trocar o tipo do JSON-LD; se você precisa disso, abra uma sugestão no GitHub . Para conferir o resultado, o projeto traz o comando wp jimca convert e o script bin/seo-audit.js , descritos em "SEO e nota de qualidade".

PrivacidadeSite jim.mabo.cc · atualizada em 19 de outubro de 2026

Privacidade do site do Jim

Esta página fala do site de divulgação (jim.mabo.cc). O plugin instalado no seu WordPress é outro assunto, explicado na última seção.

O que medimos no site

Cloudflare Web Analytics: contagem de visitas e páginas mais vistas, sem cookies e sem identificar você entre uma visita e outra. Fica ligada o tempo todo.
Microsoft Clarity: mapas de calor e gravações anônimas de sessão, para vermos onde as pessoas travam. Usa cookies próprios e só carrega depois que você clicar em “Aceitar” no aviso do rodapé. Se o seu navegador envia o sinal Global Privacy Control, tratamos como recusa e nem mostramos o botão “Sim, pode”.

Como recusar ou mudar de ideia

Use o botão “Preferências de privacidade” no rodapé de qualquer página. Ao recusar, o Clarity deixa de carregar e a sua escolha é guardada só no seu navegador (localStorage, chave jim-consent).

Outros serviços que o site usa

GitHub Pages hospeda as páginas e registra o seu endereço IP nos logs de acesso, como qualquer servidor web.
Google Fonts entrega as fontes Onest e Literata; o Google recebe o seu IP ao baixá-las.
wordpress.org: os botões “Baixar” levam para o diretório oficial de plugins, que tem a própria política.

E o plugin Jim, no seu site?

O plugin não rastreia quem visita as suas páginas: não grava cookies de visitante, não envia dados a nós e não usa serviço de análise. Duas observações para ser exato:

O contador “instalações ativas” (shortcode [jimca_instalacoes]) é exibido pelo seu servidor, que consulta a API pública do wordpress.org só com o nome do plugin e guarda o número em cache por 12 horas. Nenhum dado de visitante entra nessa consulta.
Os recursos de IA são opcionais e usam a sua chave. Se você ligá-los, o texto da pergunta vai para o provedor que escolher (OpenAI, Gemini, Claude etc.) ou para um modelo local. Revise a política desse provedor.

Responsável e contato

Mayara Nascimento, autora do Jim. Dúvidas ou pedidos sobre dados: abra uma conversa no GitHub.

Voltar ao início