Tribe Simpler CSS

A simple (mu-)plugin enabling custom CSS on WordPress and WordPress µ blogs.

Description

This Simpler CSS mu-plugin allows WordPress µ hosts to enable users to add custom stylesheets to their blogs.

The plugin creates a new menu item under the Appearance menu in WordPress 2.7 that allows users to enter custom CSS code that will be injected into the <head> section of their blog. The CSS is stored in the blog's options table and is filtered through a standard PHP function before being outputted, preventing the user from inserting malicious code into the header.

For non-WordPress µ blogs, this plugin provides an easy way to modify the appearance of installed themes or plugins (such as Sociable) without modifying theme/plugin files that may change with upgrades. No write access is required to any files for Simpler CSS to function, as it stores its data in the database's options table — and that means theme/plugin upgrades won't impact your custom CSS.

The custom CSS will only show when the theme has the necessary wp_header() function in the <head> section, as most themes now do.

Props go to Jeremiah Orem who created the original Custom User CSS plugin on the directory. I merely took that, contributed a thorough readme.txt, and fixed the code to add the menu item under the Appearance menu.

Installation

For WordPress µ

1. Upload the simpler-css.php file to the /wp-content/mu-plugins/ directory. The other files should not be uploaded, and the file cannot be in a subdirectory.
2. You're done! As a mu-plugin, Simpler CSS is automatically enabled for all blogs.

   For normal WordPress installations

3. Upload the simpler-css directory to the /wp-content/plugins/ directory.
4. Activate the plugin through the 'Plugins' menu in WordPress.

Frequently Asked Questions

Why isn't the code showing up on the blog?

Remember that this plugin depends on standard WordPress hooks to operate. If the active theme does not have wp_header() in its code, this plugin is ineffective. Remedy: add the code <?php wp_header(); ?> to the theme files in the <head> section.

Why can't I add JavaScript to the blog's code?

This plugin will only operate for Cascading Style Sheets code. The custom CSS is escaped and outputted within a set of `` HTML tags. These tags are outputted automatically, and including them manually in your CSS code could lead to malfunctions.

Screenshots

1. The menu item as it appears under the Appearance menu.
2. The options page, with CSS code.

Changelog

0.6

• Updated deprecated function
• Connect nonce field into saving process

0.5

• Updated compatibility to 3.0-alpha (Subversion trunk version)
• Fixed htmlspecialchars() usage to be compatible with PHP < 5.2.3

0.4

• Fixed <td> tag that wasn't closed
• Changed regular expression pattern to be more liberal, to allow external URLs

0.3

• Updated compatibility to 2.9-rare (Subversion trunk version)