• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar

I Like Kill Nerds

The blog of Australian Front End / Aurelia Javascript Developer & brewing aficionado Dwayne Charrington // Aurelia.io Core Team member.

  • Home
  • Aurelia 2
  • Aurelia 1
  • About
  • Aurelia 2 Consulting/Freelance Work

How to Add Visible Text Descriptions into the WordPress Theme Customisation API sections

General · February 18, 2013

There is no denying that the WordPress Theme Customisation API is an awesome addition (added in version 3.4) however there are some things that it can’t do out of the box and if you’re not a super developer capable of creating your own customize classes to create custom sections and settings with textual descriptions then you’re fresh out of luck.

The Theme Customisation API has support for a description attribute you can add to your sections like so:

[code]

$wp_customize->add_section( ‘logo’ , array(
‘title’ => __(‘Logo’, ‘themes;ig’),
‘priority’ => 29,
‘description’ => __(‘Change your themes logo here. If no logo image is uploaded, your site name in text will be displayed instead.’, ‘themeslug’)
) );

[/code]

Now you could be forgiven for thinking the description argument will add in a visible description to your setting section, but it doesn’t. What the description argument adds is a title to the heading of your settings section that shows when the mouse hovers and waits a second or so. If you want to display text with instructions visible at all times there is no option for that by default so for the sake of finding a quick and functional solution I recently came up with a hacky solution that uses the description argument.

You add in your section descriptions like you would expect too and then drop this code into the bottom of your theme’s functions.php file and presto, you have descriptions that will display when you expand them.

Dwayne

Leave a Reply Cancel reply

0 Comments
Inline Feedbacks
View all comments

Primary Sidebar

Popular

  • Testing Event Listeners In Jest (Without Using A Library)
  • How To Get The Hash of A File In Node.js
  • How To Mock uuid In Jest
  • Which Neural DSP Archetype Plugins Should You Buy?
  • How to Copy Files Using the Copy Webpack Plugin (without copying the entire folder structure)
  • Removing A Character From The Start/End of a String In Javascript
  • How To Convert FormData To JSON Object
  • How To Correctly Use Semantic HTML5 <article>, <main> and <section> Tags
  • Wild Natural Deodorant Review
  • How to Use Neural DSP Archetype Plugins With the Quad Cortex

Recent Comments

  • Thebe on How to Remove the My Sites Menu From the WordPress Admin Bar
  • Maccas worker jn the 2000s on Dear McDonald’s: bring back the Warm Cookie Sundae, you cowards
  • Anamika Singh on Testing Event Listeners In Jest (Without Using A Library)
  • Stefan on A List of WordPress Gutenberg Core Blocks
  • pandammonium on A List of WordPress Gutenberg Core Blocks

Copyright © 2022 · Dwayne Charrington · Log in

wpDiscuz