<?php
/*
Plugin Name: Bunny's Technorati Tags
Plugin URI: http://wp-plugins.net/index.php?id=98
Description: Allows easy addition to a post of a space-separated list of tags which can be displayed with adequate Technorati links in the template. Can display keywords instead if no tags are available.
Version: 0.41
Author: Stephanie Booth
Author URI: http://climbtothestars.org/


  Copyright 2005  Stephanie Booth  (email : steph@climbtothestars.org)

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

INSTRUCTIONS
============

Add the following code to your template where you want your tags to appear:

<?php the_bunny_tags(); ?>              

The keywords will appear as links wrapped in <p class="tags">Tags: ...</p>. You may want to add CSS to style the list.

If you want other html, you can try things like the following (thanks, Scott):

<?php the_bunny_tags("<ul><li>", "</li></ul>", "</li><li>"); ?>
                        
If you want keywords to be translated as tags for posts which do not have tags defined, change the setting below. Attention! your keyword list must be stored in a custom field 'keywords' and be a comma-separated list -- otherwise you will need to edit the function get_bunny_tags_list().

WARNING: if your pages aren't utf-8 and you use non-ascii characters in your tags, your tags might not get indexed properly.

SETTINGS
========

If you want the plugin to try and use a comma-separated "keywords" post_meta field if there is no space-separated "tags" field available, replace "true" below by "false": */

$bunny_strict=true;

/*
CHANGELOG
=========

0.1  - Initial release 18.01.2005
0.2  - Added "tags" textarea to post.php
     - Modified the_bunny_keyword_tags(): uses 'tags' if available
0.21 - Added missing "Save Post" action hook (tags weren't saved on drafts)     
0.3  - Include tags in post content in feeds for better parsing by Technorati
     - Replaced the_bunny_keyword_tags() by setting $bunny_strict=false
0.31 - Now encodes accented characters in tag URIs (accented tags were breaking Kevin's parser!)
0.32 - Minor tweaks to url (correct encoding function, removed trailing slash) which should *finally* mean the tags will get indexed correctly. See warning above, however.
0.4  - Courtesy of Scott Jarkoff, you can now wrap the list of tags in any HTML you want.
0.41 - Fixed bug messing with the feeds.

CREDITS
=======

Many thanks in particular to Carthik ( http://blog.carthik.net/ ), who gave me the necessary nudge to start coding this plugin, and to Morgan ( http://doocy.net/ ), who helped me write my first action hooks, and who pointed me to his plugin MiniPosts; you'll recognize some of the code if you compare both plugins ;-) 

Thanks also to Kevin Marks ( http://epeus.blogspot.com/ ) for encouraging me to play about with all the Technorati stuff and helping me iron out some tag url bugs.

Scott Jarkoff ( http://www.jarkolicious.com/ ) made the modification which allows passing HTML formatting of the list in the_bunny_tags($before, $after, $separator). Thanks!

<? this line just makes things pretty in my BBEdit
*/


// retrieve tag values from post_meta
function get_bunny_tags($separator=" ", $meta_field) 
{    
    $tags = get_post_custom_values($meta_field);
    if(!empty($tags[0]))
    {
        $tags_array = explode($separator, $tags[0]);
    }
    return($tags_array); // return an array of tags
} 


// prepare formatted tag list from $tags_array
function output_bunny_tags($tags_array, $before, $after, $separator) 
{    
    if(!empty($tags_array))
    {
        $tags_list=$before; // HTML to display before the list of tags
        foreach($tags_array as $tag) // go through all tags for the post
        {
            $tag_link='<a href="http://technorati.com/tag/' . rawurlencode($tag) . '" title="' . __('See the Technorati tag page for', 'BunnyTags') . ' \'' . $tag . '\'." rel="tag">' . $tag . '</a>' . $separator; // make a link to the technorati tag page, with tag link text
            $tags_list.=$tag_link; // stick it on the end of the growing list
        }
        $chomp = 0 - strlen($separator);
        $tags_list=substr($tags_list, 0, $chomp);// remove the last separator
        $tags_list.=$after; // HTML to display after the list of tags
    }
    return($tags_list);  // return the nice little html-ized list of technorati tags
}

// prepare the formatted list of tags -- this is what you mess with if your custom field values aren't formatted like described in the instructions
function get_bunny_tags_list($before, $after, $separator)
{
    global $bunny_strict;
    
    $technorati_tags=get_bunny_tags(' ', 'tags');
    $label="Tags";
    if(empty($technorati_tags)&&!$bunny_strict)
    {
        $technorati_tags=get_bunny_tags(', ', 'keywords');
        $label="Keywords";
    }
    $technorati_tags_list=output_bunny_tags($technorati_tags, $before, $after, $separator);
    return($technorati_tags_list);
}


// stick the list of tags at the end of the_content if we're in a feed
function append_tags($content)
{
    global $feed;
    if (!empty($feed)&&!is_single()) 
    {
        $tags_list=get_bunny_tags_list('<p class="tags">Tags: ', '</p>', ', ');
        $content.=$tags_list;
        // debugging
        // $debug="This is feed: $feed";
        // $content.=$debug;
    }
    return $content;    
}

// output textarea to easily add tags in admin menu (addition to the post form)
function add_tags_textarea() {
    global $postdata;
    
    $tags = get_post_meta($postdata->ID, 'tags', true);
    
    echo '<fieldset id="posttags"><legend><a href="http://technorati.com/help/tags.html" title="Information about Technorati tags.">' . __('Tags', 'BunnyTags') . '</a></legend>';
    echo '<div><input type="text" name="tags" id="tags" size="100" value="' . $tags . '" /><br />' . __('Separate tags with spaces', 'BunnyTags') . '</div></fieldset>';
}

// update tags custom value for given post
function update_post_tags($id) {
    delete_post_meta($id, 'tags');
    $setting = $_POST["tags"];
    add_post_meta($id, 'tags', $setting);
        }


// start serious stuff
// localization
load_plugin_textdomain('BunnyTags');

// ACTION!

add_action('simple_edit_form', 'add_tags_textarea');
add_action('edit_form_advanced', 'add_tags_textarea');
add_action('edit_post', 'update_post_tags');
add_action('publish_post', 'update_post_tags');
add_action('save_post', 'update_post_tags');

add_filter('the_content', 'append_tags');

// TEMPLATE FUNCTION

// use this function to output as tags the space-separated content of the meta field "tags"; depending on your setting of $strict at the beginning of this file, the function may treat as tags the comma-separated content of the meta field "keywords" if "tags" doesn't exist. You may pass arguments $before, $after, and $separator to control the formatting.

function the_bunny_tags($before = '<p class="tags">Tags: ', $after = '</p>', $separator = ', ')
{
    print(get_bunny_tags_list($before, $after, $separator));
}

?>