{"id":59,"date":"2005-06-23T10:02:39","date_gmt":"2005-06-23T00:02:39","guid":{"rendered":"http:\/\/www.thunderguy.com\/semicolon\/wordpress\/safe-title-wordpress-plugin\/"},"modified":"2006-11-25T19:17:21","modified_gmt":"2006-11-25T09:17:21","slug":"safe-title-wordpress-plugin","status":"publish","type":"page","link":"https:\/\/thunderguy.com\/semicolon\/wordpress\/safe-title-wordpress-plugin\/","title":{"rendered":"Safe Title: a WordPress plugin"},"content":{"rendered":"

Latest version is 0.1.<\/em><\/p>\n

Safe Title is a WordPress<\/a> plugin that allows you to use HTML in post titles in the default WordPress theme.<\/p>\n

Warning<\/strong>: You probably don’t need to use this plugin. It’s more an interesting technical experiment than a useful addition to the WordPress canon. Please read the notes below.<\/p>\n

When posting to your WordPress blog, sometimes you just want to use HTML in the title. You want to make some words stand out with color<\/span>, or use italics<\/i> or a code<\/code> font. (Here’s an example of an HTML post title<\/a> on this very website.)<\/p>\n

Sadly, the default theme included with WordPress 1.5 can’t handle this; it fails to strip HTML tags from the title when it appears inside an HTML attribute, and you end up with a deformed post title. I initially solved this problem by creating a special template tag that strips tags from the title, but this meant I had to edit my theme to use the new tag. Wouldn’t it be nicer to create a plugin that would do it automatically, thus magically “fixing” the default theme?<\/p>\n

I amused myself by finding a way to do it. It’s easy to add a filter to the_title<\/code> to strip the tags. The hard part is when the filter has to decide whether to actually strip the tags or not. It only needs to do it if it’s being used inside an HTML attribute, but the filter callback does not receive any context to help it decide.<\/p>\n

So we create some context for it. Turn on output buffering at the top of the page (using an action hook). Then the filter can look at the output buffer to see whether it’s being used inside an attribute. The rest is simple.<\/p>\n

The beauty of this idea is that it’s completely automatic — just enable the plugin. No theme changes required.<\/p>\n

The ugliness of this idea is that it’s probably terribly inefficient and may break other plugins that mess around with output buffering. But I find the “sledgehammer vs. peanut” approach quite amusing.<\/p>\n

And it’s a great illustration of how flexible WordPress is.<\/p>\n

Compatibility<\/h2>\n

Safe Titla was developed with WordPress 1.5, but is not robust due to problems with the WordPress hooks.<\/p>\n

Installation<\/h3>\n
    \n
  1. Download the safe-title.php file (see the end<\/a> of this article for download location)<\/li>\n
  2. Copy safe-title.php into your WordPress plugins directory (wp-content\/plugins).<\/li>\n
  3. Log in to WordPress Admin. Go to the Plugins page and click Activate for Safe Title<\/li>\n
  4. That’s all<\/li>\n<\/ol>\n

    Here’s the code from the plugin:<\/p>\n

    \/\/ Turn on output buffering \r\nadd_action('wp_head', 'tguy_st_ob_start');\r\n\r\n\/\/ Strip the title if it's inside a tag\r\nadd_filter('the_title', 'tguy_st_strip_if_in_tag', 10, 3);\r\n\r\nfunction tguy_st_ob_start() {\r\n    ob_start();\r\n}\r\n\r\nfunction tguy_st_strip_if_in_tag($title_wrapped, $before, $after) {\r\n\/*\tStrip HTML tags from the title if it's already inside a tag.\r\n*\/\r\n    $title = substr($title_wrapped, strlen($before), strlen($title_wrapped) - strlen($before) - strlen($after));\r\n    $title_stripped = strip_tags($title);\r\n    if ($title != $title_stripped) {\r\n        \/\/ Title has html tags\r\n        if (preg_match('\/<[^>]*$\/', ob_get_contents())) {\r\n            \/\/ We're inside a tag. Return the stripped title\r\n            return $before . $title_stripped . $after;\r\n        }\r\n    }\r\n    return $title_wrapped;\r\n}<\/code><\/pre>\n
    I’d love to hear any comments on this approach. The idea of peeking into the output buffer is overkill for this plugin, but it could be a useful way of solving more complex problems.<\/p>\n
    <\/a>Download<\/h2>\n
    You can download safe-title.php<\/a> or view the source code<\/a>. Don’t forget to check out all the other plugins available here — there’s bound to be one that you will find useful.<\/p>\n
    I write these WordPress plugins because I enjoy doing it, but it does take up a lot\r\nof my time. If you think this plugin is useful, please consider donating some appropriate\r\namount.<\/p>\r\n\r\n
    \r\n
    \r\n
    \r\n\r\n\r\n\r\n<\/div>\r\n<\/form>\r\n<\/div>\r\n
    Click here to donate using a credit card or PayPal.<\/p>\r\n\r\n
    \r\n\r\nSend Bitcoins<\/a> to address
    \r\n1542gqyprvQd7gwvtZZ4x25cPeGWVKg45x<\/tt><\/p>\r\n
    Full WordPress plugin list<\/h2>\n