README.md

Advanced Custom Fields: Typography Field

A Typography Add-on for the Advanced Custom Fields Plugin.

• Requires at least: WP 3.5.0
• Tested up to: WP 6.0
• Tested up to: PHP 8.2
• Tested up to: ACF 6.0
• Stable: 3.2.3
• Latest: 3.3.0

Description

Typography field type for "Advanced Custom Fields" plugin that lets you add different text properties e.g. Font Size, Font Family, Font Color etc.

If you want any kind of font/typography features within ACF, this is the plugin for you! There's nothing else like it!

Supported Subfields

• Font Size
• Font Family
• Font Weight
• Font Style
• Font Variant
• Font Stretch
• Line Height
• Letter Spacing
• Text Align
• Text Color
• Text Decoration
• Text Transform

Other Features

• Supports Google Fonts. The selected Google Fonts are automatically enqueued on front-end of posts/pages. Google Fonts also work with ACF Options.
• Supports serving Google Fonts remotely, or locally.
• Supports Gutenberg Blocks created with ACF.
• Option to show/hide each subfield individually.
• Option to make each subfield required individually.
• Color Picker for Text Color subfield.
• Shortcode for getting typography field values.
• Shortcode for displaying link/style HTML code in-line.

Screenshots

Documentation

// Returns the value of a specific property
get_typography_field( $selector, $property, [$post_id], [$format_value] );

// Displays the value of a specific property
the_typography_field( $selector, $property, [$post_id], [$format_value] );

// Returns the value of a specific property from a sub field.
get_typography_sub_field( $selector, $property, [$format_value] );

// Displays the value of a specific property from a sub field.
the_typography_sub_field( $selector, $property, [$format_value] );

Shortcodes

Retrieve typography field values for display or use anywhere you want.

[acf_typography field="field-name" property="font_size" post_id="123" format_value="1"]

Retrieve either link or style HTML tag codes for font stylesheets to use in-line anywhere you want.

[acf_typography_stylesheet link_type="link" post_id="123"]

// link_type = "link" or "style" (str) (optional) (default: "link") 

// Returns link code for link_type="link"
// <link rel="stylesheet" ... />

// Returns style code for link_type="style"
// <style> ... </style>  

// post_id = a specific post_id to get the stylsheets for (str) (optional) (default: current post_id)

Want to alter the output for the link/style code returned?

function myprefix_change_stylesheet_output( $output, $tag, $attr ) {
	
	//make sure it is the right shortcode
	if('acf_typography_stylesheet' != $tag){ 
		return $output;
	}
	
	// general code to do something with the output string 
	// some examples are shown below
	
	// check for specific link_type
	if(isset($attr['link_type'])){
		// only do something based on supplied link_type ("link" or "style")
		if ($attr['link_type'] === "style") {
			// example to partially "minify" in-line CSS stylesheet code 
			$output = str_replace(array("\r", "\n"), "", $output);
		}
	}
	
	// check for specific post_id
	if(isset($attr['post_id'])){
		// only do something based on supplied post_id
	}
	
	// get current object ID if you did not supply a post_id
	if (!isset($attr['post_id'])) {
		$object_id = get_queried_object_id();
		// only do something based on current object_id
		
		// get post_type for current object_id
		if (get_post_type($object_id) == "my_custom_post_type") {
                        // only do something based on a specific post_type
		}
	}

	return $output;
}
add_filter( 'do_shortcode_tag', 'myprefix_change_stylesheet_output', 10, 3);

Compatibility

This ACF field type is compatible with:

• ACF plugin v4, v5 & v6
• Free and paid versions of the ACF plugin

Installation

• Download the plugin from WordPress Repository or use the latest release from this repository.
• Google API Key is required for Google Fonts. Please add one by going to WordPress Admin Dashboard > Settings > ACF Typography Settings

Changelog

See changelog on CHANGELOG.md file.