Postscript

Contributors: hearvox
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=T4YWRA5FZC5PC
Tags: script, javascript, style, styles, stylesheet, css, class, enqueue
Author URI: http://hearingvoices.com/
Plugin URI: http://hearingvoices.com/tools/postscript/
Requires at least: 3.5
Tested up to: 4.9.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Data visionaries and multi-mediators, make any post sing with scripts and splendid with styles, all from within WordPress.

Description

No more shoehorning stylesheets and JavaScripts into the post content box. No more loading scripts on every post that only a few use. Postscript lets you easily add libraries or single-post script and style files post-by-post.

The plugin uses the WordPress "enqueue" methods, which means you can control dependencies (when registering scripts), improve site performance by putting styles in the head and scripts in the footer, and eliminate loading multiple copies of the same library (jQuery, I'm looking at you).

Enqueue Registered Styles and Scripts (by Handle)

Use the Postscript meta box (Edit Post screen) to enqueue registered styles and scripts (listed by handle in checkboxes).

Enqueue Unregistered Styles, Scripts, and Data Files (by URL)

For each post, you can also enqueue unregistered files, by entering URLs in the meta box text fields for:

• 1 CSS stylesheet.
• 2 JavaScript URLs, e.g, one JSON data file and one script file.

Add Post and Body Classes

And for each post, you can add:

• A classname, to the HTML body tag (requires body_class() in theme).
• A classname, to class="post" list (inserted by WordPress, requires post_class() in theme).

Settings and Security

The Settings screen lets you control which user-roles and post-types display the Postscript meta box and which script/style handles users are allowed to enqueue.

Installation

To install and use the Postscript plugin:

1. Upload the postscript directory and content to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to the Setting: Postscript options screen.

Frequently Asked Questions

How do add registered script/style handles to the Postscript meta box?

The Settings > Postscript screen lists all available handles, those registered via the [wp_enqueue_scripts hook])https://developer.wordpress.org/reference/hooks/wp_enqueue_scripts/} in your active theme and plugins and the defaults registered by WordPress itself.

You can add any registered script or stylesheet handle to the checkboxes in the Postscript meta box. The GitHub Dev Notes details on the inner workings of this plugin, including custom fields and taxonomies, transients, options, and filters.

How do I register scripts?

Your Scripts and Styles: You can register your own CSS/JS file handles with the wp_register_script() and wp_register_style() functions.

Default Scripts and Styles: WordPress auto-registers numerous styles and scripts via its core functions: wp_default_scripts() and wp_default_styles(). Each file gets its own unique handle: see the list of defaults.

What is a use case for this plugin?

Adding Thickbox to a post is an example of what this plugin does. WordPress ships with a modified ThickBox jQuery library, used to make modal lightbox windows. The add_thickbox() function enables this feature. When enabled, though, Thickbox's CSS and JS files load on every Post, whether the post needs it or not.

This plugin improves site performance by enqueuing scripts only when specifically requested for an individual post, via the Postscript meta box. See the screenshots.

How can I contribute to Postscript?

Postscript is now on GitHub. Pull Requests welcome.

How can I translate Postscript?

This plugin is internationalized (default: English). Please contribute a translation in your language.

The WordPress.org Polyglots Team maintains a comprehensive Translator’s Handbook. All text strings in this plugin are localized, following the guidelines of the Wordpress.org Plugin Handbook's Internationalization section.

Credits

This plugin was developed as part of a Reynolds Journalism Institute fellowship.

Screenshots

1. Edit Post screen Postscript meta box
2. Settings Page: User Roles, Post Types, URls, and Classes
3. Settings Page: Tables of Added Scripts and Styles
4. Settings Page: Remove Scripts and Styles

Changelog

1.0.0

Release Date: February 20, 2018

Bugfixes:

• Fixes taxonomy term deletion when no terms checked.
• Removes Postscript taxonomies from Dashboard menu links.
• Removes Postscript taxonomies from Dashboard: Appearance: Menu checkboxes.
• Removes Postscript taxonomies from Quick Edit checkboxes.
• Removes Yoast SEO plugin "Make Primary" button on Postscript taxonomies.

0.4.7

Release Date: July 30, 2016

Beta version, first in WordPress Directory:

• Adds whitelists for hostnames and extensions of unregistered URLs.
• Changes custom taxonomy slugs to 'postscripts' and poststyles'.Fix
• Tests upgrade option function based on version number.