KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

acf-complex-titles

★ 45 Open GitHub ↗

Complex titles with previews for WordPress content types using Advanced Custom Fields Pro 5

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Advanced Custom Fields Complex Titles

A WordPress plugin that adds custom fields to create a formatted title

This plugin creates custom fields below the title Pages and automatically replaces `the_title()` when called from inside the loop.

![Screenshot](https://raw.githubusercontent.com/MWDelaney/acf-complex-titles/gh-pages/screenshot.png)

## Requirements

1. WordPress 4.5+
2. Advanced Custom Fields Pro 5

## Usage
The following formatting options are included at this time:

1. Word or Phrase (the actual content, don't remove this one)
1. Emphasize
2. Size (small, medium, large)
3. Alignment (left, right, center)

The following layouts are also included for headline groups:

1. Alignment

### Add fields
To add fields to the title(s), extend the Fields class as follows:
```php
	 // Replace the plugin's Fields class with our class extending it
	 add_filter ('acfct_set_fields_class',  function() { return 'myFields'; });

// Add custom CSS to style the new fields
	 add_action ('complex_titles_css', 'addMyStyles');

/**
	  * Add styling for the new fields
	  * 	Naming scheme is as follows:
	  * 		.complex-title-element-[your-field-acf-name]
	  */
	 
	 function addMyStyles() {
		 // Variable containing the styles we want to add
		 $myStyles = "
		 	.complex-title-element-underline {
				text-decoration: underline;
			}
		 ";
		 
		 // Enqueue these styles along with the plugin's other styles
		 wp_add_inline_style( 'acf-complex-titles-style', $myStyles );
	 }

// Our class extending the plugin's class to add new fields
	 class myFields extends MWD\ComplexTitles\Fields {
		 /**
 		 * Field: Underline
 		 *
 		 * @author Michael W. Delaney
 		 * @since 1.0
 		 *
 		 * Checkbox
 		 */
 		public $underline = array (
 			'order' => '10',
 			'field' => array (
 				'key' => 'acfct_underline',
 				'label' => 'Underline',
 				'name' => 'underline',
 				'type' => 'true_false',
 			)
 		);
	 }
```

### Enable only some fields
To remove fields from the available list, declare theme support for only the fields you wish to use:
```php
add_theme_support( 'complex-titles-fields', array( 'word-or-phrase', 'size' ) );
```

### Enable only some layouts
To remove layouts from the available list, declare theme support for only the layouts you wish to use:
```php
add_theme_support( 'complex-titles-layout', array( 'alignment' ) );
```

### Change which post types get Complex Titles
By default complex titles are enabled for Pages, to define which post types complex titles should be available on, declare theme support:

```php
 $landing_page_templates = array(
   array (
     array (
       'param' => 'post_type',
       'operator' => '==',
       'value' => 'page',
     ),
     array (
       'param' => 'page_template',
       'operator' => '!=',
       'value' => 'template-no-header-image.php',
     ),
   ),
 );
 add_theme_support( 'complex-titles-location', $landing_page_templates );
```

## Templates
Basic templates and styles are included. These templates are designed to be simple for styling via your theme. To override the included templates, copy the template(s) you wish to override from `templates` to your theme in a sub-directory called `ct-templates`

## Styles
This plugin ships with basic styling for the default fields. These styles are enqueued on the front-end and in the WordPress admin so that the Complex Title preview area matches the front-end as closely as possible.
To dequeue these styles and replace them with your own, add the following to `functions.php`
```php
remove_action('complex_titles_css', array( $acf_complex_titles, 'front_end_styles' ) );
```

acf-complex-titles

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README