This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP ragadjust

Description

WP ragadjust is an extremely simple plugin that includes ragadjust.js on your web pages. Ragadjust.js is a script written by @nathanford and envisaged by @markboulton which resolves several typographical violations relating to the rag that are common on the web:

  • Line breaks immediately following a preposition
  • Line breaks immediately following a dash
  • Small words at the end of a line
  • Consecutive hyphenation
  • (Line) broken, short emphasised phrases

Solving these issues improves the overall readability of your content.

Read the article behind the idea.

Screenshots

  • Before / After ragadjust.

Installation

  1. Upload wp-ragadjust to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Done!

FAQ

Which elements are _ragadjust_ed by default?

By default ragajust is applied to p tags.

Can I change which elemnts are adjusted?

Yes, you can use the wpr_elements filter to make adjustments to the selectors.

To add a new selector:

add_filter( 'wpr_elements', 'wpr_new_selectors' );
function wpr_new_selectors( $elements ) {
    $elements[] .= '.textwidget'; // Adjust text widgets in addition to p
    return $elements;
}

To remove a current selector:

add_filter( 'wpr_elements', 'wpr_remove_elements' );
function wpr_remove_elements( $elements ) {
    unset( $elements['0'] ); // Unset 'p'.
    return $elements;
}

To use your own, entirely unique selectors:

add_filter( 'wpr_elements', 'wpr_custom_elements' );
function wpr_custom_elements( $elements ) {
    $elements = array(
            'article',
            'footer',
        );
    return $elements;
}

These snippets should go in your child themes functions.php file.

Can I change the method used?

Yes. By default all methods will be used to fix all violations. If however you only want to fix prepositions and ignore everything else you can do so via the wpr_method filter like so:

add_filter( 'wpr_method', 'wpr_custom_method' );
function wpr_custom_method( $method ) {
    $method = 'prepositions';
    return $method;
}

The method options are:

  • emphasis – Text of three or less words in bold or italics does not break across lines.
  • small-words – Breaks lines before words of three or less characters.
  • prepositions – Breaks lines before prepositions.
  • dashes – Breaks lines before hyphens and dashes.
  • all (default) – All of the above.

Reviews

Read all 5 reviews

Contributors & Developers

“WP ragadjust” is open source software. The following people have contributed to this plugin.

Contributors

Translate “WP ragadjust” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0

Initial release.