seamonsterdeneb

A spinnaker is a special type of sail that is flown in front of the main sails. It’s packed away when not in use, but when the wind is right, it can be unfurled to provide a powerful boost. This plugin is named Spinnaker because it allows you to keep your images and PDFs neatly tucked away, ready to be “unfurled” into a beautiful, accessible lightbox when your users need them.
Spinnaker is a lightweight, modern, and highly accessible plugin that turns any image or PDF link into a fully-featured dialog lightbox. It’s built with accessibility as a priority, ensuring a seamless experience for users with keyboards and screen readers.
Image Lightbox Features:
<ul>
<li>Converts any <code><img></code> tag into a clickable lightbox trigger.</li>
<li>Displays a large, scrollable version of your image that fills the viewport without forcing double-scrollbars.</li>
<li>Adds scroll-arrow buttons for easy navigation of oversized images.</li>
<li>Supports custom initial image positioning (e.g., center, top, bottom, left, right).</li>
<li>Displays image credits as a “placard,” with support for links.</li>
<li>Provides a “Download” button for the full-size image.</li>
<li>Fully localizable UI text in Spanish, Russian, Vietnamese, Simplified Chinese, Arabic, Korean, and Somali.</li>
</ul>
PDF Lightbox Features:
<ul>
<li>Converts any <code><a></code> tag pointing to a PDF into a lightbox trigger.</li>
<li>Displays the PDF in an embedded viewer right on your site.</li>
<li>Includes a “Download” button.</li>
<li>Supports page builder modules (like DIVI) where you can only add a class to the container.</li>
<li>Tracks PDF views and downloads, with stats available in the WordPress admin.</li>
<li>Fully localizable UI text in Spanish, Russian, Vietnamese, Simplified Chinese, Arabic, Korean, and Somali.</li>
</ul>
<h3>Usage</h3>
<h3>Image Lightbox</h3>
To make an image open in a lightbox, add the class <code>image-lightbox-trigger</code> to the <code><img></code> tag itself.
For Gutenberg Block Editor: 
Gutenberg wraps images in a <code><figure></code> element. Add the class <code>image-lightbox-trigger-container</code> to the figure wrapper: Select the image block, open the “Advanced” panel in the block settings, and add <code>image-lightbox-trigger-container</code> to the “Additional CSS class(es)” field. For screen reader descriptions, you can use the image’s “Title” field (available in the image block settings). For advanced features like credits and positioning, switch to HTML editing mode.
For Page Builders (like DIVI): 
If you can only add a class to the container/module holding the image, add the class <code>image-lightbox-trigger-container</code> to the container. The plugin will find the first image inside it and turn it into a lightbox.
Optional Attributes (add to the <code><img></code> tag):
<ul>
<li><code>data-description="…"</code>: A longer description for screen readers. Note: Users of Gutenberg and other page builders that don’t allow custom attributes to be added can use the image’s “Title” field. The plugin will automatically use the title text for the screen reader description and remove the title attribute from the image to prevent duplicate announcements.</li>
<li><code>data-credit="…"</code>: The text for the credit placard. Requires HTML editing mode in Gutenberg.</li>
<li><code>data-credit-link="…"</code>: A URL to make the entire credit placard a link. Requires HTML editing mode in Gutenberg.</li>
<li><code>data-position="…"</code>: Set the initial scroll position. Options: <code>top</code>, <code>bottom</code>, <code>left</code>, <code>right</code>, or <code>center</code> (default). Requires HTML editing mode in Gutenberg.</li>
</ul>
Localization: 
To translate the UI text, add a language-specific class like <code>-es</code> (for Spanish) to the trigger class (e.g., <code>image-lightbox-trigger-es</code>).
<ul>
<li>Supported languages: Spanish (<code>-es</code>), Russian (<code>-ru</code>), Vietnamese (<code>-vi</code>), Simplified Chinese (<code>-zh</code>), Arabic (<code>-ar</code>), Korean (<code>-ko</code>), and Somali (<code>-so</code>).</li>
</ul>
Example HTML:
<pre><code><img class="image-lightbox-trigger-es" src="…" alt="…" 
 data-description="Una descripción detallada de la imagen." 
 data-credit="Foto por Jane Doe" 
 data-credit-link="[https://example.com](https://example.com)"
 data-position="right">
</code></pre>
<h3>PDF Lightbox</h3>
To make a link to a PDF open in a lightbox, add the class <code>pdf-lightbox-trigger</code> to the <code><a></code> tag itself.
For Page Builders (like DIVI): 
If you can only add a class to the container/module holding the link, add the class <code>pdf-lightbox-trigger-container</code> to the container. The plugin will find the correct PDF link inside it.
Localization: 
To translate the UI text, add a language-specific class like <code>-es</code> (for Spanish) to the trigger class (e.g., <code>pdf-lightbox-trigger-es</code>).
<ul>
<li>Supported languages: Spanish (<code>-es</code>), Russian (<code>-ru</code>), Vietnamese (<code>-vi</code>), Simplified Chinese (<code>-zh</code>), Arabic (<code>-ar</code>), Korean (<code>-ko</code>), and Somali (<code>-so</code>).</li>
</ul>
Example HTML:
<pre><code><a href="/path/to/file.pdf" class="pdf-lightbox-trigger-es">Directorio</a>
</code></pre>

Spinnaker Dialog Lightboxes

Accessible lightboxes for images and PDFs using the HTML dialog element. Add classes to create instant lightboxes!

Amber Hinds

Steve Jones

Road Warrior Creative

Equalize Digital

Web Content Accessibility Guidelines (WCAG) Success Criterion 3.2 (Predictable) specifies that web pages should appear and operate in predictable ways. It is a common practice to set links that go to off-site locations to open in a new window or tab when clicked. Opening new windows or tabs automatically when a link is activated can be disorienting for people who have difficulty perceiving visual content, and for some people with cognitive disabilities, if they are not warned in advance.
This plugin helps websites become more accessible and better meet WCAG guidelines for predicability by providing advanced warning if a link is going to open a new window or tab before the user clicks or activates it. Providing a warning allows the user to decide it they want to leave the current window, and the warning will help them find their way back, if they do decide they would like to go to the new window. It will help them understand that the “back” button will not work and that they have to return to the last window they had open, in order to find their previous location.
There are no settings in this plugin. Simply activate it and it will automatically find all links that open in a new window and add the following three fixes to each link: 
1. A new window icon after the link text to denote that the link opens in a new window for sighted people. 
2. A tooltip, visible on hover, that says “opens a new window.” 
3. “Opens a new window” screen reader text that will be read out to blind or visually impaired people using screen readers immediately following the link anchor text.
Please note: new window warnings will be added to links and links that have been styled to look like buttons, including social media sharing and link icons. Depending upon what third party plugins are adding links to your site that open in new windows, some CSS styling may be required.
In addition to adding warnings for your users, this plugin integrates with the <a href="https://wordpress.org/plugins/accessibility-checker/" rel="ugc">Accessibility Checker plugin</a>; when Accessibility New Window Warnings is activated, it will automatically clear all “<a href="https://equalizedigital.com/accessibility-checker/link-opens-new-window-or-tab/" rel="nofollow ugc">Link Opens New Window or Tab</a>” warnings in Accessibility Checker scans of your website. Installing and activating this plugin is a great way to quickly remediate and remove a lot of open issues across you entire website.
The Accessibility New Window Warnings plugin is inspired by <a href="https://www.w3.org/TR/WCAG20-TECHS/G201.html" rel="nofollow ugc">Techniques for WCAG 2.0 G201: Giving users advanced warning when opening a new window</a>.
<h3>Localization</h3>
The Accessibility New Window Warnings plugin is ready for localization. We have added a Spanish translation and are open to more translations!
If you would like to contribute a translation to this plugin, please <a href="https://equalizedigital.com/contact/" rel="nofollow ugc">contact us</a> or <a href="https://github.com/equalizedigital/accessibility-new-window-warnings" rel="nofollow ugc">fork the repository on GitHub</a>.

Accessibility New Window Warnings

Install, activate, DONE! I love how simply this plugin fixes a real problem! This goes right into my starter site and on every website I build from here on out!

Simple solution for an important problem


I installed this on my blog as I wanted to ensure there was a visible indication when links opened external pages to better comply with accessibility guidelines without having to go through hundreds of old posts. Did the job and correctly and easily and automaticaly added the desired indicators, markup and icons.


Does the job intended

Make links that open in a new window compliant with WCAG guidelines for accessibility by adding a warning for users.

Spinnaker Dialog Lightboxes vs Accessibility New Window Warnings