WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Google Webfonts For Woo Framework

Give the WooThemes framework access to the full range of current Google Webfonts.

What if I don't have a Google API key?

No problem! From version 1.2.0 this plugin carries a list of fonts and variants as a fallback. If the API key is not entered or the API key is invalid, then the plugin will use the fallback list. This list initially contains 652 fonts but will slowly get out of date as Google extends its fonts. It will be refreshed on each new version of the plugin however.

Where do I get a Google API key?

A Google API key can be obtained here: https://cloud.google.com/console?redirected=true

How can I contribute to this plugin?

This plugin is managed on github here https://github.com/academe/google-webfonts-for-woo-framework Feel free to raise issues there and make pull requests, as well as in the normal way on wordpress.org

I have installed this plugin and my API key seems to be already set. How?

The option used to store your API key shares it name with several other popular Google Webfonts plugins. If you have used, or are using, those plugins too, then the API key setting will be shared. This is by design.

I see errors reported when fetching the new Google webfonts

Some hosts may not be set up to allow your site to fetch data from remote sites. Please report any such errors on the plugin page or github, and we will try looking for a workaround.

Can I use the new fonts in a page body?

Yes, you can. WooThemes themes provides a short-code tag that allows you to embed any font in the body of a page or post. However, the list of fonts that the short-code quick-create function that the content editor provides, will not include the full list of fonts. To work around this, just select any random font to create a short-code tag, then change the name of the font manually in that tag. The theme will load that font automatically when you display the page or post.

Tell me about variants. What are they?

Many Google Webfonts come with variants, and these are listed against each font in the plugin settings page. A variant is another version font from the same font family, that is used for displaying a different style or weight. Where a variant does not exist, for example if there is no "italic" variant, the web browser will fake it and make a best guess of what it would look like. This is not ideal from a design perspective. So where possible, use fonts that have variants listed that cover the styles and weights that you want to use in your design. That way you will get a font that has been carefully designed for that purpose.

The settings page allows you to preview specific variants of each font, as well as the standard core font (generally normal/non-italic, and regular/400-weight).

Is it just Google Webfonts?

For now, yes it is. The Woo Framework is designed to pull in external webfonts from Google only at present.

There are plans to extend this to other sources of web-based fonts, with the risk that it may be a little ess robust when it comes to theme updates from WooThemes. However, that will likely be a separate plugin; this plugin will continue to support just Google Webfonts.

How can I get a list of Google fonts this plugin recognises?

If you do not supply a valid API key, this plugin will fall back to the fonts listed in fonts.json To get an updated list of fonts for that file, make sure you have a valid API key then add this parameter to the end of the settings page for this plugin:

export=1

Your URL will look like this:

http://yoursite.example.com/wp-admin/options-general.php?page=gw-for-wooframework&export=1

This will then list all the fonts and their variants downloaded from the Google API in the same format that fonts.json uses. There is no API at this time for fetching the subsets (latin, greek etc) or font classes (serif, sans serif, handwriting, etc), so that information is not included. However, if you are interested in those details, I'm trying to keep an updated list here:

https://github.com/academe/GoogleFontMetadata

What is the font weight selection all about?

In the settings page, you can select a filter for the font weights. By selecting weights, only those weights will be requested from Google.

What happens, is that when you request a font from Google, it is delivered with all the weights that it supports. Those weights may include ultra-bold, ultra-light, semi-bold and so on, as well as the standard light/normal/bold (also known as 300, 400 and 700). Each of these weights adds to the download payload and that can be excessive for some fonts, especially for users on slow or expensive connections.

By filtering the weights - by default just asking for 300/400/700 - the fonts downloaded from Google can be much smaller. WooThemes themes only support these three weights in the theme administration pages, so this is why we only request these three by default. If you have extended the theme and require additional weights, then select the weights that you would like included in the settings page. Those weights will then be requested for all all fonts used from Google, but only where Google offers those weights.

Selecting a weight, or not selecting it, will not change the weights your browser will attempt to display. What it changes is the glyphs for the exact weights that are requested from Google. It is a performance enhancement; don't download what is not needed.

Requires: 3.3 or higher
Compatible up to: 3.9.1
Last Updated: 2014-6-24
Downloads: 9,507

Ratings

5 stars
5 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

0,1,0
100,2,2
100,1,1 100,1,1
100,1,1 100,1,1
100,1,1