Jim – Conversor Acessível

Apraksts

Jim – Conversor Acessível lets administrators upload PDF, DOCX or TXT files from the WordPress dashboard and turns each file into a responsive, accessible (WCAG 2.1 AA) HTML page, with:

  • Text size, high-contrast and reading theme controls (Light, Sepia, Dark).
  • A floating player docked to the bottom of the screen, following Material Design 3 (48dp touch targets, 24dp icons, label-large type, level 2/3 elevation): text size and theme, high contrast, voice, play/pause, speed, stop, and a button to hide the whole bar.
  • Text-to-speech using the browser’s native Web Speech API (no external API cost).
  • Contrast, visible focus and keyboard navigation across all controls.
  • Conversions stored in the WordPress database (Custom Post Type), reusable via the [documento_acessivel id="123"] shortcode.
  • A [jimca_instalacoes] shortcode that displays the number of active installs reported by the WordPress.org API (available once the plugin is published in the official directory).

Requirements

  • PHP 7.4+
  • No extra setup: the required libraries (smalot/pdfparser and phpoffice/phpword) are already bundled with the plugin.

Supported formats

  • PDF (with extractable text — image-only/scanned PDFs are not supported)
  • Word .docx (the legacy Word 97-2003 .doc format is not supported)
  • TXT

Ekrānuzņēmumi

Uzstādīšana

  1. Upload the plugin folder to wp-content/plugins/.
  2. Activate the plugin under Plugins > Installed Plugins.
  3. Go to Jim – Conversor Acessível > Novo Documento to upload a file.
  4. Copy the generated shortcode ([documento_acessivel id="X"]) and paste it into any page or post.

BUJ

Does the install counter work before I publish the plugin on WordPress.org?

No. The [jimca_instalacoes] shortcode queries the public WordPress.org API (api.wordpress.org/plugins/info), which only has data after the plugin has been submitted to and approved in the official directory. Until then, the shortcode renders blank for visitors (and shows a notice to logged-in administrators).

Are the original uploaded files kept?

By default, no — the plugin extracts the content and deletes the original uploaded file. This can be changed under Jim – Conversor Acessível > Configurações.

Can I choose how the converted document looks?

Yes. Under Jim – Conversor Acessível > Configurações you can set a default reading theme (Light, Sepia or Dark) applied to every converted document. Readers can also switch the theme themselves from the reading toolbar on each document — their choice is saved only in their own browser and doesn’t change the site-wide default.

Does the plugin send data to any external server?

Only one call, and only if you use the [jimca_instalacoes] shortcode: a request to WordPress.org’s own public API (api.wordpress.org/plugins/info) to fetch this plugin’s active install count. No data about your site, your documents or your visitors is ever sent anywhere else.

Atsauksmes

Par šo spraudni nav atsauksmju.

Autori un izstrādātāji

“Jim – Conversor Acessível” ir atvērtā pirmkoda programmatūra. Šo spraudni ir veidojuši šādi cilvēki.

Līdzdalībnieki

Izmaiņu žurnāls

1.0.0

  • Initial release: PDF/DOCX/TXT conversion, accessible document shortcode with text-to-speech, reading themes (Light/Sepia/Dark), and WordPress.org install-count shortcode.
  • Reading controls float at the bottom of the screen while the document is in view, with menus that open above each button; the reader’s choices (size, theme, contrast, voice, speed, bar hidden) are remembered per document in their own browser.
  • Progress feedback while a document is being converted, and readable messages instead of a raw error page when the server rejects an upload or lacks a required PHP extension.