Lumtera Docs

Appearance

Site fixes ​

Some accessibility problems come from your theme, not your content. Under Lumtera → Settings → Site fixes you can switch on 19 small fixes for the most common ones.

  • Every fix is off by default. Each one says when to Leave it off if, and How it works shows exactly what it changes.
  • This isn't an overlay. Each fix is a small change to the HTML or CSS your server sends. Every visitor gets the same page, there's no widget, and nothing rewrites the page in the browser.
  • Fixing the theme itself is always better. Use these while you wait for a theme fix, or when you can't change the theme.

Only administrators can change these settings. Changes show on your site right away: if you use WP Super Cache, W3 Total Cache, WP Rocket, WP Fastest Cache, SiteGround Speed Optimizer, LiteSpeed Cache, Cache Enabler or Breeze, Lumtera empties its page cache when you save. Otherwise, clear your host's or CDN's cache. Use Preview on your site to open your home page, then check a page with the keyboard and a screen reader.

The skip link, the focus outline and pinch zoom are the baseline fixes in the Overview's Get started checklist. Like every site fix, they stay free.

If WP Accessibility is doing the same job ​

If the WP Accessibility plugin is active and has the same fix on, Lumtera leaves that job to it rather than doing it twice, and the fix says so: "WP Accessibility is doing this on your site, so Lumtera leaves it to that plugin while its setting is on." That covers its skip links (when they have a target), focus outline, zoom and form labels, among others. Two of its settings do nothing on a theme tagged accessibility-ready, so Lumtera's fix still works there.

What changes on the page ​

Site fixes change only the tags they are for. The rest of the page, including text in any language, structured data (JSON-LD) and inline scripts, stays exactly as your theme sent it.

Keyboard ​

Add a "Skip to content" link ​

Adds a Skip to content link as the first thing on every page. It's hidden until someone presses Tab, then appears as a high-contrast box in the top-left corner.

  • Target: when you save with this fix on, Lumtera looks at your home page for an existing skip link and the main content area, and shows what it found, for example "Found your main area on the home page: #primary." To set it yourself, fill in Skip to the element with this ID (optional), without the #. The element must exist on every page. If you leave the field empty and Lumtera found no main area, the link points to #content.
  • No link is added if your theme already has a skip link, or if it's a block theme whose template has a main area: WordPress adds its own skip link there.
  • Block themes with WordPress's skip link switched off. Some sites switch WordPress's own skip link off. Then Lumtera adds one, and gives your template's main area the ID lumtera-main, so the link has somewhere to go. The settings screen says when this is the case. If WordPress's older footer script still adds a link, Lumtera adds none, so there is never a second skip link.
  • Your theme must call wp_body_open(), as almost all modern themes do.

Show where keyboard focus is ​

Adds a clear outline around links, buttons and form fields when they're reached with the keyboard. It overrides a theme that removes outlines. Clicking a link or button with the mouse shows no ring. Text fields show it however they're focused.

Leave it off if your theme already shows a clear focus indicator.

  • Ring color (optional): a hex color such as #0a4f9c. Empty uses near-black, #1d1d1d.
  • A contrasting halo is picked automatically, so the ring shows on light and dark backgrounds. The contrast between ring and halo never drops below 4.5:1, and the screen shows the ratio.

Make the Tab key follow the page ​

Removes tabindex values above 0 from links, buttons and fields in content, menus, widgets and forms. Other elements get tabindex="0", so they can still be reached. Values of 0 and -1 aren't changed.

Leave it off if a form or tool was built to rely on its own Tab order and you have tested that order with a keyboard. Press Tab through your forms after turning this on.

Zoom and motion ​

Allow zooming on mobile ​

Some themes stop people from pinch-zooming on phones, which fails WCAG 1.4.4. This fix adds a viewport tag that allows zooming, at the end of the page <head>.

Browsers use the last viewport tag, so this one wins over a restrictive tag printed earlier. It can't override a tag that the theme adds after WordPress's wp_head(). Use the Whole page tab in review mode to confirm zoom works.

Leave it off if your theme isn't responsive (built for a fixed desktop width), or its viewport tag sets other values you need, such as viewport-fit=cover.

Respect "reduce motion" ​

For visitors who have asked their device to reduce motion, CSS animations and transitions finish at once and smooth scrolling is off. Nothing changes for anyone else. It doesn't stop movement made by scripts or videos.

Page basics ​

Add a missing page title ​

If your theme prints no <title> at all, adds one built the way WordPress builds titles. Lumtera finds that out from your home page when you save, and adds nothing until it knows. Leave it off if your theme or an SEO plugin already gives every page a title.

Set the page language ​

Adds lang (and dir on right-to-left sites) to the <html> tag from your site's language setting, when they're missing. Leave it off if a translation plugin sets the language for each page.

Remove repeated tooltips ​

Removes the title attribute from links and images when it only repeats their text or alt text, in content, menus, widgets, thumbnails and lists. A title that adds information, or is the only name something has, stays. Those tooltips no longer appear on hover.

Links in content ​

These apply to posts and pages as they're shown, not to what's saved. Turning a fix off undoes it.

Underline links in content ​

Underlines links inside post content, comments, and paragraphs in the main area, so they don't rely on color alone (WCAG 1.4.1). Buttons and links in navigation menus aren't changed.

Adds hidden text, "(opens in a new tab)", to links in post content that open a new tab, so screen reader users know. If the link has an aria-label, the text is added to that instead. Links that already say "new tab" or "new window" are left alone.

Stopping links from opening new tabs is the better fix.

The same hidden words for links in menus and in Navigation and Social Icons blocks, which are outside post content.

Removes target="_blank" from links in content, menus, widgets and blocks as pages are shown. What's saved doesn't change, so turning this off brings the new tabs back. With this on, the two "opens in a new tab" fixes have nothing to do. Leave it off if visitors must keep a page open while following a link, such as a help link in the middle of a long form.

Name the post in "Read more" links ​

Adds the post title as hidden text inside "Read more" links, including the Read More block and the excerpt block's link. Nothing visible changes. Links that have their own name or already say the title are left alone.

Adds the file type and size, such as "(PDF, 1.2 MB)", to links in post content that point to PDF, DOC, DOCX, XLS, XLSX, PPT and PPTX files in your Media Library. It works for full addresses and for links written from the site root (/wp-content/uploads/…), also on sites with a port in the address.

Show the file details:

  • To everyone (default): small visible text after the link.
  • To screen readers only: hidden text.

Links that already name the file type, File block buttons, and files hosted elsewhere aren't changed.

Forms ​

Label the search and comment forms ​

Gives WordPress's own search and comment form fields an accessible name ("Search", "Name", "Email", "Website", "Comment") when your theme leaves them unlabeled. It also names an icon-only search button "Search". Fields that already have a label, aria-label or title aren't changed. Nothing visible changes.

Visible labels in the theme are better than these hidden ones.

Ask for words before searching ​

Marks the field in WordPress's search form as required, so the browser asks for words. A search for nothing that gets through anyway shows your theme's "nothing found" page. Search forms with other choices, such as categories, can still be sent empty. Leave it off if people on your site browse by searching for nothing.

Media and documents ​

Stop sound playing by itself ​

Removes autoplay from audio and from video that isn't muted, and gives them playback controls. Turns off autoplay in embeds such as YouTube unless they're muted. Silent videos, such as Cover block backgrounds, keep playing.

Name embeds that have no title ​

Adds a title such as "Embedded content from example.com" to iframes with no name. Embeds with a title are left alone, and hidden ones are skipped. A title you write yourself is better: this only says where the embed comes from, not what it shows.

Warn about PDFs when uploading ​

Adds a line beside the uploader and in a PDF's details in the Media Library, and a note on the next admin screen after uploading one. It never blocks the upload. Only people who use wp-admin see this; visitors' pages don't change.

CSS rules for theme colors ​

When you approve a color fix from the editor's rendered page check, it's listed here under CSS rules for theme colors, with the element, the old and new color and the contrast. Remove this rule puts that element back to your theme's color. Your content and theme files are never changed.

For developers ​

lumtera_site_fixes_skip_link_target, lumtera_site_fixes_theme_has_skip_link, lumtera_site_fixes_viewport and lumtera_site_fixes_filter_content let you adjust these fixes. See Hooks & filters.