OMGF (Pro) doesn’t detect/download any fonts.
Table of Contents
This issue could have several causes:
Embedded Content (iframes)
The most common cause of undetected Google Fonts is an external resource, which is embedded in an iframe, is loading the Google Fonts. Read this for more information on why OMGF (or anything) isn’t capable of detecting those Google Fonts.
CSS Optimization and Page Caching Plugins
The most common cause is that you’re using a CSS minification/combination plugin that also has an option to optimize Google Fonts, e.g. Autoptimize, WP Rocket or Asset Cleanup. Check the list of known issues and make sure you’ve disabled any settings that might conflict with OMGF (Pro).
Cookie Notice/Consent Plugins
Another common cause is that you’re using a cookie consent plugin which blocks Google Fonts until prior consent is given. In most cases, it’ll suffice to remove Google Fonts processing from your cookie banner framework. If you don’t want to do so, OMGF Pro is required as it supports processing of asynchronously loaded Google Fonts.
Staging Areas
If you’re running OMGF (Pro) on a staging area, which is locked to the outside world by e.g. basic authentication or a splash screen (i.e. an Under Construction screen), this needs to be disabled temporarily in order for OMGF (Pro) to run. OMGF (Pro)’s detection script runs at server level (and not in a browser) it can’t “act” like an administrator and get access to your site’s frontend.
File/Folder Permissions
Default WordPress instances have folder permissions set to 755 and file permissions to 644. If somehow in your case this is different, it might be that OMGF (Pro) isn’t able to write files to the folder defined under Advanced Settings (default:
/uploads/omgf
).
Unconventional (or Exotic) Google Fonts implementations
Due to coding standards/restrictions in the wordpress.org repository, OMGF is restricted to scanning the HTML document for Google Fonts. If your theme and/or plugins are using exotic implementations of Google Fonts, an upgrade to OMGF Pro might help you out.
OMGF Pro detects Google Fonts loaded in or added by:
- inline @import and @font-face statements,
- @import and @font-face statements in local stylesheets,
- WebFont Loader,
- JavaScript,
- Early Access (Beta).
Already a Pro user and still no luck? Then open up your browser’s Developer Console (opens by pressing F12) and/or your server’s PHP logs. Look for any errors related to OMGF Pro (or other Fatal Errors) and continue further down this FAQ.
Other Issues
- Check the list of Compatible Themes and Plugins to see if OMGF (Pro) is tested with your theme and/or plugins. Make sure to scroll through the entire list, because I’m continuously updating this list with my findings.
- Check the list of known issues with 3rd party plugins for known fixes to common issues with other plugins.
Is your theme/plugin not listed there? No worries. Just shoot me a message and I’ll get you sorted!