Tribe Simpler CSS
Simplifies custom CSS on WordPress blogs.
by Brian Jessee · github.com/stellarwp-sunset/tec-simpler-css · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/stellarwp-sunset/tec-simpler-css/archive/refs/heads/master.zipReadme
=== Tribe Simpler CSS === Contributors: brianjessee Tags: css, wpmu, appearance, themes Requires at least: 3.9 Tested up to: 4.6.1 Stable tag: 0.5 Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=759905
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 µ =
- Upload the
simpler-css.phpfile to the/wp-content/mu-plugins/directory. The other files should not be uploaded, and the file cannot be in a subdirectory. - You're done! As a mu-plugin, Simpler CSS is automatically enabled for all blogs. = For normal WordPress installations =
- Upload the
simpler-cssdirectory to the/wp-content/plugins/directory. - 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 ==
- The menu item as it appears under the Appearance menu.
- 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)